鲸灵语音宠物 regrevia/dsh-pet-voice

鲸灵 · 随身宠物

一只住在你电脑里的像素鲸鱼娘。屏幕和麦克风在你手上，大脑跑在你自己电脑上的 DeepSeek Harness 会话里。

DSH 的 App 端，还融合了桌宠玩法：语音唤醒、随口说话、语音指挥。远程操作电脑上的 DeepSeek Harness 有三种连法——局域网、自建域名、服务器中转；也能直接和工作在项目里的小鲸鱼聊天，一句话指挥它干活。出门在外，再也不用担心没带电脑。

不运营任何服务器、不用注册账号，会话与记忆都在你自己电脑上。APK 是 30 MB 的 Android 自签名包，装完扫码就能用。

三步用起来

1. 电脑上装插件

rsync -a --delete plugins/dsh-pet-voice/ ~/.dsh/plugins/dsh-pet-voice/
然后重启一次桌面端，让它重读 cordis.patch.yml

装好后桌面端侧栏出现「大肥鱼」，点开是它的面板。

2. 电脑上出配对码

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

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

3. 手机上扫码

装 APK（Releases）→ 首页「扫码绑定」→ 扫上一步的二维码 →「立即对话」。
悬浮窗出现后，说「大肥鱼」唤醒，或者直接点它说话。

第一次用、什么都没有？照 docs/quickstart.md 走一遍。

三种连法

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

| 连法 | 适合 | 需要 | 面板选哪档 |
| 局域网 | 手机和电脑同一个 WiFi | 无 | 局域网 |
| 自建域名 | 长期用、自己有域名 | 一台能跑 nginx/caddy 的机器 + 证书 | 自建域名，填自己的域名 |
| 服务器中转 | 在外面也想用，不想碰路由器和证书 | 装 cloudflared / ngrok，或自己的中转服务器 | 自建域名，填工具给的 https 地址 |

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

现在能用吗

| 项 | 状态 |
| APK | 0.9.33（versionCode 103），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。

它能做什么

- 说停就停：尾静音 1 秒判定说完；悬浮窗里可以连续对话。
- 回复一定到：先试长连接，拿不到立刻转轮询；断网期间的话不会丢。
- 动作有反馈：听、想、说、待机四种状态各有动作，时长按素材走。
- 能指挥项目：手机上直接切项目、切人设、开新会话，语音就把活派出去。
- 8 套衣服：水手裙 / 女仆装 / 鲸鱼卫衣 / 冬日斗篷 / 深海公主 / 深海研究员 / 星潮小魔女 / 泡泡睡衣。
- 面板可配：连法、人设、输出长度、气泡开关、唤醒词都在插件面板里改。

手机上的对话页

它怎么工作

手机（悬浮窗 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/dsh-pet-voice/ DSH 插件：/pet-voice/ 页面、语音闭环、配对、更新通道 android/ Android 客户端（Kotlin，零 androidx） docs/ 契约、安装、自接入、真机、架构 scripts/ 自测、验收、素材生成、发布

许可

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

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