peon-voice — 语音主题包插件（DSH）

给 DeepSeek Harness 用的语音 + 主题音乐插件：在 agent 会话生命周期事件上播放随机语音提示，并按主题播放网易云音乐背景乐。

🎙️ 语音包：新会话（问候）、收到消息（应答）、一轮完成（完成）、agent 向你提问（提问）时随机播放对应语音，多条随机且避免连播同一条
🎵 主题包：切换主题时自动切换对应语音包，并播放该主题关键词搜到的网易云歌单
🔊 网易云音乐：匿名接口获取免费歌曲并后台顺序播放，不可播 VIP 歌曲（自动跳过）；歌单全部播完或连续多首无法播放时自动切换到新歌单；播放语音时背景乐自动闪避（duck）
🖥️ 双端实现：Host 端（Node，注册 /peon/* HTTP 路由）+ Client 端（浏览器，轮询事件队列并播放）
🔄 每次启动重置：播放状态不持久化，每次打开 DSH 都会重新随机挑选歌单（主题/语音包选择会保留）

目录结构

peon-voice/
├── lib/
│   ├── index.js        # Host 端：事件监听、语音/主题扫描、HTTP 路由
│   ├── client.js       # Client 端：浏览器 UI + 音频播放（__ModuleLoader__ 模块）
│   └── netease.js      # 网易云客户端（匿名歌单搜索、流媒体代理）
├── voice-packs/        # 语音包（每个子目录一个包）
│   ├── orc/            # 兽人男声 · Orc Peon
│   └── female/         # 日语动漫萌音 · 女生
├── theme-packs/        # 主题包（每个子目录一个主题）
│   ├── orc-epic/       # 兽人史诗
│   └── anime/          # 日系动漫
└── package.json

安装

把本仓库放到 DSH profiles 的 node_modules 下（或通过路径引用），然后在你的 cordis 配置（如 cordis.patch.yml）中注册该插件条目即可，例如：

plugins:
  peon-voice: {}

插件启动后会注册 /peon/* 路由；浏览器端会在 DSH Web 界面加载并开始播放。路径默认指向仓库内的 voice-packs/ 与 theme-packs/，克隆即用。

语音包格式

voice-packs/<pack-id>/ 下一个目录即一个语音包，文件名以类型开头即可（.mp3/.wav 均可，数字后缀随意）：

文件名	触发时机
`greeting-*`	问候音：打开应用 / 新会话 / 切换工作区（可多条随机）
`ack-*`	应答音：收到消息时（可多条随机）
`done-*`	完成音：一轮对话完成时
`question-*`	提问音：agent 向你提问时

可选 pack.json：{"label": "显示名"}（不写则用目录名）。放好音频后在应用里切换到这个语音包即可，无需重启。

主题包格式

theme-packs/<theme-id>/pack.json：

{
  "label": "日系动漫",
  "voice": "female",
  "music": { "keywords": ["动漫主题曲", "二次元主题曲"] }
}

label：界面显示名
voice：切换该主题时自动切换的语音包 id
music.keywords：用于在网易云搜索歌单的关键词（每次从评分最高的若干歌单中随机选一个播放）

环境变量

所有路径都可通过环境变量覆盖，默认值开箱即用：

变量	默认值	说明
`PEON_VOICE_PACKS`	`<仓库>/voice-packs`	语音包根目录
`PEON_VOICE_THEMES`	`<仓库>/theme-packs`	主题包根目录
`PEON_VOICE_STORE`	`~/.dsh/peon-voice-pack.json`	当前选中语音包/主题的持久化
`PEON_VOICE_DEBUG_LOG`	`~/.dsh/peon-voice-debug.log`	调试日志

HTTP 路由

路由	说明
`GET /peon/events`	拉取并清空事件队列（Client 轮询）
`GET /peon/audio?kind=`	从当前语音包随机返回一条音频
`GET /peon/packs` · `POST /peon/pack`	列出 / 切换语音包
`GET /peon/themes` · `POST /peon/theme`	列出 / 切换主题（同时切换语音包）
`GET /peon/music/playlist` · `GET /peon/music/stream?id=`	主题歌单 / 歌曲流媒体代理
`POST /peon/music/leader`	心跳/竞选播放者，返回全局音乐状态
`POST /peon/music/action`	队列化一条播放命令（由播放者执行）
`POST /peon/music/report`	播放者上报播放状态（全局镜像）
`GET /peon/status`	插件状态总览

播放行为

歌单内顺序播放，全部播放完毕自动切换到该主题的新随机歌单
VIP 受限歌曲播放失败时自动跳过；连续 3 首失败（歌单基本全是 VIP）自动切换新歌单
手动「切歌」仍为随机（不重复上一首），手动「切歌单」立即换一个新歌单
播放状态（当前歌单/曲目）不持久化：每次打开 DSH 都是新的随机歌单
多窗口/多标签全局统一：同时开多个会话（多个浏览器上下文）时，由 Host 仲裁出唯一播放者实际播放音乐，其余上下文静默并镜像同一播放状态（歌单/曲目/播放/暂停、主题与语音包切换全部同步）；播放者窗口关闭后自动移交并续播同一曲目。语音提示保持各上下文独立触发，不做全局统一。

免责声明

网易云音乐接口为非官方匿名实现（公开 /api 端点），仅作个人使用；VIP 歌曲不可播放，请遵守网易云音乐服务条款。