ChainlessChain 文档

主题

更新日志 ​

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

[Unreleased] — 测试套件普查修复 + project-service 导出 UTF-8 bug ​

全栈测试普查（CLI / 桌面 / 后端 Java / 后端 Python）并修复全部真实失败，仅余环境受限项（需 Ollama/Qdrant 服务或 GPU 本地推理）。

Fixed — cc CLI 客户端/传输层稳健性硬化（对照 Claude Code CLI） ​

对照 Claude Code CLI 排查 cc 自身的网络/IO 客户端层（并行平价循环未覆盖的一层），修复一批「静默失败 / 永久挂起 / 截断不报错」类问题。全部带专项单元测试（~27 项新增）。三层测试普查全绿：CLI 单元 19523、集成隔离 24、e2e 604（4 skip）；普查另暴露并修复 1 个 --verbose 回归 + 2 个陈旧断言。

  • 写入完整性：write_file / edit_file / edit_file_hashed 落盘后比对实际字节数（网络盘 / OneDrive·Dropbox·Google Drive 可能静默截断或写出 0 字节），不匹配即报错而非假成功。
  • MCP tools/list 失败可见：服务器声明了 tools 能力但 tools/list 失败时，cc mcp connect 显示「! Connected · tools fetch failed」而非误导的「Tools: 0」（Claude-Code 2.1.181 对齐）。
  • MCP stdio 进程猝死快速失败：服务器进程崩溃/退出时立即拒绝在途请求，而非挂满 30s 超时。
  • MCP HTTP 请求超时：HTTP 传输补齐 30s 超时（与 stdio 对齐），挂死服务器不再永久阻塞；longRunning 服务器（IDE 桥接 openDiff 需人工评审）豁免——顺带接通此前预留未消费的 longRunning 元数据。
  • cc mcp serve 请求护栏：请求体大小上限（413）+ 收集阶段超时（408）+ error 处理，防内存耗尽 / 慢客户端占用 socket / 断连崩溃。
  • 安装下载完整性：cc setup 下载校验 Content-Length（截断即删分片不安装）+ 停滞超时（无数据 60s 中止，防挂死镜像冻结安装）。
  • 杀进程定时器清理：SIGTERM→SIGKILL 升级定时器 unref + 进程退出即清，杀任务后不再占住事件循环、延迟 CLI 退出。
  • --verbose 根因可见：非法 JSON 选项的友好报错（parseJsonOption）链上原始 SyntaxError 为 cause 并续接其调用栈，cc … --verbose 重新显示根 SyntaxError（修复 helper 合并引入的回归），非 verbose 仍是单行友好提示。

Added — 个人数据中台分析/采集修复 + FAMILY-67 通话/通知体验 + Android 键盘遮挡修复（v5.0.3.121） ​

个人数据中台（PDH）一批分析管线 + 查询解析 + 抖音/头条采集修复（pdh 0.4.29 + cli 0.162.82 已发 npm；Android cc bundle internal-binaries-android-v20260619，USR_VERSION 49）；FAMILY-67 通话/消息通知体验完善；Android 全局键盘遮挡修复。release 发 18 个安装包资产。

  • PDH 分析管线：spending 总额改用 sumEventAmount（不再被每子类型 5000 行上限少计）；overview byApp/byType/total 用 facetCounts（不再被 1 万行上限截断）；timeline 排除使用画像聚合基线事件。
  • PDH 查询解析：parseIntent 补收入类金额词 +「多少/几」量词对称；parseFilters 移除 income 裸「收到」误判；parseTimeWindow「最近 N 个月」月末日不再月份溢出丢整月；「花了多少钱」无「总共」时不再误判为列表（应为求和）。
  • PDH 采集：抖音使用画像采集 + 观看记录 vault ingest；头条明文文章 reader（标题在 share_info blob）；可复现 Android 微信 EnMicroMsg.db 解密入库脚本。
  • FAMILY-67 通话/通知：通话断网重连宽限（ICE DISCONNECTED 不再静默挂死）；好友连接自愈（仅 DataChannel 已连时才发起 E2EE 握手）；未接来电通知 + CallStyle 锁屏来电 +「保持在线接听」前台服务；好友消息通知深链进对应聊天 + 运行时申请 POST_NOTIFICATIONS（Android 13+）。
  • Android 键盘遮挡：edge-to-edge 下加全局 imePadding，一处修复所有页面输入框被键盘遮挡。
  • IDE 扩展：VS Code 0.33.0 / JetBrains 0.4.18 专用视觉模型入口 + 首次运行 LLM 配置引导。

Added — FAMILY-67 好友通话历史 + 来电铃声 + CLI 网络鲁棒性（v5.0.3.120） ​

好友语音/视频通话历史落库 + 通话记录可查看，来电铃声/振动/去电回铃音，CLI 各处网络 fetch 加超时防永久挂起。cli 0.162.81 已发 npm。

  • 通话历史落库：通话终态经 CallHistoryRecorder 落库 call_history，记录来/去电、未接、音视频类型与挂断原因。
  • 好友资料页查看通话记录：好友资料页「查看通话记录」接通，按好友 DID 过滤或查看全部（Flow 实时读取）。
  • 来电铃声/振动 + 去电回铃音：来电播放系统铃声 + 振动，去电播放回铃音（修「来电无声音」）。
  • CLI 网络鲁棒性：webhook 通知、cc update / vcheck 的更新检查、provider 连通性探针均加超时（dead endpoint 不再永久挂起）。
  • CLI 数值守卫：reputation / 插件收益分账拒绝 NaN 的 score/amount，避免污染余额。

Fixed — 好友 P2P 发消息稳定性（v5.0.3.119） ​

两天「无法扫码加好友 / 对方收不到消息 / 连不上」全链路收口，真机双向消息 <1s 送达验证。

  • 消息显示：接收方按本机视角重写消息会话归属（peerId = 发送方 DID、方向=入向），修「消息已到库但聊天界面看不到」（此前原样存发送方视角 → 落进错误会话）。
  • 连接稳定性：ICE 改回 ALL（恢复同网设备直连；此前误用 relay-only 反而禁掉直连且撞 TURN 服务器自身 IP）+ WebRTC DataChannel 建立超时 15s→40s（给直连 + 加密握手足够时间）。
  • 信令中继兜底：DataChannel 打不通时命令（E2EE 握手 + 消息同步）自动经信令服务器中继，不再依赖 P2P 直连建立成功；端到端加密不受影响（仅转发签名/密文帧）。
  • 断连自动重连：连接丢失后清理状态并 ≤15s 内自动重拨（此前残留状态导致「假在线真离线」）。
  • 重启恢复：应用启动恢复持久化 E2EE 会话 + 消息即时推送（免等周期同步）+ 聊天顶部 loading 进度条永转修复。
  • TURN 服务器：coturn 公网/私网映射修复，解决中继候选广播私网 IP 导致的权限拒绝。

Fixed — 个人 AI 知识库分析管线去噪（v5.0.3.118） ​

真机采集数据接入个人 AI 知识库后暴露的分析质量问题（pdh 0.4.28 + cli 0.162.78 已发 npm；Android cc bundle v20260617c）。

  • 微信群 topic 名解析：从联系人册解析群显示名，不再用裸数字 chatroom id 命名群话题。
  • analysis.interests 去噪：过滤纯数字/空话题名 + 拉取前 over-fetch，避免真实兴趣被未解析的群 ID 挤出榜单。
  • analysis.timeline 清单排除：时间线查询新增 excludeExtraKinds，跳过 app-snapshot / contact-snapshot 清单快照事件（带合成采集时刻 → 冲垮按时间倒序查询），事件仍留库供统计。

Fixed — root 内存采集 抖音/WCDB2 命中 + 扫描生命周期硬化（v5.0.3.117） ​

真机 2026-06-17 暴露：抖音 WCDB2 解密页内存无 SQLite format 3 文件头 → 旧纯头匹配扫描 0 命中。纯 APK 改动（脚本在 assets，复用 bundle v20260617b / pdh 0.4.27）。

  • D1 叶子页扫描：mem-scan 改按内容判定——含文件头（标准 SQLCipher / 微信）或明文 schema CREATE TABLE（WCDB2 / 抖音解密页缓存）的内存区域整段落盘 → 下游 leaf-salvage --unaligned 扫 0x0D 叶子页打捞（不依赖文件头，两种加密通吃）；MAX_DUMPS=30 + 单区域 ≤64MB 防爆盘 / 超时。
  • D2 扫描生命周期硬化：finally 额外 pkill 'dd if=/proc' 杀孤儿 dd（timeout tree-kill 杀不到管道里的 dd）+ AtomicBoolean 单实例锁防多次点击并发扫描。
  • 版本面：productVersion v5.0.3.116 → v5.0.3.117 / 桌面 5.0.3-alpha.117 / Android versionCode 503117（USR_VERSION 47 · binariesVersion 20260617b 不变，bundle 同 .116）/ iOS build 117。

Added — root 内存采集 多 app + 来源归属 + 扫描硬化（v5.0.3.116） ​

真机暴露的扫描 bug 修复 + 多 app 直采。pdh 0.4.27 + cli 0.162.77 已发 npm；Android cc bundle internal-binaries-android-v20260617b（USR_VERSION 47）。

  • 多 app root 直采 + 正确来源归属：cc hub salvage --app <key>（douyin/toutiao/wechat/kuaishou/xiaohongshu/weibo）经新 forensics/salvage-ingest.js 把消息以正确 source.adapter 直写 vault（头条 → social-toutiao，不再全挂 douyin）；Android「一键 root 采集」按钮加目标 app 下拉选择器。
  • 扫描引擎硬化（真机 2026-06-17 暴露）：mem-scan 脚本加 trap 'kill 0' 自清子进程 + collector 用 timeout 包裹 + 预算 180s → 300s + finally pkill 兜底——修复扫描超时残留孤儿 root 进程问题。
  • 版本面：productVersion v5.0.3.115 → v5.0.3.116 / 桌面 5.0.3-alpha.116 / Android versionCode 503116 · USR_VERSION 47 · binariesVersion 20260617b / iOS build 116。

Added — 个人数据中台 免密钥取证一键采集 + 跨 app 数据总览上设备（v5.0.3.115） ​

root 真机免密钥取证（Method B /proc/mem 内存打捞）从手动脚本做成 app 内一键按钮；跨 app 数据总览修复（旧 cc bundle 不含 analysis.overview 致「数据总览报错」）。pdh 0.4.26 + cli 0.162.76 已发 npm；Android cc bundle 刷到 internal-binaries-android-v20260617（USR_VERSION 46）。

  • cc hub salvage <dump>：把叶子页打捞器收进可 bundle 的 pdh lib（forensics/leaf-salvage.js）+ 封装成单命令（dump → 叶子页打捞 → social-douyin 入库），真 SQLite 库端到端验证（中文 + emoji 无损）。
  • Android「一键 root 采集（抖音内存·免密钥）」按钮：MemSalvageCollector 编排 su 内存扫描 → 拷 dump → 逐个 cc hub salvage 入库；仅 root 机、目标 app 须前台登录在用，v1 限抖音。
  • 数据总览旧 cc 优雅降级：设备 bundled cc 早于 analysis.overview 时把裸 Unknown skill 翻成「需更新本机 cc 组件」可操作提示。
  • 版本面：productVersion v5.0.3.114 → v5.0.3.115 / 桌面 5.0.3-alpha.115 / Android versionCode 503115 · USR_VERSION 46 · binariesVersion 20260617 / iOS build 115。

Fixed — CLI e2e server-readiness 超时硬化（冷启动高负载下的 flake） ​

全量 e2e 跑出 4 文件 / 16 测试失败，单独重跑全绿——根因是 singleFork 满负载下子服务器冷启动慢、等待预算太紧；非产品 bug（cc ui 独立跑约 3.3s 即打印 URL，姊妹测试全过）。

  • ui-command / web-panel：服务器就绪 fallback 8s/10s → 25s（旧逻辑到期后静默返回空输出，把"启动慢"翻成 expected '' to contain URL 的误导断言并级联砸了 13 个测试）。后续补齐同文件 --token / --web-panel-dir 两个块自带的内联就绪等待（同样 8s，重负载下 ECONNREFUSED 级联 7 个测试）→ 也提到 25s，全文件 3 处一致。
  • coding-agent-envelope-roundtrip / serve-command：waitForReady 默认 10s → 25s；serve-command 另把 collectMessages 默认 10s → 25s（流式 WS 消息冷执行后才到）。
  • mtc-audit-e2e：两个重活测试给显式预算——独立验证测试（6 连冷启动）120s、"both code paths" 等价性测试（4 连冷启动）90s（旧时均撞 60s 全局默认）。
  • orchestrate-command：修 timeout 倒挂——it() 预算 20s 比内部子命令自身 30s 超时还短，提到 40s。
  • integration 重活测试（同 trap #31 模式延伸到集成层）：crosschain-multisig-e2e happy-path 2-of-2 + mtc-federation-governance-sync-cli alice publish→bob pull + marketplace-multisig-e2e ¥1500 order + multisig-cli policy→propose→sign×2→finalize，各多次串行 CLI 冷启动，重负载下反复撞 60s 全局默认（隔离全绿）→ 各给显式 90s。
  • 系统性收口：与其逐个 flake 加 per-test 预算，把 base vitest config 的 testTimeout 60s → 90s——unit + integration 本地与 CI shard 都跑在这个 base config 上，一处覆盖整个重活集成族；unit 共享但很快，唯一代价=真卡死的 unit 测试在 90s（而非 60s）才失败。e2e 仍用自有 config。
  • install-and-run execSync 子进程超时：--version / --help / config list 三处 execSync 用 10s，重负载冷启动 spawnSync ETIMEDOUT → 提到 30s。

Added — cc CLI 0.162.71 → 0.162.73：Claude Code IDE/terminal 平价收官 + microcompact 自动压缩（已发 npm） ​

对照 Claude Code desktop/IDE 的剩余体验缺口一连补齐 17 项并收官。chainlesschain 0.162.70 → 0.162.73 已发 npm（latest，全局安装实测全通；161/162 旧版已 deprecate）。

  • 扩展思考可视化（REPL）：/think 开 / /ultrathink 最大预算 / /think-off 关（Anthropic provider；其它忽略）。推理以 dimmed 折叠块在最终答案之上流式渲染，含会话中途步骤的推理，不只末轮。
  • REPL token 流式输出：assistant 文本逐字流式呈现（无 AssistantResponse hook 时启用），不再整段一次性弹出。
  • 审批档位即时切换：REPL /permissions <tier>（normal / acceptEdits / bypass / plan）+ Shift+Tab 循环审批模式，无需重启会话。
  • 行范围文件引用：@src/app.ts#L5-10（单行 #L7）只展开选中行而非整文件（CLI + VS Code 扩展一致）。
  • PDF 页抽取：@report.pdf 经可选 pdf-parse 依赖抽取文本页注入上下文（异步 expandFileRefsAsync；未装依赖则优雅跳过）。
  • microcompact 自动压缩（0.162.73）：会话历史跨阈值时，agentLoop 先就地精简陈旧的大体积工具结果（保留最近上下文 + 消息条数），若由此回落阈值下则整体跳过破坏性的全量摘要；否则照常 fall-through。autoMicroCompact:false 退出。省下「几个巨型旧工具输出」场景的全量摘要成本与上下文损失。

Added — cc CLI 0.162.66：Claude-Code 编码闭环补齐（已发 npm） ​

对照 Claude Code CLI 的剩余高价值缺口一次性补齐。chainlesschain 0.162.65 → 0.162.66 已发 npm（全局安装实测 cc review / cc insights / cc agent 新 flag 全通）。

  • cc review — diff-first 代码审查（/code-review 平价）：默认审工作区 vs HEAD，可 --staged / --base <ref>（PR 式 base...HEAD）/ --range A..B / --paths，并内联未跟踪新文件；low|medium|high 力度档；--security（/security-review）+ --simplify（/simplify，只清理不抓 bug）两视角。只读走 plan 权限出 Markdown 报告；--fix 走 acceptEdits + 自动 checkpoint 直接落地（每次编辑可 cc checkpoint restore 回滚）；--comment 解析机读 JSON findings → 经 gh 在当前分支 PR 发行内评论（--dry-run 预览 + 交互确认）。
  • headless 无人值守硬化：--max-budget-usd <amount>（按 cc cost 价格表累计成本，到顶前停，免跑飞）；--strict-mcp-config（只用 --mcp-config 服务器，忽略已注册 + IDE 桥，工具面可复现）；--replay-user-messages（stream 输入回显用户消息便于转录/对账）。
  • cc insights [id] — 会话分析报告（/insights 平价）：轮次 / 工具调用 + 错误率 / 时长 / token + 估算 $ 成本，纯 JSONL 复盘；从 session_start 回填模型给 headless 会话定价（强于 cc cost）。
  • 全局 run / verify 技能：新增 cli-bundled 技能层（随 cc 包发布）——run（按项目类型拉起实跑）+ verify（观测真实行为给 VERIFIED / NOT VERIFIED / BLOCKED 裁决）；CLI 自有层而非桌面 builtin，不动桌面端「144 技能」计数。

Added — VS Code 扩展「ChainlessChain IDE Bridge」0.28.0 → 0.30.0（已发 Open VSX） ​

open-vsx.org/extension/chainlesschain/chainlesschain-ide latest = 0.30.0（2026-06-16）。继续对标 Claude Code IDE/terminal：审批模式、键盘快捷键、上下文用量、扩展思考可视化、行范围引用、待审提示。

  • 0.28.0 后台 tab 完成提示：在你没看的会话 tab 里一轮跑完 → 该 tab 标绿 ● 点 + 「Show」toast 跳转，不再静默完成。
  • 0.29.0 面板补齐：/retry（重发上条 prompt）/ 代码块悬浮 Copy 按钮 / / 斜杠命令自动补全下拉 / /rewind（列本会话 checkpoint 并恢复工作树，需 cc ≥ 0.162.70）。
  • 0.30.0 审批模式选择器 /auto·/bypass·/normal（Claude Code 平价）：面板可让 agent hands-off——/auto 自动接受文件编辑、/bypass 跳过所有审批、/normal 回默认逐项审批。按会话生效（--permission-mode 是 spawn-time，切模式停子进程→下条消息带新模式 respawn，resume 同会话续上下文）。plan 模式不变。
  • 0.30.0 新会话 / 重开已关 快捷键：Cmd/Ctrl+Alt+N 任意处开新会话 tab；Cmd/Ctrl+Shift+T（聊天视图聚焦时）重开最近关闭的 tab 并 resume 其会话；视图标题栏加 ＋ 按钮。
  • 0.30.0 持久上下文窗口指示：聊天下方细行显示模型上下文用量 ⊟ context 12.3k / 200k (6%)，每轮后刷新（复用 CLI 权威算法 cc context --json，溢出转红）。chainlesschain.chat.contextIndicator: false 可关。
  • 0.30.0 扩展思考 toggle + 推理可视化：/think 开 / /ultrathink 最大预算 / /think-off 关（Anthropic；其它 provider 忽略）。开启时推理以可折叠 dimmed 块（▾ thinking）在答案上方流式渲染，action/answer 来时自动折叠，可点开。
  • 0.30.0 待审 tab 蓝点：审批落在你没看的后台 tab（agent 被 block 等你）时，该 tab 显蓝点（区别于绿「完成」点）+ toast；切到该 tab 重新呈现审批卡可操作。
  • 0.30.0 @file#L5-10 行范围引用：有选区时「Insert File Reference」(Ctrl/Cmd+Alt+K) 插入选中行范围 @src/app.ts#L5-10（单行 #L7），CLI 只展开那几行而非整文件（需 cc ≥ 0.162.71）。
  • 发布：0.28–0.30 各 tag ide-vscode-v* → ide-extensions.yml 清洁室构建发 Open VSX；0.30.0 经 CI run 实证 registry latest = 0.30.0。

Added — VS Code 扩展「ChainlessChain IDE Bridge」0.23.0 → 0.27.0（已发 Open VSX） ​

open-vsx.org/extension/chainlesschain/chainlesschain-ide latest = 0.27.0（2026-06-15）。继 0.22.x 之后,继续对标 Claude Code IDE：终端上下文、版本对齐、稳定性。

  • 终端上下文共享（0.23.0，Claude Code 平价）：新增 getTerminalOutput IDE 工具（mcp__ide__getTerminalOutput）——agent 能看你刚在集成终端跑的命令、输出、退出码（VS Code 1.93+ shell integration）。配套 CLI（cc 0.162.67）：每轮提交自动把最近终端输出注入 <ide-context> + 显式 @terminal at-mention。
  • CLI 版本对齐 version-sync（0.24.0）：激活时检测 cc --version,低于扩展所需最低版本时一键提示升级（npm i -g chainlesschain@latest）——扩展（Open VSX）与 CLI（npm）独立发版轨,这条让它们对齐。
  • 会话 tabs 交互卡修复（0.25.0）：切 tab 改用分离 DOM 节点（而非 innerHTML 字符串）保存/恢复 transcript——未决审批卡的 Approve/Deny 按钮在切走再切回后仍可点（之前会失效）。
  • Upgrade CLI 命令（0.26.0）：命令面板 ChainlessChain: Upgrade CLI 随时从 IDE 升级 cc,不止在低于最低版本被提示时。
  • @terminal 补全 + App Preview 崩溃重启（0.27.0）：面板 @ 补全新增 @terminal（把最近终端命令/输出按需拼进 prompt）；dev server 意外退出时报崩溃并一键 Restart（而非默默停掉）。
  • 发布：0.23–0.27 各 tag ide-vscode-v* → ide-extensions.yml 清洁室构建发 Open VSX,逐版对 registry 实证 latest。0.22.1 为纯文档刷新（Open VSX listing：标注「仅 Open VSX,非微软商店」+ 功能列表对齐）。

Added — VS Code 扩展「ChainlessChain IDE Bridge」0.22.0（已发 Open VSX） ​

open-vsx.org/extension/chainlesschain/chainlesschain-ide 早前 latest = 0.22.0（2026-06-15）。对标 Claude Code desktop/IDE 的四个高价值面板能力一次性补齐。

  • 会话 tabs（Claude Code 平价）：聊天面板支持多会话——标题栏每个 tab 显标题 + × 关闭，+ 新建。每个 tab 独立持有自己的 cc agent 进程与 resume id；切换 tab 恢复该会话的 transcript，后台 tab 的输出不会串入当前可见会话；关闭一个 tab 激活相邻 tab，面板永不为空。
  • App Preview（预览面板平价）：「Start App Preview」自动识别项目的 dev 脚本（dev / start / serve … 或跑 vite/next/cra/webpack/astro 的脚本）→ 拉起 → 解析它打印的本地 URL → 用 VS Code 内置 Simple Browser 内嵌打开；dev server 自带 HMR 负责改文件即时热重载。「Stop App Preview」杀掉它。
  • diff 行内批注（Request changes…）：原生 diff 评审在 Accept / Reject 之外新增第三个选择「Request changes…」——对具体改动行写修改意见,文件不落盘,行锚意见回喂 agent 让其修订后重新提案。
  • 批量多文件 diff（openMultiDiff）：agent 可把跨多个文件的整个 changeset 一次性放进原生多文件 diff 评审——Accept all / 勾选子集应用 / Reject——而非逐文件一次次确认。
  • 发布：tag ide-vscode-v0.22.0 → ide-extensions.yml 清洁室构建（vscode-ext 241 测试全绿 + 干净 38 文件 .vsix）发 Open VSX；本地 vsce package 实证产物一致。官方 Marketplace 仍跳过（无 VSCE_PAT，Azure 受限）。

Added — VS Code 扩展「ChainlessChain IDE Bridge」0.19.0 + 0.20.0 + 0.21.0（已发 Open VSX） ​

独立版本轨（同 CLI npm）；open-vsx.org/extension/chainlesschain/chainlesschain-ide 早前 latest = 0.21.0。补齐对标 Claude Code IDE 的最后四个面板原生入口（设计文档 module 98 Phase 7）。

  • Fix with ChainlessChain（0.19.0）：诊断（error/warning）上 QuickFix 灯泡 → 唤起聊天面板并种入作用域修复请求（文件以 @<path> 引用 + severity 标签 + 1-based 行号，上限 10 条）；命令面板/右键亦可，无灯泡参数时按 选区→光标行→全文 兜底收集问题。
  • Explain / Refactor 选区右键（0.20.0）：选中代码右键 → 种入引用 @selection 的请求（CLI 发送时展开为实时选区，不嵌码无时序耦合）+ 文件/行号指针；右键项仅 editorHasSelection 显示。
  • /cost、/context 面板命令（0.20.0）：转交 CLI 真相源 cc cost <id> / cc context <id>（本面板 session），等宽块渲染，不在 webview 重算定价/上下文。
  • workspace symbol @-mention（0.21.0，gap D）：@-补全新增按符号名（函数/类/方法）搜索 → 选中符号插入其所在文件为 @<path>（CLI 只认 @<path>），按符号名找文件名不同的文件;标签 <kind> <name> · <path>,≥2 字符触发、按路径去重。面板 @ 三类来源（IDE 伪 mention / 文件 / 符号）齐全。
  • 发布：tag ide-vscode-v0.20.0（0.19+0.20）与 ide-vscode-v0.21.0（gap D）→ ide-extensions.yml 清洁室构建（扩展/IDE 测试全绿 + 干净 .vsix）发 Open VSX；官方 Marketplace 跳过（无 VSCE_PAT，Azure 受限），不建 GitHub Release。ws transport 仍有意 defer。

Fixed ​

  • project-service ZIP 导出 UTF-8 编码 bug：导出写 ZIP 条目用平台默认编码（GBK 默认 JVM），导出含中文项目后 UTF-8 导入端抛 MalformedInputException 无法回环重导入。改为始终 UTF-8 + null 内容写空条目兜底。

Tests / QA hardening ​

  • CLI：恢复 deprecated-shim 导出平价（agent-core/mcp-client）+ 补 hub 子命令 douyin-watch-sync + skill sources 4→6 层 + 24 个 e2e 文件子进程超时 15s→30s（消除 Windows 冷启动 spawnSync ETIMEDOUT 抖动）。
  • 桌面：内置技能计数 145→146（新增纯文档型 pdh-android-collector）+ DOC_ONLY_SKILLS 白名单校验。
  • 后端 Java（project-service）：mvn test 32 失败 → 0（补 @Mock UserMapper、宽松 stubbing、对齐过期断言/调用计数、导入测试 UTF-8 + ObjectMapper stub）。
  • 后端 Python（ai-service）：对齐 git_manager 过期 API 断言 + 修 code_generator 过期返回键（refactored_code）；pytest 15 → 41+ 通过。

[v5.0.3.114] - 2026-06-15 — 个人数据中台 gov-ixiamen 端点真机静态校验 + Android cc bundle v20260615d（pdh 0.4.25 / cli 0.162.71） ​

用已 root 真机对 PDH「端点抓包」runbook 跑静态分析层（只读 APK 二进制，无任何登录态/账号介入），校验若干 best-effort scaffold 的占位端点。@chainlesschain/personal-data-hub 0.4.24→0.4.25、CLI chainlesschain 0.162.70→0.162.71 已发 npm；Android cc bundle 滚到 internal-binaries-android-v20260615d、USR_VERSION → 45。桌面 / Android / iOS 全 surface 对齐 .114。

Fixed — gov-ixiamen 采集器主机域名纠正（静态 APK 校验） ​

  • i 厦门 com.xmgov.xmapp 的 cookie-api 占位主机原是错的：旧 app.ixm.gov.cn 为虚构域名；真机 dex 静态分析确认真实后端为 *.ixiamen.org.cn（业务网关 https://buss.ixiamen.org.cn/pbc/）。已改为真实网关（opts.listUrl 仍可覆盖），/handle/list 尾段 + 请求体仍 unverified（body 经 libzxprotect 加密静态不可见）。adapter VERSION 0.1.0→0.2.0。
  • 银行/政务结论一并记入 runbook §3.1：中行（SecNeo 壳，明文仅推送 SDK 域 → 维持 snapshot）、工行（网关域可见但请求体加密+签名 → 维持 snapshot）、12123（域名早已正确，子路径由 libNetHTProtect 原生构造）。

[v5.0.3.113] - 2026-06-15 — npm 发布/安装链路加固（npmmirror 自动同步 + 版本弃用 workflow）+ VS Code 扩展 0.28/0.29 + CLI 0.162.70 ​

修复中国大陆镜像装机失败、加固 npm 发布链路，并继续推进 IDE / CLI 体验。桌面 / Android / iOS 全 surface 对齐 .113（check-version-sync 绿）。Android cc bundle 滚到 internal-binaries-android-v20260615c（携 cli 0.162.70 + pdh 0.4.24），USR_VERSION → 44。

Fixed — npm 安装可靠性（中国大陆镜像） ​

  • npmmirror tarball 懒同步导致 npm install E404（#33）：@chainlesschain/core-infra@0.1.0 在 registry.npmmirror.com 仅有元数据、tarball 未缓存 → 默认走淘宝镜像的用户装机硬失败。修：① 手动触发镜像 sync API 修复线上（tarball 404→200，镜像装机恢复）；② npm-publish.yml 新增「发版后自动 PUT 镜像 sync API」步（best-effort，结果进 job summary，不阻断发版），后续每次发版自动补齐；③ README（中英）补「改用官方源 npm i -g chainlesschain --registry https://registry.npmjs.org」说明。

Added — npm 发布链路工具 ​

  • npm-deprecate.yml：参数化 workflow，用 NPM_TOKEN secret 弃用/取消弃用已发布的 npm 版本（本地 token 已过期，发布权限只在 CI）。
  • CLI 0.162.68 → 0.162.70 收口：0.162.68 误从陈旧 tag 发布、personal-data-hub-wiring.js 漏接 8 个 PDH adapter（douban/ximalaya/keep/didi/mercedes/eleme/xianyu/vipshop）→ 已 deprecate；0.162.69 为修复版（从 main 重发，含完整 adapter wiring）；0.162.70 续推 REPL 增强（已发 npm，npm latest）。

Added — VS Code 扩展「ChainlessChain IDE Bridge」0.28.0 / 0.29.0（已发 Open VSX） ​

  • 后台 tab 完成信号（0.28.0）：非当前可见会话 tab 跑完时给出完成提示。
  • 面板 / slash 命令 + @ 补全 + /rewind（0.29.0）：聊天面板内联 slash 命令与 at-mention 自动补全；/rewind 回到 agent checkpoint。

[v5.0.3.112] - 2026-06-15 — 个人数据中台补 6 个跨平台采集器 + Android cc bundle v20260615b（pdh 0.4.24 / cli 0.162.67） ​

补齐路线图 / 参考机之外、但高个人数据价值的 6 个主流平台采集器。@chainlesschain/personal-data-hub 0.4.23→0.4.24、CLI chainlesschain 0.162.66→0.162.67 已发 npm；Android cc bundle 滚到 internal-binaries-android-v20260615b（携全部新 adapter），USR_VERSION → 43。桌面端 / CLI 即装即用，Android 端随 v5.0.3.112 APK 携带。

Added — 6 个新采集 adapter ​

  • 饿了么（shopping-eleme）：外卖订单（snapshot + cookie-api，镜像美团外卖结构）。
  • 闲鱼（shopping-xianyu）：二手买卖记录，买 / 卖双向（对手方角色随 side 翻转）。
  • 唯品会（shopping-vipshop）：品牌特卖订单（品牌 → 商家）。
  • 豆瓣（social-douban）：书影音兴趣图谱——标记（看过 / 想看 / 在看）→ 媒体事件 + 条目、影评 → 帖子、关注 → 联系人。
  • 喜马拉雅（audio-ximalaya）：听书 / 播客收听历史——收听 / 收藏 / 订阅专辑（新 audio- 类目）。
  • Keep（fitness-keep）：运动训练记录，多类型（跑步 / 骑行 / 瑜伽 / 力量 …）。

全部 snapshot 主路径 + cookie-api（注入式 fetch + signProvider seam，端点 best-effort 可覆盖、未实地验证）；各 adapter 全单元测试通过，接桌面 / CLI 双壳。adapter 总数 83 → 89。

[v5.0.3.111] - 2026-06-15 — 个人数据中台采集器再扩面 + Android cc bundle 滚到 v20260615（pdh 0.4.23 / cli 0.162.65） ​

继 v5.0.3.110 之后再补一轮 PDH 采集长尾：新增 西瓜视频 / 天眼查 / 懂车帝 / 企业微信（wework-pc）等 adapter，并由并行支线补上 个税（gov-tax scaffold）/ 扫描全能王 / 美柚 / i 厦门。@chainlesschain/personal-data-hub 0.4.18→0.4.23、CLI chainlesschain 0.162.60→0.162.65 已发 npm；Android cc bundle 滚到 internal-binaries-android-v20260615，USR_VERSION → 42。至此 PDH 路线图除 6 个 gov/bank 强认证 app（故意 defer）外的消费级平台已全部接通。

Added — 本轮新采集 adapter ​

  • 西瓜视频（video-xigua）、天眼查（biz-tianyancha）、懂车帝（social-dongchedi）、企业微信电脑版（wework-pc）、个税 APP（gov-tax，scaffold）。

[v5.0.3.110] - 2026-06-14 — 个人数据中台采集器扩面：13 个新平台 adapter（出行 / 购物 / 社交 / 文档 / 音乐 / 视频 / 招聘） ​

一轮 /loop 把 PDH 采集覆盖补齐：完成阶段（Phase 5–12）所有 ≥⭐⭐⭐ 平台 + 可行的 Phase 13+ 长尾全部落地。@chainlesschain/personal-data-hub 0.4.7→0.4.18、CLI chainlesschain 0.162.49→0.162.60 已发 npm；Android cc bundle 滚到 internal-binaries-android-v20260614b，USR_VERSION → 37。

Added — 13 个新采集 adapter ​

  • 出行：travel-tongcheng（同程旅行）、travel-didi（滴滴企业版）。
  • 购物：shopping-dianping（大众点评）—— 补 Phase 7 ⭐⭐⭐⭐ 漏建（订单 / 团购）。
  • 社交 / 内容：social-zhihu（知乎）、social-csdn（CSDN）。
  • 文档 / 云盘：doc-wps（WPS 云文档）、doc-tencent-docs（腾讯文档）、doc-baidu-netdisk（百度网盘）。
  • 音乐：music-kugou（酷狗音乐）。
  • 视频：video-iqiyi（爱奇艺）、video-tencent（腾讯视频）。
  • 招聘：recruit-boss（BOSS 直聘）。
  • 每个 adapter 双模：snapshot（设备快照）+ cookie-api（注入 fetchFn + signProvider seam，端点 best-effort 可覆盖）。

Changed ​

  • 新增 3 个同形平台共享工厂：_document-base、_video-base（与既有 shopping-base / travel-base 一致）。
  • pdh / cli 已发 npm；Android binariesVersion → 20260614b（bundle 内核实测携带 pdh 0.4.18 + cli 0.162.60）。

[v5.0.3.109] - 2026-06-14 — fix: Android 发布 APK 缺 cc bundle — release.yml 补 downloadInternalBinaries staging + 硬验证 gate ​

v5.0.3.108 真机验证发现发布的 APK 不含 cc-cli.tgz（设备上 local-terminal/cc 不可用）。根因:release.yml build-android 只跑 assembleRelease,downloadInternalBinaries 的 preBuild lazy dependsOn 在 CI 不触发。纯打包修复——bundle 内容不变（pdh 0.4.6 / internal-binaries-android-v20260613 / USR_VERSION 25）。

Fix —— Android release APK bundle 打包 ​

  • assemble 前独立步骤跑 ./gradlew downloadInternalBinaries(保证 cc-cli.tgz 落盘后再被 mergeReleaseAssets 快照)。
  • build 后硬验证 gate:unzip -l <apk> | grep assets/local-terminal/cc-cli.tgz,任一 APK 缺则 exit 1。
  • 版本面:productVersion v5.0.3.108 → v5.0.3.109 / desktop 5.0.3-alpha.109 / Android versionCode 503109 / iOS CFBundleVersion 109（USR_VERSION 25、binariesVersion 20260613 不变）。

拼多多是购物三联里最后一个仅 user-export 快照、无自动采集路径的适配器；本版补齐 cookie-api 主动采集，与 taobao/jd/meituan 平价，并随 Android in-APK cc bundle v20260613 下发。

  • 新增 _syncViaCookie：经注入的 fetchFn 拉取 mobile.yangkeduo.com/.../transaction_list（Node 保持纯解析/编排，与 taobao/jd/meituan 同 seam）。
  • anti_token 签名经 signProvider seam 注入（纯 Node 扛不住拼多多签名轮换；Android 端由 in-APK WebView JS VM 产出），传给 fetchFn 作 antiToken，无 provider 时为 null（best-effort）。
  • orderToRecord 映射 transaction_list 字段（snake/camel 双兼容）+ 分→元换算 + 数字/文本状态映射；extractOrders 容错嵌套返回；分页命中 watermark 提前停。
  • capabilities 升 sync:snapshot + sync:cookie-api；version 0.1.0 → 0.2.0。+13 cookie-api 测试，PDH 全套 128 文件 2094 tests 通过 / 9 跳过。

Chore —— 发版链 ​

  • @chainlesschain/personal-data-hub 0.4.5 → 0.4.6 + chainlesschain CLI 0.162.47 → 0.162.48 已发 npm（CLI pin pdh 0.4.6）。
  • Android in-APK cc bundle：internal-binaries-android-v20260613（pdh 0.4.6）+ USR_VERSION 24 → 25 + binariesVersion 20260612 → 20260613。
  • 版本面：productVersion v5.0.3.107 → v5.0.3.108 / desktop 5.0.3-alpha.108 / Android versionCode 503108 / iOS CFBundleVersion 108。

[v5.0.3.107] - 2026-06-12 — feat: 个人数据中台 FAMILY-23 家庭守护采集器 v0.2 live fetcher 全收口（作业帮 / 华为学习中心 / 支付宝）+ Android cc bundle v20260612 ​

本版收口个人数据中台「家庭守护 telemetry」最后 3 个仅快照占位的采集器，使其具备主动 live 采集能力，并随 Android in-APK cc bundle 下发；同时一并随产物发布前期已单独发 npm 的 cc CLI 0.162.41 Claude-Code 平价工作。

Feat —— FAMILY-23 家庭守护采集器 v0.2（snapshot + live 双路） ​

  • 作业帮 edu-zuoyebang：ZYBUSS 会话 cookie → 用户信息 + 学习/搜题记录
  • 华为学习中心 edu-huawei-learning：华为账号会话 cookie → 用户信息 + 课程学习记录
  • 支付宝 finance-alipay：会话 cookie → mobilegw 账单/交易明细（签名 seam；金额元→分 + 收支方向推导；高敏感闸不变）
  • 三者补齐 sync:cookie + _syncViaLive（normalize 路径不变）；新增共享 _live-json-helpers.js
  • 端点 best-effort（多字段名兼容，未实地验证）；测试 +39，PDH 全套 2083 tests 全绿

Release —— 发版链全闭环 ​

  • personal-data-hub 0.4.4→0.4.5 + CLI 0.162.45→0.162.46 已发 npm（run 27387691645）
  • Android cc bundle 重建 internal-binaries-android-v20260612（cli 0.162.46 + pdh 0.4.5）+ USR_VERSION 23 → 24（真机装新 APK 触发 sentinel 重提取）

[cc CLI 0.162.41] - 2026-06-11 — feat: Claude-Code 平价终章——项目记忆（cc.md）+ REPL steering + 结构化输出（npm 单独发布，随 v5.0.3.107 产物一并发布） ​

对照 Claude Code 的 CLI 平价 backlog 一日清空并发版：①项目记忆体系——cc agent 自动加载 cc.md > CLAUDE.md > AGENTS.md 层级（@path 递归 import + 路径作用域 .claude/rules + .chainlesschain/rules.md，预算 fail-open，CC_PROJECT_MEMORY=0 关）；cc init 默认改为项目盘点生成 cc.md（/init 平价，模板退 -t，--ai 用有界 agent 精炼约定，已有 CLAUDE.md 自动 @import 防遮蔽）；cc memory files 查看实际加载链。②REPL steering 三件套——回合中输入 FIFO 排队（修并发回合 race）、Esc 即时中断、/rewind + 空闲双 Esc 会话回退（原文回填改完重发）；外加 ! <cmd> bash 直通、# <note> 快捷记忆、/ 命令 TAB 补全、/context 实时窗口占用、--resume 离线恢复摘要。③结构化输出与生态出口——cc agent -p --json-schema（回答经 JSON Schema 校验 + 自动纠错重试，stdout 只出合规 JSON）、cc mcp serve（本机文件工具反向暴露为 MCP server，root 限域 + Bearer）、cc session export（agent 转录 Markdown）/ cc session search（跨会话全文检索）、启动被动版本提醒（CC_UPDATE_NOTICE=0 关）。④chainlesschain CLI 0.162.40 → 0.162.41 已发 npm（发布产物全局安装实测通过，~120 新增单测随包）。

[v5.0.3.106] - 2026-06-11 — fix: PDH 快手 api_ph base64 采集修复 + 高德标题 bug + 出行/社交全适配器测试收口（pdh 0.4.4 / cli 0.162.40）+ Android cc bundle v20260611（真机实证重提取） ​

本版以 PDH 个人数据中台采集层为主线：①修复新版快手 kuaishou.web.cp.api_ph cookie 改为 base64(JSON) 后 profile 采集失败（apiPhDecodeCandidates 解码链，pdh 0.4.4）；②修复 travel-base buildTitle 不认 name 字段导致所有高德路线/搜索事件标题为 car: ? → ?；③订正头条/快手/邮箱适配器 3 处过时注释。④测试矩阵全收口 +180，全仓 55 适配器测试覆盖 100%。⑤pdh 0.4.3→0.4.4 + cli 0.162.39→0.162.40 已发 npm；⑥Android in-APK cc bundle 重建 internal-binaries-android-v20260611（pdh 0.4.4 + cli 0.162.40）+ USR_VERSION 21 → 22。⑦真机（Xiaomi amethyst）实证：装新 APK 触发 sentinel 17→22 重提取，设备上 pdh=0.4.4 + 两处修复 grep 命中。

Fix —— PDH 采集层（pdh 0.4.4） ​

  • 快手 api_ph base64(JSON) cookie 解码 fallback（新版快手 profile 采集恢复）
  • travel-base buildTitle 加 name 三级回退（修高德所有行程事件标题）
  • 订正头条/快手/邮箱 3 处过时注释

Test —— 适配器测试矩阵全收口（+180，全仓 55 适配器 100% 覆盖） ​

  • 小红书 ADB 三件套 58 + 出行 6 模块 74 + whatsapp/shopping-base 24 + 快手 base64 9

Android —— in-APK cc bundle 刷新 + 真机验证 ​

  • internal-binaries-android-v20260611（pdh 0.4.4 + cli 0.162.40）+ USR_VERSION 22
  • 真机实证 sentinel 17→22 重提取 + 设备上 pdh 0.4.4 代码落地

[v5.0.3.105] - 2026-06-10 — feat: cc agent MCP prompts/resources + SubagentStop hook + --fork-session（CLI 0.162.38）+ Android cc 内置 bundle 刷新 ​

本版把 v5.0.3.104 之后 2026-06-10 的 CLI 平价主线固化为一次正式发版：①MCP prompts 作为 slash 命令 + MCP resources 暴露给 agent/REPL；②SubagentStop settings.json hook（Claude-Code 平价）；③cc agent --fork-session（Claude-Code 平价）；④CLI 0.162.38 已发 npm；⑤Android in-APK cc bundle 重建（cli 0.162.38 + pdh 0.4.3）+ USR_VERSION 20 → 21，补上 v5.0.3.101 以来 APK 内置 cc 跑旧代码的缺口；⑥CLI e2e 共享 helper + e2e 隔离/重试 CI 加固；⑦docs-site 补全 14 个 CLI 命令用户文档 + 全站数字对账（155 命令/145 技能/25 Android）。

Feat —— cc CLI 0.162.38（Claude-Code 平价三连） ​

  • MCP prompts 作为 slash 命令 + MCP resources 暴露给 agent/REPL
  • SubagentStop settings.json hook
  • cc agent --fork-session：复制既有会话为新分支继续

Android —— in-APK cc bundle 刷新 ​

  • cc-cli.tgz 重建（cli 0.162.38 + pdh 0.4.3）→ 新内部二进制 release，binariesVersion + manifest sha256 同步
  • USR_VERSION 20 → 21：真机升级后强制重新解包新 bundle

Tests / CI ​

  • CLI e2e 共享 helper（testHome + freePort）+ e2e 隔离/重试 CI 加固
  • 桌面端 10 个 stale 单测修复

Docs ​

  • docs-site 补全 14 个 CLI 命令用户文档 + 全站数字对账：155 命令/145 技能/25 Android

[v5.0.3.104] - 2026-06-10 — chore: CLI 0.162.37（IDE 桥接收官）+ 全平台版本对齐 + docs/品牌清扫（补记） ​

（补记条目 —— 发版当时未写 changelog）本版主体：①CLI 0.162.37 发 npm（IDE 桥接全 Phase 收官后的聚合版）；②iOS/Android/desktop 版本对齐 v5.0.3.104；③VS Code 扩展 Open VSX 自动发布 CI + 图标重绘；④JetBrains buildPlugin 修复（关 instrumentation）；⑤docs-site 新增 8 个 CLI 用户文档页 + Family Guard 用户页 + V2 治理命令开发者参考；⑥发布文档脱敏；⑦桌面端 vitest-4 stub bug + 12 个 stale 测试修复。

[v5.0.3.103] - 2026-06-10 — feat: cc loop（/loop 平价）+ IDE 桥接 Phase 3/4（JetBrains 平价 + 发布基建）+ VS Code 扩展可视化与品牌化 ​

本版把 v5.0.3.102 之后 2026-06-10 的工程主线固化为一次正式发版：①cc loop —— Claude-Code /loop 平价：固定间隔循环 + --dynamic 自定步速 + --save / --resume 会话持久化 + headless（非 TTY）下稳定运行；②IDE 桥接 Phase 3 —— JetBrains 平价（纯 JDK 协议核 + IntelliJ glue，跨语言 interop 实跑验证）；③IDE 桥接 Phase 4 —— 发布与维护基建（ide-extensions.yml：vsce package/publish + gradlew buildPlugin，tag + secret 双门控）；④VS Code 扩展 —— IDE 桥接可视化（状态栏 + 侧边栏 + 仪表板）+ ChainlessChain 品牌 logo/图标（0.2.0 / 0.2.1）；⑤REPL 中 IDE 自动连接遵循 --ide / --no-ide。CLI 沿用 0.162.36、PDH 0.4.3（已发 npm）。

Feat #1 —— cc loop（Claude-Code /loop 平价） ​

  • 固定间隔循环执行 prompt / slash 命令
  • --dynamic 自定步速 + prompt 模式 agent flag 透传
  • --save / --resume 会话持久化
  • headless（非 TTY）下稳定运行 + 集成/E2E 测试

Feat #2 —— IDE 桥接 Phase 3/4 ​

  • Phase 3：JetBrains 平价 —— 纯 JDK 协议核 + IntelliJ glue，CLI 零改动双证 + 跨语言 interop 实跑验证
  • Phase 4：发布与维护基建 —— ide-extensions.yml（vsce package/publish + gradlew buildPlugin，tag + secret 双门控，缺 secret fail-fast）+ LICENSE/CHANGELOG + 发布文档
  • REPL 中 IDE 自动连接遵循 --ide / --no-ide

Feat #3 —— VS Code 扩展可视化与品牌化 ​

  • IDE 桥接可视化：状态栏 + 侧边栏 + 仪表板（0.2.0）
  • ChainlessChain 品牌 logo 作为扩展图标 + Activity Bar 图标多轮打磨（0.2.1）

[v5.0.3.102] - 2026-06-10 — feat: IDE 桥接落地（cc ide + VS Code 扩展）+ cc 命令行 Claude-Code 平价收官 + cc agent 多模态视觉输入 ​

本版把 cc 命令行向 Claude Code 的平价能力收官，并新增 IDE 桥接与多模态视觉输入：①IDE 桥接 —— 新增 cc ide 命令 + VS Code 扩展，自动发现并连接编辑器内置的 MCP server，支持 openDiff 接受/拒绝往返（CLI 命令数 149 → 150）；②cc 命令行 Claude-Code 平价收官 —— MCP OAuth 远程授权、自定义及内置上下文用量状态栏、输出风格、web_search 可插拔搜索、扩展思考、settings.json 全事件 hooks 及 block 语义、headless agent -p、/compact 自动压缩、cc checkpoint 双引擎、权限规则；③cc agent --image 多模态视觉输入（自动使用配置的视觉模型）。CLI 0.162.36 已发 npm。

Feat #1 —— IDE 桥接（cc ide + VS Code 扩展） ​

  • 新增 cc ide 命令：自动发现并连接编辑器内置的 MCP server
  • VS Code 扩展：openDiff 接受/拒绝往返，编辑器内审阅 AI 改动
  • CLI 命令数 149 → 150

Feat #2 —— cc 命令行向 Claude-Code 平价收官 ​

  • MCP OAuth 远程授权：cc mcp login <url> 走 Auth Code + PKCE，token 按 origin 持久化，connect 时注入 Authorization: Bearer（到期 refresh）
  • 状态栏：自定义 statusLine 命令 + 内置上下文用量行（模型 · 已用/窗口 · cwd · 轮次）
  • 输出风格 /output-style：命名 persona 叠加系统提示 + 内置 explanatory/learning
  • web_search 可插拔搜索源：tavily/brave/bocha/qianfan + keyless duckduckgo/searxng/baidu
  • 扩展思考：--think / --ultrathink / --thinking-budget（Anthropic opt-in）
  • settings.json 全事件 hooks + block 语义：PreToolUse/PostToolUse/UserPromptSubmit/SessionStart/SessionEnd/Stop/PreCompact
  • 权限规则：.claude/settings.json allow/ask/deny（deny > host-deny > ask > allow）+ 交互 always-allow 持久化
  • headless agent -p 全家桶 + /compact 自动压缩 + cc checkpoint 双引擎（git plumbing 影子提交 + copy fallback）

Feat #3 —— cc agent 多模态视觉输入 ​

  • cc agent --image：自动使用配置的视觉模型读图

版本同步 ​

  • productVersion v5.0.3.101 → v5.0.3.102
  • desktop-app-vue 5.0.3-alpha.101 → 5.0.3-alpha.102
  • chainlesschain CLI 0.162.32 → 0.162.36（已发 npm）
  • @chainlesschain/personal-data-hub 0.4.3（不变）
  • Android USR_VERSION 20（不变）+ versionCode 503101 → 503102 + versionName 5.0.3.101 → 5.0.3.102；binariesVersion 待 cc-cli.tgz 重建（Android cc 内嵌 bundle 仍为旧代码）
  • iOS CFBundleVersion 101 → 102

[v5.0.3.101] - 2026-06-09 — feat: CLI Claude-Code 平价收尾 + PDH 微信4.0/QQ-NT 一键采集 + 安全 fail-closed 套件 + U-Key 托管层（gated） ​

本版把 v5.0.3.100 之后累积的工程主线固化为一次正式发版：①CLI 向 Claude-Code 平价收尾（headless agent -p 全家桶 + cc cost + 文件态 checkpoint）；②个人数据中台（PDH）微信 4.0 完整采集 + QQ-NT 一键解密/解析（真机 nt_msg.db 验证通过）；③一批安全 fail-closed 收口（SAML/OAuth/通道签名/permission-ipc）；④U-Key 口令托管层（Phase 3，默认 gated OFF）；⑤桌面数据库/LLM 性能面板 V6 端口接通。npm：pdh 0.4.2 → 0.4.3 + CLI 0.162.31 → 0.162.32，Android USR_VERSION 19 → 20 强制真机重抽 cc-cli.tgz。

Feat #1 —— CLI Claude-Code 平价收尾（headless agent + cost + checkpoint） ​

  • headless agent -p 全家桶：--output-format / --max-turns / --allowed-tools / --disallowed-tools / --permission-mode / stdin、--input-format stream-json（多轮）、--system-prompt / --append-system-prompt、--add-dir 多根工作区、--fallback-model
  • @file 引用在 ask + chat 非 agent 入口平价
  • cc cost token 计费 + 配置化价格覆盖 llm.pricing
  • 文件态 cc checkpoint / rewind（git plumbing 影子提交，零触工作区/真索引）
  • 共享交互式 session picker，cc session resume 复用
  • 跟进（CLI 0.162.33，单独 npm 发布）：headless 上下文自动压缩 + 手动 cc compact（Claude-Code /compact 对标）——agent -p / --resume 长会话超阈值时本轮自动压缩（默认开，按模型 context window 自适应阈值；截断/snip 保证工具对安全，不留孤儿 tool 结果），并写 compact 事件供 --resume 从压缩后的短历史重建；cc compact <id> 离线压缩存档会话（--dry-run / --json）；stream-json 输出 compaction 事件
  • 修：headless stdout 不再混入 bootstrap 日志；--disallowed-tools 此前静默无效（现合并 persona + caller 两个 deny-list）

Feat #2 —— PDH 微信 4.0 完整采集 + QQ-NT 一键解密/解析 ​

  • 微信 4.0 一键解密 + PC 本地 DB 自动发现 + QQ-NT 解密器内核
  • 微信 4.0 完整采集：每库独立密钥 + zstd 消息体解压 + 联系人；公众号 + 朋友圈 + 收藏；非文本消息人话化（链接/文件/图片…）
  • QQ-NT 端到端解密 + protobuf 消息解析（真机 nt_msg.db 验证）+ 名称补全（uin→昵称 / 群号→群名）+ android.root_pull + pdh-im-collect 内置技能
  • 社交平台 ADB 感知 readiness（root 真机一键）+ 真机采集漂移修（微博 cookie 目录 glob / 抖音 SQLCipher / 豆包诊断）

Feat #3 —— 安全 fail-closed 套件（审计跟进） ​

  • SAML 签名 + OAuth id_token 验证 fail-closed
  • 通道消息签名 fail-closed
  • permission-ipc DB 回退镜像受管加密、删硬编码 "123456"
  • 渲染层 days 入参净化 + 不再吞 sandbox 审计错误

Feat #4 —— U-Key 口令托管层（Phase 3，默认 gated OFF） ​

  • U-Key passphrase escrow provider 层 + 接入 bootstrap DB-key 解析（默认关）
  • PIN 解锁流程 + 备份码 UI 设计

Feat #5 —— 桌面性能面板 V6 端口 + 后端 IPC 接通 ​

  • 数据库性能 / LLM 性能页 port 到 V6 shell（path M）
  • 数据库性能面板后端 IPC 此前从未注册 → 10 个 db-performance:* 通道静默空白；现接通 + DI 接缝 + 6 测试

Android UX（真机反馈） ​

  • 扫码加好友后跳对方资料页（之前只弹 Toast 无法加好友）+ AI 陪学空历史问候移到 UI 层 + 「本机角色」卡（设为孩子后 SOS/遥测/任务才生效）+ SOS 大红按钮接真触发

测试 / 质量（cowork skills 套件收口） ​

  • pdh-im-collect 内置技能单测 19 例：readiness 探测（array / keyed-object / 噪声 JSON 解析 + cc 缺失降级）、wechat/qq 指引、--run 选择性执行、口令脱敏（永不回显）、输入路由、错误处理；经 _deps 注入接缝 stub cc CLI，零真实子进程
  • 修 cowork skills 套件两处历史 fail：skill-lazy-load re-spy 陈旧调用计数误判（清 spy，实现未动）；youtube-summarizer 命中真 YouTube 网络 60s 超时 → 加 _deps.fetchText 接缝 + fixture stub 改 12 例确定性用例
  • cowork skills 全量套件复跑：47 文件 / 815 测试全绿（0 fail）

版本同步 ​

  • productVersion v5.0.3.100 → v5.0.3.101
  • desktop-app-vue 5.0.3-alpha.100 → 5.0.3-alpha.101
  • chainlesschain CLI 0.162.31 → 0.162.32（待发 npm）
  • @chainlesschain/personal-data-hub 0.4.2 → 0.4.3（待发 npm）
  • Android USR_VERSION 19 → 20 + versionCode 503100 → 503101
  • iOS CFBundleVersion 100 → 101

[v5.0.3.100] - 2026-06-08 — chore(release): 版本对齐发布（CLI npm 发布通道修复 + PDH 0.4.1） ​

把 v5.0.3.99 之后的打包工作固化为一次正式发版。无桌面 / Android / iOS 应用源码改动 —— 本版产物与 v5.0.3.99 功能等同，仅版本号对齐 + 工程通道修复。

Fix —— CLI npm 发布通道修复（web-panel prepublishOnly 构建） ​

  • chainlesschain 的 prepublishOnly → npm run build:web-panel 在 npm publish 下长期失败：vite ERR_MODULE_NOT_FOUND @vitejs/plugin-vue。
  • 真因：构建脚本跑在父 npm publish 内，父 npm 泄漏 npm_config_local_prefix / npm_config_* 指向真实仓库根，子 npm install 因此把依赖装到真实根而非构建目录 → vite 解析不到工具链（standalone 运行正常，故只在 CI / publish 下复现）。
  • 修复：build-web-panel.mjs 改为隔离 temp 目录构建 + scrub npm_config_* / npm_package_* / INIT_CWD 环境变量，子 npm 把 temp 目录当成自己的工程根。CLI 从此可正常发版（npm-publish dry-run 绿，CLI tarball 3.4 MB / 720 files）。

Publish —— npm 包 ​

  • @chainlesschain/personal-data-hub 0.4.0 → 0.4.1（README 刷新到 51 adapter / readiness / 一键采集 现状）
  • chainlesschain CLI 0.162.29 → 0.162.30（dep pin pdh 0.4.1）
  • 两包均已发布并验证安装（npm i 拉取 + 加载/运行正常）

版本同步 ​

  • productVersion v5.0.3.99 → v5.0.3.100
  • desktop-app-vue 5.0.3-alpha.99 → 5.0.3-alpha.100
  • Android versionCode 503099 → 503100 / versionName 5.0.3.99 → 5.0.3.100
  • iOS CFBundleVersion 99 → 100
  • 全平台 18 产物（Win / Mac / Linux / Android / iOS）已 ship（release run 27130664552 全绿）

[v5.0.3.99] - 2026-06-08 — feat: 个人数据中台（PDH）采集大更新 + DB 静态加密默认开启 + AI 陪学接入界面 ​

本版主线是 个人数据中台（PDH）采集能力大幅扩容 + 真机生效：adapter readiness 止血 + 一键采集/导入引导 UI，新接通多家本地直读源（抖音 / 微信 PC / QQ-NT / 钉钉 / 飞书 / Apple 健康 / 网易云音乐 / 微信读书）。同时把 DB 静态加密 gate 默认翻开（PHASE_1_5_DEFAULT_ON=true），并把 Android「AI 陪学」积分 / 温和度月报 / 任务可见 UI 接成可交互入口。pdh 0.4.0 + cli 0.162.29 已发 npm，Android binariesVersion 20260608（cc-cli.tgz 刷新）+ USR_VERSION 19 强制真机重抽。

Feat #1 —— PDH adapter readiness 止血 + 一键采集 UI + 抖音/微信PC/QQ-NT 本地直读样板 (6d978c78c) ​

  • 新增 adapter readiness 概念：从宽松的 healthCheck sync 闸门分离出真正的「就绪」判定，走 registry.readiness()，解决「配置看起来正常却采不到」的死角（详见 memory pdh_adapter_readiness_vs_healthcheck）
  • 桌面/移动端「一键采集」+「导入引导」UI：把多步配置 + 触发采集收敛成单一可见入口
  • 抖音 / 微信 PC / QQ-NT 三家本地直读样板（电脑端本地 DB / 文件直读，honest best-effort）

Feat #2 —— 钉钉 / 飞书 电脑版本地 IM 采集 + 微信读书 + Apple 健康 / 网易云音乐 (e43c12509 · e1b38553b · 67add5740) ​

  • 钉钉 / 飞书 电脑版 honest best-effort 本地 IM 采集
  • 微信读书 weread cookie 采集 + 一键登录采集 UI
  • Apple 健康 + 网易云音乐 adapter + 一键采集 UI

Feat #3 —— email 账单 LLM 补全（Phase 5.5）+ iOS 加密备份解密（Phase 7.5b）(77ae9ef2c) ​

  • 邮件账单解析在结构化字段缺失时走 LLM gap-fill 补全
  • iOS 加密备份解密落地（Phase 7.5b 移动提取层延伸）

Feat #4 —— DB 静态加密 gate 默认开启 + DID keystore 打包态 fail-closed (0b9f41c5e · 7ecb3503d) ​

  • PHASE_1_5_DEFAULT_ON=true — DB at-rest 加密从「默认关、需显式开」翻成默认开启；preflip 自动化闸门已全绿（A 层 L1+L3 45 + L2 真 SQLCipher 7 + B.1 真 Windows DPAPI 探针 6，详见 d91d72f62）
  • DID keystore 在打包态 fail-closed（不再静默回退明文）+ 修 EncryptionConfigManager 构造参数

Feat #5 —— Android「AI 陪学」积分 / 温和度月报 / 任务可见 UI 接入 (e07f90086 · e9f4b36ba · eca6b2dda · a87314aba · 264cfbea4 · 760d70bd3) ​

  • M9 奖励/积分引擎纯逻辑层 + M10 家长教育/监管温和度月报纯函数 → 接成家庭 tab 可见可交互入口（积分卡 + 兑换目录 + 温和度评分 + 同类对比 + 12355 公益热线）
  • M5 任务可见 UI：家长建作业 → 进 AI 陪学引导模式（不直接给答案）+ 提交 / AI 批改 / 完成 / 打回 + family_task 23 字段 Room 持久层
  • 陪伴 tab 复用 core-security KeystoreFacade（真 AES-GCM + StrongBox）TEE 加密落盘，家长 dump 也只得密文

Chore #6 —— 死代码清理 + 依赖瘦身 + 静默吞错收口 (425382abc · cb039fcd2 · bbd33ae27 · c253890ff · b19f2f7a1) ​

  • 删 9 个 dead/orphaned 模块（v2/optimized 重构残留）+ ai-engine-manager-p2.js 993 LOC（零引用）
  • 移除 7 个未用 runtime 依赖（146 → 139）
  • shell.openExternal / openPath 前校验 URL/路径（新增 safe-open.js，仅 http(s) + 防路径遍历）
  • 后台 sync / P2P send 静默吞错改 logger 记录
  • CI 真生效修：Database Tests / Lint & Format Check 之前 fail 不挂 job（2f65700a1 · 16f81cf81）+ personal-data-hub vitest 套件首次纳入 CI test.yml（28435642b）

版本同步 ​

  • productVersion v5.0.3.98 → v5.0.3.99
  • desktop-app-vue 5.0.3-alpha.98 → 5.0.3-alpha.99（electron-updater 比对）
  • chainlesschain CLI 0.162.28 → 0.162.29
  • @chainlesschain/personal-data-hub 0.3.9 → 0.4.0（已发 npm）
  • Android binariesVersion 20260528 → 20260608（cc-cli.tgz 刷新含 cli 0.162.29 + pdh 0.4.0）+ USR_VERSION 17 → 19（强制真机重抽 cc-cli.tgz）
  • iOS build 98 → 99

[v5.0.3.98] - 2026-06-03 — fix(android): 社交/首页 ANR 修 + 家庭守护「AI 陪学」Epic A–G 纯逻辑全做透 + PDH 意图路由收口 + 浏览器扩展 handler 拆分 ​

用户反馈「点社交会卡住」长期未解；本轮定位到 ViewModel init 块默认在主线程同步读 EncryptedSharedPreferences + DIDManager.initialize 里的 StrongBox 解密（小米 amethyst 单次解密可达数秒），两路汇总把主线程吃 >5s 触发 ANR。一并把 family-guard Epic C M2 telemetry 底座（孩子端共享 child_event 表 + ForegroundAppAggregator pure state machine）落到 main，让后续 FAMILY-21/25 ticket 不再二次拆表。

范围说明：productVersion 在 3514e55e0 即 bump 到 .98，但 tag 直到 2026-06-03 才 cut；其间约 150 commit 累计骑在 .98 版本号上，随同一 tag 一并 ship。下方 #1–#3 是 .98 prep 当时的三件，#4 汇总 prep 之后累计落地的工作。

Fix #1 —— 主线程 keystore 阻塞致社交/首页 ANR 全切 IO 线程 (6ad0f7989) ​

  • HubLocalViewModel.init { … 13 个 refresh*FromStore() } 同步读 EncryptedSharedPreferences（keystore-backed），改包进 viewModelScope.launch(Dispatchers.IO) { … }
  • DIDManager.initialize() 整段 withContext(Dispatchers.IO)：loadWallet→loadEntry→StrongBoxKeyManager.unwrapEd25519Private 是阻塞式 Android Keystore (StrongBox) 调用，部分机型单次解密数秒；旧 init { viewModelScope.launch { didManager.initialize() } } 默认跑 Main → 进社交页主线程卡 >5s → ANR
  • 内部仅 _state.update / launchIn(viewModelScope)，线程安全

Feat #2 —— FAMILY-20 Epic C M2 telemetry 底座（主文档 §3.2 v0.2 起步）(abd3a2cb7) ​

  • 新 ChildEventEntity (child_event 表) + ChildEventDao + ChildEventRepository(Impl)：source / kind / payload JSON / timestamp / duration_ms / level=L1，3 index (did+timestamp / source / level)
  • 新 ForegroundAppAggregator (pure state machine, 同 app 连续 30min 合一行 / 切 package / 乱序 ts 强制 flush) + ForegroundAppRun + ForegroundAppSample (UsageStats 分钟级采样)
  • Room SCHEMA_VERSION 2→3, MIGRATION_2_3 (CREATE TABLE + 3 index, IF NOT EXISTS 全 trap [[pdh_partial_index_if_not_exists_drift]] family-guard 版规避), exportSchema=true 生成 3.json
  • DI: FamilyGuardModule.provideChildEventDao + FamilyGuardBindingsModule.bindChildEventRepository (@Singleton)
  • FamilyGuardSchemaTest version 2→3 / 8→9 tables
  • Epic C M2 后续 (FAMILY-21 ForegroundAppTimer 服务 / FAMILY-25 上行权限过滤层) 复用本 schema + Repository

Chore #3 —— docs/design 站 DEPLOYS 恢复 + www hotfix (52b7a0780 + daf3bcd05) ​

  • docs-website-v2/scripts/fetch-release-sizes.mjs 加 internal-binaries-* tag skip（避免选错最新 binaries release 拿不到 desktop asset），sweep /releases?per_page=30 找第一个含 desktop asset 的；release-sizes.json tag 回到 v5.0.3.97 / 11 sizes
  • scripts/deploy-all.py DEPLOYS[] 恢复 docs.chainlesschain.com + design.chainlesschain.com 两路（用 12:39 stamp tarball 占位），下次全量 deploy 直接复用，本轮 www-only 跑过的不重复

Feat #4 —— 随 .98 tag 累计 ship 的工作（.97 prep 之后，约 150 commit） ​

  • 家庭守护 / AI 陪学 Epic A–G 纯逻辑层全做透（:feature-family-guard 337 测试全绿）：Epic A 模块脚手架 + 角色首启锁 → B 解绑 / QR 配对 / 复活码紧急解绑 → C telemetry 上行管线（CentralTelemetryDispatcher + AnomalyDetector v0 + Quiet Hours + 数据生命周期清理）+ 桌面家长仪表板镜像 → D mobile↔mobile 通话（WebRTC 对等 + 角色协商 + 强接通配额 + 通话 UI）→ E SOS 一键求助（event 状态机 + broadcast call 协调 + 误触撤销 + 60s 外部联系人升级）→ F 地理围栏（Repository + 动作引擎 + 异常停留检测）→ G 多家长协商频道 + 不可删审计日志 + TimeAuthority 防改钟（接 24h 角色锁 / 解绑冷却 / quiet hours 三约束点）。剩余 device/UI/真机/PM 阻塞项不在本版范围。
  • PDH AnalysisEngine 意图路由收口：sum-amount 按币种拆分（不再跨币种乱加）/ count 硬上限采样 / 多币种 breakdown；静态安全审计 F2–F6（7 个 ApiClient PII 脱敏 / 缺 cookie fail-fast / CancellationException rethrow / WebView JS bridge 收窄到 active 平台 / Xhs -461 风控熔断）。
  • 浏览器扩展 background.js Phase 0/1 大拆分：从单体 background.js 抽出共享 inject/CDP core，并把 clipboard / cookies / storage / network / page / notifications / devtools(debug+inspect) / indexeddb / dom / input / events / media-emulation / lifecycle / fonts / accessibility / selection-dragdrop / performance 等 handler 全部模块化到 handlers/*.js + 注册表。
  • 桌面新增约 80 个 Pinia store 单测套件：覆盖 taskBoard / workspace / planning / memory / 各 EvoMap / federation / PQC / ZKP / WebAuthn / IPFS-cluster / GraphQL 等 store。
  • iOS / Android 验签 + 防改钟接通：Android LenientManifestVerifier 接 RemoteSkillRegistry 默认（A7）+ A1 防改钟桌面 responder / Android RpcClient。

版本同步 ​

  • productVersion v5.0.3.97 → v5.0.3.98
  • desktop-app-vue 5.0.3-alpha.97 → 5.0.3-alpha.98
  • chainlesschain CLI 0.162.27 → 0.162.28（无 src 改，仅版本号 bump，跟 productVersion 节奏）

[v5.0.3.97] - 2026-05-27 — PDH RAG 接通 Android 云模型 + 联系人电话号码 LLM 真可见 + 6 平台 endpoint hotfix 套件 ​

之前 Android CLOUD_ANDROID 路由只把用户问题原文打给云模型，AI 真就「无脑闲聊」；本地金库里有的联系人、近期事件全部失联。本轮把 PDH RAG 检索真接到云路由 + 修两个长期幻觉死角（联系人字段 strip + entity routing 被挤），并扫了 4 个社交平台的 endpoint 漂移。

Fix #1 —— PDH RAG 真接通到 Android CLOUD_ANDROID route (3f31e2894) ​

  • 新 cc hub retrieve-context CLI 命令 + LocalCcRunner.retrieveContext Kotlin 桥
  • HubLocalViewModel 整合：云路由先拉 hub.retrieveContext(question) 拿到 facts → 拼进系统消息 → 再发云模型
  • AI label 从「无脑闲聊」改为真有 citations 引回原始事件

Fix #2 —— PDH cc hub retrieve-context 冷启动 90s → <5s (eb24c4d5d) ​

  • 新 getHubMinimal() 工厂跳过 8 个 aichat adapter / kg / bm25 重型 init — retrieve-context 走只读 vault 查询无需这些
  • 真机 2026-05-27 验过：冷启 4.2s vs 旧 87s
  • 让云路由问问题在用户感知内可用

Fix #3 —— PDH summarizePerson 含 identifiers + notes (a41d50ebd) ​

  • 之前 strip phone / wechatId / email 字段 → 768 个联系人在 vault 但 LLM 答「没有足够信息」
  • 「妈手机号」「张三的微信号」类查询真能命中
  • 改 summarizePerson() 保留 identifiers Map + notes 串拼进 person facts

Fix #4 —— PDH entity-focus routing + searchPersons LIKE 名字搜索 (f5d66debc + 90343ff93) ​

  • _gatherFacts 加 entity-focus path：question 抽出 person name candidate → searchPersons → 优先注入
  • contacts 不再被 events 挤出 RAG 200 上限
  • 之前 events 多的用户问联系人问题，contacts 全被淹

Fix #5 —— PDH-Android 4 个平台 endpoint hotfix ​

  • Xhs 3 endpoint path / param 对齐 JsBridge 真路径 (64c549609) — /api/sns/web/v1/me → /api/sns/web/v2/user/me 等
  • Toutiao extractUid 加 uid_tt / sso_uid_tt / tt_webid fallback (e2de2d8e2) — passport_uid 长期 null 拒登录
  • Weibo /api/favorites 上游下线 → graceful skip (48cece8e3) — 不再给假 404
  • Douyin 收藏分页 — 之前只一页（~24 / N）静默丢 (de4be43c6) — has_more 循环分页拉全

Fix #6 —— Android askQuestion timeout 60s → 240s (d9a85d325) ​

  • MediaPipe cold-start over budget 导致首问 LLM 无响应 — 用户体感「按了没反应」
  • 一次性提到 4 min 兜底 cold-start，warm 后正常 30-60s

Fix #7 —— PDH aichat-health timers unref (c1aaf553b) ​

  • cc hub 系列命令调完不立即 exit — 因为 aichat-health setInterval 把 event loop 持有
  • 全部 timer.unref() 后 cc hub 命令秒退

文档 ​

  • docs/internal/hidden-risk-traps.md 加 trap #27 (USR_VERSION sentinel cache miss after PDH/CLI lib refresh) + trap #28 (workspace dep npm publish stale — 改 pdh/lib 或 cli/lib 必 bump version + npm publish + Android USR_VERSION，否则真机走 fast-path 跳解压用旧代码)
  • handbook 标题升到 #6-#28

版本同步 ​

  • productVersion v5.0.3.96 → v5.0.3.97
  • desktop-app-vue 5.0.3-alpha.96 → 5.0.3-alpha.97
  • chainlesschain CLI 0.162.26 → 0.162.27（src 改 + pin @chainlesschain/personal-data-hub 0.3.7 → 0.3.9）
  • @chainlesschain/personal-data-hub 0.3.7 → 0.3.9（含 RAG retrieve-context 接通 + summarizePerson 字段保留 + entity-focus routing）
  • Android versionCode 503096 → 503097 / versionName 5.0.3.96 → 5.0.3.97（USR_VERSION 12→17 累计 5 次 bump 强制重抽 cc-cli.tgz）
  • iOS CFBundleVersion 96 → 97

Bundled ​

  • test(android): Phase 2-6 androidTest infra — 18-stub reactivation foundation (c34e8b8ee)
  • fix(android-ci): scope AVD cache key to dodge prefix-match collision (54eb55246)
  • fix(android-test): 3 flaky/drifted tests + XhsApiClientSignBridgeTest endpoint sync (5e688c537 + b01f264f4)
  • fix(ci): free 30+ GB on Android E2E runner to dodge dex-merge ENOSPC (6cab8b1c3)

[v5.0.3.96] - 2026-05-27 — fix(desktop): 检查更新两路兜底 — release-in-progress 友好提示 + 窗口隐藏发系统通知 ​

用户在 v5.0.3.94 反馈：托盘点「检查更新」没反应；早些时候同一按钮还弹出过红色 dialog 把整段 HttpError 404 stacktrace 糊脸。诊断 → 两个独立但叠在一起的问题：(1) tag 推后 release.yml workflow 还在上传 assets 时 latest*.yml 暂 404，electron-updater 把整段 stacktrace 当 error 发渲染端 + 弹红卡；(2) v5.0.3.44 后更新提示走渲染端 AppUpdateNotifier 卡片（画在 BrowserWindow 内），用户从托盘点检查更新时主窗口仍在托盘 → 卡片画在不可见窗口 → 哑响。

Fix #1 —— release-in-progress 友好提示 (39913cfd7) ​

  • 新 desktop-app-vue/src/main/system/update-error-classifier.js 把 electron-updater 错按 kind 分类：release-in-progress (Cannot find latest*.yml / 404 拉 latest*.yml) vs generic
  • auto-updater.js error handler 按 kind 分流：release-in-progress 后台自检完全静默；手动检查弹 info dialog「新版本正在发布中，请稍后几分钟再试」 而不是糊 stacktrace
  • 8 case 单测覆盖（含真实 v5.0.3.95 错误文本 + latest-mac/linux 变体 + 404-only-on-non-yml 反例 + null/undefined 边界）

Fix #2 —— 窗口隐藏到托盘时检查更新发系统通知兜底 (bc322467d) ​

  • enhanced-tray-manager.js#triggerCheckForUpdates：触发检查前先 this.showWindow() 把主窗口拉回前台，确保 notifier 卡片可见
  • auto-updater.js：update-downloaded + update-not-available 两个事件加 OS Notification 兜底（窗口隐藏 / 最小化 / destroyed 时发），点击通知亮窗 → 用户随即看到 notifier 卡片 / native dialog
  • 新 update-window-visibility.js 抽 shouldFallbackToOsNotification 纯函数 helper
  • 9 case 单测覆盖 null / destroyed / 不支持 / 可见 / 隐藏 / 最小化 / 防御性兼容

Bundled ​

  • test(android): Phase 2-6 androidTest infra — 18-stub reactivation foundation (c34e8b8ee)
  • docs: auto-generate documentation from latest changes (c3f7a0c1c)

[v5.0.3.95] - 2026-05-27 — fix(desktop): legacy-GPU Chromium 130+ 崩溃自动恢复 (trap #26) ​

用户反馈：ChainlessChain-Setup-5.0.3-alpha.94.exe 装一会闪退。诊断结果不是 installer 问题 —— NSIS 装成功，但安装完最后那步自动启动 ChainlessChain.exe，Electron 39 / Chromium 130+ 的 GPU 进程在 CoreMessaging.dll 抛 STATUS_FAIL_FAST_EXCEPTION (0xc0000602)，因目标机 GPU 驱动太老（确认机型 Intel Iris Pro 5200 + 2016-09 驱动）。任何 ≤2018 GPU 驱动 + 老 Intel HD/Iris 系列机器都会撞这条，是 trap #26 (Legacy-GPU Chromium fail-fast) 的典型表现。

Fix —— marker file 自动恢复 ​

  • desktop-app-vue/src/main/index.js setupApp() 启动前写 .launching marker 到 userData；mainWindow.once("ready-to-show") 清掉 marker
  • 下次启动看到残留 marker → 判定上次崩了 → 持久化 .gpu-disabled 文件 + app.disableHardwareAcceleration() + Chromium switches (--disable-gpu / --disable-gpu-compositing / --disable-software-rasterizer)
  • 支持 CHAINLESSCHAIN_DISABLE_GPU=1 env var 手动触发；删 <userData>/.gpu-disabled 可恢复 GPU
  • 同 VS Code / Slack / Cursor / Discord 的 disable-gpu 恢复模式，外部行为驱动不依赖任何 GPU API 状态
  • commit d8dc212f1

Docs —— trap #26 + handbook ​

  • docs/internal/hidden-risk-traps.md 加 trap #26 完整正文（诊断三步 + SOP/checklist + 反模式 + 快速诊断键），标题升到 #6-#26
  • CLAUDE.md handbook reference 同步到 21 silent-failure patterns #6-#26
  • memory gpu_crash_recovery_legacy_intel_driver.md 落地

诊断快速键（user 报 "installer 闪退"时强制走） ​

powershell
# (1) installer 是否真崩
Test-Path "$env:ProgramFiles\ChainlessChain\ChainlessChain.exe"
# True → installer ✅, 问题在 app 启动

# (2) Event Log 找 0xc0000602
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='Application Error'; StartTime=(Get-Date).AddMinutes(-30)} |
  ?{$_.Message -match 'chainless'} | Select-Object TimeCreated, Message | Format-List
# 异常代码: 0xc0000602 + CoreMessaging.dll → 锁实 trap #26

# (3) GPU 驱动年龄
Get-CimInstance Win32_VideoController | Select-Object Name, DriverVersion, DriverDate

同时打包 ​

  • chore(ci): PR-advisory sidebar coverage audit for design docs
  • chore(ci): hard-gate trap #25 partial-index drift in PDH（PDH IF NOT EXISTS partial-index drift → events 表卡 1 行 / raw_events 1308 行的 silent fail，CI lint 硬拦）
  • chore(docs-infra): consolidate sync filename maps to shared JSON（两份 sync 脚本共享 docs/design/_filename-map.json）
  • test(android): fix TurnEphemeralRefresherTest CI flake — 3s → 10s poll
  • fix(android-tests): resolve 27 unit test failures across 7 classes
  • test(android): resolve 17 .kt.broken — delete 14 LLM-hallucinated + fix 2 stubs + revive TaskPlanCardTest
  • chore(android): add release-precheck workflow — R8 hotfix-chain prevention

[v5.0.3.94] - 2026-05-26 — re-tag of .93 fixes after release.yml bs3mc rebuild step failed CI ​

v5.0.3.93 tag 推送后 release.yml 新加的 bs3mc rebuild step 在 win/mac/linux 三 build 都 fail：desktop-app-vue 那份 bs3mc rebuild 成功（prebuild-install 拉 Electron 二进制），但 packages/cli 那份 fall back 到 source build，撞 v8::Context::GetIsolate 被移除的 V8 API。改用 COPY 策略：只对 desktop-app-vue 跑 @electron/rebuild + find packages -name better_sqlite3.node | xargs cp -f 覆盖所有 nested 副本。v5.0.3.93 tag 重 trigger workflow 试了多种方法都没成（delete-recreate / force-push / workflow_dispatch HTTP 500），bump v5.0.3.94 强触发。.93 全部修复内容保持原样（见下）。

[v5.0.3.93] - 2026-05-26 — hotfix: PDH 「刷新失败」(bs3mc ABI mismatch) + Providers 「加载配置 key 变了」+ save 假阴 ​

用户反馈：(1) 桌面 v5.0.3.88/.92 PersonalDataHub 点「刷新」抛 刷新失败: NODE_MODULE_VERSION 127. This version of Node.js requires NODE_MODULE_VERSION 140；(2) LLM 配置页点「加载配置」后 apiKey 被字符串 null 覆盖；(3) 保存 LLM key 后 toast 报「没有检测到配置变更」实际未保存。本 hotfix 三事齐修。

Fix 1 — bs3mc native binding ABI mismatch (release pipeline) ​

  • .github/workflows/release.yml win/mac/linux 三个 job 都加 step「Rebuild bs3mc native bindings for Electron ABI」用 @electron/rebuild@^4 --only better-sqlite3-multiple-ciphers 拉 bs3mc 官方 Electron prebuild
  • 根因：electron-builder.yml:16 设 npmRebuild: false（因 node-gyp 三平台编译都有坑），CI Node 22 npm install 抓 Node ABI 127 prebuild → ship 二进制；Electron 39 ABI 140 加载即崩。Rebuild step 拉 upstream Electron prebuild 不本地 node-gyp，绕开 npmRebuild 禁因
  • 同步 rebuild desktop-app-vue/node_modules/ 和 packages/cli/node_modules/（walker 会找到 PDH 嵌套的 bs3mc）— 用户实际报错路径是后者
  • macOS 当前 last-rebuild-wins on disk → x64 final。arm64 DMG 反而被 x64 binary 覆盖，arm64 mac 用户 followup 修
  • memory release_bs3mc_no_rebuild_step.md（trap #26 候选 — npmRebuild: false + 无 @electron/rebuild step = release ship Node ABI binary silent fail）

Fix 2 — Providers.vue parser section 污染 ​

  • packages/web-panel/src/views/Providers.vue parser 抽到 parsers.js 作 parseLlmConfigOutput 导出 — 测试不再复制粘贴
  • 原 parser 用扁平正则 ^(?:llm\.)?(\w+)… 扫全文；cc config list 输出里 llm: 段 apiKey: ****（masked 被过滤）+ enterprise: 段 apiKey: null（不含 *** 通过过滤）→ result.apiKey 被字符串 "null" 覆盖 → UI 上「点击加载配置 key 变了」
  • 改 parser 跟踪 currentSection，只读 llm: 段内的值，跨段不污染
  • 加 4 个回归测：enterprise apiKey:null 不污染 / 跨段同名 key 不被覆盖 / llm 段前的 top-level key 被忽略
  • 103/103 tests 通过

Fix 3 — saveConfig 假阴 + 重启提示 ​

  • loadConfig 改成只快照 parsed 出来的值，不再 { ...configForm } 把"用户输入但未保存的值"误当 baseline → 修「保存提示无变更但 key 实际没发后端」silent fail
  • 保存成功后弹横幅提示：桌面 ws-cli-loader 只在 createSession 时重读 config.json (ws-cli-loader.js:118-128)，已存在的聊天 session 拿不到新 key/provider/baseUrl/model — 必须新建 Chat 或重启 app

版本 ​

  • root productVersion v5.0.3.92 → v5.0.3.93
  • desktop-app-vue 5.0.3-alpha.92 → 5.0.3-alpha.93
  • Android versionCode 503092 → 503093 / versionName 5.0.3.93
  • iOS CFBundleVersion 92 → 93
  • 无 npm 包改动（packages/cli + packages/personal-data-hub 源码 since v5.0.3.92 未变）

[v5.0.3.92] - 2026-05-26 — PDH Mode B Phase 7 (6-platform Android in-APK root local DB extraction) + Toutiao in-WebView prefetch (6/6 platforms) + npm pkg refresh ​

Toutiao in-WebView prefetch (Mode A 6/6 平台齐) ​

  • ToutiaoJsBridge.kt（新建） + SocialCookieWebViewScreen.kt/HubLocalScreen.kt 接入 — 复刻 [[bilibili_in_webview_prefetch_architecture]] 给头条；passport_uid cookie 抠 + /passport/account/info/v2/?aid=24 拿 profile event；feed/collection 试调 byted_acrawler 签名（多半 CORS 拒，v0 跳过）
  • ToutiaoLocalCollector.kt — ingestPrefetched() + recordSync() 写 staging JSON 走 cc adapter 入 vault
  • 至此 in-WebView prefetch 路径 4/6 平台齐（Bilibili + Douyin + Xhs + Toutiao），Weibo 路径 A 已稳，Kuaishou 走 SignProvider

npm 包升版 ​

  • @chainlesschain/personal-data-hub: 0.3.6 → 0.3.7（SignProvider 接口 + Xhs/Toutiao/Kuaishou C 路径 collector，4 commit since last bump）
  • chainlesschain CLI: 0.162.25 → 0.162.26（C 路径 CLI/WS wiring + Bridge dry-run doctor，4 commit since last bump）
  • CLI dep pin @chainlesschain/personal-data-hub 同步 0.3.6 → 0.3.7

PDH Mode B Phase 7 — 6 平台 Android in-APK root SQLite 直读 ​

6/6 platforms 全 ship v0.1：Toutiao + Douyin + Bilibili + Weibo + Xhs + Kuaishou。每 platform 3 Kotlin files + 21 JVM tests。详 CHANGELOG.md 根条目。

  • Shared scaffold pdh/social/common/ (B0 8051f4ae5)：LocalRootCollector + BaseRootCredentialsStore + DbCohortCopier + RootShellRunner
  • HubLocalScreen + HubLocalViewModel 6 syncXxxRoot() methods + 24 VM tests
  • 5 E2E checklists + 1 unified master checklist (Win-first PowerShell, ~1 day execution)
  • 剩 (user-driven 真机): 5 platform schema 探测 / Weibo v0.2 决策树 / Xhs v2.0 + Kuaishou v2.0 (frida + 反爬 SDK neuter, 4-6 weeks/platform)

[v5.0.3.85] - 2026-05-24 — hotfix5: MediaPipe SIGABRT + PDH trap #22 recovery ​

用户反馈：「安卓端本机模型问几个联系人会崩」— v5.0.3.84 APK 在 productVersion bump (2026-05-23 09:10) 之后 30 小时才 land MediaPipe 三连修 (3fa4a81d5)，84 装机包不含 guard。本 hotfix 把 trap #22 (MediaPipe OUT_OF_RANGE → JNI abort → SIGABRT) 三处联动修真 ship；同期把 trap #22b (PDH partial-index drift) + rederive 孤儿数据救援 一并入袋。

Android — MediaPipe JNI abort 防护 (3fa4a81d5) ​

  • MediaPipeLlmEngine.chat() 进 native 前加 prompt-length guard — MediaPipe predictSync 在 prompt > setMaxTokens 时抛 IllegalStateException 后不 clear pending exception 就调 NewByteArray → CheckJNI JniAbort → SIGABRT 整 app，Kotlin try/catch 完全够不到，只能上游 fail-fast。
  • ensureLoadedLocked() session 缓存 key 加 loadedMaxTokens — MediaPipe 把 ctx 窗口烤进 LlmInference handle，首次 chat 用 512 建好后后续 maxTokens 变更全被忽略。
  • LocalLlmServer.handleChat setMaxTokens ← req.options?.numCtx（不是 numPredict）。Ollama num_predict 是 output budget，与 MediaPipe maxTokens (总上下文窗口) 不同义。
  • 3 处必须联动 — 漏一个都不修。新加 2 JVM 单测 + handbook trap #22。

PDH — partial-index drift recovery (7af396405) ​

  • migration v4：explicit DROP + CREATE partial unique index — 4 表 events/persons/places/items 同步带 WHERE source_original_id IS NOT NULL。修老 vault (pre 44c4188a8) 因 CREATE UNIQUE INDEX IF NOT EXISTS 隐藏的 schema drift → adapter.sync silent fail / events 卡 0 行 / raw_events 累积 1000+。
  • registry.rederive({ adapter?, batchSize=100 }) + vault.queryRawEvents() — 升级到 v4 后，raw_events 里的孤儿数据手动 re-derive（不 re-fetch source，不更新 watermark）。
  • cc hub rederive [--adapter <name>] [--batch-size <n>] [--json] CLI 入口，镜像 syncAdapter/syncAll 体例。
  • Android: cc-cli.tgz repack 含本修，LocalCcRunner 走 cc hub rederive 救 1305-row raw_events orphan。
  • 测试：sandbox runner 47 PASS。

包版本 ​

  • chainlesschain (CLI) 0.162.17 → 0.162.18：bundle 本修 (cc hub rederive 新命令)。
  • PDH 不动 (仍 0.2.4)。

[Unreleased — PDH Vault Browser Phase 16 — 桌面 + Android 数据可视化入口] - 2026-05-24 ​

用户反馈"安卓端和桌面端都缺少采集上来数据的可视化展示"。之前用户只能"问 AI"间接看到 RAG 召回片段，或 Android 个别 tab 的"看采集到的"bottom sheet（5 tab 中 4 个没该按钮）。本期补完整双端主动浏览器入口：分类侧栏 + FTS5 CJK 全文检索 + 5 种 category-keyed 渲染器 + 游标分页 + JSON/NDJSON/CSV 导出。

后端 (FTS5 + categories + search/facet API) ​

  • 新 categories.js — 7 buckets (chat/social/email/shopping/travel/system/ai-chat) + 单一真相源 + prefix-rule mapper getCategory() / groupByCategory()
  • migration v3：FTS5 external-content 虚拟表 events_fts + 3 个 INSERT/UPDATE/DELETE triggers 保持索引同步 + 一次性 backfill；trigram tokenizer（CJK 子串匹配，比 LIKE 快 10-100×）；探测不支持时 _meta.fts_mode='like' 透明降级
  • vault.searchEvents / facetCounts / ftsMode：游标分页 (occurred_at DESC, id DESC) 比 OFFSET 稳定 / FTS5 phrase-match 自动加引号 / category WHERE 翻译 / sub-3-char query shortQuery=true UI 提示
  • 测试：36 categories + 13 SQL helpers + 27 FTS5 native integration（trigger sync / cursor / category 过滤 / CJK trigram，21s）

协议层 (CLI + WS + composable) ​

  • CLI: cc hub search + cc hub facet-counts (含 --q --adapter --category --subtype --since --until --cursor --limit)
  • WS topics: personal-data-hub.search-events + personal-data-hub.facet-counts
  • composable: usePersonalDataHub.searchEvents() + .facetCounts()
  • 测试：4 composable wrapper tests

桌面 UI (Vue 3 + Pinia + Ant Design) ​

  • 新路由 /personal-data-hub/browser + AppLayout 侧栏菜单"数据浏览器"入口
  • Pinia store pdhBrowser.js：filters/results/cursor/facets + debounce 300ms + race-resolution token（stale slow response silently drop）+ facets 调用故意 strip adapter/category/subtype（否则 sidebar bucket counts 始终 100%）
  • 5 种 renderer：ChatBubble/OrderTable/Timeline/EmailList/Generic + dispatcher 按 category 派发（不按 subtype — subtype 漂移快）
  • 导出 ExportDropdown.vue：JSON/NDJSON/CSV 三格客户端下载，RFC-4180 escaping，filename 含日期+category
  • 测试：10 store + 12 view-level (vue-test-utils + @pinia/testing) + 19 getCategory + 11 export

Android UI (Compose + Hilt) ​

  • 第 6 tab "数据浏览" in PersonalDataHubScreen.kt (back-compat: existing NavGraph initialTab=0-4 不动)
  • HubBrowserViewModel：MutableStateFlow + debounce + race-token + 并行 facet+search async + error 捕获
  • HubBrowserScreen：stateful wrapper + stateless HubBrowserScreenContent（避 mockk HiltViewModel androidTest 初始化 trap）
  • HubBrowserRenderers.kt：categoryFor() 派发 + 5 个 Composable renderers 镜像桌面
  • LocalCcRunner 扩展：searchEvents / facetCounts 包 cc hub search 子进程，含 sealed SearchResult / FacetCountsResult / Cursor，抽 _runCcJson helper
  • 测试：7 JVM VM + 10 JVM renderer dispatcher
  • 剩: Compose UI test + 真机 latency benchmark 等 Android emulator CI job 启用

Commit 链 ​

86b3cda98  merge: github/main into local main (plumbing zero-touch merge)
8b2757704  test(pdh): vault-search.test.js fixture 修 + sandbox runner script
fe102c112  test(pdh-browser): view integration + e2e SPA routes + browser-history sync
839e534c5  feat(pdh-browser): JSON/NDJSON/CSV 导出
7b9815381  feat(pdh-browser): 4 category-keyed renderers (both shells)
b4fa54b6d  feat(pdh-android): vault browser tab + LocalCcRunner.searchEvents
3aebbbffe  feat(desktop):     PdhVaultBrowser view + Pinia store
856312de8  feat(ws):          search-events + facet-counts topics + composable
c8142e573  feat(pdh):         vault FTS5 search + facetCounts API (migration v3)
801a95969  feat(pdh):         shared adapter→category taxonomy

测试总计 149 ✅ (36+27+13+4+10+12+19+11+10+7) — Win 本地全跑通；Android Compose UI + 真机 latency 走 CI / 真机

设计文档: docs/design/Personal_Data_Hub_Vault_Browser.md 覆盖 5 个关键决策（FTS5 trigram / 两轴 taxonomy / category-keyed renderers / cursor 分页 / race token）+ 文件清单 + 已知限制 + commit 链。

FTS5 native test 本地解法: bs3mc 在 root 是给 Electron 39 (NODE_MODULE_VERSION 140) 编的，Node 任何版本都加载不了。修法 = bash packages/personal-data-hub/scripts/run-native-tests-sandbox.sh 在 $TMPDIR/pdh-fts5-sandbox/ 独立装 bs3mc 跑 27/27 PASS 21s。CI 不需此步（无 Electron 占用）。详 memory bs3mc_electron_abi_sandbox_workaround.md。

[Unreleased — PDH 4 档 LLM 路由 + 三屏 selector] - 2026-05-24 ​

用户反馈 "首页对话框没看到选项"。把 tab 0 HubAskScreen 既有的 2 路 (CLOUD_ANDROID / PC_LOCAL) 扩到 4 路 (+LOCAL_DEVICE / +LAN_OLLAMA)，并把路由选择器镜像到 tab 3 "本机数据" 与 tab 4 "本机提问" 的 HubAskCard。用户能在首页对话框直接选目标 LLM。

  • 新增 2 路：LOCAL_DEVICE (端侧 MediaPipe + 本机 RAG) + LAN_OLLAMA (用户填的局域网 Ollama URL)
  • 三屏统一选择器：tab 0 HubAskScreen + tab 3 HubLocalScreen + tab 4 HubLocalAskScreen，0/1/≥2 routes 三态分支 (banner / single label / 4 radio)
  • LAN baseUrl 持久：LlmPreferences (EncryptedSharedPreferences) + Settings → AI 后端 加 "局域网 Ollama URL" OutlinedTextField + regex 校验。StateFlow 实时同步到 ViewModel
  • 测试 (15+):
    • JVM 单测: LlmPreferences 4 LAN 用例 / HubAskViewModel 3 路由 / HubLocalViewModel 3 路由 / PersonalDataHubIntegrationTest 已更新 ctor
    • Compose UI: HubAskRouteSelectorTest 8 集成场景 (stateless content + RadioButton click + disabled state)
    • 真机 E2E: LlmRouteSelectorE2ETest 8 @Ignore'd placeholder (需配对桌面 / 真机 API key / LAN Ollama)
  • 顺手修 pre-existing test bug: HubLocalViewModelTest 2 个 budget 验证测试 stub 用了 4-any 而 fn 是 6 参，maxFacts=80 != eq(20) 默认匹配 → 补全 6-any stub 并显式断言 maxFacts/maxQueryLimit
  • commits: 7079de909 (主) + 测试 + 文档跟随
  • 关键 trap (新 memory pdh_4tier_llm_route_card_selector): llmName 后缀污染 / combine 5-arg 上限 / remoteHub.health 失败非 fatal / LAN acceptNonLocal 必 true

[v5.0.3.84 — hotfix4: CLI + desktop 接通 PDH 11 个 no-arg adapter (+ 修 2 个静默吞错)] - 2026-05-23 ​

v5.0.3.83 修了 wizard 但 cc hub sync-adapter <name> 仍报 "no adapter X"：CLI + desktop wiring 历史都只 wire 了 BilibiliAdapter，PDH 0.2.3+ ship 了 9 social/messaging + 5 map/shopping。第一轮补 8 (94b0ecf25c) 时把 Telegram/WhatsApp 也塞 for-loop，但它们 ctor 需 account 参数 → 被 try/catch silent 吞，实际从未 register。本 hotfix 修正后 land 11 个真正 no-arg + 注明 6 个 credential adapter defer。

  • CLI personal-data-hub-wiring.js：boot 时 for-loop 11 个 (Weibo / Douyin / Xiaohongshu / Toutiao / Kuaishou / QQ / BaiduMap / TencentMap / Jd / Meituan / Pinduoduo)。
  • Desktop wiring.js：同款 11 adapter wire (cross-shell parity)。
  • Defer：6 个 credential adapter 需 <vendor>-accounts.json loader infra (mirror email/alipay/wechat): Train12306 / Ctrip / Amap / Taobao / Telegram / WhatsApp。
  • CLI 0.162.16 → 0.162.17：bundle 本修。PDH 不动 (仍 0.2.4)。

[v5.0.3.83 — hotfix3: PDH AIChat 向导静态 import 改 lazy require] - 2026-05-23 ​

v5.0.3.82 web-panel PDH 页面"刷新失败"：packages/cli/src/lib/personal-data-hub-aichat-wizard.js 顶层 import { ... } from "@chainlesschain/personal-data-hub/adapters/ai-chat-history" 在 nested PDH 是旧版（如 0.2.0 缺该 subpath export）时整个 wiring 链 module-load 阶段就炸。本 hotfix 改 memoized lazy _require，错误延后到 wizard 真正调用时才报，Node 解析也有机会走 root symlink 拿到带 export 的源码副本。

  • personal-data-hub-aichat-wizard.js (dcee0c775e)：top-level static ESM import → memoized _loadAichatModule() lazy _require。3 处使用点改成调用时按需取。与既有 lazy _require for cookie-capture-spec / wizard-controller 同款防御。
  • PDH 0.2.3 → 0.2.4：纯 bump，让 CLI dep lock 到新版强制 nested install 拉新 tarball。
  • CLI 0.162.15 → 0.162.16：bundle 本修 + PDH dep 同步 bump。
  • 17/17 既有 wizard 单测全过。

[v5.0.3.82 — hotfix2: Android R8 fullMode ConcurrentModificationException] - 2026-05-23 ​

v5.0.3.81 build-android 仍 fail：proguard 修过了第一道关（Missing class 走过），但 R8 minify 内部抛 java.util.ConcurrentModificationException — AGP 8.x R8 full-mode 优化大 dex 图（Hilt + Ktor + SLF4J 合并后）时的 upstream bug。本 hotfix2 关 android.enableR8.fullMode。

  • gradle.properties android.enableR8.fullMode=true → false (14d574c046)。release.yml 注释早就要求 disable，但 sed 只改了 org.gradle.jvmargs — 从未翻这个 property，所以 v5.0.3.81 重跑还是崩。
  • upstream R8 bug 跟踪：issuetracker.google.com/issues/238045415（concurrent collection iteration in R8 optimizer）。DEX 大 ~3-5% 但稳。

[v5.0.3.81 — hotfix: Android R8 Ktor proguard + WebView vendor-switch remount] - 2026-05-23 ​

v5.0.3.80 build-android 在 R8 minify 阶段 fail（Ktor IntellijIdeaDebugDetector 引用 java.lang.management.* JVM-only API + slf4j-api 缺 StaticLoggerBinder），导致 v5.0.3.80 GitHub Release 缺 4 个 Android asset。本 hotfix 加 proguard -dontwarn 规则 + bundle 一个真机 bug 修。

  • proguard-rules.pro Ktor 规则 (c42aa603c5)：-dontwarn java.lang.management.** + org.slf4j.impl.** + io.ktor.util.debug.** + -keep class io.ktor.** { *; }。Ktor 是 A3 端侧 LLM HTTP server 在 v5.0.3.80 引入的（ed768ffdf），release-mode R8 minify 才触发。
  • HubLocalScreen.kt WebView remount 修 (13545bd232)：key(pending.adapterName) 包 SocialCookieWebViewScreen，原因 AndroidView.factory 只在第一次 composition 触发，AI vendor 切换（Wenxin → Kimi）时 WebView 卡在前一个 URL，dialog 标题变了 URL 没变 → Wenxin isLoginSuccess 在 stale URL 上误命中。Xiaomi 24115RA8EC 真机复现。
  • feature-local-terminal USR_VERSION 3→4 + cc-cli.tgz -4.7MB：内容变了强制重 extract，否则缓存。
  • package-lock.json 清 stale iconv-lite 条目。

[v5.0.3.80 — PDH v0.2 大爆发 — 11 个 placeholder 卡接通 + WeChat/QQ 真采集 + A3 端侧 LLM 骨架] - 2026-05-22 ​

47 commits since v5.0.3.79。Personal Data Hub 从 Plan A v0.1（1 个 adapter）扩到 v0.2（11 个真接通 + WeChat 4 sub-phase + QQ XOR-IMEI + A3 Android 端侧 LLM 全链路 skeleton）。三道锁（拒云 / 销毁 / 导出）UI + 后端真接通；AI 给出处 citation chip 跳事件详情；release.yml 拆 publish-deps 前置 job 解 desktop build 链。

  • PDH v0.2 — 社交内容 + 购物 + 出行 + AI 助手 + 邮箱 11 平台接通：
    • 社交内容 (A8 v0.2)：微博 (c087c36eb) + 抖音/小红书 (20f9b2188，内容 4/4) + 头条/快手 (e1155b1d7，dual-mode snapshot+sqlite)
    • 购物 (§2.4)：京东/美团 (f3cbd0693，dual-mode) + 拼多多 SAF JSON (78695c25e) + 支付宝 CSV + 淘宝 HTML (799e364f0)
    • 出行 (§2.5)：高德/携程 (0fe532e72，cookie scrape WebView) + 百度/腾讯地图 (3d1cf9481)
    • AI 助手 (§2.6 D10.2)：9 路 WebView cookie scrape + cc sync wire (1e7725552)；8 卡 enable (20e0318b4)
    • 邮箱 (§2.3 D6.2)：QQ/Gmail/163/Outlook 4 家 IMAP via Jakarta Mail 真接通 (7777f5bec)
  • WeChat in-app collector Phase 12.10（4 sub-phase 全 land）：
    • 12.10.1+12.10.2 scaffold (8c52d5963 + 6eb1b4918 + d962b94fe)
    • 12.10.3 WeChatDbExtractor SQLCipher decrypt (8081f8a0d)：sjqz MD5(IMEI+UIN)[:7] 7.x + frida 64-hex 8.x 双 PRAGMA + 3 profile fallback + WAL+SHM cohort
    • 12.10.4 WeChatFridaInjector (37a4e465d)：bundle frida-inject + spawn /data/local/tmp/cc-* + 5-symbol hook
    • 12.10.6 prereq vendor frida 16.5.9 (cdfe1048e)：arm64-v8a + armeabi-v7a → APK ship + scripts/wechat-e2e.py 8-scenario adb harness (c25e48e74)
  • QQ in-app collector Phase 13.5 v0.2 (a07731b46)：XOR-IMEI 算法 byte-identical sjqz qq.py 移植（no SQLCipher / no frida）— 4 Kotlin + 27 unit tests + 13 JS snapshot tests + 6 longtail
  • A3 Android 端侧 LLM 全链路 skeleton：A3.1-A3.4 Ktor LLM server + ModelManager (ed768ffdf) / A3.8 PDH tab 4 "本机提问" (e14fc5106 + f2705a73e) / askQuestion 全链路 (f41f06441) / KotlinLlamaCppEngine 骨架 (8f023052a)
  • 三道锁 UI + 真接通 (0fd45af15 + 1353103d5 + 6bb5eb826)：拒云 / 销毁 / 导出 — cc hub export 真接通；D11 SAF picker 升级到用户选位置 (7e4fa844f)
  • AI 给出处真接通 (3a76ee5e4)：cc hub event-detail + citation chip
  • release.yml 链路修复 (12d1391d1)：split workspace deps publish 前置 job — 解 v5.0.3.79 desktop build chicken-and-egg
  • Bonus 修复：WeChat normalize 排除 @stranger/fake_* (3c8917a3c) + A6a server IO thread bind (6ad123399) + RealtimeEventManagerProfileQueryTest flake (9619e506d) + HubAuditViewModelTest stub (7478d4c30) + Bilibili API headers (f7e11d6a5) + wechat-e2e.py UTF-8 cp936 (e65ec6d83) + debug/release APK auto-detect (08941a5f1) + cc hub wechat doctor (11629ef2a)
  • 测试 sweep 收口（3 stale assertion 修，2026-05-22 同日）：(1) longtail-adapters.test.js DouyinAdapter rejects missing account.uid ↔ §A8 v0.2 把 uid 改成 constructor 可选（snapshot 模式从 payload 取），镜像 XiaohongshuAdapter snapshot mode constructs without account.uid 用例 — commit 6b7a1324d；(2) analysis.test.js TOTALS preamble regex /TOTALS.*authoritative/ 漏 /i flag — system prompt 大写 "AUTHORITATIVE" 不 match — commit a30ab1ed0；(3) hub-command.test.js 硬钉子命令快照漏新增的 event-detail（§A6 citation 出处）+ export（§A8 v0.2 staged snapshot 导出）— commit 90a8af926。3 个 commit 均经验证：156/156 PDH snapshot tests + 101/101 desktop PDH tests + 18/18 web-panel PDH tests + 87/87 CLI hub tests 全绿。剩余 178 PDH JS test 失败为 bsmc NODE_MODULE_VERSION 不匹配（Electron 桌面进程占着 ABI 140 build，Node 22 需要 ABI 127）— 环境问题不是代码 bug，CI 上不复现。
  • Memory 沉淀：android_wechat_collector_phase_12_10.md (8 trap + 5 真机 blocker) + android_qq_collector_phase_13_5.md (10 trap) + pdh_a8_weibo_v0_2_landed.md + wechat_frida_hook_audit_traps.md + pdh_a3_skeleton_landed.md
  • v0.2 → v1.0 残留：WeChat 12.10.6 真机 E2E 需 root 机子 + Magisk-su；QQ HubLocal UI wire 第二批；A3 端侧 LLM Maven deps + JNI + 真机（~5d）

[v5.0.3.77 / .78 — Personal Data Hub Plan A v0.1 真机闭环 + iOS .ipa ship] - 2026-05-22 ​

两个 tag 合并发布：.77 顺手出 iOS .ipa 真机包 + Phase 14.1 step 5 ChatBubble；.78 是 Personal Data Hub Plan A v0.1 Xiaomi 24115RA8EC 真机端到端闭环 + 3 真机硬化修。CLI bump 到 0.162.14，npm @chainlesschain/personal-data-hub@0.2.1，Android versionCode 503078，iOS CFBundleVersion 78。

  • Personal Data Hub Plan A v0.1 真机闭环（commits dc1241744 Plan A + 02cb0cf3f Path C + 1be6135f6 Path Y + 8a6afb72c cc android scaffold + 0bcde34dd 3 真机硬化 + 65aa01954 3 followups + 339d0e64c cc subprocess W^X / reader / timeout / audit key + 478a7e159 ingest timeout 30→120s）：
    • Xiaomi 24115RA8EC 真机端到端：1305 entities（通讯录 / 通话 / 短信 / 位置 / 系统）入本地 SQLCipher vault。
    • Path C — phone-native snapshot writer（Kotlin ContentResolver + PackageManager 直采）+ 桌面 ingest pipeline（WS 推桌面 staging → 既有 adapter snapshot 模式入 vault）。完全绕开 A6 JNI；~0.5d 在 Win 上 ship + 真机闭环。
    • Path Y — desktop 返 RAG context + Android-local LLM 推理。DeepSeek + Doubao + 其它 7 个云 LLM 通过 cc-android-bridge stub + bridge-direct 模式接通。
    • 新 cc android 15 子命令 scaffold + system-data-android bridge-direct 模式。
    • 3 真机硬化修：originalId required（adapter yield 必含字段否则 invalidCount=rawCount 假象 + 1305 行 audit burst）+ skip-embeddings flag（Plan A 模式无需 vector）+ audit pagination 拆 1305 → 50/page。
    • Android cc subprocess：W^X execve via mksh symlink（filesDir 文本脚本被 SELinux 拒）+ reader-thread try/catch(Throwable) 治 EOF race（Process.waitFor 关 FD 时 InterruptedIOException 未捕获）+ ingestSystemDataAndroid 30s → 120s 超时。
    • Bonus 运行时修：bootstrap LLMManager 注册为 getLLMManager() singleton（commit ea293043f）+ web-shell PDH wiring inject CcLLMAdapter 让 web-shell 也尊重 active LLM provider（commit bb008de6f）。
    • PDH 分析正确性修（commits 751ca2a47 + 34532fc5d + 19c11920e）：AnalysisEngine 读 persons + items 不只 events（止住幻觉 contact counts）+ LLM ResponseCache bypass for analysis ask（防 stale cache 答案）+ TOTALS preamble + 扩展 count intent（止 FACTS-length count 漂移）。
    • Memory 沉淀：pdh_plan_a_android_standalone_design.md（6 真机 trap）+ pdh_path_c_snapshot_writer.md + pdh_path_y_transition.md + android_cc_subprocess_execve_via_mksh.md + android_process_reader_thread_eof_race.md + miui_query_all_packages_silently_blocked.md + pdh_adapter_originalid_required.md + compose_lazycolumn_key_burst_collision.md + npm_publish_audit_and_dep_chain.md + android_native_lib_extract_w_x.md。
  • PDH-first publish ordering（commits 4e0ff2544 + 38861059a）：release.yml publish-cli job 现先发 @chainlesschain/personal-data-hub 再发 chainlesschain 避免 dep-chain 404（CLI 0.162.14 require PDH 0.2.1；若 CLI 先发则下游 npm install -g 在 PDH 处 404）。
  • E2EE 7 androidTest 重新激活（commit a09fc53ee）：7 个 @Ignore + TODO() cipher 测试经新 X3DHSimulator state-less E2EESession factories 重新跑起来 — Alice/Bob initiator/responder 不再需要两 PSM 实例。core-e2ee androidTest quarantine 全清。
  • Phase 14.1 step 5 ChatBubble + Phase 14.5 streaming-ask 设计（commits 6f861dcd9 + 3979d553a）：iOS Personal Data Hub chat UI 落地 chat-bubble 模型；Phase 14.5 streaming-ask 设计文档归档。
  • iOS .ipa 真机 ship（commit 71436b9ac v5.0.3.77 tag + b98ce22fc PersonalDataHubViews.swift target membership）：iOS .ipa 7.9MB 进 v5.0.3.77 GitHub Release assets，target-membership 接通后真出包。
  • Android 收尾：c47da1bb6 bump feature-file-browser + feature-project minSdk 到 28（解 NDK linker 不兼容）+ dd7d45155 re-quarantine 2 个 drifted :app androidTest 文件 + 从 E2E matrix 撤下 API 26 + 4c44bfc95 re-quarantine 18 个 TODO()-body stub 测试 + b11354ac5 HubHealthCard.kt 删 return@Column 治 PDH SlotTable 崩 + a4a3727a3 hoist annotations-java5 / webrtc / bouncycastle exclusions 到 root。
  • 版本面：productVersion v5.0.3.75 → v5.0.3.78 / CLI 0.162.13 → 0.162.14 / desktop-app-vue 5.0.3-alpha.75 → .78 / android versionCode 503075 → 503078 / iOS CFBundleVersion 75 → 78 / npm @chainlesschain/personal-data-hub 0.2.0 → 0.2.1。

[v5.0.3.75 / .76 — iOS PIN 闪退两轮 hotfix + Android quarantine 全部 0 收尾 + Plan A 真机闭环 verified] - 2026-05-21 ​

多 fix 合并发布为 v5.0.3.75 与 .76 两 tag（iOS PIN-unlock 闪退诊断推进 CFBundleVersion 73 → 75 → 76）。WeChat Phase 12.6.7-10 bootstrap 编排层也作为 .75 doc-prep sweep 一并发（commit 7ac414535）。

  • iOS PIN-unlock 闪退第二轮诊断（commits 5807c1fbc + 9deb6078d，CFBundleVersion 73 → 75 → 76）：
    • 第一嫌疑收口：DatabaseManager.open(password:) 持 queue.sync 后调 runMigrations → execute(...)，execute 自身又 queue.sync 同一串行队列 = libdispatch 重入。iOS 17+ 某些路径 inline-recurse 蒙混，iOS 16 上稳定走 _dispatch_assert_queue_fail 死锁 — PIN 输完自动提交后 AppState.authenticate 卡死被 watchdog 干掉。修法：拆 _executeUnlocked / _queryUnlocked / _queryOneUnlocked 私有不锁版，runMigrations / getCurrentVersion / runMigration / migration_v1 14 处 execute 全改走 unlocked（它们已在 open() 的 queue.sync 闭包内）。公共 API 行为零变化。
    • .75 装机后仍闪退，第二轮两嫌疑合 ipa：(a) unsafeBitCast(-1, to: sqlite3_destructor_type.self) 内联两处 → 提到文件级 private let SQLITE_TRANSIENT_FN 单点定义 + String bind 改 withCString { ... } 让生命周期对优化器可见。(b) ContentView AuthView → MainTabView 跨 view-tree 大变 + PINEntryView SecureField @FocusState 拆解 + TabView 内 NavigationView/NavigationStack 上场被打进同一 transaction，去 .animation(.easeInOut, value: appState.isAuthenticated) 暂避 iOS 16 host swap 焦点回收 race。
    • 下一步：装机重测；同时催 .ips 定锤帧顶。
  • Android androidTest quarantine 7 → 0 全部收尾（commits 62a179cad + 73bc6b706 + 84f01437e + 60d887690 + 6afedbbf8 + 84fca147c + 03026b79b）：4 文件真接通 API（AuthRepositoryTest / KnowledgeUITest / AI_RAG_IntegrationTest / AIConversationUITest），3 文件 @Ignore + TODO() 占位（E2EEIntegrationTest 7 ciphertests / AIConversationE2ETest 10 / KnowledgeE2ETest 8 = 25 测试方法待跨模块 TestActivity + 共享 helper module + Hilt 运行时 setup 4 prereq 后重启）。
  • HiltTestRunner 3 模块接通（commit 6ee00b763 / cherry-pick 1a71849dd）：core-e2ee / feature-ai / feature-knowledge 三 androidTest source set 加 class HiltTestRunner : AndroidJUnitRunner 把 test 进程 Application 换成 HiltTestApplication，让 @HiltAndroidTest runtime DI 真 bootstrap（之前 compile 绿但 runtime 静默不生效）。Compile-clean verified，真运行需 emulator/device，CI connectedAndroidTest 是 canonical 验。feature-project / feature-p2p / feature-file-browser 同样有 @HiltAndroidTest 但 androidTest source set 还含 LLM-fiction（MainActivity reverse-dep + 缺包 com.chainlesschain.android.test.* + entity 字段幻觉 + 跨模块 DatabaseFixture/NetworkSimulator），跟同样 quarantine sweep 后再接 Hilt。
  • Plan A 真机闭环 verified — traps 16/17 收口（commit bf259899f）：Xiaomi 24115RA8EC 2026-05-20 真机三步 T1/T2/T3 PASS — @chainlesschain/personal-data-hub require / bs3mc native dlopen / SQLCipher LocalVault open schema=2 + queryEvents + destroy。Trap 16：Node 24 libnode 在 Termux libtermux_cxx.so 套装下 dlopen 静默死（与 Phase 2.5 trap 5 同套路 — libc++ 符号子集不全），mitigation PKGS=nodejs 不 nodejs-lts。Trap 17：bs3mc V8 直 API 跨 Node 24→26 HandleScope ctor ABI break，mitigation bs3mc against Node 26.1.0 headers cross-compile。§12 决策结论：工程基础 100% verified，剩 feature 层 ~10-12d (A3 LlamaRn / A6 JNI / A7 cc android + cc hub subcommand)。

[v5.0.3.74 — AIChat registry-contract bug fix + Phase 10.2 集成/E2E + README 历史快照重构] - 2026-05-20 ​

Hub 内部质量收口，无新功能。修了 Phase 10.2 落地以来一直存在的 1 个隐性 bug：AIChatHistoryAdapter sync() 的 yielded raws 不符合 AdapterRegistry 的信封契约 ({originalId, capturedAt, payload})，registry 调 vault.putRawEvent({originalId: undefined, ...}) 直接抛错，所有 AIChat raws 100% 进 invalidCount → 没一条 event 真落库。

  • AIChat registry-contract 修法（3 cascading 根因）：
    • sync() 现 yield {originalId, capturedAt, payload:{kind,vendor,...}} 信封；normalize() 接受信封 + adapter-internal 双形态保后向兼容。
    • schema-map.buildMessageEvent：occurredAt ISO 字符串 → ms 整数；新增 ingestedAt + source.capturedAt (schema validateEvent / validateBaseEntity 要求正整数 ms)。Person + Topic + Item 同步加 ingestedAt + source。
    • 实体 id：newId() → 确定性 evt-aichat-${vendor}-${originalId} / item-aichat-${vendor}-${originalId}-${idx}，re-sync 走 ON CONFLICT(id) DO UPDATE 而不撞 UNIQUE(source_adapter, source_original_id) 二级约束抛错。
  • 新增测试 +2 文件 +9 单测：
    • __tests__/integration/ai-chat-history-registry.test.js 6 个场景 — 完整链路 register → syncAdapter → fixture HTTP → raw_events 归档 → normalize → partition → vault put → watermark 推进 → 审计日志 + 幂等 re-sync + 部分 vendor 失败 + 零会话 no-op + audit.sync.ok 落库。
    • __tests__/e2e/ai-chat-cross-source-journey.test.js 3 个场景 — TimelineSkill 编织 DeepSeek + Kimi 事件按时序 / RelationsSkill 聚合 AI-agent 互动 / cookie-expired sentinel 不中断 journey。
  • Hub 测试基线：47/927 → 50/952 全绿，~38s on dev box。
  • README 横幅重构：README.md:2305 / README_EN.md:2040 卡在 v5.0.3.48 的 25 版本旧"⭐ 当前版本"横幅改成"⭐ 历史快照"+ 3 行指针指向文件顶部真的当前状态；8 个 badge SVGs 刷到 v5.0.3.73 / CLI 0.162.9。横幅正文保留作历史归档（下方 Latest Update 系列本就是按时间倒序的 release notes）。
  • docs-site PDH 页：测试基线行 47/927 → 50/952 + "Phase 10.2 集成 + E2E 9 新测 + AIChat registry-contract bug fix" 明记，已部署到 docs.chainlesschain.com。
  • 版本面：productVersion v5.0.3.73→v5.0.3.74 / desktop-app-vue 5.0.3-alpha.73→.74 / android versionCode 503073→503074 / iOS CFBundleVersion 73→74 / CLI 0.162.10→0.162.11（避免 publish-cli 因同版本退出）。

[v5.0.3.73 — PDH 收口 test sweep（集成 + E2E + 2 真 bug + 4 站 docs 刷新）] - 2026-05-20 ​

Personal Data Hub 13-phase burst 落地后的质量与文档收口，2 commits（cbfab26e1 测试+bug / 69de3ffc4 docs），无新功能。47 test files / 927 tests 全绿。

  • 集成测试新增：__tests__/integration/cross-adapter-pipelines.test.js 6 个场景 — Email + Alipay 同邮箱归一 → RelationsSkill 联合视图 / SpendingSkill 跨 Alipay+Shopping+Travel 聚合 / TimelineSkill 编织 WeChat + Alipay 时序 / 手工 merge 解锁联合视图 / 跨 Adapter 共享 entityResolver 实例 / FixtureAdapter helper 隔离真 IMAP 与 ZIP 依赖。
  • E2E 测试新增：__tests__/e2e/full-user-journey.test.js 3 个场景 — 完整用户旅程从空 vault 到 "我花了多少？" 自然语言回答 / 幂等 re-sync 同 CSV 0 重复事件 / vault stats 反映 post-sync entity counts。
  • 顺手扫出并修 2 个真 bug：
    • lib/analysis-skills/spending.js subtypes 白名单漏 "order"，Phase 7 Shopping 全部订单事件不进消费报表 —— 由集成测试发现。
    • lib/adapters/alipay-bill/alipay-bill-adapter.js normalize 时漏导出 event.extra.counterparty —— 由 E2E 测试 breakdown[0].key 期望"张三"但实际拿到商品名 "生日礼物" 发现。补 counterparty: row.counterparty || undefined。
  • 修 flaky 单测：__tests__/registry.test.js 并发 sync 测试 MockAdapter count: 5000 → 500 + 30s 超时，本机 / CI 都稳。
  • 文档 4 站全刷：
    • README.md / README_EN.md：质量面 38/792 → 47/927。
    • docs-site/docs/chainlesschain/personal-data-hub.md：版本头从 "16 个 Adapter" 升 "19 个 Adapter（含 8 AIChat 厂商）"，加 Mobile Extraction Layer + EntityResolver + 5 Analysis Skill 名字。
    • docs-website-v2/src/pages/index.astro + en/index.astro：底部脚注从 "38 test files / 792 tests" 升 "47 test files / 927 tests · 6 集成 + 3 E2E 场景"。
    • 设计站 docs-site/scripts/sync-design-docs.js + docs-site-design/scripts/sync-docs.js：已含 Personal_Data_Hub_Python_Sidecar.md + Personal_Data_Hub_sjqz_Comparison.md 映射，跑 sync 同步 190 文件。
  • Release infra：CLI 0.162.8 → 0.162.9 跟随 desktop bump，避免 publish-cli 步因 npm dist-tag 已发同版本退出。

bump 内容（.72 → .73）：productVersion v5.0.3.72 → v5.0.3.73 / desktop-app-vue 5.0.3-alpha.72 → 5.0.3-alpha.73 / Android versionCode 503072 → 503073 + versionName 5.0.3.72 → 5.0.3.73 / iOS CFBundleVersion 72 → 73 / CLI npm 0.162.8 → 0.162.9。

[v5.0.3.72 — iOS keychain hotfix repackage（after .71 build infra failure）] - 2026-05-20 ​

v5.0.3.71 release pipeline 所有 desktop build job 全 EUSAGE：root package-lock.json 与 packages/personal-data-hub/package.json 不同步 —— hub 在 Phase 12/13 滚动期间加了 adm-zip + iconv-lite 两 optional dep（前者解 iTunes backup zip / 后者解 GBK 编码 social 历史），workspace 各自 package.json 已声明但 root package-lock.json 没 sync 进去。5d8ba08b5 fix(deps) sync root lock 后，.72 repackage 同一 iOS keychain fix（625e86819）成功出包。d03c87d0a 后续把 packages/cli 在 root lock 里也 bump 到 0.162.7 收口。

bump 内容（.71 → .72）

  • 修 root package-lock.json 缺 adm-zip@^0.5.16 + iconv-lite@^0.6.3（hub Phase 12 WechatAdapter / Phase 13.x social adapter 用）
  • packages/cli root lock 同步到 0.162.7
  • 同一份 iOS keychain Logger.swift NSLock 防并发崩溃修（与 .70 同一 commit 625e86819 forward）
  • 18 assets 完整：4 Android（arm64/v7a/universal/aab）+ macOS dmg + Linux AppImage/rpm/deb + Windows Setup/Portable + iOS .ipa + 3 latest.yml + blockmaps

版本面同步：CLI 0.162.6 → 0.162.8（.71 已发的 0.162.7 + .72 catch-up 0.162.8）· productVersion v5.0.3.70 → v5.0.3.72（中跳 .71，因 .71 release 失败）· desktop-app-vue 5.0.3-alpha.70 → .72 · iOS CFBundleVersion 70 → 72 · Android versionCode 503070 → 503072, versionName 5.0.3.70 → 5.0.3.72。

[v5.0.3.71 — Personal Data Hub Phase 4.5–13.7 一晚 13-phase burst（15 commits）] - 2026-05-20 ​

Personal Data Hub 从 Phase 4 真接通真三方一直推到 Phase 13.7 七 social adapter 全部落地。一晚 15 commits 763047a22 → b2baf4eda。38 test files / 792 tests / 9/9 AIChat 真厂商接通。本 release 出包失败（root package-lock 不同步致 desktop EUSAGE），同一份变更走 .72 repackage 真出包，但本条目记录 phase 落地节奏。

新增 phase（按 lib/adapters 落地序）

  • Phase 4.5 — Python sidecar bridge + SystemDataAdapter（commit 68b2fac14）：JS↔Python 进程间 JSON-RPC 桥接，接 4 个 Android system data source（通讯录 / 通话记录 / 短信 / 位置）借 sjqz 项目 17 个真已写 parser，避免 17 parser 重写。Per memory personal_data_hub_python_sidecar.md 的 v0.3 Architecture 决策落地。
  • Phase 7 — Shopping three-pack（commit 6ba5c9480）：Taobao + JD + Meituan 三大电商 adapter，订单 / 物流 / 评论解析入 hub vault。
  • Phase 7.5 — Mobile Extraction Layer（commit d210713c8）：双路提取 — Android 走 ADB backup (adb backup -all)，iOS 走 iTunes encrypted backup（用 adm-zip 解包 + iconv-lite GBK→UTF-8）。
  • Phase 9 — Travel four-pack（commit 3a140484a）：高德 / 百度地图 / 携程 / 12306 四旅行平台 adapter（LBS 足迹 + 行程订单合一）。
  • Phase 10.1 — AIChat skeleton（commit ad301c5bc）：9-vendor 抽象框架 + HttpClient infra 准备。
  • Phase 10.2 — AIChat 9/9 vendors 全部 live（commits 1d31108bb + 42fe7f5dd + b2baf4eda）：DeepSeek + Kimi h5 私有 API（无官方 OpenAPI，逆 h5 web 接口）+ 通义千问 + 智谱清言 GLM + 腾讯混元 + 百度千帆 + 字节扣子 + Dreamina + 豆包，9/9 真厂商接通。HttpClient infra 接 retry-with-backoff + progress streaming。
  • Phase 11 — 5 内置 analysis skill（commit 763047a22）：跨 hub 数据源的 5 个分析技能（消费趋势 / 出行画像 / 沟通频率 / 内容偏好 / 时间分布等），LLM 直接调。
  • Phase 12 v0.5 — WechatAdapter frida-independent slice（commit 65de030dc）：v0.5 切出 frida-independent slice（不依赖动态注入），T3 风险从"高"降到"中"。完整 SQLCipher dump 仍走 v1.0 frida 路径。
  • Phase 13.3-13.7 — 5 social adapter（commits 12b06c4d5 + 18c62c9d6）：Douyin + Xiaohongshu + QQ + Telegram + WhatsApp 五平台。WhatsApp 完成 sjqz parser port（13.7 是 sjqz parser 移植 last mile）。
  • Phase 13+ Bilibili + Weibo（commit ade1bc025）：借 sjqz parser 接两站。

质量面：38 test files / 792 tests 全绿。personal_data_hub_phase_status.md memory 同步刷新（docs page 历史 lag 5+ phase 常态，改前必 git log 查 lib/adapters 真实进度）。

release pipeline 失败 → .72 救场：本 release 11 desktop build job 全 EUSAGE（npm pipeline error）— root package-lock.json 在 Phase 12/13 滚动期间未 sync 进 hub 加的 adm-zip + iconv-lite optional dep。5d8ba08b5 fix(deps) sync lock 后跳过 .71 直接 ship .72 repackage 真出包。所以 .71 GitHub Release 不存在，本条目记录 phase 落地节奏（代码在 main 上 + npm 0.162.7 已发，仅 desktop installer 缺）。

[v5.0.3.70 — iOS hotfix 三件套（PIN-unlock crash + AppIcon 真编进包）] - 2026-05-20 ​

三个 iOS 真 bug 一次扫净 + bundle .69 forward。.69 release 因 publish-cli npm 404 卡 draft；.70 重打了 .69 的所有变更 + AppIcon wiring 修复，重跑 publish-cli 成功 PATCH 发布（最终 18 assets 全齐，Latest）。

修复（相对 .67 baseline）

  • iOS PIN 解锁闪退（iOS 16 EXC_BAD_ACCESS） — CoreCommon/Utilities/Logger.swift 的 metadata 字典在多线程下并发改写，iOS 16 上必崩。改用 NSLock 保护 read/write 路径，单测覆盖并发 fan-out 不再 race
  • AuthViewModel.createPrimaryDID SQL 参数绑定 — 之前用了 DatabaseManager.execute(_:) 不带 parameters 的重载，SQL 参数没真绑进 prepared statement → 插入失败/silent skip；改走 execute(_:parameters:) 重载
  • AppIcon 从未真正编进包 — Assets.xcassets 在 pbxproj 里被声明为 PBXGroup（逻辑文件夹）而不是 PBXFileReference type=folder.assetcatalog，且没加进 PBXResourcesBuildPhase。结果 18 张 AppIcon + 3 张 LaunchIcon 全套素材在仓里却从未被 actool 调用编译，主屏一直显示 wireframe 地球占位。2441b0d8b 修 pbxproj wiring；.70 真正出 Assets.car 进 ChainlessChain.app

版本面同步

  • productVersion v5.0.3.69 → v5.0.3.70
  • packages/cli 0.162.4 → 0.162.5（npm publish 成功后 Latest）
  • desktop-app-vue 5.0.3-alpha.69 → .70
  • iOS CFBundleVersion 69 → 70
  • Android versionCode 503069 → 503070, versionName 5.0.3.69 → .70

Release pipeline 操作记录

  • .69 因 publish-cli npm 404（chainlesschain@0.162.4 PUT 拒）→ finalize-release job skipped → release stuck draft 8h+，触发把 .69 全部变更 bundle 进 .70 再发的决策
  • .70 首次跑同样在 publish-cli 步 404；gh run rerun --failed 重试一次成功 PATCH，draft → published
  • 18 assets 完整：4 Android（arm64/v7a/universal/aab）+ macOS dmg + Linux AppImage/rpm/deb + Windows Setup.exe/Portable + iOS .ipa + 3 latest.yml + blockmaps

[v5.0.3.68 — CLI npm 0.162.3 catch-up（Phase 5.1-5.6 hub + cc ui fixes）] - 2026-05-20 ​

v5.0.3.67 desktop release 全 11 jobs 绿，但 publish-cli 检查发现 chainlesschain@0.162.2 已在 npm registry 上 → 跳过 publish。结果：用户 npm i -g chainlesschain 拿到的 CLI 仍是 0.162.2，没包含 Phase 5.1-5.6 hub work 也没包含 3 个 cc ui 修复。v5.0.3.68 是个补丁 release，专门把 npm CLI bump 到 0.162.3。

bump 内容（CLI 0.162.2 → 0.162.3）

  • Phase 5.1 EmailAdapter (IMAP) — bundles @chainlesschain/personal-data-hub workspace 含完整 IMAP 适配器
  • Phase 5.2 email body parsing + attachment metadata
  • Phase 5.3 Email classifier (Layer 1 规则 + Layer 2 LLM)
  • Phase 5.4 6 个 email template field extractors（bill/order/travel/government/register/other）
  • Phase 5.5 PDF decryption + transactions extraction
  • Phase 5.6 email config wizard + sync status + event detail
  • Phase 4 (UI) cross-shell PersonalDataHub view（desktop V6 + cc ui）
  • cc ui LAN urls + token in startup banner（bound 0.0.0.0）
  • cc ui force-exit timer must not unref（防卡死）
  • cc ui SIGINT 2s graceful timeout（Ctrl-C 不再 hang）

Release pipeline 收口（无中间 bug 这次）

  • 5 builds（win/mac/linux/ios/android）一次全绿
  • 16 cli-tests shards（4 e2e + 8 integration + 4 unit）全绿
  • create-release / publish-cli-precheck / publish-cli / update-changelog / finalize-release 全绿
  • 26 / 26 jobs green — 与 v5.0.3.67 同一发版流程，但这次 publish-cli 真 push 到 npm（chainlesschain@0.162.3）

版本号同步：CLI 0.162.2→0.162.3 · productVersion v5.0.3.67→v5.0.3.68 · desktop-app-vue 5.0.3-alpha.67→.68 · iOS CFBundleVersion 67→68 · Android versionCode 503067→503068, versionName 5.0.3.67→5.0.3.68 · 根 package-lock packages/cli 0.162.2→0.162.3。

经验：以后每个 desktop release 都要顺手 bump CLI（如果 hub / cli / shared workspace 有任何改动）。release.yml 的 publish-cli-precheck 默认 skip 已 published 版本，是安全网而不是触发器。

[v5.0.3.67 — Android Phase 5.6/5.8 cc-exec 自然语言 Chat] - 2026-05-19 ​

第一次让 LLM 直接在 Android 端调本机 cc CLI 跑只读查询。用户用大白话问"列下我最近的笔记 / 搜下 RAG 相关的"，模型识别 → 发 cc_exec 工具调用 → app 内白名单 → mksh + node 跑 cc → 卡片把命令 + 输出回贴到聊天。

新增功能

  • Phase 5.6 LLM tool-use 协议接通：OpenAI（tool_calls + type:function 信封）、Doubao（豆包，wire-compat 直 delegate）、Claude/Anthropic（tool_use 内容块 + tool_result 走 role=user）三家都正式接 tool-use；不支持的厂商（Qwen / Ernie / Spark 等）自动走"防幻觉 fallback"，明确告知用户切模型而不是编笔记
  • Phase 5.7 cc Chat 屏：底部"个人中心 → cc Chat (自然语言)"入口；五状态进度条 (思考中 / 准备调用工具 / 执行 cc / 处理结果 / 整理)；工具卡片显示 cc 命令 + exitCode + 耗时 + stdout 折叠展开 + 取消按钮
  • 8 个只读子命令上限：note list/show/view、search、memory list/show、skill list、status、session list、mcp list、did show —— 写 / 删 / 安装类 LLM 即便编也会被白名单拒绝（exitCode=126），无 shell 拼接风险（ProcessBuilder 绕过 shell）

修复（本次审计 + 测试发现）

  • Blocker B28：CcExecService.executeArgv 改用 coroutineScope + 双 async 异步排空 stdout/stderr，避免 JVM pipe buffer 满（典型 4–64KB）→ 子进程 write() 阻塞 → 父 waitFor() 死锁。cc search 类大输出场景前一版有概率 hang 到 timeout
  • High B26：CcChatOrchestrator.runFallback 不再 silently 丢弃 StreamChunk.error，HTTP 401 / 网络错都会显式弹 Failed event
  • High B17：CcAllowlist.check 现在显式拒绝"有 allowedSubcommands 但用户没传子命令"的情况（例如 cc note），错误消息列出合法子命令

测试覆盖（127 新测试，全绿）

  • feature-ai：CcAllowlistTest (38) + CcExecServiceTest (19) + CcToolCallDispatcherTest (17) + CcChatOrchestratorTest (14) — 共 89 单测
  • :app：CcChatViewModelTest (19) + CcChatIntegrationTest (9) — 端到端覆盖 E1 happy path / E5 deny / E6 fallback / E7 cancel / E9 dedup
  • B28 验证用 /bin/sh -c "yes hello | head -c 200000" 200KB 输出 + 排空路径，Linux/macOS CI 真跑，Windows 测试跳过

真机 E2E 状态：9 场景 E1-E9 Checklist + 完整 SOP 已 land 设计文档；自动化 preflight 脚本在 android-app/scripts/e2e/phase_5_8_preflight.ps1（接 Xiaomi 24115RA8EC 真机后一键检查 cc bundle / APK 装好 / 残留扫描）

详见设计文档：

[iOS Phase 6 sprint] - 2026-05-18 — Knowledge 30 + AI Extended 25 全 hybrid + 15 main tab + 多模态 v0.3 + Agent streaming（19 commits, 绿基线 1fb947b32） ​

一晚 19 commits 收口 iOS Phase 6.3/6.4 全套 hybrid（OQ-3.2=C / OQ-3.3=C）。桌面 +55 method + iOS 56 wrap + 2 新 SwiftUI tab + 5 sub-tab + 多模态实时录音 + Agent 流式输出。iOS CI 真编 2 轮抓 2 bug 已修；绿基线 1fb947b32（Build & Test SPM + Build Release SPM 三 job 全绿）。

Phase 6.3 — Knowledge 30 method：桌面 knowledge-handler.js 39 method（老 9 + step 1+2+3 = 30）；iOS KnowledgeCommands actor 31 wrap method（30 + getNote alias）；新 SQLite 表 knowledge_folders + knowledge_note_versions + ALTER notes 加 starred/pinned/last_viewed_at/archived。92 cumulative tests。

Phase 6.4 — AI Extended 25 method：桌面 ai-handler.js 37 method（老 5 + Phase 5 fix 7 + Phase 6.4 25）；iOS AIExtendedCommands actor 25 wrap method + 与 AIChat (Phase 5 12) 并列共 37 method。新表 ai_prompt_templates。RAG/Multimodal/Agents 用 defensive 双路径方法检测 + 优雅降级。101 cumulative ai tests。

iOS UI — 15 main tab + 5 sub-tab：

  • KnowledgeView（4 filter segmented + 搜索 + 新建 sheet + swipe action）
  • AIExtendedView 5 sub-tab：Templates CRUD / Code（解释/生成/重构 3 mode）/ RAG / Multimodal / Agents
  • 5 sub-tab 触 HIG 软上限 → picker 切 horizontal scroll + capsule highlight（与 Phase 4.5 NotificationsView 同模式）
  • RemoteOperateView 13 → 15 tab

v0.2 / v0.3 增量功能：

  • Multimodal v0.2：PhotosUI PhotosPicker OCR / 文本生图 AsyncImage / TTS AVAudioPlayer 播放 / .fileImporter 音频转文字
  • Multimodal v0.3：MultimodalAudioRecorder.swift (@MainActor + AVAudioSession + 16kHz mono AAC) + UI 闪烁红点 + 时长 monospaced + 停止/取消
  • Agents v0.2：list/detail/run/stop + 4 色 status chip
  • Agents v0.3：runAgentStream 桌面 (复用 activeStreams Map 与 chat stream 共用) + iOS 3 wrap + VM 后台 250ms poll loop + 实时累积 UI 渲染

iOS CI 真编验证（commits fa0746860 + 1fb947b32）：

  • 真 bug #1：RemoteAIExtendedViewModel.swift:425 nextChunkIdx: Int? → Int 类型不匹配 → ?? sinceChunk
  • 真 bug #2：StreamChunkResponse 模型缺 error 字段 → 加 (backward-compat)
  • Win 无 Swift，iOS CI 是 1500+ LOC Swift 唯一编译验证路径
  • 绿基线 1fb947b32（3 job 全绿）

设计文档（4 个新 doc）：

  • iOS_对标_Android_Phase_6_Plan.md §11 加 19 commits 时序表 + 实际 vs 计划偏差 + 5 个新模式
  • iOS_Phase_6_3_6_4_Knowledge_AI_Desktop_Debt.md — debt 审计
  • iOS_Phase_6_6_Desktop_Skill.md + iOS_Phase_6_7_Extension_Skill.md — Coverage Trap T2/T4 误判修正
  • iOS_Phase_6_0_RealDevice_E2E_Plan.md v1.0 — 38 场景跨 7 段 reproducer + bug 模板 + 通过/失败 P0/P1/P2 分级

剩余真机 E2E（plan §11.4 唯一未闭环）：Mac + iPhone + 桌面跑 38 场景。Win dev box 不可推进，等用户。

[Sub-phase 5-6 v2 + 10 v2] - 2026-05-18 — Android LOCAL 项目终端 picker + 全量项目内容拉取（commit 09bd0ec0f） ​

承接 3319febc4 Sub-phase 5-6 fix 真机反馈："弹补填对话框但找不到同名 PC 项目"+"项目文件同步没做"两条阻塞，两件事一起收口。

Issue 1: LOCAL 项目终端入口改为 PC 项目 picker

  • 旧 v1：手输 Windows 路径 dialog（仅自动预填同名项目）；同名不命中 → 移动端键盘敲长路径，UX 失败
  • 新 v2：dialog 打开调 project.list 拉所有桌面项目 → LazyColumn picker → tap row → 直接保存 pcRootPath + 跳终端
    • 同名匹配项目仍保留高亮 "同名" 标在 picker 顶部
    • 列表为空（桌面项目都没 rootPath）→ 自动展开 "自定义路径" 折叠区 + error hint
    • 自定义路径输入作 fallback，保留 v1 流程

Issue 2: PC→Android 全量项目内容拉取

  • 旧 v1（504bd6dde Sub-phase 7）：pullSingle 只拉 metadata + 文件清单，文件内容 "由 caller 跳 FileTransferScreen 拉" — 实际从未接通
  • 新 v2：pullSingle 之后循环调 project.getFile(fileId) 真把每个文件 content 存 Room project_files
    • 单文件 getFile 失败 → continue + log warn（不阻塞整体）
    • content > 1MB → skip 写占位 row（size + hash 保留，content=null）防 OOM
    • PullProgress StateFlow 暴露进度 → UI 显 LinearProgressIndicator + 下载文件 N/M: <path>
    • 完成后 metadata.pullState 升 "files_downloaded"

测试覆盖：78 新单元 + 集成测试全绿

  • RemoteContextViewModelTest.kt × 16（listPcProjects / findPcProjectPathByName / pushPcRootPathToDesktop）
  • RemoteProjectBrowserViewModelTest.kt × 7（pullProject happy / 失败 continue / exception continue / >1MB skip / 空 files / lifecycle / 并发 ignore）
  • mobile-bridge-sync.test.js × 15（含 6 新 handleProjectUpdatePath）
  • project-management-handler.test.js × 33（含 9 新 createFile/createFolder/writeFile/deleteFile + getFile Android Room 契约）
  • project-handlers.test.js × 7（10 topic dispatch + pre-bootstrap）
  • 修了 3 个 stale 测试断言（504bd6dde 改 userId 过滤后没同步更新）

剩余真机 E2E §12.3 8 场景：picker 命中 / 自定义路径 fallback / FROM_PC 不弹 dialog / 拉取 10 文件 progress 跑完 / >1MB skip / 单文件失败 continue 等。需 Mac/Win PC + Android 双机配对环境。

详见 设计文档 §12。

[v5.0.3.64] - 2026-05-18 — iOS 版本号 4 段制 + AppConstants stale 硬编码清零 + 全套测试覆盖 ​

v5.0.3.63 release 后用户反馈:(1) iOS Settings 「版本」只显示 3 段制 5.0.3 或 stale 0.32.0（实际几个月没更过硬编码常量）;(2) PIN 闪退问题仍报告(待 crash log)。本版做三件事:A 修 AppConstants.App.version / buildNumber / bundleId 三个 stale 硬编码改为从 Bundle.main 动态读;B 加 iOS 17 API 二次审计(全仓 596 个 .swift × 29 个 pattern 扫描,0 处新增违规);C 加单元测试 + 集成测试 + UITest 三层覆盖。

已完成:

  • 修 stale 硬编码 — AppConstants.App.version (0.32.0 → Bundle.appShortVersion) / buildNumber (32 → Bundle.appBuildNumber) / bundleId (com.chainlesschain.ios → Bundle.main.bundleIdentifier)
  • 修 AIDashboardView.swift:95 硬编码 v0.16.0 + PluginManager.swift:118 硬编码 fallback 1.7.0
  • 加 Bundle extension (Modules/CoreCommon):appShortVersion / appBuildNumber / appFullVersion(4 段制 5.0.3.64) / appFullVersionTag(v5.0.3.64) / appDisplayName
  • SettingsView 关于栏:显示 v5.0.3.64(a11y id = settings.app.version), 加「Bundle ID」一栏让用户能确认装的是真版本
  • SystemTools.appInfo 加 fullVersion 字段(技能侧获 4 段制版本号)
  • 11 BundleVersionTests + 7 AppStateNotificationTests + 2 XCUITest(testSettingsVersionDisplaysFourSegmentTag / testPINUnlockDoesNotCrashOnFirstLaunch) 三层覆盖
  • 全仓 596 个 .swift 二次审计 29 个 iOS 17-only API pattern, 0 新增违规, AppState.swift v5.0.3.63 修已就位
  • AppIcon 18 + LaunchIcon 3 张资产复审:全 RGB 无 alpha 通道, App Store 合规
  • 5 version surface 全 sync (productVersion / desktop alpha / ios short+build / android name+code)

待用户反馈:v5.0.3.63 PIN 闪退根因未在代码层复现, 装 v5.0.3.64 仍崩请附 crash log (Xcode → Devices and Simulators → View Device Logs)。Settings 新「Bundle ID」字段可帮确认安装版本。

[Unreleased] — iOS Phase 5 AI Chat 收口（4 真实 bug + 4 集成测试） ​

Phase 5.1-5.6 已随前期 commit 落地；Phase 5.7 收口走静态审计路径找出并修 4 真实 bug，每条 1 个回归单测。同时补 4 个集成测试覆盖 events fan-out / cancel 顺序 / offline drain / 多对话 stream 隔离的端到端链路。

Bug 修复：

  • RemoteAIChatViewModel.finalizeStreamingPlaceholder 空字符串 messageId 击穿 SwiftUI ForEach 身份 — 改用显式 isEmpty guard 而非 nil-coalesce。
  • RemoteAIChatViewModel.deleteConversation 失败时半回滚 — 仅恢复 conversations 列表，currentConversation/messages 留空。新增 rollbackDelete 私有方法，全量原子回滚。
  • RemoteAIChatViewModel.sendMessage 缺 stream-in-flight 防御 — UI 隐藏 send button 但 VM 不能假设，加 guard currentStreamId == nil。
  • RemoteAIChatViewModel.selectConversation 保留 stale currentStreamId — 切对话后 prev stream 的 delta 在 edge case 下污染新 conv 末条。改为显式清。

测试覆盖：

  • 单测从 41 → 45（每个 bug 1 条回归单测）；总 iOS 单测 ~358。
  • 新集成测试 Phase5AIChatIntegrationTests.swift（4 条）：真 fan-out 端到端 / cancel 顺序保证 / offline drain / 多对话 stream 隔离。
  • 集成测试从 6 → 10。

真机 E2E（Phase 5.8） 仍待 Mac+iPhone+真桌面在场，design iOS_Phase_5_AI_Chat_Skill.md §8.4 已就绪 8 场景 reproducer 详步骤。

[v5.0.3.63] - 2026-05-17 — iOS 16 PIN 闪退修复 + AppIcon 全幅 + Sub-phase 5-6 移动远程终端体验 ​

v5.0.3.62 部署 iOS 16 后真机暴露两类问题：(1) iOS 16 上 PIN 设置 / 解锁均闪退，根因 AppState.swift 用了 iOS 17 only MainActor.assumeIsolated；(2) AppIcon 缩成小图四周大片白边。同时 Android 端 Sub-phase 5-6 LOCAL 项目首次远程终端体验：放宽 v2 fallback gate + 弹框补填 PC 端工作目录避免 PtyManager 落 Electron cwd。

已完成：

  • iOS PIN 闪退（iOS 16）— AppState.swift MainActor.assumeIsolated → Task { @MainActor in ... }；518 个 .swift 复审 0 处其它裸调 iOS 17 API
  • iOS AppIcon — desktop-app-vue/assets/icon.png（1282×1282 全幅）sharp 重生成 18 张 AppIcon + 3 张 LaunchIcon，扁平化白底
  • Android Sub-phase 5-6 LOCAL 项目终端入口 — RemoteContextViewModel.kt（新）：pairedDesktops StateFlow 兜替 sourcePeerId 判 Terminal icon 可见 / findPcProjectPathByName() 自动预填同名项目路径 / pushPcRootPathToDesktop() 双向同步
  • ProjectDetailScreenV2.kt v2 fallback + AlertDialog lookup 进度条 + 预填
  • mobile-bridge-sync.js 新 project.updatePath topic 兼容 root_path 旧 row
  • 5 个 version surface 全 sync 验证通过
  • iOS 16 真机 PIN 首次设置 + 重新登录解锁两条路径通过
  • Android Xiaomi 24115RA8EC：LOCAL 项目首次点终端 → 弹框预填 → 写回桌面 pc_root_path → PtyManager 落正确工作目录

[v5.0.3.62] - 2026-05-17 — iOS deployment target 降到 iOS 16 ​

v5.0.3.61 .ipa 出包后审计发现 iOS 17 baseline 偏高；app 实际只用 1 处 iOS 17-only API（SystemInfoView 的 .symbolEffect pulse 动画）。降到 iOS 16 后覆盖 2017 年以来所有 iPhone 机型（iPhone 8+），可测试 / 试用人群约扩大 30%。

已完成：

  • ChainlessChain.xcodeproj Debug + Release config IPHONEOS_DEPLOYMENT_TARGET = 16.0
  • Package.swift platforms .iOS(.v16)，SPM 模块跟随
  • SystemInfoView pulse 动画 if #available(iOS 17, *) 包装，iOS 16 fallback 为静态图标
  • 5 个 version surface (productVersion / desktop / ios.short / ios.build / android.name/code) 全 sync 验证通过

审计结果：app 无 @Observable macro / ContentUnavailableView / 显式 @available(iOS 17, *) 标注，迁移成本极低。

[v5.0.3.61] - 2026-05-17 — iOS CI 真签名 .ipa 出包 ​

v5.0.3.56 揭示 iOS app target 412 编译错后，build-ios 临时回退 SPM-only 不产 .ipa。app target 0 错 (a8dc88b13) 后，本版本恢复 xcodebuild archive + ExportArchive 路径，配 团队 Apple 账号 ad-hoc 证书，每次发版自动产签名 .ipa（7.4MB）随 GitHub Release。

已完成：

  • 配 4 个 GitHub Secret (IOS_CERTIFICATE_BASE64 / IOS_CERTIFICATE_PASSWORD / IOS_PROVISIONING_PROFILE_BASE64 / IOS_TEAM_ID)，团队的 iPhone Distribution 证书 + adhoc ad-hoc profile
  • release.yml build-ios 从 SPM-only 回到 xcodebuild archive 路径（revert faa8e267f）
  • 4 iter 修通签名链路：(1) 加 PROVISIONING_PROFILE_SPECIFIER 暴露需求 → (2) 删 xcpretty 让 raw 错误显形 → (3) 看到 SPM target 全局污染真因 → (4) 把 signing setting 从 CLI 搬到 ChainlessChain.xcodeproj per-target，CLI 只留 DEVELOPMENT_TEAM
  • ExportOptions.plist 加 signingStyle=manual + provisioningProfiles map
  • 加 Upload xcodebuild logs (diagnostics, always) step 让失败可秒拉 raw 日志
  • Android 跨模块 runtime 35 fail 一晚收口（与 iOS 工作并行）

已验证：测试 run 25987829449 产 ChainlessChain.ipa 7,720,753 bytes，embedded.mobileprovision 匹配 adhoc profile，挂载 GitHub Release 同 17 个 desktop / Android asset 一起。整 release.yml 11 job 全绿。

已知限制：

  • .ipa 仅可装 已登记的测试 iPhone (UDID b9a7376832...)。加新设备需 Apple Developer Portal 加 UDID + 重签 profile + 更新 secret
  • App Store distribution 不在本版本范围（需要 App Store method profile）

[v5.0.3.57] - 2026-05-17 — Android FileTransferScreen 本机下载浏览面板 ​

Plan C Android↔PC 文件传输 (3463e059a) 落地后的 UX 补强：Android 端新增「本机下载文件夹」面板，用户可以直接在 app 内浏览公共 Downloads 目录里下载到的文件，点击调系统应用打开，免去跳 Files app 翻找。

已完成：

  • FileTransferScreen TopBar 增加 PhoneAndroid 图标按钮，切换显示 LocalDownloadsPanel
  • queryLocalDownloads() 通过 MediaStore.Downloads.EXTERNAL_CONTENT_URI 查询（API 29+ 公共 Downloads 目录），按 DATE_ADDED DESC 排序，每行展示文件名 / 大小 / 时间 + 「打开」按钮
  • 面板内置刷新 / 关闭 / loading 态 / 空态提示，最大高度 360dp + LazyColumn

背景：Plan C 落地后用户反馈，下载完文件只看到 Toast「已保存到 Downloads」，但不知道具体哪里、也无法直接打开。这次面板就在 FileTransferScreen 内集成，UX 闭环。

[v5.0.3.56] - 2026-05-16 — iOS CI 真编译收口 (Phase 1-5 SPM 绿) + release.yml 防 mask ​

2026-05-15/16 一晚 20 iter 推进 iOS GitHub Actions 真编译。Phase 1-5 时代所有 iOS CI 显示 success 实际从未真编译——双层 mask 让失败假绿。本次收口让 Phase 1-5 SPM 模块（CoreP2P 起 263 unit tests 基底）真编绿，揭示 app target 412 个老代码 compile error。

已完成：

  • .github/workflows/ios-build.yml 全 mask 拔除 + native swift build --target CoreP2P 路径稳定，Phase 1-5 真编验证（run 25923999179）
  • .xcodeproj 程序化接 SPM wiring（ios-app/scripts/wire_spm_packages.rb + manual-dispatch workflow ios-wire-spm.yml）
  • 补缺失类型（DIDIdentity / Ed25519 / Ed25519KeyPair / Base58 / Data.bytes ext / SecKey force-cast）
  • 修 Phase 1-5 真 Swift 编译 bug（covariant Self / pcPeerId unwrap / data redeclaration）
  • .gitignore models/ → /models/ anchor，解屏蔽 7 个 iOS Swift 文件
  • release.yml build-ios 删 stale create_xcode_project.rb、删全 mask、临时 SPM-only 路径不阻塞 release

已知限制：iOS app target 412 编译错（pre-Phase-1-5 老 scaffold），本版本暂不产 .ipa/.app 安装包。修复路径详见 memory ios_app_target_compile_state.md，4 级工作量评估（极轻 30min → 极重 1-2 周）。

[v5.0.3.55] - 2026-05-15 — Android GA 后续 #21 P1 主体 5/5 + iOS Phase 1+2+3+4 完整移植 ​

桌面 Android v1.0 GA (v5.0.3.53) 上架后，issue #21 P1 主体 5 项一日内全部 land — A.1+A.2+B.1+B.5+C.1 闭环，~270 单测 + 5 设计文档 + Linux 用户配对指南。P2 候选 4 项 (B.3/B.4/C.2/C.3) 等 GA Play Store + 真用户反馈复评。

A.1 桌面 Linux native 配对（PR1+PR2+PR3，57 单测）：

  • cc pair preflight — 5 项 LAN 诊断（平台 / 网卡 / multicast / port 5353 holders / firewall hint），exit 0/1/2 分级
  • cc pair token generate/list/show/revoke — one-active-DID 不变量 + atomic file write
  • dist-tools/systemd/chainlesschain.service — hardening 全套 systemd 模板（NoNewPrivileges / ProtectSystem=strict / ReadWritePaths whitelist）
  • docs/linux/PAIRING.md — 9 段用户指南（3 场景 / 5 blocker 修复 / 诊断包收集）
  • Audit 反驳："Linux 需补 mDNS systemd 单元"是误解 — @libp2p/mdns + bonjour-service 纯 JS 不依赖 avahi-daemon

A.2 三端 UI consistency 设计文档 v0.1 baseline — 4 项 必须一致（语义色 / 高风险红 / DID 短显 / m-of-n 进度展示）+ 4 项 必须不同（手表大按钮 ≥48dp / 桌面侧栏 / 车载 voice-only / 手机 thumb zone）

B.1 web-shell 私钥签字 UI（PR1+2a+2b+3，113 单测）：

  • MultisigSigner + buildUkeyManagerSigner adapter + multisig.sign WS topic（in-process，绕开 cc subprocess 6-10s 冷启）
  • signWithExternal async API（core-multisig 新增）
  • SignProposalModal.vue（Pinia store + member dropdown + dev-only hex source）
  • unified-key-manager DID-based signer routing — 同 DID 跨 driver 自动路由

B.5 跨链桥 outbound × m-of-n 多签（Layer 1+2，8 PRs）：

  • Layer 1：CLI bridge --require-multisig + bridge-consume + web-shell crosschain.bridge.consume 直接 topic + Multisig.vue 执行按钮
  • Layer 2：cc_bridges m-of-n provenance 列 + crosschain-mtc attachMultisigProvenance / stripMultisigSigsForCanonical helpers + buildMultiHopBridgeEnvelope 3rd arg + verifyMultiHopBridgeEnvelope auto-runs provenance check + bridge-consume --mtc carries multisig provenance into staging
  • Layer 3（external-blocked Q-COMP-3）：真 testnet 锚定 + contract audit + KYC + bridge counterparty 选型 — 不计入本 scope

C.1 watch face → VoiceMode shortcut（PR1+PR2+PR3，33 单测）：

  • Phone-side VoiceLaunchActions + VoiceTriggerSource（AUTO_BUTTON / PHONE_SHORTCUT / WEAR_FORWARD / VOICE_TRIGGER 4 enum）
  • CcPhoneVoiceListener Data Layer service — /cc/voice/start MessageClient path
  • Wear-app VoiceSender / VoiceShortcutTileService / VoiceComplicationService
  • 安全：trigger_source 字段 wear 侧仅信息用途，phone 侧锁 WEAR_FORWARD 防伪
  • Audit reframe：设计文档说"需先抽 generic cc.voice.start IPC"不准 — Auto Phase 1 实际是 in-process VM event，没有公开 IPC；wear 走 Wearable Data Layer MessageClient 直 forward 更直

bug 修（最终 sweep）：

  • C.1 PR1+PR2 两个 Robolectric 测试漏标 @Config(sdk = [33])，Robolectric DefaultSdkPicker 拒收 compileSdk=35（maxSdkVersion=34）；统一与 :app 其它 Robolectric 测试一致 — f1d283833

剩余 follow-ups（gated）：

  • A.1 full headless WS signaling listener + IPv6 multicast + WSL2 helper（gated on GA reflection）
  • B.5 Layer 3 真链上锚定（external-blocked，Q-COMP-3 待 testnet 资金 + contract audit + KYC 决策）
  • B.1 F1-F4：encrypted software secret store / CLI --keystore flag / SignProposalModal 'unified' radio / UnifiedKeyManager IPC bind-did
  • C.1 真机 instrumented E2E + 预览 drawables + phone shortcut tile

issue：#21 · 设计文档：Android 重新定位 §10 GA 后续 scope

[v5.0.3.55] - 2026-05-15 (cont) — iOS Phase 1+2+3+4 完整移植 + 2 P0 修 ​

Android v1.0 GA 验证后启动 iOS 镜像移植，一日内三 Phase 框架级落地：133 文件 / ~264 单测 / 3 设计文档 / 3 trap memory。

iOS 端用户闭环（仅框架，待真机 E2E）：

  • 桌面配对三流（Flow B 摄像头扫桌面 QR / Flow A 桌面扫手机 QR Signal e2ee / 手输 6 位 code）
  • 已配对桌面列表 → 单击桌面 → RemoteOperateView 5-tab segmented shell：
    • 终端 Tab（Phase 2）：xterm.js WKWebView + WebRTC DataChannel 直连 + softkey toolbar
    • 剪贴板 Tab（Phase 3.3）：双向读写 + iOS UIPasteboard 集成
    • 文件 Tab（Phase 3.4）：浏览 home dir + 面包屑 + 看文本 + 24 文件 icon
    • 截屏 Tab（Phase 3.5）：触发桌面截屏 + iOS 显图 + PHPhotoLibrary 显式保存
    • 系统 Tab（Phase 3.5）：CPU/Mem/Disk/Net 4 cards + 5s polling

架构 highlight：

  • RemoteCommandClient 通用 RPC actor (Phase 2 TerminalRpcClient.invoke 抽出 sibling) — 4+N skill 共享同一 invoke 池 + DC/signaling 双路径 + LRU dedup + pending pool
  • RemoteSkillRegistry 23 SeedRegistry 1:1 mirror Android (795 method)
  • OfflineCommandQueue UserDefaults JSON crash recovery (sending → pending) + OfflineQueueDrainer dataChannelReady false→true edge detection
  • 镜像 Android 已 Xiaomi 真机 E2E 验证版的 layout（HIG 偏离仅白名单 6 项）

bug 修 (P0)（code review 后期）：

  • RemoteCommandClient.invoke continuation 泄漏 — withThrowingTaskGroup timeout 路径不会 auto-resume 池中 continuation；修法 do/catch 显式清池
  • RemoteWebRTCClient.waitForAnswer 同模式不清 pendingAnswer；修同上
  • 2 regression test + 1 集成 test 验池清

剩余真机 E2E（需 Mac+iPhone+真桌面，移交用户）：Phase 1.7 三流配对 + Phase 2.7 4 终端场景 + Phase 3.7 4 skill 各跑一次 + Phase 4.7 8 通知场景。

iOS Phase 4 — Notification skill 追加（design cf7a7be78 + 6 sub-phase impl 45b485fdd → 5877b5d84）：

  • NotificationCommands actor (11 method, 1:1 mirror Android NotificationCommands.kt) + 18 unit tests
  • NotificationEventDispatcher @MainActor class — 订 commandClient.events + LRU dedup 256 + 触发 PushNotificationManager.scheduleSystemNotification + 10 unit tests
  • RemoteNotificationsViewModel — 6 user actions + 乐观更新 + offline gate 三分支 + 13 unit tests
  • NotificationsView UI — 镜像 Android NotificationCenterScreen + filter / List + swipe / detail sheet / settings sheet
  • RemoteOperateView 第 6 tab "通知" + SkillTabPickerView REWRITE 为 horizontal scroll + button row + Capsule unread badge (per design §7.9 备选 B; HIG 5-tab segmented 软上限解决方案)
  • 既有 PushNotificationManager (531 LOC) 0 改动 — 仅加 1 行 extension PushNotificationManager: RemoteNotificationPushTarget {} 显式 conformance
  • 新发现 trap (设计 §7 未覆盖)：events fan-out — cmdClient.events 单消费者，多 skill 订阅必须 RemoteDeps 内 fan-out task 拆成多子流；Phase 3 仅 1 订阅 OK，Phase 4 加 dispatcher 后必现冲突。修法落地在 RemoteDependencies init。
  • 41 新 unit tests across 3 files；iOS 单测累计 ~313

设计文档：iOS Phase 1 配对 · iOS Phase 2 终端 · iOS Phase 3 操控 framework · iOS Phase 4 通知 skill

[v5.0.3.54] - 2026-05-14 — Plan A.1 真机 E2E 收口（8 bugs：UI 黑屏 + cc/claude 可用） ​

v5.0.3.53 发版后真机 E2E 暴露 8 个独立 bug，从"打不开 / 黑屏 / 无法输入 / cc/claude 不可用"到端到端完整可用。f54a6fcd0 收口（Xiaomi 24115RA8EC ↔ Windows git-bash longfa 验证）。

核心修复（详细 entry 见根 CHANGELOG.md）：

  • fix1-5 WebRTC echo loop + iceServers 自动 refresh + 中继 msg.from 注入 + TerminalRpc dedup gate
  • fix7 TerminalListViewModel closure shadow + List 屏自动 navigate 到新 session
  • fix11 TerminalWebView LayoutParams MATCH_PARENT — Compose AndroidView WRAP_CONTENT + HTML body height:100% 死锁让 WebView 永远 0 高（"全黑"真因）
  • fix12 PtyManager login shell + git-bash probe — cc / claude / npm 等用户全局 CLI 在 Android 远程终端可用（之前 PATH 解析到 WSL bash root 用户没 PATH）

记忆复盘：feedback_currentpeerid_target_vs_self_trap.md + android_webview_xterm_resize_observer.md

[v5.0.3.53] - 2026-05-14 — Plan A.1 远程终端 Android↔桌面 WebRTC DataChannel 直连 ​

Plan A v5.0.3.52 真机 e2e 暴露 5 个 reliability bug，其中 1 个是架构性：signaling 4 跳链路（手机 → 路由器 → 中继 → 桌面 RelayClient）任一跳被 NAT idle / 蜂窝运营商间歇杀 TCP 即整体失败。Plan A.1 治本：稳态命令 + stdout/exit 推送从 4 跳 signaling 切到 1 跳 WebRTC DataChannel 直连，绕开中继 + NAT idle，p50 RTT 200-500ms → 30-80ms。失败 silent fallback signaling，保留兜底。

核心改动（详细 entry 见根 CHANGELOG.md）：

  • Phase 1 Trap 1 修复 + dataChannelReady derived StateFlow（治三方互覆盖 setOnForwardedMessageReceived 单 callback 的 latent bug，让 ice:config 拦截不再被偷走）
  • Phase 2 SignalingRpcClient.invoke DC fast path + 双 listener pending pool；DC 抛异常或未 ready 自动 fallback signaling LAN+relay 双发既有路径
  • Phase 3 TerminalListScreen 进入时触发 WebRTC handshake + UI chip 实时显示 "P2P 直连 / 中继路径"
  • Phase 4 TerminalRpc 双订 forwardedMessages + webRTCClient.messages + (sessionId, seq) 反向 LRU 去重；桌面 mobile-bridge.bridgeToLibp2p 加 reqId LRU dedup 防 PtyManager 双执行
  • Phase 5 零新代码：DC 失效 fallback + 自动重建是 Phase 2 + P2PClient 既有 scheduleReconnect 的免费副产品

Plan A 真机 e2e 临门 sweep 的 4 个 bug（53 一起带版）：APK 中文 GBK 乱码 / 每次 invoke 新 peerId 让 server cleanup 误杀 / OkHttp pingInterval 太短 / WS reconnect 不自动 re-register。

真机 e2e §5.3 矩阵移交用户：Xiaomi 24115RA8EC × 桌面 Windows dev — 5 场景（LAN / 蜂窝 / 双 NAT / DC 失效 / DC 恢复）。

详细设计：docs/design/Android_Remote_Terminal_Plan_A1.md v1.0（一日 7 commit 完成 Phase 1-5）。

[v5.0.3.52] - 2026-05-14 — Plan A 远程终端：Android↔桌面 PTY 全链路 ​

用户痛点："PC 上开了很多终端，能不能在 Android 上看到这些终端的输出并远程输入指令？"
硬约束：Windows 上已经在跑的外部终端不能被另一进程 attach（OS 句柄私有）。
落地：方案 A — ChainlessChain 桌面端用 node-pty 托管新开终端，复用 #21 Remote Operate signaling-relay 通道把 stdin/stdout 流到 Android。

Added — Plan A Phase 1 – 4 全部落地 ​

  • 桌面主进程 — PtyManager（lazy node-pty + 256KB ring buffer + 24h idle kill + shell 白名单 pwsh/cmd/bash/wsl + 8 session 上限）+ RingBuffer（byte-aware FIFO）+ terminal-handlers.js（8 个 WS topics：create/list/stdin/resize/close/history + server-push stdout/exit）+ terminal-ipc.js（V6 native IPC bridge）+ confirmation-dialog.js（高危关键字 systray 弹窗 + 永久信任）。startWebShell 接 ptyManager + terminalRequireConfirmation；handleMobileCommand 加 terminal.* namespace + mobile-bridge stdout/exit fanout（per-peer subscription map）。
  • 共享 helper — packages/cli/src/gateways/ws/topic-handler-attachment.js 抽出 ws-cli-loader 的 dispatcher 包装为 ESM helper；cc ui 的 agent-runtime.startUiServer 调一遍 → cc ui 也能 /terminal。
  • Web Panel — useTerminal composable（singleton fan-out via module-level sub map，base64↔UTF-8 编解码）+ Terminal.vue route /terminal（xterm.js lazy import + 多 session 标签 + history 补帧 + ResizeObserver + 高危关键字拦截 toast）+ 侧栏菜单 + i18n。
  • V6 plugin widget — plugins-builtin/terminal/plugin.json + shell/widgets/TerminalWidget.vue + shell/TerminalPanel.vue（xterm.js 嵌入 + IPC bridge electronAPI.terminal.*）+ slash 命令 /terminal。
  • Android — TerminalRpcClient.kt（复用 SignalingRpcClient envelope pattern + observeStdout/observeExit SharedFlow）+ TerminalWebView.kt（WebView ↔ Kotlin JS bridge）+ xterm-shell.html + xterm.js / addon-fit / xterm.css vendored 入 assets/terminal/ + TerminalListScreen / TerminalSessionScreen Compose + softkey toolbar（Ctrl/Tab/Esc/方向/Ctrl+C/D）+ NavGraph 2 路由 + RemoteOperateScreen 加 "打开远程终端" 按钮。
  • 设计文档 + 用户文档 — docs/design/Android_Remote_Terminal_Plan_A.md + docs-site/docs/guide/remote-terminal.md（双站同步）。

Tests — 162 新增，全绿 ​

  • Desktop main process: 61 测（RingBuffer 7 + PtyManager 15 + terminal-handlers 15 + terminal-ipc 12 + confirmation-dialog 5 + ws-smoke integration 6 + real PTY spawn cmd.exe integration 1）
  • CLI cc ui: 21 测（PtyManager 10 + handlers 8 + ws-mirror-smoke 3）
  • Web Panel: 17 测 useTerminal composable + 3 e2e（real cc ui subprocess + real WebSocket + real shell stdin/stdout round-trip）
  • Android: 10 测 TerminalRpcClientTest（happy / list / stdin / resize / close / history / stdout fan-out / exit fan-out / idempotent start / non-terminal events）

Fixed — pre-existing test drift swept by full suite run ​

  • docs-site/scripts/sync-design-docs.js + docs-site-design/scripts/sync-docs.js ROOT_FILE_MAP 各加 Android_Remote_Terminal_Plan_A.md 映射，双站同步 149 文件
  • desktop-app-vue widget-registry.test.ts 期望 5 个 widget id，PREVIEW_WIDGETS 已扩到 7（bridge-mtc + federation-governance 此前漏更新）
  • web-panel dashboard-store.test.js 没 mock mcp.list_tools 的 sendRaw 回应（commit d9cc41432 后漂移）
  • web-panel views-mount-smoke.test.js 5 个尾部视图（Projects/VideoEditing/P2P/Memory/Git）在 50+ 文件并行套件下撞 Notification + Pinia 跨测试状态污染：Projects 修 i18n title + 其余 4 个拆 views-mount-smoke-tail.test.js 独立 worker
  • web-panel Projects-folder-picker.test.js 测试 commit bfdde637d 已重构掉的 UI，删除过时测试

[Unreleased] - 2026-05-13 (later) — Android 社交功能产线化（demo → production） ​

14 屏 + 9 ViewModel + 4 Repository 的社交骨架 (~10K LOC) 建好已久，但 NavGraph 只接通 MyQRCode / QRCodeScanner 两路由，其它 7 路由是 registerPlaceholder("temporarily simplified")；SocialScreen Friends / Timeline 两 tab 显示固定字串；PostRepository.reportPost 构造完 entity 不入库；FriendRepository.searchUserByDid 非本地 DID 返回 null。本次一次性收口，不 bump version。

Added ​

  • NavGraph 7 占位换实屏 + 2 新路由 —— PublishPost / PostDetail / FriendDetail / UserProfile / AddFriend / CommentDetail / EditPost 全部接 Composable；新增 NotificationCenter / BlockedUsers 两路由（前者作为 deep-link target，后者由 FriendListScreen 新加 dropdown 入口可达）。DID 文档加载期渲染 CircularProgressIndicator 占位。
  • SocialScreen.kt 三 tab 升级 —— Friends → FriendListScreen（保留 P2P chat 入口 CTA）；Timeline → TimelineScreen，myDid 走 DIDViewModel.didDocument；Notifications → NotificationCenterScreen（带筛选 / 批量已读 / 清理菜单）。
  • PostReportDao 落地 —— entity 早在 schema v23 在册，但 DAO 一直缺。新建 DAO（去重 + status 流转 + 7 个查询/更新方法）+ 注册到数据库 + Hilt @Provides。PostRepository.reportPost() 改走 DAO 入库 + (postId, reporterDid) idempotent；getUserReports() 走 DAO 查询不再 hardcode 空。
  • PROFILE_QUERY / RESPONSE 协议 —— 2 新 MessageType + SelfProfileProvider 接口 + SelfProfileSnapshot data class。RealtimeEventManager.queryProfile(targetDid, 5s timeout) 用 onSubscription 解 SharedFlow replay=0 订阅竞态。DefaultSelfProfileProvider（DID 末 8 位占位昵称，与现 MyQRCodeViewModel 同规则）在 ChainlessChainApplication.delayedInit 注入。FriendRepository.searchUserByDid() 本地未命中即 fallback。
  • BlockedUsersScreen 接 ViewModel —— FriendViewModel 注入 DIDManager、加 loadBlockedUsers() + unblockFriend 走完整 unblockUser(myDid, did) 路径（清 BlockedUserEntity 行）。

Tests — 39 new, all green ​

  • Unit (core-p2p) RealtimeEventManagerProfileQueryTest 6
  • Unit (feature-p2p) Post/Friend/FriendViewModel/DefaultSelfProfile 14
  • Integration (core-database) PostReportDaoTest Robolectric + in-memory Room 8
  • Regression (app) SocialRouteRegressionTest / SocialScreenTabRegressionTest 11

学习——race-fix：queryProfile resolves 测试用 runTest 跑挂——manager 内部 scope 用 Dispatchers.IO 与 virtual-time TestDispatcher 不在同图，2s timeout 在 virtual 时间瞬时跳完，IO 协程没来得及处理就 fail。改 runBlocking + withTimeout(10_000) 后过。

详细设计文档 →

[Unreleased] - 2026-05-13 — v1.2 GA 反馈整合：P0 前置 + project workflow + 11 daily templates + 6 bug fix (#21) ​

本批分两阶段。阶段 1 (v1.2 GA 上架前)：A.3 ADR review / B.6 PQC 严格模式 verifier / B.2 削 web-shell /multisig cc subprocess 冷启三项 GA-independent + AI-3 forward-compat seam + 2 相关 bug fix。阶段 2 (v1.2 GA 反馈到位)：5+3 反馈整合 #2 (删除 bug) / #3 (模板改日常 11 个) / #4-#7 (桌面↔手机项目工作流: CLI + REMOTE handler + 双向 sync walker) / #8 (web-shell 项目菜单 + 双端一致 view) 落地 P1+P2+P3 Part A。version 不 bump —— v1.2 GA 反馈仍在收集中, 与未来 P1 主体一起 release。

Added — v1.2 GA 反馈整合 5+3 项 (#21 #2/#3/#4/#5/#7/#8) ​

  • #2 项目无法删除 fix (commit fc24f9856) —— ProjectScreen.kt::EnhancedProjectCard 完全没有 delete UI（feature-project/.../ProjectListScreen.kt delete 代码是死代码未连入 NavGraph）。加 3-dot 菜单 + AlertDialog 确认 → DAO softDelete → Room Flow 自动从列表移除。
  • #3 项目模板改日常 11 个 (commit 99d38bf69) —— 砍掉 11 IDE 模板 (Android/React/Spring/Flutter 等)，整个 ProjectTemplates 重写为日常生活模板：购物清单 / 旅行计划 / 读书笔记 / 灵感收集 / 健身计划 / 食谱记录 / 学习计划 / 家庭账本 / 工作日志 / 会议记录 / 空白。TemplateCategory 加 5 个新类目 (DAILY/TRAVEL/STUDY/HEALTH/FINANCE)。
  • #4/#7 桌面 CLI + REMOTE handler P1 (commit 32ccabdb5) —— cc project init/list/show/delete 4 subcommands 直写 desktop chainlesschain.db (WAL 并发安全)。project-management-handler.js 暴露 6 actions 给 Android L3 REMOTE 调用，复用 desktop DatabaseManager。CLI 7 + handler 21 unit tests。
  • #4 Android→Desktop 反向 sync P2 (commit 2646bbb4e) —— 修补 audit 发现的反向同步缺口 (SocialSyncWalker 不含 projects 表)。新增 ProjectSyncWalker (feature-project) + CompositeSyncRepositoryWalker (:app 聚合 Social + Project) + SyncWalkerModule (Hilt 绑定)。CREATE/UPDATE/DELETE op mapping 完整。
  • #5/#8 web-shell Projects view + in-process WS P3 Part A (commit bfdde637d) —— 6 in-process WS topics 包装 P1 ProjectManagementHandler (DRY: 同一 handler 同时服务 web-shell + mobile L3 REMOTE)。新 Projects.vue 项目管理列表 (stats + filter + Detail drawer + Create modal)，useShellMode().isEmbedded 分发 in-process vs subprocess。原 Projects.vue 内容保留为 ProjectInit.vue (/project-init)。

Fixed ​

  • wear test imports (commit c0d061328) —— CcPhoneDecisionListenerTest.kt 缺 4 kotlinx.coroutines imports block 整个 :app:compileDebugUnitTestKotlin，加 imports 解锁。
  • B.6 strict mode disk-load gate (P0 sweep) —— LandmarkCache.loadFromDisk() bypass strict-mode gate；per-snapshot 严格检查移到 _validateAndStoreSnapshot() 头部，+2 disk-load integration tests 锁回归。
  • feature-project pre-existing kotlin.test imports (P2 sweep) —— 5 文件用 kotlin.test.* 但 deps 无；改 org.junit.Assert.* 解锁 :feature-project:compileDebugUnitTestKotlin。

Tests ​

阶段 1 (P0)：

  • landmark-cache-strict-pq-mode.test.js 11/11
  • multisig-handlers.test.js 23/23
  • ManifestSignatureVerifierTest.kt 10/10 + regression SkillMetadataTest 9/9 + RemoteSkillRegistryTest 38/38

阶段 2 (project workflow)：

  • project-management-handler.test.js 21/21 (P1 desktop handler)
  • project-cli.test.js 7/7 (P1 CLI integration via sql.js WASM)
  • ProjectSyncWalkerTest.kt 12 tests (P2 — pending CI, 本地 feature-project pre-existing test failures 不相关)
  • CompositeSyncRepositoryWalkerTest.kt 7/7 (P2 :app aggregate)
  • project-handlers.test.js 7/7 (P3A web-shell wrapper)
  • Android :app:testDebugUnitTest regression 80/80
  • Desktop combined 51/51

[Unreleased-Phase1-Legacy] - 2026-05-13 — Android v1.3+ P0 前置三项 GA-independent + AI-3 forward-compat + 2 bug fix（已并入上方 Unreleased 主条目） ​

Added — #21 P0 前置三项 ​

  • A.3 ADR Review v2.0（commit 348896382）—— 新增 Android_ADR_重评估_v2.0.md v1.0；8 ADR audit 结论 5 keep / 2 amend / 1 revise：ADR-2 (M2 DID wallet 走软件 Ed25519，blocks B.3 DID rotate) 待 v1.2 GA Play Console API level 数据决策选项 A/B/C；ADR-7 / ADR-8 文本 amend 落 §4 对齐真实（cc-mobile.json 从未创建，registry 实际 disk-first + push-based 非 pull）。同 commit §10 v1.3+ scope triage 分层（12 子项 P0/P1/P2 + 5 依赖链）。
  • B.6 PQC 严格模式 verifier gate（commit e24386d00）—— packages/core-mtc/lib/landmark-cache.js 加 strictPqMode opt-in flag + 两层 gate (_assertStrictPqMode landmark-level / _assertStrictPqModeForSnapshot per-snap) + STRICT_PQ_MODE_VIOLATION error code + CLASSICAL_ALGS 常量 + isClassicalAlg helper。Reading A 语义：拒收任何 alg === "Ed25519" 的 partial sig + publisher_signature；与现 heterogeneous federation 数据格式兼容，0 schema 改动；生产者侧 0 改动。
  • B.2 in-process multisig.* + marketplace.consume topics（commit b1c7cfd95 + label fix c21ba9346）—— desktop-app-vue/src/main/web-shell/handlers/multisig-handlers.js 新增 7 个 in-process WS topics 镜像 CLI --json 输出 shape：multisig.list / show / policy.show / cancel / finalize / sweep + marketplace.consume。Topics 调 openMultisigManager() from CLI multisig-runtime.js（per-call open SQLite WAL ~20ms），dynamic-import 跨 CJS/ESM 边界。Multisig.vue 加 callMultisigTopic() helper 用 useShellMode().isEmbedded 分发；7 处 ws.executeJson 全切；非 embedded（cc serve）保留原 subprocess fallback。性能：asar:true 子进程冷启 6-10s → in-process ~20ms (SQLite open) + 查询，60-100× 提升。UX 0 改动。
  • A.3 AI-3 SkillMetadata.signature forward-compat（commit 45a88270e）—— Android Kotlin。新增 ManifestSignatureVerifier.kt：interface + sealed VerificationResult.{Accepted | Rejected(reason)} + object NoOpManifestVerifier always-accept stub。SkillMetadata.kt 加 signature: String? = null field + init invariant。RemoteSkillRegistry.kt 加 @Volatile manifestVerifier + setManifestVerifier(v) swap seam + updateFromRemote() per-skill 验签 partial-acceptance + empty-result 短路。Marketplace M0 (#21 AI-5) 上线时注入真 Ed25519/SLH-DSA hybrid verifier 即可，调用方 0 改动。

Fixed ​

  • wear test imports（commit c0d061328）—— CcPhoneDecisionListenerTest.kt 自 cc08da0b0 (v1.2 #20 P0.2) 起用 kotlinx.coroutines.GlobalScope.launch { delay() } 写 smoke 测试，但 imports 缺 launch/delay/GlobalScope/DelicateCoroutinesApi。block 了整个 :app:compileDebugUnitTestKotlin，加 4 imports 解锁。
  • B.6 strict mode disk-load gate（test-driven 发现于本次 QA sweep）—— LandmarkCache.loadFromDisk() 直接调 _validateAndStoreSnapshot() bypassing ingest's strict-mode gate；strict mode OFF 写入磁盘的 Ed25519 landmark，下次 strict mode ON 加载时仍接受（silent invariant 违反）。修：per-snapshot 严格检查移到 _validateAndStoreSnapshot() 头部统一处理，+2 新 disk-load integration tests 锁回归。

Tests ​

  • landmark-cache-strict-pq-mode.test.js 11/11 pass（9 原 + 2 disk-load integration）
  • multisig-handlers.test.js 23/23 pass（B.2 unit tests via runtimeFactory 注入 seam）
  • ManifestSignatureVerifierTest.kt 10/10 + SkillMetadataTest 9/9 + RemoteSkillRegistryTest 38/38 regression 全过（本地 NDK install 修复后 ./gradlew :app:testDebugUnitTest 2m21s 全绿）
  • web-shell 379 regression 全过（25 test files）

[5.0.3.49 / CLI 0.161.9 / Android 1.0.0 GA] - 2026-05-12 (M-of-N multisig Phase 1d + Phase 2a marketplace mediator + Phase 2b web-panel multisig view + Flow B QR pairing 收口 + 测试补丁) ​

本版四条主线：(1) @chainlesschain/core-multisig package + cc multisig CLI 落地（commit 3c890dcac，v1.2 m-of-n Phase 1d）—— Phase 1 完整 5-lib：policy / store / proposals / signing / governance-log；CLI 8 subcommands propose / sign / cancel / finalize / list / show / sweep / policy；75 lib 单测 + 10 CLI integration 测试全过。(2) Phase 2a marketplace.purchase mediator（commit 2755093d0）—— 设计文档 §6.1 落地：cc marketplace purchase 大额（≥¥1000）自动走 M-of-N 多签 propose，小额走 direct execute；cc marketplace consume 在 threshold 达成后 finalize + 执行业务操作；抽 multisig-runtime.js 共享 SQLite cascade（-130 行 dedup，Phase 1 10/10 零行为变更）；8 新 E2E 测试全过。marketplace.purchase / did.rotate / 跨链 bridge 三大典型 domain 由此解锁，marketplace.purchase 是第一个真实接通业务侧的 mediator。(3) Phase 2b web-panel Multisig 视图落地（commit c758492d9）—— 设计文档 §8.1 落地：web-shell（默认桌面入口）加 M-of-N 多签查看 / 操作面板，Phase 1 CLI 的 cc multisig list/show/cancel + cc marketplace consume 通过 ws.executeJson(...) 走 CLI 子进程；同份 SPA 在 desktop web-shell + cc ui 两边都自动可用（per memory feedback_cross_shell_feature_pattern）。(4) Android v1.1 W3.7 Flow B QR pairing 落地（commit c47cbc649）—— desktop 显 QR / phone 扫的主流应用通用 UX，Xiaomi 24115RA8EC 真机 E2E verified。同时把 Flow B 漏掉的 2 个测试文件补齐：ScanDesktopPairingViewModelTest 10 项 + desktop-pair-handlers.test.js 19 项。

Added — M-of-N multisig core（v1.2 #20 P0.3 Phase 1d） ​

  • @chainlesschain/core-multisig package（commit 3c890dcac）—— 新建 npm workspace package：
    • lib/policy.js —— 域级 policy {m, n, members[], requirePqc, defaultExpiryMs} validate + normalize
    • lib/store.js —— SQLite schema (proposals / signatures / policies 3 表) + 5 操作 helper
    • lib/proposals.js —— 状态机 propose / sign / cancel / finalize / expireStale；pending → reached → consumed + cancelled / expired terminal
    • lib/signing.js —— JCS canonicalize + DOMAIN_PREFIX "MULTISIG:" 防回放 + Ed25519 / SLH-DSA dispatcher + verifyThreshold strip-all-sigs
    • lib/governance-log.js —— append-only JSON Lines 审计 log，每态转捕 proposed / signed / reached / consumed / cancelled / expired / expired_sweep
    • 75 单测（policy 14 + signing 21 + proposals 20 + store 12 + governance-log 8）全过
  • cc multisig CLI 8 subcommands（commit 3c890dcac）—— propose <domain> --payload-file --initiator --key / sign <id> --signer --key / cancel <id> --reason / finalize <id> / list [--state --domain --limit] / show <id> / sweep / policy {set, show}；全 --json 输出。
  • SQLite driver cascade native → WASM（per memory feedback_sqlite_wasm_fallback）—— better-sqlite3-multiple-ciphers / better-sqlite3 失败时自动降级 sql.js (WASM)，CLI 跨平台开箱即用。
  • 跨包 dep 注入 —— cli/package.json 加 @chainlesschain/core-multisig: 0.1.0；cli/src/index.js 注册 registerMultisigCommand(program)。
  • 测试基础修复 3 项：
    • core-multisig vitest.config.js 设 globals: true，避免 vitest 4 拒绝 CJS require("vitest")（memory cli_ci_sharding_lessons）
    • 5 个 test 文件改 ESM import { describe, ... } from "vitest" 头
    • multisig-cli.test.js import 路径修：@chainlesschain/core-mtc/signers/ed25519.js → 去 .js 后缀（core-mtc exports key 是 ./signers/ed25519 无后缀）
  • 10/10 CLI integration tests pass（包括 help / policy roundtrip / propose / sign / cancel / finalize / list / show / sweep / 错误路径）。

Added — Phase 2a marketplace.purchase mediator（v1.2 #20 P0.3 Phase 2） ​

  • 共享运行时抽取 packages/cli/src/lib/multisig-runtime.js（commit 2755093d0，新文件）—— Phase 1 commands/multisig.js 内联的 SQLite cascade（better-sqlite3-multiple-ciphers → better-sqlite3 → sql.js）+ manager loader 抽出公共模块，让 commands/marketplace.js 复用同一份；readSecretKey / readJsonArg helpers 同。
  • commands/multisig.js refactor（commit 2755093d0）—— 用 multisig-runtime.js 替代内联 _openManager / _openDatabase / _adaptSqlJs / _readKey / _readJsonArg，−130 行 deduplication。Phase 1 10/10 integration test 全 green，零行为变更。
  • cc marketplace purchase <itemId> 新 subcommand（commit 2755093d0）—— --amount-fen N --buyer <did> --key <hex> [--threshold-fen N] [--item-name <name>]：amount < threshold（default LARGE_PURCHASE_THRESHOLD_FEN = 100_000 fen = ¥1000）走 direct path（CLI stub 打印 "purchased"，无真支付处理器）；amount ≥ threshold 必须有 marketplace.purchase 域 policy，否则 exit 2 no_policy；有 policy 调 mgr.propose 返 proposalId 让其他签名方加签。
  • cc marketplace consume <proposalId> 新 subcommand（commit 2755093d0）—— 校验 domain == "marketplace.purchase" + state == "reached" 才执行；finalize 后打印订单 payload + governance log 写 consumed 事件。错域 / 错态都 exit 2。
  • LARGE_PURCHASE_THRESHOLD_FEN export（100,000 fen = ¥1000）—— 业务侧 + CLI 共享门槛常量。
  • 8 新 E2E test 全 green（packages/cli/__tests__/integration/marketplace-multisig-e2e.test.js）：(1) 大额 ¥1500 2-of-2 全 walkthrough：policy set → purchase 创 proposal → 2 个签名方各 sign → reached → consume → finalize → governance.log 4 类事件 (proposed / signed×2 / reached / consumed)；(2) 小额 ¥500 走 direct path 不创 proposal；(3) --threshold-fen override 覆盖默认；(4) 大额无 policy → exit 2 blocked；(5) consume pending proposal → exit 2 proposal_state_pending；(6) consume 错域 proposal → exit 2 wrong_domain；(7) --help 文本验证。
  • 总 18 multisig integration test 全 green（Phase 1 10 + Phase 2 8）。

Added — Phase 2b web-panel Multisig 视图（v1.2 #20 P0.3 Phase 2b） ​

  • packages/web-panel/src/views/Multisig.vue（commit c758492d9，新文件 468 行）—— 设计文档 §8.1 落地：
    • 6-card 顶部 stats —— 总提案 / 待签 (pending) / 已达阈值 (reached) / 已执行 (consumed) / 已取消 (cancelled) / 已过期 (expired)，各带 Ant icon + 色彩 token
    • 两个 tab —— 提案列表：表格 columns（ID / Domain / State / Sigs / Created / Expires / Actions）+ state 过滤器（pending / reached / consumed / cancelled / expired）+ domain 过滤；行 actions：详情 / 取消 / 执行购买（marketplace.purchase reached only）。域策略：列已知 domain（marketplace.purchase / did.rotate / crosschain.outbound）的 policy 详情 + 成员展开
    • Detail drawer (640px) —— Descriptions 显 domain / state / threshold / sigs / initiator / timestamps / payload (JSON pretty) + 签名列表（signer DID + alg + 时间）+ 操作按钮：取消（pending|reached）/ 执行购买（marketplace.purchase reached）/ finalize（其他 reached）
    • info Alert 提示 "web shell 不持私钥，sign 操作走 CLI"
    • 顶部操作栏：刷新 + 扫过期（调 cc multisig sweep）
  • packages/web-panel/src/router/index.js（commit c758492d9）—— 加 { path: 'multisig', name: 'Multisig', component: () => import('@/views/Multisig.vue') } 路由。
  • packages/web-panel/src/components/AppLayout.vue（commit c758492d9）—— security/audit 组加 multisig menu item（TeamOutlined icon）；折叠模式（右侧）同步加 multisig 入口；i18n fallback "M-of-N 多签" — appLayout.items.multisig 未配时显示中文。
  • WS 通信走 CLI 子进程 —— ws.executeJson('multisig list --json') 等通过 CLI WS server _executeCommand 路径。第一次冷启动 6-10s（asar:true 开销，per mtc-status-handlers.js comment）— Phase 2 可接受；Phase 3 follow-up 可加 in-process WS handlers (multisig.list / multisig.show / ...) 削延迟。
  • Phase 3 留 follow-up：私钥签名 UI（需 Unified KeyStore 接通）、in-process WS handlers（现走 cc subprocess）、实时推送（现 onMounted 拉取一次无 WS 订阅）、Marketplace.vue 集成入口（purchase modal 直接进 multisig 流程）。

Added — Android v1.1 W3.7 Flow B QR pairing（issue #19） ​

  • Mobile 端扫描桌面 QR 完整链路（commit c47cbc649）—— Phone 摄像头扫桌面屏幕 QR 比反向（desktop webcam 扫小手机屏）识别率高得多，主流应用（微信、支付宝、Discord、WhatsApp Web）通用 UX 模式。9 项实战坑（memory desktop_qr_pairing_flow_b.md 全记）：<a-qrcode> 必须显式 async-register / parseJsonOutput log-prefix vs JSON-array regex / mobileBridge.peerId 必须 this. / social QRCodeScannerViewModel 校验 reject 非好友 QR / pair-ack 拦截在 bridgeToLibp2p 前 / in-memory ack vs CLI 写 DB 双轨 / 跨模块 DI / adb reverse 无域名 E2E / Flow B QR 字段含 pcPeerId。
  • 跨模块 DI：PairingSignalingGate.sendAck interface 落 :core-p2p 避免 :feature-p2p 反依赖 :app；WebSocketPairingSignalingGate.sendAck 实现在 :app 内 ensureRegistered + Mutex 串行化。WebRTCClient.SignalClient.sendForwardedMessage(toPeerId, payload) 桥接 mobile 端的 signaling forward。
  • Mobile 端 UI ScanDesktopPairingScreen + ScanDesktopPairingViewModel：用非-social QRCodeScannerScreen（ZXing 透传，social variant 校验 reject 我们的 desktop-pairing JSON）；NavGraph + SettingsScreen 加"扫描桌面 QR"入口（推荐路径）。
  • Desktop 端 WS topics 三件套 desktop-pair-handlers.js：desktop.pair.generate-qr（生成 6 位 code + payload + pcPeerId 三段 fallback：mobileBridge.peerId → deviceManager.getCurrentDevice → "desktop-unknown"）/ desktop.pair.poll-ack（idle / waiting / acked / expired 四态）/ desktop.pair.reset；mobile-bridge.js 加 this.peerId 持久化 + 拦截 type=pair-ack 经 recordPairAck 匹配 + 写 SQLite paired_devices。
  • Vue UI MobileBridge.vue Flow B tab（默认）+ Flow A + 手输 3-tab；antd.js 注册 AQrcode（ant-design-vue qrcode 异步加载）。
  • 真机 E2E verified：Xiaomi 24115RA8EC desktop QR → ML Kit 扫 → signaling pair-ack → desktop mobileBridge 拦截 → recordPairAck 匹配 → CLI pair-from-qr 写 SQLite → Vue 列表刷新。

Added — 单元测试补丁 ​

  • ScanDesktopPairingViewModelTest.kt (新增，10 测试)：初始 Scanning 态 / 合法 QR → Sending → Success + ack payload 字段验证 / type 错 → Failed / code 非 6 位 → Failed / pcPeerId blank → Failed / timestamp > 5min → Failed / 无 DID → Failed / signaling gate 失败 → Failed + 错误信息透传 / retry 重置态 / 重复扫描 idempotent / malformed JSON → Failed。MockK + StandardTestDispatcher + FakeGate 捕获 sendAckCallCount 验。
  • desktop-pair-handlers.test.js (新增，19 测试)：generate-qr 6 case（bridge 缺/null throw、peerId happy path、deviceManager fallback、desktop-unknown fallback、regenerate 覆盖前 session）/ poll-ack 4 case（idle / waiting / acked / expired with vi.useFakeTimers）/ reset 1 case / recordPairAck 4 case（无 session drop、code mismatch drop、缺 pairingCode drop、match + receivedAt timestamp）。
  • Android :feature-p2p:testDebugUnitTest 41s 全绿 含新 ScanDesktopPairingViewModelTest + existing DesktopPairingViewModelTest（commit 时同步改 sendAck signature）+ MessageQueueViewModelTest + P2PChatViewModelTest + P2PDeviceViewModelTest。
  • Desktop 3 文件 / 45 测试全绿 含新 desktop-pair-handlers.test.js + mobile-pair-handlers.test.js + web-shell-bootstrap.test.js。

Distribution ​

  • 桌面 binary：v5.0.3.48 → v5.0.3.49 重打（含 Flow B + multisig 新代码；auto-updater 比对 5.0.3-alpha.49 > 5.0.3-alpha.48）
  • chainlesschain npm 0.161.8 → 0.161.9（cli 加 multisig command + dep @chainlesschain/core-multisig）
  • Android：versionCode/Name 不变（1.0.0 GA 维持），Flow B 走桌面端首发；后续 Android v1.1 minor release 一并 ship 完整移动客户端
  • 三大文档站本次同步刷新：docs-site / docs-site-design / docs-website-v2 tagline 升 v5.0.3.49 + 加本节 changelog；CHANGELOG.md + README.md / README_EN.md 同步

[5.0.3.48 / CLI 0.161.8 / Android 1.0.0 GA] - 2026-05-12 (Android M3 capture suite 5/5 code + M4 RemoteSkillRegistry method-level + ApprovalUI 4-category + ProgressViewer + alias 兼容窗口 + Android M7 GA flip versionCode 37 → 100 / versionName 0.37.0 → 1.0.0) ​

Android v1.0 RFC M3 + M4 收尾批次（7 commit / 187 新单测）+ Android M7 GA flip 一并落地（commit ffe722162，versionCode 37 → 100，versionName 0.37.0 → 1.0.0）。把设计文档 §5.3 L2 捕获五件套补齐到代码层（VoiceMode / CameraOCR / LocationTagger / SharePayloadFlusher / PushNotifier）+ §6 M4 D1 RemoteSkillRegistry method-level 元数据 + §5.4 ApprovalUI 4-category 适配 + ProgressViewer 长时任务面板 + §8.3 alias 兼容窗口。Android 总单测 196+ → 383+。无桌面 / CLI 源码改动，CLI npm 0.161.7 → 0.161.8（force publish 走 release.yml 同步轨道）。Android v1.0 GA 仍待用户出场（4 项）：M3 真机 E2E / M4 D2 真机 / FCM 凭证 / M6 性能实测。

Added — Android M3 capture suite (5/5 code) ​

  • VoiceMode 连续语音串联（commit 47bebed80）—— ASR → REMOTE chat → TTS pipeline 在 home 入口串通。
  • CameraOCR 拍照入 KB 流水线（commit a69269ced）—— ai.ocrImage + knowledge.createNote 走完，自动写 OCR 元数据。
  • LocationTagger Play Services FusedLocationProvider + Foreground Service（commit 3f5ac8647）—— GPS 数据进 createNote.metadata，前台服务保证后台采集合规。
  • SharePayloadFlusher 接 SyncCoordinator → knowledge.createNote（commit 3d1a6e3a8）—— 5 种 SharePayload（Text / Url / SingleImage / MultiImage / GenericFile）转 note 字段；SyncCoordinator 30s push 循环末尾 drain SharedInboxRepository，失败 re-enqueue。19 新单测。
  • PushNotifier 本地通道 + FCM 骨架（commit c0d990c91）—— 4 NotificationChannel（Cowork DEFAULT / Marketplace HIGH / SystemAlert DEFAULT / ShareInbox LOW）+ 协议中立 CcPushNotificationService 入口；google-services.json 真接入按 android-app/docs/M3_FCM_SETUP.md 5 步（用户出场）。36 新单测。

Added — Android M4 收尾 ​

  • RemoteSkillRegistry method-level 元数据补全（commit 6e49270fd）—— MethodMetadata（name / paramCount / riskOverride / requiresApprovalOverride）+ listMethods / getMethod / requiresApprovalForMethod / riskForMethod accessor；knowledge.* + ai.* 各 10 methods seeded（8 riskOverride 演示）；其他 21 namespace pending 桌面 mobile-skill-whitelist 下发。16 新单测。
  • ApprovalUI 4 category 适配（commit f4f83cc67）—— ApprovalCategory enum {Sign / Cowork / Marketplace / SystemCritical} + fromMethod 推断；AndroidApprovalGate 4-arg overload 透传 category（旧 3-arg 自动 forward）；Dialog 按 category 切 icon / tint / title / footer。9 新单测。
  • ProgressViewer 长时任务面板（commit f4f83cc67）—— LongTaskRegistry @Singleton MutableStateFlow<List<LongRunningTask>>（Pending / Running / Completed / Failed / Cancelled，MAX_TASKS=100 滑窗）+ TaskProgressCommandRouter 接 task.* reverse-RPC（update / complete / fail / cancel / remove）+ Compose ProgressViewerScreen（StatusChip + Linear / indeterminate Circular + dismiss / clear-terminal）。34 新单测（15 + 19）。
  • §8.3 RemoteSkillRegistry alias 兼容窗口（commit 0bc8e2797）—— SkillMetadata.aliases: List<String> + 内部 aliasIndex 反查；get / listMethods / requiresApproval / risk* 全部经 resolveAlias 路径自动解析；新增 resolveAlias public API。7 新单测。
  • §8.1 README + v1.0 GA 检查清单（commits 0bc8e2797 3da484e9c）—— android-app/README.md M3 (2/5) → (5/5 code)、M4 补 method-level + ApprovalUI + ProgressViewer；新增 ANDROID_v1_GA_CHECKLIST.md 列 v1.0 GA 仍待用户出场 5 项。

Tests ​

  • Android 新增 187 单测全绿 跨 14 测试文件。回归覆盖 capture / push / registry / task / approval-category / composite-router 全部新模块。
  • Android 总单测 196+ → 383+（M1 0 + M2 68 + M3 130 + M4 152 + M5 33）。
  • Desktop store 回归 26 文件 / 773 测 ✓；CLI lib 169 文件 / 7185 测 ✓（确认 Android 工作未污染 desktop / CLI 路径）。

Distribution ​

  • 桌面 binary：v5.0.3.47 → v5.0.3.48 重打（无桌面源码改动；auto-updater 比对 5.0.3-alpha.48 > 5.0.3-alpha.47）
  • chainlesschain npm 0.161.7 → 0.161.8（CLI 自身 0 源码改动；force publish 走 release.yml 同步轨道）
  • Android：versionCode 37 → 100, versionName 0.37.0 → 1.0.0 GA（commit ffe722162）—— M7 GA flip 与本批 M3/M4 工作一并落地；android-app/CHANGELOG.md 加 [1.0.0] - 2026-05-12 GA entry 汇总 9 commit + 4 项已知限制（FCM 国内 / 单 peer / 离线队列 / QRPairing scaffold）；android-app/README.md 标题切 "🎉 v1.0.0 — GA"。下一步 tag v1.0.0 在 commit ffe722162 推 gitee+github
  • 三大文档站本次同步刷新：tagline 升 v5.0.3.48 + 加本节 changelog

[5.0.3.47 / CLI 0.161.7 / Android 0.37.0] - 2026-05-11 (Verification release：build-android keystore fix VERIFIED + density splits 14→4 用户侧首落 + outstanding ../ 全扫净) ​

验证型发版。无桌面 / CLI / Android 源码改动，只把 v5.0.3.46 后陆续落的 3 个 release-pipeline 修复在 CI 实跑一遍证明 green。release.yml run #25632845952 全 11 个 job ✓（含 build-android、create-release、publish-cli、finalize-release），4 个 Android assets 入 GitHub Release v5.0.3.47。

Verified ​

  • build-android keystore path mismatch（commit f9a7ba716） —— 历史：49f1440ca (2026-05-09) 把 android-app/app/build.gradle.kts:79 从 file(...) 切到 rootProject.file(...)，让 release.storeFile 路径解析基准从 :app 模块改成 rootProject (android-app/)。.github/workflows/release.yml 的 release.storeFile=../debug-ci.keystore 在新基准下错位到 repo root，gradle 在 <repo-root>/debug-ci.keystore 找不到 keystore，v5.0.3.46 build-android 因此挂在 :app:validateSigningRelease。修法：去掉 workflow 里 keystore.properties 内容的 ../ 前缀。v5.0.3.47 build-android job 真绿 verified，4 Android assets 正确入 Release。
  • Density APK splits 用户侧首落（commit 9865c5c08） —— v5.0.3.46 已合，但因 build-android 挂没产出，本轮首次用户可见：density × ABI splits 在 Android 5.0+ runtime resource selection 下作用不大，移除后 release asset count 14 → 4（3 APK + 1 AAB），AAB 走 bundle{} 块的 density delivery 上 Play Store。
  • 剩余 ../ 三处扫净（commit 5a06421cd） —— keystore.properties.template / docs/guides/KEYSTORE_SETUP.md / orphan android-app/.github/workflows/android-release.yml 同病一并扫。约定全 repo 统一：release.storeFile=keystore/<name>.keystore（无 ../），物理 keystore 落 android-app/keystore/<name>.keystore。

Distribution ​

  • 桌面 binary 重打 v5.0.3.46 → v5.0.3.47（二进制内容与 v5.0.3.46 等价；auto-updater 比对 5.0.3-alpha.47 > 5.0.3-alpha.46，v5.0.3.46 用户重启拿到新 build）
  • chainlesschain npm 维持 0.161.7（无 CLI 改动，release.yml cli-tests job correctly skipped）
  • Android：versionCode 37 / versionName 0.37.0 不变（无源码改动），APK 因 density splits 关闭从 14 → 4 个产物
  • 三大文档站本次同步刷新：tagline 升 v5.0.3.47 + 加本节 changelog + deploy-all.py tar 路径同步

[5.0.3.46 / CLI 0.161.7 / Android 0.37.0] - 2026-05-10 (Phase 3d 桌面 ↔ Android 双向同步全套 + Android 七件套 + e2e CI 静默回归洞收口) ​

真正打通桌面 ↔ Android 的双向社交数据同步（Phase 3d M2 → v1.2 共 12 个 commit，gate 1-4 全部 Ed25519 真签真验），Android 端一次落 7 件用户可见功能（Volcengine 语音 / APK 自更新 / Splash 重做 / Claude coral 主题 / i18n 三地区 / 生物识别 / DID Key 屏），CI 收掉 e2e-tests continue-on-error 这个把 3/3 OS 失败显示 success 的静默回归洞。

Added — Phase 3d Mobile-Bridge-Sync 桌面 ↔ Android 双向同步 ​

  • M2: 5 ResourceType walker + tombstones + IPC wire-up（commits 491fb4758 a052e51c0 dd2156ec3 a4fe653f9 9a8e3635d）—— 桌面侧 sync engine 落地：scaffold mobile-bridge-sync provider，drop dead MobileSyncManager；rewrite 5 ResourceType walker（note / conversation / did / community / channel）+ apply 路径；tombstone 触发器 + resource_type 列；mobile.ts 真 provider + IPC wire-up；52 个 mobile sync 测试，过程中找出并修 3 个 prod bug
  • M3 step A→D.5: SocialSyncAdapter wiring + Room cursor + JSON-RPC handlers（commits 28c85dad5 647dc8699 945001502 510f6d2e0 1131e35a2）—— Android 侧：用 dagger.Lazy 解 4 处 Hilt 循环依赖；MESSAGE outgoing path；Room 持久化 SyncRemoteCursor；sync.* JSON-RPC handlers 在 SyncManager 落地；transport wiring + outbound JSON-RPC
  • M4: 设置页 + DeviceManager + 手动配对（commits 0bf5f00b9 17ea9b69d）—— Settings 加 SyncMobile 移动设备同步页面（设备列表 + 同步状态 + 触发 push/pull）；DeviceManager wire-up + 手动 pairing 表单
  • v1.1: SocialSyncWalker for handlePullRpc 实数据 + DID auth 验证 + SyncCoordinator auto-trigger（commits 2d841dfdc 692e3e626 b77e0773b）—— Android 侧 walker 真填 handlePullRpc 不再 stub；sync.* topic 加 DID 签名验证；SyncCoordinator socket 连上后自动 trigger push/pull，不需要 UI 手动点
  • v1.2: 真 Ed25519 签名 + Android gate 4（commits c739d77d0 4ecb7c8ef）—— 桌面侧把 placeholder 签名换成真 @noble/ed25519 签名；Android gate 4 即对端 Ed25519 验签（前 3 gate 在 v1.1 已开），桌面 ↔ Android 4 个 gate 全部 strict-verify

Added — Android 0.37.0（commit 1348636ad，7 件用户可见功能） ​

  • Volcengine SeedASR 语音识别 —— WavRecorder（16kHz mono PCM → WAV）+ VolcengineAsrClient（HTTP submit + 800ms poll）+ HomeStatusViewModel 状态机 + AsrSettingsScreen（x-api-key 入口）+ Recording dialog（pulsing coral mic + breathing ring + mm:ss + 72dp Stop 圆）+ Transcribing dialog（3-dot breathing，跟 splash 一致）
  • APK 自更新（issue #21） —— UpdateChecker（GitHub Releases API，tag prefix android-v，arm64-v8a asset 选择）+ UpdateInstaller（DownloadManager + FileProvider + ACTION_VIEW）+ UpdateDialog（changelog scroll + REQUEST_INSTALL_PACKAGES 权限流）+ Settings "检查更新" 入口带当前 versionName + Application 级 BroadcastReceiver 接 DownloadManager.ACTION_DOWNLOAD_COMPLETE
  • Splash + 主题大改 —— SplashScreen 紫色渐变 + 旋转环 + TT logo + 3-dot + progress + stage；rememberUpdatedState 修 splash race（之前 nextAfterSplash 在 AuthVM load 完之前被 capture 成 stale）；Theme.kt 切 Claude coral palette（#D97757 primary + warm-gray dark + #FAF9F5 bg）；Type.kt 加粗 headlines + 拉宽 body line-height；dynamicColor=false 默认保品牌色（Android 12+ 否则会被 Material You 改色）
  • i18n（issue #16） —— resourceConfigurations 用 zh-rCN / zh-rTW / zh-rHK 显式 qualifier（fix：zh 作 language-only 在 build 时把 values-zh-rCN/ 全过滤掉）；AppCompatDelegate.setApplicationLocales 在 SettingsScreen 接线；MainActivity → AppCompatActivity + Theme.AppCompat.Light.NoActionBar 父主题；locales_config.xml + AppLocalesMetadataHolderService（API <33 兼容）
  • Auth + DID —— AuthRepository.register 幂等回退到 verifyPIN（fix race：AuthVM 异步 DataStore read vs splash navigate 抢跑）；SettingsScreen 生物识别 toggle 接 AuthVM enableBiometric / disableBiometric；新增 KeyManagementScreen（DID + public key hex + clipboard + trusted devices + reset）
  • Home page UX —— LLM 未配置 banner 显示在 BrandSection 上方（点击跳 LLM Settings）；Send-from-home prefill 通路：home → NewConversation route 带 prefill；ConversationViewModel.getDefaultModel() + 自动建会话（prefill 跳过 picker UI）；BrandSection / AboutScreen logo 切 R.mipmap.ic_launcher（TT 品牌）；FunctionEntryCard 12 个硬编码彩色 → 统一 surfaceVariant + 44dp icon chip
  • Launcher icons —— 替换默认 Android 机器人 mipmap-{m,h,xh,xxh,xxxh}dpi/ic_launcher{,_round}.png 为 TT logo（PIL LANCZOS resize）
  • 顺手修的 latent bug：OpenAIAdapter.{chat,chatWithTools,checkAvailability,streamChat} 加 withContext IO + flowOn（之前 block main thread → 12s 主页冻结）；RemoteConnectionManager.invoke{,WithRetry} inline reified <T : Any>；ProcessManagerViewModel.cpuUsage Elvis fallback 改 Double 0.0；SystemMonitorScreen.kt:149 os?.type/version null-safe；256 个 rs_* string stub 自动生成（remote/ui/* 屏 Phase 3d v1.3 work 平行编译需要）

Fixed ​

  • Android sync.* DID auth strict-mode flip + release build unblock（commit 49f1440ca）—— sync.* topic 的 DID 鉴权从可选变强制；release build 之前因 lint baseline 漂移挂的 issue 一并修
  • 2 个 mobile-ipc 测试 stale after M4.5（commit d34de0ac0）—— DeviceManager wire-up 改了 IPC shape，把测试同步对齐
  • 官网移动端 hamburger 菜单（commit 0bb62675d）—— SiteHeader.astro 在小屏下 nav 列表撑满整行无折叠，加 <button> toggle + tailwind md:hidden
  • logo 资产送 docs+design 站 + www 文档跳链 retarget（commit 61b8cd642）—— 之前 docs/design 站 hero 引 /logo.png 但仓库里没有；www 部分 footer 链接还指着旧 docs 路径
  • E2E preload 真错暴露 + force V5/V6 mode + app-config.json 早写（commits 076474208 1f61a18bf fc9cacc48）—— preload 失败时 throw window snapshot 不再 catch+continue 吞信号；E2E 强制 V5/V6 模式让 preload bridge 真加载；测试启动前先 writeFileSync app-config.json useWebShellExperimental:false，绕过 Phase 1.6 hard-flip

CI ​

  • drop e2e-tests workflow continue-on-error: true（commit e807d576c）—— 之前 JOB 级 continue-on-error 让 3/3 OS 失败显示 success，"No team IPC interface found" 沉了几周
  • e2e-tests workflow 加 npm cache + Playwright browsers cache（commit 9460f05da）—— actions/cache@v4 缓存 ~/.npm 和 ~/Library/Caches/ms-playwright / %LOCALAPPDATA%\ms-playwright，单 OS 跑时间预期从 ~14m 降到 ~6-8m

Android ​

  • versionCode 36 → 37, versionName 0.36.0 → 0.37.0 —— minor bump 反映 7 件用户可见功能 + Phase 3d 双向同步落地

Tests ​

  • 桌面 mobile sync 52 测试全绿（M2 step 8）
  • Android Phase 3d v1.1/v1.2 sync 测试全绿（gates 1-4 完整）
  • mobile-ipc 12/12 绿（M4.5 wire-up 后）

NPM ​

  • chainlesschain 保持 0.161.7（CLI 自 v5.0.3.45 无源码改动）

Distribution ​

  • 桌面 binary 重新打过；auto-updater 比对 5.0.3-alpha.46 > 5.0.3-alpha.45，所有 v5.0.3.45 桌面用户重启会真发现新版
  • Android APK 走新 android-v0.37.0 tag 发布（用户可在 Settings → 检查更新 看到）
  • 三大文档站本次同步刷新：tagline 升 v5.0.3.46 + 新增本节 changelog + 设计文档对齐

[5.0.3.45 / CLI 0.161.7] - 2026-05-09 (cc ui llm.chat parity + 意图理解 opt-in 开关 + 真流式 + Vue Proxy reactivity 修复) ​

cc ui 终于跟桌面 web-shell 在 LLM 路径上对齐；项目/文件模式聊天默认不再走"理解中…"占位 LLM 调用；chatStream 改为真正的 token-by-token 流式；意图卡片 Vue Proxy 引用 bug 修复让占位卡正确翻面。

Added ​

  • cc ui llm.chat WS topic（commit f41c4b4e2） —— 桌面 web-shell 自 4eaf90137（Phase 2）就有这个 topic，但 cc ui（CLI 的 ws-server）从未注册过。结果：QuickAsk 页面在 cc ui 模式下永远卡 60 秒后报 Stream idle timeout。新增 packages/cli/src/gateways/ws/llm-chat-protocol.js，handler 复用 chat-core 的 streamOllama / streamOpenAI / streamAnthropic，按 <topic>.chunk + <topic>.result 的 frame 协议跟桌面 llm-handlers.js 完全对齐。
  • 共享 cred 解析（commit f41c4b4e2） —— 新增 packages/cli/src/gateways/ws/llm-creds.js：explicit options → WS session creds → provider 环境变量（VOLCENGINE_API_KEY / OPENAI_API_KEY 等）；任何源没拿到都立即返回 ok:false 帧，不再 60 秒挂死。chat-intent-protocol 同步切到这个 helper，顺手修一个 latent bug：原代码 session.baseUrl || "http://localhost:11434" 在 session 没设 baseUrl 时硬编码到 ollama 地址，所有云 provider 在用户本地没起 ollama 时都会跑死。
  • 意图理解可见开关（commit f41c4b4e2） —— Chat / Agent 项目/文件模式 header 加 <a-switch>，默认关闭。原行为：v5.0.3.43 起每条消息先调 LLM 提炼意图（chat.intent.understand-stream），再走真发送 —— LLM 慢/无 cred 时占位卡 90 秒；现在默认直发，需要意图卡片的用户手动打开开关（持久化到 localStorage cc.web-panel.chat.intentEnabled）。submitUserInput 第一行短路：if (mode === 'global' || !intentEnabled.value) { sendMessage; return }。桌面壳同享这个 SPA bundle，所以桌面也跟 cc ui 行为一致。

Fixed ​

  • chatStream 真正的 token 流式（commit 35f6e60ea） —— packages/cli/src/lib/chat-core.js 的 chatStream 原本是 buffer 全部 token 后再循环 yield 的伪流式 —— 消费者要等到 LLM 整个回完才看到第一帧。改为 token queue + Promise waiter 模式：onToken push 后立刻 wake generator yield。Chat / Agent / QuickAsk / 意图理解 全部受益。
  • 意图占位卡片 Vue Proxy reactivity 修复（commit a76e451e2） —— submitUserInput 创建 placeholder 后 push 进 reactive messages[sessionId] 会被 wrap 成 Proxy，但本地变量 ref 仍指向 unwrap 之前的 target；后续 placeholder.metadata.X 直接改原对象绕过 Proxy set trap → 数据更新但不触发重渲染。修法：card = msgs[msgs.length - 1] push 后重新取 Proxy 引用，所有后续 mutation 走 card.metadata.X。

Tests ​

  • CLI ws gateway 16/16 绿（chat-intent 6 + 新 llm-chat 9 + 新增"无 cred 不调 LLM"环境清理 1）
  • web-panel chat-intent-flow 27/27 绿

NPM ​

  • chainlesschain 0.161.5 → 0.161.6 → 0.161.7（0.161.6 已先于 productVersion 单独 publish 修复 QuickAsk + Chat 项目模式 hang；0.161.7 带 chatStream 真流式 + 意图卡片 Vue Proxy 修复）

[5.0.3.44 / CLI 0.161.5] - 2026-05-08 (LLM OCR + audit-ipc 覆盖 + chat-intent 90s 兜底) ​

一条 user-visible feature（截图 LLM OCR）+ 三条质量收口。无破坏性变化，所有 v5.0.3.43 用户可直接 upgrade。

Added ​

  • 截图 OCR 新增 LLM 引擎（commit 39b16e29f） —— Tesseract.js 中文识别准确度差，新增 engine 参数 auto/llm/tesseract 三态：
    • auto（默认）：火山引擎已配置走 doubao 视觉 OCR，否则回落 Tesseract；LLM 出错带 fallbackFrom / fallbackReason 标签自动降级
    • llm：强制视觉 LLM（当前 volcengine doubao-1.5-vision-pro，userBudget=medium），无 llmManager / 非 vision provider 时显式报错
    • tesseract：强制本地 Tesseract.js
    • V5 / V6 共享 dialog + web-panel dialog 各加一个 <a-select> engine 选择 + 蓝/灰/橙三色 tag 显示已用引擎。Engine guards 放在 recognizeDispatch 便于测试 stub 替换 impl 不重复验证逻辑；Provider 白名单 Set(["volcengine"])，扩展到 gemini / openai / anthropic 只需各自 LLMManager 暴露 chatWithImage* 后加一个集合项

Fixed ​

  • chat intent understand 90s wall-clock 兜底（commit 6cbd04c50） —— sendStream 自带的 60s idle timer 在每个 chunk 上 rearm，慢 LLM 一直 dribble token 但永远不出 final frame 时"理解中…"占位卡会无限转。包一层 AbortController + setTimeout(90s) 把 signal 传进 stream 调用，超时后清理 placeholder 并给可读错误。
  • compliance-ipc 死 handler 清理（commit 29006decf） —— compliance-ipc.js 之前注册了两个 typo 前缀 channel compliance-classify:generate-report / compliance-classify:get-policies 无人调用；renderer 真正调用的 compliance:generate-report / compliance:get-policies 由 audit-ipc.js 拥有，背后是 ComplianceManager。两边背后还接的是不同 service（soc2Compliance.generateReport vs auditManager.complianceManager.generateReport），保留死路径只会让后续改真路径时漏改 → 直接删 + 同步删 IPC_CHANNELS 中两个 typo 项。
  • macOS 临时目录路径断言修复（commit bb2c16656） —— build-win-with-deref.test.js（虽然测的是 Windows 构建符号链接，macOS Unit Tests 矩阵也跑）3 个断言炸 expected '/private/var/folders/...' to be '/var/folders/...'：macOS 的 /var → /private/var symlink，os.tmpdir() 返回 /var/... 但 realpath 路径不一样。canonical = fs.realpathSync(os.tmpdir()) 把测试临时目录都规范化掉，linux / win 上 realpath 恒等无 regression。

Tests ​

  • audit-ipc.js 首次单测覆盖（commit b092673be） —— 之前零覆盖的盲点，被 29006decf typo 死 handler bug 拽出来。audit-ipc.js 拥有 18 个 channel 含 renderer-facing 的 compliance:get-policies / compliance:generate-report，没有单测就让 compliance-ipc.js 里的 typo duplicate 静悄悄活了几个月。源码 DI 改造（与 credit-ipc 模式一致）：accept ipcMain via deps with electron fallback，lazy-required 让 injection 可以抢先；新增 23 个 case 覆盖 18 channel 路由 + happy-path payload + AuditManager 异常路径。
套通过
desktop 单测1477 / 1477
CLI unit17,455 / 17,455

Notes ​

  • CLI npm 包同步发布 chainlesschain@0.161.5（v5.0.3.43 末已 bump 0.161.4 → 0.161.5）。
  • 桌面 binary 重新打过；auto-updater 比对 5.0.3-alpha.44 > 5.0.3-alpha.43，所有 v5.0.3.43 桌面用户重启会真发现新版。

[5.0.3.43 / CLI 0.161.4] - 2026-05-07 (MTC publisher_signature M-of-N 修正 + 安全硬化级联) ​

Fixed ​

  • MTC landmark.publisher_signature strip-all-sigs 对称化（commit c23e98cca + 文档 038e6d710） —— Producer 与 verifier 必须对称地把 _stripSigsForPublisher(landmark)（清零 publisher_signature.sig + 每个 snapshot 的 signature.sig + signatures[*].sig）喂给 JCS 后再签 / 验，而不是只清零 publisher_signature.sig。否则只要篡改 M-of-N 联邦中任何一个成员的 per-member sig，publisher_signature 就会被打断，直接绕过 M-of-N 阈值的存在意义。Helper 抽到 packages/core-mtc/lib/publisher-signing.js，导出为 @chainlesschain/core-mtc/publisher-signing 子路径。三处调用点：batch.js（单签 + 联邦）、landmark-cache.js 验证侧、桌面 governance-multisig.js（lazy-require 绕 @noble/curves hoisting trap）。规范文档 §8.2 同步更新。Canary：mtc-federation-publish-cli.test.js "2-of-3 threshold accepts when one member's sig is tampered" — 任何修改 publisher-sig 路径都必须跑全部 mtc-federation* 集成。
  • LandmarkCache landmark.publisher_signature 验证启用（commit c40d927da + 72c3619ee） —— LandmarkCache 默认 opt-in verifyPublisherSignature: true 对 cache 命中前增加发布者签名校验（不再无脑相信 cache）；real-verifier callers（CLI cc mtc verify + 桌面 audit pipeline + cross-chain bridge 校验侧）全线启用。常量 BAD_PUBLISHER_SIG 重命名为 BAD_LANDMARK_SIG（36fcd8f4f）以匹配规范 §11；spec §8.5 文档跟进 LANDMARK_SIG_PREFIX 定义（8e459cfd5）。

Security ​

  • HIGH 44 → 0 / MOD 4 → 0 / LOW 45 → 0 安全硬化级联（多 commit） —— 一周内分 8 次清空全部 npm audit 警报：
    • f6c937fa8 override transitive serialize-javascript + tar（HIGH 44 → 10）
    • 8a56978b5 干掉无人维护的 speedtest-net，改用 native fetch 实现网速测试（HIGH 10 → 7）
    • 9c7ce00e7 override semver 到 ^7.7.4（清掉 imap 链 HIGH 7 → 4）
    • 922b64822 override undici 到 ^6.21.2（清掉 hardhat 5.x 链 HIGH 4 → 3）
    • 4fae47dd4 deprecate werift（清空残余 HIGH 3 → 0）
    • cc7b0b40a override ip-address + dompurify（MOD 4 → 0）
    • 1f86594a2 override tmp 到 ^0.2.5（LOW 45 → 40）
    • 64047283a override make-fetch-happen 到 ^13（LOW 40 → 14）
    • d19bcb8cb 拆 hardhat-stack 到独立 contracts/ workspace + drop 不再依赖的 hdkey（LOW 14 → 0）
  • channel-manager DDL 加固 + drop 未用的 jspdf（commit d558b66b1，1 critical） —— 修一处 DDL 注入面 + 删未用依赖减少攻击面。
  • wrtc-compat ip.isPublic 补丁 CVE-2024-29415（commit 7312cf035） —— ip package SSRF 漏洞绕过补丁。

Added ​

  • Updater 渲染端进度通知（commit 4c1a5ac18 + e27592bb5） —— notifier-only flow，关闭重复的 native dialog，渲染端实时显示下载进度。

Fixed (post-release follow-ups, 2026-05-08) ​

源码级 follow-ups，源自 551ef28b3 "fix(ipc): correct ipcGuard API" 那次 sweep 不彻底，留下两类互补 bug。两个 commit 都是源码 / 测试同步问题，不影响 v5.0.3.43 桌面 binary 的业务功能（handlers 仍正常注册），下次发版自动滚入。

CommitBug为什么之前没炸测试
af92e0162 fix(test): align nostr-bridge-ipc stub源码用 ipcGuard.markModuleRegistered(name) 直调（real guard 有此 fn），但 test stub 仍 mock 不存在的 registerModule(name, channels) 二参 → stub 调时 TypeError: ipcGuard.markModuleRegistered is not a function，23 / 389 social 用例炸CI "Unit Tests" stable-fallback 排除 **/*-ipc.test.js；"Full Test Suite" 用 continue-on-error: true23 / 23 ✅
11247a957 fix(ipc): align 8 ai-engine IPC modules8 个 IPC 模块（autonomous-developer / collaboration-governance / tech-learning / federation-hardening / reputation-optimizer / sla / stress-test / inference）反过来 —— 源码 if (ipcGuard.registerModule) { ipcGuard.registerModule(name, CHANNELS); }，real guard 没 registerModule → if 永远 falsy → guard 内部 registeredModules Set 漏跟踪这 8 个模块。Handlers 走 ipcMain.handle 仍真正注册，业务功能正常，只是 guard tracker 漏 8 个模块测试 stub 自己 mock 了 registerModule → 测试假绿邻近 29 文件 577/577 ✅

修法：stub registerModule → markModuleRegistered + 断言去 channels 参（test 侧）；if (ipcGuard.registerModule) { ipcGuard.registerModule(name, CHANNELS); } → ipcGuard.markModuleRegistered(name)，同时去掉同样无意义的 if (ipcGuard.unregisterModule) wrap（源码侧）。CI 漏检的两类（fallback 排除 *-ipc.test.js + Full Suite continue-on-error: true）作为单独 follow-up，不在本 commit 范围。

Maintenance (post-release follow-ups, 2026-05-08 evening) ​

当晚晚些时候继续清理。其中 cf77aea8d 直接关掉上一段 explicit 留的"CI 漏检两类"follow-up；其余三条是顺手清出的 V5 opt-out 死代码 + 必走的 CLI 版本 bump + 一个 web-panel 404 bundle 修。这一批同样不影响 v5.0.3.43 桌面 binary 的业务功能，下次发版自动滚入。

Commit内容
1cb6576b9 chore(web-panel): refresh built asset hashescommitted 的 index.html 引用 index-Cf0pZvjB.js，但该 bundle 已被新 build 覆盖；workspace 实际用 index-Cs70ksHC.js —— main 上 web-panel 在加载 404 bundle。同步两处 dist (packages/web-panel/dist/ + packages/cli/src/assets/web-panel/)
cf77aea8d fix(ci): close test.yml two coverage holes(1) Unit Tests stable-fallback 删掉 **/*-ipc.test.js catch-all（40 个 IPC 文件本地 39 pass + 1 skip / 1476 用例）；(2) Full Test Suite "Run all unit tests" 删掉 continue-on-error: true（coverage step 保留）。drive-by：compliance-ipc.test.js 3 个 fail align 到源里实际注册的 compliance-classify:* typo 前缀（dead handler 独立 bug 后续 commit 再处理）
539463b85 refactor(ui): drop dead chat-panel state + stale V5 page references5066a778d 删了 V5 ChatPanel 容器，但 app.ts chatPanelVisible field、AppHeader 聊天 toggle、VoiceCommandHandler 打开/关闭聊天 + 未识别语音 fall-through 派发到聊天的分支全成 cosmetic no-op。同时清 4 个 plugin.json description + communityQuick.ts header 引用已删 V5 页面的 stale 字符串。−50 行净瘦身
a9b85f5ba test(ui): drop chatPanelVisible default-state assertion in app.test.js539463b85 漏改第二个 store 测试 tests/unit/stores/app.test.js（之前 .ts 镜像 src/renderer/stores/__tests__/app.test.ts 改了，.js 这个 broke）。pre-commit prettier 顺手 reformat 整文件单引号→双引号
c61de71eb chore(cli): bump 0.161.4 → 0.161.5af92e0162 + 11247a957 改了 CLI 源但没 bump 版本号 → 下次发版 cli-tests 会被 SHOULD_TEST=false 跳过（rule: github_release_pipeline_constraints.md #5）。drive-by：package-lock.json 之前 v5.0.3.42 release 时 .161.3 → .161.4 漂移没修，一并对齐到 .161.5

Notes ​

  • 测试结果：desktop 单测 1454 / 1454 ✅，CLI mtc-federation 集成 41 / 41 ✅，core-mtc 单测全绿。
  • 本版本同时是大幅安全 / 加密路径硬化版本，不含新增 P2P / chat-panel feature；用户可放心 upgrade。

[5.0.3.42 / CLI 0.161.4] - 2026-05-07 (CLI 0.161.3 → 0.161.4 chat-intent 同步) ​

Changed ​

  • CLI 包 chainlesschain 0.161.3 → 0.161.4 atomic bump（commit a555b6760） —— v5.0.3.41 ship 了 chat-panel-v5 三壳对齐里的 chat-intent 路由代码，但 CLI package.json.version 没动，cli-tests 在 release 流程的 precheck 阶段判 SHOULD_TEST=false（chainlesschain@0.161.3 已在 npm registry → 跳过测试），导致后续 v5.0.3.43 publisher_signature 修补的真实回归差点没被拦住。本版本明示 atomic bump CLI 0.161.4 + 安装包同步发布，触发 cli-tests 强制运行，未来如果发现 CLI source 改动但 release pipeline 跳测 cli-tests，请优先检查 git diff <prev-tag>..HEAD -- packages/cli/src/ 是否非空 + 同步 bump CLI version。

Notes ​

  • 本版本无功能变化，仅修 release pipeline 测试覆盖问题。

[5.0.3.41 / CLI 0.161.3] - 2026-05-07 (chat-panel-v5 双壳对齐 + B4 social 滚动收口) ​

Added ​

  • chat-panel-v5 V6 AIChatPanel 对齐（commit b33527d31，Phase E）—— 把 V5 ChatPanel 的 4 个核心特性反向对齐到 V6 默认壳的 AIChatPanel：流式响应 + 历史会话切换 + 上下文记忆引用 + 工具调用面板。从此 V5 / V6 / web-shell 三壳的聊天体验严格对等，没有"V6 缺特性所以回退 V5"的回退路径。
  • chat-panel-v5 web-shell 端口 v1+v1.1（commit 72b13388a）—— V5 ChatPanel 的全部 router 协议、autoSendMessage 信号、virtual list 与 5 intent / 6 IPC 在 web-shell 默认壳走 WS topic 接通。配合上一条，默认壳 web-panel 用户不再看不见任何聊天能力。

Fixed ​

  • web-panel 单测 views-mount-smoke.test.js 在 63 文件并行套件下 first-import 撞 30s timeout（本版）—— Pipeline.vue + Chat.vue 在 4-fork 池 + 全量 SFC transform 竞争下，首个加载它们的 fork 会撞默认 testTimeout。fix：file-level vi.setConfig({ testTimeout: 60_000 })，全局 timeout 不动（已验证全局升 60s 反让 worker pool 调度恶化导致更多 file 超时）。同 cli_ci_sharding_lessons 记录的 vitest 4 严格 timeout 模式。

Notes ​

  • 本版本同时 ship 了之前 4 个 "5.0.3.40 续" 滚动条目里全部内容：B4-cred-persist + B4-auto-archive（XVII / XVIII），B4-mofn-sign v2 + B4-webpanel v1，B4-merkle channel envelope finality，社区/频道跨机同步 Phase A + B4 + Web Shell Phase 3c.7。productVersion 这次正式 .40 → .41，安装包/auto-updater 会发现新版本。
  • 测试结果：desktop 单测 1454 / 1454 (4 skipped) ✅，CLI mtc-federation 集成 41 / 41 ✅，web-panel 单测 1853 / 1853 ✅，web-panel e2e 63 / 63 ✅。

[5.0.3.40 续 / CLI 0.161.3] - 2026-05-07 (B4 social audit-grade closure: cred-persist + auto-archive) ​

Added ​

  • B4-cred-persist v1 — WebDAV 凭据走 secure-config + 修一个潜伏 ~1 个月的字段名 bug（commit 8e8e5a1b9）—— §2.2.21 (XIV) 接好 Archive Tab 后让用户每次推归档都手输 baseUrl/username/password 走 wire（凭据原则违反 + 真去用 WebDAV archive 立刻撞 "url 必填"——构造器读 url/remotePath 但工厂从 §2.2.16 起一直传 baseUrl/remoteRoot，字段名根本对不上）。本节同时解决两个问题：(1) 抽 archive-provider-factory 到独立模块（src/main/mtc/archive-provider-factory.js +90，DI 注入可单测），加 useStoredCredentials:true 模式——main 从 Phase 3c 已落的 sync-credentials secure-config.enc（safeStorage / AES-256-GCM）解密构造 WebDAVClient；(2) 字段名 baseUrl/remoteRoot → url/remotePath 修正，加测试锁定 (expect(captured).not.toHaveProperty('baseUrl'))。新 1 IPC + 1 WS topic *.has-stored-webdav-credentials（只回 boolean，凭据永不外泄）+ MtcAudit.vue Archive Tab 重做：toggle 默认 ON 时不显示输入框，vault 空时 disable + 引导去 Settings → 同步 → WebDAV。安全不变量：useStoredCredentials=true 时 inline url/username/password 完全忽略（vault wins，防 spec-injection）；响应 schema 单元锁死 expect(Object.keys(r).sort()).toEqual(['hasCredentials','success'])。测试：desktop +10（archive-provider-factory 12 新文件 + community-mtc-handlers +4），web-panel +4 useMtcArchive。

  • B4-auto-archive v1 — 主进程定时归档 cron + MtcAudit 第 5 个 Tab（commit edfe4ade5）—— XVII 修了凭据持久化让推送不再需要每次输密码，本节继续把 cron 跑起来：主进程 setInterval 周期触发 ChannelEnvelopeArchiver.push，配置写到 app-config.json 的 mtc.autoArchive namespace（enabled / intervalMs / providerSpec / communityIds + lastRunAt/Status/Error/Summary），enabled=true 的旧配置在主进程 boot 后自动接续。新模块 src/main/mtc/auto-archive-scheduler.js (+250) 是纯 Node（无 Electron API，timers DI 可单测）。3 个 IPC + 3 个 WS topic：auto-archive:{config-get,config-set,run-now} 和 mtc.auto-archive.{config-get,config-set,run-now}。MtcAudit.vue 第 5 个 Tab："启用定时归档" Switch + intervalHours InputNumber（最小 0.083h = 5min）+ provider 切换 + 复用 §XVII useStoredCredentials toggle + community 白名单 Textarea + 立即归档 + 持久化配置 + lastRun 状态卡。鲁棒性不变量：intervalMs ≥ 5min（防误配 ms-DoS）/ enabled=true 强制要求 providerSpec（拒绝保存）/ runOnce 内置 _running 守卫（多 fire 不重入返回 {skipped:true}）/ per-community try/catch（单点失败仅记 lastRunStatus='partial'，不阻断后续 community）/ providerSpec.useStoredCredentials 走 §2.2.23 vault 路径（cron 配置不写明文密码）。测试：desktop +24（auto-archive-scheduler 19 新文件 + community-mtc-handlers +5），web-panel +9 useAutoArchive。

Notes ​

  • §2.2.10 → §2.2.24 这 15 节涵盖 P2P 社交从"消息可信 + 自动联网" → "envelope 跨机" → "trust 校验" → "UI 可见" → "外部归档（活的）" → "M-of-N 多签" → "跨联邦信任" → "默认壳全套" → "凭据加密复用" → "周期自动归档" 的完整 audit-grade 闭环。私钥 / 密码均不过线，UI 默认壳全套可见。
  • 设计文档 docs/design/modules/02_去中心化社交模块.md 在前序 commit 已加 §2.2.22（B4-mofn-sign v2）+ §2.2.23（B4-cred-persist）+ §2.2.24（B4-auto-archive），三大文档站本次同步刷新。

[5.0.3.40 续 / CLI 0.161.3] - 2026-05-07 (B4-mofn-sign v2 + B4-webpanel UI) ​

Added ​

  • B4-mofn-sign v2 — sign-as-self（私钥永不离 main）+ 顺手修一个潜伏 ~1 个月的 IPC bag bug（commit 5c0374e88）—— B4-webpanel UI 落地后想点"代我签名"按钮时撞墙：v1 协议要求渲染端把 64 字节 secretKey base64 后塞进 wire；web-panel 显式不持私钥（这是安全决策）所以按钮不可实现。本节把签名搬进主进程：渲染端只发 (communityId, proposalId)，main 通过 DIDManager.getCurrentIdentity() 取本人当前身份代签——私钥永不离开主进程。新 IPC governance-mofn:sign-as-self + WS topic mtc.governance-mofn.sign-as-self。顺手修了 registerAllIPC 的依赖包从 §2.2.10 Phase A 起就漏传 12 个 manager（communityManager / channelManager / gossipProtocol / governanceEngine / contentModerator / mtcFederationManager + B4 全套），phase-3-4-social 拿到的全是 null，桌面 V5/V6 的社区 IPC 全程返回空数组或 "not initialized"——Phase 1.6 hard-flip 默认壳走 web-shell，没人发现。本次结构性补齐。安全模型对比：v1 渲染端持密码 / 走 wire vs v2 都不持 / 不走 wire。测试：desktop +6（community-mtc-handlers）+ web-panel +4 useGovernanceMofn。

  • B4-webpanel v1 — web-panel UI 接全套 13 个 WS topic（commit 4bc9d5651）—— §2.2.20 (B4-webshell) 已把 IPC → WS 桥接铺好，但 web-panel 没 UI 入口。本节加 4 个 composable（useMtcEnvelope / useMtcArchive / useGovernanceMofn / useCrossFedTrust）+ 1 个 4-tab 页面 MtcAudit.vue：envelope 查询 / archive 推恢列 / governance M-of-N 提案 / cross-fed-trust 跨联邦信任锚——全部接到默认壳的 sidebar 上，桌面 V5/V6 用户和默认壳用户看到的功能严格对等。

[5.0.3.40 续 / CLI 0.161.3] - 2026-05-07 (B4-merkle channel envelope finality) ​

Added ​

  • B4-merkle v1 channel 事件 Merkle 批 envelope finality（在 B4 DID 签名 + auto peer bridging 之后）—— 本机发出的每条 channel 消息进离线可验的 Merkle 批 envelope，组合 B4a 签名得"任何第三方都能验证我在 X 时间向 Y 频道发了 Z"。新模块 desktop-app-vue/src/main/mtc/channel-event-batch.js (+390)：累积到 <userData>/channel-mtc/<communityId>/staging/<message-id>.json → 按 threshold(默认 100) 或 timer(默认 1h) 触发 closeBatch → 写 batches/<batch-id>/{manifest,landmark,envelope-*}.json (atomic rename + crash rollback)。social-initializer 注册 channelEventBatcher initializer（autoTimer 启 1h closer），community-ipc.channel:send-message 在三件双发后 enqueue，新 IPC channel:get-message-envelope(communityId, messageId) 返回 inclusion proof + landmark 给 renderer / 外部 verifier。tweetnacl-based MTC signer + 自家 _assembleBatchLocal 用 core-mtc subpath primitives (/hash /jcs /merkle /constants) 绕开 @noble/curves@^1 vs @2.2.0 subpath 删除导致 core-mtc index 加载失败的 hoisting trap。输出 landmark/envelope wire-compatible，对端可用 cc mtc verify 验证。总测试：891 → 969（27 文件全绿），新增 31 用例（channel-event-batch 23 unit + community-ipc-merkle-enqueue 8 integration）。out/build/ChainlessChain-Setup-5.0.3-alpha.40.exe 含全套已 rebuild（426 MB，exit 0）。

Notes ​

  • B4-merkle v1 是 local-only：本机发出去的 envelope 落本机盘；远端没你的 batch dir 就查不到。Cross-machine envelope 分发是 follow-up sub-phase（federation channel publish landmark + on-demand pull envelopes）。
  • 设计文档新增 §2.2.13（数据流 + 文件布局 + tweetnacl signer 解释 + @noble/curves 跨版本 subpath 陷阱实战）。
  • 这是当前 v5.0.3.40 滚动周期的第二批：第一批是社区跨机同步 Phase A + B v1 + B4 + Phase 3c.7。

[5.0.3.40 续 / CLI 0.161.3] - 2026-05-07 (社区/频道跨机同步 Phase A + B4 + Web Shell Phase 3c.7) ​

Added ​

  • 社区/频道：跨机器同步真正打通（commits 50b8ddb05 + 3741a8e7e）—— v5.0.3.40 之前社区 UI 完整可用但只在单机生效：A 在频道发的消息到不了 B 的本地数据库。Phase A 系统性修了 7 个底层 bug：libp2p 3.x stream API（stream.write → stream.send / stream.source → for await of stream）、registerMessageHandler 在 P2PManager.initialize 漏调、收包后没按 type 派发（新增 decodeWireMessage + dispatchTypedMessage）、gossipProtocol.message:received 一直没人订阅（新 gossipReceiver 在 social-initializer 接到 channelManager.handleMessageReceived）。Phase B v1 在 Phase A 直发 gossip 之上叠 MTC federation gossipsub 作为"审计级"双轨，channel:send-message / community:join 双发布双订阅、INSERT OR IGNORE 幂等。B4 DID 签名补完：每条 channel_message 现在带 sender_pubkey + Ed25519 detached signature；接收侧三重校验（DID ↔ pubkey、签名验真、shape 合法），关闭 sender_did free-text 冒名缝隙；signature / pubkey 通过 PRAGMA-based ALTER 加列，向后兼容。B4 自动 peer 桥接：libp2p peer:connected 双向广播 mtc:advertise envelope，对端按收到的 multiaddrs 顺序 mtcFedMgr.connectPeer 直至首发命中；非阻塞，Phase A 直发通道始终优先。总测试：149 → 891（22 个 p2p+social+mtc 文件全绿），新增 47 个 B4 用例（did-signer 22 + p2p-manager-dispatch +2 + channel-manager-signing 8 + mtc-auto-bridge 15）。
  • Web Shell Phase 3c.7：截图识别 + 通知设置 + 托盘路由收口（commit 200078947）—— Phase 3c.6 已落 NotificationBell + ClipboardImportDialog + SyncSettings + Search.vue，但 web-panel App.vue 的 routeTrayAction 还写死 "暂未接入 / 即将推出 / 暂无对应页面" toast，从托盘点进来全是死提示。本次：
    • screenshot-handlers.js 新增 3 个 WS topic（capture / ocr / cleanup）封装 _internal.isInsideTmpDir gate（防 path-traversal）；useScreenshot composable + ScreenshotImportDialog.vue port V5；pure-browser 模式自动 unsupported:true。
    • notification-settings-handlers.js 新增 2 个 WS topic（get / update）桥接 appConfig.notifications.{enabled,sound,badge,desktop} 子树；useNotificationSettings + NotificationSettings.vue 与 V5 SystemSettings 第 277-305 行同形。
    • 托盘 5 个 quick-action（global-search / clipboard-import / show-notifications / screenshot-ocr / open-settings#notifications）全部接到真路由；Notes.vue 监听 ?clipboardImport= / ?screenshotOcr= query 自动开 dialog；NotificationBell.vue mount/unmount cc:open-notification-drawer window event。
    • 测试 26 cases：截图 15（capture/ocr/cleanup envelope + path-traversal reject）+ 通知设置 11（DEFAULTS fallback / patch coercion / 拒绝 null settings）。
  • Plugin Marketplace 部署脚本骨架（commit a62fd8b81）—— docker-compose.yml 加 marketplace services（postgres/redis 复用 db=2、独立 MinIO、db-init 一次性、Spring 容器）；deploy/init-marketplace-db.sh 幂等 CREATE DATABASE + schema bootstrap；deploy/PLUGIN_MARKETPLACE_DEPLOY.md end-to-end BT Panel SSL 部署指南；deploy/nginx/chainlesschain.conf 加 plugins.chainlesschain.com vhost；deploy/fix-bt-nginx-marketplace.sh BT Panel nginx 修复脚本。生产实际是 standalone 部署到 47.111.5.128（该机无 chainlesschain repo），这些是未来 from-repo 部署的参考。

Fixed ​

  • Dashboard bundled-skill 发现 + JSON-based stat 解析（commit 3881b9603）—— skill 数 / 桌面统计在仪表盘上的展示口径修正，bundled-skill 列表能正确发现，stats 走 JSON 解析不再走 fragile string parse。

Notes ​

  • 本次 5 个 commit 互不依赖、互不冲突，仍属 v5.0.3.40 滚动更新（productVersion 未升）：B4 social 签名 + 自动 MTC 桥接是 Phase B 的真功能补完，社区跨机同步在 .40 之前 UI 已可见但实际不通；Phase 3c.7 是 Web Shell 默认壳路径上托盘 → 页面联动的真接线（之前 5 处死提示）。三大文档站本次同步刷新即对齐。
  • 设计文档 docs/design/modules/02_去中心化社交模块.md 新增 §2.2.10（Phase A 跨机同步实战架构 + 7 个底层 bug 列表 + 端到端数据流图）和 §2.2.11（B4 DID 签名 + auto MTC peer bridging），用户文档 docs-site/docs/chainlesschain/social.md 在「社区/频道功能」段加 tip 提示，官网 docs-website-v2/src/pages/index.astro 三大场景 bullet 加上「社区 / 频道 gossip 跨机同步（v5.0.3.40+）」。

[5.0.3.40 / CLI 0.161.3] - 2026-05-07 (MTC 视图 in-process 提速 + CI 三发解锁) ​

Fixed ​

  • MTC 视图 onMounted 三发并发必爆 timeout（asar 冷启动级联）—— v5.0.3.39 切到 asar:true 后 cc 子进程冷启动从 dev 的 ~2.5s 涨到打包后 6-10s（asar header 走查 + Node module resolve 多一层虚拟 fs），Mtc.vue 的 loadStatus + loadBridgeStatus + loadBridgeSla 三发并发必撞 8s/6s 上限（用户截图 "状态加载失败: Request timeout" + "加载桥 MTC 状态失败: Request timeout"）。修法：新增 3 个 in-process WS topic（mtc.audit-status / mtc.bridge-status / mtc.bridge-sla）直查 audit-mtc / cross-chain-mtc lib（纯文件读，无 SQLite，无 spawn，零 asar 开销）；Mtc.vue 通过 useShellMode().isEmbedded 双路径分叉，embedded 走新 topic，浏览器 / cc serve 仍走旧 ws.execute。同时把保底 timeout 从 8000/6000 提到 30000 ms（与 executeJson 默认对齐）。顺手修了 standalone 路径一个 pre-existing shape mismatch（lib 返回扁平字段，SPA 期望 obj.config.* 包装）—— 仅 embedded 路径生效，standalone 维持原状（独立 follow-up）。配 7 + 1 新单测。
  • macOS unit fallback 上 7 个 build-win-with-deref 测试（commit 25d834958）—— desktop-app-vue/scripts/build-win-with-deref.js 的 isSymlink 之前用 realpathSync 比较，但 macOS os.tmpdir() 路径含 /var → /private/var 的隐式 symlink，所有 tmp 子目录都被误判为 symlink → 7 测试 fail。改成 platform split：Win 仍用 realpath（junction 需要），POSIX 用 lstat.isSymbolicLink()（POSIX 没有 junction 概念，lstat 可靠）。
  • rules-validator SQL_INJECTION 在测试 fixture 上误报（同 commit）—— desktop-app-vue/src/main/sync/__tests__/sync-external-store.test.js:32 是 TestDbManager.exec(sql) 的 sql.js 测试 fixture passthrough，被规则验证器 v2 当成 db.exec() 高危调用报红。getAllFiles 现在跳过 __tests__/ / __mocks__/ 目录 + .test.js / .spec.js / .d.ts 文件。生产代码扫描不变；75 条警告仍属 advisory。
  • CLI subprocess cold-start ETIMEDOUT on Windows（同 commit）—— packages/cli/__tests__/unit/skill.test.js（12 处 @ 15s）+ agent-repl.test.js（3 处 @ 10s）调 node bin/chainlesschain.js …。ESM module-graph cold-start 在繁忙 Windows 主机真的需要 >10s（vitest 的 60s testTimeout 包不住，per-call execSync timeout 才是真天花板）。所有 CLI subprocess 调用 timeout 统一升到 60s（与项目 testTimeout 对齐）；passes 仍 1.7-2.5s 完成，只有真 fail 才会跑满。

Tests ​

套通过文件Duration
Desktop unit + stores10482 / 10482 (689 skipped)3201022s
MTC handler in-process 新增7 / 713.4s
web-panel mtc-parser 新增14 / 1411.1s
CLI unit17392 / 17392 (7 skipped)412458s
CLI integration821 / 82156198s
CLI e2eTBDTBDTBD
小计28716 + e2e790+~28 min

Notes ​

  • 桌面有运行时改动：web-shell-bootstrap.js 注册 3 个新 in-process WS handler，packages/web-panel SPA bundle 重打。auto-updater 比对 5.0.3-alpha.40 > 5.0.3-alpha.39，所有 v5.0.3.39 桌面用户重启时会发现新版并自动获取 MTC 提速 + CI 修复。
  • v5.0.3.39 release-sizes / 安装时间真机 benchmark 仍是 issue #8 待跟进项；本版桌面 binary 重新打过（含 SPA 新 bundle），但 ASAR surgery / native deps / 文件量级与 .39 一致，install 时间应等价。
  • standalone cc serve 模式下 loadBridgeStatus 仍受 lib-vs-SPA shape mismatch 影响（pre-existing bug），桥状态显示 defaults——只在浏览器直连场景出现，桌面 v5.0.3.40 默认壳不受影响。
  • 四个 fix 互不相关、互不依赖、互不冲突；任一单独应用都比 .39 现状好，捆绑发布只是节省一次 release 仪式。

[5.0.3.39 / CLI 0.161.2] - 2026-05-07 (B4 post-pack ASAR surgery — Win 安装显著加速, issue #8) ​

Fixed ​

  • Windows 安装显著加速（commit e11b46913）—— dev-box (NVMe SSD + Defender OFF) 实测 190.9s vs 1201s 旧 baseline (issue #6) = 6.3× 提速；HDD + Defender ON 默认环境严格 parity 数据未测（issue #8 close comment 详述 methodology caveats）。v5.0.3.4-13 因 electron-builder prod-dep walker 漏掉 call-bind-apply-helpers / side-channel-{list,map,weakmap} 4 个 transitive deps 改成 asar: false 兜底，代价是 NSIS 内 ~110k loose files × ~10ms 文件级 LZMA dict reset + NTFS transaction + Defender scan = 旧 baseline 上 ~20 分钟安装地板。本版本（B4 plan）走第三条路：asar: true + post-pack ASAR surgery。

Added ​

  • scripts/asar-surgery.js —— 在 electron-builder afterPack 钩子里跑 surgery：从原 asar extractAll 到 staging → 把 walker dropped 的 4 个包从 desktop-app-vue/node_modules/ 注入到 staging 的 top-level node_modules/ → 用 @electron/asar.createPackageWithOptions 重打包，并保留 electron-builder 原始 unpackDir 决策（扫物理 app.asar.unpacked/ 父目录构造 brace-expanded glob）→ build-time verification gate 检查 4 个包确实落在 top-level（缺一即抛错，避免静默发出坏包）。
  • scripts/build-win-with-deref.js —— Win 包装 electron-builder --win：临时把 @chainlesschain/{core-mtc,session-core} 的 workspace symlinks 替换成 verbatim 拷贝（asar packer 拒绝跨 app-root 符号链接），electron-builder 完成后在 finally 用 'junction' 还原（Windows 非 admin 不能创建 'dir' symlink，必须 junction）。surgery 本身在 afterPack 里跑（在 NSIS 生成安装包之前），不在这里跑——否则 Setup.exe 已经从 surgery 前的 win-unpacked 打好了。
  • scripts/probe-asar.js —— 调试 CLI：node scripts/probe-asar.js <path/to/app.asar> 打印 4 个 walker-dropped 包是否落在 asar header top-level。
  • tests/unit/scripts/asar-surgery.test.js + build-win-with-deref.test.js —— 23 个单元 + 集成测试（真 fs + 真 @electron/asar 跑 fixture），覆盖 no-asar 跳过 / 4 包注入 / source 缺包抛错 / dst 已存在覆写 / unpacked 内容保留 / verification 失败抛错 / stage 清理 / symlink 检测 / dereference / detach / restore-with-junction。期间发现并修掉 1 个真 bug：

Changed ​

  • electron-builder.yml —— asar: false → asar: true，移除 7 条 force-include extraResources（app.asar.unpacked/{call-bind-apply-helpers,dunder-proto,get-proto,math-intrinsics,side-channel-{list,map,weakmap}}），afterPack hook 在 asar:true 路径下调 runSurgery。
  • scripts/electron-after-pack.js —— afterPack hook 双分支：asar:false（已有 nuclear-replace 路径，保留给 mac/linux 临时兼容）/ asar:true（新增 runSurgery({appOutDir, sourceNm}) 调用）。Mac/Linux/Win 三平台共用一条 surgery 路径。
  • desktop-app-vue/package.json —— @electron/asar ^3.4.1 提为显式 devDep（之前是 electron-forge / electron-builder / electron-winstaller 的 transitive，任一升级丢掉就坏）；make:win:builder 脚本改走 node scripts/build-win-with-deref.js。

Notes ​

  • 测试期间发现的真 bug：@electron/asar 有 module-level filesystemCache keyed by archive path，extractAll 后必须 asar.uncache(asarPath) 才能让后续 listPackage 读到 fresh header（否则 verification gate 永远抛 stale）。无 vitest fixture 的话生产环境也会同样抛——单纯依赖人工 Win VM 烟测发现需要再走一遍 30-45min build cycle。
  • Refuted 路径（不要再走）：asarUnpack glob（issue #6 经验证）、extraResources to app.asar.unpacked/（v5.0.3.12）、4 包提为直接 dep（v5.0.3.6）。
  • ASAR 完整性：Electron EnableEmbeddedAsarIntegrityValidation fuse 目前只在 macOS 强制（Electron 文档）。Windows 上 fuse no-op，post-surgery hash mismatch 不会让启动崩。当 macOS 加入支持（或 Windows 启用）后续 Phase 2：要么 @electron/fuses post-build patch 关闭 integrity，要么 surgery 后重算 hash 写回 electron.exe。

[5.0.3.38 / CLI 0.161.2] - 2026-05-06 (refit Android APKs missed by v5.0.3.37 immutable-release) ​

详见 git log 608d235dd。

[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）。

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

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。

[5.0.2.49 / CLI 0.156.6] - 2026-04-22 (V6 Preview 工具/任务 widget · ClaudeBox 工具卡 · XSS 防护收口 · IPC 契约锁定) ​

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 单元27411718 / 11718全通过（125s）
CLI 集成40696 / 696全通过（40s）
CLI E2E38565 / 565全通过（360s）
合计35212979 / 12979零回归

[5.0.2.34 / CLI 0.137-0.139] - 2026-04-19 (V2 第九批 · 14 个 session/context/permission/social lib 级治理表面) ​

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 单元24410493 / 10493全通过
CLI 集成40696 / 696全通过
CLI E2E38565 / 565全通过
合计32211754 / 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.js9837全通过
ueba.test.js5929全通过
threat-intel.test.js6941全通过

本批相较 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 单元2327618/7618129s
CLI 集成40696/69646s
CLI E2E38565/565427s

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

npm ​

Tag版本发布时间
v5.0.2.340.66.02026-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.310.48.02026-04-17 文档重构基线（本地 tag）
v5.0.2.320.49.0+ Phase 63 Universal Runtime
v5.0.2.330.51.0+ Phase 17 IPFS + Phase 27 Multimodal

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

Tests ​

层文件数用例数耗时
CLI 单元2327082/7082210s
CLI 集成40696/69676s
CLI E2E38565/565459s

本批新增 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 单元2196010/6010114s
CLI 集成40696/69636s
CLI E2E38565/565495s

本轮新增 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 统一演进的重要基础版本

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team