dsh-workspace-mover 2.1.0 → 2.1.1

package/README.md

@@ -1,26 +1,38 @@
 # dsh-workspace-mover
 
-**_> 非官方项目，由社区成员独立开发和维护。_**
+> [!IMPORTANT]
+> 非官方项目，由社区成员独立开发和维护。
 
 <!-- Hero -->
 <div align="center">
   <b style="font-size: 1.15em;">在侧边栏把会话拖到另一个工作区——真迁移原始档案，而不是复制</b><br /><br />
+  <p style="font-size: 0; line-height: 1;">
+    <a href="dsh://plugin/install?id=dsh-workspace-mover&name=dsh-workspace-mover&version=2.1.1&repo=PianoPrince%2Fdsh-workspace-mover&permissions=%E6%9C%AC%E5%9C%B0%E4%BC%9A%E8%AF%9D%E6%96%87%E4%BB%B6%E8%AF%BB%E5%86%99%2C%E5%B7%A5%E4%BD%9C%E5%8C%BA%E8%AE%B0%E8%B4%A6%E5%8F%98%E6%9B%B4&downloadUrl=https%3A%2F%2Fgithub.com%2FPianoPrince%2Fdsh-workspace-mover%2Farchive%2Frefs%2Fheads%2Fmain.zip">
+      <img src="https://img.shields.io/badge/DeepSeek%20Harness-%F0%9F%9A%80%20%E5%94%A4%E8%B5%B7%E6%A1%8C%E9%9D%A2%E5%AE%A2%E6%88%B7%E7%AB%AF%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85-10B981?style=for-the-badge&logo=deepseek&logoColor=white" alt="唤起桌面客户端一键安装" />
+    </a>
+  </p>
+  <p style="font-size:12px;color:var(--dsw-alias-label-tertiary,#999)">官方桌面客户端对该深链目前降级为聚焦窗口；Hub 系第三方客户端支持完整安装流程。</p>
   <p style="font-size: 0; line-height: 1;">
     <a href="https://github.com/PianoPrince/dsh-workspace-mover/actions/workflows/test.yml"><img alt="CI" src="https://github.com/PianoPrince/dsh-workspace-mover/actions/workflows/test.yml/badge.svg" style="height:20px; margin:0 2px;" /></a>
     <a href="https://www.npmjs.com/package/dsh-workspace-mover"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-workspace-mover" style="height:20px; margin:0 2px;" /></a>
-    <img alt="plugin version" src="https://img.shields.io/badge/dsh--plugin-2.1.0-4d6bfe" style="height:20px; margin:0 2px;" />
+    <img alt="plugin version" src="https://img.shields.io/badge/dsh--plugin-2.1.1-4d6bfe" style="height:20px; margin:0 2px;" />
+    <img alt="DSH tested 0.2.0-rc.2" src="https://img.shields.io/badge/DSH_tested-0.2.0--rc.2-4c8dff" style="height:20px; margin:0 2px;" />
     <img alt="DSH engines" src="https://img.shields.io/badge/DSH-%E2%89%A50.1.5--rc.1-339933" style="height:20px; margin:0 2px;" />
-    <a href="https://github.com/PianoPrince/dsh-workspace-mover/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/PianoPrince/dsh-workspace-mover" style="height:20px; margin:0 2px;" /></a>
-    <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" style="height:20px; margin:0 2px;" /></a>
     <img alt="Node" src="https://img.shields.io/badge/Node-%E2%89%A522-339933" style="height:20px; margin:0 2px;" />
     <img alt="npm 依赖：0" src="https://img.shields.io/badge/npm%20%E4%BE%9D%E8%B5%96-0-4d6bfe" style="height:20px; margin:0 2px;" />
-    <a href="https://awesome-dsh-plugin.com"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg" style="height:20px; margin:0 2px;" /></a>
   </p>
   <p style="font-size: 0; line-height: 1;">
+    <a href="https://github.com/PianoPrince/dsh-workspace-mover/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/PianoPrince/dsh-workspace-mover" style="height:20px; margin:0 2px;" /></a>
+    <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" style="height:20px; margin:0 2px;" /></a>
+    <a href="https://awesome-dsh-plugin.com"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg" style="height:20px; margin:0 2px;" /></a>
+    <a href="https://www.dsh.so/artifact/dsh-workspace-mover/"><img alt="dsh.so risk: low" src="https://www.dsh.so/badge/dsh-workspace-mover.svg" style="height:20px; margin:0 2px;" /></a>
+    <a href="https://github.com/XingLingQAQ/dsh-plugin-registry"><img alt="Listed in dsh-plugin-registry" src="https://img.shields.io/badge/registry-dsh--plugin--registry-2d6a8f" style="height:20px; margin:0 2px;" /></a>
     <img alt="真迁移" src="https://img.shields.io/badge/-真迁移-4d6bfe" style="height:20px; margin:0 2px;" />
     <img alt="零 token 消耗" src="https://img.shields.io/badge/-零%20token%20消耗-4d6bfe" style="height:20px; margin:0 2px;" />
     <img alt="备份回滚" src="https://img.shields.io/badge/-备份回滚-4d6bfe" style="height:20px; margin:0 2px;" />
-    <img alt="GitHub clones observed（含 unique）" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FPianoPrince%2Fc14345658550a4a308570acfbaf9d170%2Fraw%2Fwsm-clones-total.json" style="height:20px; margin:0 2px;" />
+  </p>
+  <p style="font-size: 0; line-height: 1;">
+    <img alt="GitHub clones observed（自 2026-08-25 累计，含 unique）" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FPianoPrince%2Fc14345658550a4a308570acfbaf9d170%2Fraw%2Fwsm-clones-total.json" style="height:20px; margin:0 2px;" />
     <!-- release-downloads-badge:start --><!-- release-downloads-badge:end -->
   </p>
 </div>
@@ -38,7 +50,7 @@
 - [🔌 如何接入 DSH](#-如何接入-dsh)
 - [🤝 与其他插件共存](#-与其他插件共存)
 - [🧩 兼容性与卸载](#-兼容性与卸载)
-- [🔐 安全承诺](#-安全承诺)
+- [🔐 安全台账](#-安全台账safety-ledger)
 - [⚠️ 已知限制](#️-已知限制)
 - [🆕 最近版本](#-最近版本)
 
@@ -54,7 +66,9 @@ DeepSeek Harness 侧边栏可以拖拽排序**同一工作区**内的会话，
 - **🏠 工作区搬家向导**：项目文件夹被移动/改名后，一键把失效分组原地重定向到新位置；id、标题、排序、归档位保持，名下会话连同旧路径散件一起迁移
 - **🛟 会话救援**（设置 → 会话救援）：一键找回「失联」「未记账」「挂错分组」的会话；已归档会话可恢复；支持一键修复与筛选
 - **🗑️ 回收站与备份**：删除先进回收站，可还原到原位置或任意分组；迁移自动生成备份，可按会话恢复或清理
+- **🛡️ 数据保护**：回收站与备份的份数/占用一屏可见；「清理 30 天前数据」先预览释放量，确认后执行
 - **⏪ 移动历史与撤回**：记录最近 100 次跨工作区移动，批量聚合为一条，整批可一键撤回
+- **🧾 迁移任务中心**：批量迁移逐项持久化记录（完成/失败、最后错误与尝试时间），失败项一键重试——按会话当前位置重新迁移，不用陈旧路径
 - **📂 空分组清理 / 打开文件夹**：只列出真正零成员的工作区；组菜单可直达系统文件管理器
 - **🤖 Agent 工具**：`mover_list_sessions` / `mover_move_session` / `mover_repair_sessions` 三个模型可调用工具——在对话里说「把这个会话挪到某组」即可触发与面板完全相同的备份回滚管线；迁移与修复执行前经宿主审批弹窗确认，未装 dsh-tools 的宿主自动停用
 
@@ -106,6 +120,7 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 | 移动失败的 toast | 操作前有自动备份、失败会回滚；按提示处理后重试。详细原因见宿主日志中的 `MOVE FAILED` |
 | 移动成功但侧边栏没归位 | 刷新页面即可 |
 | 有些会话从侧边栏不见了 | 打开 **设置 → 会话救援** 自动扫描并找回 |
+| 升级 DSH 0.2 后，旧会话切换模型报 `Unknown agent preset` | 0.2 不再读取 0.1.x 旧格式的自定义预设目录，需迁移为声明行——与插件无关，完整步骤见 [docs/dsh-0.2-preset-migration.md](docs/dsh-0.2-preset-migration.md) |
 
 </details>
 
@@ -167,7 +182,7 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 
 ### 对话里迁移（Agent 工具）
 
-1. 装有 `dsh-tools` 的宿主（web 默认）自动注册三个模型工具：清单（只读）、迁移、一键修复；
+1. 装有 `dsh-tools` 的宿主（web 与桌面版默认）自动注册三个模型工具：清单（只读）、迁移、一键修复；
 2. 在对话里说「列出我的会话」「把会话 X 挪到 Y 组」「跑一次修复」——模型先用清单工具把名字解析成精确 id，再执行动作；
 3. 迁移与修复在动手前经宿主审批弹窗请你确认（与面板确认同级）；拒绝或关闭弹窗则不执行；
 4. 宿主没有 `dsh-tools` 时自动停用，不影响面板与拖拽。
@@ -199,8 +214,10 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 
 | 同装插件类目 | 兼容性 | 说明 |
 | --- | --- | --- |
+| 官方内置插件（0.2 起的 8 个：终端 / 网页搜索 / 子智能体等） | ✅ 无冲突 | 功能面不相交；Agent 工具经官方 `dsh-tools` 注册表共存，本插件工具名以 `mover_` 前缀隔离 |
 | 侧边栏增强 / better-sidebar / 终端 / 费用统计 / 记忆 / 导出分享 | ✅ 无冲突 | 面板与数据面完全不同 |
 | 归档管理类插件 | ✅ 兼容 | 双方都使用官方归档数据，数据层一致（面板功能可能有些重复） |
+| 回收站 / 会话删除类插件 | ✅ 数据隔离 | 各插件维护独立的回收站目录，互不读写；建议只启用一家的删除入口，避免操作混淆 |
 | 排序 / 置顶类插件 | ⚠️ 基本兼容 | 移动后会精确重排「最近更新」；与置顶/排序插件并存通常无碍，仅各自面板展示顺序可能不完全一致 |
 | 重画侧边栏的插件（自绘工作区树） | ⚠️ 降级共存 | 对方若替换官方侧边栏结构，本插件可能暂时无法识别会话行——表现为功能不触发，**不会损坏数据** |
 | 其他会话移动器 | ❌ 建议二选一 | 同类插件可能重复处理同一次拖拽；本插件已覆盖移动 / 批量 / 合并 / 归位 / 归档恢复 |
@@ -219,17 +236,30 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 - **其他已知组合**：dsh-market `1.45.1`。不修改 DSH 源码，仅通过官方扩展点接入。
 - **质量门禁**：提交前运行 `npm run check`（语法检查 + 测试 + `npm pack --dry-run`）；CI 在 ubuntu / windows / macos × Node 22/24 上执行同等步骤。
 - **市场卡片的「宿主要求未知」**：GitHub-only 插件没有 npm 发布清单时，dsh-market 可能无法从远端元数据推导宿主版本；显示「未知」**不代表**运行时不兼容。
+- **升级到 DSH 0.2 的预设迁移**：0.2 不再读取 0.1.x 旧格式的自定义预设目录（`$DSH_HOME\.agent-presets\`），旧会话恢复会报 `Unknown agent preset`（与本插件无关，属宿主变更）。迁移步骤与实测记录见 [docs/dsh-0.2-preset-migration.md](docs/dsh-0.2-preset-migration.md)。
 - **卸载可逆**：移除插件不会删除会话档案、工作区或官方记账。插件自己的历史、任务、备份和回收站数据仍保留在插件数据目录（见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)）；移除后刷新或重启 DSH 即可清理注入的界面。
 - **共存建议**：不要与另一个跨工作区拖拽移动器同时启用；其他类型插件可按上表共存。
 
 部分高级操作依赖较新的 DSH 能力；不支持时界面会明确提示，而不是静默失败。
 
-## 🔐 安全承诺
+## 🔐 安全台账（Safety Ledger）
+
+每一次迁移都走同一条带安全边界的管线：**字节级备份先行 → 逐步回滚 → 迁移后校验 → 恢复账本兜底**。任何一步失败都会回到移动前的状态；连回滚都失败的极端情况会写入持久化恢复记录并在救援面板标红，等待人工确认——数据永不消失。
+
+**Never-does（绝不）：**
+
+- 绝不执行任何 git 写操作（commit / stash / reset / checkout 都不碰）；
+- 绝不在字节级备份落盘之前改动任何文件；
+- 绝不静默丢弃会话数据——恢复不了的极端情况会明确标红并保留现场；
+- 绝不绕过确认执行破坏性操作（对话内的迁移 / 修复还须经宿主审批弹窗）；
+- 绝不上传任何本地数据——插件无网络请求，全部工作在本机完成。
+
+**具体承诺：**
 
 - **移动前自动备份**；搬运落地后再核对会话身份与路径，不符则整体回退；
 - **失败时恢复到移动前状态**（文件与记账一并恢复）；
 - **删除先进回收站**，可还原到原位置或任意分组；彻底删除需二次确认；
-- **无法自动恢复时**，会在救援面板明确标出，需要人工确认；会话文件与备份始终保留，**绝不静默丢弃**；
+- **无法自动恢复时**，会在救援面板明确标出，需要人工确认；会话文件与备份始终保留；
 - **近期打开过、仍驻留在 Harness 内存中的会话**不能直接删除，需重启 Harness 后再删（界面会给出明确提示）。
 
 > 失败路径优先保数据，不静默丢会话。<br>
@@ -245,6 +275,13 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 
 ## 🆕 最近版本
 
+### v2.1.1 · 2026-10-05
+
+- `mover.doctor` 自检：面板新增「自检」按钮 + `mover_doctor` 模型工具——服务、数据目录、恢复记录、工作区路径约 13 项检查，pass/warn/fail 三态汇报，DSH 升级后先自检再动手
+- 信任资产：`dsh://` 一键安装深链按钮、dsh.so 风险徽章（已收录且 L5 实测 / risk low）、dsh-plugin-registry 收录徽章、"DSH tested 0.2.0-rc.2" 徽章
+- 兼容性报告：`docs/compatibility/` 落地桌面版实测记录，此后每适配一个 DSH 版本新增带日期报告
+- 安全承诺章节品牌化为「安全台账（Safety Ledger）」+ never-does 清单
+
 ### v2.1.0 · 2026-10-04
 
 - Agent 工具：`mover_list_sessions`（只读清单）/ `mover_move_session`（迁移单个会话）/ `mover_repair_sessions`（一键修复）注册进官方 `dsh-tools`，在对话里即可调用

package/client/client.js

@@ -131,6 +131,22 @@ window.__ModuleLoader__.load({
 				sessionBusy: "该会话正在处理中（可能有迁移 / 还原 / 删除操作尚未完成），请稍后再试。",
 				contextStale: "插件上下文已失效（客户端热重载导致）。请刷新页面（或重启应用）后重试，功能会自动恢复。",
 				recoveryNote: "检测到 {n} 条自动回滚也失败的记录，需人工确认：会话文件与备份均保留在原处，未丢失。请勿手动清理 pluginData 目录，查看 recovery.json 或联系开发者处理。",
+				doctorBtn: "自检",
+				doctorChecking: "自检中…",
+				doctorSummary: "自检完成：{pass} 通过 · {warn} 警告 · {fail} 失败",
+				doctorHostRegistry: "工作区注册表服务",
+				doctorHostPersistence: "会话持久化服务",
+				doctorHostProjection: "投影缓存",
+				doctorHostArchive: "归档通道",
+				doctorHostAgents: "Agents 服务",
+				doctorHostApproval: "审批接缝",
+				doctorAgentTools: "Agent 工具",
+				doctorDataRecycle: "回收站",
+				doctorDataBackups: "备份目录",
+				doctorDataHistory: "移动历史",
+				doctorDataTasks: "任务记录",
+				doctorRecovery: "恢复记录",
+				doctorWorkspaces: "工作区路径",
 				repairAllBtn: "一键修复",
 				repairAllDone: "✓ 已修复 {n} · 跳过 {s} · 失败 {f}",
 				skipNeedsTarget: "需选择目标分组",
@@ -262,6 +278,22 @@ window.__ModuleLoader__.load({
 				sessionBusy: "This session is busy: a move / restore / delete is still in flight. Try again in a moment.",
 				contextStale: "The plugin context went stale (client-side hot reload). Refresh the page (or restart the app) and the features will work again.",
 				recoveryNote: "{n} record(s) need manual recovery: automatic rollback also failed. Session files and backups are all kept in place — nothing was lost. Do not clean the pluginData directory by hand; inspect recovery.json or contact the developer.",
+				doctorBtn: "Doctor",
+				doctorChecking: "Running checks…",
+				doctorSummary: "Doctor finished: {pass} pass · {warn} warn · {fail} fail",
+				doctorHostRegistry: "Workspace registry service",
+				doctorHostPersistence: "Session persistence service",
+				doctorHostProjection: "Projection cache",
+				doctorHostArchive: "Archive channel",
+				doctorHostAgents: "Agents service",
+				doctorHostApproval: "Approval seam",
+				doctorAgentTools: "Agent tools",
+				doctorDataRecycle: "Recycle bin",
+				doctorDataBackups: "Backups",
+				doctorDataHistory: "Move history",
+				doctorDataTasks: "Task records",
+				doctorRecovery: "Recovery records",
+				doctorWorkspaces: "Workspace paths",
 				repairAllBtn: "Fix all",
 				repairAllDone: "✓ Fixed {n} · skipped {s} · failed {f}",
 				skipNeedsTarget: "needs a target group",
@@ -335,6 +367,7 @@ window.__ModuleLoader__.load({
 .wsm-mono{font-family:ui-monospace,Consolas,Menlo,monospace}
 .wsm-badge{flex:none;font-size:11px;padding:1px 7px;border-radius:99px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.15));color:var(--dsw-alias-label-secondary,#666)}
 .wsm-badge.err{color:var(--dsw-alias-state-error-primary,#dc2626);border-color:currentColor}
+.wsm-badge.warn{color:var(--dsw-alias-state-warning-primary,#d97706);border-color:currentColor}
 .wsm-cwd{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary,#999)}
 .wsm-select{font:inherit;font-size:12px;background:var(--dsw-specific-input-major,#fff);color:var(--dsw-alias-label-primary,#111);border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.15));border-radius:6px;padding:3px 6px;max-width:220px}
 .wsm-input{flex:1.4;min-width:170px;font:inherit;font-size:12px;background:var(--dsw-specific-input-major,#fff);color:var(--dsw-alias-label-primary,#111);border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.15));border-radius:6px;padding:3px 7px}
@@ -637,6 +670,7 @@ window.__ModuleLoader__.load({
 			const [trash, setTrash] = useState(null);
 			const [backups, setBackups] = useState(null);
 			const [tasks, setTasks] = useState(null);
+			const [doctor, setDoctor] = useState(null);
 			const [query, setQuery] = useState("");
 
 			const call = async (endpoint, payload) => {
@@ -675,6 +709,21 @@ window.__ModuleLoader__.load({
 
 			useEffect(() => { void runScan(); }, []);
 
+			// 自检（v2.2）：只读诊断，结果常驻面板直到下次运行或重新扫描
+			const runDoctorNow = async () => {
+				setBusy(true);
+				setNote(t("doctorChecking"));
+				try {
+					const value = await call("mover.doctor");
+					setDoctor(value);
+					setNote(t("doctorSummary", value.summary));
+				} catch (err) {
+					setNote(t("failed", { msg: errMsg(err) }));
+				} finally {
+					setBusy(false);
+				}
+			};
+
 			const relink = async (item) => {
 				const target = picked[item.sessionId];
 				if (!target) return void setNote(t("pickTarget"));
@@ -1185,6 +1234,7 @@ window.__ModuleLoader__.load({
 				h("div", { className: "wsm-scanrow" },
 					h("button", { className: "wsm-btn small primary", disabled: busy, onClick: () => void runScan() }, busy ? t("scanning") : t("scan")),
 					h("button", { className: "wsm-btn small", disabled: busy, onClick: () => void repairAll() }, t("repairAllBtn")),
+					h("button", { className: "wsm-btn small", disabled: busy, onClick: () => { setDoctor(null); void runDoctorNow(); } }, busy ? t("doctorChecking") : t("doctorBtn")),
 					h("input",
 						{
 							className: "wsm-input", placeholder: t("filterPh"), value: query, disabled: busy,
@@ -1195,6 +1245,13 @@ window.__ModuleLoader__.load({
 						t("scannedN", { n: scan.scanned }) + (summaryParts.length ? ` · ${summaryParts.join(" · ")}` : ""))
 						: null
 				),
+				doctor ? h("div", { className: "wsm-list", style: { marginTop: "8px" } },
+					doctor.checks.map((c) => h("div", { className: "wsm-item", key: c.id },
+						h("span", { className: "wsm-badge" + (c.state === "fail" ? " err" : c.state === "warn" ? " warn" : "") },
+							c.state === "pass" ? "✓" : c.state === "warn" ? "⚠" : "✗"),
+						h("span", { className: "wsm-cwd", title: c.detail }, t(`doctor${c.id.split("-").map((w) => w[0].toUpperCase() + w.slice(1)).join("")}`) + (c.detail ? ` — ${c.detail}` : ""))
+					))
+				) : null,
 				brokenWorkspaces.length > 0 ? h(Caption, { text: t("wsSection"), help: t("wsHelp") }) : null,
 				brokenWorkspaces.length > 0 ? h("div", { className: "wsm-list" },
 					brokenWorkspaces.map((row) => h("div", { className: "wsm-item", key: row.workspaceId },

package/lib/index.js

@@ -2359,6 +2359,17 @@ function createAgentTools(ctx, dispatchRef) {
 				await approveOrThrow(ctx, exec, 'mover_repair_sessions', 'Run a workspace-mover repair pass (accounting-only fixes for misfiled / unregistered sessions; no files are moved).');
 				return await callDispatch(dispatchRef, 'mover.repairAll', {}, exec?.signal);
 			}
+		},
+		{
+			name: 'mover_doctor',
+			description: `Run the workspace-mover self-check (read-only diagnostics): host services (registry / persistence / projection cache / archive channel / agents / approval seam), agent-tool registration, data directories (recycle bin, backups, move history, tasks), pending manual-recovery records, and workspace folder presence. Returns per-check pass / warn / fail states with details and a summary — use it after a DSH upgrade or when a feature misbehaves, to see what is degraded before attempting anything else. No user approval needed; nothing is modified.`,
+			parameters: { type: 'object', properties: {}, additionalProperties: false },
+			output: { schema: { type: 'object' }, render: JSON_TEXT },
+			isConcurrencySafe: () => true,
+			timeoutMs: 30000,
+			async execute(args, exec) {
+				return await callDispatch(dispatchRef, 'mover.doctor', {}, exec?.signal);
+			}
 		}
 	];
 	return tools;
@@ -2378,6 +2389,86 @@ function registerAgentTools(ctx, dispatchRef, logger, agentToolsState = { regist
 }
 //#endregion
 
+//#region doctor（v2.2）：只读自检——服务、数据目录、恢复记录、工作区路径
+// 纯 ok(value)，无锁无变更；刻意不跑全量 scan，保证秒级返回。
+async function runDoctor(ctx, agentToolsState) {
+	const checks = [];
+	const add = (id, state, detail = '') => checks.push({ id, state, detail });
+	const pass = (id, detail) => add(id, 'pass', detail);
+	const warn = (id, detail) => add(id, 'warn', detail);
+	const fail = (id, detail) => add(id, 'fail', detail);
+
+	const registry = ctx?.workspaceRegistry;
+	const persistence = ctx?.sessionPersistence;
+
+	if (!registry) fail('host-registry', 'workspace registry service unavailable');
+	else {
+		let count = 0;
+		try { count = registry.list().length; } catch { /* list 失败按 0 报告 */ }
+		pass('host-registry', `${count} workspaces`);
+	}
+
+	if (!persistence) fail('host-persistence', 'session persistence service unavailable');
+	else if (typeof persistence.root === 'string' && dirExists(persistence.root)) pass('host-persistence', String(persistence.root));
+	else fail('host-persistence', `sessions root missing: ${persistence.root ?? '(none)'}`);
+
+	const projection = projectionTable(ctx);
+	const projectionRead = typeof projection?.get === 'function';
+	const projectionWrite = projectionRead && typeof projection?.put === 'function' && typeof projection?.delete === 'function';
+	if (projectionWrite) pass('host-projection', 'read + write');
+	else if (projectionRead) warn('host-projection', 'read-only — projection title restore degraded');
+	else warn('host-projection', 'absent — projection title restore degraded');
+
+	if (typeof registry?.enqueueOperation === 'function') pass('host-archive', 'archive-set channel ready');
+	else warn('host-archive', 'archive-set changes degraded');
+
+	if (peekService(ctx, 'agents')) pass('host-agents', 'running-state checks active');
+	else warn('host-agents', 'running-state checks degraded');
+
+	if (typeof ctx?.approval?.request === 'function') pass('host-approval', 'approval seam ready');
+	else warn('host-approval', 'agent approval seam absent — conversational moves rely on model discipline');
+
+	if (agentToolsState?.registered) pass('agent-tools', 'registered with dsh-tools');
+	else warn('agent-tools', 'not registered — dsh-tools absent on this host');
+
+	try { const trash = await listTrash(ctx); pass('data-recycle', `${trash.items.length} entries`); }
+	catch (err) { fail('data-recycle', String(err?.message ?? err).slice(0, 140)); }
+
+	try { const backups = await listBackups(ctx); pass('data-backups', `${backups.items.length} session groups`); }
+	catch (err) { fail('data-backups', String(err?.message ?? err).slice(0, 140)); }
+
+	try { const history = await listHistory(); pass('data-history', `${history.items?.length ?? 0} records`); }
+	catch (err) { fail('data-history', String(err?.message ?? err).slice(0, 140)); }
+
+	try { const tasks = await listTasks(); pass('data-tasks', `${tasks.items?.length ?? 0} records`); }
+	catch (err) { fail('data-tasks', String(err?.message ?? err).slice(0, 140)); }
+
+	const recovered = recoveryCount();
+	if (recovered === 0) pass('recovery', 'no manual-recovery records');
+	else warn('recovery', `${recovered} record(s) need manual review — see the rescue panel`);
+
+	if (!registry) warn('workspaces', 'skipped — registry unavailable');
+	else {
+		let total = 0;
+		let missing = [];
+		try {
+			for (const entity of registry.list()) {
+				total++;
+				try { if (!dirExists(entity.path)) missing.push(String(entity.id)); }
+				catch { missing.push(String(entity.id)); }
+			}
+		} catch { /* 同上 */ }
+		if (total === 0) warn('workspaces', 'no registered workspaces');
+		else if (missing.length === 0) pass('workspaces', `${total} paths all present`);
+		else warn('workspaces', `${missing.length}/${total} folders missing: ${missing.slice(0, 5).join(', ')}`);
+	}
+
+	const summary = { pass: 0, warn: 0, fail: 0 };
+	for (const c of checks) summary[c.state]++;
+	return { checks, summary, generatedAt: new Date().toISOString() };
+}
+//#endregion
+
 export function apply(ctx) {
 	const logger = ctx.logger ?? console;
 	const dispatchRef = { fn: null }; // agent 工具在调用期才用到 dispatch，挂载时序无关
@@ -2419,6 +2510,8 @@ export function apply(ctx) {
 						recoveryCount: recoveryCount()
 					});
 				}
+				case 'mover.doctor':
+					return ok(await runDoctor(ctx, agentToolsState));
 				case 'mover.workspaces':
 					return ok(await listWorkspaces(ctx));
 				case 'mover.history':

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "dsh-workspace-mover",
-  "version": "2.1.0",
-  "description": "在 DSH 侧边栏安全迁移会话：真迁移原始档案，支持失联会话恢复、移动历史、一键撤回和 agent 工具。",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./client/client.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "client",
-    "test",
-    "cordis.patch.yml",
-    "README.md",
-    "docs/ARCHITECTURE.md",
-    "docs/media",
-    "LICENSE"
-  ],
-  "scripts": {
-    "test": "node --test test/core.test.mjs test/e2e-sandbox.test.mjs test/traffic-badge.test.mjs test/release-downloads.test.mjs",
-    "check:syntax": "node --check lib/index.js && node --check client/client.js",
-    "check:pack": "npm pack --dry-run",
-    "check": "npm run check:syntax && npm test && npm run check:pack"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "workspace",
-    "session",
-    "session-migration",
-    "drag-and-drop",
-    "agent-tools"
-  ],
-  "engines": {
-    "node": ">=22",
-    "dsh": ">=0.1.5-rc.1"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/PianoPrince/dsh-workspace-mover.git"
-  },
-  "bugs": {
-    "url": "https://github.com/PianoPrince/dsh-workspace-mover/issues"
-  },
-  "homepage": "https://github.com/PianoPrince/dsh-workspace-mover#readme",
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-slots"
-      ],
-      "platform": "web"
-    }
-  }
-}
+{
+  "name": "dsh-workspace-mover",
+  "version": "2.1.1",
+  "description": "在 DSH 侧边栏安全迁移会话：真迁移原始档案，支持失联会话恢复、移动历史、一键撤回和 agent 工具。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./client/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "test",
+    "cordis.patch.yml",
+    "README.md",
+    "docs/ARCHITECTURE.md",
+    "docs/media",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test test/core.test.mjs test/e2e-sandbox.test.mjs test/traffic-badge.test.mjs test/release-downloads.test.mjs",
+    "check:syntax": "node --check lib/index.js && node --check client/client.js",
+    "check:pack": "npm pack --dry-run",
+    "check": "npm run check:syntax && npm test && npm run check:pack"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "workspace",
+    "session",
+    "session-migration",
+    "drag-and-drop",
+    "agent-tools"
+  ],
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.1.5-rc.1"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PianoPrince/dsh-workspace-mover.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PianoPrince/dsh-workspace-mover/issues"
+  },
+  "homepage": "https://github.com/PianoPrince/dsh-workspace-mover#readme",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  }
+}

package/test/e2e-sandbox.test.mjs

@@ -1825,7 +1825,7 @@ const FAKE_EXEC = () => ({ agent: { session: {} }, signal: undefined });
 test('v2.1 apply 在带 dsh-tools 的宿主上注册三个 agent 工具，status 汇报能力位', async () => {
   const { registered } = mountToolStubs();
   apply(ctx);
-  assert.deepEqual(registered.map((t) => t.name), ['mover_list_sessions', 'mover_move_session', 'mover_repair_sessions']);
+  assert.deepEqual(registered.map((t) => t.name), ['mover_list_sessions', 'mover_move_session', 'mover_repair_sessions', 'mover_doctor']);
   for (const def of registered) {
     assert.equal(typeof def.execute, 'function', `${def.name}.execute`);
     assert.equal(typeof def.output?.render, 'function', `${def.name}.output.render`);
@@ -1919,3 +1919,44 @@ test('v2.1 mover_repair_sessions 走审批并修复未记账夹具会话', async
   assert.equal(approvalCalls.length, 1);
   assert.equal(approvalCalls[0].toolName, 'mover_repair_sessions');
 });
+
+// ===== v2.2.0 mover.doctor 自检 =====
+
+test('v2.2 mover.doctor 沙箱全绿：服务/数据/工作区全部 pass', async () => {
+  apply(ctx);
+  const res = await call('mover.doctor');
+  assert.equal(res.ok, true, JSON.stringify(res));
+  const { checks, summary } = res.value;
+  assert.ok(checks.length >= 12, `至少 12 项检查，实际 ${checks.length}`);
+  for (const c of checks) assert.ok(['pass', 'warn', 'fail'].includes(c.state), `state 合法: ${c.id}`);
+  assert.equal(summary.fail, 0, `不应有 fail: ${JSON.stringify(checks.filter((c) => c.state === 'fail'))}`);
+  const ids = new Set(checks.map((c) => c.id));
+  for (const expected of ['host-registry', 'host-persistence', 'host-projection', 'data-recycle', 'data-backups', 'recovery', 'workspaces']) {
+    assert.ok(ids.has(expected), `缺少检查项 ${expected}`);
+  }
+  assert.equal(typeof res.value.generatedAt, 'string');
+});
+
+test('v2.2 mover.doctor 降级：摘除注册表后 fail + warn，但不抛错', async () => {
+  apply(ctx);
+  ctx.workspaceRegistry = undefined;
+  const res = await call('mover.doctor');
+  assert.equal(res.ok, true, 'doctor 本身永远 ok');
+  const registryCheck = res.value.checks.find((c) => c.id === 'host-registry');
+  assert.equal(registryCheck.state, 'fail');
+  const workspacesCheck = res.value.checks.find((c) => c.id === 'workspaces');
+  assert.equal(workspacesCheck.state, 'warn');
+  assert.equal(res.value.summary.fail >= 1, true);
+});
+
+test('v2.2 mover.doctor 恢复记录告警：recovery.json 存在时 warn', async () => {
+  apply(ctx);
+  const dir = join(root, 'workspace-mover');
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, 'recovery.json'), JSON.stringify({ version: 1, records: [{ id: 'rec-x', kind: 'delete', phase: 'test', createdAt: new Date().toISOString() }] }));
+  const res = await call('mover.doctor');
+  assert.equal(res.ok, true);
+  const recovery = res.value.checks.find((c) => c.id === 'recovery');
+  assert.equal(recovery.state, 'warn');
+  assert.match(recovery.detail, /1 record/);
+});

package/test/traffic-badge.test.mjs

@@ -1,6 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
-import { buildBadgeFiles, buildState, mergeHistory, normalizeClonesResponse, normalizePathsResponse, normalizeReferrersResponse, normalizeViewsResponse, parseHistory } from '../.github/scripts/traffic-badge-core.mjs';
+import { buildBadgeFiles, buildState, buildStructuredDaily, mergeHistory, normalizeClonesResponse, normalizePathsResponse, normalizeReferrersResponse, normalizeViewsResponse, parseHistory } from '../.github/scripts/traffic-badge-core.mjs';
 
 const snapshot = {
 	count: 12,
@@ -55,12 +55,26 @@ test('schema migration preserves the old value as a legacy estimate only', () =>
 	assert.equal(state.lastWindow.count, 12);
 });
 
-test('badge exposes only observed GitHub clones and 14d uniques', () => {
+test('badge exposes cumulative clones and cumulative uniques since the observation start', () => {
 	const state = buildState({}, parseHistory('{"date":"2026-09-08","count":5,"uniques":3}\n{"date":"2026-09-09","count":7,"uniques":4}\n'), normalizeClonesResponse(snapshot), '2026-09-10T00:00:00Z');
+	assert.equal(state.cumulativeUniques, 7);
 	const files = buildBadgeFiles(state);
 	const total = JSON.parse(files['wsm-clones-total.json'].content);
 	assert.equal(total.label, 'GitHub clones observed');
-	assert.match(total.message, /12 since 2026-09-08/);
-	assert.match(total.message, /7 unique/);
+	assert.equal(total.message, '12 since 2026-09-08 · 7 unique');
 	assert.equal(files['wsm-clones-14d.json'], undefined);
 });
+
+test('structured daily backfills JSONL-only early days without clobbering views', () => {
+	const existing = [{ date: '2026-09-09', clones: { date: '2026-09-09', count: 7, uniques: 4 }, views: { date: '2026-09-09', count: 2, uniques: 1 } }];
+	const historyRows = parseHistory('{"date":"2026-09-07","count":1,"uniques":1}\n{"date":"2026-09-08","count":5,"uniques":3}\n{"date":"2026-09-09","count":99,"uniques":99}\n');
+	const cloneDays = [{ date: '2026-09-09', count: 7, uniques: 4 }];
+	const viewDays = [{ date: '2026-09-09', count: 2, uniques: 1 }];
+	const daily = buildStructuredDaily(existing, historyRows, cloneDays, viewDays);
+	assert.deepEqual(daily.map((row) => row.date), ['2026-09-07', '2026-09-08', '2026-09-09']);
+	assert.deepEqual(daily[0].clones, { date: '2026-09-07', count: 1, uniques: 1 });
+	assert.equal(daily[0].views, undefined, 'JSONL 回填行没有 views 数据');
+	// JSONL 与快照冲突时快照优先：09-09 保持 7/4，且 views 不丢
+	assert.deepEqual(daily[2].clones, { date: '2026-09-09', count: 7, uniques: 4 });
+	assert.deepEqual(daily[2].views, { date: '2026-09-09', count: 2, uniques: 1 });
+});