agent-mobile/dsh-mobile

dsh-mobile

面向 AI Agent 工具的移动端配套仓库：当前适配 DeepSeek Harness（dsh），OpenClaw / ZCode 等陆续接入。包含两部分：

| 目录 | 内容 | 版本 |
| --- | --- | --- |
| dsh_mobile_app/ | Flutter 手机 App：在手机上使用 dsh agent（聊天、审批、语音） | 1.0.99 |
| dsh_dart_sdk/ | 纯 Dart SDK：手写镜像宿主 /api 线协议（dsh-client-connection / dsh-host-apiproxy 的 Dart 对应物） | 0.1.0 |

App 不依赖任何 fork：配合官方 dsh + 两个服务端插件即可使用——

- dsh-mobile-gateway：局域网访问 + token 门控 /m/api（必需）
- dsh-speech：ASR / TTS / 实时转录（语音功能需要）

高光：扫码配对 · 一键连接 · 工具审批 · 语音对话 · 实时转写

| 工具调用审批 | 语音对话（ASR + TTS） | 实时转写 |
| --- | --- | --- |
|  |  |  |
| 工作区外写入先弹审批卡，点「允许一次」继续，拒绝即不动 | 对它说话实时转写，AI 流式回复并语音播报 | 长段落逐句出稿、带说话人标签，一键发送到对话 |

快速上手

1. 服务端（电脑）：安装 dsh 与插件，配一个 token：

npm install -g @deepseek-ai/dsh
dsh plugin --profile web add github:agent-mobile/dsh-mobile-gateway
dsh plugin --profile web add github:agent-mobile/dsh-speech   # 语音功能需要

在 ~/.dsh/profiles/web/cordis.patch.yml 中为两个插件各配同一个 token：
- id: mobile-gateway
config: { token: 换成一个长随机串 }
- id: speech
config: { token: 同上 }

dsh web
启动行会打印局域网地址，例如:
dsh web: http://127.0.0.1:3080 (LAN: http://192.168.1.5:3080)

首次启动 Windows 会弹防火墙授权，勾选专用网络放行。

2. 手机端：与电脑连同一 Wi-Fi。

- 直接安装：从 Releases 下载最新 APK 安装（系统会要求允许安装未知来源应用）
- 打开 App，填服务器 http://:3080 与 token（或在电脑浏览器打开 http://127.0.0.1:3080/m/ 生成 token 与配对二维码，App 扫码自动填入）

从源码构建

- Flutter 3.41+ / Dart ^3.11（App）；纯 Dart ^3.11（SDK）
- Android 构建：Android SDK 35 相关工具链

git clone https://github.com/agent-mobile/dsh-mobile.git
cd dsh-mobile

SDK 单测
cd dsh_dart_sdk && dart pub get && dart test && cd ..

App（会连同 path 依赖 ../dsh_dart_sdk 一起拉起）
cd dsh_mobile_app && flutter pub get && flutter test
flutter build apk --release
产物: build/app/outputs/flutter-apk/app-release.apk

仓库里的 build_apk.ps1 是维护者在本机（网络受限、使用本地 Gradle/JDK）的构建脚本，外部贡献者不需要它，走上面的标准 flutter build apk 即可。

文档索引

- 语音对话 · 实时转写 · 远程组网 完整指南：文字/语音模式切换、实时转写、dsh-speech 语音链路配置、局域网 / 蒲公英 / WireGuard 组网
- App 功能与开发说明
- Dart SDK 用法
- SDK-0.1.2-MIGRATION.md：dsh 0.1.1 → 0.1.2 的 /api 协议变化与 Dart 侧映射（改协议先读这份）

版本对齐

宿主 dsh 0.1.2-rc.1 ↔ 两个插件 0.1.2-rc.1 devDeps ↔ SDK 手写协议 0.1.2。宿主升级涉及 packages/client/connection 或 packages/host/apiproxy 的变更时，需要同步更新 Dart SDK 与其测试。

许可证

MIT