前言¶
在 DeepSeek Harness（DSH）里做长期陪伴类智能体，常见做法是分散配置：角色提示词在一处，TTS 在另一处，长期事实要么靠模型上下文硬撑，要么自己写脚本落盘。QQ 或语音通话若再单独接网关，会话、记忆和朗读很难对齐同一条链路。
大肥鱼（dsh-dafeiyu-dot）把角色、声音、记忆宫殿与 QQ 收进一个配置中心，在 DSH 侧栏以客户端插件形式运行。项目由 wz20 维护，源码 MIT 许可，当前处于公测；接口兼容性以 DSH 0.2.1-rc.3 为验证基线，Windows 用户请使用插件 0.11.1 或更新版本（修正界面图标等静态资源路径校验）。社区目录页：skillhub.cn/plugins/wz20/dsh-dafeiyu-dot；仓库：github.com/wz20/dsh-dafeiyu-dot（GitHub 星标 4，分类：客户端）。DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话定位：DeepSeek Harness 陪伴插件——可视化配置角色与「鲸鱼娘模式」，支持情绪语音、本地记忆宫殿、QQ 私聊/群 @、半双工语音通话，以及 DSH 窗口内的记账与陪伴挂件。
插件负责编排与配置；对话模型、语音推理、QQ 网关由使用者自行准备并接入兼容服务。
核心功能¶
下面按 README 中「能做什么」表格归纳，均为插件已声明能力。
角色与模式¶
在同一会话中编辑名字、称呼与角色提示词，可在标准模式与鲸鱼娘模式之间切换。退出鲸鱼娘模式后，陪伴记忆与自动朗读停用；挂件可继续独立显示。DSH 文字会话自动朗读、通话语音与 QQ 语音分别管理。
情绪语音¶
本地链路可走 VoiceStudio（引擎 ID audiocpp）经 audio.cpp 与 Breeze TTS 2；云端可走 BreezeBlue 官方 API。两条路线均支持同一音色的情绪表达（台词清洗 + 语气判断，情绪指令随合成请求下发）。另提供 OpenAI 兼容 TTS，可选音色、音量与语速；非 1 倍语速时可经 FFmpeg 保音高调速。
记忆宫殿¶
长期事实带来源保存；回复前自动召回（当前最多 6 条、总注入不超过 3,600 字符），压缩前补存。支持关系图浏览、精读、更正、遗忘与备份。需要把工作区记忆落到指定目录时，可配置 memoryPalaceRoot。私聊、不同群与不同群成员的记忆隔离存储。
QQ 陪伴¶
通过 NapCatQQ 等兼容 OneBot v11 正向 WebSocket 的网关接入；插件主动连接网关。配对主号私聊；群中需逐群启用，且仅在真实 @ 时回复。支持语音条、主题表情与消息摘要看板。
语音通话¶
手动开始的半双工通话，复用当前会话、模型与记忆；可静音、打断、挂断，也可展开文字输入。识别沿用 DSH 当前语音识别配置（README 以 SenseVoice ONNX 为参考示例）。
记账挂件¶
在 DSH 窗口显示账务与陪伴挂件，支持触点声音；显示与音效可独立开关。挂件数据与部分媒体目录沿用 DSH 数据目录下的 .dshw-*.json、whale-roles/ 等路径（详见 README「本地数据与隐私」）。
技术栈概览¶
插件通过服务接口对接外部组件，使用者配置自己的兼容实例：
| 能力 | 参考组件 |
|---|---|
| 宿主 | DeepSeek Harness、Cordis、Node.js ES Modules |
| 本地 TTS | VoiceStudio → audio.cpp → Breeze TTS 2 |
| 云端 TTS | BreezeBlue API（默认 https://api.breeze.blue/v1，模型 breeze-tts-2） |
| NapCatQQ，OneBot v11 正向 WebSocket | |
| 记忆 | Markdown 事实、JSON 状态与索引、本地检索 |
详细部署链路与架构图见仓库 README「技术栈与参考部署」「架构与流程」。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，API 密钥与网关令牌经 DSH 凭据服务管理。
准备环境¶
至少需要：DSH 桌面版及已配置的对话模型；任选 BreezeBlue 官方 API、或 VoiceStudio + audio.cpp + Breeze TTS 2、或 OpenAI 兼容 TTS；使用通话时需 DSH 语音识别器；使用 QQ 时需 NapCatQQ 或兼容网关；需要变速时需 FFmpeg。
从仓库地址安装¶
在 DSH 插件安装入口粘贴仓库地址，确认安装并启用：
https://github.com/wz20/dsh-dafeiyu-dot
或使用命令行：
dsh plugin --profile desktop add "https://github.com/wz20/dsh-dafeiyu-dot" --ignore-scripts
安装后从侧栏「大肥鱼」进入配置中心，再按下一节配置语音、记忆与可选 QQ。
本地开发可在 dsh-dafeiyu-dot 项目目录执行（资料原文，非 git clone 指引之外的额外步骤）：
dsh plugin --profile desktop add "link:$PWD" --ignore-scripts
重启 DSH 后从侧栏打开配置中心。
典型配置步骤¶
经过上面的安装，可按 README「配置自己的大肥鱼」顺序操作：
- 角色：填写名字、称呼和提示词，选择陪伴会话，开启鲸鱼娘模式。
- 语音：选择本地或在 API 中选择「BreezeBlue 官方 API」／「OpenAI 兼容 API」。填写密钥，读取并选择音色，检查连接后手动试听。
- 记忆：开启陪伴记忆；需持久化到工作区时设置
memoryPalaceRoot。 - QQ（可选）：运行网关，启用 OneBot v11 正向 WebSocket，保存地址与令牌，选择会话并完成主号配对；群回复逐群启用。
- 通话与挂件（可选）：从会话顶栏或配置中心进入语音通话；按需开启挂件与触点音效。
BreezeBlue 路线示例：在「大肥鱼 → 语音」选 API → BreezeBlue 官方 API，填写 API Key，「保存并读取音色」后选择音色或 voice_id，再检查连接与试听。细则见仓库 docs/setup.md。
本地数据与适用注意¶
默认运行目录为 $DSH_HOME/dsh-dafeiyu-dot/；未设置 DSH_HOME 时为 ~/.dsh/dsh-dafeiyu-dot/。长期记忆默认在运行目录 memory-palace/，备份须包含隐藏目录 .state/。
适合谁：希望在 DSH 内一站式搭陪伴角色、要带情绪朗读与可审计长期记忆、并可选接 QQ 或半双工通话的桌面用户。注意：远程对话模型与 TTS 会收到相应会话与台词；QQ 可用性依赖网关与账号状态；项目公测，接口以自述基线为准；配对主号私聊复用所选会话及该会话已启用的 DSH 工具权限，请使用可信账号。故障恢复见 docs/recovery.md。
结尾¶
大肥鱼把角色、情绪语音、记忆宫殿、QQ 与通话收进 DSH 客户端插件的统一配置中心，适合在 Harness 里做可延续记忆的陪伴场景。进一步了解能力与隐私说明见 GitHub README；安装与目录索引分别见 https://github.com/wz20/dsh-dafeiyu-dot 与 https://www.skillhub.cn/plugins/wz20/dsh-dafeiyu-dot。
