Repository navigation
v0.1.1:介绍价值先行、补 npm 与 marketplace 分发面
相对 v0.1.0 的改进。这一版补的是「可信度」和「分发面」:介绍从「辩护书」改成「价值书」,上游溯源挪到尾部;补上 npm 和 Claude Code marketplace 两条安装路径;补 2026-10-26 定位到的三处 env-doctor 盲区。改动全部来自本机实测。
相对上一版的改进
- 介绍重写:开头价值先行 + 优势清单 + 四条安装路径,冷访客 30 秒能判断;「出身」「为什么重新做一个」「与原项目对照」整体下移到尾部「上游溯源与分工」,对上游的语气从「批评」改成「分工」
- env-doctor 三处盲区:共享 node_modules 农场的悬空软链、全局 patch 层(
~/.dsh/cordis.patch.yml对所有 profile 生效)、入口写在exports的包不再被误报「无 main 入口」 - 断言数守卫:文档宣称的断言数必须与实际一致,防手工漂移(这次重写就靠它拦住了一处徽章 URL 的误读)
新增能力
- 真冷启动档:
run.mjs --real-smoke桥接原仓库 verify-runtime,干净 profile 真装真启,四类归因;脚本不在本机时诚实跳过并给补法 - 接缝查询:
seams.mjs给一个包名/API 符号在官方指南与本机宿主里的双源结论,双源一致才下「已移除」 - 指南出处锚点:命中带
guideFile/guideLine,直达官方指南原文位置 - 运行日志交叉核对:
run-log.mjs doctor把运行日志与宿主启动日志交叉核对,插件报错先跑它 - 上游盯梢:
guide-sync.mjs --check返回 1=有新版(顺手预取指南)、0=无需动作,可直接接 cron 或 agent 轮询 - 同步后给提交命令建议:只 add 同步路径,防夹带
- CI:push 和 PR 自动跑
npm test - pre-commit 钩子:commit 时自动跑自检,改完真源忘了 sync-skill 在这一刻被拦
默认关闭功能的打开方式
- 真冷启动档默认关闭(要真宿主证据才开):
node scripts/run.mjs <插件目录> --real-smoke - 上游盯梢默认不跑(要轮询才调):
node scripts/guide-sync.mjs --check - 覆盖层自愈默认 dry-run(真动手才加
--apply):node scripts/env-heal.mjs --apply - 类型剥离默认关闭(只有 Node 22.13+ 才需要)
相关依赖
- 零外部依赖:只用 Node 内置模块(
node:fs、node:path、node:os、node:child_process)加git和npm命令 - Node 22.13+(
import.meta.dirname需 20.11+,可选的类型剥离需 22.13+,默认关闭) - 差异来源:DeepSeek 官方
docs/upgrade-guide/+ npmdist-tags,随上游自动更新 - 自检 129 项,零网络,任何机器能跑
分发面
- skills CLI(推荐):
npx skills add taxueseek/plugin-fast-adapt - Claude Code marketplace:
/plugin marketplace add taxueseek/plugin-fast-adapt - npm:
npx plugin-fast-adapt <插件目录>(已发布plugin-fast-adapt@0.1.1) - awesome-claude-skills:PR 已提交,待维护者合入
实测数据
- 自检 129 项全绿,零网络
- 扫描器对触点密集大文件保持线性(性能回归门)
- 全链编排 226ms 级(子进程开销:env-doctor ~70ms / code-scan ~47ms / quick-smoke ~44ms)