dsh-tr-bridge · TokenRouter × DeepSeek Harness
预览版本 v0.1.0-rc.1 / Preview. 社区开发的独立插件，非 DeepSeek Harness 官方组件。已通过 Node 模拟测试；尚未在 Windows DeepSeek Harness 0.2.1-rc.5 完成插件加载及真实 CLI 派发验收。请勿将本项目标记为 Stable、Official 或 Production Ready。
开源来源声明 / Attribution： 本项目受开源社区项目 dsh-agent-conductor（MJorgin）、dsh-agent-teams（NanmiCoder） 和 dsh-agent-arena（Tikzen） 的启发。尤其借鉴了前者的外部 CLI 代理派发思路，以及后两者的多 Agent 协作场景。这是独立实现的非官方社区项目，不是上述项目的官方分支或官方维护版本，也不声称首创相关概念。 项目完整源代码以 MIT License 公开，欢迎阅读、修改、分发与贡献；具体出处请见 NOTICE.md。
English: A local, host-only DeepSeek Harness bridge that delegates bounded tasks to the user's existing tr codex and tr grok launchers. It does not request, store or forward TokenRouter API keys. Early preview; Windows end-to-end compatibility is unverified.
一个专门为 Windows 上已能运行 tr codex、tr grok 的用户准备的 DeepSeek Harness Host 插件。
已验证的前置条件
在项目开发者的 Windows 电脑上，已分别验证下列 TR 命令链路（不是桥接插件本身）：
# 在可信任的 Git 项目内
tr codex exec "只回复 CODEX_OK"
# 结果：CODEX_OK，provider: tokenrouter，sandbox: read-only
tr grok -p "只回复 GROK_OK"
# 结果：GROK_OK
这说明 TR 本身的命令链路正常，不意味着本插件已通过 Windows DSH 宿主验证。
安装（Windows 桌面版，先验收再正式使用）
-
把本文件夹解压到例如 D:\dsh-tr-bridge。确认该文件夹直接包含 package.json、cordis.patch.yml 和 index.js。
-
DeepSeek Harness 桌面版 → 插件 → 添加插件 → 输入本地目录 D:\dsh-tr-bridge → 安装 → 启用。
-
如果程序要求重启，请重启 DeepSeek Harness。无需单独安装 Node 依赖；此包未声明第三方依赖。
-
首次测试请优先选择一个不含重要文件的临时 Git 工作区，确认安全后再进入日常项目。新建会话。
-
首先发送：
请确认已加载 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 命令冒充为插件调用；先检查插件是否启用及工具注册日志。
能力与限制
- 一个工具：
tr_bridge(agent, task, dryRun)，代理名为 codex 或 grok。
- Codex 实际执行
tr codex exec --sandbox read-only <task>，TR 注入的 TokenRouter 路由保持不变。
- Grok 实际执行
tr grok -p <task>，并在任务前加入“禁止修改文件”的文字提示。这不是 Grok 的真实沙箱。在尚未单独验收 Grok 的只读/工具权限前，请仅用于可信、无需改文件的工作区。
- 两个任务互相独立，可以并行调用，都会消耗各自模型的使用额度。
- 每次是一次性的外部 CLI 调用，不是独立的 DSH AgentTeams 成员，也不提供实时微信群式对话。
- 任务最多 20,000 字符，单次最长 10 分钟，返回文本截断到约 24,000 字符；支持 DSH 取消信号。
- 不主动写文件、安装 CLI、重新登录、管理 TR 的 API Key，也不修改 DSH 现有配置。
排查 Windows 启动问题
PowerShell 能运行 tr，但桌面版插件提示找不到： 桌面程序的 PATH 可能与终端不同。可以在 PowerShell 使用 Get-Command tr | Format-List CommandType,Source,Definition 检查其类型与路径（不要粘贴含敏感参数的配置）。如果它是可执行文件，可在 DSH 的插件配置中为 tr-bridge 行设置 config.trCommand 为该可执行文件的完整路径；如果它是 PowerShell 别名或函数，不能直接以可执行文件的方式调用，需要另行提供安全的命令入口。
Codex 报不是 trusted directory： 在 Harness 里先选受信任的 Git 项目文件夹；不建议为了避错直接关闭信任检查。
Grok 无输出或超时： 先在同一个工作区手工重试 tr grok -p "只回复 GROK_OK"。对于需要界面交互、授权提示或登录步骤的任务，本插件不会自动处理。
本地开发测试
node --test
测试只使用 Node 内置 mock，不访问 TR、Codex、Grok 或网络。
来源与维护说明
致谢与引用来源（按照思路影响划分）：
本项目的桥接逻辑为独立编写，无运行时依赖，不直接复制上述项目代码。引用链接用于说明设计灵感和尊重原作者贡献；相关商标、项目名称及其原始源码归各自权利人所有。详细说明请读 NOTICE.md。
状态：v0.1.0-rc.1，预览安装包。Node 模拟单元测试已通过；尚需 Windows DeepSeek Harness 0.2.1-rc.5 真实安装、运行、取消验收。不承诺已通过 Windows 实机加载。问题请开 GitHub Issue，附脱敏日志、版本和复现步骤，不要上传 TokenRouter Key 或包含客户资料的截图。
Open source
