前言¶
DeepSeek Harness（DSH）通过 Host 插件把工具注册进会话，让模型在受控边界内执行外部能力。若你已在 Windows 上通过 TokenRouter 跑通 tr codex、tr grok，希望在 Harness 里把有界任务派给这两条 CLI，而不是在对话里手工复制粘贴命令，就需要一个只在本机、只走现有 tr 启动器的桥接层。
dsh-tr-bridge（GitHub：superqin7/dsh-tr-bridge）是社区维护的 MIT 开源 Host 插件，当前为预览版 v0.1.0-rc.1。它不申请、不存储、不转发 TokenRouter API Key；设计思路受 MJorgin/dsh-agent-conductor 等项目的启发，为独立实现，非 DeepSeek 官方组件。README 明确说明：Node 模拟测试已通过，尚未在 Windows DeepSeek Harness 0.2.1-rc.5 上完成插件加载与真实 CLI 派发验收，请勿当作 Stable 或 Production Ready 使用。
这是什么¶
维护者 superqin7，分类为工作流。插件在本地 Host 内注册一个工具，把 bounded task 委托给用户已有的 tr codex 与 tr grok，不安装 CLI、不改 DSH 全局配置、不管理 TR 密钥。
一句话：Harness 会话 → tr_bridge 工具 → 本机 tr 命令 → Codex / Grok 模型额度。
核心功能¶
插件只暴露一个 Host 工具：
tr_bridge(agent, task, dryRun)
- agent：
codex或grok。 - task：任务描述（上限约 20,000 字符）。
- dryRun：为
true时只预览将要执行的启动参数，不真正调用 CLI。
具体行为（与 README 一致）：
| agent | 实际命令形态 | 说明 |
|---|---|---|
| codex | tr codex exec --sandbox read-only <task> |
保持 TokenRouter 注入的路由；需在 Harness 中选受信任的 Git 工作区 |
| grok | tr grok -p <task> |
任务前会加「禁止修改文件」类文字提示；不是 Grok 的真实沙箱 |
其他已写明的边界：单次最长约 10 分钟；返回文本截断到约 24,000 字符；支持 DSH 取消信号；Codex 与 Grok 可并行调用，各自消耗额度；每次为一次性外部 CLI 调用，不是 DSH AgentTeams 成员，也没有群聊式持续对话。包未声明第三方 npm 依赖，要求 Node >= 20。
已验证的前置条件（TR 链路，非插件本身）¶
开发者在 Windows 上已分别验证 TR 命令（不代表桥接插件已在 DSH 桌面版验收）：
# 在可信任的 Git 项目内
tr codex exec "只回复 CODEX_OK"
# 结果：CODEX_OK，provider: tokenrouter，sandbox: read-only
tr grok -p "只回复 GROK_OK"
# 结果：GROK_OK
下面介绍在 DSH 里安装插件并做 dryRun / 实调时的步骤。
安装与启用（Windows 桌面版）¶
README 给出的方式是本地目录安装，不是 dsh plugin add github:... 一类命令：
- 将仓库内容解压到例如
D:\dsh-tr-bridge，确认目录下直接有package.json、cordis.patch.yml、index.js。 - DeepSeek Harness 桌面版 → 插件 → 添加插件 → 输入本地路径
D:\dsh-tr-bridge→ 安装 → 启用。 - 若程序要求重启，重启 Harness。无需单独
npm install。 - 首次测试建议使用不含重要文件的临时 Git 工作区，新建会话。
若 PowerShell 能运行 tr 但插件提示找不到命令：桌面进程的 PATH 可能与终端不同。可用 Get-Command tr | Format-List CommandType,Source,Definition 查看；若是可执行文件，可在插件配置里为 tr-bridge 设置 config.trCommand 为该文件的完整路径；若是 PowerShell 别名或函数，不能直接当可执行文件调用，需另备安全入口。
典型用法¶
先确认工具已加载，并用 dryRun 预览参数：
请确认已加载
tr_bridge工具。先以agent=codex, task=只回复 CODEX_OK, dryRun=true预览启动参数，不要真正执行。
核对预览中的工作目录与 tr codex exec --sandbox read-only 一致后，再实调：
请调用
tr_bridge工具分别让 Codex 和 Grok 只回复CODEX_OK和GROK_OK，完成后显示两份原始回复。不要修改任何文件。
若第 5 步提示找不到 tr_bridge，不要用 Shell 命令冒充插件调用；检查插件是否启用及工具注册日志。
Codex 报非 trusted directory 时，应在 Harness 里选择受信任的 Git 项目文件夹，不建议为避错关闭信任检查。Grok 无输出或超时，先在同一工作区手工执行 tr grok -p "只回复 GROK_OK"；需要交互、授权或登录的步骤，插件不会自动处理。
适用场景与注意¶
适合谁：已在 Windows 配置好 TokenRouter，且 tr codex / tr grok 在终端可用；希望在 DSH 单会话里把只读或轻量任务交给 Codex/Grok，并愿意接受预览版与未完成的 Windows E2E 验收风险。
务必注意：
- 插件以当前 DSH 进程权限运行；安装前应阅读 MIT 源码 与 NOTICE.md，自行判断信任边界。
- Grok 路径仅有文字层面的「勿改文件」提示，在单独验收权限前，仅用于可信、无需改文件的工作区。
- 社区目录页 skillhub.cn/plugins/superqin7/dsh-tr-bridge 为独立站点 listing，与 DeepSeek / 幻方无官方从属关系；DSH 生态仍是「一切皆插件」，本仓库 GitHub 星标为 1（以目录页/仓库公开信息为准）。
本地开发可运行：
node --test
测试仅用 Node 内置 mock，不访问 TR、Codex、Grok 或网络。
结尾¶
经过上面的步骤，你可以在 Harness 里用 tr_bridge 把有界任务交给本机 TokenRouter 的 Codex 与 Grok CLI，而不把 API Key 交给插件。当前版本为预览态，Windows 桌面实机加载仍待社区验收；问题可到 GitHub 开 Issue，附脱敏日志与版本，勿上传 TokenRouter Key 或客户资料截图。
- 目录页：https://www.skillhub.cn/plugins/superqin7/dsh-tr-bridge
- 仓库：https://github.com/superqin7/dsh-tr-bridge
