更新日志

所有重要的项目变更都会记录在此文件中。
格式参考 Keep a Changelog，版本号遵循语义化版本。

[5.0.3.37 / CLI 0.161.2] - 2026-05-06 (桌面版同步 productVersion + 托盘内存使用周期更新)

Changed

desktop-app-vue/package.json version 同步 productVersion（commit c73c3530c）—— 1.1.2-alpha → 5.0.3-alpha.37，semver 合法（-alpha.N prerelease），数字部分跟 productVersion vX.Y.Z.N 一一对应。规则文档化在 CLAUDE.md Version hierarchy 段：每发一版（productVersion → vX.Y.Z.N）desktop 版同步到 X.Y.Z-alpha.N。下一次发版（productVersion → v5.0.3.38）desktop 版变 5.0.3-alpha.38，比 v5.0.3.37 用户当前的 5.0.3-alpha.37 高一档，auto-updater 会真发现并提示新版本。Setup.exe 文件名也变为 ChainlessChain-Setup-5.0.3-alpha.37.exe，与 GitHub release tag v5.0.3.37 视觉对应。v5.0.3.36 用户重启时会首次收到原生"发现新版本 5.0.3-alpha.37"对话框——跨 v5.0.3.31-36 六个 release 因桌面版字段一直是 1.1.2-alpha 没动过，auto-updater 比对永远相等而误报"已是最新"，本版彻底解开。

Added

托盘 → 性能监控 → 内存使用周期更新（commit c73c3530c）—— EnhancedTrayManager 早就提供了 updateMemoryUsage(usage) 方法但 main 进程从未调用，跨 v5.0.3.30+ 一直显示"加载中..."。index.js 在 tray 创建后挂一个 10s setInterval：用 app.getAppMetrics() 累计所有 electron 进程（main + renderer + GPU + utility 子进程）的 workingSetSize (RSS)，格式化"X MB"或"X.X GB"传给 updateMemoryUsage。failure-tolerant：getAppMetrics 抛错只 logger.warn 不影响 tray 主流程。onWillQuit 中 clearInterval 提早停掉防止 quit 链路 timer 火 stale 回调。

[5.0.3.36 / CLI 0.161.2] - 2026-05-06 (手动检查更新加 native dialog feedback)

Changed

手动检查更新加 native dialog feedback（commit 734f87cc6）：v5.0.3.35 修了 electron-log 缺失致 auto-updater 整模块 load 不进来的 bug 之后，从 electron-log 真实日志（%APPDATA%\chainlesschain-desktop-vue\logs\main.log）看 auto-updater 在用户点托盘"检查更新"时确实运行了：手动检查更新 → Checking for update → Update for version 1.1.2-alpha is not available → 当前是最新版本。但跨 v5.0.3.30-5.0.3.35 六个版本用户一直反映"点了无反应"——根因 auto-updater.js 的 update-not-available / error 事件只调 webContents.send("update-status",...) IPC，但 V5/V6 App.vue 和 web-shell 加载的 web-panel SPA 都没监听这个 channel，无论哪种 renderer UI 都看不到任何反馈。修法：auto-updater.js 加 _manualCheckPending 标志；checkForUpdates(manual=true) 设置；update-not-available 事件回调在 manual 时弹 native "当前已是最新版本"dialog（带当前版本号）；error 事件在 manual 时弹 native"检查更新失败"dialog（带错误信息）；update-available 已有 showUpdateAvailableDialog，仅清 manual 标志避免重复弹窗。后台 3s 启动自检 + 每 4h 周期检查路径不传 manual=true，全程静默不弹任何 UI（电源管理 / 锁屏唤醒等场景下大量自动 dialog 很骚扰）。enhanced-tray-manager.js triggerCheckForUpdates 调用处加 true。

Notes

之前 v5.0.3.31/32/33/34/35 五版的"检查更新点了无反应"用户体验问题彻底闭环。绕开了 renderer IPC channel 的"无人监听"问题，跟 showAboutDialog 同套路走主进程原生 dialog——简单可靠，不依赖 V5/V6 / web-shell 模式。

[5.0.3.35 / CLI 0.161.2] - 2026-05-06 (auto-updater 缺 electron-log 模块导致从未 load)

Fixed

packaged 安装版 require("electron-log") 抛 ENOENT 致 auto-updater 模块无法 load（commit 7b9194cd9）：v5.0.3.34 给"检查更新"fallback dialog 加诊断字段后，用户截图反馈 autoUpdater loaded: NO、require error: Cannot find module 'electron-log'、app.isPackaged: true。诊断把根因暴露得很彻底——v5.0.3.31 加 auto-updater init 时就坏，但 require 抛错被 logger.warn 静默吞掉，包括启动 3s 自检 + 4h 周期检查 + 托盘"检查更新"在内的整条自动更新链路其实从未真正生效，跨 v5.0.3.31/32/33/34 四个版本（v5.0.3.32 加的 app.isPackaged gate 是有效的，autoUpdater 是 undefined 就走不到那一步）。electron-log 既不是 desktop-app-vue 的直接依赖，electron-updater@6.6.2 也不再带它作 transitive dep（v6 起 logger 由调用方注入）。修法是双保险：(1) auto-updater.js 把 require("electron-log") 包 try/catch，缺失时 fallback console-based {info,warn,error}，内部 log.info(...) 站点全部不变；fallback 分支不设置 autoUpdater.logger，让 electron-updater 用自带默认。(2) desktop-app-vue/package.json 加 electron-log: ^5.4.3 直接依赖，正常情况走 file logger，fallback 只是兜底。

Notes

已知不在本版本修：托盘 → 性能监控 → "内存使用 / 加载中..." 永远显示"加载中..."。tray-manager 有 updateMemoryUsage(usage) 方法但 main 进程从未周期调用它来填充实时数据。单独 issue 跟。
web-panel 的"全局搜索 / 截图识别 / 剪贴板导入 / 同步 / 通知中心"等 tray 项点了弹"功能即将推出"toast 是设计预期——web-panel 暂无对应面板。要让它们真工作得在 web-panel 加面板，是更大的功能开发。

[5.0.3.34 / CLI 0.161.2] - 2026-05-06 (Web-shell 托盘菜单 bridge + 检查更新诊断)

Fixed

Web-shell 模式下托盘菜单事件被丢弃（commit 91914eb14）：用户在 v5.0.3.33 packaged install 反馈托盘"新建笔记 / 设置 / 检查更新"等点了不跳转。根因 Phase 1.6 hard-flip 之后默认走 web-shell 模式（caaddf530），加载的渲染器是 web-panel SPA 而非 desktop-app-vue 的 V5/V6 Vue 渲染器；v5.0.3.31/32 修的都是 desktop-app-vue/src/renderer/App.vue 的 IPC tray:action listener，但这文件在 web-shell 模式下根本没被加载，preload 也是空的（per strategy memo），主进程 webContents.send("tray:action",…) 发的事件无人接。修复给主进程加一条"绕开 IPC 走 ws-server"桥接：ws-cli-loader.js 暴露公共 broadcast(frame)（委托现成的 ChainlessChainWSServer._broadcast），web-shell-bootstrap.js 透传到 startWebShell handle，index.js 用 getWebShellHandle() 懒 getter 注入 EnhancedTrayManager，dispatchTrayAction 在原 IPC send 之外 additionally broadcast({type:"tray:action",payload:{type,payload}})；web-panel/src/App.vue 在 wsStore.onMessage 上挂全局监听并路由到 web-panel 自己的 /notes//chat//dashboard//project-settings 等页面，无对应面板的（通知中心 / 全局搜索 / 同步）回 toast"功能即将推出"。

Changed

"检查更新"开发模式 fallback dialog 加诊断信息 —— v5.0.3.32 已经把 gate 从 process.env.NODE_ENV === "production" 改成 (NODE_ENV === "production" || app.isPackaged)，但用户在 v5.0.3.33 packaged install 上仍报告看到这个 dialog。把 NODE_ENV / app.isPackaged / autoUpdater loaded / checkForUpdates fn 四个字段直接打到 dialog detail 里，下次用户截图就能直接判断是哪条 fail（require 抛了？isPackaged 出乎意料 false？module 缺导出？），避免再让用户挖 log 文件。

Tests

enhanced-tray-manager.test.js 6 → 10 测试（新增 4 个 web-shell broadcast path：handle 存在时双发、handle 为 null 时仅 IPC、未传 option 时向后兼容、broadcast 抛错时不波及主进程）。
src/main/web-shell/ 全 13 文件 196/196 绿。

[5.0.3.33 / CLI 0.161.2] - 2026-05-06 (托盘"关于"产品版本 "—" 修复)

Fixed

托盘"关于"对话框产品版本永远显示 "—"（commit 461edf060）：用户在 v5.0.3.32 安装版反馈托盘 → 关于显示 产品版本：—，应显示 v5.0.3.32。根因 enhanced-tray-manager.js:317 用 require("../../../../package.json") 读 monorepo 根的 productVersion，但 packaged install 里 enhanced-tray-manager.js 位于 app.asar/dist/main/system/，相对路径 ../../../.. 走出 app.asar 抵达 <install>/resources/，那里没有 package.json → require 必失败 → 永远 catch 走 "—"。dev 模式路径在 repo 内有效所以本机看不出来，是 v5.0.3.31 / v5.0.3.32 共有的历史遗留 packaging 路径问题。修复：build 时把 productVersion + appVersion 烧进 dist/main/build-info.json（scripts/build-main.js 在 copyDir 完成后写入），showAboutDialog 优先读这个常量文件，老相对路径保留作为直接 import src 跑测试时的 fallback。

Why

v5.0.3.32 修完两处托盘主链路 bug 后用户复测发现"关于"还有这个边角小问题。它和托盘菜单链路、自动更新链路均无关，但同样属于"只在 packaged install 才暴露、dev 模式看不出来"那类。顺手收口。

[5.0.3.32 / CLI 0.161.2] - 2026-05-06 (托盘修复 v5.0.3.31 残留两处)

Fixed

托盘"检查更新"在打包版误报开发模式（commit 7e6605006）：v5.0.3.31 用户反馈 GitHub 下载的安装版点托盘"检查更新"仍弹"当前模式：development"对话框。根因 enhanced-tray-manager.js:365 守的是 process.env.NODE_ENV === "production"，但 Electron 打包后 NODE_ENV 默认 undefined（不是 "production"），所以 packaged install 也走 fallback 分支并因此从未真正调用过 autoUpdater.checkForUpdates()。改判 (process.env.NODE_ENV === "production" || app.isPackaged)，对齐 backend-service-manager.js:17 既有双判断。后台静默自动更新链路本身不受影响，因为 auto-updater.js:32 守的是 !process.env.NODE_ENV || === "production"，对 undefined 容错。
首次启动未设密码状态下托盘菜单事件被丢弃（commit 2532774f5）：App.vue onMounted 在 initial-setup:get-status 返回 { completed: false } 时 early-return，跳过下方 tray:action / show-global-settings / database-switched 三个 IPC listener 注册。结果首次启动用户点托盘菜单，主进程 dispatchTrayAction 把窗口 show + focus 后通过 IPC send("tray:action")，但 renderer 没人接，路由不跳——表现为"托盘只把窗口拉出来不进对应界面"。修复：把这三个 listener 整体提到早返之前（连同已经在那里的 deep-link:invitation），它们和数据库加密 / 设置流程无依赖。

Notes

已知小问题（不在本版本修）：preload removeListener 直接传 func，但 on 注册时包了 arrow wrapper，匹配不到——onUnmounted 的 cleanup 实质未生效（轻微监听器累积），不影响功能。

Why

v5.0.3.31 已经修了"托盘菜单大部分项哑响"的主链路（tray:action 统一通道 + renderer listener），但两处残留——NODE_ENV === "production" 误判和 setup-未完成早返——只在用户实际跑 packaged install 才暴露，本机 dev 模式正好走另一条分支看不见。这两个 bug 是 v5.0.3.31 修复闭环外漏掉的边角。

[5.0.3.31 / CLI 0.161.2] - 2026-05-05 (vitest 4 bump + 自动更新 + 托盘菜单 IPC 修复)

Fixed

桌面自动更新 + 托盘菜单全量修复（commit bc2e476bf）：v5.0.3.30 用户反馈三个 packaged-install 问题同源——(1) 自动更新功能不工作、(2) 托盘"检查更新"点击无反应、(3) 托盘菜单大部分项点击无反应（除"显示主窗口"）。auto-updater.js 模块存在但 index.js 从未调用 init()，packaged 版本无启动自检也无 4h 周期检查；托盘菜单各项发送的 per-item IPC channel（quick-action / sync / show-notifications / show-performance / open-settings / show-about / check-update）在 renderer 0 监听器。修复：所有菜单项重新走 dispatchTrayAction 统一入口；窗口隐藏时先 show()+focus() 给反馈（之前 silent-on-hidden 是"无响应"感知的助燃因素）；"检查更新"生产模式直调 auto-updater.checkForUpdates()、dev 模式 fallback dialog；"关于"主进程 native dialog.showMessageBox，无需 renderer 往返。App.vue 监听 tray:action 按 type 派发到 Vue Router、GlobalSearch、window CustomEvents；未映射的 screenshot-ocr / clipboard-import / sync 显式 toast "功能即将推出"——比哑响好。
afterPack 预清悬挂 symlink（commit 411a99af5）：CI Linux build 在 after-pack 报 ENOENT: no such file or directory, stat .bin/cc。根因 CI "Merge hoisted modules into nested" 步创建 .bin/cc 软链指向 @chainlesschain/cli，但 cli 包本身只装在 packages/cli/node_modules/ 下，nothing 镜像到 desktop-app-vue/node_modules/@chainlesschain/——symlink dangling。fs.cpSync(..., { dereference: true }) 在 filter 回调前先 getStats()（跟随 symlink），filter 返 false 拦不住。修复：cpSync 前 walk sourceNm，unlink 任何 target 解析失败的 symlink；廉价（仅 .bin/* 通常是 symlink）、有日志、best-effort。
vitest 3→4 误升级回滚（commit 18caa371a）：bc2e476bf 暂存 desktop-app-vue/package.json 1.1.1-alpha → 1.1.2-alpha 时，git add 同时拣进了 chore/vitest-v4-dry-run 分支遗留在工作目录的 vitest dep 改动（sticky checkout 没清干净），导致 vitest 3→4 没带 lockfile 一起升级，CI npm ci 报 8 个 lock file's @vitest/expect@3.2.4 does not satisfy 4.1.5。三平台 build 全挂。回滚 vitest / @vitest/coverage-v8 / @vitest/ui 回 ^3.0.0 重新对齐 lockfile，v4 迁移按计划走单独分支（见下面 v4 bump 段落）。

Added

vitest 3.x → 4.1.5 全量升级 + 后量子级 CI 稳定性（7 commits 57bb519fe..8ad5fb7e9）：v3 时代两个工件性 workaround 同时退役——issue #5 的 Windows Unit Tests continue-on-error + issue #4 的 mtc-federation-governance-cli poolMatchGlobs → threads:singleThread 路由。vitest 4 上游修了 birpc 60s onTaskUpdate 心跳硬编码（vitest-dev/vitest#8297），现在尊重用户配置的 testTimeout / hookTimeout，--reporter=basic 也由 default + silent=passed-only 替代。受影响包：cli、web-panel、core-mtc、session-core、shared-logger、core-{db,env,infra,config}、desktop-app-vue（含 @vitest/coverage-v8 / @vitest/ui）。同批 bump @vitejs/plugin-vue 5.x → 6.0.6（vitest 4 的 vite peer 是 ^6 || ^7 || ^8，plugin-vue 5 顶到 vite ^6 conflict 在 web-panel install 时 ERESOLVE 撞墙）。落地配套：vi.fn(() => obj) 用作 constructor 的 ~30 文件改 function () { return obj }（v4 拒绝 arrow 作 ctor）；CLI testTimeout: 30000 → 60000 给 subprocess-heavy 联邦治理 + 审计 e2e 场景留余量；tests/setup.ts window 访问加 typeof guard（v4 严守 per-file @vitest-environment node）；OrganizationRolesPage.test.js 补 MoreOutlined 等 12 个 antd icon mock（v4 mock module strict mode）；ProgressMonitor.test.ts 把 (global as any).window = {...} 改成 mutate window.electronAPI（避免覆盖整个 jsdom window 丢 getComputedStyle）。最终 5/5 CI workflow 全绿；issue #5 自动闭环。

Changed

删除冗余 android-release.yml（commit 36d9307f6）：standalone workflow 与 release.yml build-android job 同 tag pattern + 同 APK/AAB 输出 + 同 GitHub Release 创建，实测前者 v5.0.3.30 在 45m15s 超时取消、后者 ~2 分钟跑完发了 14 APK + AAB，标准 release 唯一作用是给每个发布加个红叉。同步刷新 android-app/docs/ci-cd/CI_CD_GUIDE.md 手动触发指引指向 release.yml，desktop-app-vue/.cowork/cicd-analysis.md 删行；FIREBASE_CRASHLYTICS_SETUP.md 通用示例 yaml 不动（说明性，非真实引用）。

Docs

issue #6 文档 fact-check（commit 4b134e9f4）：issue #6 body 提的 asar:true + asarUnpack glob 把 Win install 砍到 5min 的方案在 2026-05-05 实证（issue 关闭注释里）证伪——asarUnpack 只能给 walker manifest 里已选的文件加 unpack 标，无法补 walker drop 到 nested-only 的 4 个包（call-bind-apply-helpers、side-channel-{list,map,weakmap}）。同步刷外部文档对齐：CHANGELOG.md 删 "重启用 asarUnpack 砍到 5 分钟" false promise 改 "前期方案证伪 + 剩余路径 = post-pack asar surgery + 暂无 active tracker"；docs-site/docs/guide/installation.md 用户面安装指南口径同步。

Why

5.0.3.31 主题是"修真问题 + 顺手清技术债"：用户反馈的自动更新和托盘菜单是真功能 bug 不能拖；CI Linux build 的 dangling symlink 是阻塞 release 的 P0；vitest 4 升级一直在 backlog 里，issue #5 直到 v4 拿掉硬编码心跳才有体面解，正好这次连同 issue #4 的 poolMatchGlobs workaround 一并退役。

[5.0.3.30 / CLI 0.161.2] - 2026-05-05 (桌面图标 + 系统托盘 + 安装恢复力)

Fixed

桌面应用图标视觉占用率不足（commit f2c8fc22f）：assets/icon.png master 圆形 logo 在 2451x2451 画布占比 ~52%（重透明边距），任务栏 + 桌面快捷方式 + 托盘渲染都比微信 / Office 等方块邻居小一圈。tools/regen-app-icon.js（sharp + png-to-ico）自动 trim 透明边、squarify bbox、重建 7 层 .ico；新 master 1282x1282，水平占比 100% / 垂直 89%。圆形 logo 固有的 π/4 比与方形 icon 视觉对比仍有差距（已写进 Known Limitations）。同批接线：BrowserWindow 加 icon: resolveAppIconPath()（dev → assets/icon.ico、packaged → process.resourcesPath/icon.ico），setupApp() 调 app.setAppUserModelId("com.chainlesschain.desktop")（不调 dev 退回 Electron 默认图标 + packaged 升级有图标关联丢失风险）；enhanced-tray-manager.js getIconPath() 候选路径之前只指向项目里压根不存在的 resources/，nativeImage 静默空、Windows 退回 fallback——补 assets/icon.ico + process.resourcesPath 进表头；electron-builder.yml extraResources 把 assets/icon.{ico,png} 拷到 process.resourcesPath，确保 packaged install 运行时 tray 找得到。
桌面 npm install 后 electron 二进制偶失（commit f2c8fc22f 同批）：desktop-app-vue/package.json 加 postinstall fallback node node_modules/electron/install.js || true。npm workspaces hoist 偶尔会让 desktop 的 electron/dist/electron.exe 缺，没这个 fallback 全新 clone npm run dev 撞 "Electron failed to install correctly" 需手动 recover。
eslint tools/ + scripts/ 范围溢出（commit f2c8fc22f 同批）：eslint.config.js 加 tools/ + scripts/ override（CommonJS、no-undef off、no-require-imports off），未来 Node helper script 不再撞 renderer-style TS 规则。
桌面主窗口最小化到系统托盘（commit d57759dc9，bundled into v5.0.3.30）：关闭按钮触发 hide() 而非 quit()，托盘图标常驻；右键菜单 Show / Quit。
桌面 installer 瘦身 357 MB / 14k 文件（commit b2e1ff27d，bundled）：electron-builder afterPack hook 过滤掉打不进生产的 devDep / 测试目录 / .bak 等无用文件。Setup.exe 装机时间天花板（文件数 × ~10ms）相应下降。
CLI prod deps 标准化注入 packaged（commit 33d40fbad，bundled）：本地 make:*:builder 链路也走 prod-deps standalone install + bundle，与 CI 路径对齐。

Why

5.0.3.30 是 5.0.3.29 之后桌面端体验线的小幅 patch，主题是 "图标视觉对齐 + workspace 残余坑收口"。功能层无变化，主要改善 packaged install 后第一印象（任务栏 / 托盘可见度）和 fresh-clone 体验。捆绑发布的 b2e1ff27d / 33d40fbad / d57759dc9 是前序未发版的 desktop work，赶 5.0.3.30 一起落 GA。

[5.0.3.29 / CLI 0.161.2] - 2026-05-05 (CI/test 稳定性收口 + 双语整站 + 桌面端体验优化)

Added

官网整站双语（commit 036bfa33e）：docs-website-v2 8 页 zh + 8 页 en 镜像（/、/cli、/web、/desktop、/security、/enterprise、/about、/404），SiteHeader/SiteFooter 检测 /en/ 前缀自动切换 nav + dictionary，"EN ↔ 中文" 双向切换。同批落地：首页"三大核心能力"屏 / Cowork 5 阶段流程图 / 6 平台 + 6 路测试细分 strip / SLA + 5 类伙伴 + 6 合作方式区块；/security 补 Trinity Trust Root v3.2 三脚（U盾 / SIMKey / TEE）+ PQC（ML-KEM/ML-DSA）+ 零知识（Groth16 + zk-STARK）+ FIPS 140-3；/about 补里程碑 + 资质双块。CLI 版本号统一引用 packages/cli/package.json，三处硬编码漂移修掉。
桌面主窗口最小化到系统托盘（commit d57759dc9）：关闭按钮触发 hide() 而非 quit()，托盘图标常驻；右键菜单 Show / Quit。

Fixed

MTC federation governance CLI 测试拆分（commit 0114aec48）：mtc-federation-governance-cli.test.js 单文件 41 测试 110-200s wall-time 触发 vitest hardcoded 60s onTaskUpdate RPC 心跳超时。拆为多文件 + poolMatchGlobs 路由到 threads pool（forks pool birpc 在 subprocess 负载下崩溃，threads 用 postMessage 不会）。issue #4 关闭。
桌面 installer 瘦身 357 MB / 14k 文件（commit b2e1ff27d）：electron-builder afterPack hook 过滤掉打不进生产的 devDep / 测试目录 / .bak 等无用文件。Setup.exe 装机时间天花板（文件数 × ~10ms）相应下降。
Node 23 native-dep prebuild 缺口排除（commit 7724ff541 + 9138aa3fa）：better-sqlite3-multiple-ciphers 只 ship ABI v115/v127/v137（无 v131），Node 23 上 npm install 级联失败 vue-tsc / ant-design-vue 等。engines.node 声明 >=22.12.0 <23.0.0 || >=24.0.0，package-lock.json engines 字段同步对齐。
桌面单元测试 RPC 饱和修复（commits 9abf81452 / 502551390）：vitest --reporter=basic --silent=true 抑制 per-test stdout RPC 流量；heartbeat-killer 干掉 hung 子进程；skill-handlers.test.js timeout 上调。
CI 测试稳定性双修（commit 2753ebf44）：stable-suite fallback 暴露的两个 unit-test 失败修掉。
官网下载链接 size 显示修复（commit 57df48852）：桌面下载卡读真 GitHub release asset size 而非占位符。
CLI prod deps 标准化注入 packaged（commit 33d40fbad）：本地 make:*:builder 链路也走 prod-deps standalone install + bundle，与 CI 路径对齐。
update-changelog job 安装 desktop deps（commit 0e34609e9）：post-workspace-refactor 后 changelog 生成需要 desktop-app-vue 的 deps。

Changed

Windows Unit Tests 标 continue-on-error（commit e0dbcb140）：等 vitest v4 升级再去掉。

Why

v5.0.3.22 → v5.0.3.29 是发布工程线最后一段稳定性收口，主题是 "把所有 CI/test/installer 路径对齐到 workspace refactor 后的新架构"。同期顺手做完官网整站双语 + 桌面端系统托盘体验优化。productVersion 跨度大但每步都是小幅 patch，无功能性变化，主要给下一次 GA 发布铺路。

[5.0.3.22 / CLI 0.161.2] - 2026-05-04 (Workspace 结构性重构 + ASAR 终结 + V5 dead-page 清理)

Changed

Workspace 重构：移除 desktop-app-vue from root workspaces（commit ad3e7d403）：根本性修复 npm workspaces hoisting 陷阱 — 此前每次发版都因 call-bind-apply-helpers 等 transitive deps hoist 到根 node_modules/ 而触发 ASAR 缺包问题（v5.0.3.7 走的是补丁性方案）。这次直接把 desktop-app-vue 从 workspace 拆出，让它有独立 node_modules/，根治第二天发版翻车的可能性。ad3e7d403 之后所有 CI/release path 都按 "non-workspace" 重新接线。
CLI 测试 sharding 替代 glob 批处理（commits 1c9db161b / 21a60f714 / b52c2f427 / a0abf544e）：vitest --shard=k/n matrix 替代易翻车的 [a-m]/[n-z] glob 批处理；9 个 push/PR workflows 加 concurrency: cancel-in-progress；integration shard 矩阵从 4 升 8 让 macos shard 4/4 上的 MTC 重型文件 hash 走他处；vitest config 内固化 silent + basic reporter。
Vite 7 + Rollup 4 strict mode 适配（commits a9418b58a / 39ebb116e / 2c1c7887c）：禁用 modulePreload polyfill、splash CSS 抽到 public/ 文件、rollup 锁 4.59.0（4.60+ source phase strict 报错）。
删除 6 个 V5 死页面（commit 5066a718d）：V6 Chat-First Shell 全量 port 完毕后清理 V5 残留；-8283 lines / +10 lines，路由表减 5 个 entries。

Fixed

call-bind-apply-helpers ASAR drop 终战（commits 496d21708 / f92505fb4 / 1c8d0994d / 99eb6b730 / 6152056e2 / 41df786f1 / 1533fc116 / d1de6b8f7 / be428a3fe / 328343642 / 4d9c21b79 / 611757f7e / 020b74f7e / aed3fcc7c / 32d23864f）：v5.0.3.7 之前已经发现，但补丁未根治。本批走完所有备选方案：禁用 ASAR、afterPack 重构、nuclear 把 dev tree verbatim 替换、extraResources 路线、最终 standalone prod-deps install + bundle。这条路线在 ad3e7d403 workspace 重构后才彻底安静下来。
Windows 冷启动 flaky 测试预热（commit 2d29bc615）：diagnostics.test.js 首次 collectDoctorReport >60s + coding-agent-envelope-roundtrip.test.js 首次 WS round-trip >5s。beforeAll 预热 + 首次请求 30s timeout。
CI release 多个角落修补（commits c4c4f0d8a / a86e05ab6 / 4aee8af0c / f5246aa5c / 8ace3d14a / afb974f0f / fefe86953 / 4ef147d53 / 016df8a0d）：saveConfig mkdir before write（fresh runner ENOENT）+ core-mtc 7 个缺失的 libp2p deps 显式声明 + web-panel npm install before build + post-workspace-refactor 各处 cd && npm ci + macOS dmg-license 安装 + AppImage embedded blockmap 验证 + create-release permissions 拓宽 + MTC governance test 已知限制文档化。
npm run dev 修（commit a84284eb6）：hoisted bin shims 残留导致 dev 启动失败，prune 掉破损的 hoisted bin shims。
桌面 backend data 路径（commit 22c0ec43d）：production 用 userData 而非 Program Files（read-only）。
桌面 webshell splash window（commit fcbf4195d）：long boot 期间显示 splash 窗给用户反馈。

Added

docs(claude) 版本号 source-of-truth 化（commit 99b5a03ac）：CLAUDE.md 把 productVersion / CLI version 等版本字段直接指向源文件（package.json 的 productVersion / packages/cli/package.json 的 version），不再在多处复制粘贴。配合本仓库三站 tagline 同步策略。

Why

v5.0.3.7 → v5.0.3.21 期间 ASAR call-bind-apply-helpers drop 反复发作，每次发版都得加新补丁。ad3e7d403 直接拆 workspace 是结构性根治 —— 自此 nested node_modules/ 物理上就有这些包，electron-builder walker 不可能再选错。同期把 V5 dead pages 删掉、CI sharding 升级、Vite 7 适配三件事打包做完，避免下次发版再被翻出。productVersion 从 .7 跳到 .21 → .22 跨度大但中间多个版本只是 release attempt 失败重试，没有功能性新增。

[5.0.3.7 / CLI 0.161.2] - 2026-05-03 (发布工程硬化：Express@5 ASAR hoist 修 + dev/CI 收口)

Fixed

Express@5 ASAR hoist 陷阱修复（commits 496d21708 / f92505fb4 / 1c8d0994d）：npm workspaces 把 Express@5 拆出的 transitive deps（call-bind-apply-helpers 等）hoist 到根 node_modules/，electron-builder files: node_modules/**/* 只看 desktop-app-vue/node_modules/，结果 ASAR 缺包导致打出来的 .exe 启动报 Cannot find module 'call-bind-apply-helpers'。修复方案三层兜底：（1）496d21708 让 ASAR 物理上一定带上 Express@5 transitive 细包；（2）f92505fb4 把 package-lock.json 同步到 nested node_modules/ 真实状态 + productVersion v5.0.3.6 → v5.0.3.7；（3）1c8d0994d ci-release hard-fail 校验 split deps 是否落进 nested node_modules/，缺包直接挂 CI。
npm run dev 修复（commit a84284eb6）：hoisted bin shims 残留导致 dev 启动失败，prune 掉损坏的 hoisted bin shims。
electron-builder release 链路收口（commits cf29f2ef1 / 8c0dc5e8f / b050abafd / 73415b67e / 5f1dac021 / da8ed9d91 / 8d5890bfd）：electron-builder.yml 资源路径修复 + Linux .deb maintainer/vendor 元数据补齐 + icon.ico 256x256 + drop missing afterSign hook + npmRebuild: false 让原生依赖走预编译 + --publish never + gh release upload 拆分（不再依赖 GH_TOKEN）+ Linux AppImage blockmap 缺失降级为 warning。

Added

CI release 测试链路 escape hatch（commit 8d2defd90 / 24427e4c8）：feat(ci): add skip_tests input to Publish to npm workflow，手动发布时可跳过 CLI 集成测试。
CLI publish IPC 饱和修复（commits 5d3a3dc49 / c2746e41b / b68fff118 / 4e50d9691）：--no-file-parallelism + 静默 vitest + 分批跑集成测试避开 onTaskUpdate timeout。

Why

v5.0.3.6 → v5.0.3.7 是发布工程线的硬化批次，无新功能。Express@5 ASAR hoist 陷阱在 v5.0.3.5 之前发布的 Windows 安装包中潜伏（dev 跑得通因为 hoist 到根 node_modules/ 仍可解析；release 装出来的 .exe 跑不通），由 496d21708 / f92505fb4 / 1c8d0994d 三连击根治。同期把 electron-builder 在 macOS DMG / Linux .deb / icon / 签名 / 发布流程上的零碎 fix 一次性收口，避免下一次发布再碰同类问题。产品功能面延续 v5.0.3.5 时的 MTC v0.11 + Web Panel i18n M3，本次部署主要是把发布工程稳定性传导到下游。

[5.0.3.5 / CLI 0.161.2] - 2026-05-03 (MTC v0.6→v0.11 doc roll-up + 跨链桥 + 治理自动同步 + 链上锚定)

Added

MTC v0.11 — 跨联邦互信 + 离线审计 + 链上 governance-anchor + 监控仪表盘（commit b312563f0）：cross-trust-create / cross-trust-validate 实现联邦间显式背书（multi-hop 信任链可达）；auditGovernanceLog 纯函数离线复盘整条治理日志；computeGovernanceSnapshotHash + buildGovernanceAnchorRecord + verifyGovernanceAnchor 把治理快照锚定到链（Q-COMP-3 已解锁，提供 InMemoryChainAnchorClient / FilesystemChainAnchorClient 抽象）；监控仪表盘聚合 sync stats / SLA / gas-aware 路径选择。
MTC v0.10 multi-proposal CRDT picker + governance ops 测试（commits 66ddc1566 / aedee372d / 6e90faa9d）：单成员视角同时存在多个 propose-revoke / propose-threshold 时，UI 用 CRDT picker 排序展示；live sync stats + libp2p smoke 强化；桌面 V6 widget surfaces governance-sync-stats（v0.10.1）。
MTC v0.9 治理 GUI（桌面 V6 + Web Panel）（commits a8fff1f52 / 9ad09446f）：操作型治理 tab 在桌面 V6 widget 与 Web Panel Mtc.vue 落地；签名密钥仍 CLI-only。
MTC v0.8 跨成员 governance.log 同步（commit bb88756d6）：filesystem drop-zone + libp2p gossipsub 双路径；service supervisor 模板（governance-sync-serve 长跑守护进程）；dedup by event_id + 时序回放最终一致。
MTC v0.7 联邦治理 CLI + 桥接 MTCA 守护（commit 1c1e4096d）：cc mtc federation {invite,vote,propose-revoke,confirm-revoke,rotate-key,propose-threshold,confirm-threshold,fork,merge} 共 11 个治理子命令；bridge MTCA 守护进程；V6 widget 接入。
MTC v0.6 跨链桥集成（commits 0123fd168 / 5a9898028）：cc crosschain mtc-batch / mtc-status 把 MTC 树头作为跨链证明随消息上链；bridge MTC opt-in flag + e2e 覆盖。
CLI 0.161.2：上述 30+ 子命令端到端集成测试（114 个），cc audit mtc enable/disable/config/... 双轨脚手架（off-by-default 等 Q-COMP-1/2 出函）。

Changed

docs-site/docs/chainlesschain/mtc.md 全文重写 — 从 v0.3 (Phase 1+1.5, 154 测试, 6 子命令) 升级到 v0.11 (Phase 0–4 全量, 476 测试 / 6 层, 30+ 子命令)。新增章节涵盖 SLH-DSA-128F 双轨签名、联邦 M-of-N 多签、链下治理日志 + 11 事件类型、跨成员同步守护、quorum 门控、跨联邦互信锚（multi-hop）、离线审计器、链上 governance-anchor、Marketplace publisher daemon、cross-chain bridge 集成、audit MTC 双轨等。
三站 hero / changelog 同步 — docs-site package.json 5.0.3.4 → 5.0.3.5；docs-site-design hero 更新 v5.0.3.5 | CLI 0.161.2 | MTC v0.11；docs-website-v2 已在 commit 31cb1c8a0 完成。
electron-builder release path 修复（commits 2cc8a6200 / 8c0dc5e8f / b050abafd / 73415b67e）：differential-update sidecars + ENOENT chainlesschain symlink + Windows distutils + 禁用 npmRebuild 让原生依赖走预编译路径。
桌面系统设置稳定性（commit b19f05966）：BOM 容忍 + IPC export 修复 + schema gaps 补齐。
桌面回归测试加固（commit 488ca8b11）：ensureOpsPlaybookDescription 迁移路径 + verify-release-artifacts 测试覆盖。

Why

v0.6→v0.11 是 MTC 从「Phase 3 联邦机制层完成」走向「Phase 4 治理 + 跨链 + 链上 + 监控完整运营层」的批次落地。b312563f0 标志着 MTC 不再是孤立的签名压缩工具，而是具备联邦自治 + 跨联邦互信 + 链上不可篡改锚定 + 离线审计可复盘的完整证书系统。本次发布把 v0.6 起的所有功能一次性 roll-up 进文档站，让用户文档与设计文档对齐到 v0.11 现状；MTC 用户文档的全文重写则是把"用户视角的 MTC"从 v0.3 快照刷新到 v0.11 完整能力面。

[5.0.3.4 / CLI 0.160.1] - 2026-05-02 (Web Panel i18n M3 全覆盖 + V6 LanguageSwitcher + web-shell opt-out + projects folder picker)

Added

Web Panel i18n M3 — ~25 视图国际化大批量收口（commits b69ed7cef / fac49c07d / 1c9c8a9a1 / 431714a8b / 0306474a8 / f357289e9 / c089ce07d / 18524d971 / 5f45b6379 / 443d3eceb / 91563a092 / 28b46d4bf / 587534ef3 / 93d41459c / 32ff8e36c / cb46f7755 / fd61758a1 / 92792a52b / 332ff60f6 / 89ba2cb5c / 7eadd0565 等）：把 web-panel 主要视图全部改用 vue-i18n 字典，覆盖 SpeechSettings / Analytics / Cron / Security / Templates / Search / Audit / McpTools / Backup / Tokens / Mtc / WebAuthn / Community / Wallet / Inference / Organization / Recommend / Federation / Reputation / AIOps / Projects 等 ~25 视图。中英双语贯通，硬编码字符串清零。
V6 Preview LanguageSwitcher（commit 645b19f30）：V6 preview 壳顶栏接入语言切换器，与 web-panel i18n 字典共享。
web-shell --no-web-shell dev opt-out + settings-authoritative precedence（commit 9119bdec1）：默认 ON 后给开发者保留快速回桌面 V6 壳的开关；setting 中显式选择优先于命令行。
cc init --cwd + projects folder picker（commit c935a95d4）：projects 视图增加"打开已有文件夹"流，走 cc init --cwd <dir> 把任意目录初始化为 ChainlessChain 工作区。

Changed

仓库根 productVersion v5.0.3.1 → v5.0.3.3 → v5.0.3.4（commit 8c68970cf 起）；CLI npm 包 0.158.0 → 0.160.0 → 0.160.1（含 web-panel dist 重打包 commit edaf61d2b）。
三站 tagline / hero chip / 模块清单同步刷新到 v5.0.3.4 / CLI 0.160.1 / 112 命令。

Why

i18n M3 是「web-panel V5→Web 全量化收官（Phase A+B+C+D = 23 ports）」之后的国际化补丁层，把所有迁移过来的 V2/V3/Phase 视图统一接入 vue-i18n。结合 V6 preview LanguageSwitcher，让 ChainlessChain 浏览器端 + 桌面端预览壳一次性获得中英双语能力。--no-web-shell 是 web-shell 默认 ON 后的运维出口；folder picker + cc init --cwd 则补齐了 projects "打开已有文件夹" 这条 V5 时代缺失的流程。

[5.0.3.3 / CLI 0.160.0] - 2026-05-01 (MTC v0.5 — Phase 3 federation 全套 + libp2p auto-discovery)

Added

MTC Phase 3.1 多签 landmark + cc mtc federation {join,leave,status}：本地 registry（atomic write、wx race-safe），M-of-N 多签 landmark 生成。
MTC Phase 3.2 多签发布：cc mtc batch* / publish-skills --federation <id> --threshold <M>，把已有 batch / skill 发布命令对接到联邦多签路径。
MTC Phase 3.3 --transport filesystem 跨进程发现：drop-zone 跨进程发现（NFS / Syncthing / SMB / USB），自签 announce schema mtc-federation-announce/v1 + TTL-evicting 名册。
MTC Phase 3.4 --transport libp2p 真 P2P auto-discovery（commit d75abe6e8）：libp2p gossipsub topic mtc-federation/v1/<id> 自动发现，Libp2pTransport 加 publishRaw / subscribeRaw 通用 pubsub API（与 landmark 通道隔离）。
Backend Q-ENG-2 OperationLogService 桥接：cc audit mtc emit 捕获 event_id 写回 audit_mtc_event_id 字段（V013 migration），web-panel Audit.vue 加 4 态 MTC 列徽章（— / 已签未查 / 待关批 / 已关批 #N）。
异构联邦支持：同一联邦内 Ed25519 + SLH-DSA 节点共存，多签门限按签名抽象层验证。

Fixed

MTC v0.5 sweep（commit f7e333a41）：drawer 错调 electronAPI.fs.readFile → 改 file.readContent；libp2p 节点 init 异常路径 cleanup；filesystem discover daemon scan 重入锁；federation join wx 独占创建。

测试

476 MTC 测试全绿：core-mtc 182 + CLI 89 + desktop 33 + web-panel 153 + backend 19，跨 6 层覆盖（unit / integration / e2e / desktop-renderer / web-panel-renderer / backend-spring）。

Added

cc mtc publish-skills marketplace publisher 守护进程：JCS-canonicalize → SHA-256 fingerprint 差量检测 + 自动 seq 递增 + 状态文件原子写（temp + rename，崩溃不污染）。
cc audit mtc {enable, disable, config, set-interval, emit, reconcile, reconcile-check, status} 双轨脚手架：每事件实时 Ed25519 落盘 + 关批 Merkle 树 inclusion proof，幂等关批 + atomic rename 崩溃恢复，schema/filename 三路验签拒伪事件。60s/3600s 双合规路径预留。
Phase 1.6 SLH-DSA real signing（FIPS 205 后量子签名 hard-flip）：--alg slh-dsa-128f opt-in，原 Ed25519 路径仍默认。
Phase 4 V6 status widget：/v6-preview 壳新增 MTC 状态 widget，跑流水显示 batch / federation / audit 三段。

Changed

assembleBatch 抽到 core-mtc/lib/batch.js 公用，CLI mtc / audit / 未来发布路径同一条装配代码。
设计文档 v0.3 → v0.4，docs-site 用户指南 + 设计站均同步。

Note

Audit 产线启用仍待 Q-COMP-1（等保三级最终性窗口）+ Q-COMP-2（T/ZGCMCA 023—2025 条款）法务出函；脚手架已就位，出函后单一 cc audit mtc enable --interval <60|3600> 即上线。

测试

222 测试全绿：core-mtc 147 + CLI 64 + desktop V6 widget 11，四层覆盖 unit / integration / e2e / desktop-renderer。

[5.0.3.1 / CLI 0.157.9] - 2026-04-27 (web-panel V5→Web 全量收官 — Phase B/C/D 一日连发)

Added

Phase B 收官 — 普惠与去中心化 10/10（commits 367132348 / c304b9d8b / 10f3451a6 / 864873047 / bfeb8091f，CLI 升 0.157.7）：
- B6 /privacy — FL 联邦学习 + MPC 多方计算 + DP 差分隐私 + HE 同态加密（cc privacy）
- B7 /inference — 节点注册 + 任务调度 + 隐私模式（cc inference）
- B8 /nlprog — 意图分类 + 实体抽取 + 翻译 + 编码约定（cc nlprog）
- B9 /tenant — 4 档计划 + 用量计量 + 配额检查 + MRR（cc tenant）
- B10 /pipeline — 7 阶段流水线 + 部署策略 + 模板（cc pipeline）
Phase C 治理与可观测 5/5（commits f25896cd2 / bc52ad5ec / 3b0f17292 / 02fb827c4 / c80cd2292，CLI 升 0.157.8）：
- C1 /governance — 提案 + 加权投票 + 影响分析 + 预测置信度（cc governance）
- C2 /audit — 审计日志检索 / 过滤 / 导出 + 合规留存（cc audit）
- C3 /reputation — exp/linear/step 衰减 + z_score/iqr 异常 + 模拟贝叶斯（cc reputation）
- C4 /recommend — 兴趣画像 + 主题评分 + 时间衰减 + 反馈回路（cc recommend）
- C5 /sla — 分级目录 + 方向感知偏离 + p95 + 补偿封顶（cc sla）
Phase D 收尾 5/5（commits fa8479d49 / da852045d / 6e1941beb / 6b7ac0985 / a7909b8a6，CLI 升 0.157.9）：
- D1 /codegen — 生成跟踪 + 5 规则安全审查 + 脚手架目录（cc codegen）
- D2 /search — 多维搜索 / 日志查看（cc search）
- D3 /tokens — Token 账本 + 7 类贡献奖励 + 排行榜（cc incentive）
- D4 /trust — 信任根 + PQC 互操作 + 卫星 + HSM（cc trust）
- D5 /federation — 熔断器 FSM + 健康检查 + 连接池 + 节点健康聚合（cc federation）

Changed

web-panel 路由数 28 → 50（+22）：cumulative Phase A (3) + B (10) + C (5) + D (5) = 23 V5→Web 端口完成。从此 cc ui 浏览器端与桌面 Electron 端功能对等覆盖去中心化身份 / 知识图谱 / 跨链 / 隐私计算 / 推理网络 / NL Programming / 多租户 / Pipeline / 治理 / 审计 / 信誉 / 推荐 / SLA / 代码生成 / 信任根 / 联邦熔断全部子系统。
web-panel 单元测试 27 → 1489 全绿（含全部 Phase A/B/C/D parser）。
仓库根 productVersion v5.0.2.55 → v5.0.3.1（V6 hard-flip 后的 minor bump，跳过 .3.0 CI hotfix 占位）。
三站 tagline / hero chip / 模块清单同步刷新到 v5.0.3.1 / CLI 0.157.9 / 50 routes。

Why

继 2026-04-26 web-panel Phase A + B (1–5) 落地之后，今日（2026-04-27）一天内连续完成 B6–B10 + Phase C + Phase D 共 15 个新视图，完成 V5→Web 全量化迁移。所有视图遵循机械模板 = <feature>-parser.js（含 stripCliNoise） + <Feature>.vue + router/sidebar 接线 + parser 单测 + 路由计数 +1 + 路径断言。CLI 三次 bundle release（0.157.7 / 0.157.8 / 0.157.9）每次随 web-panel dist/ 资产 hash 同步刷新（commits de3da1fd7 / dc44c91b8 / 589a7acd8 / 1faa9e11f）。

测试

web-panel 单元：1489/1489（27 → 1489，覆盖率 ×55 增长）
vite build 全绿，所有 chunk gzip 后均 ≤ 30 kB

[Unreleased] - 2026-04-26 (V6 shell 硬翻 + top-10 parity 10/10 + web-panel Phase A)

Added

V6 widget probe 6 颗：每颗按 5-7 文件模板（plugin.json + Widget + Panel + 可选 thin store + AppShell wiring + 集成测试），贡献 /<route> slash + Home 页 widget + Phase 3.3 modal panel
- did-management → /did (commit 35f4e278b，thin store 包 did:get-all/get-current/set-default)
- projects → /projects (commit a097596f5，thin store 包 project:get-all recent-5)
- p2p-messaging → /p2p (commit 3883a72ec，thin store 包 node-info/peers/nat-info graceful)
- community → /community (commit 5b5e6fe1d，thin store 包 community:get-list)
- ai-chat → /chat (commit 396d6e7b1，gating route，thin store 包 llm:check-status + llm:get-config)
- settings → /settings (commit ccbc312fd，pure-info panel 列出 7 个 SystemSettings sub-pane)
web-panel /did + /knowledge + /project-settings 三路由（commits f37aa44d0 / c0e96c9e0 / d1f22ce2d）
- /knowledge 4-tab：力导向图（ECharts）/ 实体表 / 关系表 / 类型分布；CRUD + 多跳 BFS reasoning，全部走 cc kg --json
- /did 复用 cc did *；助记词/DHT 按钮 disabled + tooltip "桌面专属"
- /project-settings 4 字段，走 cc config get/set project.*，diffProjectConfig 只对改动字段发 set
新依赖：echarts ^6 + vue-echarts ^7（web-panel）
预约 remote agent：trig_013pjiuMPAUkNyoE4QxVdee8 在 2026-05-10 09:00 Asia/Shanghai 自动巡检 V6 硬翻部署后 14 天的 git/issue/test/notes 状态

Changed

V6 shell 默认开关硬翻（commit caaddf530）：
- router/v6-shell-default.ts 初始 useV6ShellByDefault false → true
- main.ts setV6ShellDefault(raw === true) → setV6ShellDefault(raw !== false) — 配置未设值默认 V6，仅显式 false 才回 V5
- SystemSettings.vue 表单 initializer 与描述文字同步
- opt-out 通道与 resolveHomeRedirect() 纯函数都没动（"no other code needs to move"）

Fixed

SystemSettings "立即试用" link 漂移（commit 72b826bdf）：之前 router.push("/v2") 但 router 守卫 redirect 是 /v6-preview，两处统一到 /v6-preview

Why

继 2026-04-21 Phase 3.4 软开关之后，top-10 V5 routes 还差 6 个没 V6 widget。这次一口气补齐 (settings/projects/chat/did/p2p/community)，凑出 V6 hard-flip parity 条件。硬翻保留 opt-out 开关，老用户出问题可一键回 V5；同时预约 14 天后的自动巡检 agent 监控回归信号。

测试

19/19 plugin-extension-points integration · 8/8 slash-dispatch · 9/9 v6-shell-default · 621/621 web-panel unit · 509/512 desktop integration（3 失败 pre-existing 网络依赖，非今日引入）

[Unreleased] - 2026-04-26 (默克尔树证书 MTC Phase 1 + 1.5 全部落地)

Added

@chainlesschain/core-mtc 新包：完整 MTC 协议实现，137 测试全绿
- RFC 6962 Merkle 树（MerkleTree 类，O(log n) 取证 + 子树根 memo）
- Verifier 纯函数（按数据格式 §11 错误码）+ LandmarkCache 含 split-view 防御
- LandmarkCache 持久化（persistDir + loadFromDisk，篡改检测）
- Ed25519 真实签名（lib/signers/ed25519.js，stopgap，待 SLH-DSA @noble/post-quantum）
- 4 种传输：InMemoryTransport / FilesystemTransport（drop-zone）/ Libp2pTransport direct（TCP+Noise+Yamux）/ Libp2pTransport gossipsub（@chainsafe/libp2p-gossipsub@14）
cc mtc CLI 6 子命令（17 集成测试全绿）：
- cc mtc batch <input> — 通用批次构造
- cc mtc batch-dids — 从本地 DID DB 读身份构造批次
- cc mtc batch-skills — 从本地 CLI 技能构造批次（Marketplace 路径）
- cc mtc verify <envelope> --landmark <landmark> — 验证 inclusion proof
- cc mtc landmark inspect — 查看 landmark 元信息
- cc mtc serve — verifier 守护进程（订阅 + 持久化 + 自动验证）
设计文档：docs/design/默克尔树证书_MTC_落地方案.md v0.3、MTC_数据格式_v1.md v0.1、默克尔树证书_MTC_v0.2_评审清单.md

Why

为 ChainlessChain 切换到后量子签名（SLH-DSA-128f）做准备。直接套 PQC 会让 DID 文档单签从 64 B 暴涨到 17 KB，DHT 周流量从 5 GB 涨到 170 GB（不可接受）。MTC 通过批量签发 + Merkle inclusion proof 把单证书携带物压回 ~700 B，节省约 97%。

借鉴 IETF PLANTS WG 的 Merkle Tree Certificates 协议（draft-ietf-plants-merkle-tree-certs-02），与 Cloudflare + Google Chrome 联合推进的 HTTPS 后量子证书方案同源。

[5.0.2.54 / CLI 0.156.7] - 2026-04-26 (技能数对齐 141 · ws-server CI 解锁 · release-tag 链路修复)

Fixed

release-tag 工作流: v5.0.2.53 的 create-release 步因走旧路径执行了 --cleanup-tag（先删后建），命中 GitHub "tag was used by an immutable release" 锁定窗口，HTTP 403。改成 gh release edit（存在则就地编辑，否则 create），避开 delete+recreate 循环，新 tag 正常落地。
CI ws-server 集成测试解锁: wss.close() 增加 2s 硬上限超时熔断，CI 上不再因 socket 残留挂死整个测试套件。

Changed

桌面技能数全面对齐 141: 文件系统真实数 144（其中 3 个为模板/示例 skills 不计入用户面），跨 9 个文件 16 处「139 内置技能」统一刷新到 141。覆盖 README header、docs-website-v2（web/desktop/cli/BaseLayout/Terminal/index 共 5 文件）、docs-site/overview.md（3 处）、packages/cli/README.md（2 处）、AnalyticsDashboardPanel.vue 与 CLAUDE.md。
仓库根 productVersion v5.0.2.53 → v5.0.2.54（commit d343fe50b），CLI npm 版本保持 0.156.7。
桌面端持续 SFC 拆分推进：AdditionalToolsStats.vue 抽出 chart-image 导出 helpers，MainLayout.vue 抽出 getMenuIcon，ChatPanel.vue 再抽 5 个 helper，MCPSettings.vue 拆出 MCPToolTestModal + mcpToolUtils，ProjectsPage.vue / PreviewPanel.vue 抽纯函数，新增 useProjectGit composable。

[5.0.2.53 / CLI 0.156.7] - 2026-04-25 (docs-gen 链路收口 · pack 错误信息增强 · CI E2E 拆批)

Fixed

docs-gen 链路稳定化:
- validate-docs 在 artifact 缺失时降级为 warning 而非 fail（修自动 release tag 链路偶发抖动）。
- 自动触发的 docs-gen 跳过 changelog 重生，避免 per-push 反复 churn；只在 release tag 上重生 CHANGELOG。
- releaseNotes 死配置移除；release-tag 工作流改为 edit-in-place 而非 delete+recreate，避开 immutable-tag lock 报错。
cc pack 安装上下文感知: 当 @yao-pkg/pkg 缺失时，输出按当前是 npm 全局/项目本地/源码仓库三种安装方式分别给出对应 npm i -D / npm i -g 提示，避免用户拿到通用一句话而无所适从。
CI 稳定性: CLI E2E 套件按 vitest pool 拆 2 批，避免 RPC timeout（>60s 整批挂掉）。

Changed

仓库根 productVersion v5.0.2.52 → v5.0.2.53（commit 3c97894f9），CLI npm 版本保持 0.156.7。

[5.0.2.52 / CLI 0.156.7] - 2026-04-25 (AIChatPage 工具外提 · 死测试清理 · CI 稳定性)

Added

AIChatPage.vue 纯工具外提 — 从渲染器最大组件抽出 aiChatPageUtils.js，把无 reactive 依赖的 helper（path/filename 处理、IPC 数据清洗等）下沉到 sibling 文件，为后续按区域拆 SFC 做准备。

Fixed

CI 稳定性:
- ws-server-workflow 整 describe 在 CI 环境 skip（本地仍跑），消除 60s+ 超时挂死。
- 4 个 ws-integration 测试在 CI skip（>60s hang）。
- pipeline integration 在 Linux host 改用 foreign target，避免 host-arch 检测路径差异。
- ws-server-workflow 单测 timeout 提到 60s。

Changed

死代码清理:
- 移除 10 个 skip-only 测试 shell（−5856 行），它们只剩 describe.skip/it.skip 没有实际断言，留着只增加 noise。
- ws-server-workflow 内层 skipOnCI/itCI 哨兵移除（外层 describe.skip 已覆盖）。
仓库根 productVersion v5.0.2.51 → v5.0.2.52（commit ed7d9bb64）。

[5.0.2.51 / CLI 0.156.7] - 2026-04-24 (precheck 跨平台修复 · pack --project 侧边栏)

Fixed

cc pack precheck: POSIX 下 cliRoot 解析与 runtime-factory 的 uiMode 推断口径对齐，修部分 Linux/macOS 环境下 precheck 误报"非 CLI 工作区"。
docs-gen 头部稳定: 自动生成的文档头去掉 volatile ISO 时间戳，避免每次 push 都产生纯时间戳 diff。
CI 矩阵: cli-ci 矩阵改 fail-fast: false，让一个矩阵格失败不再连带杀掉其他平台/Node 版本。

Added

设计文档站侧边栏: cc pack --project 项目模式 设计文档入口加入设计站侧边栏 /cc-pack-project-mode-design。

Changed

仓库根 productVersion v5.0.2.50 → v5.0.2.51（commit 2b0c5027e）。

[5.0.2.50 / CLI 0.156.7] - 2026-04-24 (cc pack 项目打包 · OTA 三段 · Linux x64 流水线)

Added

cc pack 命令首发（Phase 0+1） — 把当前 ChainlessChain CLI 工作区 + node_modules 打成单文件可执行程序（基于 @yao-pkg/pkg）。最小入口：cc pack → dist/chainlesschain-portable-<target>.exe。配套首版 design doc。
cc pack --project 项目模式（Phase 2a-3b 全量落地）:
- Phase 2a · BAKED 字段 — 项目根的 .chainlesschain/ 内容（config / skills / rules / persona）被烤进产物，配合 sanitizeProjectName + CC_PROJECT_ROOT 环境变量串起项目身份。
- Phase 2b · GET /api/skills 实接线 — web-ui-server.js 暴露 {schema:1, skills:[…]} 端点（SPA + minimal 双路径），由 CLISkillLoader.loadAll() 驱动；smoke-runner 从 pre-wired 升级为真实断言（保留 v0.3 的 404 容忍分支作前向兼容）。
- Phase 3a · 子命令白名单 — Commander allowedCommands 收敛产物可用子命令面（项目模式默认只暴露与该 persona 相关的命令）。
- Phase 3b · 自动 persona + manifest sidecar — 产物启动时自动激活项目 persona（CC_PACK_AUTO_PERSONA），同时输出 <artifact>.pack-manifest.json 描述 bundledSkills / persona / 构建时戳。
- 配套 design doc 升级到 v0.4，单元 + 集成 + e2e stub 测试齐全。
OTA 自更新三段（Phase 5a-5c）:
- 5a cc pack check-update — 探测远端 OTA manifest，比对本地 artifact 与远端最新版本。
- 5b 制品下载 + SHA-256 校验 — 流式下载 + 校验失败回滚。
- 5c --apply 自替换 — POSIX 走 atomic rename，Windows 走 sidecar 脚本（绕开 Windows 文件锁）。
Phase 4a · Linux x64 打包流水线 — CI 加 Linux x64 矩阵格 + 守卫，保证 Linux 产物随每次 release 一并打出。
@chainlesschain/core-db sql.js WASM 兼容层 — loadSQLiteDriver 增加 ABI probe，better-sqlite3 不可用时优雅降级到 sql.js（首屏不再因 native 缺失硬挂）。
桌面端 HarnessTaskDrawer 拆分 — 从 ChatPanel 抽出独立 SFC，浏览器扩展相关 IPC handler 同步拆出。

Fixed

桌面端 6 个页面 $router 替换为 useRouter() — 修 setup script 中误用 options-API 全局 $router 导致 hot-reload 边界偶发 undefined。
desktop-app-vue electron forge 打包路径疏通。

Changed

CLI npm: chainlesschain@0.156.6 → 0.156.7。
仓库根: productVersion v5.0.2.49 → v5.0.2.50（commit cd98f4dc9）。
三站 tagline 与 deploy 脚本同步刷到 v5.0.2.50 / CLI 0.156.7。

Added

V6 Preview Shell 工具/任务 Widget — /v6-preview 新增工具调用与任务进度两个 Widget；web-panel ClaudeBox 风格工具卡同步在 Chat View 上线（Phase 75 路由子页计数刷新到 27）。
跨平台 postinstall — chainlesschain npm postinstall 改写为 Node 脚本（不再依赖 bash），修 Windows 全局安装时 bash: not found 失败。
IPC 契约测试锁定:
- agents / autonomous / ai-engine IPC channel 契约测试。
- code-agent-ipc handler 覆盖。
- a2a + collaboration-governance + tech-learning handler 覆盖。

Fixed

XSS 防护双补丁:
- 所有 v-html 路径强制走 sanitizer，对应 lint rule 从 warn 翻成 error。
- renderMarkdown 通过 DOMPurify 串接，GlobalSearch 高亮路径同步修复。
CI: 桌面 unit-test matrix 加入 macOS 平台。

Changed

CLI 治理 v2 共享 helpers 抽取 — 把分散在多个 V2 governance surface 的样板代码抽进 governance-v2 共享模块，并附迁移指南；后续 V2 surface 添加复杂度下降。
CLI npm: chainlesschain@0.156.5 → 0.156.6。
仓库根: productVersion v5.0.2.43 → v5.0.2.49（commit fdc9df624，跳过 .44–.48 未发布的中间号）。
文档:
- Signal Protocol 依赖风险与迁移选项设计文档落地。
- God Component 拆分路线图（AIChatPage.vue + background.js）入设计文档。

[5.0.2.43 / CLI 0.156.6] - 2026-04-22 (MainLayout + DIDManagement SFC 拆分 · Shell 接入真实 LLM · 启动流程拆 Critical/Deferred · 重型组件懒加载 · CLI postinstall 跨平台)

Fixed

CLI postinstall 跨平台 — chainlesschain@0.156.5 把 postinstall 脚本改写成跨平台 Node 实现，修复 Windows 全局安装时 bash: not found 导致失败的问题；0.156.6 为随后的打包补丁。

Added

MainLayout.vue 六级拆分 — 把原 3203 行桌面壳按功能切成 6 个独立 SFC，累计 3203 → 1943 行（−39%）：
- FavoriteManagerModal.vue（151 行） — "管理快捷访问" 弹窗，Favorites / Recents Tab。
- HeaderBreadcrumbs.vue（170 行） — 135 行 breadcrumbs computed（7 路由前缀分支），router.push 点击处理。
- SyncStatusButton.vue（97 行） — 全局同步状态按钮，自管 isSyncing / syncStatus / syncError + 3 个事件监听。
- VoiceCommandHandler.vue（584 行） — VoiceFeedbackWidget + 75 条语音命令模式表 + 7 个语音识别/转发 handler。
- SidebarContextMenu.vue（97 行） — 侧边栏右键菜单，show(event, item) 命令式暴露，14 个调用点不变。
- AppHeader.vue（210 行） — <a-layout-header> 整块（侧栏切换 / 面包屑 / Ctrl+K / 同步 / AI / 语言 / 通知 / 用户菜单）。
DIDManagement.vue 三级拆分 — 把原 1390 行组件切成 3 个子组件，累计 1390 → 543 行（−61%）：
- AutoRepublishSettingsPane.vue（148 行） — 自动重发布设置弹窗 + 状态轮询。
- MnemonicModals.vue（308 行） — 助记词展示 + 导出两个弹窗合一，defineExpose({showDisplay, triggerExport}) 命令式 API。
- IdentityDetailsModal.vue（约 421 行） — 身份详情 / DID Document / QR 三个弹窗合一 + DHT publish/unpublish。
Shell 接入真实 LLM — V6 预览壳 ShellComposer 真正可发消息：
- handleSend() 接入 llm-preview-bridge：优先 sendChatStream (prompt-only) 走 queryStream 流式；失败回退 sendChat (带 history) 非流式。
- ConversationStream 新增 typing indicator（3 点波浪），无 DID chip 视觉噪音。
- 开发基于现有 useConversationPreviewStore：beginStreamingAssistant / updateAssistantContent / finalizeStreamingAssistant / removeMessage。
主进程启动拆 Critical / Deferred — bootstrap 按阶段分两段，main/index.js 改走 fast-start：
- bootstrapCritical() 仅跑阶段 0-5（Hooks / 核心 / 文件 / LLM / 会话 / RAG+Git），splash 5-55%。
- bootstrapDeferred() 跑阶段 6+，splash 55-90%。
- IPC 注册拆 registerCriticalIPC() + registerDeferredIPC()，setupIPC 在 createWindow 内仅调用一次（避免 llm:chat / conversation:* 二次注册与 ipc-guard 竞态）。
- CHAINLESSCHAIN_LEGACY_BOOT=1 保留旧单阶段启动回退开关。
重型渲染器组件懒加载 — 5 个重型编辑器改 defineAsyncComponent：
- FileEditor.vue → Monaco（~5MB）。
- KnowledgeDetailPage.vue → Milkdown MarkdownEditor（~1.5MB）。
- DesignEditorPage.vue → Fabric.js DesignCanvas（~1MB）。
- ProjectDetailPage.vue → CodeEditor / MarkdownEditor / WebDevEditor 一次三件（共 ~5MB）。
- 实测 monaco 独立 chunk 3.7MB / gzip 938KB，首屏不再强拉。
后端服务并行轮询 — BackendServiceManager：
- 4 个服务改并行轮询（原串行 4×30s），单服务最多 10s，新增 servicesReady Promise 供调用方 await。
- startServices() 不再阻塞启动，触发后即返回。

Changed

Phase 3.4 软开关重定向目标：/v2 → /v6-preview — router/v6-shell-default.ts::resolveHomeRedirect 的 opt-in 目标由 /v2 改为 /v6-preview（Claude-Desktop 风格预览壳），让默认开启场景直接进入真实可用的新壳；同步 9/9 单测 + JSDoc 注释已对齐。
SyncStatusButton 取消 prettier 多行格式，紧跟项目样式规范。
components.d.ts 自动生成文件分号风格对齐。

Verified

Store 测试 600/600 绿（23 文件，35s）。
Shell + router + bootstrap 定向测试 76/76 绿（5 文件）。
Skill-handlers + ipc-guard + bootstrap 285/285 绿。
Vue 组件测试 124/125（1 skip）。
AI + core + multi-agent 单元测试 411/413（2 skip）。
Database + enterprise + did + knowledge 单元测试 1456/1464（8 skip）（3 stderr 错误是预存在的测试脚手架 no such table: skills / pubsub.addEventListener，非本次引入）。
shell-preview 组件/服务/widgets 51/51 绿。
集成测试（mcp / canonical-tool / canonical-workflow / code-execution / file-ops / plugin-ext / coding-agent-hosted-tools / planning-ipc / lifecycle）98/104（6 skip）。
Smoke：vite build + build:main 均成功；eslint 0 errors。
E2E：playwright 1017 测试 / 163 文件全部可枚举；环境健康检查 80%。

[5.0.2.43 / CLI 0.156.4] - 2026-04-21（下午）(SystemSettings / ChatPanel SFC 拆分 + CI/Release 修复)

Added

SystemSettings.vue 六级 Pane 拆分 — 把原 3444 行单文件按功能切成 6 个独立 SFC：
- P2PNetworkPane.vue（830 行） — 流量层 / WebRTC / NAT / Circuit Relay / 网络诊断
- SpeechRecognitionPane.vue（421 行） — Web Speech / Whisper API / Whisper Local / 音频处理
- LLMPane.vue（622 行） — 7 个 Provider 表单 + 对话/嵌入连通性测试
- DatabasePane.vue（约 280 行，自包含） — db 位置 / 迁移 / 备份管理
- ProjectPane.vue（74 行） — 项目根路径设置
- PerformancePane.vue（62 行） — 硬件加速 / GPU / 内存 / 缓存滑块
- 统一采用 defineModel('config') + v-model:config 模式，子组件可直接改嵌套 config.*.* 路径；最终 SystemSettings.vue 3444 → 1070 行（−69%）。
ChatPanel.vue 两级外提 — 从 4057 行组件抽出两个可复用模块：
- chatPanelUtils.js — 7 个纯工具（sanitizeJSONString / sanitizeFileName / getDirectoryPath / joinPath / resolveProjectOutput / cleanForIPC + WINDOWS_RESERVED_FILE_NAMES）。
- composables/useMemoryLeakGuard.js — 封装 activeTimers / activeListeners + safeSetTimeout / safeRegisterListener + 自动 onUnmounted 清理；对任何跟踪 electronAPI.*.on 监听器的组件都可复用。
- ChatPanel.vue 4057 → 3788 行（−269）。
CLI 0.156.2 → 0.156.4 — 0.156.3 已被 npm 占用，跳到 0.156.4 再发布。

Changed

三站 CLI 版本号统一刷新：用户文档 tagline / 官网首页 chip / 设计站 tagline 全部 0.156.2 → 0.156.4。
设计站 tagline 修正历史遗留 v5.0.2.34 / CLI 0.156.0 为 v5.0.2.43 / CLI 0.156.4。

Fixed

CI/Release 打包链 — 多个 commit 修 release 产物：
- rsync --ignore-existing 替代 cp -Rn 做 node_modules 合并。
- 跨 workspace 安装平台专属 rollup 原生 binary（E2E workflow）。
- 重写 @chainlesschain/* workspace symlink 为绝对路径，避免打包后链接指空。
- xcopy 永远把 hoisted node_modules 拷进发布包。
- CLI publish 在 npm 已有同版本时跳过（避免 409）。

[5.0.2.43 / CLI 0.156.2] - 2026-04-21（上午）(发布前测试回归闭环 + 533 自动文档刷新)

Added

发布前测试回归闭环 — 92 单元测试 + 5 集成测试 + vue-tsc --noEmit + vite build + describe.skip E2E 五关全绿，无 bug 溢出。
533 份自动文档刷新 — desktop-app-vue/docs/api/generated/*.md prettier list/heading 规范刷新，ARCHITECTURE_OVERVIEW.md + COMPONENT_REFERENCE.md 格式同步。
CLI 0.156.1 → 0.156.2 — patch 补丁（无源码改动，用于 v5.0.2.43 npm 发布）。

Changed

三站版本号统一刷新：docs-website-v2 官网 footer + /desktop chip + index.astro 首页 hero chip 全部 v5.0.2.34 → v5.0.2.43，CLI chip v0.156.0 → v0.156.2。

[5.0.2.42 / CLI 0.156.1] - 2026-04-20 晚 (V6 Shell 回归闭环 + 用户文档)

Added

V6 Shell + /v6-preview 用户文档 — desktop-v6-shell.md 新增 §18 "P7–P9b 预览壳" 全套 + §18.7 测试回归表；desktop-ui-refactor-user-guide.md 新建 355 行用户指南；6 份核心指南追加 17 章规范附录。
设计文档 — docs/design/桌面版UI重构_设计文档.md 458 行，含 10 章 + 附录 A/B。

Changed

sync-docs.js / sync-design-docs.js 加入新中文 → ASCII 映射；两站 VitePress sidebar 加入新条目。

[5.0.2.34 / CLI 0.140-0.142] - 2026-04-19 (V2 第十批 · 16 个编排/自治/经济/进化 lib 级治理表面)

Added — 16 个 V2 lib 级治理表面（严格增量 · 内存 governance · 与运行态 / 传输层 / 协议层完全独立）

orchestrator V2（cc orchgov）— 编排 profile 4-state（retired 终态、paused→active 恢复）+ task 5-state（3 终态），per-owner active cap 6、per-profile pending cap 12，autoPauseIdle + autoFailStuck；45 V2 单测（gov-stats-v2 独立，避开已有 cc orchestrate router *-v2）。
perf-tuning V2（追加到现有 cc perf）— tuning profile 4-state（decommissioned 终态、stale→active 恢复）+ bench 5-state（3 终态），per-owner 6、per-profile 10，autoStaleIdle + autoFailStuck；45 V2 单测（Phase 22 SQLite 不动）。
topic-classifier V2（cc topiccls）— classifier profile 4-state（archived 终态、stale→active 恢复）+ job 5-state（3 终态），per-owner 8、per-profile 20，autoStaleIdle + autoFailStuck；45 V2 单测。
iteration-budget V2（cc itbudget）— budget profile 4-state（exhausted 终态、paused→active 恢复）+ run 5-state（3 终态），per-owner 4、per-profile 8，autoPauseIdle + autoFailStuck；45 V2 单测。
git-integration V2（cc git）— repo profile 4-state（decommissioned 终态、archived→active 恢复）+ commit 5-state（3 终态），per-owner 10、per-profile 20，autoArchiveIdle + autoFailStuck；45 V2 单测。
cowork-task-runner V2（cc cowork runner-*-v2）— runner profile 4-state（retired 终态、paused→active 恢复）+ exec 5-state（3 终态），per-owner 8、per-profile 15，autoPauseIdle + autoFailStuck；45 V2 单测（runner-* 前缀避开 Agent Coordinator V2 冲突）。
inference-network V2（cc inference）— node profile 4-state（decommissioned 终态、degraded→active 恢复）+ job 5-state（3 终态），per-owner 12、per-profile 25，autoDegradeIdle + autoFailStuck；45 V2 单测（与已有 task-scheduling V2 共存于同文件）。
content-recommender V2（cc recommend cr-*-v2）— recommender profile 4-state（archived 终态、stale→active 恢复）+ job 5-state（3 终态），per-owner 8、per-profile 10，autoStaleIdle + autoFailStuck；45 V2 单测（cr-* 前缀避开 content-recommendation.js V2）。
app-builder V2（cc lowcode）— app profile 4-state（archived 终态、paused→active 恢复）+ build 5-state（3 终态），per-owner 10、per-profile 20，autoPauseIdle + autoFailStuck；45 V2 单测。
siem-exporter V2（cc siem）— SIEM target 4-state（retired 终态、degraded→active 恢复）+ export 5-state（3 终态），per-owner 8、per-profile 50，autoDegradeIdle + autoFailStuck；45 V2 单测。
autonomous-agent V2（cc autoagent）— autonomous agent profile 4-state（archived 终态、paused→active 恢复）+ run 5-state（3 终态），per-owner 5、per-profile 10，autoPauseIdle + autoFailStuck；45 V2 单测（与交互式 cc agent 分离）。
compliance-framework-reporter V2（cc compliance fwrep-*-v2）— framework profile 4-state（archived 终态、deprecated→active 恢复）+ report 5-state（3 终态），per-owner 8、per-profile 15，autoDeprecateIdle + autoFailStuck；45 V2 单测（fwrep-* 前缀避开已有 compliance V2）。
agent-economy V2（cc economy）— account profile 4-state（closed 终态、frozen→active 恢复）+ tx 5-state（3 终态），per-owner 20、per-profile 30，autoFreezeIdle + autoFailStuck；41 V2 单测（默认 currency=CLC）。
pipeline-orchestrator V2（cc pipeline）— pipeline profile 4-state（archived 终态、paused→active 恢复）+ run 5-state（3 终态），per-owner 10、per-profile 20，autoPauseIdle + autoFailStuck；41 V2 单测。
evolution-system V2（cc evolution）— evo goal profile 4-state（archived 终态、paused→active 恢复）+ cycle 5-state（3 终态），per-owner 6、per-profile 12，autoPauseIdle + autoFailStuck；41 V2 单测。
hierarchical-memory V2（cc hmemory）— tier profile 4-state（retired 终态、dormant→active 恢复）+ promotion 5-state（3 终态），per-owner 12、per-profile 30，autoDormantIdle + autoFailStuck；41 V2 单测（默认 level=short-term）。

Changed

CLI 包版本：chainlesschain@0.137.0 → 0.142.0（V2 第十批分多次推进，每次落 2 ~ 4 个 lib 级 surface）
design doc 96：新增"第十批（编排 / 自治 / 经济 / 进化治理层 · 16 个）"章节，版本演进累计更新为 92+ V2 表面

Tests

本批相较 0.139.0 累计新增 704 个 V2 单元测试（12 × 45 + 4 × 41），零回归。

层级	文件	测试	状态
CLI 单元	274	11718 / 11718	全通过（125s）
CLI 集成	40	696 / 696	全通过（40s）
CLI E2E	38	565 / 565	全通过（360s）
合计	352	12979 / 12979	零回归

Added — 14 个 V2 lib 级治理表面（严格增量 · 内存 governance · 与 session.db / 角色表 / DI 容器 / 社交边零耦合）

slot-filler V2（cc slotfill）— template profile 4-state（archived 终态、stale→active 恢复）+ fill 5-state（3 终态），per-owner 10、per-profile 20，autoStaleIdle + autoFailStuck；37 V2 单测。
web-fetch V2（cc webfetch）— target profile 4-state（retired 终态、degraded→active 恢复）+ job 5-state（3 终态），per-owner 12、per-profile 30，autoDegradeIdle（7d）+ autoFailStuck（60s）；37 V2 单测。
memory-injection V2（cc meminj）— rule profile 4-state（archived 终态、paused→active 恢复）+ injection 5-state（3 终态），per-owner 10、per-profile 25，autoPauseIdle + autoFailStuck；37 V2 单测。
session-search V2（cc seshsearch）— search profile 4-state（archived 终态、stale→active 恢复）+ query 5-state（3 终态），per-owner 8、per-profile 20，autoStaleIdle + autoFailStuck；37 V2 单测。
session-tail V2（cc seshtail）— tail subscription 4-state（closed 终态、paused→active 恢复）+ event 5-state（3 终态），per-owner 10、per-sub 30，autoPauseIdle（24h）+ autoFailStuck（60s）；37 V2 单测。
session-usage V2（cc seshu）— usage budget 4-state（archived 终态、exhausted→active 恢复）+ record 5-state（recorded/rejected/cancelled 3 终态），per-owner 5、per-budget 50，autoExhaustIdle + autoRejectStuck；37 V2 单测。
session-hooks V2（cc seshhook，避开 SQLite 支持的 cc hook）— hook profile 4-state（retired 终态、disabled→active 恢复）+ invocation 5-state（3 终态），per-owner 12、per-profile 25，autoDisableIdle + autoFailStuck；37 V2 单测。
mcp-scaffold V2（cc mcpscaf，避开 cc mcp）— scaffold profile 4-state（archived 终态、stale→active 恢复）+ generation 5-state（failed 仅从 generating，queued 不可失败；3 终态），per-owner 6、per-profile 15，autoStaleIdle + autoFailStuck（60s）；37 V2 单测。
plan-mode V2（cc planmode）— plan profile 4-state（archived 终态、paused→active 恢复）+ step 5-state（3 终态），per-owner 6、per-profile 15，autoPauseIdle + autoFailStuck；39 V2 单测。
permission-engine V2（cc perm）— perm rule 4-state（retired 终态、disabled→active 恢复）+ check 5-state（allowed/denied/cancelled），per-owner 10、per-rule 30，autoDisableIdle + autoDenyStuck；38 V2 单测。
user-profile V2（cc uprof）— user profile 4-state（archived 终态、dormant→active 恢复）+ pref 5-state（proposed/applied/rejected/superseded/cancelled，applied 非终态），per-owner 5、per-profile 20，autoDormantIdle + autoCancelStale；37 V2 单测。
social-graph V2（cc social sg-*-v2，sg-* 前缀避开 social-manager V2）— sg node 4-state（removed 终态、inactive→active 恢复）+ edge 5-state（proposed/established/severed/expired/cancelled，established 非终态），per-owner 50、per-node 100，sg-autoDeactivateIdle + sg-autoExpireStale；37 V2 单测。
service-container V2（cc svccont）— svc container 4-state（decommissioned 终态、degraded→active 恢复）+ resolution 5-state（3 终态），per-owner 8、per-profile 25，autoDegradeIdle + autoFailStuck；37 V2 单测。
task-model-selector V2（cc tms）— selector profile 4-state（decommissioned 终态、stale→active 恢复）+ selection 5-state（3 终态），per-owner 8、per-profile 16，autoStaleIdle + autoFailStuck；37 V2 单测。

Changed

CLI 包版本：chainlesschain@0.131.0 → 0.137.0 → 0.139.0（V2 第九批分批推进）
命令层：14 个全新 top-level 分派，避免与已有 top-level（cc session、cc mcp、cc hook、cc social）冲突

Tests

本批相较 0.136.0 累计新增 521 个 V2 单元测试（10×37 + 39 + 38 + 2×37），零回归。

[5.0.2.34 / CLI 0.131-0.136] - 2026-04-18 晚 (V2 第八批 · 12 个 lib 级治理表面)

Added — 12 个 V2 lib 级治理表面（严格增量 · 内存 governance · 与 SQLite / 传输层 / 协议层完全独立）

a2a-protocol V2 — A2A_AGENT_MATURITY_V2 4-state（retired 终态）+ A2A_MESSAGE_LIFECYCLE_V2 5-state（3 终态），per-owner active-agent cap（pending→active 仅）、per-agent pending-message cap（queued+dispatching）在 createA2aMessageV2 强制，autoRetireIdleA2aAgentsV2 + autoFailStuckA2aMessagesV2；40 V2 单测，独立于 Phase 81 A2A schema / typed subscription 实现。
activitypub-bridge V2 — AP_ACTOR_MATURITY_V2 4-state + AP_ACTIVITY_LIFECYCLE_V2 5-state（3 终态），per-owner active-actor cap、per-actor pending-activity cap 在 createApActivityV2 强制，autoRetireIdleApActorsV2 + autoFailStuckApActivitiesV2；39 V2 单测，独立于现有 ActivityPub outbox 语义。
bi-engine V2 — BI_DATASET_MATURITY_V2 4-state + BI_QUERY_LIFECYCLE_V2 5-state（3 终态），per-owner active-dataset cap、per-dataset pending-query cap 在 createBiQueryV2 强制，autoArchiveIdleBiDatasetsV2 + autoFailStuckBiQueriesV2；39 V2 单测，独立于 Phase 95 NL→SQL / IQR 异常 / 线性预测。
browser-automation V2 — BROWSE_SESSION_MATURITY_V2 4-state + BROWSE_STEP_LIFECYCLE_V2 5-state（3 终态），per-owner active-session cap、per-session pending-step cap 在 createBrowseStepV2 强制，autoArchiveIdleBrowseSessionsV2 + autoFailStuckBrowseStepsV2；37 V2 单测，独立于现有 Playwright / MCP computer-use 集成。
cross-chain V2 — CC_BRIDGE_MATURITY_V2 4-state + CC_TRANSFER_LIFECYCLE_V2 5-state（3 终态），per-owner active-bridge cap、per-bridge pending-transfer cap 在 createCrossChainTransferV2 强制，autoDegradeIdleCcBridgesV2 + autoFailStuckCcTransfersV2；40 V2 单测，独立于 Phase 89 bridge/swap/message HTLC 流。
dao-governance V2 — DAO_REALM_MATURITY_V2 4-state + DAO_PROPOSAL_LIFECYCLE_V2 5-state（3 终态），per-owner active-realm cap、per-realm open-proposal cap 在 createDaoProposalV2 强制，autoArchiveIdleDaoRealmsV2 + autoFailStuckDaoProposalsV2；41 V2 单测，独立于 Phase 92 二次方投票 / 循环安全委托。
dlp-engine V2 — DLP_POLICY_MATURITY_V2 4-state + DLP_INCIDENT_LIFECYCLE_V2 5-state（3 终态），per-owner active-policy cap、per-policy open-incident cap 在 createDlpIncidentV2 强制，autoDeprecateIdleDlpPoliciesV2 + autoCloseStaleDlpIncidentsV2；40 V2 单测，独立于 Phase 50 channel-scoped 策略 / UTF-8 byte-gate。
evomap-manager V2 — EVOMAP_HUB_MATURITY_V2 4-state + EVOMAP_SUBMISSION_LIFECYCLE_V2 5-state（3 终态），per-owner active-hub cap、per-hub pending-submission cap 在 createEvoSubmissionV2 强制，autoArchiveIdleEvoHubsV2 + autoFailStuckEvoSubmissionsV2；39 V2 单测，独立于 Phase 42 federation / 加权投票实现。
matrix-bridge V2 — MX_ROOM_MATURITY_V2 4-state + MX_EVENT_LIFECYCLE_V2 5-state（3 终态），per-owner active-room cap、per-room pending-event cap 在 createMxEventV2 强制，autoArchiveIdleMxRoomsV2 + autoFailStuckMxEventsV2；37 V2 单测。
nostr-bridge V2 — NOSTR_RELAY_MATURITY_V2 4-state + NOSTR_EVENT_LIFECYCLE_V2 5-state（3 终态），per-owner active-relay cap、per-relay pending-event cap 在 createNostrEventV2 强制，autoDegradeIdleNostrRelaysV2 + autoFailStuckNostrEventsV2；39 V2 单测。
session-consolidator V2 — CONSOL_PROFILE_MATURITY_V2 4-state + CONSOL_JOB_LIFECYCLE_V2 5-state（3 终态），per-owner active-profile cap、per-profile pending-job cap 在 createConsolJobV2 强制，autoArchiveIdleConsolProfilesV2 + autoFailStuckConsolJobsV2；38 V2 单测，独立于现有 session-consolidator 聚合流。
zkp-engine V2 — ZKP_CIRCUIT_MATURITY_V2 4-state + ZKP_PROOF_LIFECYCLE_V2 5-state（3 终态），per-owner active-circuit cap、per-circuit pending-proof cap 在 createZkpProofV2 强制，autoArchiveIdleZkpCircuitsV2 + autoFailStuckZkpProofsV2；41 V2 单测，独立于 Phase 88 scheme-parametric（Groth16/PLONK/Bulletproofs）实现。

Changed

CLI 包版本：chainlesschain@0.131.0 → 0.136.0（V2 第八批分多次推进，每次落 2 ~ 3 个 lib 级 surface）
docs-site：首页 hero tagline 同步到 v5.0.2.34 · CLI 0.136.0 · V2 规范层第八批 · 11700+ 测试

Tests

本批相较 0.130.0 累计新增 470 个 V2 单元测试（40+39+39+37+40+41+40+39+37+39+38+41），零回归。

层级	文件	测试	状态
CLI 单元	244	10493 / 10493	全通过
CLI 集成	40	696 / 696	全通过
CLI E2E	38	565 / 565	全通过
合计	322	11754 / 11754	零回归

[5.0.2.34 / CLI 0.124-0.130] - 2026-04-18 (V2 第七批 · 9 个治理表面)

Added — 9 个 V2 治理表面（严格增量，纯内存 governance，与 SQLite / 传输层独立）

cc sso V2 (CLI 0.124.0) — Provider 4-state 成熟度（pending/active/deprecated/retired，deprecated→active 恢复）+ 5-state 登录生命周期（initiated/authenticating/completed/failed/cancelled，3 终态），per-owner active-provider cap（pending→active 仅）、per-provider pending-login cap（initiated+authenticating）在 createLoginV2 时强制，autoDeprecateIdleProvidersV2 + autoFailStuckLoginsV2；35 V2 单测，基于现有 SSO SQLite 表。
cc workflow V2 (CLI 0.125.0) — Workflow 4-state 成熟度（draft/active/paused/retired，paused→active 恢复）+ 5-state Run 生命周期（queued/running/succeeded/failed/cancelled，3 终态），per-owner active-workflow cap（draft→active 仅）、per-workflow pending-run cap（queued+running）在 createRunV2 时强制，autoPauseIdleWorkflowsV2 + autoFailStuckRunsV2；44 V2 单测，独立于旧 DAG 执行器。
cc router V2 (CLI 0.127.0) — Router Profile 4-state 成熟度 + 5-state dispatch 生命周期（3 终态），per-owner active-profile cap（pending→active 仅）、per-profile pending-dispatch cap（queued+dispatching）在 createDispatchV2 时强制，autoDegradeIdleProfilesV2 + autoFailStuckDispatchesV2；37 V2 单测（共 43），新顶层 router 命令，独立于旧 AgentRouter 类。
cc hook V2 (CLI 0.128.0) — Hook Profile 4-state 成熟度（retired 终态、disabled→active 恢复）+ 5-state exec 生命周期（3 终态），per-owner active-hook cap（pending→active 仅）、per-hook pending-exec cap（queued+running）在 createHookExecV2 时强制，autoDisableIdleHooksV2 + autoFailStuckExecsV2；42 V2 单测（共 76），独立于 SQLite registerHook / executeHooks 路径。
cc mcp V2 (CLI 0.129.0) — MCP Server Profile 4-state 成熟度（retired 终态、degraded→active 恢复）+ 5-state invocation 生命周期（3 终态），per-owner active-server cap（pending→active 仅）、per-server pending-invocation cap（queued+dispatching）在 createInvocationV2 时强制，autoDegradeIdleServersV2 + autoFailStuckInvocationsV2；33 V2 单测（共 65），独立于 MCPClient 传输层。
cc cowork coord-*-v2 (CLI 0.130.0) — Coord Agent 4-state 成熟度（retired 终态、idle→active 恢复）+ 5-state assignment 生命周期（3 终态），per-owner active-agent cap（pending→active 仅）、per-agent pending-assignment cap（queued+dispatched）在 createAssignmentV2 时强制，autoIdleCoordAgentsV2 + autoFailStuckAssignmentsV2；32 V2 单测（共 74），函数名以 Coord 中缀避免与旧 team/template/result 流冲突。
cc subagent V2 — Sub-Agent Profile 4-state 成熟度（retired 终态、paused→active 恢复）+ 5-state task 生命周期（3 终态），per-owner active cap、per-profile pending cap，autoPauseIdle + autoFailStuck；37 V2 单测（共 43），独立于旧 RingBuffer-backed 单例注册中心。新顶层 subagent 命令。
cc execbe V2 — Execution Backend Profile 4-state 成熟度（retired 终态、degraded→active 恢复）+ 5-state exec-job 生命周期（succeeded 终态 + 3 终态），per-owner active cap、per-backend pending cap，autoDegradeIdle + autoFailStuck；46 V2 单测（共 68），独立于 Local/Docker/SSH Backend 实现。新顶层 execbe 命令。
cc todo V2 — Todo List 4-state 成熟度（archived 终态、paused→active 恢复）+ 5-state item 生命周期（in_progress 中间态 + 3 终态），per-owner active cap、per-list pending cap，autoPauseIdle + autoFailStuck；39 V2 单测（共 41），独立于 per-session writeTodos/getTodos API。新顶层 todo 命令。

Changed

CLI 包版本：chainlesschain@0.123.0 → 0.124.0 → 0.125.0 → 0.127.0 → 0.128.0 → 0.129.0 → 0.130.0（V2 第七批分多次推进 + 0.126.0 修复 bump；subagent/execbe/todo 三个表面为本批后续增量）
docs-site：首页 hero tagline 同步到 v5.0.2.34 · CLI 0.130.0 · 109 命令
docs-site-design：首页 badges 同步到 v5.0.2.34 · 95+ 模块 · 139 技能 · 7600+ 总测试
docs-website-v2：index.astro evolution 条目增加 9 张 v5.0.2.34 卡片（ember 高亮），架构演进计数 49 → 58；CLI 数 76 → 109、测试数 5517+ → 7600+；cli.astro 标题与正文从 90 命令升至 109 命令

Tests

本批相较 0.123.0 累计新增 345 个 V2 单元测试（35 + 44 + 37 + 42 + 33 + 32 + 37 + 46 + 39），零回归。所有 V2 表面均以 -v2 后缀分派，preAction bypass 自动识别。

CLI 单元：新增 6 文件 / +223 pass
CLI 集成：无新增，既有 40 文件 / 696 pass 绿
CLI E2E：无新增，既有 38 文件 / 565 pass 绿

[5.0.2.10 / CLI 0.130.0] - 2026-04-18 晚 (V2 第六批 · 13 个运行时管家)

Added — 13 个 V2 规范表面（严格增量，全部基于内存 governance 层，与遗留 SQLite/ 文件态独立）

cc automation V2 — AUTOMATION_MATURITY_V2 draft/active/paused/archived + EXECUTION_LIFECYCLE_V2 queued/running/succeeded/failed/cancelled，per-owner active-automation cap = 20、per-flow pending-execution cap = 30，autoPauseIdle* + autoCancelStuck*。
cc instinct V2 — PROFILE_MATURITY_V2 pending/active/dormant/archived + OBSERVATION_LIFECYCLE_V2 captured/reviewed/reinforced/discarded/promoted，per-user 5、per-profile 100，autoDormantIdleProfilesV2 + autoDiscardStaleObservationsV2。
cc memory V2 — ENTRY_MATURITY_V2 draft/active/stale/archived + CONSOLIDATION_LIFECYCLE_V2 pending/running/merged/rejected/superseded，per-owner 200、per-owner 20，autoStaleEntries* + autoSupersedeStuck*。
cc note V2 — NOTE_MATURITY_V2 draft/active/stale/archived + REVISION_LIFECYCLE_V2 pending/applied/rolled_back/conflicting/discarded，per-author 100、per-note 50，autoStaleNotesV2 + autoDiscardStaleRevisionsV2。
cc org V2 — ORG_MATURITY_V2 provisional/active/suspended/archived + MEMBER_LIFECYCLE_V2 invited/active/suspended/removed/expired，per-owner 10、per-org 500，autoSuspendIdleOrgsV2 + autoExpireStaleMembersV2。
cc permmem V2（新命令组）— PIN_MATURITY_V2 pending/active/dormant/archived + RETENTION_JOB_LIFECYCLE_V2 queued/running/succeeded/failed/cancelled，per-owner 100、per-pin 10，autoDormantIdlePinsV2 + autoCancelStuckJobsV2。
cc rcache V2（新命令组）— PROFILE_MATURITY_V2 pending/active/suspended/archived + REFRESH_JOB_LIFECYCLE_V2 queued/running/completed/failed/cancelled，per-owner active-profile 25、per-profile pending-job 4，autoSuspendIdleProfilesV2 + autoFailStuckRefreshJobsV2。与 legacy LRU cc tokens cache 并存不冲突。
cc scim V2 — IDENTITY_LIFECYCLE_V2 pending/provisioned/suspended/deprovisioned + SYNC_JOB_V2 queued/running/succeeded/failed/cancelled，per-tenant 5000、per-idp 50，autoSuspendIdleIdentitiesV2 + autoFailStuckSyncJobsV2。
cc session V2 — CONVERSATION_MATURITY_V2 active/idle/closed/archived + TURN_LIFECYCLE_V2 queued/running/completed/failed/cancelled，per-user 20、per-session 100，autoIdleConversationsV2 + autoFailStuckTurnsV2。
cc social V2 — RELATIONSHIP_MATURITY_V2 pending/active/muted/blocked + THREAD_LIFECYCLE_V2 draft/posted/archived/flagged/removed，per-user 1000、per-user 500，autoMuteStaleRelationshipsV2 + autoArchiveStaleThreadsV2。
cc sync V2 — RESOURCE_MATURITY_V2 pending/active/paused/archived + SYNC_RUN_V2 queued/running/succeeded/failed/cancelled，per-owner 50、per-resource 20，autoPauseIdleResourcesV2 + autoFailStuckRunsV2。
cc tokens V2 — BUDGET_MATURITY_V2 pending/active/warning/exhausted + USAGE_RECORD_LIFECYCLE_V2 pending/committed/refunded/rejected/disputed，per-owner 10、per-budget 10000，autoExhaustBudgetsV2 + autoCommitStaleRecordsV2。
cc wallet V2 — WALLET_MATURITY_V2 provisioned/active/frozen/retired + TX_LIFECYCLE_V2 pending/submitted/confirmed/failed/cancelled，per-user 10、per-wallet 100，autoFreezeIdleWalletsV2 + autoCancelStuckTxsV2。

Changed

CLI 包版本：chainlesschain@0.106.0 → 0.130.0（V2 第六批一次性推进 13 个管家 + 小版本收口）
README：中/英双语在最新版本区前插入 V2 第六批条目，替换安装命令到 chainlesschain@0.130.0

Tests

模块	单元测试（新/总）	状态
`automation-engine.test.js`	+46 / 114	全通过
`instinct-manager.test.js`	+48 / 73	全通过
`memory-manager.test.js`	+47 / 101	全通过
`note-versioning.test.js`	+49 / 71	全通过
`org-manager.test.js`	+43 / 75	全通过
`permanent-memory.test.js`	+46 / 71	全通过
`response-cache.test.js`	+46 / 66	全通过
`scim-manager.test.js`	+39 / 62	全通过
`session-manager.test.js`	+33 / 77	全通过
`social-manager.test.js`	+34 / 75	全通过
`sync-manager.test.js`	+39 / 65	全通过
`token-tracker.test.js`	+49 / 88	全通过
`wallet-manager.test.js`	+41 / 70	全通过

本批相较 0.106.0 累计新增 560 个 V2 单元测试，零回归。

CLI 单元：232 文件 / 9219/9229（10 skipped）
CLI 集成：40 文件 / 696/696
CLI E2E：38 文件 / 565/565
Desktop core+database / renderer stores / ai-engine sample 全部绿（15+16+3 files / 1587 pass）

[5.0.2.10 / CLI 0.106.0] - 2026-04-18 (V2 第五批 · 协作治理 + UEBA + 威胁情报)

Added — 3 个 V2 规范表面（严格增量）

cc collab V2 (CLI 0.105.0)：4-state Agent 成熟度 (provisional/active/suspended/retired，suspended→active 恢复) + 5-state 提案生命周期 (draft/voting/approved/rejected/withdrawn，3 终态)，per-realm active-agent cap = 10、per-proposer voting-proposal cap = 3，autoRetireIdleAgentsCgV2 + autoWithdrawStuckProposalsV2 批量 auto-flip。
cc compliance ueba V2 (CLI 0.105.0)：4-state baseline 成熟度 (draft/active/stale/archived，stale→active 恢复) + 5-state investigation 生命周期 (open/investigating/closed/dismissed/escalated，3 终态)，per-owner active-baseline cap = 20、per-analyst open-investigation cap = 10（在 openInvestigationV2 创建时强制，因 open 即起始态），autoMarkStaleBaselinesV2 + autoEscalateStuckInvestigationsV2。
cc compliance threat-intel V2 (CLI 0.106.0)：4-state Feed 成熟度 (pending/trusted/deprecated/retired，deprecated→trusted 恢复) + 5-state Indicator 生命周期 (pending/active/expired/revoked/superseded，3 终态)，per-owner active-feed cap、per-feed active-indicator cap、autoDeprecateIdleFeedsV2 + autoExpireStaleIndicatorsV2。SQLite IoC 目录之上叠加纯内存 V2 层。

Changed

CLI 包版本：chainlesschain@0.104.0 → 0.105.0 → 0.106.0（V2 第五批分两次推进）
docs-site：cli-collab.md / cli-compliance.md 追加 V2 规范表面段（共 4 个枚举 + 3 状态机 + 6 个 auto-flip + 18 配额配置）
docs-website-v2：index.astro 升级到 48 条 evolution 条目（v5.0.2.10 新增 39 项，第五批 V2 列入）；CLI chip 从 v0.104.0 升至 v0.106.0
docs/cli/platform.md：吸收 Collaboration Governance V2 / Compliance UEBA V2 段（项目根反向同步）

Tests

模块	单元测试	V2 新增	状态
`collaboration-governance.test.js`	98	37	全通过
`ueba.test.js`	59	29	全通过
`threat-intel.test.js`	69	41	全通过

本批相较 0.104.0 累计新增 107 个 V2 单元测试，零回归。

[5.0.2.34] - 2026-04-17 (npm 0.66.0 · 7 个新命令组 + 8 个 V2 强化)

Added — 7 个新 CLI 命令组

cc agent-network — 去中心化 Agent 网络：Ed25519 DID + W3C VC + Kademlia k-bucket 模拟 + 4 维加权声誉任务路由 (Phase 24)
cc automation / cc auto — 工作流自动化引擎：12 个 SaaS 连接器 (Gmail/Slack/GitHub/Jira/Notion/Trello/Discord/Teams/Airtable/Figma/Linear/Confluence) + 5 种触发器 + DAG 流 (Phase 96)
cc didv2 — W3C DID v2.0：did:key/web/chain + Ed25519 VC/VP + k-of-n 守护人社交恢复 + 身份漫游 (Phase 55)
cc perf — 性能自动调优：OS 真采样 + 5 规则带滞回 + 冷却，CLI 只汇报不自动应用 (Phase 22)
cc pipeline — 开发流水线编排：7 阶段 AI 开发流水线 (req→arch→code→test→review→deploy→monitor) + 4 模板 + 6 部署策略 (Phase 26)
cc ecosystem / cc eco — 智能插件生态 2.0：注册 + DFS 依赖求解器 + 沙箱日志 + 发布状态机 + 70/30 收益分账 (Phase 64)
cc sso — 企业身份认证：SAML/OAuth2/OIDC 配置 CRUD + PKCE S256 + AES-256-GCM Token 加密 + DID↔SSO 身份桥 (Phase 14)

Added — 8 个现有命令 V2 强化（严格增量，向后兼容）

cc social graph — 图分析：度/紧密度/中介中心性 + 影响力 + 社区发现 + BFS 最短路径 (Phase 42)
cc dao — 4 阶段生命周期 + 二次投票 (cost=n²) + 防环委托 + 时锁 + 多数+法定人数门槛 (Phase 92)
cc economy — 支付类型 + 双边状态通道 + NFT 铸造/列表/购买/销毁 + 任务贡献加权分账 (Phase 85)
cc evolution — 6 维能力评估 + 4 级严重度诊断 + 4 种修复策略 + 成长里程碑自动记录 (Phase 100)
cc hmemory — 4 层内存 + 3 类型 + 3 权限共享 + 巩固状态机 + 概念重叠语义搜索 (Phase 83)
cc sandbox — 沙箱状态机 + 5 类权限 + 5 级风险评分 + 5 类配额 + 自动隔离 + 审计过滤 (Phase 87)
cc workflow — 5 类标准模板 + 检查点快照 + 回滚到检查点 + 条件断点（正则安全） + JSON 导入/导出 (Phase 82)
cc zkp — 3 种证明方案 (Groth16/PLONK/Bulletproofs) + 方案参数化证明形状 + 凭证注册表 + 选择性披露 (Phase 88)

Changed

CLI 包版本：chainlesschain@0.51.0 → 0.66.0（单次 npm publish，包含 2026-04-17 下午全部新增）
docs-site 新增 12 个命令参考页：cli-agent-network / cli-automation / cli-did-v2 / cli-perf / cli-pipeline / cli-ecosystem / cli-sso 等，VitePress 侧栏同步更新
docs/cli 子文件：blockchain-enterprise.md / core-phases.md / platform.md 吸收新命令项

Tests

层	文件数	用例数	耗时
CLI 单元	232	7618/7618	129s
CLI 集成	40	696/696	46s
CLI E2E	38	565/565	427s

本批相较 0.51.0 新增 536 个单元测试（7082 → 7618），覆盖 15 个新 / 强化命令，全部通过；集成 / E2E 零回归。

npm

Tag	版本	发布时间
v5.0.2.34	0.66.0	2026-04-17 晚

npm i -g chainlesschain@0.66.0（别名 cc / clc / clchain）

[5.0.2.33] - 2026-04-17 (npm 发布批次 · CLI 0.51.0)

Added

Phase 17 IPFS 去中心化存储 CLI：cc ipfs node-start/add/get/pin/gc/set-quota/attach-knowledge，确定性 bafy CID + AES-256-GCM + 配额/GC + 知识库附件，64 tests
Phase 20 模型量化 CLI：cc quantize，GGUF 14 级 + GPTQ 目录 + 作业生命周期 (pending→running→completed/failed/cancelled) + 进度追踪，48 tests
Phase 27 多模态协作 CLI：cc mm session/stream/track/snapshot，CRDT 风格会话状态 + 5 模态/7 文档格式/6 输出格式参考目录，68 tests
Phase 28 自然语言编程 CLI：cc nlprog classify/extract/detect-stack/translate/refine/convention-add/conventions/stats，启发式双语意图/实体/技术栈识别 + 翻译/惯例 CRUD，62 tests
Phase 63 统一应用运行时 CLI：cc runtime，OS/容器/云环境能力检测 + 自适应资源分配策略 + 运行时统计，60 tests
5 个新 docs-site 页面：cli-ipfs.md · cli-quantize.md · cli-mm.md · cli-nlprog.md · cli-runtime.md（由并行会话 commit 27267ed9f 落地）
VitePress 侧栏：新增 2 个命令分组，去除过期 NEW 标记

Changed

CLAUDE.md 计数更新：90 → 102 CLI commands，7200+ → 7400+ tests
CLI 包版本：chainlesschain@0.47.9 → 0.49.0 → 0.51.0（v5.0.2.32 / v5.0.2.33 两次 npm 发布）
docs-website-v2：index.astro 升级到 36 条 evolution 条目，cli.astro 新增 3 个命令类别

npm

Tag	版本	包含 Phase
v5.0.2.31	0.48.0	2026-04-17 文档重构基线（本地 tag）
v5.0.2.32	0.49.0	+ Phase 63 Universal Runtime
v5.0.2.33	0.51.0	+ Phase 17 IPFS + Phase 27 Multimodal

发布渠道：npm i -g chainlesschain@0.51.0（别名 cc / clc / clchain）

Tests

层	文件数	用例数	耗时
CLI 单元	232	7082/7082	210s
CLI 集成	40	696/696	76s
CLI E2E	38	565/565	459s

本批新增 Phase 17/20/27/28/63 共 302 个 CLI 单元测试（64 + 48 + 68 + 62 + 60），全部通过。E2E 首次运行时 vitest-worker 出现一次 Timeout calling "onTaskUpdate" RPC 告警（已知长跑套件抖动），重跑全绿。

[5.0.2.10-cli-wrap] - 2026-04-17

Added

Phase 58 联邦硬化 CLI：cc federation register/breaker/failure/success/half-open/check/node-health/pool-* /stats，熔断器三态 (closed/open/half_open) + 健康检查最差态聚合 + 连接池模拟
Phase 84 多模态感知 CLI：cc perception record/results/voice-start/voice-status/index-add/query/context/stats，四模态 (screen/voice/document/video) + 语音会话状态机 + 跨模态索引搜索
Phase 80 数据库演进 CLI：cc dbevo register/up/down/status/history/query-log/query-stats/analyze/suggestions/apply/stats，迁移 CRUD + 慢查询分析 + 索引建议追踪
Phase 25 AIOps CLI：cc ops detect/incidents/baselines/playbooks/postmortem/stats，Z-Score/IQR 异常检测 + 事件四阶段生命周期 + playbook + 事后复盘
Phase 86 代码生成 Agent 2.0 CLI：cc codegen generate/show/list/review/review-show/reviews/scaffold/scaffolds/stats，生成追踪 + 5 条启发式安全规则 + 脚手架记录
新增 docs-site 页面：cli-federation.md (Phase 58 CLI 参考) · cli-perception.md (Phase 84 CLI 参考)，VitePress 侧栏新增"v5.0.2.10 联邦与多模态感知"分组

Changed

docs/CLI_COMMANDS_REFERENCE.md 精简重构：54.8k → 4.4k 精简索引；完整命令清单拆到 docs/cli/ 6 个子文件 (core-phases / managed-agents / blockchain-enterprise / observability / platform / video)
命令注释全量中文化：~371 条 # 注释由英文翻译为中文，技术术语 (DID/P2P/MCP/PQC/...) 保留原文
CLAUDE.md 计数更新：65 → 90 CLI commands，5960+ → 7200+ tests

Tests

层	文件数	用例数	耗时
CLI 单元	219	6010/6010	114s
CLI 集成	40	696/696	36s
CLI E2E	38	565/565	495s

本轮新增 Phase 25/58/80/84/86 共 239 个 CLI 单元测试（48 + 59 + 47 + 47 + 38），全部通过。E2E 运行过程中 vitest-worker 抛出一次 Timeout calling "onTaskUpdate" RPC 超时告警（长跑套件已知问题），不影响任何断言结果。

Fixed

docs-site/docs/chainlesschain/ai-video-generation.md 最后一个参考链接由已删除的锚点修正为 cli/video.md

[5.0.2.9-polish] - 2026-04-15

Added

会话钩子第四事件 AssistantResponse：在 agentLoop() 返回后 fire-and-forget 触发，钩子可读到 {sessionId, response, messageCount, provider, model}
UserPromptSubmit 钩子支持 rewrite / abort：钩子 stdout 返回 {"rewrittenPrompt": "..."} 即可改写本轮 prompt；返回 {"abort": true, "reason": "..."} 直接跳过 LLM
Skill-Embedded MCP 上下文过滤：buildOptimizedPrompt({ activeMcpServers }) 只把白名单内的 MCP 服务器工具暴露给 LLM，避免 130+ 技能场景下的工具爆炸
UnifiedToolRegistry.initialize({ deferSkills: true })：fast init 立即返回，技能解析延迟到第一次读 API 或 setImmediate 后台执行；生产 wiring 已切换
MCPClientManager.disconnect(name)：单服务器断开别名，配合 Skill-Embedded MCP 的 mount/unmount 流程
Category Routing 扩展 EMBEDDING / AUDIO：embedding 默认 ollama 优先（本地、免费）；audio 默认 openai 优先（whisper/tts 质量最高）

Tests

新增 145 测试覆盖本轮（unit 131 + integration 11 + e2e 3），全绿
新增 tests/integration/skill-mcp-context-filter.integration.test.js、tests/integration/unified-tool-registry-deferred.integration.test.js、__tests__/integration/session-hooks-lifecycle.test.js、__tests__/e2e/session-hooks-smoke.test.js

Performance

6 个核心包 vitest.config.js 统一加 pool: "forks", maxForks: 2 防御并行 OOM
UnifiedToolRegistry 冷启动从 ~数百 ms 降到接近 0（138 技能解析延迟到首次读）

Compatibility

全部改动向后兼容：未传新参数时行为与之前完全一致

[5.0.2.10] - 2026-04-06

Changed

文档站版本同步到 v5.0.2.10
CLI Agent Runtime 重构文档已对齐到当前实现
Web Panel 文档已补齐 runtime event、session record、后台任务、Worktree、压缩遥测相关说明
设计文档模块 78 已接入固定路由，不再生成 78-unmapped.md
根 README、设计文档索引、文档站首页已重新补回推荐阅读与当前架构主线
设计模块 69 / 73 / 75 / 77 / 78 已统一补成当前实现对应的长版文档

Added

session-created、session-resumed、session-list-result 的 record 字段文档
tasks-detail、tasks-history、task:notification 的用户文档
worktree-diff、worktree-merge 的用户文档
compression-stats 的筛选参数文档
cli-ui 增补项目模式、全局模式、会话流转、联调要点说明
agent-optimization 增补五个核心优化模块与已完成增强集成说明
minimal-coding-agent-plan 文档同步代码实际进度：Phase 0–6 全部落地、9 个测试文件 85/85 通过
新增 coding-agent-bridge.test.js 单元测试（12 用例），通过 _deps 注入覆盖桥接层并发场景
新增 coding-agent-lifecycle.integration.test.js（10 用例）覆盖 19 个 IPC channel、plan-mode、high-risk gating、worktree 全流程
新增 coding-agent-bridge-real-cli.test.js（2 用例）真实子进程启动 chainlesschain serve 端到端验证

Fixed

coding-agent-bridge.js：request() 在 _send 抛错时未清理 pending，导致内存泄漏；现 try/catch 中先 pending.delete(id) 再 throw
coding-agent-bridge.js：WebSocket close 时未拒绝在途 pending 请求，调用方永久挂起；现 _attachSocket() 的 close 处理器调用 _rejectAllPending(...)
修复 docs-site 首页、Agent 架构页、UI / Serve 文档页的中文乱码
修复设计文档首页与运行时重构计划页的内容不同步问题
修复模块 78 在文档站同步时未映射到稳定路由的问题
修复模块 69 / 73 / 75 / 77 文本被压缩成提纲页的问题
同步修正首页、Agent 架构页、UI 页中过期的验证结果数字
文档站新增 Minimal Coding Agent 实施计划，与设计模块 78 一并入口化
设计文档站补齐模块 77 / 78 的稳定路由与侧边栏入口

Tests

CLI ws-runtime-events：2/2
CLI tools-registry：6/6
CLI agent-core：66/66
CLI ws-session-workflow：16/16
CLI 本轮定向合计：90/90
Web Panel 定向单元：27/27
Web Panel 构建：通过
Docs Site 构建：通过

[5.0.2.8] - 2026-03-31

Added

Web 管理面板扩展为 10 个模块、4 套主题
新增 Services、Logs、Notes、McpTools、Memory、Cron 页面
新增主题切换 store 与全局主题变量覆盖
新增多组纯函数解析器用于 Web Panel 输出解析

Fixed

修复技能列表始终显示 0 的问题，stdout / output 字段兼容恢复
修复多个页面的中文字符损坏
修复浅色主题下组件样式未完整适配的问题
修复 DeepSeek 图标损坏

Tests

新增 29 个 Web Panel 单元测试
Web Panel 测试总量提升到 150+ 级别

[5.0.2.7] - 2026-03-25

Added

Skill Creator v1.2.0
新增 optimize-description
新增 eval 样本自动生成、训练集 / 测试集划分
支持 LLM 驱动的技能描述迭代优化

Tests

新增 76 个测试

[5.0.2.6] - 2026-03-24

Added

Vue3 Web 管理面板 npm 打包接入发布流程
prepublishOnly 自动构建 Web Panel
findWebPanelDist() 支持多路径查找

Fixed

修复 $&、$'、$$ 等特殊字符注入导致的配置损坏
修复文档中部分字符被 U+FFFD 覆盖的问题

Tests

新增 $ 特殊字符相关回归测试

[5.0.2.3] - 2026-03-20

Fixed

修复 Web UI 与 WS 服务器之间 5 处协议不匹配：
- 消息缺少 id
- auth-ok / auth-result 不一致
- msg.session.id / msg.sessionId 不一致
- session-list / session-list-result 不一致
- stream-data / response-token 语义不一致

Added

新增 21 个协议单元回归测试
新增 6 个协议集成测试
设计文档模块 73 补充 v1 -> v2 协议对照说明

[5.0.2.2] - 2026-03-18

Added

新增 chainlesschain ui
支持项目模式与全局模式
支持会话列表、Markdown 流式渲染、自动重连
支持 HTTP + WebSocket 一体化启动
支持浏览器自动打开、token 注入和基础安全响应头

Fixed

修复 UI 关闭流程与 server.listen 错误处理问题
修复带 query 参数时的 URL 路由匹配问题

[5.0.2.1] - 2026-03-17

Added

新增 doc-edit 技能
支持 md/txt/html/docx/xlsx/pptx 文档编辑
支持 edit / append / rewrite-section
输出总是写入 _edited 新文件

Added Docs

新增 ai-doc-creator 与 ai-media-creator 用户文档
文档站开始按用户文档与设计文档分层导航

[5.0.2.0] - 2026-03-17

Added

新增 AI 文档创作模板 ai-doc-creator
新增 AI 音视频创作模板 ai-media-creator
新增 doc-generate、libre-convert、ComfyUI / TTS 技能
文档站升级到 v5.0.2.0

[5.0.1.9] - 2026-03-17

Added

新增 CLI 指令技能包系统
将 60+ CLI 指令自动封装为 9 组技能包
引入 sync-cli
支持 direct / agent / hybrid / llm-query 四种执行模式

[5.0.1.8] - 2026-03-16

Added

子代理隔离系统 v2
SubAgentContext
SubAgentRegistry
命名空间记忆与作用域上下文
Agent 智能增强 v2

[5.0.1.7] - 2026-03-15

Added

子代理隔离系统初版
spawn_sub_agent
三级摘要策略
作用域上下文引擎

[5.0.1.6] - 2026-03-15

Added

Agent 智能增强
run_code 工具的 auto pip-install
脚本持久化
错误分类
环境检测
agent-core 从 REPL 中提取

[5.0.1.5] - 2026-03-15

Added

SlotFiller 集成到 Agent 主循环
serve 自动接入 WSSessionManager
session:create / session:close 事件日志

Fixed

修复 session-resume 后无法继续发送消息的问题

[5.0.1.4] - 2026-03-15

Added

WebSocket 有状态会话
session-create
session-resume
session-message
session-list
session-close
slash-command
session-answer

Notes

这是后续 Runtime / Gateway / Event 统一演进的重要基础版本

更新日志 ​

[5.0.3.37 / CLI 0.161.2] - 2026-05-06 (桌面版同步 productVersion + 托盘内存使用周期更新) ​

Changed ​

Added ​

[5.0.3.36 / CLI 0.161.2] - 2026-05-06 (手动检查更新加 native dialog feedback) ​

Changed ​

Notes ​

[5.0.3.35 / CLI 0.161.2] - 2026-05-06 (auto-updater 缺 electron-log 模块导致从未 load) ​

Fixed ​

Notes ​

[5.0.3.34 / CLI 0.161.2] - 2026-05-06 (Web-shell 托盘菜单 bridge + 检查更新诊断) ​

Fixed ​

Changed ​

Tests ​

[5.0.3.33 / CLI 0.161.2] - 2026-05-06 (托盘"关于"产品版本 "—" 修复) ​

Fixed ​

Why ​

[5.0.3.32 / CLI 0.161.2] - 2026-05-06 (托盘修复 v5.0.3.31 残留两处) ​

Fixed ​

Notes ​

Why ​

[5.0.3.31 / CLI 0.161.2] - 2026-05-05 (vitest 4 bump + 自动更新 + 托盘菜单 IPC 修复) ​

Fixed ​

Added ​

Changed ​

Docs ​

Why ​

[5.0.3.30 / CLI 0.161.2] - 2026-05-05 (桌面图标 + 系统托盘 + 安装恢复力) ​

Fixed ​

Why ​

[5.0.3.29 / CLI 0.161.2] - 2026-05-05 (CI/test 稳定性收口 + 双语整站 + 桌面端体验优化) ​

Added ​

Fixed ​

Changed ​

Why ​

[5.0.3.22 / CLI 0.161.2] - 2026-05-04 (Workspace 结构性重构 + ASAR 终结 + V5 dead-page 清理) ​

Changed ​

Fixed ​

Added ​

Why ​

[5.0.3.7 / CLI 0.161.2] - 2026-05-03 (发布工程硬化：Express@5 ASAR hoist 修 + dev/CI 收口) ​

Fixed ​

Added ​

Why ​

[5.0.3.5 / CLI 0.161.2] - 2026-05-03 (MTC v0.6→v0.11 doc roll-up + 跨链桥 + 治理自动同步 + 链上锚定) ​

Added ​

Changed ​

Why ​

[5.0.3.4 / CLI 0.160.1] - 2026-05-02 (Web Panel i18n M3 全覆盖 + V6 LanguageSwitcher + web-shell opt-out + projects folder picker) ​

Added ​

Changed ​

Why ​

[5.0.3.3 / CLI 0.160.0] - 2026-05-01 (MTC v0.5 — Phase 3 federation 全套 + libp2p auto-discovery) ​

Added ​

Fixed ​

测试 ​

[5.0.3.2 / CLI 0.159.0] - 2026-04-30 (MTC v0.4 + Phase 1.6 SLH-DSA + Phase 4 V6 widget) ​

Added ​

Changed ​

Note ​

测试 ​

[5.0.3.1 / CLI 0.157.9] - 2026-04-27 (web-panel V5→Web 全量收官 — Phase B/C/D 一日连发) ​

Added ​

Changed ​

Why ​

测试 ​

[Unreleased] - 2026-04-26 (V6 shell 硬翻 + top-10 parity 10/10 + web-panel Phase A) ​

Added ​

Changed ​

Fixed ​

Why ​

测试 ​

[Unreleased] - 2026-04-26 (默克尔树证书 MTC Phase 1 + 1.5 全部落地) ​

Added ​

Why ​

[5.0.2.54 / CLI 0.156.7] - 2026-04-26 (技能数对齐 141 · ws-server CI 解锁 · release-tag 链路修复) ​

Fixed ​

Changed ​

[5.0.2.53 / CLI 0.156.7] - 2026-04-25 (docs-gen 链路收口 · pack 错误信息增强 · CI E2E 拆批) ​

Fixed ​

更新日志

[5.0.3.37 / CLI 0.161.2] - 2026-05-06 (桌面版同步 productVersion + 托盘内存使用周期更新)

Changed

Added

[5.0.3.36 / CLI 0.161.2] - 2026-05-06 (手动检查更新加 native dialog feedback)

Changed

Notes

[5.0.3.35 / CLI 0.161.2] - 2026-05-06 (auto-updater 缺 electron-log 模块导致从未 load)

Fixed

Notes

[5.0.3.34 / CLI 0.161.2] - 2026-05-06 (Web-shell 托盘菜单 bridge + 检查更新诊断)

Fixed

Changed

Tests

[5.0.3.33 / CLI 0.161.2] - 2026-05-06 (托盘"关于"产品版本 "—" 修复)

Fixed

Why

[5.0.3.32 / CLI 0.161.2] - 2026-05-06 (托盘修复 v5.0.3.31 残留两处)

Fixed

Notes

Why

[5.0.3.31 / CLI 0.161.2] - 2026-05-05 (vitest 4 bump + 自动更新 + 托盘菜单 IPC 修复)

Fixed

Added

Changed

Docs

Why

[5.0.3.30 / CLI 0.161.2] - 2026-05-05 (桌面图标 + 系统托盘 + 安装恢复力)

Fixed

Why

[5.0.3.29 / CLI 0.161.2] - 2026-05-05 (CI/test 稳定性收口 + 双语整站 + 桌面端体验优化)

Added

Fixed

Changed

Why

[5.0.3.22 / CLI 0.161.2] - 2026-05-04 (Workspace 结构性重构 + ASAR 终结 + V5 dead-page 清理)

Changed

Fixed

Added

Why

[5.0.3.7 / CLI 0.161.2] - 2026-05-03 (发布工程硬化：Express@5 ASAR hoist 修 + dev/CI 收口)

Fixed

Added

Why

[5.0.3.5 / CLI 0.161.2] - 2026-05-03 (MTC v0.6→v0.11 doc roll-up + 跨链桥 + 治理自动同步 + 链上锚定)

Added

Changed

Why

[5.0.3.4 / CLI 0.160.1] - 2026-05-02 (Web Panel i18n M3 全覆盖 + V6 LanguageSwitcher + web-shell opt-out + projects folder picker)

Added

Changed

Why

[5.0.3.3 / CLI 0.160.0] - 2026-05-01 (MTC v0.5 — Phase 3 federation 全套 + libp2p auto-discovery)

Added

Fixed

测试

[5.0.3.2 / CLI 0.159.0] - 2026-04-30 (MTC v0.4 + Phase 1.6 SLH-DSA + Phase 4 V6 widget)

Added

Changed

Note

测试

[5.0.3.1 / CLI 0.157.9] - 2026-04-27 (web-panel V5→Web 全量收官 — Phase B/C/D 一日连发)

Added

Changed

Why

测试

[Unreleased] - 2026-04-26 (V6 shell 硬翻 + top-10 parity 10/10 + web-panel Phase A)

Added

Changed

Fixed

Why

测试

[Unreleased] - 2026-04-26 (默克尔树证书 MTC Phase 1 + 1.5 全部落地)

Added

Why

[5.0.2.54 / CLI 0.156.7] - 2026-04-26 (技能数对齐 141 · ws-server CI 解锁 · release-tag 链路修复)

Fixed

Changed

[5.0.2.53 / CLI 0.156.7] - 2026-04-25 (docs-gen 链路收口 · pack 错误信息增强 · CI E2E 拆批)

Fixed