dsh-phone:用手機掃碼配對,在 OpenTandem 上繼續本機的 dsh 會話

前言

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 中已寫明、可與資料覈對的內容:

  1. 側欄入口:啓用後在 dsh web 側欄出現 Phone,可 Show QR code。
  2. 掃碼配對:手機掃二維碼在瀏覽器打開,在 OpenTandem 登錄並點 Allow 後,dsh web 頁面顯示電腦已連接。
  3. 會話同步:手機 OpenTandem 中會出現 dsh 使用的項目文件夾及近期會話,可繼續或新建任務;與電腦共用同一會話。
  4. 換賬號:在配對頁點 Switch account;新連接需在手機再次 Allow,當前連接會保持到你在手機上重新授權爲止。
  5. 安全與賬號邊界:OpenTandem 賬號與密碼僅在手機登錄,插件不接觸;不使用 DeepSeek 賬號;任務走你在 dsh 裏已配置的模型。插件路由走 dsh 自帶的連接檢查,POST 僅接受 application/json。
  6. 後臺常駐:首次配對會下載並安裝 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 步驟可復現完整流程:

  1. 在 dsh web 側欄點 Phone,再點 Show QR code。
  2. 用手機掃描二維碼,在瀏覽器中打開鏈接。
  3. 在手機上登錄 OpenTandem,點 Allow。
  4. 確認 dsh web 的 Phone 頁顯示已連接。
  5. 在手機 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,並複用已有會話與項目目錄。查閱說明與源碼:

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜