dsh-upgrade-skill

升级 DSH（DeepSeek Harness）插件的 skill。适用于检查已安装插件的更新、把插件 升级到新版本、处理升级引入的 breaking changes，以及 DSH 宿主升级后适配插件源码。

主 SKILL.md 保持版本无关：它提供「确认目标版本 → 给插件定形态 → 按形态执行 清单 → 真实 profile 验证」的通用流程。具体到某个宿主版本的包改名、API 重命名和 DOM 契约变化，统一放在 references/migration-baseline.md 的「迁移证据基线」里， 避免版本串散落在全文各处。

目录结构

dsh-upgrade-skill/
├── README.md                              # 本文件
└── skills/
    └── dsh-upgrade-skill/
        ├── SKILL.md                       # skill 主入口：通用升级工作流与形态清单
        └── references/
            ├── migration-baseline.md      # 迁移证据基线（当前覆盖：0.1.1 → 0.1.2-alpha.2）
            └── checklists.md              # 分形态修复样例、常见报错表、实测记录

安装

DSH 的 skill 发现根如下（优先级从高到低）：

来源	根目录
project-dsh	<项目根>/.dsh/skills
project-agents	<项目根>/.agents/skills
custom	Config.customSkillDirs
user-dsh	<dshHome>/skills
user-agents	<agentsHome>/skills

任选其一，把 skills/dsh-upgrade-skill 整个目录放进去（或创建符号链接）：

mkdir -p ~/.agents/skills
ln -s "$(pwd)/skills/dsh-upgrade-skill" ~/.agents/skills/dsh-upgrade-skill

skill 系统扫描目录 bundle（<name>/SKILL.md）与平铺 Markdown （<name>.md）。重启或新建会话后，模型会话目录中会出现 dsh-upgrade-skill，调用 skill 工具即可加载完整指令。

当前证据基线

• 升级起点：dsh-v0.1.1-rc.1
• 升级目标：dsh-v0.1.2-alpha.2（npm @deepseek-ai/dsh@0.1.2-alpha.2）
• 证据状态：迁移表来自两个 tag 的源码 diff；web client 的安装与 boot graph 已在目标版本上实测（浏览器内 DOM 交互待补）；ACP bridge 已完成构建、单测与 完整 initialize/session/new/prompt/cancel round trip（审批分支待专门复验）； 工具型 bundle + client 插件已完成构建、安装、web API 与内置自检（PASS 6/7）

只改这一个文件（references/migration-baseline.md）就能换到下一个目标版本； 主 SKILL.md 和 checklists 不需要跟着版本号一起改。

维护

• 目标版本变化时，更新 references/migration-baseline.md 的版本表、迁移表和 实测记录，并同步本 README 的「当前证据基线」；
• 新增插件形态或新报错时，先补 references/checklists.md，再在 SKILL.md 主 流程里加对应入口。