plugin-fast-adapt

plugin-fast-adapt

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

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

> DSH 每次发新版，老插件就可能启动不了。 这个技能直连 DeepSeek 官方升级指南，扫你的插件代码，报出踩了哪几条破坏性变更、官方给的修法是什么；还能一条命令从零造出可运行的插件。已适配到 0.2.2-rc.1：该版官方还没写指南条目，官方 Release Note 被当作虚拟指南一并纳入，因此覆盖度仍判 complete=true；再新的版本如果既无指南也无发布说明，账本会明说「不能当查干净」。支持本地环境权威锚定、Release Note 破坏性变更提取与整机集群多维批量治理。

速览

| | |

| --- | --- |

| 上游发新版 | 无需任何改动，直接可用（直连官方源与 Release Notes，不维护滞后卡片） |

| DSH 宿主适配 | 覆盖 v0.1.7-rc.2 至 0.2.2-rc.1（该版无官方指南条目，由官方 Release Note 转成虚拟指南补上）；再新的版本若无任何官方来源，覆盖度账本会明说「不能当查干净」 |

| 集群治理看板 | 一键扫描整机 Web / APP 插件与工作区，按运行态生命周期多维矩阵呈现 |

| 定版权威 | 默认收敛到本机真实宿主版本（方案 B 零网络请求，防上游频控） |

| 扫描误报 | 12 处 → 0（四层降噪 + 常量词边界正则 + 虚拟指南去重） |

| 验证一次改动 | 3600 秒真宿主冷启动 → 毫秒级内存冒烟（支持未构建产物硬拦截与宿主模块软链兜底） |

| 幽灵宿主 | 磁盘已换新、进程还在跑旧代码时报警（比进程启动时间，不读版本号） |

| 假绿检测 | tsconfig 的 paths 指向不存在的 checkout 时报警（本地门禁可能全绿而实际已坏） |

| 自检 | 263 项断言，离线可跑 |

| 外部依赖 | 0（只用 Node 内置模块 + git/npm 命令） |

| 跨平台 | 原生支持 macOS、Linux 标准路径、Termux 移动端与容器环境（支持 XDG 规范） |

| 造插件 | 一条命令出五形态可运行插件，生成即验证 |

它解决什么

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。两处都是官方源，所以上游发新版的那一刻，这个技能就自动跟上了。

优势

• 适配到 0.2.2-rc.1：直连官方 docs/upgrade-guide/ 与 Release Notes。官方指南只写到 0.2.2-alpha.3，0.2.2-rc.1 由 Release Note 转成虚拟指南补上（该 Release Note 两万七千余字，含完整破坏性变更段），所以覆盖度仍判全覆盖；支持虚拟指南自动生成与三元版本账本快速探测
• 本地环境权威锚定（零网络依赖）：默认定版本严格收敛到本机已安装的 DSH 宿主版本（方案 B，零外部网络请求），免除官方源网络波动与 GitHub 频控影响；显式 --check-upstream 才核对上游
• 集群全域多维治理看板：新增 fleet-sweep.mjs，一键扫描整机 Web 插件、APP 桌面端插件、工作区源码与运行中服务，输出五大生命周期矩阵看板，支持 --apply-compat 批量安全修补
• 误报与低级错误硬守卫：
• 四层降噪 + 常量词边界正则匹配（避免 ABORTED 误伤 FS_ABORTED）
• 虚拟 Release 指南与官方真实指南自动去重
• 未构建 TypeScript 插件硬拦截（未见 lib/index.js 等入口即阻断并指引 pnpm run build）
• 宿主同名内置包遮蔽（Bundle Resolution Shadow）检测，防官方同名包静默覆盖
• 宿主冷启动退出码 143（SIGTERM）优雅停机正常判定，杜绝假死误报
• 冒烟自动解析 Schemastery Config({}) 填充默认值，未安装 node_modules 的单文件插件自动挂载宿主依赖兜底
• 跨平台与容器自适应：消除绝对路径硬编码，扩展适配 Linux 发行版标准路径（/usr/lib/node_modules）、Termux 移动端（$PREFIX/lib/node_modules）与 npm_config_prefix，支持环境变量 DSH_HOST_PATH / DSH_LOCATION 直接覆盖，严格遵循 XDG 缓存规范
• 验证便宜：内存级 Cordis 冒烟毫秒到秒级出结果，不用真宿主冷启动；需要真证据时 --real-smoke 再补干净 profile 真装真启档
• 零外部依赖：只用 Node 内置模块加 git/npm 命令，没有 TypeScript、没有 AST 库、没有网络请求库
• 可复现：263 项自检离线可跑；CI 在 push 和 PR 上跑 ubuntu/macOS/Windows 三平台，打 tag 时另跑发布预检
• 不止适配：scaffold.mjs 一条命令生成五形态可运行插件（真基类装载验证），write-gate.mjs 写完出「出生证」
• 静默失败有判据：ghostHost 比对进程启动时间与磁盘变更时间，抓「磁盘新版、内存旧版」；falseGreen 抓 tsconfig 的 paths 指向不存在 checkout 时 TypeScript 的静默回落。两条都只报不判，证据写在输出里
• 边界诚实：冒烟通过不等于宿主兼容，这句话写在工具输出里；体检的软指标只透传，不替用户说「合格」

四条车道

主入口只做路由，四条车道各管一件事，按意图读对应文档，不一次把四份都读进来：

SKILL.md                      主技能：判断走哪条 + 一键编排 + 跨车道纪律
sub-skills/adapt/SKILL.md     升级适配：定版本 → 取指南 → 扫命中 → 接缝 → 秒验 → 体检
sub-skills/build/SKILL.md     造插件：scaffold 五形态 + write-gate 体检门
sub-skills/diagnose/SKILL.md  环境与启动故障：env-doctor + log-doctor + env-heal
sub-skills/review/SKILL.md    代码审查与架构审核：P0/P1/P2/P3 分级 + 子 Agent 隔离委派
scripts/                      四条车道共用的工具箱，不随车道分家
references/                   降噪规则、迁移 SOP、CI 模板

build、diagnose 与 review 还各有一个顶层别名，可以让它们独立响应触发词（不建也能用，主技能会按意图读对应车道文档）：

ln -s /sub-skills/build    ~/.agents/skills/dsh-plugin-build
ln -s /sub-skills/diagnose ~/.agents/skills/dsh-plugin-diagnose
ln -s /sub-skills/review   ~/.agents/skills/dsh-plugin-review

别名的作用是让「造插件」「装了没生效」和「代码审查」这几类独立目标有自己的触发面，不必挤在主技能一个 description 里。宿主加载器对 description 有 1024 字符硬上限，超了整条技能会被丢弃而不是截断——这条现在由自检门禁守住。

安装

用 skills CLI（推荐，一条命令装到它支持的 agent）：

npx skills add taxueseek/plugin-fast-adapt

Claude Code marketplace：

/plugin marketplace add taxueseek/plugin-fast-adapt
/plugin install plugin-fast-adapt

npm（带 plugin-fast-adapt 命令，转发到一键编排）：

npx plugin-fast-adapt <插件目录>

手动安装：