dsh-bash-rtk

在 DeepSeek Harness（dsh）的 bash 执行器里，把符合条件的 shell 命令路由给 rtk（Rust Token Killer）执行 —— 压缩工具输出、省 token、其余一概不变。

English version

---

为什么需要它

LLM agent 在冗长的工具输出上浪费大量 token（git log、cargo build、pytest 输出……）。rtk 已知道如何把这些输出压缩 30–90%。本插件把这套过滤接到 dsh 的 bash 执行器上，让每个符合条件的命令自动走 rtk —— 且对实际运行内容零语义改动。

工作原理

model → dsh bash 工具 → RtkBashExecutor.resolve()
                              │
              ┌───────────────┴────────────────┐
         符合条件？                        不符合条件
   （简单命令 + 在白名单内）          （复杂 / 未知命令）
              │                                │
      rtk  …                  命令原样执行
   （rtk 压缩输出）              （逐字节透传）

三道独立关卡决定路由（见 src/wrap.ts）：

1. 复杂度 — 任何 shell 元字符（| & ; \ $`）都会取消资格。包装这些会改变实际运行内容，故直接透传。
2. 白名单 — 仅 rtk 实际实现的已知开发工具才符合资格（wrap.ts 中的映射表）。
3. 可用性 — 若 PATH 上找不到 rtk 二进制，变换退化为恒等：部署行为与原始本地执行器完全一致。

版本说明

本插件不捆绑、不锁定 rtk 版本。dsh 启动时会探测 PATH 上的 rtk --version（见 src/index.ts 的 resolveRtk()）。因此：

• rtk 发布新版本时，任何在本地升级了 rtk 的用户会自动获得新行为 —— 无需更新本插件。
• 本插件版本（本仓库）与 rtk 版本相互独立，请勿混为一谈。本说明给出的是测试所基于的最低 rtk 版本，而非锁步版本号。

要求： rtk 在 PATH 上（rtk --version 退出码为 0）。插件不会安装或管理 rtk —— 你必须自行安装并更新 rtk（例如 或下载发布二进制）。当 rtk 缺失时，插件静默退化为透传。