前言¶

在用 DeepSeek Harness（DSH）写智能体时，经常会遇到 shell 命令输出太长、上下文被占满的问题。传统做法要么让模型重试、要么手动截断，体验并不顺滑。rtk（Runtime Token Keeper）能对命令输出做压缩，但需要显式调用 rtk rewrite。dsh-rtk-bridge 这个插件把这两件事串起来：让模型调用 pwsh / bash 时，插件自动用 rtk 查找等价命令并改写执行，把压缩后的输出直接放进上下文。

这是什么¶

dsh-rtk-bridge 是 DeepSeek Harness 的一个工作流插件，由 b1inkie 维护。它包装 DSH 的 shell 工具，在模型发起 pwsh 或 bash 时，先尝试用 rtk rewrite 改写命令。命中等价命令后，执行改写后的命令，让 rtk 的压缩输出进入上下文；如果改写失败（rtk 缺失、无等价命令、改写不安全等），则原样执行。

核心功能¶

• 自动改写并执行：插件包装 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

/rtk 命令¶

典型用法¶

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

rtk --version
rtk rewrite "git status"

适用场景与注意¶

• 适合希望减少命令输出长度、避免模型被长文本占满上下文的工作流。
• 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
• Windows 受限沙箱下（read-only / workspace-write），rtk 无法抓取子进程输出，插件默认暂停改写，原命令照常执行。需要完整功能请使用 danger-full-access。
• 只处理 shell 工具（pwsh / bash），不处理 read / grep / fs 等原生工具。
• 压缩由 rtk 完成，DSH 负责超长截断。

短结尾¶

dsh-rtk-bridge 让 rtk 的命令改写能力在 DSH 中无缝接入，减少模型输出压力。插件主页：https://github.com/b1inkie/dsh-rtk-bridge