前言¶
DeepSeek Harness（DSH）把模型、工具與會話收進桌面進程；Clanker 則是同一維護者生態下的手機端客戶端。若只在手機上配置模型 API，對話仍侷限在端側能力，無法複用你在 Harness 裏已經配好的文件工具、終端與 agent 流程。要在手機上發起「帶認證、可流式、可控制、可傳文件」的遠程 agent 會話，需要一條穩定的橋接層，並自動跟上 Harness 本地端口與啓動 token 的變化。
下面介紹社區插件 dsh-clanker-bridge（維護者 DANIE4588E，分類：客戶端）。它在 Harness Desktop 內啓動認證橋接，讓 Clanker 把本機 Harness 當作 remote backend；手機側不執行遠程 agent 的工具事件，工具權限與執行仍由桌面 Harness 負責。
這是什麼¶
dsh-clanker-bridge 的定位是：在 Harness Desktop 的 Node 運行時裏運行橋接服務，連接 Clanker 手機端與 Harness，處理配對、會話映射與文件工作區，並通過 version-1 遠程 agent API 暴露能力列表、模型、會話、流式事件、Stop、審批/提問與附件傳輸。
上游客戶端與合約與 Harness Desktop 0.2.1-rc.5 對齊（package.json 中 engines.dsh 爲 0.2.1-rc.5）。README 寫明 Windows 爲已驗證平臺；其他桌面發行版與操作系統未做 live 驗證。
核心功能¶
依據倉庫 README，插件在橋接層側提供或透傳的能力包括：
- 認證橋接：本地
pairing.html展示 Wi-Fi/以太網地址與 bridge token；Harness 每次啓動時在內存中注入當前 API 憑證，bridge token 與設備身份持久化，舊聊天可掛回同一設備映射。 - 流式與推理：文本與 reasoning 流式輸出；支持按模型選擇 effort；工具進度、審批/提問、取消。
- 統計（需在 Clanker 側開啓）：Context meter、Decode speed、Cache hits；未知項不展示；Context 反映 Harness 當前壓力/容量，而非 lifetime token 合計。
- 控制與會話語義：後續消息在 active turn 結束前排隊；禁用 regeneration，避免重複 agent 動作。
- 文件：附件按原始字節傳輸，單文件上限 20 MB；每個聊天在 PC 上對應 workspace，Harness 工具需能訪問該文件系統；新改文件可隨回覆附帶，下載保留不可變版本；路徑與符號鏈接校驗不越出 workspace 邊界。Workspace 組織文件，不對 agent 做沙箱；權限、歷史、壓縮與 memory 仍由 Harness 管理。
- 安全邊界：
connection.json與pairing.html含穩定 bridge token，需保密；配對通過本地文件而非未認證 HTTP 路由；上游 Harness 啓動 token 不寫入磁盤、不發給手機。
插件默認監聽端口 8788（可在配置中修改）。
安裝與啓用¶
環境前提（README 原文）：
- 官方 Harness Desktop 0.2.1-rc.5。
- Clanker 需帶 Settings → Backends 的構建；僅配置模型 endpoint 的舊版 Clanker 無法使用 agent bridge。
- 先在 Harness 中配置好模型以及 file/terminal 等工具。
在另一臺 Windows PC 上安裝步驟如下。
- 在 Harness 中打開 Plugins → Add plugin。
- 安裝本倉庫（安裝命令以 README 爲準）：
github:DANIE4588E/dsh-clanker-bridge
也可從 GitHub latest release 安裝預構建歸檔。
- 若 Harness 提示重啓，從 Windows 托盤菜單完全退出後再用平常快捷方式重新打開。
- 在本機瀏覽器打開私有本地配對頁（默認路徑；若設置
DSH_HOME或自定義存儲目錄，路徑以插件日誌爲準，插件只記錄路徑、不記錄 token）：
%USERPROFILE%\.dsh\integrations\clanker-bridge\desktop\pairing.html
- 在 Clanker 中選擇 Settings → Backends → Add remote backend，從該頁複製 PC 的局域網地址與 bridge token，點 Test connection，選模型後 Save。
- 新建聊天並選擇已保存的 backend。
README 說明：無需在另一臺 PC 上 checkout Clanker 源碼、單獨裝 Node、控制台啓動或手工複製 Harness token；插件運行在 Harness 的 Node 運行時內。
配置項¶
插件配置（README 表格）：
| Setting | Default | Meaning |
|---|---|---|
port |
8788 |
手機連接的端口。 |
listenAddress |
0.0.0.0 |
在 LAN/VPN 網卡監聽；設爲 127.0.0.1 則僅本機。 |
dataDirectory |
Harness home 下 integrations/clanker-bridge/desktop |
持久化配對、橋狀態、版本化文件對象與工作區。 |
日常使用：正常打開 Harness 即可；關閉桌面窗口時 Harness 仍可保持運行，完全退出則橋接停止，需重新打開 Harness 再連。若端口已被其他 bridge 佔用，本插件不會踢掉對方——需改端口或停用另一 bridge 後重啓。升級時保留 dataDirectory；刪除會生成新身份，舊聊天無法在對換設備後繼續恢復。
網絡：需在私有 Windows 網絡上放行默認 8788；手機須與 PC 同 LAN 或經私有 VPN 可達；經公網訪問應通過反向代理走 HTTPS。在 Clanker 裏保存備用地址不會自動建立路由。
典型用法¶
配對完成後，手機 Clanker 的新會話走已保存的 remote backend，對話與附件經橋接進入 Harness agent 管線。要在 Clanker 裏看到用量相關 UI，需開啓 Context meter、Decode speed、Cache hits。
若你曾使用 Clanker checkout 裏的開發插件 clanker-harness-desktop-bridge，README 建議遷移前自行備份舊 bridge token、狀態與 workspace 路徑；用本插件默認全新安裝會得到獨立 backend 身份，不會自動導入舊連接。共用同一端口前應先禁用舊插件。
適用場景與注意¶
適合：已在 Windows 上運行 Harness 0.2.1-rc.5，並在 Clanker 中使用 Backends；希望手機端只做遠程 UI 與控制，agent 工具在桌面執行的場景。
注意：
- 插件在 Harness 插件體系內運行，以當前 DSH 進程權限訪問本機文件與網絡；安裝前請閱讀 源碼 與 MIT 許可證。
- 在手機上刪除聊天僅清除手機側本地數據；主機上的 session 與文件需在本 PC 上顯式清理。
- DSH 生態強調「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-clanker-bridge 把 Clanker 手機端與 Harness Desktop 的遠程 agent 接口接在一起：認證配對、流式與控制、附件與工作區映射，並鎖定與 Harness 0.2.1-rc.5 一致的客戶端合約。需要安裝命令、配置字段與配對路徑時，以 GitHub README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/DANIE4588E/dsh-clanker-bridge
- 倉庫：https://github.com/DANIE4588E/dsh-clanker-bridge
