Skip to content

发布 v0.0.1 首个 MVP:清理历史预发布、收敛版本与发布管线、重写发布说明/CHANGELOG/README#36

Merged
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/release-v0.0.1-mvp
Jun 30, 2026
Merged

发布 v0.0.1 首个 MVP:清理历史预发布、收敛版本与发布管线、重写发布说明/CHANGELOG/README#36
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/release-v0.0.1-mvp

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

此前发布状态混乱,不适合作为首个对外正式版:遗留 4 个 v0.0.1-rc.* 标签 + 2 个预发布 Release,package.json 停在 0.0.4,README 仍声称 cherry-pick/revert/reset/分支重命名「不可用」(实际早已经 execGit CLI 通道实现),CHANGELOG 散落多段无单一正式版视图。本 PR 将其收敛为单一、据实、可对外的 v0.0.1 首个 MVP 正式版

改动

清理(已执行,仓库级,不可逆)

  • 删除 4 个 rc 标签(本地 + 远程 rc.1/rc.4,本地 rc.2/rc.3)与 2 个 GitHub Release(rc.1/rc.4)。已核验本地/远程标签与 Release 均为空。

版本与发布管线

  • package.json: version 0.0.4 → 0.0.1
  • .github/workflows/ci.ymlgithub-release): 新增 actions/checkoutgenerate_release_notes 改为 body_path: docs/releases/${tag}.md——Release 正文取自版本控制的 Release Note(单一事实源、版本留痕、CI 与具体版本解耦)。
  • .github/workflows/ci.ymlpublish): OpenVSX 步骤加 continue-on-error: true——隔离「版本已存在」报错,保 GitHub Release + .vsix 正常产出、首发 workflow 不标红。

文档(与 package.json contributes 逐项对齐实证)

  • 新增 docs/releases/v0.0.1.md: 面向用户的发布说明,覆盖全部真实特性(7 视图 / 92 命令 / 3 配置项 / 218 单测),作为 GitHub Release 正文;docs/releases/README.md 为发布说明索引。
  • CHANGELOG.md: 删除 [Unreleased]rc.1–rc.4 多段,收敛为单一 [0.0.1] 条目(按域分组、去重)。
  • README.md: 能力总览升级为 v0.0.1 全量,据实校准过时「不可用」表述,新增路径 B 的 Mermaid 架构图,补开发者构建/测试/文档导航。
  • docs/README.md & docs/.agents/knowledge-map.md: 登记 docs/releases/;修正失效的 .agents 相对链接。

验证

  • 质量门:pnpm run package(check-types + lint + esbuild --production)GREEN。
  • 单测:pnpm run test:unit218 passed(2.17s)。
  • 打包:vsce package 产出 hyper-git-0.0.1.vsix(9 文件 / 113 KB,含重写后的 readme/changelog)。
  • 链接:三份文档全部相对链接目标存在;特性数量经 package.json 实测(92 命令 / 7 视图 / 3 配置项)。

后续(合入后执行打标签发布)

git tag -a v0.0.1 -m "v0.0.1 — 首个 MVP 正式版"
git push origin v0.0.1

CI 将产出官方(非 prerelease)GitHub Release(正文取自 docs/releases/v0.0.1.md)+ .vsix 资产。

风险与备注

  • OpenVSX 不可清理:历史 0.0.1–0.0.4 预发布无法经 CLI 删除/覆盖,需在 OpenVSX 后台手动处理;v0.0.1 重推大概率在该步报错,已用 continue-on-error 隔离。
  • VS Code Marketplace 从未发布,无需清理,仍由 ENABLE_MARKETPLACE_PUBLISH 门控。
  • body_path 纪律闸门:未来每个 v* 标签都需先备好同名 docs/releases/<tag>.md,否则发布失败(有意为之)。

🤖 Generated with Claude Code

清理历史预发布(删除 rc.1–rc.4 标签与 rc.1/rc.4 两个 GitHub Release)后,将首个 MVP 正式版收敛为单一 v0.0.1:

- package.json: version 0.0.4 → 0.0.1。
- ci.yml(github-release): 新增 actions/checkout,并将 generate_release_notes 改为 body_path: docs/releases/${tag}.md——Release 正文取自版本控制的 Release Note(单一事实源、版本留痕、CI 与具体版本解耦)。
- ci.yml(publish): OpenVSX 发布步骤加 continue-on-error——历史 0.0.1–0.0.4 已占用且不可覆盖,隔离该步报错以保 GitHub Release + .vsix 正常产出、首发 workflow 不标红。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
面向用户与开发者重写三份文档,特性与 package.json contributes 逐项对齐实证(7 视图 / 92 命令 / 3 配置项 / 218 单测):

- docs/releases/v0.0.1.md(新增): 首个 MVP 正式版 Release Note,覆盖全部真实特性,作为 GitHub Release 正文单一事实源;docs/releases/README.md 为发布说明索引。
- CHANGELOG.md: 删除 [Unreleased] 与 rc.1–rc.4 多段,收敛为单一 [0.0.1] 正式版条目(按域分组、去重)。
- README.md: 能力总览升级为 v0.0.1 全量,据实校准已过时的「cherry-pick/revert/reset/分支重命名不可用」表述(均已经 execGit CLI 通道实现),新增路径 B Mermaid 架构图,补开发者构建/测试/文档导航。
- docs/README.md & knowledge-map.md: 登记 docs/releases/;修正失效的 .agents 相对链接。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI ThreeFish-AI merged commit 10d1016 into feature/1.x.x Jun 30, 2026
5 checks passed
@ThreeFish-AI ThreeFish-AI deleted the ThreeFish-AI/release-v0.0.1-mvp branch June 30, 2026 07:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant