已开启
docs: migrate presentation references to atomgit.com and atomgit-cli #611
leonaltair创建于 5 天前
docs: migrate presentation references to atomgit.com and atomgit-cli #611
已开启
leonaltair创建于 5 天前
leonaltair
leonaltair
5 天前

变更内容

基于社区 issue(编号见文末 Closes 行)完成全仓引导性引用迁移:将展示、链接、注释、打包元数据中的 gitcode.com / gitcode-cli 分别更新为 atomgit.com / atomgit-cli。共 177 个文件、822 行对称替换,无 Go 代码改动。

替换范围

  • Markdown 文档全量(README、AGENTS、CLAUDE、CONTRIBUTING、RELEASE、docs/、spec/、Example/、issues-plan/、.loop/ 历史记录等):网页 URL、SSH clone 示例、组织名(skills、gc-api-doc、homebrew-tap)、GitHub 镜像链接(github.com/gitcode-cli/cli → github.com/atomgit-cli/cli,与 release.yml 中已并存的双 remote 元数据一致)
  • 打包元数据展示字段:.goreleaser.yaml、nfpm-amd64/arm64.yaml、homebrew/gc.rb、scoop/gc.json、pyproject.toml 的 homepage / Repository / Issues URL
  • .gitmodules:submodule URL 更新为 git@atomgit.com:atomgit-cli/gc-api-doc.git(旧地址 git@gitcode.com:gitcode-cli/... 已无法访问,新仓库已核验存在)
  • 其他:LICENSE 署名(atomgit-cli contributors)、Dockerfile label、postinstall 输出链接、Makefile/build.sh/package.sh/rtk 配置注释、devcontainer 名称
  • 顺手修正:CONTRIBUTING.md 的 cd gitcode-cli → cd cli(原命令与 git clone .../cli.git 产生的目录名不一致,属既有笔误)

边界保留(功能性标识符,逐条核验未触碰)

  • Go module path:gitcode.com/gitcode-cli/cli(go.mod 与全部 import 不变)
  • npm 已发布坐标:@gitcode-cli/cli(与 @atomgit-cli/cli 双坐标并存,release workflow 逻辑不动)
  • PyPI 包名:gitcode-cli(全部 pip/pipx/uv 安装命令原样;RELEASE.md 中曾被误改的包名表格与图示已回退)
  • API host:api.gitcode.com / web-api.gitcode.com(含代码、测试与 Referer header)
  • 认证相关 gitcode.com host(延续 PR !606 确立的功能性 host 保留边界)
  • 用户本地运行时路径 ~/.config/gc/:本 PR 完全不涉及,用户升级后认证与配置原样保留,无需迁移

与 PR !606 的关系

本分支基于 feature/issue-631(PR !606 head)之上开发,包含其提交;两者在 README、AGENTS、docs/COMMANDS、npm/README 四个文件有重叠。建议评审与合入顺序:PR !606 先行,本 PR 随后;!606 合入后本 PR 的 diff 将自动收敛为仅剩本次改动。

作者自检

  • 作者主体标识: AI 代理(Trae,GLM 模型)基于社区 issue 需求实现,作者账号 leonaltair。
  • 根因或实现理由: 组织已整体迁移至 atomgit.com,旧引用部分已 404(gitcode-cli/skills、旧 submodule 地址),展示性链接与元数据应随之更新;同时严格保留功能性标识符避免破坏已发布生态与用户本地数据。
  • 主要修改: 177 文件 822 行对称替换,全部为文档 / 打包元数据 / 注释;git diff 确认零 Go 文件、零 npm 安装器代码(npm/lib/*.js)改动。
  • 单元测试: go build ./... 通过;go test ./tests/contracts/... 通过(该测试校验文档中的安装命令模式,覆盖 npm/PyPI 坐标未被误改的回归)。
  • 实际命令验证: 本次为文档 / 元数据改动,无命令行为变更,无新增命令验证需求;功能性保留项已逐条 grep 复核(module path、npm/PyPI 坐标、API host、认证 host、本地路径),残留引用均为刻意保留。
  • 安全审查: 无凭证、无敏感信息;git add 逐文件精确指定(177 个文件显式列举,未用 git add -A),staged diff 复核无敏感内容;pre-commit 全部钩子通过(含 gitleaks workspace 扫描)。
  • 文档同步: 本 PR 主体即文档同步;docs/COMMANDS.md 等命令行为文档中仅链接与组织名变化,行为描述未动。
  • 风险: low——展示性链接与元数据变更,向后兼容;submodule URL 变更已核验新地址可达(atomgit-cli/gc-api-doc 存在);用户本地数据零影响。
  • 未覆盖项: ① docs/AI-GUIDE.md 第 4 节固定的 skills commit pin(6f0d8b0)原为旧仓核验值,指向 atomgit-cli/skills 后该 commit 是否存在未验证,建议克隆后重新核验并更新 pin;② release 下载链接(wget/scoop 示例)改为 atomgit.com 域后,建议下次发布时实测下载可达性;③ skills 仓 README 基线为 CLI v0.7.0,落后当前 v0.15.0,建议以独立 issue 跟进内容对齐;④ 本机未执行 make lint(golangci-lint 未安装),以远端 CI 结果为准。
  • CI 证据: PR 创建后观察 GitCode Actions 与 GitHub Actions 镜像 CI,结果将补充在本 PR comment。

Closes #634

likedislike
合并受阻
leonaltairleonaltair
5 天前 创建了 pull request,commit 36b2bef3
leonaltairleonaltair
5 天前 关联了issue:全仓引导性引用由 gitcode.com / gitcode-cli 迁移至 atomgit.com / atomgit-cli
leonaltair
leonaltair
5 天前 评论:

CI 证据回填:

GitCode Actions(主仓原生 CI):

  • Run 471(workflow_run_id 32bed2cbdcae4f4f8d3006dbb64ddc7c),event MR,head sha 9d488845010c0f21244675d4b3cf181c76c50d78
  • 结论:全部 5 个 job COMPLETED,无失败——Lint / Secret Scan / Test / Build / Package
  • Test job 步骤明细:Run tests、Run npm wrapper tests、Run Python unit tests、Upload coverage 全部通过

GitHub Actions(镜像仓跨平台 CI):本机未安装 gh CLI 无法观测,待人工核验或后续补充;以 GitCode 原生 CI 为主证据。

likedislike
Aaflyingto成员
5 天前 添加了label:risk/highscope/apistatus/draftstatus/self-checkedtype/bug
Aaflyingto成员
5 天前 删除了label:status/draft
Aaflyingto成员
5 天前 删除了label:status/self-checked
Aaflyingto成员
5 天前 删除了label:scope/api
Aaflyingto成员
5 天前 删除了label:type/bug
Aaflyingto成员
5 天前 删除了label:risk/high