Skip to content

chore(Release): 发布 v0.0.10-rc.1 — 打通 VS Code Marketplace 发布链路并走通完整 release 流程 - #58

Merged
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/fix-ovsx-release-workflow
Jul 4, 2026
Merged

chore(Release): 发布 v0.0.10-rc.1 — 打通 VS Code Marketplace 发布链路并走通完整 release 流程#58
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/fix-ovsx-release-workflow

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景与诊断

排查「已配置 `OVSX_PAT` 但 GitHub Release 仍不往 VS Code Marketplace 发布」,定位到三层根因(均以只读证据坐实):

  1. `OVSX_PAT` ≠ `VSCE_PAT`,是两个不同注册中心。`OVSX_PAT` 服务 Open VSX(open-vsx.org,供 Cursor/Windsurf/VSCodium);VS Code Marketplace 用 `VSCE_PAT`(Azure DevOps PAT)。仓库当前只有 `OVSX_PAT`,无 `VSCE_PAT`
  2. Marketplace 步骤被变量门控且默认关闭。`ci.yml` 的 `if: ${{ vars.ENABLE_MARKETPLACE_PUBLISH == 'true' }}`,而仓库 variables 完全为空,该步骤被整段跳过。
  3. rc 版本号格式与 Marketplace 不兼容。历史 rc 写 `0.0.9-rc.2`(带 semver 后缀);VS Code 官方明确「仅支持 major.minor.patch,不接受 semver 预发布后缀」,故带 `-rc.N` 的版本会被 Marketplace 拒收。

工作流设计本身合理(双市场解耦、变量门控、审批门无阻);问题在缺凭证/变量 + rc 版本格式。历史 rc 的 CI「全绿」仅证明 GitHub Release + `vsce package` 打包成功——Marketplace 从未真正发过(被跳过),OpenVSX 又被 `continue-on-error` 掩盖真实结果。

本 PR 变更(发布物料)

  • `package.json`:`version` `0.0.9` → `0.0.10`(方案 A:纯 major.minor.patch,由 `--pre-release` 标志发预发布,规避 Marketplace 版本格式限制)。
  • `CHANGELOG.md`:新增 `[0.0.10-rc.1]` 段(遵循 Keep a Changelog)。
  • 新增 `docs/releases/v0.0.10-rc.1.md`:文件名精确匹配 tag `ref_name`(`ci.yml` 的 `body_path`),作 GitHub Release 正文单一事实源。

归纳 v0.0.9→HEAD 的真实变更:Graph 视图更名并对齐官方 Source Control GRAPH (#53)、悬浮浮层被侧边栏 iframe 裁剪修复 (#53)、未提交角标承载迁移至隐藏 TreeView (#52)、README 真实性校准 + 中英双语 (#51)。

发布方案(合并后执行)

  • 版本方案 A:package.json 用纯 `0.0.10`,tag `v0.0.10-rc.1`,靠 `--pre-release` 发预发布通道。代价:`0.0.10` 版位被预发布占用,正式版须用 `0.0.11`。
  • 三渠道全发:GitHub Release + VS Code Marketplace(预发布)+ OpenVSX。
  • 触发:本 PR 合并入 `feature/1.x.x` 后,在其上打 `v0.0.10-rc.1` tag 推送触发 CI。

前置条件(需仓库管理员在打 tag 前完成)

  1. 确认/创建 Marketplace publisher `ThreeFish-AI`;
  2. 创建 Azure DevOps PAT(scope: Marketplace → Manage);
  3. 新增仓库 Secret `VSCE_PAT`;
  4. 新增仓库 Variable `ENABLE_MARKETPLACE_PUBLISH=true`;
  5. 核实 OpenVSX `ThreeFish-AI` namespace 已 claim + `OVSX_PAT` 有效。

验证

tag 推送后确认:`package` 产出 `hyper-git-agentic-git-0.0.10.vsix`;`github-release` 建 prerelease 并附 vsix、正文取自本 Release Note;`publish` 的 Marketplace 步骤不再跳过且以 `--pre-release` 成功;显式查 OpenVSX 步骤日志确认真发布。

🤖 Generated with Claude Code, CodeX, Gemini

…ELOG;

- package.json version 0.0.9 → 0.0.10(方案 A:纯 major.minor.patch,由 --pre-release 标志发预发布,规避 VS Code Marketplace 不接受 -rc.N semver 后缀的限制);
- 新增 docs/releases/v0.0.10-rc.1.md(文件名精确匹配 tag ref_name,作 GitHub Release 正文单一事实源),归纳 v0.0.9→HEAD 真实变更:Graph 视图对齐官方 (#53)、悬浮浮层 iframe 裁剪修复 (#53)、未提交角标承载迁移 (#52)、README 双语与真实性校准 (#51);
- CHANGELOG 新增 [0.0.10-rc.1] 段(遵循 Keep a Changelog);
- 本版作为 VS Code Marketplace 发布链路打通的验证版(首次以 vsce publish --pre-release 于 Marketplace/OpenVSX/GitHub Release 三渠道并发)。

🤖 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 e986856 into feature/1.x.x Jul 4, 2026
5 checks passed
@ThreeFish-AI
ThreeFish-AI deleted the ThreeFish-AI/fix-ovsx-release-workflow branch July 4, 2026 07:52
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