dsh-pager

dsh-pager

DeepSeek Harness 的"寻呼机"：一个 DSH 插件，加一个约 53 KB 的安卓 App；iPhone 把网页添加到主屏幕即可。 人不在电脑前，也能看进度、看改了哪些文件、发指令，并在通知栏里直接批准或拒绝。默认仅同步 DSH 自己的项目和对话；电脑上的 Claude Code / Codex 接入为显式开启的可选功能（见 docs/claude-code-codex.md）。

非官方社区项目，与 DeepSeek 没有关联。· English

MIT · Android 10+ · iOS / iPadOS 16.4+（主屏幕 Web App） · Windows & macOS 宿主 · DeepSeek Harness 0.2.1 / 0.1.1-rc.2 · Node.js 22+ · dsh-plugin

_{截图来自演示模式（node plugin/dev.mjs --demo），数据全部是虚构的；演示包含可选的外部 Agent 接入，实际部署默认关闭。}

---

界面更新

1.6.2 跨平台完整版（Windows / macOS 宿主 + Android / iPhone / iPad）：安卓与 iPhone 主屏幕 Web App 双端互通、三种语音交互（录音转文字 / 语音消息 / 实时语音通话）、运行中发消息「修改 / 引导 / 等待」三选一待发栏、Windows 与 macOS 原生桌面文件操作与区域截图/OCR/翻译、异步提问、原聊天自动任务与恢复、中文社区市场、上下文灰字智能建议。

先按完整扩展安装说明注册各模块；语音与社区市场需分别安装随仓库提供的固定版本扩展。APK 不捆绑电脑服务、语音模型、第三方播放器或私人配置。详见更新记录。

首页“插件”进入手机、平板插件市场：中文分类搜索、星标/下载排序、详情和电脑端安装回执。

手机和平板现可在输入框下方切换“只读 / 工作区写入 / 完全访问”，并远程浏览 Windows 磁盘或 macOS 主目录/桌面/文稿/磁盘卷创建工作区；电脑本机界面新增原生文件夹选择并添加工作区入口。用法及维护说明见 会话权限与电脑文件夹。

当 DSH 正在执行任务时，无论从手机端还是桌面端发送文字或语音消息，都会进入输入框上方的待发栏，提供 修改（编辑内容）、引导（立即插话送入当前运行回合）、等待（保持排队等当前回合结束后自动发送）三项选择。

有新版界面时，首页顶部会显示「界面有更新，点这里更新」。点击一次更新这台设备的整套界面，所有对话都生效；手机、平板分别更新一次。

旧界面首次升级：在首页点击「已连接」→「更新界面并重连」。之后可以使用首页的新版提醒。界面只在可见、联网时检查更新，不会自动刷新或打断播放；更新会保存文字草稿，待发送图片和进行中的消息操作需要先处理。

安卓安装包升级单独显示「App 安装包有新版本」。它仍使用系统安装确认；仅更新界面无需重新安装 APK。

为什么做它

DSH 的 Web 界面是为桌面设计的，直接拿手机打开会遇到三个问题：

1. 界面挤：侧栏、工具面板占满屏幕，输入框被挤走。
2. 流量大：打开一个长会话，要先下载几 MB 的原始事件，其中 89% 是逐字流式碎片，另外每轮还带着整段系统提示词。
3. 锁屏就失联：任务跑完、出错、停下来等你批准，都要你自己打开页面才知道。

dsh-pager 分别对应三件事：一套为手机重写的界面，在电脑上先折叠再下发的接口，以及常驻后台的提醒。

它是什么

安卓 · dsh-pager App（约53 KB：WebView 外壳 + 常驻通知服务）
iPhone · 同一个界面，Safari "添加到主屏幕"（网页推送做锁屏提醒）
   │   你已有的远程通道：国内云服务器上的登录网关，或异地组网（与翻墙无关）
   ▼
DSH web（仍只绑 127.0.0.1，不改 DSH 源码）
   └─ 插件 dsh-pager，挂在 /m
        ├─ /m/                 手机界面（由电脑提供，更新后在设备端刷新）
        ├─ /m/api/boot         工作区 + 会话列表（约 2 KB）
        ├─ /m/api/history      在电脑上折叠后的历史（4 MB 级 → 20–30 KB）
        ├─ /m/api/events       实时帧（流式文字每 90 ms 合并一次）
        ├─ /m/api/notify       后台提醒流（120 秒心跳，断线补发）
        ├─ /m/api/call|fs|raw  结果查看器：完整 diff 和输出、工作区文件、图片视频（只读，限工作区内）
        ├─ /m/api/push/*       iPhone 锁屏提醒（网页推送，端到端加密）
        ├─ /m/api/agents/*     Claude Code / Codex：钩子入口、会话记录、从手机继续
        ├─ /m/api/app/*        App 内更新（安装包在你自己的电脑上）
        ├─ /m/api/usage        用量：token、缓存命中、上下文占用、耗时（读 DSH 自己记的数）
        ├─ /m/api/commands     快捷指令（存在电脑上，所有手机共用）
        └─ /m/api/rpc|respond  发消息 / 停止 / 换模型 / 审批 / 回答提问（白名单）

历史真机实测（旧版本）

1.6.1 已通过公开包签名兼容性与主机回归检查；本轮没有连接实体手机/平板，不把旧版体验当作新版完整设备验收。

实测环境：Redmi（HyperOS / Android 16）与华为平板（HarmonyOS 4.2），经公网链路连回家里电脑（2026-09-21 至 09-22）。

同一套 App 还在华为平板上跑通了首次配置、地址校验和后台服务。

亮点

• 真正的后台提醒：通知走一条独立的低频流（120 秒一次心跳，比界面用的实时流省电得多），由前台服务托着，Wi-Fi 和流量互切时立即重连。
  • 任务完成、出错、Agent 提问、工具审批都会提醒；审批可以直接在通知栏点"允许"或"拒绝"，点通知会打开对应会话。
  • 断线期间漏掉的提醒按序号补发（6 小时内）；待处理的审批和提问，每次连上都会重发。
  • 不依赖 Google 推送（FCM），国产系统（HyperOS、HarmonyOS）照样能用。开机、升级后自动恢复需要系统允许 App"自启动"（这两个系统默认不允许，见 docs/android.md）。
  • iPhone 走网页推送（iOS 16.4+），内容端到端加密，苹果的推送服务看不到内容。
• 结果查看器：在手机上看完整的改动对比（逐行 diff）和命令输出，浏览工作区里的文本、Markdown、图片、视频。只能看该对话所在工作区里的文件；密钥、证书、.env、名字带"密码"等的文件不显示，内容里有私钥的文件拒绝打开。
• 成片直接看：最终回复里的视频路径会生成对话内播放器；其他文件路径点开所在文件夹并标出对应文件。中文、空格、Markdown 链接及 file URI 均可识别，文件仍限会话工作区。建议成片使用 H.264/AAC MP4，具体播放格式取决于设备的 WebView。
• 持久的流畅播放：固定插件支持所有 DSH 工作区，无需为某条任务创建临时播放器。电脑有 FFmpeg 时，大视频默认生成最长边1280、30帧、限码率的预览并缓存；可切换原画。预览与原画都支持按需加载和拖动，源文件保持原样。首次准备完成后会复用缓存，重启不会丢失；未安装 FFmpeg 时使用原画。
• 结果简洁显示：每轮中间说明、思考和工具记录收进一个“查看过程”，默认只显示最终结果；运行状态、出错、审批和提问仍能看到。
• 手机与平板共用更新：电脑更新插件后，打开首页连接状态，点“更新界面并重连”即可加载新界面；已有旧界面可从最近任务关闭 App 后再打开。无需为界面改动重装 APK。

- **Claude Code / Codex 也能管（可选，默认关闭）**： - 离开电脑时，它们的确认请求发到手机：电脑锁屏或 3 分钟没人操作就算离开，一回到电脑就交还。 - 完成时提醒；手机上能看它们的会话记录，也能从手机继续对话。 - **通知栏就能处理**： - 允许（需先解锁）或拒绝； - 选择题直接点选项； - 完成后直接回复下一条指令。 - **App 内更新、分享到 DSH**：电脑上有新版本时，手机点一下就更新，不用再插线；在其他 App 里"分享"文字和图片给 DSH，选好对话即可。 - **用量**：每个会话的 token、缓存命中率、上下文占用、耗时和输出速度，以及最近 7 天的汇总（对话菜单"用量"、连接面板"最近 7 天用量"）。上下文用到 70% 以上时，对话标题下会提示，该考虑开新对话了。数据是 DSH 自己记的，插件只是读出来。 - **桌面小组件**（App 1.4.0）：不打开 App 就能看到"2 个等你确认 · 1 个在跑"、连接状态和最近完成的任务；数字由电脑推送，小组件自己不联网。 - **快捷指令**："跑测试""总结改动"这类常用的话存在电脑上（`~/.dsh-pager/commands.json`），所有手机共用；输入框旁点 ⚡ 选一条就填进去，看一眼再发。 - **省流量**：插件在电脑上把原始事件折叠成"用户消息 / 回复 / 每个工具一行 / 回合结束"，再压缩下发。 - **界面热更新**：界面跑在电脑上，App 只是外壳。改完界面，手机下拉刷新就生效，不用重装。 - **受限接口**：手机接口挂在 DSH 自己的 Web 服务上；本机截图使用独立回环端口、Origin校验及随机票据。不会替你把服务绑定到公网。 - 接口沿用 DSH 同款信任栅栏（Host / Origin / 跨站检查）。 - RPC 使用显式白名单；权限、文件夹、计划与提问使用专门校验接口，不提供任意设置或密钥写入入口。 - **不绑定通道**：走你已有的登录网关或异地组网，不内置第三方隧道或中继。流量不经过别人的服务器，用国内云服务器就能全程国内直连（作者自用的就是这样）。 - **基础界面复用 DSH 线协议**；新增桌面、模型及任务扩展使用宿主 SDK/插槽。DSH 升级须重新检查兼容性。 - **小而可审计**： - 手机界面为原生 JS/CSS；基础 HTTP 服务使用 Node 内置模块，扩展复用 DSH SDK。可选语音和市场另有第三方依赖及许可。 - App 使用 Java、无 Gradle，构建步骤和签名要求见 Android 文档。

与同类项目对比

数据取自各项目的 README 和最新 Release（截至 2026-09-21）。"未提及"只表示 README 里没找到相关说明，不代表一定没有这个功能。

我们的定位：不是把桌面界面搬到手机上，而是做一个"寻呼机"。你锁屏时它替你盯着，需要你时叫你，点开就能处理。所以我们优先保证三件事：体积最小、流量最省、后台提醒最可靠。认证和隧道交给你已有的、更专业的工具。

目前的不足：

• 不内置认证和隧道。你需要自己有一条连回家里电脑、带认证的通道：国内云服务器上的登录网关（作者自用，全程国内直连），或者异地组网工具。见 docs/remote-access.md。
• iPhone 是网页版（添加到主屏幕）：通知上不能直接批准，要点开进 App 处理；目前只在电脑浏览器上端到端验证过推送，真机 iPhone 还没测。
• 只覆盖 DSH 的常用功能：看会话、发消息（可带图）、停止、切模型、审批、回答提问、待办、排队消息、看结果和工作区文件。目标、计划模式、终端还没有。
• 暂时只能连一台电脑（可以在 App 里切换地址）。

快速开始

1. 在电脑上装插件

要求：DeepSeek Harness 0.1.1-rc.2（已验版本）（在 0.1.1-rc.2 上验证），Node.js 22 及以上。

git clone https://github.com/wg5759/dsh-pager.git

把 plugin/ 目录链接进 DSH profile 的 node_modules，名字用 dsh-pager：

:: Windows（目录联接，不需要管理员权限）
mklink /J "%USERPROFILE%\.dsh\profiles\web\node_modules\dsh-pager" "C:\path\to\dsh-pager\plugin"

# macOS / Linux
ln -s /path/to/dsh-pager/plugin ~/.dsh/profiles/web/node_modules/dsh-pager

在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加：

- insert:
    - id: mobile
      name: 'dsh-pager'

重启 DSH web，然后在电脑浏览器打开 http://127.0.0.1:3080/m/，能看到会话列表就说明插件装好了。

想卸载，删掉这几行 patch 再重启即可，DSH 会完全恢复原样；可选桌面入口随相应扩展卸载；不会将电脑界面替换成手机界面。

2. 让手机能访问到

DSH 本身没有登录功能，所以千万别把它直接暴露到公网。常见做法有两种，都不需要翻墙，详见 docs/remote-access.md：

• 带登录的网关（推荐，作者自用）：在一台国内云服务器上放一个带登录页的反向代理（登录页 + Cookie 方式），再通过隧道（如 WireGuard）连回家里电脑。全程国内直连，手机上不用装任何额外软件。
• 异地组网（如 EasyTier、ZeroTier、Tailscale、自建 WireGuard）：把手机和电脑连进同一个私有网络，再用自带的 tools/forward.mjs 把 DSH 转发到电脑的组网地址上。它会拒绝监听公网地址和通配地址。
  • 这类工具技术上也叫"VPN"，但作用只是把你自己的设备连在一起，和翻墙无关。
  • 部分工具的协调服务器在海外，国内可能连不稳。想全程国内，就选能自建节点的方案。

如果手机访问时用的地址不是回环地址，要在插件这一行加上 trustedHosts：

- insert:
    - id: mobile
      name: 'dsh-pager'
      config:
        trustedHosts: ['100.64.0.5:8080']   # 手机访问时用的 host:port

3. 在手机上装 App

从 Releases 下载最新的 dsh-pager-v<版本>.apk，下载后请核对 SHA256SUMS，也可以按 docs/android.md 自己编译。

首次打开会让你填服务器地址，例如 https://pc.example.com:8443 或 100.64.0.5:8080，填完即可使用。

要收到后台提醒，还需要三个设置：

• 允许通知；
• 把电池 / 省电策略设为"无限制"。HyperOS 默认的"智能限制"会在息屏后切断后台联网；
• 允许"自启动"，否则手机重启或 App 升级后，要手动打开一次 App 才恢复提醒。

以后想换地址，点界面顶部的连接状态，选"切换服务器"。

iPhone / iPad（iOS 16.4+）：用 Safari 打开 https://你的地址/m/ 并登录，点"分享"→"添加到主屏幕"，从主屏幕图标打开后，点连接状态 →"开启锁屏提醒"。详见 docs/ios.md。

4.（可选）接入 Claude Code / Codex

node tools/install-hooks.mjs claude     # Claude Code
node tools/install-hooks.mjs codex      # Codex（装好后在 Codex 里输入 /hooks 信任一次）

详见 docs/claude-code-codex.md。

安全须知

• 能在手机上发指令，就等于能让电脑执行命令（受 DSH 自身审批策略约束）。所以远程通道必须有你信得过的认证：带登录的网关，或者只有你自己设备的异地组网。
• 手机接口不另开监听端口，也不改变 DSH 的绑定地址；显式调用本机截图时使用带随机票据的独立回环服务，/m/api/* 沿用和 DSH 相同的 Host / Origin / 跨站检查。trustedHosts 里写错的条目会让插件在加载时直接报错，而不是悄悄放行。
• App 本地只存服务器地址、网关 Cookie（如果有）和提醒序号；日志只记连接状态和帧类型，不记内容和凭据（adb logcat -s DSHNotify）。
• 没有统计、没有第三方 SDK、不依赖 Google 服务；公开版 APK 关闭了 WebView 远程调试（1.2.1 起）。
• 结果查看器只读，且只能读该对话所在工作区里的文件（符号链接、目录联接指到外面的也会被拦住），并隐藏密钥类文件。它不会识别普通文档里写的密码。
• iPhone 推送的签名密钥和设备列表保存在电脑上的 ~/.dsh-pager/，不在代码仓库里。
• Claude Code / Codex 的钩子凭 ~/.dsh-pager/hook.json 里的随机令牌与插件通信，令牌只在本机。从手机继续对话时，消息作为一个整体参数交给命令行工具，不经过 shell。
• App 内更新：安装包从你自己的电脑下载，先校验 SHA-256；Android 只接受同一签名的更新，并且每次都要你确认。

开发

cd plugin && npm test                 # 手机/HTTP回归，含RFC 8291测试向量
node --test tools/*.test.mjs          # 转发器、钩子安装器单测
node tools/make-icons.mjs             # 重新生成网页 App 图标
node plugin/dev.mjs                   # 独立开发服务器 http://127.0.0.1:3090/m/，直连本机 DSH，改服务端代码不用重启 DSH
node plugin/dev.mjs --demo            # 演示模式：假的 DSH 后端 + 虚构的项目和会话，不需要 DSH，也不会显示真实数据
node tools/screenshots.mjs            # 用演示模式和无头 Chrome / Edge 重新生成 docs/img/ 下的截图
bash android/build.sh public          # 编译 App（无 Gradle，需 Android SDK build-tools 34 + JDK 17）

界面文件（plugin/www/）保存后即时生效；index.js / server.js / fold.js / notify.js 改动后需要重启 DSH。DSH 的线协议笔记见 docs/dsh-protocol-notes.md。

手机和平板的已完成长回复（超过 600 个字符或 12 行）默认显示原文开头的短摘要，点“查看完整结果”展开全部内容；视频卡片和工作区文件的“所在文件夹”入口始终可见。展开状态在当前会话页面内保留，展开/收起不重建播放器，复制仍取完整回复。短回复和出错、停止的结果直接显示。此项仅修改 /m 前端，更新界面即可获取，无须重启 DSH 或重新安装 App。

plugin/     DSH 插件：index.js 挂载 · server.js 接口与实时桥 · fold.js 事件折叠 · notify.js 提醒中枢
            files.js 结果查看器（只读、限工作区）· push.js 网页推送 · commands.js 快捷指令 · www/ 手机界面、Service Worker、Web App 清单
            agents.js Claude Code / Codex 钩子中枢 · presence.js 是否在电脑前 · transcripts.js 读它们的会话文件
            demo/ 演示模式（fake-dsh.mjs 按 DSH 线协议提供虚构数据）
android/    App 外壳：MainActivity（WebView、首次配置、App 内更新、分享）· NotifyService（后台提醒）
            UpdateReceiver · BootReceiver · build.sh
tools/      forward.mjs 转发到私有地址 · pager-hook.mjs 钩子命令 · install-hooks.mjs 安装钩子
            make-icons.mjs 生成图标 · screenshots.mjs 生成截图
docs/       远程访问 · Android · iPhone · Claude Code / Codex · DSH 协议笔记

许可与声明

MIT。"DeepSeek"及"DeepSeek Harness"是其各自所有者的商标。本项目是独立的社区插件，没有获得 DeepSeek 的认可或背书，也与其没有关联。

---

English

dsh-pager is a pager for DeepSeek Harness (DSH). It has two parts:

• a ~53 KB Android app (1.6.1);
• a DSH plugin that serves a phone-first UI and API at /m on DSH's own web server.

Together they let you follow sessions, send prompts, and approve or reject tool calls from the notification shade while you are away from your PC. This is an unofficial community project, not affiliated with DeepSeek.

• Real background alerts. A dedicated low-traffic notify stream (120 s heartbeat) is held by a foreground service.
  • Alerts cover turn completion, errors, agent questions and tool approvals, with Allow/Deny buttons on the notification.
  • Missed notices are replayed after a reconnect, and pending approvals are re-sent on every reconnect.
  • There is no FCM or Google services dependency.
• Low traffic. Raw session history is 89% streaming fragments. The plugin folds it on the PC, so a 4 MB session opens as 28 KB (1.45 s over a public network on a real phone).
• No new exposure.
  • DSH keeps binding 127.0.0.1, and no port is opened.
  • /m/api/* applies DSH's own Host/Origin fence, plus a 9-method RPC allow-list.
  • Remote access is left to your own authenticating gateway or private network (WireGuard, EasyTier, Tailscale…); see docs/remote-access.md. DSH has no login, so never expose it publicly without one.
• Small and auditable.
  • Core mobile HTTP code uses Node built-ins; optional extensions have documented dependencies.
  • A vanilla JS mobile UI that hot-reloads on the phone.
  • A 1,300-line Java shell built without Gradle, with in-app updates served from your own PC.
• DSH-only by default. Only DSH projects and sessions are synced. Claude Code and Codex are an optional, explicit opt-in; see docs/claude-code-codex.md.
• Persistent video previews. Every DSH workspace can deliver local video paths as inline players. With FFmpeg, large videos get cached H.264/AAC previews (1280 maximum edge, 30 fps, capped bitrate), with an original-quality switch. Both support HTTP Range seeking, and completed previews survive restarts.
• Compact completed results. Long completed replies show an excerpt with expandable details. Video players and workspace-file folder buttons stay visible; toggling details keeps the player node and copying returns the full reply. Short replies and error/stop results remain fully visible.

Try the UI without DSH: node plugin/dev.mjs --demo serves made-up projects and sessions from a fake DSH at http://127.0.0.1:3090/m/ (the screenshots above come from it).

Quick start:

1. Link plugin/ into ~/.dsh/profiles/web/node_modules/dsh-pager.
2. Add - insert: [{ id: mobile, name: 'dsh-pager' }] to cordis.patch.yml and restart DSH.
3. Make /m/ reachable from the phone through an authenticating gateway or a private network.
4. Install the APK from Releases and enter your server address.

MIT licensed.