Skip to content

docs+fix+release: M0-M5 文档沉淀 + M0-M4 审查补缺口 + v0.0.1-rc.1 发布准备 - #8

Merged
ThreeFish-AI merged 3 commits into
feature/1.x.xfrom
ThreeFish-AI/docs-review-release
Jun 27, 2026
Merged

docs+fix+release: M0-M5 文档沉淀 + M0-M4 审查补缺口 + v0.0.1-rc.1 发布准备#8
ThreeFish-AI merged 3 commits into
feature/1.x.xfrom
ThreeFish-AI/docs-review-release

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

① 文档沉淀(M0-M5)

  • 新增 实施状态总览:里程碑交付记录、P0/P1 达成矩阵、API 限制汇总、M5 AI 设计(留存)、验证与发布状态。
  • 同步 docs/README、knowledge-map、README(路线图 M0-M4 ✅ + Features/Installation/Known Limitations 发布段落)。

② M0-M4 审查补缺口(第二轮独立 review)

经 2 路 code review(M3/M4 正确性 + 完整性/发布就绪)修复:

  • [Blocker] Stash 视图语义错误log({refNames:['stash']}) 仅返回最新 stash 内部提交(非栈列表,经实测确凿)→ 移除错误枚举,stash 操作改作用于 stash@{0}(保持路径 B 不 shell out 原则,多 stash 列表文档化为 API 限制)。
  • 3 个 TreeProvider EventEmitter 泄漏 → 实现 Disposable + 入 subscriptions。
  • refreshAll 过度刷新 → 150ms 防抖。
  • Blame 守卫:仓库外文件明确提示。
  • 补 P0/P1 缺口:Discard 改动(restore/clean)、Pull/Push/Fetch 命令。
  • 测试补齐:ChangelistRegistry CRUD/持久化单测(vi.mock,+7 项)。

③ v0.0.1-rc.1 发布准备

  • 版本 0.0.1(Marketplace 仅支持 major.minor.patch;预发布语义由 --pre-release + tag v0.0.1-rc.1 体现)。
  • PNG 图标(128×128,Marketplace 要求)。
  • CI publish 条件 --pre-release(rc tag)+ Dependabot 配置。
  • CHANGELOG 首发候选段落。

验收

结果
check-types / lint / package
test:unit 52/52(+7 ChangelistRegistry)
test:integration ✅ 3/3

发布前置(需人工,无法由 Agent 完成)

  • 创建 Marketplace publisher threefish-ai + 配置 VSCE_PAT / OVSX_PAT GitHub secrets。
  • ovsx create-namespace threefish-ai 并 claim ownership。
  • 打 tag v0.0.1-rc.1 触发 CI 双市场发布。

🤖 Generated with Claude Code

🤖 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>
…Discard/Pull/Push/Fetch 与 ChangelistRegistry 测试;

🤖 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>
…t+CHANGELOG);

🤖 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 cac355a into feature/1.x.x Jun 27, 2026
4 checks passed
@ThreeFish-AI
ThreeFish-AI deleted the ThreeFish-AI/docs-review-release branch June 27, 2026 14:53
ThreeFish-AI added a commit that referenced this pull request Jul 4, 2026
留存本次角标更新不及时问题的表因/根因/处理/防范,并交叉引用 #8 关于 badge 承载与 pendingBadge 时序的预警。

🤖 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 added a commit that referenced this pull request Jul 4, 2026
* fix(Badge): 修复活动栏未提交数角标更新不及时;

- 根因:角标挂在 Commit WebviewView 上,VS Code 在 resolveWebviewView(用户打开过面板)前无法显示 webview 角标(vscode#164974/#146330),故面板未打开时新变更不点亮、提交/撤销后不清除;
- 承载迁移:改由隐藏 TreeView(hyperGit.changesBadge, when:false)承载,createTreeView 于 activate 即实例化,其 badge 无论面板是否打开都可靠聚合到容器图标;
- 单一事实源:新增 engine 纯函数 change-count(toRelKey/countUniqueChanges)与 GitRepositoryService.getChangeCount(),getChanges 复用同一去重逻辑,避免双实现漂移;
- 及时且高效:角标走独立 40ms 微防抖快路径,与 150ms 重刷新解耦、合并事件风暴;释放期清理悬挂定时器;
- 熵减:移除 Commit webview 死代码(updateBadge/pendingBadge)杜绝容器求和 2× 计数;补充 change-count 单元测试锁定计数等值不变式。

🤖 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>

* docs(Issue): 补录 #10 活动栏角标 WebviewView.badge resolve 前不显示的根因与处理;

留存本次角标更新不及时问题的表因/根因/处理/防范,并交叉引用 #8 关于 badge 承载与 pendingBadge 时序的预警。

🤖 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>
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