dsh-companion
一个完全可自定义的陪伴 Agent（DeepSeek Harness 插件）——名字、性格、声音都由你 在对话里配置，不需要 fork 仓库或发布新包。声音由 Qwen3-TTS（本地部署在 mac mini 上）生成，浏览器播放——跨平台（macOS / Windows / Chrome / Edge / Safari），无需服务器 TTS 或 API key。
> 任意人设 · 任意声音 · 每个会话自己的定时问候 · 零构建
亮点
- 会话内配置：会话标题旁的 👤 按钮打开配置窗口——填名字、性格设定，选一个
内置音色（点击试听）或直接用文字描述一个全新的声音，Qwen3-TTS 会按你的描述 生成。保存立刻生效，不用重启。
- 每个会话独立：人设按会话保存，不同会话可以是完全不同的搭档；新会话在
第一次保存前使用一个通用的默认人设（小助手）。
- 自动朗读每一句回复：搭档每次回话都会说出口，用的是这个会话保存的声音。
speak/cheer模型工具：搭档可随时要求把某句念出来，或弹出 💛 打气卡片。- 每个搭档自己的定时问候：在配置窗口里加一个或多个时间（HH:MM），到点会
用这个搭档的人设生成一句问候，只送进这一个会话——不会影响其他会话。
架构
浏览器 (dsh web GUI) mac mini (dsh host)
┌─────────────────────┐ /dsh-companion/tts ┌──────────────────────────┐
│ client.js │ ───────────────────────► │ dsh-companion 插件 (Node) │
│ fetch WAV → <audio> │ │ 代理 → 127.0.0.1:3091 │
└─────────────────────┘ └──────────┬───────────────┘
│ http
┌─────────────▼─────────────┐
│ tts_service.py (FastAPI) │
│ Qwen3-TTS-12Hz-1.7B- │
│ VoiceDesign (MPS) │
└───────────────────────────┘人设/声音/问候时间存在 $DSH_HOME/state/dsh-companion/personas/<sessionId>.json， 按会话读写；系统提示词按会话动态渲染（一个 preset composition 每进程只挂载 一次，被所有会话共享，所以人设不能写死在插件启动时的闭包里）。问候调度也是 按会话独立跑的一套小定时器，不是所有会话共用一个全局时间表。
安装
1. mac mini 上部署 TTS 服务（只需一次）
brew install portaudio ffmpeg sox
/usr/local/bin/python3.12 -m venv ~/qwen-tts-venv
~/qwen-tts-venv/bin/pip install -U qwen-tts
# 把 tts_service.py 放到 ~/tts_service.py，然后：
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.dsh.sister-tts.plist2. 安装插件
dsh plugin --profile web add github:Yihong89/dsh-companionBundle patch 有意为空——插件只在预设里显式写了 name: dsh-companion 行时才 激活（即 companion 预设 ~/.dsh/.agent-presets/companion/agent.cordis.yml）。
3. 创建 companion 预设
~/.dsh/.agent-presets/companion/agent.cordis.yml：
- insert:
- id: dsh-companion
name: dsh-companion用这个预设新建会话后，点会话标题旁的 👤 按钮即可开始配置。
命令
| 命令 | 作用 | | --- | --- | | /speak on\|off | 开关自动朗读 | | /speak <text> | 立刻把文字念出来 | | /cheer [text] | 立刻送一句打气（朗读 + 💛 卡片）；不写文字用内置语库 |
> /cheer-at / /cheer-text 命令仍然存在（继承自 dsh-voice-core），但对 > dsh-companion 没有实际效果——问候时间现在存在每个会话自己的人设文件里， > 只能通过 👤 配置窗口设置。这是已知的一处粗糙边缘，留给后续清理。
已知限制
- 声音预览、试听音频不会被缓存/预生成——每次点击都会实时调用 Qwen3-TTS
（几秒钟）。
/cheer-at//cheer-text命令对问候时间不再生效（见上）。
测试
node --test test/*.test.jsLicense
MIT