Plugin Fast Adapt — Development skill for Claude Code

plugin-fast-adapt

**简体中文** | [English](README.en.md)

[](https://github.com/taxueseek/plugin-fast-adapt/actions/workflows/ci.yml) [](LICENSE) [](package.json) [](#依赖与自检) [](#依赖与自检)

**DSH 每次发新版，老插件就可能启动不了。** 这个技能直连 DeepSeek 官方升级指南，扫你的插件代码，报出踩了哪几条破坏性变更、官方给的修法是什么；还能一条命令从零造出可运行的插件。

速览

上游发新版	无需任何改动，直接可用（直连官方源，不维护知识卡片）
扫描误报	12 处 → 0（四层降噪）
验证一次改动	3600 秒真宿主冷启动 → 毫秒级内存冒烟
自检	140 项断言，离线可跑
外部依赖	0（只用 Node 内置模块 + git/npm 命令）
网络	只取官方源时用，核心步骤全离线
造插件	一条命令出五形态可运行插件，生成即验证

它解决什么

DSH（DeepSeek Harness）是一个「所有功能都以插件形式存在」的 AI 运行框架，麻烦在于每次发新版，老插件就可能启动不了。常见的应对是手写升级卡片：每个版本区间写几十张卡，记清什么坏了、怎么修。这条路有三个绕不过去的问题：

1. 卡片写完就过时。上游一次跃迁能改动数千个文件，卡片之间还有覆盖不到的「走廊缺口」。
2. 大知识库挤占推理空间。论文实测，弱模型（qwen3.8-27b）带全套卡片库答题，56 题等权差 -3.07 pp（7 题改善、18 题退化、31 题持平）。
3. 验证太贵。改一次验一次要等真宿主冷启动，实测有过 3600 秒超时；宿主升级后 profiles 覆盖层残留旧包，还会导致插件装载冲突。

本项目的取舍是：**不维护知识，只维护取知识的方法。** 破坏性变更的权威描述在 DeepSeek 官方仓库的 `docs/upgrade-guide/<版本>/<主题>/guide.md`，官方发版时同步更新，格式固定（`## Change` 讲什么变了，`## Migration` 讲怎么改）；版本信息在 npm registry 的 `dist-tags`。两处都是官方源，所以上游发新版的那一刻，这个技能就自动跟上了。

优势

• 自动跟上新版：直连官方 docs/upgrade-guide/ 与 npm dist-tags，上游发版即生效，没有卡片滞后也没有走廊缺口
• 误报清零：四层降噪把真实插件的命中从 12 处误报降到 0，每条命中带 severity、evidence 和直达官方指南的出处锚点
• 验证便宜：内存级 Cordis 冒烟毫秒到秒级出结果，不用真宿主冷启动；需要真证据时 --real-smoke 再补干净 profile 真装真启档
• 零外部依赖：只用 Node 内置模块加 git/npm 命令，没有 TypeScript、没有 AST 库、没有网络请求库
• 网络依赖很轻：只有「取官方源」走网络——定版本读 npm 的 dist-tags、取指南 clone 官方仓库。dist-tags 缓存 1 小时，失败降级旧缓存并明确标 stale；指南优先复用本机已有 clone，--no-clone 可跳过。环境巡检、代码扫描、冒烟、体检、日志诊断、接缝查询全离线
• 可复现：140 项自检离线可跑；CI 在 push 和 PR 上自动跑
• 不止适配：scaffold.mjs 一条命令生成五形态可运行插件（真基类装载验证）