Skip to content

ci+chore(Release): v0.0.1-rc.3 发布 + GitHub Release 自动附带可本地安装的 .vsix - #16

Merged
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/release-rc3-with-vsix
Jun 29, 2026
Merged

ci+chore(Release): v0.0.1-rc.3 发布 + GitHub Release 自动附带可本地安装的 .vsix#16
ThreeFish-AI merged 2 commits into
feature/1.x.xfrom
ThreeFish-AI/release-rc3-with-vsix

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

用户要重新发布 v0.0.1-rc.3核心诉求:GitHub Release 的 assets 必须携带一个可直接用于「Extensions: Install from VSIX」本地安装的 .vsix

循证排查发现真正缺口:现有 .github/workflows/ci.yml 会构建 .vsix,但只把它当作 Actions artifact 上传 + 发往 Marketplace/OpenVSX,从未把 .vsix 附带到 GitHub Release(rc.1/rc.2 的 Release 页面均无 .vsix,而 README 早已指引用户「从 Releases 下载 .vsix」——指引与现实不符)。

变更

ci:GitHub Release 自动附带 .vsix

  • 新增独立 github-release job(softprops/action-gh-release@v2):对每个 v* tag 复用 package job 产出的 vsix artifact,自动创建 Release(*rc* tag 自动 prerelease)并上传 .vsix
  • 解耦needs: package(非 needs: publish)、不挂 environment: production → 即便市场 publish 待审批/失败,带 .vsix 的 Release 仍照常产出。
  • 最小权限:顶层 permissions: contents: read 不动,仅本 job 提权 contents: writefail_on_unmatched_files: true 杜绝「空资产 Release」。
  • publish(Marketplace + OpenVSX)job 零改动,既有行为完全保留。

chore(Release):rc.3 发布物料

  • package.json 版本 0.0.20.0.3(rc.3 市场版本,未占用)。
  • CHANGELOG.md 落定 [0.0.1-rc.3] - 2026-06-29(含 Batch 5-12 全量对齐 + CI 附带 .vsix 说明)。
  • README.md 手动安装指引明确文件名(hyper-git-0.0.3.vsix)。

文档沉淀

  • docs/research/04-publishing-cicd.md:CI 蓝图补充 github-release job(机制 + 解耦理由)。
  • .agents/issue.md:新增 #7「GitHub Release 缺少 .vsix 资产」(表因/根因/处理/防范)。

验证(已自证)

  • ci.yml YAML 解析通过;jobs 拓扑正确(github-releaseneeds: package、tag 门控、contents: writepublish 不变)。
  • ✅ 本地 pnpm install --frozen-lockfile + vsce package:产出 hyper-git-0.0.3.vsix(48.41 KB,含 dist/extension.js@0.0.3),check-types / lint / esbuild 全 GREEN。
  • code --install-extension hyper-git-0.0.3.vsix本地 VS Code 安装成功(端到端「Install from VSIX」可用性自证)。

合并后发布流程

合并入 feature/1.x.x 后,在合并点重建并推送 v0.0.1-rc.3 tag 触发 CI → github-release job 自动产出带 .vsix 的 GitHub 预发布。

⚠️ 待决production 环境当前 protection_rules: [](无审批门),推 tag 会令 publish job 自动发市场。「仅 GitHub 本轮」需先处理(增设审批人 / 临时门控 / 确认接受发 0.0.3 到市场),详见 PR 讨论。

新增独立 github-release job(softprops/action-gh-release):对 v* tag 复用 package job 产出的 vsix artifact 自动建 Release 并上传 .vsix;rc tag 自动 prerelease;与市场 publish 解耦(needs: package、不挂 production 环境),即便市场发布待审批/失败亦不阻塞 Release 资产产出;最小权限仅本 job 提权 contents: write;fail_on_unmatched_files 杜绝空资产。同步 docs/research/04-publishing-cicd.md 蓝图与 .agents/issue.md #7。

🤖 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>
version 0.0.2 → 0.0.3(rc.3 市场版本,未占用);CHANGELOG 落定 [0.0.1-rc.3] - 2026-06-29 第三个预发布候选(含 Batch 5-12 全量对齐 + CI 附带 .vsix 说明);README 手动安装指引明确 .vsix 文件名(hyper-git-0.0.3.vsix)。

🤖 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 3cc2018 into feature/1.x.x Jun 29, 2026
5 checks passed
@ThreeFish-AI
ThreeFish-AI deleted the ThreeFish-AI/release-rc3-with-vsix branch June 29, 2026 13:23
ThreeFish-AI added a commit that referenced this pull request Jul 20, 2026
- Stash / Shelf 由 collapsed 改为 visibility:hidden(hideByDefault,默认不显示、视图菜单可勾选恢复)
- Commit / Worktrees 由 visible 改为 collapsed(显示但默认折叠)
- Branches / Graph 保持 visible;容器内声明顺序重排为 Commit·Branches·Graph·Worktrees
- 纯 package.json contributes.views 声明式改动,initialSize 不变,src/ 零改动、零破坏
- 新增 tests/unit/views-layout.test.ts 声明式护栏锁定顺序与各视图 visibility
- CHANGELOG 记 Changed、issue.md 新增 #16 并给 #12 补指针、README 计数 372→375

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
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