掌上 dsh · dsh-mobile

把 DeepSeek Harness 的会话装进手机浏览器。 配对即用：流式对话、工具过程、审批与提问、文件上传、模型切换，全部随身。

快速开始 · 特色 · 截图 · 配置 · 架构

实时流式对话
_{思考过程、工具调用、Markdown 一屏到底}

会话一览
_{按天分组、轮次统计、运行中高亮}

_{本机 / 同步桌面 / 桌面端
每一行都标明改动落在哪一层}

特色

🎛 和桌面同一份上下文 手机上看到的就是桌面那个会话：同一串消息、同一份工具输出、同一个模型。接着聊，不用复制粘贴。

🧠 过程是可见的 思考折叠卡、工具调用卡、子任务卡、轮次尾卡都会出现在消息流里，可展开看细节；跑完显示「已完成 · 用时 N 秒」。

📎 附件真的能用 发图、发文件（.docx/.xlsx/.pptx/.zip/.txt 都行）；已上传文件以胶囊显示在待发送区，发送时把工作区路径交给模型，直接就能读。

✅ 审批与提问 宿主弹出的审批、ask_user_question 都能在手机上应答；错过也没关系，重进会话会自动补发卡片。

📱 PWA 常驻 添加到主屏幕，像 App 一样打开；带离线条、更新检查与浏览器通知。

🔌 零改造接入 不改 dsh 本体、不改桌面 UI。宿主半是一个普通插件，手机 UI 是打包好的静态资源。

_{工作区 · 固定 / 最近 / 运行中}

_{待发送附件 · 图片与文件}

_{长文正文 · 流式输出}

快速开始

1. 装插件（二选一）

# 按名字从 npm 装
dsh plugin add dsh-mobile-web

# 或者本地开发装：把仓库根目录作为 bundle
dsh plugin add /path/to/dsh-mobile

2. 桌面 dsh：设置 → 掌上 dsh，出二维码

3. 手机浏览器打开

http://<主机IP>:19387/m/     # 局域网直连
https://your-host.example.com:45632/m/   # 公网（HTTPS 反代）

手机扫桌面那张二维码即可自动配对（面板里同时给了「复制链接」，不方便扫码时把链接发到手机粘贴也行）。配对后设备 cookie 长期有效，桌面端可随时撤销设备。

公网访问请务必套 HTTPS 反代，不要把 19387 明文端口直接暴露到公网。详见 SECURITY.md。

能力一览

扫码配对：桌面设置面板出二维码，手机扫一下就完成配对；扫不了码时可复制面板里的配对链接粘贴。服务端下发 HttpOnly 设备 cookie，可在桌面端随时撤销设备。
完整手机聊天界面：会话列表、流式回复（SSE /m/api/events.mux）、推理块、工具卡、Markdown/代码块、消息队列、引用、重新生成、搜索。
工作区与会话：浏览 / 新建 / 重命名 / 归档；运行中徽标；「最近访问 / 固定 / 运行中」快捷入口；会话清理（归档 / 本地隐藏 / 彻底删除 / 回收站）。
审批与提问：mobile.pending / mobile.respond；进入会话自动补发待处理卡片，工作区与会话行有橙条提示。
附件：相册/拍照、文件上传（24 MB 上限，落到会话工作区 .dsh-uploads/）；文件卡片可预览文本、下载原文。
模型与权限：查看模型目录、切换会话模型与思考强度；权限预设从工具栏盾牌切换。
命令面板：/ 面板合并宿主命令、本机动作与技能目录，中文标题与说明；选中即插入输入框，由宿主命令通道执行。
通知：浏览器通知 + 推送渠道（WxPusher / Server酱 / Bark / Telegram / PushPlus）+ 可选 Web Push。
语音转写：可配置 OpenAI 兼容的转写服务（按序回退）。
设置：外观 / 对话等本机项 + 主机配置只读/可写项，逐项标注「本机 / 同步桌面 / 桌面端」。
PWA：可添加到主屏幕，离线壳与更新检查。

前置条件

dsh ≥ 0.2.0-rc.1（见 package.json 的 dsh.engines.dsh）
Node.js ≥ 20（插件宿主与 mobile-src 构建）
手机端浏览器：Chrome / 夸克等 Chromium 内核；HTTPS 环境下 Web Push、剪贴板等能力才可用

配置

在 profile 的 cordis.patch.yml 里加一条：

- insert:
    - id: dsh-mobile
      name: 'dsh-mobile-web'
      config:
        enabled: true
        mobilePort: 19387
        mobileHost: '0.0.0.0'
        pairCode: ''                                          # 留空 = 随机 6 位码（5 分钟过期）
        publicBaseUrl: 'https://your-host.example.com:45632'   # 仅用于展示，可留空

字段	默认	说明
`enabled`	`true`	关闭后不挂载任何路由
`mobilePort`	`19387`	手机监听端口（独立于 GUI 的动态端口）
`mobileHost`	`0.0.0.0`	监听地址；只在本机用可改 `127.0.0.1`
`pairCode`	`''`（随机 6 位、5 分钟过期）	留空 = 随机码；填固定值则该码永不过期（代码内回退值 `123456` 仅供开发，公开部署不要用固定码）
`publicBaseUrl`	空	设置面板展示的公网地址，仅展示用途，留空也不影响运行
`devicesFile`	`~/.dsh/dsh-mobile-devices.json`	已配对设备与 token 的存储位置
`pushConfigFile`	`~/.dsh/dsh-mobile-push.json`	推送渠道配置
`hiddenModels`	`[]`	手机端模型选择器里隐藏的模型 id

架构

手机浏览器 / PWA
  │  GET /m/  (HTML + 注入脚本 + theme.css)
  │  POST /m/api/<method>  (63 个 RPC：session/workspace/pair/mobile/…)
  │  GET  /m/api/events.mux (SSE)
  ▼
index.js（宿主半）
  ├─ 双 HTTP 面：GUI webServer（回环，设置面板）+ 0.0.0.0:<port>（手机/局域网/公网）
  ├─ 配对与设备 cookie、审批/提问应答、通知、用量、插件/自动化页数据、命令与技能目录
  └─ 注入脚本：在不改 bundle 的前提下补齐工具栏、命令面板、设置范围标签、图片预览等
  ▼
assets/mobile.bundle.js  ← 由 mobile-src/ 构建（dsh-palm v1.6.0 fork，见 mobile-src/UPSTREAM.md）
assets/theme.css         ← 本仓库自己的样式（实时读盘，改完刷新生效）

手机 UI 复用 dsh-palm v1.6.0 的 React bundle（源码已 vendor 到 mobile-src/，Apache-2.0）；宿主侧 RPC 由本插件按 dsh 原生服务重新实现，而不是沿用 dsh-palm 的 host。

开发

# 1) 构建手机 bundle（源码在 mobile-src/，产物写到 assets/）
cd mobile-src
npm ci
npm run build        # 实测 npm ci ~1.2s、构建 65–80ms，产物 sha256 可复现

# 2) 检查宿主半语法
node --check index.js

# 3) 本地加载验证（插件已装好并监听 19387 时）
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:19387/m/

assets/theme.css 每次请求实时读盘：改完刷新手机页面即生效，无需重启 dsh。
index.js / src/host/** 由 dsh 进程加载，保存后不会自动重载；开发时可临时在 profile 的 cordis.patch.yml 末尾加一行注释触发 reconcile（随后还原），或重启 dsh。

改动归属（避免误归因）

mobile-src/ 相对 dsh-palm v1.6.0 只改了两处，已回源到源码并记录在 mobile-src/UPSTREAM.md：
1. 设置 → 外观新增「发送模式」行（读写宿主 window.__dmSendMode）；
2. 用量卡片的「账户余额」文案改为「充值余额」。
「关于 / 反馈」文案、网页搜索 artwork 等属于 src/host/** 的 DOM 补丁（注入脚本），不是 bundle 源码改动。
其它手机端增强（命令面板、图片预览、设置范围标签、插件/自动化页等）全部在 src/host/** / assets/theme.css 中实现。

已知限制

实时通道：聊天流式走 SSE /m/api/events.mux；通知类端点 /m/api/events.notify 未实现（保持 404），手机端通知走轮询 / Web Push / 推送渠道。
Web Push：iOS 与大陆网络对 FCM 支持有限（需代理）；不想折腾可用推送渠道（WxPusher 等）。
Web Push 需要 HTTPS：http:// 访问时浏览器通知与 Service Worker 推送不可用。
设备 cookie 即登录态：撤销设备后该 cookie 立即失效；不要在多台设备间共享 cookie。
截图路由：/m/shot/<file> 匿名只读（手机 <img> 不带 cookie），只应放非敏感截图；详见 SECURITY.md。
mobile-src/ 是 fork：不跟随 dsh-palm 上游；需要上游修复时按 UPSTREAM.md 手工 cherry-pick 并重建 bundle。
实测环境：桌面 Chromium 与 Android 夸克浏览器；其它 WebView 未系统验证。

License（分层）

本仓库是混合来源，按目录分层授权：

范围	许可证	版权
根目录代码（`index.js`、`client.js`、`assets/theme.css`、注入脚本、`docs/` 等）	MIT（见 LICENSE）	dsh-mobile contributors
`mobile-src/`（手机 UI 源码，fork 自 dsh-palm v1.6.0）	Apache-2.0（`mobile-src/` 适用同一份 Apache 全文：根目录 LICENSE-APACHE 与 `mobile-src/LICENSE-APACHE` 内容一致）	© Eternalloveone / dsh-palm 及上游归因方
依赖的 dsh 平台包（`@deepseek-ai/dsh-*`）	Apache-2.0	DeepSeek

归因链保留在 NOTICE：dsh-palm → dsh-remote-web-ui（@linxin666/dsh-remote-web-ui，Apache-2.0）。mobile-src/ 的 baseline、构建方式与本地改动见 mobile-src/UPSTREAM.md。

致谢

这个项目站在别人肩膀上：

dsh-palm（© Eternalloveone，Apache-2.0）—— 手机端 UI 直接来自它的 v1.6.0；我们 vendor 到 mobile-src/ 后做了本地修改（清单见 mobile-src/UPSTREAM.md）。
DeepSeek Harness（Apache-2.0）—— 宿主平台与 @deepseek-ai/dsh-* 服务。

安全

公开部署前请阅读 SECURITY.md：必须 HTTPS 反代、设备 cookie 等同登录态、/m/shot/ 匿名可读、固定配对码（如果你的配置里设了）务必改掉。

dsh-mobile-web

Install

Source

Tags

Creators

Readme