dsh-pwa

把 DeepSeek Harness 装进口袋。 为 DeepSeek Harness（dsh）打造的手机优先 PWA：挂在 dsh web 服务的 /m 路径下 —— 会话列表、实时流式对话、审批、Agent 提问、新建会话、发图片，全部可用。手机上零安装：用 Safari/Chrome 打开 → 分享 → 添加到主屏幕 → 全屏 App。iOS 和 Android 都能用。

手机上的 dsh-pwa 会话列表与对话

为什么是 PWA，而不是原生 App？

	dsh-pwa	saya-ch/dsh-mobile	官方 web UI + Tailscale
形态	PWA，手机零安装	安卓原生 App + 插件	桌面优先的网页 UI
iOS	✅（Safari → 添加到主屏幕）	❌（仅安卓）	✅（浏览器打开）
安卓	✅	✅	✅
远程访问	沿用 `dsh web`（局域网 / Tailscale / 任意反向代理）	内建：局域网、Tailscale Funnel、cpolar、cloudflared、FRP	手动 `tailscale serve`
推送通知	❌（iOS PWA 限制）	✅（安卓系统通知）	❌
安全模型	同源 + dsh `trusted-host` 信任围栏	证书固定 + 设备配对	`trusted-host` 信任围栏
维护面	只有静态文件 —— 和桌面 GUI 用同一套 `/api`	原生 App + 插件都要维护	无（官方 UI）

如果你要安卓系统通知和证书固定的设备配对，去看 saya-ch/dsh-mobile。如果你要最轻、iOS 安卓通吃、手机上什么都不用装的方案，就是这里。

功能

📋 会话列表：工作区分组、搜索、下拉刷新、真正的"待办"筛选（待审批 / 待回答）
💬 流式对话：乐观上屏、排队消息可见、按天分隔、时间戳、代码块一键复制、图片全屏查看
✅ 审批、❓ Agent 提问做成可点卡片（危险命令红色二次确认）
🖼️ 发图片：拍照 / 相册 / 剪贴板粘贴，自动按模型限制压缩
➕ 新建会话，可选 Agent 预设
📳 触感反馈、深浅色主题、按会话自动存草稿、连接状态 pill + 手动重连
⚙️ 桌面端自动多出 设置 → 手机端 入口，显示手机访问地址 + 一键复制（不用在手机键盘上敲 URL）

完整 UX 审计过程在 docs/AUDIT.md —— 69 项，全部修复，每项都写了根因。

快速开始

前置：已安装桌面版 DSH（dsh CLI 可用）。

1. 建一个（或复用你现有的）web profile，~/.dsh/profiles/web/package.json：

{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {
    "dsh-pwa": "latest"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-pwa"
      ]
    }
  }
}

还没发 npm 的话，把依赖换成 "dsh-pwa": "github:jackxu925/dsh-pwa"。

2. 安装并启动（手机从外部访问时，把你的访问域名加进信任围栏）：

cd ~/.dsh/profiles/web && npm install
dsh --profile web --host 0.0.0.0 --port 3080 --trusted-host <你的访问域名>

3. 手机浏览器打开 http://<主机地址>:3080/m/ → 分享 → 添加到主屏幕，即为全屏 PWA。

以后升级：npm update dsh-pwa 后重启 dsh web 即可。本插件只挂载静态页面，协议层完全复用 DSH 自带的 /api，跟着你的 DSH 版本走。

原理

服务端只做一件事：把 web/ 下的静态页面挂到 /m（lib/routes.js，自愈式挂载）。
页面直接调用 DSH 自己的 /api —— 和桌面 GUI 完全相同的协议（POST /api/<ns>/<method>、POST /api/respond、ws://…/api/events.mux 下行帧）。零业务逻辑重复。
天然支持 Tailscale：沿用现有的 trusted-host 信任围栏。

改 web/ 下任何文件后刷新页面即可（静态文件按请求读取，无需重启）。

截图

会话列表	对话

路线图

适合贡献者的下一步（来自 docs/AUDIT.md "仍需协议/服务端配合"一节）：

session/list 携带末条消息预览与未读计数
移动端会话管理（长按菜单：归档 / 重命名 / 删除）
排队消息的取消 / 编辑
Web Push：后台时审批 / 提问的系统级通知
Service Worker 离线壳（需先有 https）

完整清单：docs/ROADMAP.md。看中哪个就提 PR —— 先看 CONTRIBUTING.md。

参与贡献

原生 JS，无构建步骤，无框架。web/ 是 App 本体，lib/ 负责挂载，client/ 给桌面端注入设置入口。详见 CONTRIBUTING.md。欢迎 PR，尤其欢迎认领上面路线图里的项。

FAQ

iPhone 能用吗？ 能 —— 这就是它存在的理由。Safari → 分享 → 添加到主屏幕。

手机上要装东西吗？ 不用，就是个网页。

暴露出去安全吗？ 和 dsh web 本身同样的威胁模型：能访问到这个 URL 的人（你的 tailnet / 局域网）就能操作你的 agent。请放在可信网络里，不要挂到公网。

离线能用吗？ 不能 —— 需要实时连到你的 dsh 服务。

DSH 升级会挂掉它吗？ 页面和桌面 GUI 用同一套 /api，插件本身不带任何协议逻辑，所以它跟着你的 DSH 版本走。但 DSH 还在 developer preview，API 有可能出现 breaking change，到时候插件也要跟着更新。

License

MIT — 见 LICENSE。

dsh-pwa

Install

Source

Tags

Creators

Readme

dsh-pwa

为什么是 PWA，而不是原生 App？

功能

快速开始

原理

截图

路线图

参与贡献

FAQ

License