Skip to content

v0.1.1:介绍价值先行、补 npm 与 marketplace 分发面

Choose a tag to compare

@taxueseek taxueseek released this 26 Oct 12:15
· 46 commits to main since this release

相对 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/ + npm dist-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)