dsh-fish-tts

中文 | English

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。

功能

• 朗读按钮：每条定稿的助手消息操作条里有一个「朗读 / Read aloud」按钮（图标与原生操作条图标同风格），点击合成并播放该条回复。markdown 会被清洗：路径 / URL / 长编号 / 代码块不会读出来。
• 自动朗读：输入框工具行的小喇叭开关（与设置页同步），开启后自动朗读页面加载后产生的新回复。
• 设置页（Settings → 语音朗读 / Voice (Fish TTS)）：
  • TTS 模型（下拉建议 + 手动输入，支持 s2.1-pro-free / s2.1-pro / s2-pro 等，保存后立即生效；默认 s2.1-pro-free）
  • 音色 reference_id（必填：音色是个人数据，插件不提供默认音色；未填写时合成会被拒绝并提示）
  • API Key（AES-256-GCM 加密存储在本机 $DSH_HOME/fish-tts/settings.json，密钥文件 key.bin 自动生成并在 Windows 上收紧 ACL；Key 不会出现在任何 GET 响应、日志或仓库中）
  • HTTP 代理（例如 http://127.0.0.1:7890，直连不通时可填）
  • 试听按钮、自动朗读开关、音量滑条（默认 60%）
• 双语界面（中文 / English，跟随 DSH 语言设置；en 词条与 zh 完全对齐）。

安装

# 从 GitHub 安装（git-hosted 插件会在安装时构建）
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
dsh plugin --profile web add /absolute/path/to/dsh-fish-tts

然后重启 dsh web（关掉终端重新运行 dsh web）并刷新页面。

仓库已提交 lib/ 构建产物，git 安装无需本地构建；改源码后运行 pnpm run build 再重启即可。

配置

首次使用：打开 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	设置/密钥文件目录

安全

• API Key 只以加密形态落盘（AES-256-GCM，每机随机密钥 key.bin，0600/ACL 收紧），不写入仓库、日志或任何 GET 响应。
• 写接口（synthesize/config）强制 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 若带凭据同样会被忽略（不泄露、无回退），请改用无凭据的代理或直连。
• 代理地址、模型、音色均为用户本机设置，仓库不携带任何个人信息。
• 合成请求的文本上限 12000 字符；结果在进程内缓存（最多 200 条），重启即清。

开发

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/ 构建产物与提交一致。

• host 侧在 src/index.ts（Node，注册 /fish-tts/* 路由与设置存储）
• client 侧在 src/client/（React，注册 conversation.chat.assistant-actions、conversation.input.left、settings.section 三个 slot）
• 依赖 DSH 0.1.0-rc.6 的运行时 API；其他版本如接口漂移请对照 deepseek-harness 仓库 相应 tag 调整。

License

MIT

合规与第三方声明

• 本项目是第三方开源插件，与 Fish Audio / Hanabi AI Inc. 无任何隶属、合作或背书关系。"Fish Audio" 为其权利人的商标，此处仅为描述性使用（说明本插件所对接的服务）。
• 本插件不分发、不托管任何 API Key；请使用你自己的 Fish Audio 账号与 Key，并妥善保管。
• Fish Audio 免费额度仅限个人、非商业用途；商业使用请订阅官方付费套餐。详见 Terms of Use。
• 仅可使用你有权使用的音色（reference_id）。未经授权，不得克隆或模仿公众人物、名人或他人的声音。详见 Acceptable Use Policy。
• 对外分发生成的音频时，建议主动披露其为 AI 合成内容，不得误导听众认为是真人真实发言。
• 使用本插件即表示你同意遵守 Fish Audio 的全部服务条款；条款如有更新，以官方页面为准。

---

独立社区项目，与 DeepSeek 无隶属关系，亦未经其认可。DeepSeek 与 DeepSeek Harness 商标归各自所有者所有。 Independent community project — not affiliated with or endorsed by DeepSeek.