dsh-caveman

dsh-caveman

让 DSH 里的 agent 少说废话、多留事实。 这是 [JuliusBrussee/caveman](https://github.com/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](NOTICE) 与下文「Apache-2.0 要求与逐条落实」。

>

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

一行安装

dsh plugin --profile desktop add github:stevenwang15/dsh-caveman

需要 Node 22+。完整装法、参数与卸载见下文。

---

装了什么（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: → 把 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