发布 v0.0.1 首个 MVP:清理历史预发布、收敛版本与发布管线、重写发布说明/CHANGELOG/README#36
Merged
Conversation
清理历史预发布(删除 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
此前发布状态混乱,不适合作为首个对外正式版:遗留 4 个
v0.0.1-rc.*标签 + 2 个预发布 Release,package.json停在0.0.4,README 仍声称 cherry-pick/revert/reset/分支重命名「不可用」(实际早已经execGitCLI 通道实现),CHANGELOG 散落多段无单一正式版视图。本 PR 将其收敛为单一、据实、可对外的 v0.0.1 首个 MVP 正式版。改动
清理(已执行,仓库级,不可逆)
rc.1/rc.4,本地rc.2/rc.3)与 2 个 GitHub Release(rc.1/rc.4)。已核验本地/远程标签与 Release 均为空。版本与发布管线
package.json:version0.0.4 → 0.0.1。.github/workflows/ci.yml(github-release): 新增actions/checkout,generate_release_notes改为body_path: docs/releases/${tag}.md——Release 正文取自版本控制的 Release Note(单一事实源、版本留痕、CI 与具体版本解耦)。.github/workflows/ci.yml(publish): OpenVSX 步骤加continue-on-error: true——隔离「版本已存在」报错,保 GitHub Release +.vsix正常产出、首发 workflow 不标红。文档(与
package.jsoncontributes 逐项对齐实证)docs/releases/v0.0.1.md: 面向用户的发布说明,覆盖全部真实特性(7 视图 / 92 命令 / 3 配置项 / 218 单测),作为 GitHub Release 正文;docs/releases/README.md为发布说明索引。[Unreleased]与rc.1–rc.4多段,收敛为单一[0.0.1]条目(按域分组、去重)。docs/releases/;修正失效的.agents相对链接。验证
pnpm run package(check-types + lint + esbuild --production)GREEN。pnpm run test:unit→ 218 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.1CI 将产出官方(非 prerelease)GitHub Release(正文取自
docs/releases/v0.0.1.md)+.vsix资产。风险与备注
0.0.1–0.0.4预发布无法经 CLI 删除/覆盖,需在 OpenVSX 后台手动处理;v0.0.1 重推大概率在该步报错,已用continue-on-error隔离。ENABLE_MARKETPLACE_PUBLISH门控。body_path纪律闸门:未来每个v*标签都需先备好同名docs/releases/<tag>.md,否则发布失败(有意为之)。🤖 Generated with Claude Code