dsh-solo

DSH-SOLO

中文 | English

通过手机远程使用电脑上的 DeepSeek Harness：查看会话、发送任务、切换模型、传递附件，并审批需要确认的操作。

0.1.5 已实现手机 App ↔ 电脑插件端到端加密。 从 0.1.4 升级时，中转、插件与 App 需要配套更新，并扫描新版二维码重新配对。自建用户请先阅读 升级与回滚说明。

安装与使用

DSH-SOLO 官方插件已内置官方云转发服务配置。普通用户只需要安装电脑端插件和 Android App，无需部署服务端，也无需填写服务器域名。 扫码即可将手机与自己的电脑配对。

1. 安装电脑端插件（推荐）

在 DeepSeek Harness 官方桌面版 中，进入 插件 → 添加插件，输入以下包名并点击 安装：

dsh-solo-agent

安装后点击 立即启用。如果左侧没有出现 手机配对，通过 应用 → 退出 完全退出桌面版，再重新打开；只关闭窗口可能隐藏到托盘。

省略版本号时安装 npm latest 标签对应的正式版；需要指定版本时可输入 dsh-solo-agent@0.1.5。如果提示找不到插件，请先将安装源切换到 官方 npm 源，国内镜像可能尚未同步。已安装的插件需要按宿主提示更新，或卸载后重新安装；通常可保留用户主目录 .dsh-solo 中的配对数据。

查看插件安装图解（点击展开）

① 添加插件，输入 dsh-solo-agent

② 安装成功后，点击「立即启用」

③ 确认插件开关已打开

④ 组件显示「运行中」，打开左侧「手机配对」

2. 下载 Android App

• 下载最新版 Android APK
• 查看全部 Releases、版本说明与插件安装包

下载 dsh-solo.apk 后在 Android 手机上安装；插件与 App 的版本兼容性以发布说明为准。安装包发布在本项目仓库的 Releases，可直接下载。

3. 扫码配对

1. 在 DeepSeek Harness 官方桌面版左侧点击 手机配对；插件详情页也有此入口。
2. 在手机 App 中点击 扫码配对，扫描页面内的二维码，确认后连接。地址与令牌自动填入。
3. 不方便扫码时，在电脑配对页点击 查看配对码，再将完整加密配对码粘贴到 App；官方 App 已预置官方云转发地址。

使用时电脑上的 DeepSeek Harness 和插件需要保持运行，电脑与手机均需联网。二维码包含设备配对凭证，请勿公开分享。Android 为当前交付目标；其他平台需要自行适配和验证。

查看电脑端手机配对页面（点击展开）

图中的二维码仅用于演示。请扫描自己电脑插件中的二维码；令牌重置后，旧二维码失效。

4. 使用演示

▶ 观看 App 完整操作视频（约 2 分 18 秒）

点击下方预览图打开视频，演示手机连接、选择电脑项目、发送任务、调用工具列出文件、切换模型，以及重命名和删除会话。

手机创建的会话会同步到电脑端所选项目：

发送第一条任务前，点击 ＋ → 选择项目，选择电脑端已添加的项目，新会话会创建在该项目下；已有会话保持原位置。项目列表只获取名称和标识，不扫描项目文件。

主页右上角齿轮提供 设备连接、使用帮助、隐私与权限、关于 DSH-SOLO；可查看版本、开源许可和项目链接，或复制不含令牌及聊天内容的连接诊断。

其他方式：使用插件安装包

需要离线安装或固定归档时，从 Releases 下载 dsh-solo-agent-<版本号>.tgz。

1. 将 .tgz 解压到准备长期保留的目录。有些工具需先解出 .tar，再解出文件夹。
2. 找到包含 package.json 的 package 文件夹，例如 D:/DSH-SOLO/plugin/package。
3. 在 DeepSeek Harness 官方桌面版 插件 → 添加插件 中输入该文件夹的绝对路径，安装并启用。

不要填写单个 .js 文件或未解压的 .tgz。本地安装会链接到该文件夹，安装后请保留原位置。已有同名插件时先卸载，再安装并按提示重启。

第三方 dsh-market 插件市场还需单独收录；发布 npm 或公开 GitHub 不会自动完成市场收录。

功能

• 查看会话和实时回复，重连后同步事件。
• 创建任务、选择模型、重命名和删除会话。
• 在手机上允许或拒绝远程审批。
• 上传图片与文件、选择电脑端项目创建会话、发送文档链接。
• 查看 Markdown 回复与代码差异。

当前安全与隐私

从 0.1.5 起，手机 App 与电脑插件之间使用端到端加密：扫码提供独立于连接令牌的加密凭据，经认证的临时 X25519 密钥交换建立每台手机各自的会话，业务内容使用 AES-256-GCM 加密并校验完整性与消息顺序。消息、工具结果、项目列表、审批和附件正文都在端侧加解密。

中转只转发密文，不持有加密凭据或解密密钥；连接 IP、连接令牌、时间与流量大小仍可见。重连历史从电脑端重新加密获取，公网仍应使用 WSS。App 的配对凭据使用系统安全存储；本机会话缓存尚未增加应用层静态加密。

旧二维码与单独连接令牌不能完成新版本配对。请保管完整二维码和加密配对码；重置后所有手机均需重新配对。电脑端及其配置的模型服务仍会处理任务内容。已完成功能与实机验证，尚未经过独立安全审计，详见 加密设计与测试说明。

自建与源码构建

源码构建默认连接本机，不包含官方服务器地址。手机自建使用时，请通过电脑端配对二维码获取手机可访问的地址。

环境：Node.js 22、Go 1.22 或更高版本；App 使用 Flutter 3.47.7 / Dart 3.13.5，Android 使用 JDK 17。构建工具版本以工程文件为准。

npm ci
npm run configure
npm run build
npm run bundle --workspace=dsh-solo-agent
npm test
npm run test:go

• 统一配置与发布说明：三端配置、签名、GitHub 自动构建。
• 桌面版插件安装与市场分发：标准安装包、本地验证和第三方市场收录。
• 自建部署：Docker、局域网和隧道接入。
• 服务端监控与部署接管：维护者登录、连接统计、资源趋势和升级验收。
• 协议定义：开发与集成参考。
• 贡献指南。

本机运行中转服务：npm run relay。插件的 relayUrl 可以覆盖构建默认值；手机扫码获取地址和令牌，两端使用相同令牌配对。

功能路线图

已完成和计划中的功能如下；优先级会根据使用反馈和开发进展调整，具体可用功能以 Release 说明为准。

• 端到端加密：手机与电脑插件之间的消息、工具、项目、审批和附件加密，包含系统安全存储与防重放。
• 加密密钥管理增强：单设备撤销、设备管理与密钥生命周期改进。
• iOS App：适配 iPhone，打通构建、签名与 TestFlight 测试分发。
• 鸿蒙端 App：完成鸿蒙平台适配、HAP 构建与真机验证。
• 系统通知与离线推送：在任务完成或需要审批时，通过手机系统通知及时提醒。
• 语音输入任务：将语音转为任务文本，方便在手机上发送指令。
• 多工作站管理：在手机上切换和管理多台电脑的会话与任务。

欢迎通过 Issues 反馈需求和使用场景。

项目结构

目录	内容
packages/agent	电脑端 Cordis 插件
packages/protocol	通信协议
app	Flutter 移动端
server	Go 中转服务
deploy	自建部署配置

通信方式：手机 App ↔ WebSocket 中转服务 ↔ 电脑端插件。公网部署请使用 WSS。

许可证

MIT