dsh-caveman

让 DSH 里的 agent 少说废话、多留事实。 这是 JuliusBrussee/caveman 的 DeepSeek Harness 非官方移植：14 个原生 DSH 技能，输入 /caveman 就能用。

上游那句话是 "why many token when few do trick"：同一句修复，普通 agent 写 63 token，caveman 写 20 token，代码、命令、路径、报错字符一个不改。

许可证：Apache-2.0。 上游 3.0.0 起统一采用 Apache-2.0（根目录 LICENSE-MIT 仅用于保留 3.0.0 之前 MIT 部分的历史贡献声明）。改造与分发需随包带 LICENSE、保留 NOTICE、声明修改——本包逐条做到了，见 NOTICE 与下文「Apache-2.0 要求与逐条落实」。

非官方移植。 "Caveman" 是 Julius Brussee 的商标，本包与上游作者无隶属或背书关系，仅以指称方式（nominative use）说明移植来源。

---

装了什么（14 个技能，三组）

1. 语气组（output，8 个）

技能	触发	做什么
caveman	/caveman	主语气：先给答案，去掉客套与总结，技术事实全留
ultracave	/ultracave · /caveman ultra	极限压缩：片段化、能一个词就一个词（仅用户可调用）
megacave	/megacave · /caveman wenyan	文言文语气，字数更少，术语原样（仅用户可调用）
caveman-commit	/caveman-commit	Conventional Commits：祈使句、≤50 字符、不写 AI 署名
caveman-review	/caveman-review	一行一条评审：L42: bug: user 可能为 null。加 guard。
caveman-help	/caveman-help	命令速查卡
caveman-stats	/caveman-stats	诚实报用量：指向宿主用量视图，明说省了多少没测过
caveman-compress	/caveman-compress <路径>	把 AGENTS.md / CLAUDE.md / todo 压成 caveman 体，省输入 token

2. 压缩组的安全设计（caveman-compress 是改造过的）

上游用 Python CLI 把文件发给外部模型端点。DSH 里有模型在跑，所以本移植去掉了外发：

• 不外发：当前会话的模型就地压缩，不调 claude CLI、不调 API、不读 key；
• 备份在源目录之外：.caveman/backups/<相对路径>.original.md——AGENTS.md.original.md 放在旁边会被 agent 当成活指令再读一遍；
• 覆盖前过闸：skills/caveman-compress/scripts/verify-compress.mjs 校验代码块/行内代码逐字未变、标题未丢、URL/环境变量/否定词未丢、文件确实变小，任一条不过就还原；
• 先拒绝：.env、credentials*、*.key、*.pem、id_rsa* 等敏感文件名读都不读直接拒绝；只压 .md/.txt/.typ/.typst/.tex 和数字后缀文本，不碰代码文件；
• 只报字节，不报节省：字节不是 token，宿主没有对照测量。

3. native 工作流纪律组（6 个，仅提示词）

技能	用在什么时候
investigate-first	原因不明的故障：先证据后结论，没找到机制不改代码
lean-build	容易过度设计的新功能：先复用、守住范围、写明停止条件
migration	schema/数据/API/协议/配置/依赖迁移：先映射读写方与兼容窗口，证明可回滚
safe-refactor	重构但要行为不变：用验证夹住结构改动
surgical-patch	小 bug 修在最窄的负责层，带回归证明
verify-and-stop	只验证不扩范围：跑门禁、给证据、停

这 6 个共享上游 native-core.md（构建最简完整系统的那段默认），插件在加载时把它追加到每个技能正文后面。

和上游的差异（诚实降级，不假装）

上游有	DSH 没有	本插件的处理
hook 写标志文件实现跨轮模式持久	无 hooks	模式只在会话内保持；模型不读写任何 mode 文件
statusline / Caveman mode: 注入	无 statusline	status 回答带 (not tracked by this host)
任务分类器决定 native 技能何时生效	无分类器	注册为模型可调用技能，按 description 匹配，偏离时说明
transcript 计数算节省	无该数据	明说 savings unknown，不编数字
CLI/proxy/engine/MCP（省输入 token）	未移植	见下

没移植（依赖上游 Go 运行时或 subagent preset）：cavecrew（要 cavecrew-* 三个 preset）、caveman-discover/explore/learn/manage/optimize/setup/evidence-review（要 Caveman CLI 与本地实验数据）、以及 CLI/proxy/engine/MCP/shrink。

安装（从 GitHub 装，不需要 npm）

dsh-caveman 这个名字在 npm 上已被另一个作者的同名插件占用，因此本包不发布 npm，GitHub 就是分发渠道。DSH 的插件安装本来就接受 file: / git / URL 三种 spec，下面三种方式任选。

方式 A：一行脚本（推荐）

curl -fsSL -o /tmp/dsh-caveman-install.sh \
  https://raw.githubusercontent.com/stevenwang15/dsh-caveman/main/scripts/install-from-github.sh
bash /tmp/dsh-caveman-install.sh desktop     # 默认 profile 是 desktop

脚本会：下载对应 release 的 tgz → 备份 profile 的 package.json/cordis.patch.yml/pnpm-lock.yaml → pnpm add file:<tgz> → 把 dsh-caveman 加进 dsh.profile.bundles → 触发一次配置变更让运行中的 DSH 重载。指定版本：bash /tmp/dsh-caveman-install.sh desktop 0.2.2。

方式 B：直接从 git 仓库装

PROFILE=~/.dsh/profiles/desktop
NODE=~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node
PNPM=~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm/bin/pnpm.mjs

cd "$PROFILE"
"$NODE" "$PNPM" add "github:stevenwang15/dsh-caveman" --config.confirmModulesPurge=false
# 再把 "dsh-caveman" 加进 package.json 的 dsh.profile.bundles

DSH 的 pnpm 会从 GitHub 拉源码（本机实测约 3 分钟，无需 token），装出来的内容和 release 一致。缺点是每次更新要重跑一次 pnpm add。

方式 C：克隆仓库后本地装

git clone --depth 1 https://github.com/stevenwang15/dsh-caveman.git /tmp/dsh-caveman
/tmp/dsh-caveman/scripts/install-local.sh desktop

install-local.sh 没有现成 tgz 时会自己 npm pack（npm 缓存不可写时自动换到临时目录），然后走同一套备份 → pnpm add → 加 bundle → 触发热重载的流程。

卸载

# 方式 A 装的最省事：
./scripts/uninstall-local.sh desktop

装完不用重启：DSH 的 HMR 会在 profile 配置变化时重排组合并重新加载 bundle。实测发现只改 package.json 的 bundle 列表不会重载模块（宿主仍持有旧实例），改 cordis.patch.yml 才会——安装脚本和 scripts/dev-reload.sh 都会刷新一行可删除的标记注释来触发。卸载脚本会恢复安装时备份的三个文件，并移除 node_modules/dsh-caveman。

验证（已完成，可复跑）

npm test        # 三组一起跑

测试	断言什么	结果
test/smoke.mjs	14 个技能注册、描述 ≤500 字符、resourceBase 真实目录、归因在正文、native-core 只进 native 组、compress 闸门与备份路径、不承诺宿主没有的能力	155/155
test/dsh-contract.mjs	从已安装 App 的 app.asar 里取出 dsh-skill 的真实 validateRuntimeSkill/validateDefinition 源码并执行，验证每个定义能过当前版本的加载期校验	30/30
test/compress-gate.mjs	安全压缩放行；改代码块/丢标题/丢 URL/丢否定词/丢环境变量/没变小，全部拒绝	9/9

真机验证：装进 desktop profile 后，当前会话的技能目录直接多出 caveman/caveman-commit/caveman-help/caveman-review/caveman-stats 等（ultracave/megacave 按 modelInvocable:false 对模型隐藏，只在用户输入时出现），skill("caveman") 返回的正文与 resourceBase 指向安装目录——说明注册、注入、资源基地址三条链路都通。

Apache-2.0 要求与逐条落实

Apache-2.0 的关键义务，逐条对应到本包：

条款	要求	本包做法
§4(a)	随分发给接收方一份 License	LICENSE = Apache-2.0 全文
§4(b)	修改过的文件要显著声明改动	NOTICE 的 "State changes" 逐条列出；caveman-compress/SKILL.md 头部注释标明 ADAPTED；index.js 头部说明是新增文件与追加说明
§4(c)	保留源作品的版权/专利/商标/归属声明	每个技能的正文末尾带 Ported from JuliusBrussee/caveman (Apache-2.0)，NOTICE 含上游版权行
§4(d)	源作品有 NOTICE 时，须附上与被衍生作品相关的归属声明	上游 NOTICE 逐字收录在 NOTICE 的 "Upstream NOTICE" 段，本包的声明追加在其后
§6	不授予商标权	NOTICE 与 README 明确写商标归属与非官方关系，名称仅作指称
§3/§5	专利授权与贡献条款自动生效	无需额外动作
无二进制	上游 Go 运行时的第三方许可文本义务	本包只分发技能文本，不分发任何 Go 二进制，故不适用；NOTICE 中已说明

一句话：可以用、可以改、可以发，但不能不带 LICENSE/NOTICE、不能把改动说成上游原样、不能暗示官方。本包这三点都守住了。

目录

dsh-caveman/
├── index.js                     # 注册 14 个技能 + 按组追加 DSH runtime 说明（新增文件）
├── cordis.patch.yml             # bundle layer
├── skills/
│   ├── <name>/SKILL.md          # 上游正文逐字复制（Apache-2.0）
│   ├── caveman-compress/SKILL.md          # 唯一改造文件（头部已标明 ADAPTED）
│   ├── caveman-compress/scripts/verify-compress.mjs  # 压缩闸门
│   └── native-core.md           # 上游 native 组共享默认（逐字）
├── scripts/install-from-github.sh  # 从 GitHub release 直装（含热重载）
├── scripts/install-local.sh / uninstall-local.sh
├── test/smoke.mjs · dsh-contract.mjs · compress-gate.mjs
├── LICENSE  # Apache-2.0 全文
├── NOTICE   # 上游 NOTICE 逐字 + 本移植的修改与商标声明
└── package.json  # 固定上游 version/commit，便于重新同步

同步上游：把 skills/<name>/SKILL.md 与 skills/native-core.md 用上游同路径文件覆盖；caveman-compress 例外（改造过，需人工合并）。index.js 不用改，DSH 说明自动追加。上游 commit 记在 package.json 的 caveman.upstreamCommit。