rtk 命令改写桥 b1inkie/dsh-rtk-bridge

dsh-rtk-bridge

把 rtk 接进 DeepSeek Harness。模型调用 pwsh / bash 时，插件先用 rtk rewrite 查找等价命令；命中就用改写后的命令执行，让 rtk 的压缩输出直接进入上下文。

git status → rtk git status → * master
M a.txt

功能

- 自动改写并执行：包装 shell 工具的 execute，直接运行 rtk ...，不需要模型重试。
- 支持 pwsh / bash：Windows 走 pwsh，Linux / macOS 走 bash。
- 失败放行：rtk 缺失、版本过旧、无等价命令、超时、改写结果不安全时，执行原命令。
- Windows 安全名单：不会把 ls / grep / find 等改写成 Windows 上不可用的 rtk 子命令。
- 防重复前缀：rtk ...、rtk.exe ... 以及带环境变量前缀的 rtk 命令原样执行。
- 清理噪音：移除 rtk 输出里的 [rtk] No hook installed 等提示。
- 兜底：工具定义不可写时自动切到 tools/execute 短路，继续改写。
- 状态命令：/rtk 查看 rtk 路径、版本、计数、沙箱状态，并可运行时开关。

要求

- DeepSeek Harness（已在 0.1.5-rc.1 验证）
- rtk >= 0.23.0
- Node >= 22.19

rtk 安装：<https://www.rtk-ai.app/docs/getting-started/installation/>

不想手动装：装完插件后在 DSH 里执行：

/rtk install

它会从官方 GitHub Release 下载当前平台的 rtk，校验 checksums.txt 里的 SHA256，解压到 ~/.dsh/rtk-bridge/bin，不需要自己找二进制或改 PATH。

插件查找顺序：

1. rtkPath 配置
2. DSH_RTK_BIN / RTK_BIN
3. /rtk install 安装的 ~/.dsh/rtk-bridge/bin/rtk[.exe]
4. PATH 上的 rtk / rtk.exe
5. ~/.local/bin、~/.cargo/bin、%LOCALAPPDATA%\Programs\rtk、WinGet Links

安装

插件市场（桌面端）

「设置 → 插件市场 → 自定义安装 → GitHub」：

https://github.com/b1inkie/dsh-rtk-bridge

命令行

dsh plugin --profile web add -w "github:b1inkie/dsh-rtk-bridge#<commit-sha>"

本地开发

dev.patch.yml
- insert:
- id: rtk-bridge-dev
name: 'D:/path/to/dsh-rtk-bridge/lib/index.js'
config:
debug: true

dsh --profile web --patch D:/path/to/dev.patch.yml

配置

在 profile 的 cordis.patch.yml 中覆盖：

- id: rtk-bridge
config:
enabled: true
mode: rewrite # rewrite | suggest
intercept: auto # auto | patch | dispatch
tools: [pwsh, bash]
rtkPath: ''
installVersion: latest # 或固定 X.Y.Z downloadBase: https://github.com/rtk-ai/rtk/releases timeoutMs: 2000
excludedSubcommands: []
rewriteWhenConfined: false
debug: false

| 字段 | 默认 | 说明 |
| enabled | true | 总开关 |
| mode | rewrite | rewrite 执行改写命令；suggest 改为 deny 并提示改写命令 |
| intercept | auto | auto 包装 execute，失败时切 dispatch；patch 只包装；dispatch 只走 tools/execute 短路 |
| tools | [pwsh, bash] | 要拦截的 shell 工具 |
| rtkPath | '' | 显式指定 rtk 可执行文件 |
| installVersion | latest | /rtk install 下载的版本，可填 X.Y.Z |
| downloadBase | 官方 releases | 下载源，GitHub 不可达时可换镜像 |
| timeoutMs | 2000 | rtk rewrite 超时 |
| excludedSubcommands | [] | 不改写的 rtk 子命令 |
| rewriteWhenConfined | false | Windows 受限沙箱里是否强制尝试 |
| debug | false | 输出改写日志 |

/rtk 命令

| 命令 | 作用 |
| /rtk / /rtk status | rtk 路径、版本、工具状态、计数器、沙箱状态 |
| /rtk verify | 重新探测 rtk |
| /rtk install [version] | 下载并安装 rtk（SHA256 校验） |
| /rtk rewrite git status | 预览改写结果 |
| /rtk gain | rtk 全局节省统计 |
| /rtk on / /rtk off | 运行时开关 |
| /rtk stats | 改写 / 回退 / 失败计数 |

验证

rtk --version
rtk rewrite "git status"

执行一次 git status 后，/rtk status 的 rewrites 应增加；/rtk gain 可查看 rtk 自己的统计。

说明

- Windows 受限沙箱：read-only / workspace-write 下 rtk 无法抓取子进程输出，插件默认暂停改写，原命令照常执行。需要完整功能请使用 danger-full-access。
- 工具卡片显示原始命令：DSH 不修改模型参数，所以记录里是 git status，实际执行的是 rtk git status。
- 只处理 shell 工具：不处理 read / grep / fs 等原生工具。
- 不做额外输出压缩：压缩由 rtk 完成，DSH 负责超长截断。
- /rtk install 需要访问 GitHub：会从官方 rtk-ai/rtk Release 下载并校验 SHA256；GitHub 不可达时可配置 downloadBase 镜像，或手动安装 rtk。

开发

node --test tests/*.test.mjs
npm pack --dry-run

许可证

MIT