dsh-fish-tts
适用于 DeepSeek Harness 的文本转语音（TTS）插件——仅支持 Fish Audio API，需使用您自己的密钥。支持逐条消息朗读、编辑器中的自动朗读开关，以及模型、语音、加密 API 密钥和代理设置。第三方插件，与 Fish Audio 无关联。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-fish-tts@0.2.11
Fish Tts 以 dsh-fish-tts 发布，当前版本为 0.2.11。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
dsh-fish-tts — DeepSeek Harness 语音合成插件（仅支持 Fish Audio API）
English: dsh-fish-tts is a third-party TTS plugin for the DeepSeek Harness Web GUI — Fish Audio API only, bring your own key: a per-message "Read aloud" action, an auto-read toggle in the composer, and a settings page for model / voice / encrypted API key / proxy. Bilingual UI (zh/en). See README.en.md for the full English version.
面向 DeepSeek Harness（DSH）Web GUI 的第三方语音合成（TTS）插件：为每条助手回复提供一键朗读，输入栏带自动朗读开关，模型 / 音色 / 加密 Key / 代理均可配置。仅支持 Fish Audio API，需自备 API Key。 使用你自己的 Fish 音色（reference_id，含自行克隆的音色）——朗读、试听都走你配置的语音。
| 对比项 | dsh-fish-tts（本插件） | 常见 Edge TTS 朗读插件 |
|---|---|---|
| 合成引擎 | Fish Audio 官方 API（仅支持；需自备 Key） | 微软 Edge 内置语音 |
| 音色 | 你自己的音色 reference_id（含自行克隆的音色，须有使用权限） | Edge 内置固定音色库 |
| API Key | 必须自备（设置页 AES-256-GCM 加密保存） | 无需 |
| 适合谁 | 已有 Fish Audio 账号、想要自己或克隆音色的用户 | 想免费快速试用、固定音色即可的用户 |
reference_id（必填：音色是个人数据，插件不提供默认音色；未填写时合成会被拒绝并提示）$DSH_HOME/fish-tts/settings.json，密钥文件 key.bin 自动生成并在 Windows 上收紧 ACL；Key 不会出现在任何 GET 响应、日志或仓库中）http://127.0.0.1:7890，直连不通时可填）
消息操作条上的朗读按钮
消息操作条上的「朗读」按钮
输入栏的自动朗读开关
输入栏的自动朗读开关
语音合成设置页（模型 / 音色 / API Key / 代理）
设置页：模型 / 音色 / API Key / 代理 / 试听
一条命令，从 npm 安装（推荐）：
npx @deepseek-ai/dsh plugin --profile web add dsh-fish-tts
然后重启 dsh web（关掉终端重新运行 dsh web）并刷新页面，打开 Settings → 语音朗读。
其他安装方式：
# 从 GitHub 安装（git-hosted 插件会在安装时构建）
npx @deepseek-ai/dsh plugin --profile web add github:MaRi23333/dsh-fish-tts
# 从本地目录安装
git clone https://github.com/MaRi23333/dsh-fish-tts.git
cd dsh-fish-tts
pnpm install && pnpm run build
npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-fish-tts
仓库已提交
lib/构建产物，git 安装无需本地构建；改源码后运行pnpm run build再重启即可。
从 GitHub 版换到 npm 源：裸包名
add dsh-fish-tts对已装的 git 版是静默空操作（pnpm 判定同名依赖已满足）。请改用npx @deepseek-ai/dsh plugin --profile web add dsh-fish-tts@latest，或先remove再add。
安装刚发布的 npm 版本时，pnpm 的供应链保护可能自动在 profile 的
pnpm-workspace.yaml写入minimumReleaseAgeExclude: [dsh-fish-tts@…]，属正常行为，不影响使用。
reference_id；「试听」按钮会调用一次真实合成，一次验证 Key、音色与网络代理配置是否就绪；未保存或音色为空时「试听」保持置灰。
首次使用：打开 Settings → 语音朗读，填模型、音色、API Key（Fish Audio 的 key），必要时填代理，保存后用「试听」验证。所有设置在保存后立即生效，无需再次重启。
也可以在 profile 的 cordis.patch.yml 里给 fish-tts 行加 config（会被设置页保存的值覆盖）：
- id: fish-tts
config:
model: s2.1-pro-free
format: wav
stateDir: /custom/state/dir
| Key | 默认 | 说明 |
|---|---|---|
model | '' | 默认模型（设置页保存值优先） |
voice | '' | 默认音色 reference_id（设置页保存值优先） |
format | wav | wav / mp3 / opus / pcm |
apiKey | '' | 一般不填；优先使用设置页加密保存的 Key，其次环境变量 FISH_API_KEY |
apiKeyFile | '' | 读取指定 dotenv 文件的 FISH_API_KEY |
proxy | '' | HTTP(S) 代理（设置页保存值优先） |
stateDir | $DSH_HOME/fish-tts | 设置/密钥文件目录 |
key.bin，0600/ACL 收紧），不写入仓库、日志或任何 GET 响应。application/json 并校验同源/loopback Origin，杜绝跨站表单盗刷。/fish-tts/* 路由拒绝非 loopback（127.0.0.1 / ::1 / ::ffff:127.0.0.1）来源的请求（403），即使宿主监听在 0.0.0.0 也不开放远程访问。http://user:pass@host:port 会在保存时被拒绝）；环境变量 HTTPS_PROXY/HTTP_PROXY 若带凭据同样会被忽略（不泄露、无回退），请改用无凭据的代理或直连。pnpm install
pnpm run typecheck
pnpm run test # node:test 单元/集成测试（上游 Fish API 使用本地 mock，不触网）
pnpm run build # host: lib/index.js；client: lib/client.js（ModuleLoader CJS closure）
pnpm run smoke # host 入口 + client ModuleLoader 冒烟
pnpm run check:pack # npm pack 内容白名单校验
要求 Node >= 22（Node 20 已 EOL）。CI（
.github/workflows/ci.yml）在 Node 22 与 24 上执行全部门禁，并校验lib/构建产物与提交一致。
src/index.ts（Node，注册 /fish-tts/* 路由与设置存储）src/client/（React，注册 conversation.chat.assistant-actions、conversation.input.left、settings.section 三个 slot）0.1.2-rc.1 的会话 API 与界面图标变化完成适配和验证；其他版本如接口漂移请对照 deepseek-harness 仓库 相应 tag 调整。独立社区项目，与 DeepSeek 无隶属关系，亦未经其认可。DeepSeek 与 DeepSeek Harness 商标归各自所有者所有。 Independent community project — not affiliated with or endorsed by DeepSeek.