随身连 Wade300/dsh-pocket

DSH Pocket · 随身连

DeepSeek Harness（DSH）的原生 HarmonyOS 客户端，用 ArkTS/ArkUI 编写，不用 WebView。

手机通过 WebSocket 连一个小型 Node 桥接服务。桥接服务用 ACP JSON-RPC 与 PC 上的 dsh --profile acp 通信。这样手机就能列出会话、流式接收回复、显示工具卡片、应答权限请求。

状态：实验性。已在 HarmonyOS NEXT（API 26）和一台折叠屏手机上测试过。难免有粗糙之处。

使用手册 · 安装 · 架构 · 排错 · 安全

功能

- 原生 ArkUI 聊天界面，不内嵌浏览器。
- 会话列表、恢复会话、新建会话、选择模型。
- 流式 Markdown：标题、列表、引用、代码围栏、表格、行内样式和链接。
- 工具调用以卡片显示，权限提示，用量行。
- 复制消息、引用回复、编辑已发送的提示词、复制代码块。
- 会话搜索和时间戳。
- 历史分页：首次打开加载最新 10 条消息；滚到顶部加载更早的页。
- 本地缓存最后打开的窗口及其最新 10 条消息；重启后网络就绪前窗口就能回来。
- 首次连接成功后，自动连接上次可用的 URL。
- 会话文件夹和隐藏会话跟随 PC 上的 ~/.dsh/storages/workspace.json。
长按会话可隐藏或取消隐藏，改动会写回 PC 上的文件。
- 三折叠布局：紧凑栏、中等分栏、展开列表 + 聊天。
- 固定桥接 token，同时只允许一个活动连接，同一 IP 输错 10 次 token 封禁一小时。

工作原理

┌──────────────────────┐ WebSocket / JSON-RPC ┌──────────────────────┐
│ HarmonyOS app │ ws:// or wss:// .../ws?token=... │ Node bridge │
│ ArkTS + ArkUI │ ─────────────────────────────────► │ dsh-native-host.mjs │
└──────────────────────┘ └──────────┬───────────┘
│ stdio JSON-RPC (ACP)
▼
┌──────────────────────┐
│ dsh --profile acp │
│ DeepSeek Harness │
└──────────────────────┘

桥接服务在 ACP 之上加了几个私有方法：

| 方法 | 用途 |
| phone/hello | 桥接服务版本和工作目录 |
| phone/info | 默认 cwd 和平台 |
| phone/history | 重放会话日志，支持 limit / before 分页 |
| phone/titles | 从会话日志读取标题 |
| phone/workspaces | 读取工作区文件夹和隐藏会话 |
| phone/archive | 隐藏或取消隐藏会话，写回 workspace.json |
应用使用的 ACP 方法：initialize、session/list、session/new、session/resume、session/set_config_option、session/prompt、session/cancel，外加 session/update 通知。

环境要求

- PC：Node.js 22 或更高版本；已安装并登录 DeepSeek Harness；PATH 中有 7-Zip，用于历史回放（可选，但推荐）。
- 手机：HarmonyOS NEXT / API 12 或更高版本。项目使用 compile SDK 26，target API 12。
- 构建：DevEco Studio 与 HarmonyOS SDK。签名使用你自己的华为开发者证书。
- 网络：手机和 PC 在同一局域网，或使用 TLS 隧道做远程访问。

快速开始

1. 启动 PC 桥接

在仓库根目录执行：

node host/dsh-native-host.mjs --port 3090

Windows 上可以直接双击 host\start-native-host.cmd。

桥接会打印局域网 URL、配置后的公网 URL，以及二维码页面。固定 token 存放在：

~/.dsh/dsh-pocket-token

删除该文件即可轮换 token，也可以传入 --token <value>。

选项：

--host <addr> bind address (default: auto-detected LAN address)
--port <port> default 3090
--public-url <url> public tunnel URL; forces loopback binding and wss://
--token <value> fixed token (default: read/create ~/.dsh/dsh-pocket-token)
--no-open do not open the QR page in a browser
--list-hosts list local IPv4 addresses and exit

2. 构建并安装应用

1. 在 DevEco Studio 中打开 harmony/。
2. 配置签名：File → Project Structure → Signing Configs，使用你的华为账号。
3. 构建 entry 模块（debug 或 release），安装 HAP。

应用只申请 ohos.permission.INTERNET。

3. 连接

使用桥接打印的 URL，例如：

ws://192.168.1.10:3090/ws?token=<token>

你也可以在 PC 上打开二维码页面（http://<pc-ip>:3090/?key=<token>），用应用扫码。

首次连接成功后 URL 会保存下来，下次启动自动重连。

4. 远程访问（可选）

不要把桥接直接暴露到公网。在它前面放一个 TLS 隧道，并让桥接绑定回环地址：

node host/dsh-native-host.mjs --host 127.0.0.1 --port 3090 \
--public-url https://your-tunnel.example.com

然后让应用连接：

wss://your-tunnel.example.com/ws?token=<token>

公网模式下，/ 的控制页面同样需要 ?key=<token>。

安全

桥接 token 权限很大：拿到它，配对的手机就能驱动 DSH 智能体，在 PC 上运行工具。请像对待 SSH 密钥一样对待它。

- 别让 token 出现在截图、日志和仓库里。
- 优先用 TLS 隧道；不要把明文 ws:// 端口转发到公网。
- 桥接只接受一个活跃 WebSocket；新的有效连接会替换旧连接。
- 同一 IP 在十分钟内出现十次错误 token，该 IP 会被封禁一小时。封禁记录在内存中，重启后清除。
- 公开模式用同一个 token 保护 /；/ws 始终需要它。
- phone/archive 会写入 ~/.dsh/storages/workspace.json；bridge 会保留一份一次性的 .dshpocket.bak 备份。不要对无法恢复的 workspace 文件运行它。
- 本项目未经过审计。暴露之前请先审查代码。

详见 SECURITY.md。

限制

- ACP 只暴露 DSH 的一部分。图片/附件、终端、文件树、预览和计划视图都不可用。
- 历史回放最多保留每个会话最新的 200 条消息；应用每次翻页 10 条。
- 窗口缓存最多存 10 条消息，且每条消息都会截断。它只是图方便，不是离线归档。
- 文件夹/隐藏同步是拉取式的：手机刷新时读取 PC 上的文件，再把隐藏/取消隐藏写回去。它不是实时推送通道。并发写入遵循后写覆盖先写。
- bridge 会先解析完整会话日志，再切出一页；日志很大时，首次打开仍可能很慢。
- HarmonyOS 的 WebSocket 行为在不同版本间有差异。应用在握手时加上 ngrok-skip-browser-warning，用于 ngrok 免费隧道。

项目结构

harmony/ HarmonyOS app (ArkTS, Stage model)
AppScope/ bundle metadata
entry/src/main/ets/ pages, ACP client, Markdown renderer, storage
host/
dsh-native-host.mjs Node bridge, WebSocket server, history and workspace APIs
start-native-host.cmd Windows launcher
vendor/qrcode.js QR rendering (MIT, see vendor/NOTICE.txt)
scripts/build-hap.cmd command-line build helper
docs/ usage, install, architecture and troubleshooting

许可证

MIT。详见 LICENSE。

DeepSeek Harness 及其标识归各自所有者所有。本项目是独立客户端，不是 DeepSeek 官方项目。