鲸灵语音宠物 regrevia/pocket-harness

Pocket Harness · DSH 手机端

把电脑上的 DeepSeek Harness 揣进兜里：会话、项目、工具、目标都还在，手机上点开接着干。

手机端不是另一个 AI 助手：它连的是你自己电脑上那个 DSH，同一条会话、同一份历史、同一批项目。
电脑上派出去的活还在跑，手机上看到的也是「回复中」；电脑上排着的目标、队列、待确认的提问，手机上一样能看到、能回答。
不用注册，不经过作者的服务器，会话和记忆都留在你自己电脑里。

桌宠可选：默认关着，只有你在设置里打开，才会出现一只像素鲸鱼娘——当个会听会说的入口。

手机上要的就是电脑上那一套

| | 云端手机 AI 助手 | Pocket Harness |
| 大脑 | 厂商服务器上的模型 | 你电脑上的 DSH 会话，带着项目、记忆和工具 |
| 历史 | 另一份对话 | 就是电脑上那条会话，切回来还是它 |
| 状态 | 只有「在输入」 | 回复中 / 用时 / 排队 / 目标 / 待确认提问，跟电脑一致 |
| 数据 | 上传 | 配对直连，只走你俩之间那条线 |
| 桌宠 | 无 | 可选，默认关 |

三步用起来

1. 电脑上装插件

rsync -a --delete plugins/pocket-harness/ ~/.dsh/plugins/pocket-harness/
重启一次桌面端，让它重读 cordis.patch.yml

装了 dsh 命令行的话，也可以 dsh plugin add pocket-harness@latest。
装好后桌面端侧栏出现「Pocket Harness」面板。

2. 电脑上出配对码

面板 →「连上手机」→ 选一种连法 → 二维码自己出来（或复制链接）。链接长这样：

https://<你的地址>/pet-voice/?k=<一次性配对码>

3. 手机上扫码

装 APK（Releases）→ 首页「扫码绑定」→ 扫上一步的二维码 →「立即对话」。
不扫码也行：手机上填电脑面板里的地址和 token。

状态一致：手机看到的和电脑上的是同一件事

手机端只有一个会话页，切换会话时把上一轮彻底收掉，表头项目跟着换。当前对齐的几件事：

- 回复中：电脑上还在生成，手机进这个会话就显示「回复中 · 用时」，不用等它出字。
- 接上继续：没等到回复就离开，回来还是同一条在跑、还在出字，停按钮也在。
- 更早的记录：往上翻到顶自动取上一页，不出现「翻不动」。
- 派出去的命令：手机上发的话和电脑上完全是同一批消息，不会出现只有一端才有的行。
- 目标与队列：项目目标只在电脑上编辑，手机上能看；队列里的活两端一致。

桌宠（可选）

设置里打开「显示鲸灵」，它才出现；关掉就只是一个干净的 DSH 手机端。
悬浮窗那只是同一个它，不会出现两只，也不会各说各话。

- 说停就停：尾静音 1 秒判你说完了，不用点发送。
- 动作就是状态：听、想、说、待机四态各有动作，安静下来就是活干完了。
- 8 套衣服：水手裙 / 女仆装 / 鲸鱼卫衣 / 冬日斗篷 / 深海公主 / 深海研究员 / 星潮小魔女 / 泡泡睡衣。

手机上的对话页

还能改什么

连法、人设、输出长度、气泡开关、唤醒词，都在插件面板里改，不用重装。

三种连法

手机和电脑必须能互相访问。开源版默认不使用作者的任何基础设施，代码里没有硬编码的域名或 IP，配置只存在你这台电脑上。

| 连法 | 适合 | 需要 | 面板选哪档 |
| 局域网 | 手机和电脑同一个 WiFi | 无 | 局域网 |
| 自建域名 | 长期用、自己有域名 | 一台能跑 nginx/caddy 的机器 + 证书 | 自建域名，填自己的域名 |
| 服务器中转 | 在外面也想用，不想碰路由器和证书 | 装 cloudflared / ngrok，或自己的中转服务器 | 自建域名，填工具给的 https 地址 |
| 公网 IP 直连 | 域名还没备案，或不想折腾证书 | 一台有公网 IP 的机器 + 反代 + token | 自建域名，填 http://<公网IP>/pet-voice/ |

域名走 HTTPS 需要 ICP 备案（国内机器）或 DNS-01 证书，没备案时 80/443 会被云厂商拦到备案页——这时直接用公网 IP + token，功能一样全。

细节、证书与排错：docs/self-host.md。不想买域名也能 https：docs/tls-self-signed.md。

现在能用吗

| 项 | 状态 |
| APK | 0.9.144（versionCode 214），Android 8.0+（API 26），targetSdk 35 |
| 验证环境 | Android 11 模拟器跑通全链路：配对、语音、回复、动作、历史、检查更新 |
| 真机 | 厂商权限跳转与硬件麦克风只在 AOSP 页面验证过，各家 ROM 仍可能不同，欢迎回报 |
| Android 14/15 | 未做实机验证：后台恢复、麦克风前台服务在收紧后的行为【需真机确认】，见 docs/android-app.md |
| iOS | 不支持（悬浮窗与常听麦克风是 Android 特性） |

内置信任锚：APK 里带了一张示例自签 CA 的公钥证书（res/raw/pet_ca.pem，无私钥），让「不买域名、机器上跑自签 https」的人开箱能连。换成自己的 CA 请跑 scripts/tls-ca.sh 再重新出包；只用系统 CA 的部署不受影响。别人的 CA 不要信，也不要装来路不明的 APK。

它怎么工作

手机（悬浮窗 WebView） 电脑（DSH 宿主进程）说话 ──► /api/asr ──► 识别文本 ──► /api/command ──► 切项目 / 派发 / 停 ──► /api/dispatch ──► 专属会话（人设走隐藏提示词）听 ◄── SSE 增量 / /api/poll 兜底 ◄── 逐字生成念 ◄── /api/tts ◄── 句子级音频

端点、鉴权、帧格式、错误码见 docs/pet-contract.md；手机端实现与限制见 docs/android-app.md。

两条外部依赖：默认语音合成走微软 Edge 的在线语音接口（edge-tts，免 key），手机端唤醒与识别走 Android 系统语音服务（SpeechRecognizer，是否上传音频由系统/厂商决定）。换本地 TTS 或换音色也能用，但这两条链路本身不是纯离线的。

开发与构建

前置：Node.js ≥ 22.15.0（插件静态引用 node:zlib 的 zstdDecompressSync）、JDK 17、Android SDK。

自测（离线部分不碰真实配置）
SKIP_LIVE=1 bash scripts/verify.sh

编 APK（JDK 17，别用 21+）
export JAVA_HOME=/path/to/jdk17/Contents/Home
android/gradlew -p android :app:assembleRelease

产物在 android/app/build/outputs/apk/release/app-release.apk。要发布自己的版本，用同一个 keystore 签名才能覆盖安装、保住配对信息，流程见 docs/android-app.md 的发布一节。

参与开发前请读 CONTRIBUTING.md；安全问题走 SECURITY.md。

目录

plugins/pocket-harness/ DSH 插件：/pet-voice/ 页面、语音闭环、配对、更新通道 android/ Android 客户端（Kotlin，零 androidx） docs/ 契约、安装、自接入、真机、架构 scripts/ 自测、验收、素材生成、发布

许可

代码与文档 MIT。像素素材由本项目生成，同样 MIT。

“DeepSeek Harness” 是它自己的项目，与它的许可证一致；本仓库只通过插件接口与它交互。