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,并复用已有会话与项目目录。查阅说明与源码:

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

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

小夜