前言¶
DeepSeek Harness(DSH)的会话一旦在电脑上跑起来,很难把任务完全交给 AI。打断、补问、处理需要确认的工具调用,都离不开人机交互。这时你往往需要回到电脑前,或者启动一个远程桌面。
dsh-roam 插件直接把 DSH 的会话带到手机浏览器。不需要安装 App,不需要中转账号,用手机扫码就能接着聊、开新任务、审批工具调用或查看进展。
插件定位¶
dsh-roam 是一个独立的 DeepSeek Harness 插件,由 winlin926 维护。它不依赖任何手机 App,只通过浏览器提供会话界面。手机上只做任务交互,终端、插件管理和复杂文件操作仍保留在电脑端。
插件目录页:https://www.skillhub.cn/plugins/winlin926/dsh-roam
GitHub:https://github.com/winlin926/dsh-roam
核心能力¶
- 接着聊:电脑上的会话在手机上继续提问、补充要求。
- 新开任务:在首页直接输入任务,选择工作区、模型、思考强度和会话模式,发送后创建会话。
- 查看进展:待办和工具调用进度在手机上可见。
- 处理审批:需要授权或回答的问题,在手机上直接处理。
- 带资料:支持相册、拍照、粘贴图片,或发送其他文件。
- 会话管理:左上角打开抽屉,查看最近会话、已归档会话,搜索或切换工作区。
- 设备状态:「连接设备」显示本次运行中的配对会话、最近请求时间和状态,避免旧连接误报为在线。
安装与启用¶
前置条件¶
- 电脑运行 DeepSeek Harness 0.2.x。
- Node.js 22.19 或更新版本。
- 手机浏览器即可,无需安装应用。
- 最简单的情况:电脑和手机连接同一个 Wi-Fi。
在 DSH 中安装(推荐)¶
- 打开 设置 → 插件市场。
- 搜索 dsh-roam。
- 点击安装,然后重启 DSH。
- 进入 设置 → 连接手机。
命令行安装¶
dsh plugin --profile web add dsh-roam@1.2.0
安装完成后进入 设置 → 连接手机。
第一次连接¶
- 在「连接手机」里选择 同一 Wi-Fi。
- 用手机相机扫描页面上的二维码。
- 浏览器打开首页后,输入第一句话,发送即可创建会话。
- 想继续之前的工作,点左上角 ☰,从左侧抽屉选择会话。
二维码是一次性的,5 分钟内有效;过期或已经用过,点「换一张」即可。
公网入口会要求输入页面显示的 6 位连接密码。浏览器会话只保存在内存中,插件或 DSH 重启后需要重新扫码,这是为了不给旧连接留下长期有效的入口。
连接方式¶
| 情况 | 建议用法 |
|---|---|
| 电脑和手机在家或同一个办公室 Wi-Fi | 选 同一 Wi-Fi,扫码即可,最省事 |
| 临时出门,手边没有域名 | 在 高级设置 → 网络配置 开启临时隧道,优先 Cloudflare,失败可回退 Pinggy |
| 有自己的域名,准备长期使用 | 配置固定域名 + frpc / SakuraFrp,再申请证书 |
没有域名也能用:临时隧道不需要你购买域名,也不需要配置固定公网 IP。隧道地址每次开启可能变化,适合临时使用;手机记得重新扫码。若希望地址长期不变,再配置自己的域名。
固定域名目前支持 HTTPS 和 Let’s Encrypt 证书申请/续期。详细的 frpc 配置、数据目录和安全边界见 README 的「连接与安全」部分。
手机端功能¶
- 新建首页直接输入任务,发送后才创建会话。
- 全屏聊天,模型、思考强度和会话模式都可以从输入卡调整;会话模式在第一条消息后锁定。
- 图片多选、拍照、粘贴,自动压缩后发送;历史图片可放大查看。
- 文件先上传,再随消息发送;历史显示文件名和大小,文件内容暂时请在电脑端查看。
- 工具审批「允许一次」或「拒绝」。
- 生成中可排队补充;想立即改变方向,点「打断」。
- 长会话可「加载更早」,回看时保持阅读位置。
- 会话重命名、归档、取消归档、按标题或内容搜索;全文搜索不可用时退回标题过滤。
- 待办、提问、连接状态和最近设备一目了然。
连接与安全¶
dsh-roam 默认不把你的工作台直接暴露出去:
- 设置管理接口只接受电脑本机回环请求,并校验 Host 和同源。
- 二维码令牌一次性、5 分钟有效;公网入口必须输入 6 位密码,连续输错会限速。
- 浏览器只接受服务端签发的 Cookie,不因为来自同一个 IP 就自动放行。
- 修改连接密码会立即使已连接的浏览器失效。
- 没有应用层端到端加密。公网 TLS 在 Cloudflare、Pinggy、frps 或反向代理处终止,相关运营方理论上可以看到会话明文。内容比较敏感时,建议使用自己控制的固定域名和反向代理,或只在可信局域网使用。
本地设置、连接密码和证书状态位于 %USERPROFILE%\.dsh\dsh-roam(DSH_HOME 可覆盖)。没有遥测,也没有插件自己的账号体系。只有开启临时隧道或申请/续期证书时,才会连接相应外部服务。
1.2.0 更新要点¶
- 首页更清净:只保留当前要做的事,最近会话不再挤占首屏。
- 找会话更顺手:左上角 ☰ 打开左侧抽屉,工作区、搜索、最近会话、归档都在这里。
- 聊天更像手机:独立返回、清楚的标题和运行状态、底部输入区,模型与模式选择也换成了适合触屏的底部面板。
- 小细节补上了:键盘和焦点、弹层返回、流式消息、长会话阅读位置、慢请求切换会话,以及发送失败后的草稿和附件保留。
- 连接情况看得见:新增「连接设备」,活跃会话有几个、最近什么时候有请求、是否手动断开,一看就明白。
- 第一次来也能看懂:README 增加中英文说明、真实手机与设置截图,安装、连接和使用路径重新梳理。
完整的兼容边界、测试记录和升级说明见 README 的 1.2.0 更新内容。
适用场景与注意¶
适合需要随时查看或补充 AI 任务进展、处理审批类交互、或在外使用浏览器的开发者。
注意:插件以当前 DSH 进程的权限运行。安装前建议查看源码与许可证(MIT)。插件仅提供浏览器界面,不把完整桌面 IDE 塞进手机。
结尾¶
dsh-roam 让你用手机浏览器就能接续 DeepSeek Harness 的会话,适合需要随时处理任务审批、查看进展或在外补充需求的场景。安装与连接都在 DSH 的设置与命令行中完成,没有额外的 App 依赖。
插件目录页:https://www.skillhub.cn/plugins/winlin926/dsh-roam
GitHub:https://github.com/winlin926/dsh-roam