MobileVC

MobileVC

MobileVC-style mobile / PWA surface for DeepSeek Harness.

中文 | English

MobileVC 给 DSH 加一个手机端界面：连上你正在跑的 DSH，直接看会话、发消息、打断、审批、传图片/文件、管理插件。

它不是第二个 Agent，也不是另一套 relay/session。所有读写都走 DSH 的 sessionController，一套会话，一套运行时。

• 版本：0.1.0
• 验证环境：DSH 0.2.0-rc.2、Node 22+
• 形态：DSH Host plugin + 静态 PWA UI
• 官网：https://mobilevc.top/
• 截图：docs/images/
• 演示：docs/media/mobilevc-demo.mp4
• 宣传片：docs/media/mobilevc-promo.mp4

B 站宣传片

新版宣传片

功能

• 真实会话：读取 DSH 的会话列表、历史、工具调用
• 实时流：sessionController.follow() + assistantStream，逐 token 的思考/正文
• 思考卡：执行中显示“正在思考”，结束后变成可折叠的“深度思考 · N 字”
• 工具卡：默认折叠，显示工具名/参数/状态，点开看完整输出
• 图片预览：read_image 从 DSH attachment store 读原图，缩略图 + 全屏
• 附件：图片作为 image part；文件通过 fileUploads receipt 发送
• 直接审批：手机 presence 优先；断流/切后台也能接住；另一端已处理时点击自动失效
• 执行迹：用户 → 思考 → 工具 → 回复 → 压缩的 timeline；默认简洁模式，按思考/工具链分组，英文原文和工具参数折叠，可切「完整」
• 文件：真实工作区，面包屑 + 逐级浏览
• 插件管理：真实 pluginManager 列表与开关
• 账号余额：底部实时余额；余额不足自动打开 DeepSeek 官方充值页
• 后台任务：显示 DSH jobs，查看输出、停止；长命令不再只能前台干等
• Web Push：完成 / 失败 / 审批通知；iPhone 需 iOS 16.4+ 并加到主屏幕
• 执行中插话：队列展示、修改、删除、立即插话
• PWA：主屏幕安装、standalone、safe-area、竖屏锁定、禁双指/双击缩放
• 不掉记录：SSE 断开自动重连 + durable 轮询兜底，新回复不需要手动刷新
• 错误可见：额度/模型失败变成错误卡，不再静默

截图

对话 · 执行迹 · 插件 · ·

更多：docs/images/sessions.png、docs/images/files.png、docs/images/image-preview.png。

安装

需要一台已经能跑 DSH Web 的机器。

作为 DSH bundle（推荐）

dsh plugin --profile web add "github:JayCRL/MobileVC"
systemctl restart dsh-web

或者本地 clone：

git clone https://github.com/JayCRL/MobileVC.git mobilevc
dsh plugin --profile web add ./mobilevc
systemctl restart dsh-web

打开：

http://127.0.0.1:8898/mobilevc/

健康检查：

curl http://127.0.0.1:8898/mobilevc/api/health
# {"ok":true,"plugin":"mobilevc","interactive":true}

自部署边缘（可选）

如果你想把“反代 + 登录 + Cloudflare Tunnel”一起交给用户，edge/ 目录提供 Caddy + 可选 cloudflared 的 compose：

cd edge
cp .env.example .env
./hash-password.sh
docker compose --profile tunnel up -d

详见 edge/README.md。它只封装入口，不包含 DSH 或 Agent runtime。

完整部署、nginx、PWA、升级/卸载、排错：INSTALL.md。

/mobilevc/ 没有独立登录页，必须放在认证 HTTPS 反向代理后面。

使用

• +：发送图片或文件
• Enter 发送，Shift+Enter 换行
• 运行中，发送键右侧红色停止按钮：打断当前 turn
• 运行中发消息：进入插话队列，自动打开面板，可修改 / 删除 / 立即插话
• 横屏：显示竖屏提示，不切桌面横向布局
• 点工具卡：展开输出
• 点 read_image 缩略图：全屏
• 迹：执行 timeline
• 插件：DSH 插件管理
• Memory：读写真实 AGENTS.md
• 审批卡：拒绝 / 允许一次
• 设置 → 通知 → 开启：启用 Web Push；测试可发一条测试通知

通知（Web Push）

• 触发：任务完成、任务失败、等待审批、后台任务结束
• 不需要公网 IP：DSH 主机主动向 Apple/Google 推送服务发起 HTTPS
• iPhone：iOS 16.4+，必须“添加到主屏幕”后从图标启动，Safari 标签页不支持
• 通知里不包含完整会话内容；点击打开 MobileVC
• 页面正在前台时不会重复推送，离开后由 Web Push 接管

架构

flowchart LR
  B[Phone / PWA] -->|HTTPS + SSE| P[MobileVC host plugin]
  P --> S[ctx.sessionController]
  P --> F[ctx.fileUploads]
  P --> A[approval/request answerer]
  P --> M[ctx.pluginManager]
  S --> L[(DSH session log)]
  F --> O[(DSH attachment store)]

• /mobilevc/api/follow → sessionController.follow({ assistantStream: true })
• /mobilevc/api/prompt → sessionController.prompt()；图片直接作为 image part，文件先 fileUploads.uploadStream() 换 receipt
• /mobilevc/api/approval → 手机 presence answerer；没有活跃 follow/presence 时 next() 交回桌面
• /mobilevc/api/queue → resolveAgent().inbox 列出插话，updateQueue() 修改/删除/steer
• /mobilevc/api/plugins → pluginManager
• 页面和 API 同源，不需要 CORS

远程访问 / 没有公网 IP

浏览器不能直接连进 NAT 后的 DSH。两种做法：

1. 自己/朋友：Cloudflare Tunnel 或 Tailscale，把本机 8898 变成一个可达 URL；不改代码
2. 产品化：中心 Relay + mobilevc-connect 插件，DSH 主动外连；Relay 只做透明隧道，不存 session

当前仓库只提供 Host plugin 和 UI，不内置 Relay。

安全

/mobilevc/ 由 Host plugin 注册，不走 DSH /api 的 browser-trust fence。它可以：

• 读所有会话、日志、工作区文件
• 发消息、停止、审批
• 写 AGENTS.md
• 上传图片/文件
• 启用/禁用 DSH 插件

所有登录用户共享同一个 DSH 身份，没有多租户隔离。公网必须使用认证 + HTTPS，不要把 8898 裸露。

方向

• 发布正式版本 / release
• 执行迹细化：step 分组、工具耗时
• 附件体验：粘贴、相机、拖拽
• 插话队列的键盘、滚动和多条消息体验
• 可选原生壳复用同一套 PWA/HTTP surface；不引入第二套 runtime

不做：重写 Agent loop、在插件里再塞 relay/E2EE、单 DSH 进程内做多租户隔离。

与旧版 MobileVC 的关系

旧版是 Flutter 客户端 + Go relay + E2EE。它保留在 legacy/，也保留在 git 历史里，但不再是默认客户端。

转向 DSH 的原因很简单：DSH 已经提供 Agent runtime、durable session log、follow 流、审批和插件系统。继续维护 Flutter + relay，等于在 DSH 之外再维护一套 session/queue/runtime，这会重新引入同步和队列问题。

现在只保留一层：

DSH owns the runtime. MobileVC owns the surface.

旧版仅作历史参考；新部署请使用上面的 DSH 安装方式。

License

MIT — see LICENSE.