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