前言¶
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
