前言¶
DeepSeek Harness(dsh)的智能體任務通常在開發機上通過 dsh web 或命令行完成。人離開工位時,想用手機查看進行中的會話、發一條新任務,往往要依賴遠程桌面或另開一套無關工具,和本機已有的 dsh 項目目錄、會話歷史也對不上。
dsh-phone 是維護者 opentandem 提供的 客戶端 類 DSH 插件:在 dsh web 裏展示二維碼,手機瀏覽器掃碼後在 OpenTandem 登錄並授權,即可把任務發到運行 dsh 的這臺電腦;本機已有會話會出現在手機任務列表裏,手機和電腦沿用同一會話。社區目錄頁:https://www.skillhub.cn/plugins/opentandem/dsh-phone。
這是什麼¶
一句話:dsh-phone 用「dsh web 側欄 + 二維碼配對 + OpenTandem 手機端」把 DeepSeek Harness 接到手機上,配對後由 OpenTandem 把任務路由到本機 dsh 執行。
插件本身主要提供一個小頁面和配對流程;長期保持手機可達的是 OpenTandem 命令行及其後臺 Runner(獨立程序,非本插件代碼打包內容)。當前 package.json 版本爲 0.1.5,插件許可證爲 MIT;OpenTandem 命令行與 Runner 源碼公開,許可證爲 AGPL-3.0。
核心功能¶
下面能力是 README 中已寫明、可與資料覈對的內容:
- 側欄入口:啓用後在
dsh web側欄出現 Phone,可 Show QR code。 - 掃碼配對:手機掃二維碼在瀏覽器打開,在 OpenTandem 登錄並點 Allow 後,
dsh web頁面顯示電腦已連接。 - 會話同步:手機 OpenTandem 中會出現
dsh使用的項目文件夾及近期會話,可繼續或新建任務;與電腦共用同一會話。 - 換賬號:在配對頁點 Switch account;新連接需在手機再次 Allow,當前連接會保持到你在手機上重新授權爲止。
- 安全與賬號邊界:OpenTandem 賬號與密碼僅在手機登錄,插件不接觸;不使用 DeepSeek 賬號;任務走你在
dsh裏已配置的模型。插件路由走dsh自帶的連接檢查,POST 僅接受application/json。 - 後臺常駐:首次配對會下載並安裝 OpenTandem 命令行並啓動 Runner,
dsh web關閉後手機仍可連到本機(可用opentandem uninstall或在 OpenTandem 設置中移除本機)。
安裝與啓用¶
安裝需使用 dsh 的 web profile(與側欄 Phone 頁面一致)。官方提供三種方式,任選其一。
從 npm 安裝:
dsh plugin --profile web add dsh-phone
從 GitHub 安裝:
dsh plugin --profile web add github:opentandem/dsh-phone
或在 dsh web 中打開 Plugins → Add plugin,輸入 dsh-phone,安裝後點 Enable now。若側欄沒有 Phone,刷新頁面一次。
安裝前應閱讀倉庫源碼與許可證;插件以當前 dsh 進程的用戶與權限運行,授權後該 OpenTandem 賬號發來的任務會在本機通過 dsh 執行,僅在自己發起配對時點 Allow。
典型用法¶
按 README 步驟可復現完整流程:
- 在
dsh web側欄點 Phone,再點 Show QR code。 - 用手機掃描二維碼,在瀏覽器中打開鏈接。
- 在手機上登錄 OpenTandem,點 Allow。
- 確認
dsh web的 Phone 頁顯示已連接。 - 在手機 OpenTandem 中查看任務列表(含
dsh項目目錄與會話),繼續會話或新建任務。
若要連接另一個 OpenTandem 賬號,在 Phone 頁使用 Switch account,並在手機上對新連接點 Allow。
首次配對時本機會發生什麼¶
點 Show QR code 前,建議瞭解插件會觸發的下載與後臺行爲(README 表格摘要如下):
| 項目 | 說明 |
|---|---|
| 下載 | 首次從 https://opentandem.org/api/cli-script?file=launcher.mjs 下載 launcher 到 ~/.opentandem-dsh/,由運行 dsh 的 Node.js 執行;launcher 會安裝 OpenTandem 命令行,約一分鐘。 |
| 後臺服務 | 命令行會啓動並保留 Runner,以便關閉 dsh web 後手機仍能訪問本機。 |
| 手機能力 | Allow 之後,該賬號下發的任務在本機經 dsh 運行。 |
OpenTandem Runner 與命令行源碼:https://github.com/opentandem/opentandem。
配置項¶
僅當資料中明確出現的環境變量:
| 環境變量 | 含義 |
|---|---|
OPENTANDEM_CLI |
使用指定的 launcher 或 opentandem 可執行文件,而不是自動下載。 |
OPENTANDEM_SERVER |
下載與配對使用的 OpenTandem 服務地址,默認 https://opentandem.org。 |
適用場景與注意¶
適合誰:已在臺式機或筆記本上跑 dsh,希望用手機通過 OpenTandem 查看同一工作區、續聊或下發任務,且能接受安裝 OpenTandem 命令行與後臺 Runner 的開發者。
兼容性:README 寫明僅在 macOS 上測試過 dsh 0.2.1-rc.2 與 0.2.2-rc.1;Windows、Linux 尚未測試。
生態說明:DeepSeek Harness 奉行「一切皆插件」;SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係,本文檔描述的是社區插件 opentandem/dsh-phone,非官方應用商店條目。
權限與安全:配對等於允許該 OpenTandem 賬號向本機 dsh 投遞任務;Runner 會長期存在直至你卸載或移除設備。安裝前請覈對 GitHub 倉庫與 MIT / AGPL 許可範圍。
結尾¶
dsh-phone 把 dsh web 上的二維碼配對與 OpenTandem 手機工作區接在一起,讓手機任務落回本機 dsh,並複用已有會話與項目目錄。查閱說明與源碼: