# 更新日志 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。 ## [2.6.3] - 2026-11-03 ### 修复 - **Windows 回退解压不再逐条走 `Expand-Archive`（issue #34）**：整树与分批两个恢复分支改走共用的逐条 .NET `ExtractToFile(overwrite: true)`，目录创建按大小写不敏感集合缓存，显式 UTF-8 并 `finally` 释放归档句柄。保留覆盖、CJK 路径、恢复计数、archive 失败可见与 H1 救援语义；issue 报告者的 5000 文件实测为 17.2s → 4.0s，本机冷缓存受 Defender 影响较大，不承诺固定耗时。 - **Windows 回退支持超过 260 字符的路径**：恢复与删除统一用 `\\?\`（UNC 为 `\\?\UNC\`）扩展绝对路径拼接，解压经 .NET 目录/文件 API 落盘；删除改用 `File.Delete` 并先清只读属性，普通路径与超长路径行为一致。解压失败或目录替换仍会终止并进入 H1 救援，不会假报 `ROLLBACK_OK`。 - **回退恢复后的文件 mtime 显式刷新**：逐条解压保留的是快照提交时间，与旧 index 的 stat 记录可能碰撞，导致紧接着的快照漏掉恢复内容、后续回退取回错误版本。现在与 POSIX 的 `tar -m` 对齐，把恢复文件 touch 到当前时刻。 - **大变更预览的分类计数改为全量口径**：此前摘要按截断后的前 500 条清单统计，与总数并列时读起来像清单丢了条目（实测 3054 条变更只报「修改 448 · 恢复 50 · 删除 2」）。现在 Windows 脚本在截断前输出 `COUNTS` 行、POSIX 由 Host 按全量清单统计，确认面板用全量计数渲染摘要；拿不到可信计数时面板隐去摘要，而不是显示一个对不上的数字。 - **工作区路径过长时给出可行动提示**：新增 `pathTooLong` 环境错误分类，识别 git 的 `Filename too long` 与 PowerShell 拉起 native 命令失败的 `The directory name is invalid`，提示「把项目移到更短的路径」。这是 Windows `MAX_PATH` 的平台限制（工作区根 ≥260 字符时 git 拒绝索引，`\\?\` 只救工作区内部的深文件），已在 README「已知限制」写明。 ### 测试 - **POSIX 回退补齐真执行回归**：新增 bash + git 冒烟，覆盖分批恢复、CJK/空格路径、`tar -m` 的 mtime 失配和超过 260 字符的路径。POSIX 模板原本已具备这些语义，本次只修正过时注释，不改实现。 - **长路径用例改为按实际根长度构造**：原先写死目录段数，在 CI 的 `/tmp` 短根上目标路径刚好 260 字符、断言落空（本地 `%TEMP%` 更长才通过）。现在按根长度反推段数，跨 runner 稳定。 ## [2.6.2] - 2026-11-03 ### 修复 - **Windows 保留设备名不再反复触发快照跳过提示（issue #32）**：`nul`、`aux`、`con`、`prn`、`com1`…、`lpt1`… 及其扩展名和上标数字变体在 `git add` 前默认排除，覆盖任意子目录；规则仅适用于 Windows，不进入构建产物 root 判定，POSIX 合法同名文件不受影响。这些路径保持「不恢复、不删除」的既有回退语义。 - **0 字节 `nul` 等路径的失败提示不再静默丢失**：`SNAP_SKIP` 同时识别 Git 的 `unable to index file 'X'` 与 `unable to add 'X' to index`，PowerShell 与 bash 模板均已覆盖。 ## [2.6.1] - 2026-10-31 ### 新增 - **「只回退消息」模式（`messageOnly`，默认关闭，issue #31）**：开启后每条用户消息仍登记撤回记录（撤回按钮与对话回退照常），但不再执行文件快照——大仓（gitignore 过滤后仍上千文件 / 上 GB）不必为每条消息写一次全量对象。按消息生效：`index.json` 只给这类条目记 `files: false`，开启前拍的旧快照仍可完整回退文件；确认面板对这类消息隐藏「回退文件与对话」单选，快照管理树标「仅消息」。代价是这类记录没有 tag，索引损坏被隔离后撤回按钮无法从 tag 重建。 ### 修复 - **磁盘枚举失败不再表现成「没有快照」**：此前快照管理读不到磁盘时会静默返回空列表，界面只剩一棵空树，用户以为快照都没了（issue #30 报告的现场就是这样）。现在失败原因进「最近错误」，列表 / 按工作区或会话批量删除 / 全部删除回 `DUMP_FAILED`，卡片显示可重试的错误条；「全部删除」也不再用「已删除 0 条」掩盖枚举失败。 - **建过仓但从没拍过快照的空仓不再永久占盘**：dump 脚本为每个 store 增发 `STATE` 段（`present` / `absent` / `quarantined` / `foreign`），「立即 gc」据此把「有 store 布局但从未生成索引」的空壳整目录回收；损坏隔离现场（`index.json.corrupt-*`）、旧版脚本输出与非本插件的目录一律保留。 ### 文档 - 新增 [plan-dump-visible-and-empty-reclaim.md](docs/plans/completed/plan-dump-visible-and-empty-reclaim.md)：两条遗留的问题、判据表与测试清单；AGENTS 已知坑补 I46，compat-audit 补 I46 详情。 - 新增 [plan-message-only-mode.md](docs/plans/completed/plan-message-only-mode.md)：只回退消息的问题、判据、边界与实施记录；smoke checklist 第十一节与 records 同日批次（M1〜M6 实弹）。 ## [2.6.0] - 2026-10-30 ### 新增 - **任务队列按工作区隔离**：快照/preview/回退/删除/gc 原先共用一条全局串行链，一个工作区的慢快照会把**所有会话**的撤回按钮一起堵住。现在同一工作区仍然串行（都在写同一个 git index），不同工作区并行；跨工作区的批量删除与全局 gc 用「等这些工作区的链尾全部落地」保证互斥。win32 下路径大小写归一，避免同一仓库拿到两把锁。 - **单次快照时限可配置（`snapshotBudgetMs`，默认 3 分钟）**：整条快照脚本（扫描 + `add` + 写索引/打 tag）的兜底超时从硬编码 600 秒改为配置项，设置卡片按秒展示；`0` 表示不限制。 ### 修复 - **Linux/macOS 上快照管理、批量删除/全部删除与「立即 gc」全部不可用**（[issue #30](https://github.com/limbo947/dsh-recall-plugin/issues/30)，POSIX dump 脚本的两个缺陷）：① 建仓后还没拍过快照的**空仓**没有 `index.json`/`lineage.json`，裸 `cat` 在 `set -e` 下让整条 dump 退出 1，磁盘上的仓一个都枚举不到；② 这两个文件落盘时没有尾换行，`cat` 后紧跟的段尾标记被粘到内容行尾，解析器按整行匹配永远收不到段尾——**即使文件齐全，每个仓也被解析成「无索引」**（报告者的临时处置只修了 ①，树依然是空的）。现在两处改为「缺席放行 + 内容后补一个换行」，逐仓隔离语义不变，存量数据无需迁移。 - **设置页 exclude 编辑器可能回显垃圾字节**（同一类行边界缺陷）：`exclude.txt` 字节数为 3 的倍数时 base64 没有 `=` padding，粘在尾部的段尾标记会被一起解码；回显后再保存即污染文件。 - **dump 脚本的测试从「字符串断言」升级为「真跑一遍」**：新增 [tests/unit/stores-dump-script.test.js](tests/unit/stores-dump-script.test.js)，在 bash 里执行生成的脚本并校验解析结果（CI 的 ubuntu 必然执行，win32 认 Git Bash）。此前只断言脚本文本与解析器行为，这两个只在执行期暴露的缺陷因此全绿漏过。 ### 文档 - 新增 [plan-stores-dump-posix.md](docs/plans/completed/plan-stores-dump-posix.md)：issue #30 的双缺陷分析、实测矩阵与防回归设计；含「不采纳 warmup 落 `index.json = []`」「不采纳脚本保持 fail-fast」的依据，以及两条遗留（dump 失败对用户不可见、空仓无法回收）。 - 新增 [plan-queue-and-budget.md](docs/plans/completed/plan-queue-and-budget.md)：含 web 新会话 cwd 的官方归属核查（`startSession` 取 `workspaceId ?? 当前 ?? 最近`、全链不传 cwd、无配置项/钩子可改写）——该项为官方行为，插件不改代码，只在 README 使用注意与 AGENTS 已知坑里写明。 ## [2.5.3] - 2026-10-30 ### 修复 - **大工作区护栏静默失效（issue #29）**：快照前的预算扫描以 `git ls-files` 为准，此前它非零退出会被当作「没超限」——`$HOME` 级工作区（523 GB / 233 万条目）上实测每条消息先写约 10 GB 对象、600 秒后被杀，prune 回收后下一条消息再重复一遍。现在统计失败一律 **fail-closed**：脚本在 `add` 之前输出 `SNAP_SCAN_FAIL` / `SNAP_SCAN_ERR` 并跳过本次快照，原因（git 的 stderr 首行）进「最近错误」，该工作区暂停快照 10 分钟（改配置或 TTL 到期自动重试），不再重付一次全量扫描。 - **超过 `maxFileBytes` 的文件不再先写对象再移出索引（issue #29）**：此前 `add -A` 会先为超大文件写入 blob，之后才由剔除逻辑移出 index——「小文件少 + 大文件多」的工作区能在预算通过后仍写满磁盘。改为先扫出大文件清单，`add` 带 `--pathspec-from-file` 的 exclude 清单执行（大文件既不进索引也不写对象），add 后仍按清单兜底剔除一次；不支持该选项的旧 git 自动退回裸 `add`（行为同旧版）。 - **分钟级失败不再免费重试两次（issue #29）**：失败耗时 ≥60 秒视为「昂贵失败」，直接进入退避（5 分钟起、指数递增），不再按「连续 3 次失败」让用户先付三轮分钟级 + GB 级写入。 ### 变更 - **快照 / 预览 / 回退三处 `add` 前统一切 cwd 到工作区根**：`--pathspec-from-file` 的隐含全集会被 cwd 前缀裁切（`:(top)` 救不回来，实测），脚本原先的 cwd 是宿主工作目录，可能正在工作区子目录里。 ## [2.5.2] - 2026-10-28 ### 修复 - **编辑重发带图片时「草稿填了却不发」（活体回归发现，仅 0.2.2-alpha.2 触发）**：`createDrafts` 第三参传 `true` 会让图片进输入态即后台上传，而官方 `sendSession` 会**等上传回执**才发 prompt——刚 fork 的子会话上传迟迟不结算时，草稿留在输入框、消息不发、控制台无错（真机复现两次；同场景纯文本编辑重发一次成功）。改为按场景分流：撤回回填（只填不发）仍传 `true` 保留即时上传；编辑重发（自动发送）传 `false`，图片字节随 prompt 内联，发送一步到位。 ### 兼容 - **dsh 0.2.2-alpha.2（一处破坏，已修）**：官方把 `readAttachment` 的入参从 `attachmentId` 字符串换成完整 `ImageAttachmentRef`，宿主不再回会话日志反查授权，裸 id 直接 `INVALID_ATTACHMENT_REF`。插件原先传裸 id → **撤回回填与编辑重发的图片会被逐项 `try/catch` 静默丢弃**。现按「完整引用 → 裸 id」探测回退并把命中代缓存在闭包，两代同时可用（0.1.x / 0.2.0 / 0.2.1 行为不变）。另补 `createDrafts` 第三参 `uploadImages=true`（旧版忽略），恢复「图片进输入态即上传」的官方语义；三参形态抛错时自动退回两参（图片改随 prompt 内联），不让整批附件丢失。 - **`sessions.fork` 停写 `parentSession`**：普通分支改由 header `origin` 判定，插件只读 `origin` 且血缘自存 `lineage.json`，无需改码；fork 子会话不再有被当作子代理的残余风险。 - **cordis 配置访问统一**：loader 的 ref 来源 `fiber.config` → `fiber.effectiveConfig`，volatile 提交与 `loader/volatile-update` 派发链未变，设置面热更不受影响。 ### 变更 - **`test:probe` 58 条**：新增「附件回读链（B1）」钉住 `readAttachment` 单参形状与 `{ attachment, data }` 返回；`createDrafts` 探针并入第三参（新旧两形态都放行）；loader 探针按 `fiber.effectiveConfig` 同步改名并注明两种拼写。 - **client 单测 121 → 129**：新增 `tests/client/draft-fill.test.ts`（对象口径 / 字符串口径 / 命中代缓存 / 双失败降级 / 仅裸 id 的旧调用方形状 / 回填第三参 true / 自动发送第三参 false / 三参抛错退回两参）；`attachmentRefsFromBlocks` 的形状断言并入既有 unit 用例（原始引用随行）。 ### 文档 - 台账同步 dsh 0.2.2-alpha.2：`dshReleases` 补 `0.2.2-alpha.2`、六条 `@deepseek-ai/dsh-*` peer 追加 `>=0.2.2-alpha.1 <0.3.0`（cordis `>=4.0.6-alpha.1 <4.0.7`、schemastery `>=3.18.6-alpha.1 <3.18.7`）、`docs/reference/` 第十一次重拉（13 源中 3 份有差异，均不落插件消费面）、`docs/dsh-contract.md` 对应版本与新增 §1.2「输入区写入链与附件回读」+ 沿革⑫、`docs/compat-audit.md` 新核验段、新增 [upgrade-assessments/dsh-0.2.2-alpha.2.md](docs/upgrade-assessments/dsh-0.2.2-alpha.2.md)、README 双语徽章与版本范围。 ## [2.5.1] - 2026-10-27 ### 兼容 - **dsh 0.2.1-rc.3 零破坏（无需改码）**：6 个 commit 全是纯加法与内部修复——新增客户端包 `dsh-client-ui-entry-customization`（左/右侧栏与会话视图的「更多」菜单）只声明并注册三个 root scope list 槽，与插件四个注册 key 零交集；新会话草稿修复落在 `ui-workspace.startSession` / `createInWorkspace` 的 blank 复用，插件不调用该入口；API Key 路由模型列表改跟官方 `/models`，客户端目录契约 `dsh-client-ui-model-selection` 零漂移。`sessions.fork`、`setDraft`/`createDrafts`/`addAttachments`、`openSession`/`unarchiveSession`、slot 定义方（`ui-chat`）、兼容门禁（`dsh-app-boot`）逐字节零变更；`test:probe` 58/58、`verify:host` 全过、六条 peer 对 rc.3 全满足，宿主启停冒烟零 compat/skip。评估见 [docs/upgrade-assessments/dsh-0.2.1-rc.3.md](./docs/upgrade-assessments/dsh-0.2.1-rc.3.md)。 ### 变更 - **`check:dsh` 改按 `dist-tags` 判定「npm 最新版」**：官方 rc 线发在 `next` 上、`latest` 停在上一版（0.2.1-rc.3 实测 `latest=rc.2` / `next=rc.3`），原实现只读 `version`（= latest），会把已发布的候选版误报成「无新版本」。现在两标签取较新者作 peer 覆盖与升级提示的基准，并在该行注明判定依据；`dist-tags` 读取失败时回退单版本探测（fail-open）。新增 5 条单测（报告判定 2 + 取较新者 3）。 - **`test:probe` 补输入区写入链 4 条（54 → 58）**：回填与编辑重发依赖的官方入口此前只有运行时能力探测兜底、探针零覆盖——官方若把 `setDraft` 并入新的 `whenDraftExists` 策略模型或改签名，没有任何红灯。现钉住 `InputActions.setDraft/addAttachments/submit`、`InputState.draft`、`SessionInputShell.actions` + `get snapshot()`、`createDrafts`/`releaseDraftAttachments`。 ### 修复 - **影子仓库写 index 的调用补 `--work-tree`（既有缺陷，与 issue #28 同批发现）**：影子仓库用 `git init --bare` 建，裸 `--git-dir` 下 git 认为没有工作树，`update-index` 直接 fatal `this operation must be run in a work tree`。后果按平台分叉：win32 上 git 非零退出不抛，**超大文件剔除（`maxFileBytes`）与 gitlink 剔除静默失效**——10 MB 文件照样进快照；POSIX 上 `set -e` 让「工作区里有带 `.git` 的子项目」这类场景**每条消息都快照失败**。三处调用（`dropGitlinks` / `oversize` / `excludeSync` 的已跟踪条目清理）统一补上，`excludeSync` 因建仓路径没有 `$root` 而走条件分支。契约单测钉住「写 index 的 `update-index` 一律带 `--work-tree`」。 - **快照总量护栏不再把 `.gitignore` 排除的目录算进去（issue #28）**：`maxWorkspaceBytes` 的前置统计改为按 `git ls-files -z -co --exclude-standard` 的清单求和，与 `add -A` 共用同一套排除引擎——`.gitignore`（每层继承）、`.git/info/exclude`、全局 excludesFile、`!` 反选与嵌套仓库的判定从此与真正进快照的口径一致。此前只认基础排除表与 `exclude.txt`，实测把 130 MB 的项目量成 297 MB 并整区停用快照（用户直接失去撤回能力），提示还会把人引向「调大上限」这个反向处置。顺带修好「父级工作区把带自己 `.git` 的子项目算进总量」。`ls-files` 失败时 fail-open 不判定（不回落目录遍历，避免两套口径随 git 状态跳变）；停用提示与设置页 hint 补注「已按 .gitignore 与排除表过滤」。 ### 文档 - 台账同步 dsh 0.2.1-rc.3：`dshReleases` 补 `0.2.1-rc.3`、`docs/reference/` 第十次重拉（13 源逐字节相同，连续第二轮零差异）、`docs/dsh-contract.md` 对应版本与沿革⑪、`docs/compat-audit.md` rc.3 核验段、README 双语徽章与版本范围。 ## [2.5.0] - 2026-10-24 ### 新增 - **「编辑并重发」：就地改完直接发出（issue #26）**：用户消息动作行在「↶ 撤回」旁新增「✎ 编辑」——点击就地展开编辑框并预填原文，改完提交即新建会话并把改后的文本自动发出。复用撤回的 fork 链（preview 取切点 → execute → `sessions.fork` → 归档原会话），但 scope 固定 `session-only`：**编辑语义不动项目文件**，也不打安全快照。原消息的图片/文件附件经 `createDrafts → addAttachments` 一并带入新消息。 - 配置项 `editSubmitsImmediately`（默认 `true`）：提交后自动发送；关闭则退化为「只回填输入框」，由用户按回车发送（适合只想改稿不想立刻发）。设置页「插件配置」卡片可直接切换，热生效；老 Host 不下发该字段时按 `true` 处理。 - 发送时机按草稿落地校验：`setDraft` → `actions.submit()` 之间读输入态快照比对草稿文本，未落地则最多等 6×50ms 再提交——`submit` 读的是输入态快照，同一 tick 内投影未刷新会按空草稿静默返回。快照不可读的跨版本面降级为让出一拍直接提交（草稿为空时官方自身拒发，最坏是「没发」，不会「发错」）。 - **版本翻页器 `‹ X/N ›`**：每次撤回/编辑重发 fork 出的会话构成同一段对话的版本家族，最后一轮回答的操作区嵌入 `‹ X/N ›`——点击切换：归档当前版本 → 解档目标版本 → 打开目标会话，侧栏始终只保留一个活动版本；切换后按 `data-chat-anchor-key` 恢复视口位置（消息内容不同、行高不同，只靠 `scrollTop` 会跳位）。家族登记在客户端 `localStorage`（`dsh-recall:versions:<根会话>`），与 host 侧 `lineage.json` 互补：丢了只影响翻页器，会话本身不受影响。 ### 变更 - **消息位置出现「官方同款」编辑卡**：点 ✎ 后气泡换成一张按官方 composer 配方画的卡片（panel 圆角 / `input-major` 底 / soft 阴影 / 14-24 字号行高），预填原文、随内容增高，**底部官方输入框保持原样**。卡内可用：Enter 发送（Shift+Enter 换行）、附件增删与粘贴/拖入、只读的权限 chip、可切换的模型与推理等级、`Esc` 取消。 - **为什么不是第二个官方输入框**：`conversation.composer.bar` 是 single 槽且已被宿主的 `conversation.content` 独占声明——插件渲染任何槽都要先在自己 children 里声明它，重复声明会在加载期抛错，组件实例也没有导出。因此这张卡是插件自绘的同款，官方样式变动时需要跟版。 - 附件语义改为显式：原消息附件渲染成可移除的 chip，提交时只带保留下来的那些；卡里新加的附件（粘贴/拖入/选择）与原图/文件一起交给 `fillDraft` 在子会话重建。图片附件显示为 56px 缩略图（原消息图片走官方 `loadImage` 通道、与消息里的大图同源；新加图片用 object URL，移除/关闭时回收），非图片仍按文件名 chip 展示。 - 编辑卡里的模型菜单按官方同构重建：主段两行「模型 / 推理等级」，点进去分别是模型列表（搜索 + 按供应商分组 + 当前项打勾）与档位列表（Default / Low / High / Xhigh）。选择走官方 `ctx.modelDirectories` 的 `directoryFor(session).select()`——与底部 chip、`/model` 命令同一条 `selectModel` 通道，选中后底部输入框的 chip 同步更新，fork 出的子会话沿用；换模型用该模型的默认档，重选同一模型保留当前档位。触发 chip 与官方同构：模型名用常规色、思考强度用更淡的字色，尾部带展开箭头（展开时翻转、给一层 hover 底）。服务缺失（旧宿主）时退回只读展示。 - 编辑态隐藏底部输入框的统计 dock（回合/步骤、tok/s、缓存命中、Trace）：编辑焦点在消息处，dock 属全局概览，留着只会分心。规则挂在既有的 `data-editing` 上，不引入额外 JS 状态。 ### 修复 - **编辑态重复触发不再重置已改文本**：编辑态下不再渲染「✎」（点了也是空操作），`openEdit` 对 editing 幂等、error 态保留改过的文本与附件——否则会用原文覆盖用户改到一半的内容。 - 输入区回填链（文本 + 附件 + 可选发送）从 `recall-node.ts` 抽到新模块 `src/client/draft-fill.ts`：撤回回填与编辑重发必须共用同一条官方写入通道，分叉必然漂移；`defaultAttachmentName` 随迁并保持 `recall-node.js` 的 re-export 路径不变。 - 编辑渲染层独立成 `src/client/edit-node.ts`（与撤回确认面板的 stage 语义不同），骨架与执行链仍在 `recall-node.ts`；版本翻页器拆为 `src/client/version-tree.ts`（家族登记/查询）与 `src/client/version-pager.ts`（`conversation.chat.assistant-actions` 槽组件）。 - 撤回执行链 `executeRecall` 参数化（scope / 切点 / 预览摘要 / 编辑文本），编辑与撤回共用同一段 fork 收尾；scope 判定改白名单，避免被当作 `onClick` 处理器时把 React 合成事件当 scope 透传。 ### 边界 - 会话第一条用户消息没有更早的 `turn/end` 边界，编辑提交会被明确拒绝（错误面板），不静默降级为「仅回填」。 - fork 失败时不回填也不发送：原会话与原消息都还在，补发会变成同一会话里的重复消息。 ## [2.4.16] - 2026-10-18 ### 修复 - **用户消息气泡被压窄、二十来个字也要折两行**：新面（factory 分支）本层 `.dsh-recall-stack` 仍带旧版的 `max-width:min(525px,82%)`，而它包裹的官方 `UserContent` 内层 `.userStack` 自己已有一道 `max-width:…82%`——两层百分比叠加成 0.82×0.82≈0.67，气泡可用宽度只剩列宽的 2/3（1600px 视口实测 254px，20 字中文 15px 字号约需 300px，于是折行）。外层在官方面改为 `width:100%;max-width:100%`（新增 `dsh-recall-stack-official` 标记），只保留右对齐与间距，宽度交回官方内层按满列宽计算（修复后同一条消息 310px、单行）；legacy 自绘面（0.1.x 与 factory 回落）仍保留原 `min(525px,82%)` 上限，长消息宽度不变。 ## [2.4.15] - 2026-10-18 ### 修复 - **构建产物工作区根在启动预热时仍被建仓/列 tag（issue #24 报告者指出的边角）**：`captureSnapshot` 与 init/snapshot-info 早已对「产物 root」（`dist/`、`…/target/debug` 等）停用快照，但预热链入口没有同一道判断——工作区开在 `dist/`、`build/` 里时每次启动都会白付 `resolveStore + ensureGit + rebuildOrphans` 的进程开销。判据与 `captureSnapshot` 同源，补单测（含 POSIX 大小写敏感语义）。 ### 变更 - 根就绪链（预热与 init 共享、in-flight 去重）从 `index.ts` 闭包迁到独立模块 `src/host/root-ready.ts`：入口早退分支与幂等契约可被单测直接钉住，`index.ts` 只留装配。 ## [2.4.14] - 2026-10-18 ### 修复 - **启动后单核 CPU 打满、进程表出现数十个 pwsh（issue #24）——三重根因一并修复**：① 启动预热对每个工作区并发跑一条命令链（7 工作区 × 6~8 条命令 ≈ 40~56 个 pwsh 冷启动），而每个恢复会话的 `init` 端点还会再跑一遍同款链；② 快照只有单文件上限（原 100MB），挡不住「大量小文件」——报告者的下载目录工作区 321 个 ≤100MB 文件合计 1.05GB 全部进快照；③ 快照的 `add -A` 无总量上限、无扫描时间预算。 - **预热与 init 共用根就绪链（in-flight 去重）+ 预热并发限流 2 路**：同一工作区在本进程内只跑一次 `resolveStore/ensureGit/loadIndex/rebuildOrphans/recover`，多工作区预热不再同时起数十条 pwsh。 - **快照前置护栏：总量上限 + 扫描时间预算**：脚本在 `add -A` **之前**遍历工作区统计「实际会进快照的文件总量」（只计 ≤`maxFileBytes` 的文件，防单个大视频误判）与耗时，超过 `maxWorkspaceBytes`（默认 256MB）或 `scanBudgetMs`（默认 10s）即输出 `SNAP_LIMIT` 并**停用本次快照**——只停用不截断：截断快照回退时会按 index 清单误删未纳入的文件。Host 侧解析标记后短路该工作区后续快照（配置变化或 10 分钟 TTL 自动重试），并在最近消息上提示可行动的恢复方式（调大上限 / 补充排除表）。 - **单文件上限默认 100MB → 8MB**（`maxFileBytes`）：与总量护栏配合，避免大文件首拍把对象库撑到 GB 级；含素材/模型的正常项目可按需调高。 ### 新增 - 配置项 `maxWorkspaceBytes`（默认 256MB）与 `scanBudgetMs`（默认 10s），0 = 不限制；设置页「插件配置」卡片可直接修改（热生效）。负数按非法回退默认——显式关闭只认 0。 - `snapFeedback.kind` 新增 `workspaceLimit`：`snapshot-info` 对停用的工作区下发可行动文案（客户端 toast 直显）。 ### 文档 - README 双语配置表补两项新字段与 8MB 默认值；AGENTS.md 核心机制补护栏语义；`cordis.patch.yml` 默认配置同步。 ## [2.4.13] - 2026-10-17 ### 兼容 - **dsh 0.2.1-rc.2 兼容（零破坏核验，无代码改动）**（升级核查见 [docs/compat-audit.md](docs/compat-audit.md) 头部 0.2.1-rc.2 段）：rc.2 自身只有模型适配（DeepSeek-V4.1-Flash-1017）与 DeepSeek Search/Fetch API 两条新特性；跨 alpha.5 / rc.1 的累计变更中，rc.1 汇总版 Breaking（输入区 stats 拆分、移除 `invariant`、移除工具展示 `both`、Agent Team inbox 直投、API Key 优先级、子路径 `package.json`）均不作用于本插件。34 个关键包 `lib/` 逐字节 diff 仅 3 处非功能漂移（`dsh-client-modules` commit 字面量、`dsh-cordis-client-runner` slot 教学目录、`dsh-api-remotes` 账号 bonus schema）；`sessions.fork`、slot 定义方、设置面、兼容门禁全部零漂移。 - **实装核验**：全局升级 `@deepseek-ai/dsh@0.2.1-rc.2` 后 `test:probe` **54/54**、`verify:host` 装配断言全过（inject=shell,sessions,agents、端点 13 项）、`check:dsh` 全绿（六条 `@deepseek-ai/dsh-*` peer 对 rc.2 全满足）；`dsh.compatibility.dshReleases` 补 `0.2.1-alpha.5` / `0.2.1-rc.1` / `0.2.1-rc.2` 三项。 ### 文档 - `docs/reference/` 镜像按 tag `dsh-v0.2.1-rc.2` 九次重拉：13 源全部逐字节相同（首个零差异轮次），仅更新头部「归档日期 / 归档 dsh 版本」两字段。 - `docs/dsh-contract.md`（版本段 + 沿革 ⑩）/ `docs/compat-audit.md`（新增 0.2.1-rc.2 核验段）/ 新增 [docs/upgrade-assessments/dsh-0.2.1-rc.2.md](docs/upgrade-assessments/dsh-0.2.1-rc.2.md) 与 [docs/upgrade-assessments/dsh-0.2.1-rc.1.md](docs/upgrade-assessments/dsh-0.2.1-rc.1.md) / README 双语兼容范围与徽章同步至 0.2.1-rc.2。 ## [2.4.12] - 2026-10-16 ### 修复 - **用户消息正文在 dsh 0.2.0-rc.x 上静默空白（issue #23）——判据重写为「旧面闭包在场即旧面」**：旧实现以 `renderFactorySlot` 是否存在判新面，而 0.2.0-rc.2 已下发该函数、`conversation.user.*` 槽位却尚未引入（0.2.1-alpha.3 才引入）——正文渲染成空、零报错（气泡只剩内边距，插件动作行照常）。`renderMessageImages` 只存在于 ≤0.2.1-alpha.2，与新槽位引入版本互斥，以其判定两面才可靠；0.2.0-rc.2 归旧面自绘、正文恢复。判据与投影单源在新增的 `src/client/user-content.ts`。 - **新面内容渲染从「分片投影」收敛为「整条内容单入口」**：文本/图片/文件卡片/未知块/引用摘要一次交给官方 `conversation.chat.user.content` Factory（投影＝官方 `contentParts` 三分派的逐字复刻；该函数官方未导出），与官方 `UserMessageNodeView` 同款调用（含 `interactive: true` 对齐）——插件只保留动作行（时间/复制/撤回），气泡外壳/文件卡片/JSON 块/文本四类自绘在新面退场，官方规则链（密钥脱敏等）自动跟随。 - **兜底不静默**：官方 Factory 返回空或抛错（槽位未注册的中间版本）时回落自绘（文本/文件卡片/JSON；新面兜底无图片入口，跳过）并打 warn——「探测通过但渲染为空」不再可能产出空白正文。旧面（≤0.2.1-alpha.2）行为不变。 ### 兼容 - **dsh 0.2.1-alpha.4 兼容（零破坏核验，无代码改动）**（升级核查见 [docs/upgrade-assessments/dsh-0.2.1-alpha.4.md](docs/upgrade-assessments/dsh-0.2.1-alpha.4.md) 与 [docs/compat-audit.md](docs/compat-audit.md) 头部 0.2.1-alpha.4 段）：双 lockfile 包清单对比（第三方依赖零变化）+ 32 个关键包 `lib/` 逐字节 diff 确认插件消费/注册契约零漂移——`sessions.fork`（`dsh-session` 整包）、`dsh-shell`、`dsh-settings`、`dsh-session-query`、`dsh-session-persistence`、`dsh-cordis-host-runner`（host 插件加载器）、`dsh-client-ui-chat`（slot 定义方）等 22 包零变更。 - **本版唯一机制变更（`engines.dsh` 优先判定）不作用于本插件**：`dsh-app-boot` 兼容性门禁改为「manifest 声明 `engines.dsh` 则只查它并**短路** peerDependencies；未声明沿用 peer 判定」——本插件未声明 `engines.dsh`（`engines` 仅 `{node:">=20"}`）→ 走 peer 路径，六条 `@deepseek-ai/dsh-*` peer 对 0.2.1-alpha.4 全满足；**维持不声明**（多段逐线窗口无法用单段等价表达，声明即短路 peer 判定且放宽未验证版本，见 I43）。输入链「命令芯片」重构（`ui-conversation` 等 3 包，编辑器内部）不改变 `setDraft` / `createDrafts` / `releaseDraftAttachments` / `addAttachments` 签名与行为；三个 client 基础包（store / primitives / slots）内联化退出运行时树，对插件透明（bundle 仅 require react）。门禁：`test:probe` **53/53**、单测 **499/499**、client **93/93**、`verify:host` 装配断言全过、`typecheck`、`check:dsh` 全绿；`dsh.compatibility.dshReleases` 补 `0.2.1-alpha.4: compatible`。 ### 文档 - `docs/reference/` 镜像按 tag `dsh-v0.2.1-alpha.4` 重拉：13 源中 12 份逐字节相同、仅 `05-publish.md` 差异（新增 `engines.dsh` 版本声明段，+365 B）。 - `docs/dsh-contract.md`（版本段与沿革 ⑨）/ `docs/compat-audit.md`（新增 I43）/ `AGENTS.md`（I43 索引行）/ README 双语兼容范围与徽章同步至 0.2.1-alpha.4。 ## [2.4.11] - 2026-10-15 ### 兼容 - **dsh 0.2.1-alpha.3 兼容（首个破坏性版本：chat.node 图片渲染入口换代）**（升级核查见 [docs/upgrade-assessments/dsh-0.2.1-alpha.3.md](docs/upgrade-assessments/dsh-0.2.1-alpha.3.md) 与 [docs/compat-audit.md](docs/compat-audit.md) 头部 0.2.1-alpha.3 段）：官方移除 `chat.node` 的 `renderMessageImages`、把 `conversation.message.images` 拆为 `conversation.chat.message.images` + `conversation.chat.user.images`，图片渲染改经 `renderFactorySlot`（`PropsRenderFactories`）+ `loadImage` 的 `conversation.chat.user.content` Factory——插件原图片重绘链在新版静默失效（用户消息图片无声空白，issue #9 的第二次形态，零报错）。 - **修复为运行时双面探测**（`src/client/recall-node.ts`）：旧面（≤0.2.1-alpha.2）沿用 `renderMessageImages` 闭包；新面（≥0.2.1-alpha.3）经 `renderFactorySlot('conversation.chat.user.content', …)` 只渲染附件行（`content.text` 传空串保官方 `showBubble=false`，正文仍由插件自绘气泡、不重复出官方气泡），`loadImage` 原样透传——peer 全窗口（0.1.2–0.2.x）行为一致。 - 探针改双面契约断言（`test:probe` 52/52），`test:client` +2（旧面闭包 / 新面 Factory 载荷与 `text:''` 契约要点 / 两入口双缺降级）；其余契约零漂移：`sessions.fork`（仅 `create` 加可选 `agentPreset`）/`updateQueue`/`setDraft`/`archiveSession` 均未动，事件集 60 → 62（仅增 `job/registered`/`job/settled`，零删除）。观察项：exact Fetch 路由明确「仅 owner Peer 可达」——远程非 owner 访问场景插件 API 403（本机 web/desktop 零影响）。 - **密钥脱敏对齐（同日跟进）**：官方新增 `dsh-client-ui-secret-mask`（`userText.register` 规则 + `conversation.user.text.node` key=`secret`）只在官方文本投影层打码，插件自绘气泡原本绕过、密钥明文。文本行改经新面 `renderFactorySlot('conversation.user.text', { text, facts: {}, interactive: false, ellipsis: false })` 投影——仅继承脱敏（`facts` 空对象令官方 whitespace 折叠/裁剪规则读不到 flag 即禁用、显示与旧面逐字一致；引用 chip 仅在显式 wire 格式下出现）；旧面（≤0.2.1-alpha.2，无 `renderFactorySlot`）保持纯字符串渲染。探针 +1、`test:client` +1（**probe 53/53、client 93/93**）。 ### 文档 - `docs/reference/` 镜像按 tag `dsh-v0.2.1-alpha.3` 重拉：13 源中 2 份差异（`05-publish.md` 的 `--from-default-profile` 重置语义；`11-cookbook-conversation-node.md` 的 `exclusive` 认领与 `groupTree` 位置表）。 - `docs/dsh-contract.md` / `docs/compat-audit.md`（I2 重写）/ `AGENTS.md`（I2 行）/ README 双语兼容范围与徽章同步至 0.2.1-alpha.3。 ## [2.4.10] - 2026-10-07 ### 修复 - **回退恢复侧从「整树解压」改为只处理 diff 变更集（issue #22）**：旧版 `rollbackScript` 的 `$restored` 是目标树全量条数——改 1 个文件也把整棵快照树打 zip/解包一遍（大工作区 GB 级三遍 IO；issue #20 实机 39.2 万条幽灵条目时打出 5.11 GB zip），未变更文件也被 `-Force` 覆写、mtime 全变误触发构建增量/文件监听。现按 sha 求出恢复集（目标有、当前无或内容不同，与 `diffScript` 的 modified+restored 同集合），`git archive -- ` 分批（100/批）只解压变更项，变更过半时回退整树单遍（N/100 次 archive+解压的启动开销超过单遍）；`ROLLBACK_OK` 的 restored 计数随之变成实际恢复条数，与 preview 的 diff 计数逐项相等。pwsh/posix 双侧对偶（POSIX 走 `archive | tar -x -m` 分批 pathspec）；archive 失败 pwsh 侧显式 throw、POSIX 侧 pipefail 非零退出——半回退不许报 `ROLLBACK_OK`（F-G2 纪律不变）。实测：6 文件工作区改 1 删 1 增 1 的回退 `ROLLBACK_OK 1 2`（旧版报 7），未变更文件 mtime 不动；变更过半整树路径双侧实测正确。 - **junction 防护三处评审补强（PR #21 P3 nit）**：① 机器生成的 exclude 行补 gitignore 转义——目录名以 `#`/`!` 开头或含 `[` 的 junction 此前会被解析成注释/反选/字符组而静默漏排除（自引用 `#hash` 金丝雀夹具实测漏排 → 修复后 1 条索引）；② 发现行排序，exclude 内容序与 NTFS 枚举序脱钩，消无谓重写；③ 良性 junction 开反选逃生口——exclude 写盘顺序改为 base + 机器行 + 用户行（gitignore 后写胜出），排除配置追加 `!路径/` 即可把指向工作区外的 junction 重新纳入快照（实测默认 1 条 → 反选后 3 条索引），切勿对自引用 junction 使用，README 双语已更新。 - **win32 目录重解析点把影子仓库索引撑爆、撤回退化为分钟级（issue #20，PR #21，外部贡献 @PrismScopes）**：git for Windows 把 NTFS junction 当普通目录，`add -A` 递归进入链接目标（`core.symlinks` 取 true / false / 默认实测同样递归，无法配置规避），自引用 junction（`a/link -> a`）按 Windows「路径中最多 31 个重解析点」上限把同一棵子树重复索引——实机病例 1.24 万条 → 39.2 万条、`.git/index` 168 MB，preview/快照/回退退化到分钟级（用户表现为「永久卡在正在计算变更」）。修法＝`excludeSyncBlock` 在 `add -A` 之前遍历目录树（不进入链接目标）把目录重解析点按相对 root 路径 + 尾斜杠并入 `info/exclude`，git 根本不进入它们；已跟踪的旧幽灵条目由既有 `ls-files -i -c` 分支一次清掉；`oversizeBlock` 同一次压栈过滤顺带剪掉重解析点。遍历只枚举目录、复用既有目录名剪枝，无重解析点的工作区不产生 exclude 差异，条件化比对跳过重写与清理循环（常态零开销）。POSIX 侧有意不做：git 把指向目录的符号链接记成 `120000` 条目、不递归进目标，照搬反而会把合法快照内容剔出快照。已知限制（README 双语已声明）：工作区内的目录重解析点一律不参与快照（含指向工作区外的良性 junction，无 `!` 反选逃生口）；POSIX bind mount 环不覆盖。维护者评审实测数据：2 真实文件 + 自引用 junction 夹具，索引 96 条（93 幽灵）→ 3 条 / 0 幽灵，`.git/index` 38 KB → 331 B；门禁 typecheck / 单测 498 / `verify:host` 全绿。 - **大幽灵存量的首诊清理从「分钟级卡死」改整棵重建（PR #21 评审补强）**：旧清理路径对 37.9 万条幽灵条目走 `ls-files -i -c` + 每批 100 条 `update-index --force-remove`，约 3797 次 git 子进程、每次重写巨型 index（168 MB 渐缩），估 10–60 分钟——升级后第一次快照仍会表现为「卡在正在计算变更」。现按 10000 条阈值切换：`read-tree --empty` 清索引、交给随后的 `add -A` 按新 exclude 整棵重建（`gcScript` 治 issue #18 同款技巧，index 是可重建缓存），实测 1.24 万条幽灵夹具首诊 **2 秒**完成；`read-tree` 失败显式 throw（静默失败会让幽灵条目随 exclude 已重写永久滞留、清理不再触发）。重解析点遍历另加 `if ($root)` 显式守卫：`ensureGitScript` 无 `$root`，原路径靠 `Push($null)` 抛错被 `catch` 吞掉的巧合跳过，现成为显式设计（三处主脚本随后在 `add -A` 之前重做发现，无漏检窗口）。 ## [2.4.9] - 2026-10-03 ### 变更 - **dsh 0.2.1-alpha.1 兼容**（升级核查见 [docs/upgrade-assessments/dsh-0.2.1-alpha.1.md](docs/upgrade-assessments/dsh-0.2.1-alpha.1.md) 与 [docs/compat-audit.md](docs/compat-audit.md) 头部 0.2.1-alpha.1 段）：全树内容级 diff（0.2.0-rc.2 整包残留作基线）确认插件注册/消费契约（chat.node 槽位与 props、`ChatNodeKind` 全集、`sessions.fork`/binding、`updateQueue`、设置双 slot）字节级相同——**无需改码**；peer 窗口 6 条 `dsh-*` 追加 `>=0.2.1-alpha.1 <0.3.0` 段（npm prerelease 门槛要求显式同 tuple 段；上限按发版决定放宽，覆盖 0.2 全线正式版），cordis 追加 `>=4.0.5-alpha.1 <4.0.6`、schemastery 追加 `>=3.18.5-alpha.1 <3.18.6`（两者产物除版本号外逐字节相同），`dsh.compatibility.dshReleases` 补 `0.2.1-alpha.1: compatible`；`docs/reference/` 镜像按 tag 重拉（13 源中 4 份实质差异：反向代理发布链接、桌面端系统分配端口 + invariant 移除文案、工具 delta 匹配语义与 `ConversationNodeDefinitionInput`、定时任务投递语义）。正向受益：官方修复插件启停时样式被误移除（`claimStyles`）与队列滞留（惠及 G1 周边时序）。门禁：`test:probe` 52/52、`verify:host` 装配断言全过、`check:dsh` 全绿。 ### 文档 - README 双语：兼容范围标注与 peer 窗口折叠块同步至 dsh 0.2.1-alpha.1（窗口上限放宽至 `<0.3.0` 的说明一并落地）。 - `docs/dsh-contract.md`：版本核验记录只保留最新（0.2.1-alpha.1），历次版本记录归口 compat-audit 与 upgrade-assessments，消除双写。 - 新增待实施计划 `docs/plans/pending/plan-refill-references.md`：引用 chip 回填（撤回后把被撤回消息里的 @文件/目录引用以可点击 chip 形式放回输入框；依赖 dsh 0.2.1-alpha.1 结构化草稿能力）。 ## [2.4.8] - 2026-10-03 撤回完成事件/回调（issue #19，方案见 [docs/plans/completed/plan-recall-event.md](docs/plans/completed/plan-recall-event.md)）：撤回到达终态时广播 cordis 事件 `dsh-recall/complete` / `dsh-recall/failed`，供同宿主任意插件监听（如长时记忆插件清理被撤回回合的记忆）。纯增量 opt-in：不订阅的插件零感知，撤回链路行为逐字节不变（事件发送失败、监听器抛错、下游慢执行均不影响主流程）。 ### 新增 - **事件契约（`src/types/events.ts`，单一事实源）**：`dsh-recall/complete`（`sessionId`/`childSessionId`/`scope`/`cutSeq`/`messageId`/`root`/`count`/`chatReverted`/`archiveRequested`/`time`，`version: 1`）与 `dsh-recall/failed`（`stage: 'execute' | 'fork'`/`sessionId`/`messageId`/`scope`/`cutSeq`/`root`/`code?`/`error`/`time`）。首发即稳定公共契约（非 experimental）：新增字段走 minor，破坏性变更走 major 且 `version` 升 2。payload 不含消息正文；事件名与契约文件的绑定由 `tests/types/events-contract.test.ts` 编译期双向断言维持（host 产物因 build-host 逐文件转译不覆盖 `types/`，事件名在 routes-core 本地字面量声明）。 - **host `notify` 端点（routes-core.ts）**：client 撤回终态上报的接缝——校验（缺 `status`/`sessionId`/`messageId` 复用 `RECALL_BAD_TYPE`，不加新错误码）→ `resolveRoot` 尽力 enrich（失败落 `null` 不阻断）→ `queueMicrotask` + try/catch 调 `ctx.emit`（下游抛错/慢执行不反噬端点）→ 恒 `{ ok: true }`。不进串行队列（零 git 操作）、不依赖 store（避开 lineage-record 的 NO_STORE 早退会吞事件的缺陷）；index.ts 以闭包注入 `emitEvent: (e, p) => ctx.emit(e, p)` 保持 ctx 不解构纪律。verify-host 端点白名单同步至 13 项（未同步时两处断言红灯，反向验证实测）。 - **client 终态上报（recall-node.ts + util.ts）**：`buildRecallNotify` 纯函数按语义决策表组装载荷（六场景矩阵单测直钉），`executeRecall` 五处上报点 fire-and-forget（`.catch` 静默）——execute 拒（透传 `code`）/ execute 抛 → `failed(stage:'execute')`；fork 抛错/返空 → `failed(stage:'fork')`（**绝不发 complete**，防下游误清该回合记忆）；撤回链完整走完 → `complete`（`chatReverted` 为对话是否真回退的判据）。STALE 自动重预览是中间态，不上报。版本错位容错：旧 host 无此端点时上报静默失败（404），撤回不受影响；旧版 client 从不上报。 - **README 双语「事件契约」章节**：事件名、payload 字段表、语义要点（STALE 不发、fork 失败只发 failed、`(sessionId, messageId, cutSeq)` 三元组幂等、隐私面）、semver 演进规则与版本错位矩阵、可直接粘贴的监听示例。 ### 测试 - `tests/unit/routes-notify.test.js`（11 例）：参数校验缺失码 / root enrich 成功·抛错·返空 / emit 异步广播与 payload 字段 / 监听器抛错仍恒 `ok:true` 且 `recordError` 留痕 / `stage`-`code` 语义。 - `tests/unit/recall-notify.test.js`（8 例）：`buildRecallNotify` 规格第一节六场景 + scope 透传与字段兜底。 - `tests/client/recall-node.test.ts` 追加 7 例：五处接线点的调用时机与载荷（含 STALE 不发 notify、上报失败静默不反噬主链）。 - `tests/types/events-contract.test.ts`：事件名字面量钉死、payload 形状断言、host 本地常量 ↔ 契约常量双向绑定、notify 端点返回类型双向绑定。基线 478 → 497（39 文件），client 83 → 90。 ## [2.4.7] - 2026-09-30 质量加固专项批次（[docs/plans/completed/plan-quality-hardening.md](docs/plans/completed/plan-quality-hardening.md) A1–A8，八项分四波：质量基建 → 数据安全 → 测试基建 → i18n）。2026-09-30 该计划连同 `plan-warmup-unhandled-rejection` 已归档到 `docs/plans/completed/`（活体冒烟第九节 R-1〜R-6 全过）。 ### 新增 - **i18n 双语层（A4）**：插件自绘界面全双语（撤回按钮与确认面板、toast、设置三张卡、快照树、最近错误），由新配置项 `locale`（`auto` / `zh` / `en`，默认 `auto` 按 `navigator.language` 判）控制，配置卡片新增「界面」分组的下拉、保存即生效。实现分三层：`src/client/locales/`（zh 事实源 + en + 纯逻辑 `t/translate/resolveLocale`，缺 key 依次回落 zh、key 本身）；host 文案键控化（错误响应按 `code` 查 `err.*`、最近错误按 `kind` 渲染、构建产物 root 停用提示改下发命中段名 `artifactSeg` 由 client 本地取词，旧中文字段保留一周期）；`tests/unit/locales-parity.test.js` 钉两语言 key 集合 / 占位符集合一致 + 静态扫描 client 源码里的字面量 key 漏配，`tests/client/i18n.test.ts` 钉 zh/en 两条渲染链与语言下拉的保存载荷。v1 明示限制（README「界面语言」节）：宿主官方设置表单自己渲染的 `Schema.description()` 仍是中文；带动态细节的 host 错误（回退失败的救援结果、具体校验原因、原始异常）原样展示 host 原文，不套本地化短句。 - **磁盘格式版本守卫（A3）**：影子仓库新增 per-store `format` marker（`SUPPORTED_FORMAT = 1`，缺席视为 1），读到更高版本或内容损坏时**拒写放行读**（fail-closed）——快照、撤回、tag 清理、索引落盘全短路并 `recordError`，快照列表 / 状态查询等只读路径不受影响，新错误码 `FORMAT_BLOCKED`（client 有对应文案）；marker 补戳挂在索引落盘路径（稳态零额外进程），读取带短确认缓存且只缓 affirmative 结果。配套通用 `fileReadCmd`（契约 + 双平台模板），替 A2 与后续小文件读取省掉逐个特化命令。 - **操作意图 journal 与崩溃恢复（A2，吸收 U4）**：撤回的 both 链「安全快照 → reset → 救援」中途断电时，安全快照 tag 已在磁盘却无任何记录指向它——新增 `src/host/intent-journal.ts`：execute 动磁盘前先写 `recall-intent.json`（messageId / safetyId / safetyOk / phase），回退成功即清；启动预热与 init 端点两处挂 `recover`：先做幂等判定（工作区与目标 tag 一致即只清记录不 reset），需救援时复用 H1 救援路径自动 reset 回安全快照并 `recordError` 留痕，`agentBusy` 忙时延后到下次 init。救援失败提示同时附上意图文件路径（U4 验收语义：中断点可查）。 - **client UI 测试体系（A1）**：vitest + jsdom 独立配置（`npm run test:client`，CI 新增同步骤），`tests/client/` 6 文件 82 例——撤回节点主链（25）、快照管理（17）、配置卡片（17）、排除卡片（13）、logger 开关（7）、i18n 双语链路（3）。断言纪律：只断行为与结构（className / aria / 调用次数 / fetch 载荷），不为文案字面量上锁（i18n 让路）。期间实测发现并修复一处真实缺陷（见「修复」）。 - **client 命名空间 logger（A5）**：`src/client/log.ts` 的 `createLogger(ns)` 前缀 `[dsh-recall:]`，error/warn 恒输出、info/debug 由 `localStorage['dsh-recall.debug']`（`*` 或逗号分隔命名空间，每次调用重读）开关——现场排查无需重启；localStorage 不可用时静默降级。替换全部 5 处裸 `console.*`，装配完成补一行 info（「Host 活 Client 死」类症状可一眼确认）。 - **`docs/format.md` 磁盘格式 spec（A7）**：逐文件固化存储布局与格式（tag 命名、index/lineage 的原子写与损坏语义差异、stamp 文件、format marker、意图 journal）、兼容纪律（读取侧字段可选化 / 未知字段忽略 / 高版本拒写），并写死「代码与本文漂移即 bug」约定；同时提前实施 plan-p2 的 FORMAT 半（SECURITY 半仍留 P2-2）。 ### 变更 - **开启 `noUncheckedIndexedAccess`（A6）**：编译期堵索引越界，修 14 处（含 `Map.get(...)!.push` 类断言），顺带清掉无注释的既有非空断言；由 CI 既有 typecheck 步骤自动成门禁，不连带开其他严格 flag。 - **catch 理由注释纪律（A8）**：协作规约新增「catch 必须附降级理由（为什么吞、为何安全、谁兜底）」，全 src 143 处 catch（host 99 + client 44）逐处审计补注；未发现「吞错 + 无 recordError + 无注释」的真问题；不设 CI 启发式门禁（误报高，靠规约 + review）。 - 配置 schema 增至 10 字段（新增 `locale`，不列进 `cordis.patch.yml`——它按行覆盖、默认值随 schema 下发）；`init` 响应与 `config-get` 的 config 子集同步下发 `locale`（老 Host 缺字段时 client 按 `auto` 解析）。 - 「最近错误」区按 host 的 `kind` 渲染本地化提示（原来的中文原文保留在条目 `title` 上），未分类错误仍原样展示 host message。 ### 修复 - **win32 上磁盘格式守卫会把正常快照库锁死（严重，随本批次实弹掘出）**：新增的通用 `fileReadCmd` 用 `Get-Content -ErrorAction SilentlyContinue` 读文件，而 PowerShell 对**缺席文件**即使吞掉报错仍以退出码 1 收尾（pwsh / Windows PowerShell 5.1 双实测）——runShell 的退出码门禁把它当执行失败抛出，格式守卫便把一个还没有 `format` 标记的正常 store 判成「标记读不到」；由于守卫同时挡在快照捕获与索引落盘上，补戳永远写不下去，**快照、撤回、快照列表载入全部停摆且不可自愈**（POSIX 侧靠 `cat … || true` 无此问题）。修复＝读取命令改用 `Test-Path` 分支让缺席以成功收尾（与 POSIX 同语义），并补契约文本钉防回归；沉淀为 compat-audit **I41**。 - **宿主退出期插件可能中断宿主（fatal load failure）**：启动预热是 fire-and-forget 的异步 IIFE，宿主在预热途中卸载（`dsh --profile headless --help` 打印帮助后立即退出、HMR、装配门禁 dispose）时访问 `sessions` 会抛「inactive context」，未接的 promise rejection 被 cordis 加载器记成 fatal。修复＝IIFE 整体接 catch 并保留诊断行（`recall warmup skipped: …`）；该项同时关闭了既有待办 [plan-warmup-unhandled-rejection](docs/plans/completed/plan-warmup-unhandled-rejection.md)。 - **格式守卫的读失败文案不再指认「文件损坏」**：读失败（多为宿主启动早期 shell 未就绪）与标记内容非法此前共用一句「不可读或内容非法」，会把用户引向一个没有问题的文件；现按「高版本 → 请升级插件 / 内容非法 → 检查 format 文件 / 读不到 → 环境未就绪、下一条消息自动重试」三分。 - **i18n 切换语言的三处半截生效（浏览器实弹掘出）**：① 英文确认句里「发送时状态」与「共 N 个文件将变更」两句拼接缺空格（`sent.1501 files`）；② 语言切换后设置卡片的两个分区折叠头（排除配置 / 快照管理）停在挂载时语言，要离开再回来才跟上；③ 保存成功提示用切换**前**的语言。修复＝英文词条补句首空格、配置表单在语言落地时回调设置外壳重渲染、语言补丁先本地落地再报成功；三处均补进 client 组件测试。 - **回退失败时不再吞掉救援结果**：此前的码文案表把 `ROLLBACK_FAILED` 一律显示成「回退失败」四字，会盖掉 host 侧更有用的信息（「已自动恢复到安全快照，请重新预览后重试」或手动救援命令）。A4 起 `err.*` 词典只收 host 文案静态的错误码，`ROLLBACK_FAILED`（连同 `BAD_TYPE` / `SETTINGS_WRITE_FAILED` / `PARTIAL_DELETE` / `ERROR`）回落 host message 原文——中文用户看到的是更完整的救援结果与逃生命令，代价是英文界面下这几类错误可能中英混排（策略与理由见 README「界面语言」）。 ## [2.4.6] - 2026-09-29 ### 变更 - **兼容声明同步 dsh 0.2.0-rc.1（零破坏核验，无代码改动）**：全局实装 `@deepseek-ai/dsh@0.2.0-rc.1`（npm dist-tag `next`，0.2.0 系列首个候选版本、汇总自 `v0.1.7-rc.2`；`latest` 仍是 0.1.7-rc.2，**装最新版必须显式写版本号**）后，以**全树逐文件哈希 diff** 核验——npm 清理失败留下的 `.dsh-EBhnoWNL` 残留正好是 0.1.7-rc.2 整包副本（298MB），直接用作基线（比对后已删除）；528 包中 310 包仅版本号 lockstep 变更，类型面 65 改 / 23 增 / 0 删，运行时 JS 71 改 / 11 增 / 2 删。插件消费面**零破坏**：`dsh-shell`/`dsh-settings`/`dsh-session-query`/`dsh-agent`/`dsh-client-connection`/`dsh-host-webserver`/`dsh-sandbox-policy`/`dsh-client-ui-slots`/`dsh-client-ui-renderer`/`dsh-client-ui-settings-plugins`/`dsh-pwsh-local`/`dsh-cordis-host-runner`（插件加载面）等内容字节级一致，消费面符号计数 11 项 0 差异（`readAttachment`/`updateQueue`/`archiveSession`/`openSession`/`createDrafts`/`releaseDraftAttachments`/`setDraft`/`addAttachments`/`stopActivity`/`increaseTitle`/`atSeq`），`plugins.bundle.config` 槽位定义与渲染调用逐行一致（`settings.plugin.item` 两版均 0 命中）。**唯一接口增量**是 `sessions.fork` 的可选 `onCreated`（向后兼容、插件不传）；真增量集中在插件管理页 UI（刷新反馈/安装输入清洗）、`config-editor` 配置继承值计算、会话标题「未命名」语义、消息提交埋点，以及 `dsh-session` 的工具结果修复链重构（`ToolCallRecovery`，插件 `cutSeq` 恒取平衡前缀、不触发补闭合分支）。门禁：`check:dsh` 四层全绿、`test:probe` 52/52、`verify:host` 装配断言全过、`typecheck` 通过、`npm test` 436/436。**活体冒烟（真宿主 + 浏览器实弹，link 模式 / `D:\tmp\recall-h0`）逐项通过**：插件经启动期兼容门禁激活（同 profile 的第三方 `dshmarket@1.65.1` 因 peer 只到 `^0.1.2-alpha.2` 被跳过，反证门禁真实生效）；撤回全链（面板清单、文件回退、安全快照 `snap-pre-rollback-*`、lineage、子会话打开、标题继承无递增、文本回填、无残留排队项、原会话归档）与设置页（配置卡完整渲染、`保存`/`恢复默认` 双向回读一致、快照树两级展开与版本家族聚族、`立即 gc`「gc 完成」）均正常，dsh stderr 零插件报错。同步项：**peer 范围必须新增 tuple** `|| >=0.2.0-rc.1 <0.2.1`（npm 的 prerelease 门槛要求同 tuple 且带 prerelease 的比较器，既有 `<0.1.8` 段放行不了 `0.2.0-rc.1`；不扩范围则启动期兼容门禁会整行跳过本 bundle）、`dshReleases` 补 `0.2.0-rc.1: compatible`、`docs/reference/` 镜像按 `dsh-v0.2.0-rc.1` tag 重拉（13 源中仅 `09-architecture.md` 有实质差异：新增一行「失败步骤会记录缺失的工具结果」，净 +121 字节）、`docs/dsh-contract.md` 对应版本与 compat-audit 头部核验段同步、README 双语徽章与兼容范围同步，评估实证见 `docs/upgrade-assessments/dsh-0.2.0-rc.1.md`。观察项（不阻塞）：`fork.onCreated` 可更早拿到 childId（插件当前不需要）；**自动化任务改由可选 bundle `dsh-experimental-schedule-bundle` 提供、默认关闭**，用户如需须在插件管理页开启。 - **兼容声明同步 dsh 0.1.7-rc.2（零破坏核验，无代码改动）**：全局实装 `@deepseek-ai/dsh@0.1.7-rc.2`（npm dist-tag `next`，rc.1 后 346 提交）后，以**聚焦消费面的内容级 diff** 核验——`npm pack` 下载 28 个包（全部 peer + 全部消费点所在包 + 官方 bundle）的 rc.1 版本，与 rc.2 树做全文件 SHA256 比对并逐行核对契约/实现差异；叠加**符号级复核**（13 包 × 23 符号在新旧树计数逐项相等，0 差异）。插件消费面**零破坏**：`api-session-controller` 的客户端契约目录（`lib/types/client/**`：fork/updateQueue/readAttachment/binding/archiveSession）**不在变更清单**，`dsh-shell`/`dsh-settings`/`dsh-sandbox-policy`/`dsh-host-webserver`/`dsh-pwsh-local`/`dsh-client-connection`/`dsh-client-modules`/`dsh-client-ui-renderer`/`dsh-client-ui-session`/`dsh-client-store`/`dsh-host-plugin-inventory`/`dsh-api-gateway` 12 个核心接缝包仅动版本号与 i18n 元数据；真增量集中在本版新能力与官方 UI 层——模型选择/账号（`initializeDefaultModel`/`hasProviderApiKey`/`requireModel`）、工具热更（`dsh-session` 纯新增 `ToolHistoryProjection`、`ui-chat` 新 node kind `developer-message`）、工作区快捷键与归档筛选三态、额度提示链、`app-boot` 的跳过报告时机（判定逻辑未变）、`ui-primitives` 样式重构，均为插件不消费处。门禁：`check:dsh` 四层全绿、`test:probe` 52/52、`verify:host` 装配断言全过、`typecheck` 通过、`npm test` 436/436。同步项：`dshReleases` 补 `0.1.7-rc.2: compatible`（peer 范围 `>=0.1.7-alpha.1 <0.1.8` 天然覆盖，无需新 tuple）、`docs/reference/` 镜像按 `dsh-v0.1.7-rc.2` tag 重拉（13 源中仅 `09-architecture.md` 有实质差异：3 处替换、净 +55 字符，含工具热更新增说明）、`docs/dsh-contract.md` 对应版本与事件集来源标注、compat-audit 头部核验段与 I33 增补、README 双语徽章与兼容范围同步，评估实证见 `docs/upgrade-assessments/dsh-0.1.7-rc.2.md`。观察项（不阻塞）：`session-query.read()` 新增显式抛 `SESSION_QUERY_CORRUPT_SESSION`（降级链保持 try/catch）；新 node kind `developer-message` 不被插件 key `['user','steering']` 命中；归档筛选三态不改 `archivedSessionIds` 语义（I37 判据继续有效）；`initializeDefault(signal)` 签名破坏性变更（插件零消费）；升级操作陷阱——Windows 上 npm 替换全局 bin shim 遇占用只留哈希名半成品，需手工改回标准名恢复 `dsh` 命令。 ## [2.4.5] - 2026-09-24 ### 新增 - **插件管理页图标（package.json 顶层 `icon`）**：新增 `assets/icon.svg`——形状沿用撤回按钮的 `UndoIcon`，画布 20×20、单色 `#658EFF`（官方品牌渐变的蓝端）。三处版面调整：① 两条侧翼从箭尖算起缩短 30%（对角分量 4 → 2.8，箭尖与尾部回环保持原位，不用整体缩放以免尾部一起变小）；② 尾端水平线向左延长到 x=6.3，与侧翼端点在竖直方向对齐；③ 整组上移 1.1（组 `transform`，路径坐标不动），使几何 bbox 中心落在画布中心 (8, 8)，上下留白对称。颜色必须写死：宿主把图标转成 base64 data URL 后以 `` 隔离渲染，`currentColor` 不继承会退化成黑色；该色在浅底（对比 ≈3.1:1）与深底（≈5.5:1）都清晰，无需主题分支。宿主 `dsh-app-boot` 的 `readPluginMeta` 读**包导出的 `package.json` 顶层 `icon` 字段**（判据：相对路径、SVG/PNG/JPEG/WebP、≤256 KiB、realpath 后仍在包目录内、常规文件），读取失败只留 metadata error 且标题/描述照常；渲染位置是**插件管理页**的 bundle 卡片与详情页头部（36px），不是设置对话框的插件 tab（后者只解析 `meta.title/description` 多语言文本）。`files` 白名单加 `assets`，`package-layout` 单测补声明合法性 + 随包发布断言——否则图标文件不进发布包、宿主只报 metadata error，线上静默无图标。 - **设置页快照管理：搜索框与树节点整行展开**：搜索框加高 20%（34 → 41px）并在框内左侧内嵌搜索图标（绝对定位 + `pointer-events:none`，输入框以 `padding-left` 让位；高度覆写只 scope 到搜索行，排除配置的快速添加框维持原高）；快照树的工作区/会话行整行可点即展开/收起（原先只有 18px 折叠箭头可命中，用户实测反馈难点），行内删除与「切换」按钮各自 `stopPropagation` 不连带折叠，折叠箭头仍是键盘与读屏入口（`aria-expanded` 不变）。 ### 变更 - **快照树删除按钮图标化并移到名称之后**：文本 chip「删除」改为垃圾桶图标（48 viewBox 路径、`stroke:currentColor` 随主题，20px 命中区、静息 `label-tertiary`、hover 转 error 色 + 危险底色），位置从行尾移到工作区/会话/快照名之后——原先删除 chip 逐行右对齐成一列、与行内容分离易点错行；「切换」留在行尾（导航动作与危险动作分开摆放）。`title` 与 `aria-label` 保留完整语义，图标 `aria-hidden`。 - **设置页整体重做，与 dsh 设计语言对齐**：去掉外层「撤回插件」可折叠卡与卡片外框，设置项直接平铺（两轮收敛：先去折叠头、再去外框，用户实测反馈两层包裹皆属冗余）。配置表单改三列网格（标签 | 控件 | 说明）：说明文字原先按流跟在宽度不一的单位 tag 之后，起笔位置逐行参差（实测「gc 触发条数」与「gc 触发小时」对不齐），改由列宽统一给定，并以 `padding-top` 与 34px 控件行共用中轴；开关行右缘对齐数字行输入框的右边框（关系由 `--dsh-recall-input-w` / `--dsh-recall-switch-w` 两个令牌承载），开关行的状态 tag 因此与数字行的单位 tag 同起点；字段标签与控件行垂直居中（label 用 34px 行高对齐控件行中轴）。折叠分区（高级：基础排除表 / 排除配置 / 快照管理）标题升为与分组标题同款 14px/700，chevron 收到行尾使标题与分组标题共享同一左缘，首项折叠头加分割线（用绝对定位伪元素绘制——`border-top` 会沿 cardbtn 的 12px 圆角走、两端上翘）；表单分组标题加粗放大（14px/700 + label-primary）。交互侧补齐：输入类 hover 中间态（rest `l4` → hover `l3` → focus `brand`）、按钮按下态、卡片与分区展开 `unfold` 入场（`prefers-reduced-motion` 同步豁免）、开关 hover 提亮、空状态居中留白；图标语言统一为 SVG（字符 `▸/▾` 跨平台字形不一，退役）。 - **设置项文案精简与标签改名**：九条字段说明改为短句（「填写 0 表示不限制 / 不启用」等语义与输入框右侧单位 tag 全部保留），「撤回后回填输入框 / 撤回后归档原会话」简化为「回填输入框 / 归档原会话」；顺带删掉基础排除表说明里遗留的计划代号。 - **撤回按钮图标同步新版形状**：`src/client/recall-node.ts` 的 `UndoIcon` 与 `assets/icon.svg` 取同一套坐标——两翼从箭尖算起缩短 30%、尾端水平线延到与侧翼端点同列（x=6.3）、整组上移 1.1 居中；内联规格刻意不变（16 声明尺寸、`stroke` 1.4、`currentColor` 随按钮文字色，即保持原有大小/粗细/颜色）。两处形状自此需同步改（`UndoIcon` 上方有同步注释）。本版 `lib/client.js` 重建为 120644 字节（含设置页 UI 重做）。 ### 修复 - **新版 Edge/Chromium 下开关与其它圆形元素被全局超椭圆圆角接管（观感「更方」）**：`dsh-client-ui-theme` 在 `@supports (corner-shape:superellipse(1.5))` 内给 `*,:before,:after` 下发 `corner-shape:var(--dsw-corner-shape)`——支持该属性的内核把**所有**元素渲染成超椭圆（squircle），旧内核（如 IDE 内置浏览器，不认该属性）则维持普通圆角，同一份 UI 因此在不同浏览器观感不同（用户实测反馈）。官方为此在 104 处圆形/胶囊元素上显式写回 `corner-shape:round`（含 `Switch.module.css` 的轨道与拇指、Tag 胶囊、StateDot、spinner），本插件漏写。修复＝开关轨道、开关拇指、`ex-chip`、`health-pill`、消息 hover 圆形按钮五处补 `corner-shape:round`；矩形元素沿用全局 squircle（与官方同策略）。注意此类差异**量不出数值**：DevTools 里两侧的 `getBoundingClientRect` / `border-radius` / `padding` 完全一致，差异只在角部形状。 - **点击设置项标签会直接触发右侧控件**：`label[for]` 与控件建立关联后，点击标签等同点击控件——开关（`button` 属 labelable 元素）被误切换、数字输入框被抢焦点（用户实测反馈）。修复＝标签改 `span`、控件改挂 `aria-labelledby` 指向标签 id（可访问名保留、读屏不弱化），numRow / boolRow / 基础排除表 textarea 三处同改；撤回确认面板的 scope 单选组保持 label 包裹写法（选项组的有意设计）。 - **字段标签与自己的输入框错开一行**：label / 控件行 / 说明文字各自为 grid item 时，说明占掉控件行的下一行会把后续 label 的自动放置顶到前一字段的说明行上（实测「gc 触发条数」标签偏上）。修复＝三列网格下每字段恰好「标签 / 控件 / 说明」三个 item，label 与控件同排。 ## [2.4.4] - 2026-09-24 ### 修复 - **反向代理子路径部署下插件全部调用失效（端点路径写成了根绝对路径）**：dsh 0.1.7-rc.1 起官方支持「Web 挂在反向代理子路径」，口径是客户端把服务端路径按**文档基址**解析——index 由 `dsh-host-frontend-static` 注入 ``、前端资源改相对引用、`dsh-api-gateway` 用 `streamBaseUrl ?? document.baseURI`、connection RPC 直接 POST 去前导斜杠的相对路由。插件客户端原先硬编码根绝对 `fetch('/api/recall/')`：子路径部署下浏览器会越过前缀打到代理未映射的根，预览/撤回/快照管理/设置卡片全部失效。实弹（真宿主 + 只映射 `/dsh/*` 的反向代理）：带前缀 `POST /dsh/api/recall/status` → 200、根绝对 `POST /api/recall/status` → 404。修复＝新增 `src/client/util.ts` 的 `recallApiUrl(name, base?)` 统一解析端点 URL（基址缺尾斜杠按目录补齐，避免直接访问 `/dsh` 时前缀被当作文件名吞掉；无 `document`／基址非法回落原根绝对路径，旧环境行为不变），`api()` 唯一调用点改走它。Host 端零改动——代理剥前缀后宿主见到的仍是 `/api/recall/*`，exact 路由照常命中。配套 5 条单测（根/子路径/多级/缺尾斜杠/回落 + fetch 桩钉调用点 URL）与 3 条探针（I40：`` 注入、前端资源相对引用、官方 `document.baseURI` 对照），台账见 compat-audit I40。 ### 变更 - **兼容声明同步 dsh 0.1.7-rc.1（零破坏核验，无代码改动）**：全局实装 `@deepseek-ai/dsh@0.1.7-rc.1`（npm dist-tag `next`）后以**全树内容级 diff** 核验——升级前对 alpha.2 整包做快照，升级后比对得 915 条变更（853 改 / 49 增 / 9 删 / 4 重命名）、647 个非 package.json 文件有真实内容差异（其中 320 个为随包 LibreOffice 运行时）。插件消费面**零破坏**：`dsh-session`/`dsh-session-query`/`dsh-shell`/`dsh-pwsh-local`/`dsh-sandbox-policy`/`dsh-host-webserver`/`dsh-client-connection`/`dsh-client-modules`/`dsh-settings`/`dsh-agent{,-loop}`/`dsh-attachment{,-local}`/`dsh-workspace` 等 24 个包与整个 cordis vendor 栈内容字节级一致（仅版本号），三个关键契约文件（`ui-chat`/`ui-conversation` 的 `contract/slots.d.ts`、`api-session-controller` 的 `contract/session.d.ts`）**SHA256 相同**；真改动集中在 `ui-chat`（工具调用准备态/本地图片预览）、`ui-conversation`（`RunningToolCall` 拆 preparing/start 两阶段、瞬态 start 语义）、`api-session-controller`（assistant 流退休记账）与 `ui-plugin-manager`（host 侧安装/失败类型），均不在插件消费面（插件不定义 ConversationNode、不消费工具调用类型）。**本版新增机制**：启动期插件/runtime 兼容性门禁——按 `peerDependencies` 中 `@deepseek-ai/dsh[-*]` 条目用 `semver.satisfies(runtime, range, { includePrerelease: true })` 判定，不兼容的行启动期整行禁用（可由 profile `compatibility.json` 或 `dsh plugin allow-version` 豁免），安装命令在 pnpm 前预检；本插件 6 条 peer 实测放行 0.1.7-rc.1、无需豁免（`dsh.compatibility.dshReleases` 仍是市场台账声明，非安装门禁）。门禁：`test:probe` 49/49、`npm test` 430/430、`verify:host` 装配断言全过、`typecheck` 通过、`build` 产物零漂移。同步项：`dshReleases` 补 `0.1.7-rc.1: compatible`（peer 范围 `>=0.1.7-alpha.1 <0.1.8` 天然覆盖，无需新 tuple）、`docs/reference/` 镜像按 `dsh-v0.1.7-rc.1` tag 重拉（13 源中仅 11 号对话节点文档有实质差异 +182 字符）、`docs/dsh-contract.md` 与 compat-audit 头部版本字段同步、README 双语徽章与兼容范围同步，评估实证见 `docs/upgrade-assessments/dsh-0.1.7-rc.1.md`。观察项（不阻塞、均非回归）：peer 区间升级为启动硬门槛（新 minor 线需先核验再开窗）；子路径部署与 SSH 远端工作区两个新场景下插件未验证（插件 API 走绝对路径、影子仓库假定本机文件系统）。 ## [2.4.3] - 2026-09-23 ### 修复 - **有后台任务在跑时撤回，原会话归档静默失败、还会被完成通知唤醒继续跑（幽灵执行）**：`dsh-workspace` 的归档对「有活动在跑」的会话**默认拒绝**——先经 `workspace/session-activity` 瀑布问 agent 回合 / `dsh-jobs` 后台作业 / `dsh-subagent` 子代理 / `dsh-schedule`，命中即抛 `workspace/session-active`；只有 `archiveSession(sessionId, { stopActivity: true })` 才改成「先停后归档」（`workspace/session-stop` → jobs 以 `kill(id, owner, "session archived")` 收尾，结算 `cause: 'kill'`）。插件旧写法既不传该选项、又用 `.catch(() => {})` 把拒绝吞掉，于是「模型起了后台作业 → 用户撤回」这条路下：原会话静默不归档（仍留在列表）、作业继续跑，且 `cause: 'kill'` **不在** `dsh-tool-jobs` 抑制通知的 `teardown` 之列 → 完成通知投递给处于 idle 的源 agent → `followup(...)` 在**文件已回滚**的原会话里开新一轮。修复＝归档改传 `{ stopActivity: true }`（官方 UI「停止并归档」同款语义：撤回即这一版作废），并把失败从静默吞掉改为 `console.warn` 留痕——归档失败意味着原会话留在列表且可能继续跑，属用户可见降级。旧版 dsh 客户端面只有 `sessionId` 一个参数，多传实参在 JS 侧无害。配套：探针新增客户端 `options?: { stopActivity?: boolean }` 与 `workspace/session-active` 拒绝语义断言（I7）；I12 探针由「已消失的旧路径静默 skip」改为双代面 + fail-loud（两代 slot 契约至少一条在位，新面 `plugins.bundle.config` 首次纳入断言），探针 46 → 49。 ## [2.4.2] - 2026-09-23 ### 修复 - **CI 单测缺 `@deepseek-ai/schemastery` 致 4 个测试文件收集失败**：`src/host/config.ts` 在运行时裸导入 `@deepseek-ai/schemastery`（Config schema 本体），但它此前只是 peerDependency——本机靠工作区 junction 解析所以本地全绿，CI `npm ci --legacy-peer-deps` 不装 peer 即 `ERR_MODULE_NOT_FOUND`。M2 起 manage-list/manage-list-stale/manage-usage/settings-bridge 四个单测文件经 routes-manage/config 链传递依赖 config.ts，而 0.1.7 适配批次（M1 起）当天才首次推送过 CI，问题首次暴露。修复＝schemastery 入 devDependencies（`^3.18.3`，与 `.volatile()` feature-detect 的下限对齐；peer 声明 `^3.18.1` 不动）。**对 2.4.1 已发布包零影响**：生产环境 schemastery 由宿主 dsh 提供，此缺包只影响 CI/裸克隆环境的单测。AGENTS.md junction 约定同步更新（schemastery 不再需要 junction；npm install 会修剪 dsh-settings junction，已记录重建方法）。 ### 变更 - **兼容声明同步 dsh 0.1.7-alpha.2（零破坏核验，无代码改动）**：本版为体验/稳健性版本，插件消费面经全树内容级 diff 实证零破坏——`updateQueue`/`readAttachment`/`QueueAction`（含 `{kind:'remove'}`）签名行逐字一致，`conversation.chat.node` 与 `ConversationNode`/`records` 槽位契约字节未变，`__ModuleLoader__.load({id, factory})` 注册形态与 `plugins.bundle.config` 在位，fork 实现与切点校验未动；`dsh-session`/`dsh-shell`/`dsh-pwsh-local`/`dsh-sandbox-policy`/`dsh-host-webserver`/`dsh-client-connection`/`dsh-agent{,-loop}` 与整个 cordis vendor 栈（含 `cordis-plugin-loader`）字节级未变，改动全部落在官方 UI/工具层（滚动跟随、历史分页 Turn 对齐、本地回声记账、队列消息重编辑、持久 pwsh 等待修复、工具结果 token 预算）。门禁：`test:probe` 46/46、`npm test` 430/430、`verify:host` 装配断言全过、`typecheck` 通过。同步项：`dshReleases` 补 `0.1.7-alpha.2: compatible`（peer 范围 `>=0.1.7-alpha.1 <0.1.8` 天然覆盖）、`docs/reference/` 镜像按 `dsh-v0.1.7-alpha.2` tag 重拉（13 文件零差异）、`docs/dsh-contract.md` 与 compat-audit 头部版本字段同步，评估实证见 `docs/upgrade-assessments/dsh-0.1.7-alpha.2.md`。已知观察项（不阻塞）：`dsh-tool-jobs` 唤醒次数上限默认放开（`maxConsecutiveWakes` 无默认值）使 P0-1 `agentBusy` 守卫的 idle 窗口概率上升，留实弹观察。 ## [2.4.1] - 2026-09-23 ### 修复 - **无快照的残骸仓库现在能被 gc 回收（issue #18）**：快照在 `git add` 与打 tag 之间失败会留下一批无 tag 可达的 blob，而 `.git/index` 仍逐条指着它们——`git prune`/`git gc --prune=now` 以 refs **+ 暂存 index** 为可达根，`git fsck --unreachable` 也报 0 个不可达（实测 5000 条 index + 0 ref 时输出 0 行），于是这类仓库一个对象都回收不掉，实测单工作区残留 78.4 MB 一根毛不减（POSIX 侧同结论）。修复＝两套模板的 `gcScript` 在 `gc` 之前加条件块：`for-each-ref --count=1 refs` 为空**且** `ls-files` 非空（= 没有可回退快照的纯残骸）时先 `read-tree --empty` 清 index 再 gc。为什么条件必须两条：有 tag 时 index 是 diff/rollback 依赖的「当前清单」，绝不能清；而 index 本身是可重建缓存，snapshot/diff/rollback 三处开头都先 `add -A`。修复后实测同一残骸库 78.4 MB → 0（残留 1 个空树对象），有 tag 的仓库 gc 后 refs/index/tag 可解析性原样，win32 与 Git for Windows bash 双侧 6/6 通过。 - **posix oversize 的 find 括号写错，超大文件剔除在 Linux/macOS 上静默全废**：`find` 的 `(`/`)` 被写成 `"\("`/`"\)"` 放进数组元素——引号内是数据，bash 不剥反斜杠，find 收到两字符 token 直接报 `paths must precede expression` 退出 1；报错被 `2>/dev/null` 吞、管道零输出、xargs 空跑、`|| true` 兜底，整条剔除 100% 静默空转（比优化前更糟：连原有的慢扫都没有，且零报错）。修复＝括号改单字符数据 `'('`/`')'`，并加外层 `-type d` 限定让 prune 只剪目录（否则与排除目录同名的大文件 `dist`/`target` 会被 `-name` 一并剪掉；pwsh 侧只对 `EnumerateDirectories` 判名，两侧同语义）。契约单测同步改钉修复后的形态。 - **pwsh `gcScript` 漏查 `$LASTEXITCODE`，gc 快速失败被误报成功**：pwsh 对原生命令非零退出不抛（EAP 不作用于 native），`git gc` 失败（磁盘满/锁冲突/杀软锁 pack）后脚本继续写 `gc.stamp`、输出 `GC_OK`、以 0 退出；`runShell` 只看进程退出码，于是 maintenance 把失败记成成功、推进完整 gcHours 周期——上条退避修复在 Windows（PS 5.1 与 pwsh 7 实测同结论）对快速失败完全失效，`gc.stamp` 这份跨重启的节流凭据也是假的。修复＝gc 之后显式 `if ($LASTEXITCODE -ne 0) { throw ... }`（同 `rescueScript`/`diffScript` 既有写法）；posix 版有 `set -e`，天然正确。契约单测新增「gc 失败必须可见」断言。 - **gc 失败后走退避重试，不再推进完整 gcHours 周期（快照仓库 GB 级膨胀的根因）**：实测一台重度机器上单工作区影子仓库积到 **3.35 GB loose 对象、in-pack 恒 0**——定期 gc 从未成功完成过。机制：`runGc` 失败（超时/磁盘/杀软）也把 `gcLastAt` 推进到此刻，等于失败一次就放弃整个 gcHours（默认 24h）周期；期间对象继续堆积，下一次 gc 只会更重、更容易超时，「失败→整天不重试→更重→更易失败」滚雪球，对象库永远压不进 pack。修复：失败只把 `gcLastAt` 回拨到「此刻 − gcHours + GC_RETRY_BACKOFF_MS（30 分钟）」，退避窗口后自动重试；成功维持原有「推进到此刻」语义；退避期间 gcCount 条数门槛照常生效，不会退化成「每条消息都重试」。`runGc` / `runGcAll` 两路径同修。新增 `tests/unit/maintenance-gc-backoff.test.js` 4 例钉住成功/失败/节流三条语义。 - **超大文件扫描（oversize）跳过被排除的大目录子树（两平台）**：原先 .NET 手动栈 / `find` 全工作树递归，`node_modules/`、`target/` 等已排除目录照样被逐文件 stat——一个 11943 个文件、10.96 GB 的 Rust `target/` 让每条消息的快照都多付一次全树扫描（I/O 风暴实测可拖垮宿主全部 HTTP 接口）。修复：把 exclude 表里 basename 形式（无通配、无内部斜杠、非 `!` 反选）的 pattern 按 gitignore 语义转为「任意层级同名目录整棵跳过」（pwsh 压栈过滤 HashSet；posix 转 `( -type d ( -name A -o -name B ) ) -prune -o` 前缀）；复杂 pattern 不参与跳过、回退全扫该子树——多扫不漏检，fail-open 语义不变。 - **`package-layout` 单测兼容 npm 11+ 的 `pack --json` 输出形状**：新版输出 `{<包名>: {...}}`（旧版为数组 `[{...}]`），原解析取错层导致 `files` 恒空、两断言恒红。两种形状都取首个条目。 ### 变更 - **settings 旧面注册接线拆出为 `src/host/settings-bridge.ts`，并补上 CI 可跑的回归单测（防盲区）**：c3cc8a7（旧面注册 entry 先解 volatile ref）此前只有依赖本机 dsh 的 `verify:host` 与 M5-5 降级实弹能覆盖——它恰恰是从全部 M1–M4 门禁漏出、被实弹才抓到的缺陷类。接线本体（两代面分派 + installSettingsSection/installSection/register 三条旧面路径 + 新面 volatile 热更挂接）移入新模块并把 `dshSettings` 改为参数注入（模块不 import 私有 peer，生产路径不变：`index.ts` 裸导入后传入），`tests/unit/settings-bridge.test.js` 新增接线级 5 例：带 `{ get() }` ref 的假 config 走三条旧面注册路径时，收到的 entry（含 register 的 `base` 与卸载回退 source）必须是解过 ref 的普通值、新面挂 volatile-update 原样重读入口 config、接线抛错走 skip 记录。变异验证：临时还原回归形态（entry 不解 ref）三条路径测试全红。`index.ts` 有效行数 329 → 298（棘轮下降）。曾评估 verify-host 旧面 pass 直接喂 ref 形态 config 的替代方案——实测 cordis 的 config 校验入口先抛 `expected number but got object`（真实现场的 ref 化发生在 loader 校验之后的私有路径），无法在不假红的前提下复刻，故单测为该回归的唯一 CI 防线。 - **适配 dsh 0.1.7-alpha.1 的两处破坏性接缝（双分支共存，老版本行为不变）**：0.1.7 把插件依赖的两个接缝整体换代，本插件在同一次发布里同时支持旧线与新线——① **shell 执行接缝**：`ShellExecutor` 删除 `run`/`start` 抽象方法，改为 `resolve(request)` + `execute(spec)` → `ShellExecution.result()`；旧调用在 linux/darwin 上会抛 `shell.run is not a function`（建仓/快照/diff/回退/gc/索引读写全链失败、撤回不可用），win32 上则被方言探针的 catch 折成「误判 bash」走自建直连通道（功能侥幸可用但打误导日志）。修复＝`runViaExecutor` 按**运行时方法探测**分流（`run` 优先 → `execute` 兜底），两分支共用同一 spec 构造与同一失败分级，并把 0.1.7 新增的 `exitCode === null`（准备期超时/信号终止）单独归类成「命令准备期超时」而不是不可读的 `exit null`。② **settings 接缝**：`dsh-settings` 导出面只剩 `SettingsForms`（`installSettingsSection`/`installSection`/`register` 全树移除），插件原三分支在 0.1.7 上**静默 no-op**（namespace 不注册、热更失效、设置卡片读不到覆盖字段、保存与恢复默认必失败）；新面按 **profile 条目 id**（本机实测为 `recall`）经 `describe`/`update`/`replace` 读写，可写字段必须在 schema 上标 `.volatile()`（schemastery ≥3.18.3 才有，插件 feature-detect），热更经 loader 提交引用后派发的 `loader/volatile-update` 驱动，取值多一层 Volatile 解包。分流判据取「旧注册入口是否缺席」——只看 `describe`/`update` 是函数分不了流（旧面同样有），误判会让 0.1.6 上的卡片失联。探针按新实现重钉（shell 接缝、settings 面、volatile 热更与 `Fiber.entry` 形状），`verify:host` 桩升级为两个 pass（含「只给新面（无 `installSection`）也必须装配成功」——这正是本轮换代被自家桩掩盖的根因），compat-audit 新增 I38/I39，镜像与兼容声明同步到 0.1.7-alpha.1。 - **「立即 gc」起按磁盘枚举覆盖全部快照仓库，并回收空仓目录（issue #18）**：`runGcAll` 原先只遍历内存缓存（启动预热与历次操作认识过的工作区），会话已删、或从未在本进程 init 过的仓库在磁盘上有、内存里没有——那些恰好是 issue #18 的 GB 级残骸，此前完全不被 gc 覆盖。修复＝注入 `dumpStores`（一条 shell 枚举容器子目录与降级候选目录）后取「内存 ∪ 磁盘」并按 git-dir 去重逐仓 gc；gc 之后追加**空仓目录回收**：仅当 index.json 明确解析为空数组、磁盘无 `snap-*` tag、内存无对应快照三条全中时，用 `legacyRmScript` 把整个 store 目录删掉（不可逆，删前 `console.error` 留痕；entries 为 null 即索引缺失/损坏的隔离现场一律不删）。实测（真实 store 目录、win32 pwsh）：残骸仓库对象 202 → 1 后目录被删，有 tag 的仓库目录与 tag 原样。 - **工作区根自身是构建产物目录时不再建快照（issue #18）**：`baseExcludes` 是相对工作区 root 的 gitignore 模式，永远匹配不到 root 自己——在 `…/src-tauri/target/debug`、`dist` 这类目录里开会话时，整个构建产物目录会被全量快照（实测 7000 个产物条目里只有 root 下恰好同名的 `build/` 子树 2000 条被排除，root 整体照进），单会话即可积出 GB 级对象库，且这类目录没有回退价值。新增 `src/host/exclude-patterns.js` 判定「root 的任一路径段命中目录形态排除项」（win32 大小写不敏感、POSIX 敏感；看任一段而非 basename——最坏形态 `target/debug` 的 basename 是 `debug`，不在表里），命中的工作区在 `captureSnapshot` 于 `resolveStore` **之前**直接返回：不建快照、连空仓库都不建、不写 feedback（设计行为而非失败）。可见性：`init` 的 `notice.buildRootNotice` 与 `snapshot-info` 的 `notice` 下发同一句提示（含命中的路径段名、给出出口、≤140 字符），client 会话内说明一次并在近消息上节流 toast，避免「撤回按钮凭空不出现」。逃生口复用排除表本身（设置页删掉 `target/` 即恢复，无需新配置项）。存量残骸的整目录清理（含会话已删、内存里没有的仓库）留待后续按需实施。 - **`baseExcludes` 默认表加宽：编译产物目录与常见二进制/压缩包默认不进快照**：原先默认仅 `.git`、`node_modules/` 与两种存储目录名，`maxFileBytes` 只挡单个大文件、挡不住 `target/` 这类上万小文件整体 GB 级的构建产物——它们既拖慢每次快照的 `add`/遍历，也直接喂大对象库（上条实测的 3.35 GB loose 即由此而来）。新增 `target/`、`dist/`、`build/`、`out/`、`coverage/`、`.next/`、`.nuxt/`、`.output/`、`.cache/`、`.gradle/` 与 `*.exe`、`*.dll`、`*.pdb`、`*.so`、`*.dylib`、`*.msi`、`*.zip`、`*.7z`、`*.rar`、`*.tar`、`*.tar.gz`、`*.iso`。排除只作用于新增暂存（已有命中条目由 excludeSync 的清理循环在下次快照移出），仍可在设置页「基础排除表」逐条删改。 - **单次 gc 超时 10 分钟 → 30 分钟（`GC_TIMEOUT_MS`）**：GB 级 loose 对象库的单次 repack 可超 10 分钟，被杀的 gc 永远完不成；gc 与快照同在串行队列，加长只影响维护节奏。 ## [2.3.24] - 2026-09-18 ### 新增 - **「仅撤回对话」模式（撤回范围二选一）**：对生成结果不满意、但文件改动恰是想要（或已人工修整）时，整段回退会把文件一并覆盖。确认面板新增撤回范围 radio 组（原生 input、键盘可达；默认「回退文件与对话」与现状逐项一致；首条用户消息因对话无从回退不渲染）——选「仅撤回对话」后文件清单降级为参考语义、安全快照预告隐藏（不打安全快照：零文件改动即无不可逆操作缺口），按钮与 executing/done 文案随模式分叉。实现＝`ExecuteArgs` 增 `scope?: 'both' | 'session-only'`（缺省/非法值回落 both：老 Client 与直调 API 行为不漂移），Host execute 开头分叉——session-only 不进串行队列、零 git 写操作（保留 NO_SNAPSHOT/AGENT_BUSY 两道护栏，跳过 STALE 校验/安全快照/rollback/rescue 全链），直接 `resolveCutSeq` + `resolveStaleQueueItemIds` 返回 `count: 0`；fork/归档/子会话导航/排队消息清理/lineage/草稿回填链与模式无关，原样复用。新增 `tests/unit/routes-scope.test.js` 5 例（session-only 零 git 调用与透传、agentBusy 拦截、NO_SNAPSHOT、非法 scope 回落 both、不传 scope 现状回归钉）。 ## [2.3.23] - 2026-09-18 ### 修复 - **撤回后子会话不打开（dsh 0.1.6-alpha.2 移除 `ISessions.open`，实弹冒烟发现）**：alpha.2 起 `ISessions` 只保留列表快照与 `retain`/`using` 引用模型，契约注释写明「navigation belongs to view owners」——原调用的 `sessions.open(sessionId)` 已不存在，守卫判断静默跳过，于是撤回的 execute/fork/lineage 全部正常，唯独 fork 出的子会话不会被打开：页面停在工作区空态。导航入口迁至独立 `uiWorkspace` 服务（`dsh-client-ui-workspace`）的 `openSession(target: SessionTarget)`（`SessionTarget = SessionId | SubagentAddress`，官方 UI 同样传裸 sessionId；`ctx.workspaces` 只有归档能力、无导航）。修复＝client `inject` 声明 `uiWorkspace` + `ctx.uiWorkspace` 类型化（`ClientUiWorkspaceService`），导航点改双版本分支：`uiWorkspace.openSession(id)` 优先、旧版回退 `sessions.open(id)`（撤回节点与快照管理「切换」两处）。`tests/probe/api-surface.test.js` 新增「会话导航归属」2 例钉住两侧事实，compat-audit 新增 I37。实弹复验：撤回第二条消息后子会话自动打开、对话回退、标题继承、被撤回消息文本回填输入框。 - **快照管理「切换」把归档会话放进点击路径，一点就落到工作区空态**：按钮判据只查会话是否在官方列表里（`sessions.list`），依据「已归档会话不在列表」的假设；alpha.2 起该快照包含归档会话，而归档会话不是合法的主视图选择——官方导航会先设置选择、随即按「归档选择不保留」把它清空，视图落空态（撤回后归档的原会话最常命中）。修复＝判据叠加归档集合排除：`ClientWorkspacesService` 补 `list` 面，从 `ctx.workspaces.list.getSnapshot().archivedSessionIds` 取归档集合（服务经 `buildSettingsCards` 传入快照管理卡），只有「在官方列表且未归档」的会话才渲染「切换」。实弹复验：归档会话行不再出现「切换」，保留「切换」的活跃会话点击后正常打开。 ### 变更 - **旧版回退核验 + 兼容声明下界收窄**：本批次三处改码都在跨版本面上（静态 `uiWorkspace` inject、`plugins.bundle.config` 注册、读 `workspaces` 归档集合），故把全局 dsh 降到纯 `0.1.6-alpha.1`（`npm install -g @deepseek-ai/dsh@0.1.6-alpha.1 --before=2026-09-16`；不带 `--before` 会因 dsh 自身 `^0.1.6-alpha.1` 放行同 tuple 预发布而混入 alpha.2 的包）实弹一轮，确认未升级 dsh 的用户更新插件后不会变砖——三项全过、控制台零报错：旧 slot（`settings.plugin.item`）卡片照常渲染且样式注入正常、`plugins.bundle.config` 在旧渲染器上是静默 no-op；撤回 fork 后子会话由 `uiWorkspace.openSession` 正常打开（切过去后再发消息、新快照记到子会话 id 为证）；快照管理树按 lineage 聚族（`v1/2`/`v2/2`）。同时按 registry 产物逐版核验 `uiWorkspace` 服务可用性：`0.1.2-alpha.2` 起有该服务但无 `openSession`（该线走 `sessions.open` 回退，`ISessions.open` 到 alpha.1 都在）、`0.1.5-rc.2` 起 `openSession` 在位，而 **`0.1.1-rc.2` 线没有该服务**（同线亦缺 `sessions`/`workspaces`：`dsh-api-session-controller`/`dsh-api-workspace-controller` 无该版本发布）——静态声明无法满足，插件 UI 会静默不渲染。据此**7 个 dsh-* peer 范围去掉 `>=0.1.1-rc.2 <0.1.2` 段**，让该组合在安装期被明确拦住而不是装上了白屏；README 双语兼容声明与 badge 上界由 `0.1.6-alpha.1` 更新为 `0.1.6-alpha.2` 并写明不再声明支持 0.1.1-rc.2 及更早的原因；compat-audit I37 补「服务可用性」条目，实弹记录见 `docs/plans/completed/smoke-checklist-records.md`。核验完装回 `0.1.6-alpha.2`（树内 8 个 `@deepseek-ai/dsh-*` 包一致），`npm run check:upgrade` 三层门禁全绿（check:dsh 全一致 / test:probe 39 通过 / verify:host 通过）。 - **README 双语补充快照捕获窗口的边界说明**：快照为异步捕获，从收到消息到 `git add` 之间有约 0.5–1.5 秒窗口（Windows 上一次 PowerShell 启动即约 0.4 秒；index.json 记的 `time` 是脚本发起时刻而非捕获时刻）。秒级完成的琐碎任务若落在窗口内改完文件，该条快照会连带捕获本轮改动——撤回时文件回退成为空操作（预览显示「共 0 个文件将变更」），对话回退不受影响，且撤回前仍先落 `snap-pre-rollback-*` 安全快照，无数据丢失。此为异步快照的固有边界，无法消除（除非让每条消息同步阻塞等快照完成）。 - **dsh 0.1.6-alpha.2 兼容适配：设置卡片迁挂插件管理页 slot（I12）**：全局实装 `@deepseek-ai/dsh@0.1.6-alpha.2`（npm dist-tag `alpha`，tag commit `ddefc45`）后核查发现旧设置页插件 tab 整体移除——`settings.plugin.item` 与 `settings.plugins.tab` 产物字符串归零，新增 ui-plugin-manager 插件管理页，声明 `plugins.item` / `plugins.bundle.config` / `plugins.row.config` 三 slot（bundle 自带配置走 `plugins.bundle.config`，keyed by bundle 包名，page 视图要求表单自含保存控件）。Client 侧改为双键并注册：新增 `plugins.bundle.config`（key=`dsh-recall-plugin`，插件管理页 bundle 页渲染 RecallSettingsCard）+ 保留旧键 `settings.plugin.item`（key=`dsh-recall`，0.1.6-alpha.1 及以前生效）——官方 renderer 对未声明 key 的 `slots.inject` 是静默 no-op（`specDynamic` 为 undefined 直接 return），双版本各吃各键无需运行时探测。其余消费面零破坏：fork 签名与切点 `cut = boundary.seq + 1`（I35 根治）逐字保持；connection `fetch.register` 契约不变（仅新增 `streamBaseUrl?` 可选字段）；client sessions 改 retain/release 引用模型（多实例共存），`binding()` 收窄为「只借已 retain 的会话」——附件重建链（I34）全链 typeof 降级兜底，最坏仅附件不重建（导航面另有两处问题，见上方修复）。peer 范围 `>=0.1.6-alpha.1 <0.1.7` 天然覆盖 alpha.2 无需扩展。机器化断言：`npm test` 361/361 + `check:upgrade` 三层门禁全绿（probe 37/37）。reference/ 镜像按 alpha.2 tag 重拉（仅 06/09 文档文字修订）；compat-audit 头部追加 alpha.2 核验段并更新 I12。实弹冒烟记录见 `docs/plans/completed/smoke-checklist-records.md`。 ## [2.3.22] - 2026-09-16 ### 修复 - **win32 上宿主把 `ctx.shell` 配成 bash 时功能面整个死亡（issue #15）**：官方 shell 是提供方注册制——一个 composition 恰好一个 `ctx.shell` 实现，win32 的 profile 可以只启用 `bash-sandbox`（禁用 `pwsh-sandbox`）；而插件按 `process.platform` 单选 pwsh 模板，两者之间没有契约保证，于是模板被 bash 执行、第一行编码前导即语法错误（`bash: -c: line 1: syntax error near unexpected token '('`），`ensureGit` 起每一步都失败：快照从未成功、撤回按钮不可用。官方 `ShellExecutor` 公开面（`resolve`/`run`/`start` + `sandboxMode`）没有任何方言标识，**不能查询只能探测**，故修复＝行为探针判方言 + 判成 bash 时改走直连通道： - **S1 方言探针**：`runShellMeta` 首调内联执行 `Write-Output <罕见 ASCII 哨兵>`（不带 UTF8_PRELUDE、30s 短超时、直调 `ctx.shell` 不触发失败清扫）；exit 0 且回显哨兵判 pwsh，非零退出（bash 下 command-not-found 即 127）/无输出/reject 一律判 bash。结果按进程缓存并以 in-flight promise 去重（突发 `session/event` 只探一次）。POSIX 不探测——bash 模板与 bash 执行器天然一致。 - **S2 直连通道**：判 bash 时 `runShellMeta` 分流到 Node `spawn` 直连 `%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -NonInteractive -Command <单 argv>`（PS 5.1 全平台自带，不赌 PS7；模板本就按 5.1 兼容写），保留官方四项语义：stdin 字节透传（PS 5.1 代码页坑由字节流绕开）、stdout 超截断保留尾部并置 `truncated`（索引读取靠它区分截断与损坏）、超时 `child.kill()`、非零退出仍走 `cleanupAfterGitFailure`；env 复刻官方清洗（剥凭证形状名与全部 `DSH_*`，叠 `NO_COLOR`/`PAGER`/`GIT_PAGER`），cwd 取 `sandboxPolicy.workspaceRoot || process.cwd()`，`windowsHide` 防桌面端闪窗。带 `RECALL_CLEANUP` 哨兵的失败清扫脚本不触发探针（只用缓存）——它只在真实命令失败后被调用，方言早已判定，善后路径不再叠一条探测进程。 - **默认路径零变化**：`ctx.shell` 即 pwsh 的常规部署（探针判 pwsh）与 POSIX 都不触达直连通道；探针误判的代价也低——两条通道对 pwsh 模板都兼容，判成 bash 只是绕开官方托管环境（无 `dshEnv`/PATH 注入、无进程树级终止）。 - 新增 `tests/unit/store-shell-dialect.test.js`（31 例：判定/收集/env 清洗/可执行路径四个纯函数 + 假 child 覆盖 stdin 字节透传、截断、超时 kill、spawn error + 分流接线与 in-flight 去重）；`tests/probe/api-surface.test.js` 新增「win32 shell 方言」3 例（ShellExecutor 无方言字段、直连复刻的 PS 5.1 候选路径与 argv 旗标、env 清洗口径）；compat-audit 新增 I36。 ## [2.3.21] - 2026-09-15 ### 变更 - **dsh 0.1.6-alpha.1 兼容性声明与台账同步**：全局实装 `@deepseek-ai/dsh@0.1.6-alpha.1`（npm dist-tag `alpha`，0.1.6 线首个预发布）后跑三层门禁——`verify:host` 装配断言通过、`npm test` 330/330、`test:probe` 32 例中 1 红。红点即本版唯一行为级变化：**官方修复 `sessions.fork` 按轮次分叉的切点**——由「`cut` 从 `boundary+1` 向后推进到下一个 `turn/start` 之前」改为「`cut` 固定 `boundary.seq + 1`、精确切到选中 `turn/end`」，结束事件之后的排队输入、标题、模型设置均不再复制进子会话 seed，2.3.17 起插件侧 `scanStaleQueueItemIds` 清理的残留排队消息问题（I35）在 0.1.6 线上从源头消失（探针按 2.3.20 预留的「好消息变红」路径改钉新锚点后 32/32 复绿）。**清理逻辑不退役**：peer 范围保留 0.1.5 线段，该线上 fork 切点未修复、清理仍必要；0.1.6 上退化为 `queue-item-not-found` 吞掉的无害空操作。其余消费面零破坏：`snapshotEvents`/`eventAt`/`ownEvents` 仅标 `@deprecated` 未移除（内存跳行为不变，列为前瞻观察项）；`ShellExecutor.start` 异步化不涉及插件（只用 `resolve`+`run`）；`agent/session-start`→`agent/created` 事件改名与插件无关；回填链与 chat.node/settings slot 全部在位。tag 对比（800 commits / 300 文件）按消费面包过滤后唯一源码命中即 fork 实现；reference/ 镜像按 alpha.1 tag 重拉 13 源——10 份内容相同、05/09/13 三文件有实质差异（09 不变式措辞补「纯消息投影」、新增 `agent/created`、桌面 profile 重写；13 钩子行改名；均不触及插件消费的槽位/契约）。**兼容声明同步**：0.1.6 为新 minor 线，7 个 dsh-* peer 各追加 `>=0.1.6-alpha.1 <0.1.7` 段；`dsh.compatibility.dshReleases` 补 `0.1.6-alpha.1: compatible`；README 双语安装兼容声明与 badge、reference/README 归档字段、dsh-contract.md「对应版本」同步。评估实证见 `docs/upgrade-assessments/dsh-0.1.6-alpha.1.md`，compat-audit 新增 0.1.6-alpha.1 核验段并更新 I35 条目。本插件源码零功能变更。 ## [2.3.20] - 2026-09-14 ### 新增 - **探针：`sessions.fork` 切点推进行为 3 例**（I35 的文档化行为落成机器断言）：`tests/probe/api-surface.test.js` 新增「sessions.fork 切点推进行为」组，直钉 `dsh-api-session-controller` 构建产物的三条锚点——boundary 以「seq >= atSeq 的首条 `turn/end`」解析、`cut` 从 boundary+1 推进到下一个 `turn/start` 前、`seed` 取 `slice(0, cut)` 完整前缀。官方若改为「seed 排除未领取 inbox 项」（撤回残留排队消息的根治方向）或重构改名即红，提示复核 G1 清理逻辑是否可退役；0.1.1 旧版安装的实现锚点未核验，整体 skip（fork 签名探针仍覆盖旧包路径）。探针 31 → 34 例全绿，compat-audit I35 的「无直接探针」缺口随之闭环。 ### 修复 - **与同页插件的全局名冲突（issue #14）：client 产物顶层声明整体收进 IIFE 闭包**：client bundle 以 classic `