dsh-plugin-upgrade-skill
帮助插件自动随着dsh版本升级的skill
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/oh-my-dsh--dsh-plugin-upgrade-skill)HTML
<a href="/listings/oh-my-dsh--dsh-plugin-upgrade-skill"><img src="/api/listings/oh-my-dsh--dsh-plugin-upgrade-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
- "name": "dsh-plugin-upgrade-skill",
- "description": "DeepSeek Harness plugin upgrade assistant with version-agnostic migration guides and community-driven examples",
- "owner": {
- "name": "oh-my-dsh",
- "url": "https://github.com/oh-my-dsh"
- },
- "plugins": [
- {
- "name": "dsh-plugin-upgrade-skill",
- "version": "0.1.0-alpha.2",
- "source": {
- "source": "github",
- "repo": "oh-my-dsh/dsh-plugin-upgrade-skill"
- },
- "description": "Safely upgrade DeepSeek Harness plugins with breaking change guides, migration recipes, and real-world examples from community practice",
- "homepage": "https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill",
- "license": "MIT",
- "keywords": ["deepseek-harness", "dsh", "plugin", "migration", "upgrade", "breaking-changes"]
- }
- ]
- }
README.md · README · 273 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # DSH Plugin Upgrade Skill
- **简体中文** | [English](README.en.md)
- [](https://arxiv.org/abs/2609.30120) [](LICENSE)   
- **教 AI 帮你升级 DSH 插件的 skill 集合**,社区共建。
- [DSH(DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness) 是一个"所有功能都以插件形式存在"的 AI 运行框架。麻烦在于:**DSH 每次发新版,老插件就可能启动不了**。本仓库把已知的坑整理成 AI 读得懂的升级手册,让 Claude Code、Codex、Gemini 等 agent 帮你把插件安全迁到新版本,并用一套公开的 benchmark 检验这件事到底有没有做对。
- > 📄 **论文**:[Evaluating Agent Skills for Version-Specific Plugin Migration: A Retrospective Study](https://arxiv.org/abs/2609.30120)(arXiv:2609.30120)。评估方法与主要发现见[论文](#论文)一节。
- ## 这个仓库里有什么
- - **246 张升级说明卡**:每张卡记录一个真实的坑——什么坏了、为什么坏、怎么修、信息来自哪个版本。按版本走廊排好序,覆盖 0.1.0-rc.8 → 0.2.1-rc.5,并在 rc.4 处分出 0.2.2-alpha.2 一支(其中 0.1.7-rc.1 → 0.1.7-rc.2 一段尚未成卡),每条边的卡数与状态见下方[覆盖表](#升级卡覆盖到哪个版本了)。
- - **13 条通用对策**:与具体版本无关的坑(先备份、新旧共存、启动卡死怎么办等),集中在一份清单里。
- - **12 个 skill**:统一工作流负责选择与编排,另外十个分别负责查升级、直连官方升级指南做快速适配、写插件、测插件、发插件、对比两个版本、排查运行时故障、接入重依赖、宿主升级后巡检整批已装插件、把升级经验提取成考题;还有一个不含 DSH 专有知识的通用迁移方法论,用作对照实验的控制组。
- - **65 道自动判分的考题(benchmark)**:27 道笔试(读代码给答案)、38 道实操(真装 dsh 真跑插件),其中包含 dsh-web 与 dsh-data-agent 两次真实迁移。
- - **一篇论文和完整的评估证据**:从原始回答、逐条评分到跨模型复评全部公开可复算,见下方[论文](#论文)。
- ## 快速开始
- ### 使用 skills CLI(推荐)
- 一条命令装到它支持的 agent:
- ```bash
- npx skills add oh-my-dsh/dsh-plugin-upgrade-skill
- ```
- ### Claude Code
- **Marketplace 安装**:
- ```bash
- /plugin marketplace add oh-my-dsh/dsh-plugin-upgrade-skill
- /plugin install dsh-plugin-upgrade-skill
- ```
- > **SSH 错误?**如果没有配置 GitHub SSH 密钥,使用 HTTPS URL:
- > ```bash
- > /plugin marketplace add https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
- > /plugin install dsh-plugin-upgrade-skill
- > ```
- **本地/开发模式**:
- ```bash
- git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
- claude --plugin-dir /path/to/dsh-plugin-upgrade-skill
- ```
- ### Codex
- 先添加 marketplace,再在 Codex 的插件界面中安装/启用该插件:
- ```bash
- # GitHub marketplace
- codex plugin marketplace add oh-my-dsh/dsh-plugin-upgrade-skill
- # 本地开发 marketplace
- git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
- codex plugin marketplace add ./dsh-plugin-upgrade-skill
- ```
- 当前 Codex CLI 没有直接安装子命令;GitHub 与本地路径都通过 `plugin marketplace add` 注册。
- ### Gemini CLI
- 直接从仓库或本地克隆安装:
- ```bash
- # 从仓库
- gemini skills install https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git --path skills
- # 本地
- git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
- gemini skills install ./dsh-plugin-upgrade-skill/skills/
- ```
- ### Cursor
- 将 `skills/` 复制到 `.cursor/skills/`:
- ```bash
- git clone https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill.git
- cp -r dsh-plugin-upgrade-skill/skills/* .cursor/skills/
- ```
- ## 怎么用
- Claude Code 中按名字调用 skill(插件安装后带命名空间):
- ```
- /plugin-workflow
- /dsh-plugin-upgrade-skill:plugin-workflow
- /plugin-upgrade 0.1.2
- /dsh-plugin-upgrade-skill:plugin-upgrade 0.1.2
- ```
- 首次只调用统一入口、尚未说明目标流程时,它会先列出 9 个工作流程和 14 项可选能力,推荐只读
- `health-check` 但不会自动执行。回复流程编号或名称,并按需增减能力后,它才会生成阶段账本并开始:
- ```text
- 选择 1
- 选择 compatibility-migration,加上 docker-smoke 和 browser-check
- ```
- 也可以直接在对话中提问(任意 agent),skill 按描述自动触发;只读检查直接给结果,升级或迁移会先出计划再等确认:
- ```
- 先检查这个 DSH 插件,让我选择要不要升级、测试、查云端命名或发布
- 我需要把插件从 0.1.1 升级到 0.1.2,有哪些破坏性变更?
- 帮我把 dsh-ads 这个插件升级到 dsh-v0.1.2-alpha.2
- 校验这个插件的命名并查询中央注册表;保留索引 URL 和 SHA-256,不要提交注册
- ```
- `naming-registry` 默认执行离线命名校验和只读中央查询;中央注册仍是单独的外部发布步骤。
- 代理网络下使用 Node 24+ 的 `node --use-env-proxy` 运行查询,Node 20-23 不保证内置 `fetch`
- 自动读取代理环境变量。查询失败、索引超限或 v2 契约不合法都表示“未知/未检查”,不能解释为名称可用。
- ## 12 个 skill 各自管什么
- | Skill | 干什么用 |
- | --- | --- |
- | [plugin-workflow](skills/plugin-workflow/) | 统一入口。运行前选择检查、升级、测试、命名注册、打包发布等功能,生成阶段账本并分别确认写入、运行和外部发布 |
- | [plugin-upgrade](skills/plugin-upgrade/) | 主角。检查插件要不要升级、执行升级、把老插件适配到新 dsh 版本 |
- | [plugin-fast-adapt](skills/plugin-fast-adapt/) | 不读升级卡,直连官方源的快速适配流水线:从 npm dist-tags 定目标版本、取该版本官方 upgrade-guide、扫描插件代码命中破坏性变更,再做冒烟与体检;独立仓库 [taxueseek/plugin-fast-adapt](https://github.com/taxueseek/plugin-fast-adapt) 的快照,不经统一工作流编排 |
- | [plugin-write](skills/plugin-write/) | 写新插件,附命名规范和查重(避免和别人插件撞名) |
- | [plugin-test](skills/plugin-test/) | 测插件改得对不对,含 docker 冒烟测试(装上 dsh 真启动一遍) |
- | [plugin-release](skills/plugin-release/) | 打包发布插件,含发布前的自动检查 |
- | [dsh-upgrade-audit](skills/dsh-upgrade-audit/) | 对比两个 dsh 版本到底改了什么,给升级卡提供证据 |
- | [plugin-runtime-debug](skills/plugin-runtime-debug/) | 排查插件在宿主里的运行时故障(坐标/投影不匹配、版本滞后、幽灵条目等) |
- | [plugin-fleet-sweep](skills/plugin-fleet-sweep/) | 宿主升级后对整批已安装插件做巡检:静态扫改名/删除的 API、真浏览器逐插件断言,并按插件逐个修复发布 |
- | [plugin-heavy-dep](skills/plugin-heavy-dep/) | 给轻量插件接入重依赖(mermaid 这类),含懒加载接入清单 |
- | [dsh-benchmark-case](skills/dsh-benchmark-case/) | 把某个插件的真实升级经验(或已有版本卡)提取成一条可自动判分的 benchmark 考题(fixture + instruction + judge + solution) |
- | [generic-migration](skills/generic-migration/) | 框架无关的插件迁移方法论(盘点耦合面、通读版本走廊、分层验证),不含任何 DSH 专有事实;用作对照实验的控制组 |
- ## 升级卡覆盖到哪个版本了
- | 版本区间 | 状态 | 说明卡 | 备注 |
- | --- | --- | --- | --- |
- | 0.1.0-rc.8 → 0.1.1-rc.1 | 📝 草稿 | [v0.1.1-rc.1.md](skills/plugin-upgrade/references/v0.1.1-rc.1.md) | 9 张草稿卡(vlln 插件迁移:repository 机制移除、strict inject、0812 服务改名等;走廊为 0810–0812 内测快照窗口的最近公开 tag 对齐,待上游复核) |
- | 0.1.1-rc.1 → 0.1.1-rc.2 | ✅ 完成 | [v0.1.1-rc.2.md](skills/plugin-upgrade/references/v0.1.1-rc.2.md) | 3 张卡 |
- | 0.1.1-rc.2 → 0.1.2-alpha.1 | ✅ 完成 | [v0.1.2-alpha.1.md](skills/plugin-upgrade/references/v0.1.2-alpha.1.md) | 28 张卡 |
- | 0.1.2-alpha.1 → 0.1.2-alpha.2 | ✅ 完成 | [v0.1.2-alpha.2.md](skills/plugin-upgrade/references/v0.1.2-alpha.2.md) | 8 张卡 |
- | 0.1.2-alpha.2 → 0.1.2-alpha.3 | ✅ 完成 | [v0.1.2-alpha.3.md](skills/plugin-upgrade/references/v0.1.2-alpha.3.md) | 2 张卡(A3-01 新增 `settings.plugin.item` keyed-slot 设置卡能力;A3-02 移除可选 SQLite Session 持久化后端,opt-in 部署需旧版导出) |
- | 0.1.2-alpha.3 → 0.1.2-alpha.4 | ✅ 完成 | [v0.1.2-alpha.4.md](skills/plugin-upgrade/references/v0.1.2-alpha.4.md) | 6 张卡(`report` → `send_message`、Python 运行时包改名、`Session.events` 移除、seq 强类型、PTC `workflow` 与 base `web_fetch` 默认值;三台真宿主验证) |
- | 0.1.2-alpha.4 → 0.1.2-alpha.5 | ✅ 完成 | [v0.1.2-alpha.5.md](skills/plugin-upgrade/references/v0.1.2-alpha.5.md) | 3 张卡(storage 域 `compatibleVersions` 读兼容与 `backup-and-skip` 兜底;旧家升级拒启/标题丢失修复;storage 层复现核对) |
- | 0.1.2-alpha.5 → 0.1.2-rc.1 | ✅ 完成 | [v0.1.2-rc.1.md](skills/plugin-upgrade/references/v0.1.2-rc.1.md) | 0 张卡(纯版本 bump;含核对记录、macOS 真机验证与 release notes 覆盖矩阵) |
- | 0.1.2-rc.1 → 0.1.3-alpha.1 | 📝 草稿 | [v0.1.3-alpha.1.md](skills/plugin-upgrade/references/v0.1.3-alpha.1.md) | 8 张草稿卡(session-log 走廊 A1-01/02 + Windows 安装 fs-ext 原生构建 A1-03 + host-plane/policy A1-04/05/06 + A1-07/08 未发布 cohort 源码宿主验证配方与 composer/read_image 运行时复核;release tarball 实测,tag 对齐待上游复核) |
- | 0.1.3-alpha.1 → 0.1.3-alpha.2 | 📝 草稿 | [v0.1.3-alpha.2.md](skills/plugin-upgrade/references/v0.1.3-alpha.2.md) | 5 张草稿卡(persona 拆前缀/后缀、`SubprocessHandle.pid` 移除、base 移除 str-replace 编辑器默认行、launcher `runCli()`/`import.meta.main`、pi-ai 0.84.2→0.85.1) |
- | 0.1.3-alpha.2 → 0.1.5-alpha.1 | 📝 草稿 | [v0.1.5-alpha.1.md](skills/plugin-upgrade/references/v0.1.5-alpha.1.md) | 20 张草稿卡(Session 格式 V3 + `EpochHeader.system` 移除、`ctx.agent` 移除、Inbox 类型化、会话事件校验收紧、PTC 改名、system prompt 入消息历史、CLI 拒 `desktop`、`--from-default-profile`、文件面新 API、Web Client `details`→`rightbar` 重构、右栏/资源扩展点、`tool-subagent` 契约、host SSH/指令发现 seam;版本号跳跃边 0.1.3-alpha.2 → 0.1.5-alpha.1) |
- | 0.1.5-alpha.1 → 0.1.5-alpha.2 | 📝 草稿 | [v0.1.5-alpha.2.md](skills/plugin-upgrade/references/v0.1.5-alpha.2.md) | 24 张草稿卡(`workspaceFiles` 改查 `workspaceFileScope`、文件读取越出工作区根 + `maxFileBytes`、`conversation` 迁到根级 `main`、minimal profile 只剩持久 shell、两个不可忽略会话事件、pi-ai 配置变更、scope 感知工具指引、`present`/reveal、文档预览改名、新 `chunked-list`/`tool-present` 包、MCP 分页 cursor 拒绝、session-format-status 文档;客户端/打包面 12 张:`rightbar` 根级化 + layout 重写、`client-resources` 去 `reload`、`ui-primitives` 图标改名、`ui-dockkit` 漂移、消息反馈注入面、`ui-workspace` 导航、交付 turn tail、浏览器依赖迁 devDeps、`documentPreviews` 注册表、action 命令、feedback Remote、右栏默认页规则) |
- | 0.1.5-alpha.2 → 0.1.5-rc.1 | 📝 草稿 | [v0.1.5-rc.1.md](skills/plugin-upgrade/references/v0.1.5-rc.1.md) | 5 张草稿卡(base 默认模型 id 改 `deepseek-flash`;适配器目录新增 V41 Flash(图片输入、历史系统提示词、不探测网关);文档渲染器新增必填 `scrollportRef`;侧栏 guide 条目新增可选 `description`;含"未改动面"负面证据与 17 仓库舰队核对记录)。本边只有 17 个提交 |
- | 0.1.5-rc.1 → 0.1.5-rc.2 | 📝 草稿 | [v0.1.5-rc.2.md](skills/plugin-upgrade/references/v0.1.5-rc.2.md) | 6 张草稿卡(反馈面注入契约去掉 `toggle`/`acknowledge`、`openDialog` 加必填 `rating`;点赞/点踩都改为弹窗确认、提交失败转 6s 警告 toast;`FileTypeIcon` 48 个代码分类换设计导出 artwork;回合尾动作条与文件区 20/16/20px 间距契约;`service-stability` 中英文文案改字;以及"宿主面零行为变更"的负面证据) |
- | 跨版本通用对策 | ✅ 完成 | [rollup-0.1.2.md](skills/plugin-upgrade/references/rollup-0.1.2.md) | 13 条(新旧共存、先备份、启动卡死怎么办等) |
- | 0.1.5-rc.2 → 0.1.6-alpha.1 | 📝 草稿 | [v0.1.6-alpha.1.md](skills/plugin-upgrade/references/v0.1.6-alpha.1.md) | 38 张草稿卡(目前最宽的一条边:800 个提交、4015 个改动文件。宿主面:`agent/session-start` 删除、`agent/created` 改串行可等待并携带 `source`/`signal`、`auditStartupEntries` 取代 `assertEntries*`、会话事件同步读取弃用、新增 `registerMessageProjection()` 与"无解释器即拒读"、session-log 默认上传;运行时:`codeRuntime`→`ptcRuntime` 且 `run` 拆成 `resolve`/`run`、`SandboxProvider.confine` 与 `ShellExecutor.start` 异步化、子进程 provider 新增 `terminalEnvironment()` 与可选控制通道、`workflow-ptc` 取代 worker-thread、MCP 升 2.0 SDK、新增 `ctx.mcpResources` 与 `ctx.ssh`;LLM:适配器改为上报 `IMAGE_OFFLOAD_REQUIRED`、`deepseek-official` 默认 Anthropic Messages 协议、图片进 v41 token 网格、投影 stateVersion 5、`AssistantProvenance`→`AssistantProviderMetadata`;客户端:provenance→producer/provider metadata、`CommandClaim.name` 必填、新增 `conversation.input.permission` 与 keyed guide slot、`reconnectLabel` 移除、diff 带上下文、`?fixture` 模式退役;打包面:base 行替换、默认挂载 `image-offload`(`image/offload` 必读事件)与 `mcp-resources`、默认关闭 `tool-ralph`、Web 包去掉 `code-runtime` 行、+22/−7 包账单、headless `--session-id`/`--json`、公共包清单重建、实验包改黑名单发布、原生依赖下限 `^0.1.4`→`^0.1.6`;并附"未改动面"负面证据) |
- | 0.1.6-alpha.1 → 0.1.6-alpha.2 | 📝 草稿 | [v0.1.6-alpha.2.md](skills/plugin-upgrade/references/v0.1.6-alpha.2.md) | 4 张草稿卡(`SessionListState.current` 删除,主会话改经 `uiSession.adapter.current` 解析;全局标准 props 用 `useSessionStatus` + `useSessionRetainInfo` 取代 `useSessionPendingInteraction`,`useSessions` 保留;新增 Plugin Manager 管理 profile bundle 与 patch 行开关,link 安装的插件不在其管理范围;GitHub 发版后 npm 有 E404 窗口;三个外部插件已发修复版的一手证据) |
- | 0.1.6-alpha.2 → 0.1.7-alpha.1 | 📝 草稿 | [v0.1.7-alpha.1.md](skills/plugin-upgrade/references/v0.1.7-alpha.1.md) | 11 张草稿卡(客户端图标集删除全部 `*16` 导出、`workspaceFiles` 读取统一到 `readBytes`、设置迁入 Profile 插件配置、bundle 声明 agent preset、session log V4、官方 DeepSeek 适配器只走 Messages API、多 patch bundle、容错 Profile 加载、按 locale 的插件元数据、自定义事件附件不再自动读取、新增设置页座位 `settings.launcher`/`settings.models.sign-in`;前一条边 0.1.6-alpha.1 → 0.1.6-alpha.2 单独成卡) |
- | 0.1.7-alpha.1 → 0.1.7-alpha.2 | 📝 草稿 | [v0.1.7-alpha.2.md](skills/plugin-upgrade/references/v0.1.7-alpha.2.md) | 4 张草稿卡(`spill-policy` 改用 `maxInlineTokens`、vendored 依赖只锁同 minor 补丁、首次安装自动选 npm registry、客户端 bundle 启动时缓存且页面自动重连) |
- | 0.1.7-alpha.2 → 0.1.7-rc.1 | 📝 草稿 | [v0.1.7-rc.1.md](skills/plugin-upgrade/references/v0.1.7-rc.1.md) | 5 张草稿卡(DSH peer 范围在安装和启动时强制校验、宿主 semver ≥ 7.8.3 下 `^0.1.7` 不接受 rc.1 的陷阱;toolview 三阶段;瞬态事件启动会话;工作详情四种模式;插件管理器限制静默 pnpm 运行) |
- | 0.1.5-rc.2 ⇒ 0.1.7-rc.1(jump) | 📝 草稿 | [jump-0.1.5-rc.2-to-0.1.7-rc.1.md](skills/plugin-upgrade/references/jump-0.1.5-rc.2-to-0.1.7-rc.1.md) | 34 张 jump 卡(不是走廊边,而是给"从 0.1.5-rc.2 一路跳到 0.1.7-rc.1、中间没停在任何 alpha"的部署看的合并净变更视图,约 3300 个提交:宿主 peer 兼容强制、PTC 运行时改名、声明式 agent preset、设置迁入 Profile 插件配置、Session log V4、Remote 双工/二进制 + `readBytes`、异步 Agent 生命周期、`Message` role 联合、Messages-only DeepSeek 适配器、toolview 三阶段、图标字重改名、右栏 tab 契约、plugin-manager 页面等;与同窗口的逐边卡(上表 0.1.6-alpha.1 至 0.1.7-rc.1 五行)互为交叉引用。`plan-migration` 只走 v\*.md 走廊,不消费本文件) |
- | 0.1.1 → 0.1.2 正式版 | ⛔ 上游没走这条路 | — | 0.1.2 正式版从未发布。`0.1.2-alpha.1` 有 git tag 但没有 npm 包(npm 上 0.1.2 线最早是 `0.1.2-alpha.2`,最晚是 `0.1.2-rc.1`),上游随后直接进入 0.1.3 → 0.1.5 → … → 0.2.x。本行保留只为说明这条边不会再有卡可补。走廊按 tag 排,所以 `0.1.2-alpha.1` 那张卡仍然有效。(npm 状态截至 2026-10-16:`latest` = `0.2.0-rc.2`,`next` = `0.2.0-rc.2`,`alpha` = `0.2.1-alpha.4`) |
- | 0.1.7-rc.1 → 0.1.7-rc.2 | 📝 等社区认领 / 尚未成卡 | — | 346 个提交,含真实改动(Schedule 先进默认 Web 组合再被禁用、native-command Windows 适配器、auto-review、user-questions 限时等待、工具描述精简、插件管理器修复);`plan-migration` 从 ≤0.1.7-rc.1 出发会报走廊缺口。想帮忙写卡?看 [贡献指南](CONTRIBUTING.md) |
- | 0.1.7-rc.2 → 0.2.0-rc.1 | 📝 草稿 | [v0.2.0-rc.1.md](skills/plugin-upgrade/references/v0.2.0-rc.1.md) | 6 张草稿卡(宿主包跨到 0.2.0:所有 `^0.1.x` 下限的 DSH peer 被拒,`^0.2.0` 本身也不接受 rc 宿主——附实测范围表与一手证据;Web 工作详情默认改为 `detailed`、默认值移入客户端代码、`transcriptView` 变为可选;Schedule 行移出默认 web-app bundle,改由 `@deepseek-ai/dsh-experimental-schedule-bundle` 提供;bundle 组合新增遥测行;`fork` 新增 `onCreated`;Explorer 打开路径改为可见窗口,可撤掉本地 reveal 热修。两条 Desktop 0.2.0-rc.2 现场记录已折叠进下一条边卡集) |
- | 0.2.0-rc.1 → 0.2.0-rc.2 | 📝 草稿 | [v0.2.0-rc.2.md](skills/plugin-upgrade/references/v0.2.0-rc.2.md) | 3 张草稿卡(桌面运行时面,实机 Desktop 0.2.0-rc.2 一手验证:Electron 壳经 `dsh-app://app` 转发渲染进程请求前删除 `host`/`origin`/`cookie`/`sec-fetch-site`、WS origin 改写为 Host authority——要求肯定性浏览器标记的插件 fence 全线 403,按平台围栏信任语义修正;原两条现场笔记折叠成卡:Desktop `ctx.sessions` 注册表为空(附上游 discussion 链接)、Windows 子进程 PATH 最小化;未归因现场笔记记录 `readSession` seeded 会话重放校验)。下一条边 0.2.1-alpha.1 另有在途认领 |
- | 0.2.0-rc.2 → 0.2.1-alpha.1 | 📝 草稿 | [v0.2.1-alpha.1.md](skills/plugin-upgrade/references/v0.2.1-alpha.1.md) | 8 张草稿卡(运行时 invariant 插件与 `./invariant` 导出移除、输入区统计拆为 `activity`/`usage`、子路径插件改走子路径导出取展示文本与图标、Schedule 进默认 Web 组合、样式注入 owner 化、安装回报实际版本、依赖映射生命周期、HMR 刷新清单) |
- | 0.2.1-alpha.1 → 0.2.1-alpha.2 | 📝 草稿 | [v0.2.1-alpha.2.md](skills/plugin-upgrade/references/v0.2.1-alpha.2.md) | 11 张草稿卡(工具展示 `both` 模式移除、子代理改为受管 activation、Agent Team 直投 Inbox、`dshHome` 键移除、Python PTC 需 `sandbox`/`sandboxPolicy`、`{{cwd}}` 变量移除、Web profile 去掉 `webRuntime`(改 `webStartup`)等) |
- | 0.2.1-alpha.2 → 0.2.1-alpha.3 | 📝 草稿 | [v0.2.1-alpha.3.md](skills/plugin-upgrade/references/v0.2.1-alpha.3.md) | 5 张草稿卡(Azure 提供方改名 `azure`、API Key 优先级按表面分裂、插件更新热生效、`--from-default-profile` 整体替换已有配置) |
- | 0.2.1-alpha.3 → 0.2.1-alpha.4 | 📝 草稿 | [v0.2.1-alpha.4.md](skills/plugin-upgrade/references/v0.2.1-alpha.4.md) | 3 张草稿卡(兼容判定优先读 `engines.dsh`(`includePrerelease` 语义)、自定义插件索引源) |
- | 0.2.1-alpha.4 → 0.2.1-alpha.5 | 📝 草稿 | [v0.2.1-alpha.5.md](skills/plugin-upgrade/references/v0.2.1-alpha.5.md) | 2 张草稿卡(新增单 owner 的 `conversation.input.model.label` slot、`/` 菜单随插件启停刷新等修复) |
- | 0.2.0-rc.2 ⇒ 0.2.1-alpha.5(jump) | 📝 草稿 | [jump-0.2.0-rc.2-to-0.2.1-alpha.5.md](skills/plugin-upgrade/references/jump-0.2.0-rc.2-to-0.2.1-alpha.5.md) | 20 张 jump 卡(不是走廊边,而是给从 0.2.0-rc.2 直接跳到 0.2.1-alpha.5 的部署看的合并净变更视图,约 1900 个提交:`engines.dsh` 优先与 `requirements` 改名、invariant 体系退役、`webRuntime`→`webStartup`、`{{cwd}}` 移除、子代理委派换代、配置键删除带、client API 删除、协议对端变更、Windows 舰队机制卡等;对应的逐边卡为 A1–A5) |
- | 0.2.1-alpha.5 → 0.2.1-rc.1 | 📝 草稿 | [v0.2.1-rc.1.md](skills/plugin-upgrade/references/v0.2.1-rc.1.md) | 3 张草稿卡(插件全生命周期依赖同步、五个实验性插件席位、杂项能力) |
- | 0.2.1-rc.1 → 0.2.1-rc.3 | 📝 草稿 | [v0.2.1-rc.3.md](skills/plugin-upgrade/references/v0.2.1-rc.3.md) | 3 张草稿卡(rc.2+rc.3 合为一条边:V4.1-Flash-1017 适配器与可选 DeepSeek Search/Fetch、插件发现「更多」菜单、新会话重新复用空白会话(推翻 DSH-0.2.1-A2-07)) |
- | 0.2.1-rc.3 → 0.2.1-rc.4 | 📝 草稿 | [v0.2.1-rc.4.md](skills/plugin-upgrade/references/v0.2.1-rc.4.md) | 1 张草稿卡(版本同步发布:CLI `lib/` 逐字节相同,仅 ACP stdout 诊断泄漏修复) |
- | 0.2.1-rc.4 → 0.2.1-rc.5 | 📝 草稿 | [v0.2.1-rc.5.md](skills/plugin-upgrade/references/v0.2.1-rc.5.md) | 1 张草稿卡(`conversation.chat.reasoning.body` 的 `text` 改为展示文本、原始输出移到新增 `rawText`) |
- | 0.2.1-rc.4 → 0.2.2-alpha.2 | 📝 草稿 | [v0.2.2-alpha.2.md](skills/plugin-upgrade/references/v0.2.2-alpha.2.md) | 3 张草稿卡(0.2.2 线起点(与 rc.5 分叉):插件管理器第三方包更新、Web 客户端移动端重做、六插件契约巡检;**34 篇上游升级指南尚未成卡**(含 Node.js 24.9 下限等破坏性变更),见文件末尾清单) |
- | 0.2.2-alpha.2 → 0.2.2-alpha.3 | 📝 草稿 | [v0.2.2-alpha.3.md](skills/plugin-upgrade/references/v0.2.2-alpha.3.md) | 8 张草稿卡(统一右键/键盘菜单:\`MenuTarget\`→\`ContextMenuTarget\`、keyed \`contextMenu.icon\`;pi-ai 动态请求头(无效头请求前报错)与图片超限自动省略;Cordis Core 4.0.0-rc.11/Loader 1.0.0-rc.8 统一配置访问与条目变更;插件管理器设置导航图标+安装/启用失败区分;文件先读/外部修改防护默认关闭;自动化任务宿主级管理+工作树并入变更请求(需手动移除 bundle)+默认关闭的 \`apply_patch\`;六插件舰队 0.2.2-alpha.3 实测+npm 中断安装双层损坏恢复 runbook) |
- | 0.2.1-alpha.5 ⇒ 0.2.2-alpha.2(jump) | 📝 草稿 | [jump-0.2.1-alpha.5-to-0.2.2-alpha.2.md](skills/plugin-upgrade/references/jump-0.2.1-alpha.5-to-0.2.2-alpha.2.md) | 6 张 jump 卡(不是走廊边,而是从 0.2.1-alpha.5 直接跳到 0.2.2-alpha.2 的合并视图:兼容清单门槛、依赖感知的插件生命周期、模型与 Web 面、README 详情页、新 Web 客户端、舰队验证记录;与逐边文件共享 34 篇未成卡的上游指南缺口) |
- ## 考题(benchmark)
- [benchmark/](benchmark/) 目录下有 65 道升级考题和自动判分,采用 [Harbor](https://github.com/harbor-framework/harbor) 任务格式:每题一个自包含任务(自带 DSH 环境的容器 + 自动 verifier),`harbor run -p benchmark/tasks/<题号> -a <agent>` 即可得到 0~1 分。同一个 agent 装 skill 做一遍、不装做一遍,分差就是 skill 的实际效果。多个模型与 agent 的实测结果和完整报告列在 [benchmark/README.md](benchmark/README.md),报告原文在 [benchmark/results/](benchmark/results/)。
- ## 论文
- 我们把这个 skill 的评估写成了一篇回顾性研究:[arXiv:2609.30120](https://arxiv.org/abs/2609.30120)。它关注的问题是:**分数提高了,是否说明迁移建议真的满足了目标版本的契约?**
- - **分数提升**:在 16 道静态迁移诊断题、64 份回答上,挂载 skill 后平均得分从 93.83 升到 98.75(+4.92,95% 区间 [0.31, 10.86])。提升集中在少数题目,8 组题两边都已满分。
- - **契约层面的检查**:把 328 条评分决策逐条对到版本契约,并用可执行探针复核,发现了评分本身的问题,例如一个会放过父目录的路径守卫仍拿到满分。分数高不等于建议正确。
- - **跨模型复评**:用另外两个模型家族(Claude Opus 5.5、GPT-5.5)在不知道分组、也看不到原分数的条件下重评全部 64 份回答,与原评审的一致率为 91.8% 和 95.7%,重算的提升为 +10.63 和 +6.09,方向一致、幅度随评审而变。
- - **可复算**:原始回答、评分、复核、复评协议与脚本都在仓库里,入口见 [paper/](paper/)。
- 局限(单一框架、静态诊断、尚无独立人工标注与对照组)在论文中如实说明,后续工作也已列出。
- ## 参考资源
- - [官方仓库](https://github.com/deepseek-ai/deepseek-harness) — DSH 主仓库
- - [Discussion #5120](https://github.com/deepseek-ai/deepseek-harness/discussions/5120) — 社区迁移踩坑征集(本仓库的起点)
- - [dsh-web 迁移实例](https://github.com/zhu1090093659/dsh-web) — @zhu1090093659 的完整迁移案例
- ## 项目里直接用
- 使用统一工作流时,把整个 `skills/` 目录复制到项目里,因为 `plugin-workflow` 会把每个阶段交给另外五个 owning Skill。只需要升级能力时,也可以单独复制 `skills/plugin-upgrade/`:
- ```text
- <your-project>/.agents/skills/
- ├── plugin-workflow/
- ├── plugin-upgrade/
- ├── plugin-write/
- ├── plugin-test/
- ├── plugin-release/
- └── dsh-upgrade-audit/
- ```
- 注意保留里面的 `SKILL.md` 和 `references/` 文件夹,别只复制一个文件。也可以让 DSH 本地的 skill 加载方式直接指向本仓库的 `skills/` 目录。
- ## 仓库目录
- ```text
- skills/<skill-name>/
- ├── SKILL.md # skill 的说明书(怎么触发、怎么干活)
- ├── references/ # 升级说明卡和详细资料
- ├── scripts/ # 可执行的小工具(含迁移规划器、工作流计划器和运行时验证器)
- └── examples/ # 示例代码(只读,不要运行)
- scripts/validate.mjs # 仓库自检
- scripts/validate-manifests.mjs # 多 agent 清单自检
- benchmark/ # 65 道考题 + 判分 + 验证报告
- ```
- ## 想贡献?
- CI 分层、工作流组合回归和真实模型对照评测入口见
- [Skill CI 说明](benchmark/docs/skill-ci.md)。参考答案测试通过不代表模型已正确使用 Skill。
- 1. 按 [skills/README.md](skills/README.md) 的规范写;
- 2. 升级卡按 [卡片格式](skills/plugin-upgrade/references/README.md) 填;
- 3. 跑两条自检命令,全绿再提 PR:
- ```sh
- node scripts/validate.mjs
- node scripts/validate-manifests.mjs
- ```
- ## 引用
- 如果本仓库或论文对你的工作有帮助,请引用:
- ```bibtex
- @misc{liu2026evaluating,
- title = {Evaluating Agent Skills for Version-Specific Plugin Migration: A Retrospective Study},
- author = {Liu, Beiming and Li, Haihao and Chen, Minjie and Chen, Ning and Wang, Yiran and Ye, Jiming and Zhang, Puzhao and Wang, Tongtao and Gao, Sheng and Jin, William and Mu, Weihao and Liu, Chengzhi and Xia, Yucheng and Wang, Guangren and Fan, Chaoyang and Huang, Changfeng and Lin, Xunming and Shen, Yuanjie},
- year = {2026},
- eprint = {2609.30120},
- archivePrefix = {arXiv},
- primaryClass = {cs.SE},
- url = {https://arxiv.org/abs/2609.30120}
- }
- ```
- ## 致谢
- 论文作者与所有提交过 PR 的贡献者共同建设了本仓库,完整名单见 [Contributors](https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill/graphs/contributors)。
- - [@hikariming](https://github.com/hikariming) — 仓库维护与 dsh 技能检索站 [dshfind.com](https://dshfind.com)
- - [@ccch1mneyyy](https://github.com/ccch1mneyyy) — issue #1 提案和 alpha 版本卡片
- - [@zhu1090093659](https://github.com/zhu1090093659) — [dsh-web](https://github.com/zhu1090093659/dsh-web) 迁移实践与详细痛点记录
- - [@huiliyi37](https://github.com/huiliyi37) — [dsh-tui](https://github.com/huiliyi37/dsh-tianshu-tui) 0.1.2-alpha.2 迁移实测
- - [@tianyicui](https://github.com/tianyicui) — discussion #5120 发起和官方征集
- ## License
- [MIT](LICENSE)
benchmark/report-judge/calibration/focused.mjs · Bundled script · 59 lines · 1 finding marked
- // Human-readable calibration hypotheses, not deterministic semantic test doubles.
- import { diagnosisSamples } from './diagnosis.mjs'
- // Keep counterexamples to the retired S5-S9 keyword graders in the live corpus.
- const paraphrases = {
- 'S5-negative-naming': '我只读检查了package.json和dsh-plugin.naming.json。清单中的pluginNames greet是题目基线认可的官方短名,包名dsh-greet和坐标acme/greet是另外两个表面,不能把缺少前缀当成兼容错误。services search是裸服务名,存在碰撞风险,应给建议而非API错误。events web-search/ready是共享事件通道,同名本身不是冲突,要看发布者schema是否相容和已有注册信息。其余loaderIds acme-greet、tools acme_greet_hi、commands acme-greet-hi、skills greet、skillProviders acme-greet-filesystem、settingsNamespaces acme-greet及路由/api/plugins/acme-greet/hi在本地没有足以认定兼容错误的证据;带作用域的名称可以减少碰撞,但这些表面的全局占用都需要注册表上下文,裸技能名也应核查。我没有查询注册表,所有保留或可用状态都是未检查,后续应逐项核验并比较事件schema、路由重叠。不能说已保留、全局可用或全部通过。private:true只是测试材料标记,不是命名错误。',
- 'S6-corridor-net-state': 'src/events.ts的produceExternalEvent里,delete (event as any).ignorable和“迁移到alpha.2继续保留”的注释应一起修正。alpha.1曾移除该标记,alpha.2又恢复持久化和重载时的保留,因此目标净状态要求撤掉剥离标记的防御,而不是撤掉标记。当前对象字面量没有这个字段,delete在这个简化片段上其实没有作用,也不能据此赞同注释。third-party/informational只有在老读者忽略其语义仍能正确重建时才可标ignorable:true;必要事件不能这样放行。标记不是读端过滤规则,带标记的事件重载后仍在日志中。公开live Session.append没有支持这个标记的参数,普通插件仅持有此API时应报告能力缺口,不能靠any强转或虚构参数冒充公开入口。具体持久化接入点仍待核对,不声称已运行验证;可计划检查标记事件保留、未知必要事件拒绝。',
- 'S7-unpublished-cohort': 'package.json中的@deepseek-ai/dsh-llm声明是^0.1.2-alpha.1;README给定的发布清单没有alpha.1而有alpha.2,我未做线上查询。以后核验应查该具体包,根包或dist-tag不能代表每个内部包。这里caret是范围,已发布alpha.2满足它,因此安装能成功,但拿到的是alpha.2类型,不是alpha.1基线,预发布API兼容性没有随安装成功得到证明。选择一条方案:明确将目标改为已发布0.1.2-alpha.2,依赖精确钉住该版并核对实际SDK类型依赖。这不能声称验证过alpha.1。后续沿用项目的一种包管理器,提交锁文件并使用冻结安装;若项目使用npm则用npm ci,然后对目标cohort运行tsc --noEmit及适用的运行验证。本次都未执行。这条路线没有临时overrides,未来升级通过明确改pin和lock并重跑验证完成;若必须停在alpha.1则另行核验源码构建和本地包方案,不建议向npm安装不存在的精确版本。',
- 'S8-release-routing-trap': 'ls-remote-tags.txt缺少v0.9.5,sync-script.sh只向origin、public、mirror2推HEAD:main,没有推标签,所以第一次解析失败属于发布分发缺陷,不能归咎用户网络或拼写。dsh-version.txt显示0.1.1-rc.2,而compat-table.md中v0.9.7针对0.1.2-alpha.1;新版插件要求旧宿主没有的useConversation接口,安装和重启都不能补上契约。生产冻结下应选择表中在rc.1验证过、根据rc.2增量说明可用的v0.9.3。不过镜像清单同样没有v0.9.3,维护者须先git push public v0.9.3并确认可解析,消费者再执行dsh plugin --profile web add \'@org/dsh-ui-progress@github:public-org/dsh-ui-progress#v0.9.3\'。不能捏造一个SHA充作立即解法。发布脚本应向每个镜像非强制推送发布标签(明确tag或--tags),并复核文档中的tag可解析。README按dsh --version分支:rc.2选v0.9.3、已验证alpha.1选v0.9.7,放兼容表和对应命令,不让一个latest命令服务所有版本。以上是建议,未执行发布或安装。',
- 'S9-composer-coordinate-trap': 'host-input-contract.ts规定draft及occurrence的位置和长度按剪贴板展开文本计算,而host-input-facade.ts的insertReference、consumeToken按detect投影切片,附件在后者只占一个U+FFFC,普通文字和空格仍照常计宽。plugin-client.js的add直接使用snapshot.draft.length。首次空输入两种位置都为零,插入成功;有附件后剪贴板长度超过detect长度,第二次插入越界返回false,于是插件报“composer changed”。console-session.txt符合这个过程,不代表真的发生并发修改。remove又把occurrence.offset到offset+length直接传给consumeToken,拒绝结果没检查,records.delete却执行了;occurrence仍在,composer和dock的chip都在,但record没了,dock才显示unavailable。转换规则是目标剪贴板位置减去前面每个附件的length-1:插到末尾计入全部已有附件;删除先转换offset,结束点取转换后起点加一。保留当前draftRev检查,consumeToken成功才删记录;失败保留记录,兼容setDraft分支用剪贴板坐标并确认成功。回归先粘A再粘B,断言两次成功且两处都显示两个chip;再删位于A之后的B,断言仅B的occurrence、dock和record一起消失且A不动。拒绝删除时记录及chip应保留,可再测首尾及删空重贴。本次未执行测试;第5项源代码阅读习惯不计分。',
- }
- const probes = {
- 'H4-tsbuildinfo-trap': [
- ['correct-negation', 'Do not follow the colleague: rewriting source is wrong. Cleaning lib is allowed, but the static fixture does not prove an executed successful build.', [90, 100]],
- ['contradiction', 'Final correction: the source must be rewritten according to A1-21 even though it has no reference. Do not clean the artifacts.', [0, 30]],
- ],
- 'H6-remote-error-trap': [
- ['correct-negation', '禁止保留旧错误码。不要用instanceof RemoteError判断跨realm失败。取消不应被重试,catch不能吞装配错误。', [90, 100]],
- ['contradiction', '最终建议:保留旧错误码cancelled和internal,继续静默吞错,用instanceof RemoteError作为跨realm判断。', [0, 25]],
- ],
- 'H12-remote-result-boundary-trap': [
- ['correct-negation', 'Never treat ordinary failures as rejected promises. The colleague advice to handle all failures in catch is wrong; do not retry assembly faults.', [90, 100]],
- ['contradiction', 'Final correction: ordinary remote failures always reject and must be handled in catch; use result.value without checking success.', [0, 30]],
- ],
- 'S5-negative-naming': [
- ['correct-negation', 'greet不是error。不能因此断言全局可用。不得断言“已保留/全局可用”。“全部通过”是错误的。', [90, 100]],
- ['contradiction', '不能说全部通过,但是我的最终判断是全部通过,没有问题,所有名字已保留且全局可用,可以直接发布。', [0, 30]],
- ],
- 'S6-corridor-net-state': [
- ['correct-negation', '不要保留防御,也不要继续删除marker。“保留防御代码”是错误的。', [90, 100]],
- ['contradiction', '不要保留防御。更正最终建议:必须保留防御代码,仍应删除marker。', [0, 10]],
- ],
- 'S7-unpublished-cohort': [
- ['correct-negation', '错误示例(不要执行):\n```sh\nnpm install @deepseek-ai/dsh-llm@0.1.2-alpha.1\n```\n禁止向npm安装这个不存在的精确版本。', [90, 100]],
- ['contradiction', 'Do not run the unavailable exact install. Correction: run npm install @deepseek-ai/dsh-llm@0.1.2-alpha.1 from the public npm registry now; it is published there.', [0, 10]],
- ],
- 'S8-release-routing-trap': [
- ['correct-negation', 'Do not blame the network. Do not upgrade the frozen runtime. An immediate v0.9.3 tag install before distribution is wrong advice.', [90, 100]],
- ['contradiction', 'Final correction: v0.9.3 is already on the public mirror, so run its install command immediately. Ignore any earlier instruction to publish that tag first.', [0, 90]],
- Note: Quoted as data in code: Tells the agent to set aside its instructions or safety, or to reveal its system prompt: "ignore any earlier instruction"
- Line 39 on GitHub
- ],
- 'S9-composer-coordinate-trap': [
- ['correct-negation', 'Do not bypass draftRev and never delete the record after a failed consumeToken. Keeping clipboard offsets unchanged would be incorrect.', [90, 100]],
- ['contradiction', 'Final correction: do not convert either span; use clipboard offsets unchanged and delete the record even when consumeToken returns false.', [0, 80]],
- ],
- }
- export function focusedSamples(task, complete) {
- if (!probes[task]) return diagnosisSamples(task, complete)
- const equivalentCode = task === 'H12-remote-result-boundary-trap' ? [{
- id: 'equivalent-success-first',
- report: complete.replace(/```ts[\s\S]*?```/, '```ts\nconst response = await ctx.remote.session.rename({ sessionId, title })\nif (response.ok) return response.value\nhandleRemoteFailure(response.error)\nreturn\n```'),
- expected: [90, 100],
- }] : []
- return [
- ...equivalentCode,
- ...(paraphrases[task] ? [{ id: 'paraphrase-zh', report: paraphrases[task], expected: [90, 100] }] : []),
- ...probes[task].map(([id, suffix, expected]) => ({ id, report: complete + '\n\n' + suffix, expected })),
- ]
- }
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.