@local/dsh-voice
适用于 DeepSeek Harness 的本地 TTS 语音，支持情感模拟（IndexTTS2；可选 QQ 发送）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Soulmate793/dsh-voice#3a94938c13b97a686334891f4b844ff10d9992ceVoice 以 @local/dsh-voice 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 加一套完全本地运行的中文语音，并且让语音带上连续变化的情绪状态。
一句话：她不只是会说话，而是带着「此刻的心情」说话。
本仓库只包含插件本体。IndexTTS2 模型与参考音需要你自行部署（约 10GB），插件不含模型。
| 工具 | 说明 |
|---|---|
voice_say | 合成一句中文语音。可指定 emotion 情绪名或 emoVector 8 维向量；传 key（private:<QQ> / group:<群>）直接发到 QQ |
voice_send_file | 把已有音频文件发到 QQ |
voice_health | 检查语音服务是否就绪；未就绪自动拉起并等待模型加载 |
voice_emotion_state | 查看当前情绪状态（向量 / 最近一次互动 / 关系亲密度） |
voice_emotion_simulate | 情绪推演：给一段对方说的话，推断对方情绪并推演自己的情绪变化 + 建议语气 |
voice_emotion_tick | 只推进情绪时间（回落 + 昼夜节律） |
情绪向量顺序（不可换）：
[高兴, 愤怒, 悲伤, 恐惧, 反感, 低落, 惊讶, 平静]
情绪名只是向量的别名，内置：开心 / 激动 / 温柔 / 撒娇 / 生气 / 委屈 / 难过 / 伤心 / 哭腔 / 惊讶 / 平静。
不指定情绪时，voice_say 会读 emotion-state.json（情绪推演维护的当前状态）决定语气，所以连续对话里声音是渐变的，而不是一条消息一个表情。
D:\index-tts2D:\index-tts2\ref\ref.wavD:\index-tts2\.venv\Scripts\python.exe）和模型目录（D:\index-tts2\checkpoints）在 DeepSeek Harness 的任意会话里让 agent 执行：
用 plugin_manager 的 install_bundle，安装这个目录：<绝对路径>/dsh-voice-plugin
安装成功后，新会话里就能看到 voice_* 工具（voice_health 可用于自检）。
两种方式（后者优先级更高）：
runtime/config.example.json 复制为 runtime/config.json，填好路径（该文件已被 .gitignore 忽略，不会进仓库）cordis.patch.yml 里覆盖 voice 行的 config配置项：
| 字段 | 说明 |
|---|---|
indextts2.python | IndexTTS2 venv 的 python 可执行文件 |
indextts2.root | IndexTTS2 仓库根目录（加到 sys.path） |
indextts2.modelDir | checkpoints 目录 |
indextts2.refAudio | 参考音（音色克隆用） |
indextts2.port | 本地服务端口，默认 8765 |
indextts2.autoStart | 服务未启动时是否自动拉起（默认 true） |
indextts2.idleSeconds | 空闲退出秒数；0 = 常驻（默认） |
indextts2.minFreeMb / minCommitMb | 内存保护阈值（不足时拒绝加载并给出提示） |
qq.baseUrl | SnowLuma / OneBot HTTP 地址，默认 http://127.0.0.1:3000 |
qq.token | OneBot access token（只合成不发送可留空） |
voice.vectorAlpha | 显式情绪向量的强度（0~1） |
voice.stateAlpha | 情绪推演状态的强度（0~1） |
memoryDir | 情绪状态目录，默认 ~/.dsh/qq-memory |
调用 voice_health
首次会自动拉起服务并加载模型（约 25~60 秒）。看到「语音服务就绪」即可使用：
调用 voice_say，text="你好呀，这是一条语音测试"，emotion="温柔"
需要发到 QQ 时再传 key，如 private:123456789。
普通语音插件是「一条消息 → 一个情绪标签」；本插件把情绪当成动态系统：
详细公式、参数与状态文件格式见 docs/emotion-model.md。
Agent 工具调用
│
├─ voice_say ──► 情绪来源（显式向量/别名/情绪状态）
│ │
│ ▼
│ HTTP POST /synth ──► IndexTTS2 本地服务（8765）
│ │ │
│ ▼ ▼
│ wav 音频 模型常驻/自动拉起/内存保护
│ │
│ ▼
│ SnowLuma / OneBot（可选）──► QQ 语音消息
│
└─ voice_emotion_* ──► emotion.mjs（情绪推演）──► emotion-state.json
运行时文件：
lib/index.js — Host 插件，注册工具、管理语音服务进程runtime/indextts2_server.py — 本地 HTTP 语音服务（常驻、自动拉起、CUDA/内存错误自动重启）runtime/emotion.mjs — 情绪推演（8 维向量、惯性、回落、昼夜、关系）runtime/datadir.mjs — 共享数据目录解析MIT，见 LICENSE。
dsh-voice is a DeepSeek Harness Host plugin bundle that adds fully local Chinese TTS (IndexTTS2) with an 8-dimensional emotion model and emotion dynamics simulation.
plugin_manager install_bundle (point it at this directory).runtime/config.example.json to runtime/config.json and fill in your paths.voice_health, then voice_say.qq.baseUrl / qq.token to deliver the voice to QQ via SnowLuma/OneBot.