DSH Doctor v0.7.0

主要更新

• 迁移目标升级到 DSH dsh-v0.1.7-rc.2（commit 477b4f4）并设为默认值。新增三个 catalog：
  • dsh-v0.1.1-rc.2 → dsh-v0.1.7-rc.2：累计 catalog，包含 0.1.1 → 0.1.2 的全部规则，对 0.1.1、0.1.2 以及迁移到一半的插件都适用；
  • dsh-v0.1.2-rc.1 / dsh-v0.1.5-rc.2 → dsh-v0.1.7-rc.2：供已完全处于 0.1.2 或 0.1.5（例如用 v0.6.0 迁移过）的插件获取更精确的来源版本证据（通过 --from 使用）。
  • 0.1.2 与 0.1.5 的历史 catalog 保留；0.1.5 区间发现的 web profile 条目移除与 dsh-client-connection inject 变化已并入新 catalog 的行为说明。
• Settings 迁移指引改为 0.1.7 的 volatile Config 模型：settingsNamespace（0.1.1）与 ctx.settings.register / SettingsProvider / SettingsScope（0.1.2）都已移除，插件应在自身 Config schema 中用 .volatile() 声明可实时修改的字段并通过 .get() 读取；浏览器端 ctx.settingsScope 改为 ctx.configForms。各内置插件导出的 *_SETTINGS_NAMESPACE 常量也按语义迁移报告。
• 新增 0.1.2 之后的包级变化：dsh-code-runtime 系列改名为 ptc-runtime（ctx.codeRuntime → ctx.ptcRuntime，纯类型改名为 exact，运行时契约为 semantic）、dsh-workflow-worker-thread → dsh-workflow-ptc、dsh-agent-presets → dsh-agent-preset-registry + 声明式 dsh-agent-preset、dsh-settings-file 移除、E2B provider 退役、node-addon-landlock-run → node-addon-system/landlock-run（exact）、agent-team web profile 合并为单一可选 bundle。
• catalog 同步 Cordis 4.0.4、client 平台基线新增 dsh-client-ui-dockkit、web profile patch 扫描覆盖 0.1.7 新增的 presets/*.patch.yml，并为独立版本的 node-addon-system（0.1.2）声明目标版本，避免 exact 改写后删除旧依赖却不补新依赖。
• 报告文案不再写死 0.1.1 / 0.1.2，改为使用 catalog 的实际来源与目标版本；CLI 帮助同步新默认值。
• Skill、references、中英文 README 与评测样例同步到 0.1.7：兼容意图改为 0.1.7-only / dual-version / pending developer decision，并说明两个来源 catalog 的选择规则。

安装

npm install --global @bruc3van/dsh-doctor@0.7.0
npx skills add bruc3van/dsh-doctor

验证

• 完成 122 项 CLI、migration、runtime、文档与 Skill 契约测试，新增 0.1.7 catalog、PTC/Landlock 精确改写与 0.1.2 / 0.1.5 起点 Settings 迁移的回归用例。
• 对照本地 deepseek-harness checkout 解析 dsh-v0.1.1-rc.2、dsh-v0.1.2-rc.1、dsh-v0.1.7-rc.2 三个 tag 的全部包导出（并比对 dsh-v0.1.5-rc.2 的包集合），逐项核实包增删、catalog 中每条符号规则的目标导出、Cordis 版本与 bundle patch 路径；三个新 catalog 均通过 --harness-root 的 tag commit 与 web profile entry 扫描校验。
• 使用 npm 发布的 @deepseek-ai/dsh@0.1.7-rc.2 对示例插件完成真实 migrate verify --level runtime（打包、临时 DSH_HOME 安装、--dump-config、激活冒烟均通过）。
• verification 参考文档补充提示：--harness-root 下过期的 lib/ 构建会通过版本检查但运行旧代码，应先重建或改用已发布包的 --dsh-command。

DSH Doctor v0.6.0

主要更新

• migration catalog 新增精确目标 dsh-v0.1.5-rc.2（对应 npm @deepseek-ai/dsh 已发布为 latest/next 的 0.1.5-rc.2）并设为默认值，Skill 的产品范围升级为 DSH 0.1.1 → 0.1.5；同时保留 0.1.2 的 alpha.2、alpha.3、rc.1 三个历史 catalog。
• 依据两个 tag 的逐项对比确认 0.1.2-rc.1 → 0.1.5-rc.2 区间没有删除或改名任何 @deepseek-ai/dsh-* 包，settings、client-store、client-ui、sdk-minimal、webhook 等插件落位包的公共入口零变更，cordis 维持 4.0.2；新增 18 个包（session-format 系列、sidebar、file-upload 等）作为纯增量能力记入 catalog 的 added 列表与 migration-map 区间说明。
• 记录该区间内 web profile 移除的 4 个 patch entry（client-runtime、api-gateway、tool-subagent-report、tool-str-replace-editor）以及 dsh-client-connection 内部 inject 列表变化，插件 patch overlay 命中这些 id 时会被分析器按既有 MIG_PATCH_TARGET_CHANGED 机制报告。
• 修复 doctor 的 DSH CLI 可用性误报：解析到命令后现在真实执行一次 --version 探测，不可执行时报出新的 DSH_CLI_NOT_RUNNABLE 错误并附失败详情，可执行时记录实际运行版本；dshCli.available 因此成为真实信号，command 型修复与移除动作不会再信任一个坏 shim。探测支持通过 cliProbe 选项注入以便测试。
• 同步 SKILL.md 版本对与描述、migrate analyze 示例、compatibility-strategy、verification、source-investigation、migration-map、中英文 README、package.json 描述与评测样例到 0.1.5-rc.2；新增 0.1.5 catalog、CLI 探测与"未来目标版本"（改用假想的 0.1.5-rc.3）回归测试。

安装

npm install --global @bruc3van/dsh-doctor@0.6.0
npx skills add bruc3van/dsh-doctor

验证

• 完成 CLI、doctor、migration、runtime、recovery、文档与 Skill 契约测试；对照本地 deepseek-harness checkout 的 dsh-v0.1.5-rc.2 tag（commit fb2c4b9e）逐项复核包增删、符号迁移、cordis 4.0.2、bundle patch 路径与 web profile entry 扫描（新增 21、移除 4 个条目），并用 npx 安装的真实 dsh 0.1.5-rc.2 验证 profile 结构与 --version、--dump-config、plugin add 命令面不变。

DSH Doctor v0.5.9

主要更新

• migration catalog 新增精确目标 dsh-v0.1.2-rc.1（对应 npm @deepseek-ai/dsh@next 已发布的 0.1.2-rc.1）并设为默认值，同时保留 alpha.2、alpha.3 历史 catalog。
• 补充 alpha.3 之后发生的两个包级变化：@deepseek-ai/dsh-tool-subagent-report 被移除（子代理上报与 follow-up 统一为 Steer 消息操作，模型侧适配在 dsh-tool-subagent-control），以及 @deepseek-ai/dsh-code-runtime-python 改名为 @deepseek-ai/dsh-experimental-code-runtime-python。这两个包现在会按"已移除包"报告，而不是误导性的依赖范围不匹配。
• Skill 的 catalog 版本对、migrate analyze 示例、中英文 README 与评测样例同步 rc.1；migration-map 新增 alpha.3 之后移除项的语义迁移指引。
• 新增回归测试覆盖 rc.1 catalog 的移除包识别、未引用依赖的清理，以及"未来目标版本"场景（改用假想的 0.1.2-rc.2）。

安装

npm install --global @bruc3van/dsh-doctor@0.5.9
npx skills add bruc3van/dsh-doctor

验证

• 完成 117 项 CLI、migration、runtime、文档与 Skill 契约测试；对照本地 deepseek-harness checkout 的 dsh-v0.1.2-rc.1 tag 逐项复核包增删、符号迁移、cordis 4.0.2 与 bundle patch 路径，并用 npx 安装的真实 dsh --version 输出核验 runtime 版本比较。

DSH Doctor v0.5.8

主要更新

• 修复 dsh-plugin-upgrade 的 YAML frontmatter：将包含冒号的长 description 明确标记为字符串，解决 npx skills add bruc3van/dsh-doctor 报错并跳过 Skill 的问题。
• 新增 frontmatter 结构回归测试，使用 YAML 解析器验证 name 和 description，避免仅靠文案匹配遗漏真实安装解析错误。

安装

npx skills add bruc3van/dsh-doctor

验证

• 完成 116 项 CLI、migration、runtime、文档与 Skill 测试，并通过 Skill 官方快速校验和真实 skills add 安装验证。

DSH Doctor v0.5.7

主要更新

• 重构 dsh-plugin-upgrade Skill：把当前 migration catalog 的 source/target 精确版本集中到单一事实块，其他说明统一引用该版本对，减少 catalog 升级时的重复维护。
• 补充更完整的插件迁移场景与触发样例，覆盖移除包的 import move、保留包中的符号移除、namespace import 人工调查，以及单版本与双版本兼容决策。
• 修复 Skill 重构后契约测试仍匹配旧文案导致的 GitHub Actions 失败；测试现在直接验证新的 catalog 边界和精确版本声明。

安装

npm install --global @bruc3van/dsh-doctor@0.5.7
npx skills add bruc3van/dsh-doctor

验证

• 完成 115 项 CLI、migration、runtime、文档与 Skill 契约测试，并检查 npm 发布包内容。

DSH Doctor v0.5.6

主要更新

• migration catalog 新增精确目标 dsh-v0.1.2-alpha.3 并设为默认值，同时保留 alpha.2 历史 catalog；补充 alpha.3 的包增删变化，并记录保留包 @deepseek-ai/dsh-settings 中 settingsNamespace 被移除后的 Settings Provider 语义迁移。
• 新增 --target-version，将 catalog 的已知 API 规则与经过额外源码调查的实际 0.1.2 目标分开；实际目标会绑定依赖检查、safe plan、报告哈希与 runtime 版本核验，并拒绝跨 release line 或早于 catalog 的版本。
• 静态分析现在识别保留包的 named import 和 named re-export 符号移除，同时避免误报同一模块中仍存在的导出；namespace import 的属性访问明确保留为人工调查边界。
• Skill 与中英文文档同步 alpha.3 catalog、npm exec 固定版本调用、实际版本调查流程、Settings Provider 迁移指引，以及 pnpm minimumReleaseAgeExclude 供应链策略的精确版本例外。

安装

npm install --global @bruc3van/dsh-doctor@0.5.6
npx skills add bruc3van/dsh-doctor

验证

• 完成 115 项 CLI、migration、runtime、文档与 Skill 契约测试；新增保留包符号移除、named re-export、future target pin、旧 prerelease 拒绝、plan 版本绑定和 alpha.3 runtime 回归覆盖。

DSH Doctor v0.5.5

主要更新

• migrate apply 新增持久化 --plan-file：预览以独占方式新建插件目录外的 plan，不覆盖已有文件，并通过分块 SHA-256 绑定包括大文件在内的完整分析输入与每项修改；正式写入必须消费同一个 plan，任何输入漂移都会拒绝写入。
• migration catalog 新增目标依赖分类策略，区分 Client 关系的 peer/dev 放置；不再把新 owner 机械复制到旧包所在的 dependency section。
• build/runtime 验证新增显式 --install 门：使用检测到的包管理器禁用 lifecycle scripts 后同步 lockfile 和 node_modules，按 runtime、development、peer 与 optional 声明核验实际解析的 DSH/Cordis 版本，再执行项目脚本。
• Skill 新增实际 DSH 与源码调查流程，覆盖 PATH、全局安装、DSH_HOME、插件 lockfile、Harness checkout、未收录版本 delta，以及 semantic finding 的调用方、Service、snapshot 和生命周期证据。
• migration manifest 检查补齐 dsh.client.platform 与 dsh.client.immediately 类型校验，并将顶层 out 纳入构建产物漂移扫描。
• 移除仅包含静态场景清单、未执行真实 Agent 运行的 Skill eval，避免把字符串契约检查误报为 Agent 场景评测。

安装

npm install --global @bruc3van/dsh-doctor@0.5.5
npx skills add bruc3van/dsh-doctor

验证

• 新增跨进程 plan 漂移、已有 plan 防覆盖、大文件输入哈希、plan 篡改、依赖分类、peer/optional peer 解析、依赖同步、静态预检短路和源码调查契约回归测试。

DSH Doctor v0.5.4

主要更新

• 为 dsh-plugin-upgrade 增加兼容性决策门：升级请求未明确时，允许先做只读分析，但在迁移写入、依赖安装、构建或运行时验证前必须询问开发者，是仅支持 DSH 0.1.2，还是同一插件版本继续兼容 0.1.1。
• 新增双版本兼容策略说明；0.1.2 catalog 的安全 codemod 在双版本模式下只作为候选修改，需要逐项复核旧版，且必须分别验证 0.1.1 与 0.1.2 的构建、产物、隔离运行和业务行为。
• 扩充 skill eval，覆盖兼容意图缺失、明确要求同一发布版本双兼容，以及单一产物不可行时不得静默放弃旧版的场景。

安装

npm install --global @bruc3van/dsh-doctor@0.5.4
npx skills add bruc3van/dsh-doctor

验证

• 完成 skill 结构、98 项测试和 npm 发布包内容检查；新增测试确保兼容决策门、双版本验证要求和中英文 CLI 测试不受本机语言环境影响。

DSH Doctor v0.5.3

主要更新

• 重构中英文 README，把 dsh-plugin-upgrade skill 的安装和使用放在前面，用更直接的方式说明 Agent、CLI 与 migration catalog 如何配合完成插件代码迁移、重新构建和验证。
• 对外统一描述为帮助插件从 DSH 0.1.1 升级到 0.1.2；dsh-v0.1.1-rc.2 与 dsh-v0.1.2-alpha.2 保留为当前 catalog 的精确参考点，其他 patch 或预发布组合需要核对实际差异。
• 补充源码、依赖、client graph、构建产物、隔离运行时的覆盖范围，以及只读分析、精确 codemod、显式确认、备份、写入保护和脱敏等安全边界。
• 同步更新 skill 描述、实际版本范围检查、发布准备说明和 eval；明确 Skill 只引导工作流程，不会自动修改全局 CLI、提交或发布插件。

安装

npx skills add bruc3van/dsh-doctor

验证

• 完成 skill 结构、95 项测试、npm 打包内容和远程 skill 安装检查，并由发布 CI 覆盖 macOS、Ubuntu、Windows 与 Node.js 22.19/24。

DSH Doctor v0.5.2

主要更新

• 为 dsh-plugin-upgrade skill 增加完整 CLI bootstrap：检查 Node.js、本地 DSH Doctor 版本和目标 migration catalog，并通过只读 npm view 检查 registry 最新版本。
• 本地 CLI 缺失、过期或缺少 catalog 时，默认使用解析后的精确 npm 版本执行 npx，并在 analyze、apply、verify 三阶段保持同一版本，避免多次使用 @latest 产生漂移。
• 明确 skill 安装不授权全局 npm 写入；只有用户显式确认后才允许全局安装或更新，并要求安装后重新核验版本和 catalog。
• 新增 CLI 缺失/过期场景的 skill eval，要求报告本地版本、registry 版本、最终选择、catalog 证据和更新状态。

安装

npx skills add bruc3van/dsh-doctor

验证

• 验证独立安装后的 skill 包含 CLI bootstrap reference 与新增 eval，并完成 skill 结构、95 项测试、完整 CI 矩阵和 npm 打包内容检查。