dsh-dafeiyu-dot
In a curated listMaintenance: Activewz20/dsh-dafeiyu-dot
A whale companion with configurable roles, emotional speech through local TTS, persistent file-based memory, QQ messaging, and half-duplex voice calls. QQ requires a NapCatQQ-compatible OneBot v11 gateway, and the emotional voice requires a local VoiceStudio + audio.cpp + Breeze TTS 2 stack (or a compatible TTS API); FFmpeg is needed for non-1x speech speed.
$ dsh plugin add dsh-dafeiyu-dotInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work9
stars
0
forks
JavaScript
Language
MIT
License
2026-10-30
Created
2026-11-02
Last push
README
dsh-dafeiyu-dot · 大肥鱼
有情绪的声音,能延续的记忆。
DeepSeek Harness 陪伴插件 · 角色配置 · 情绪语音 · 记忆宫殿 · QQ · 语音通话
开始使用 · 技术栈 · 界面预览 · 架构与流程 · 数据与隐私 · 开发文档
把角色、声音、记忆与 QQ 接入放进一个配置中心,在 DSH 里搭建自己的大肥鱼。她可以用选定的音色表达语气,在回复前找回相关记忆,也可以通过 QQ 发送语音和主题表情。
项目处于公测阶段,源码采用 MIT 许可。当前接口兼容性以 DSH 0.2.1-rc.3 为验证基线。Windows 用户请使用 0.11.1 或更新版本,该版本修正了界面图标等静态资源的路径校验。

本文界面截图使用当前前端与项目公开素材渲染,配置、人物、记忆和消息均为虚构演示数据;截图中的连接与消息状态用于展示界面。
能做什么
| 能力 | 使用方式 |
|---|---|
| 角色与模式 | 可视化编辑名字、称呼和角色提示词;在同一会话切换标准模式与鲸鱼娘模式。 |
| 情绪语音 | 本地 VoiceStudio/audio.cpp 与 BreezeBlue 官方 API 均支持同一音色的情绪表达;提供 OpenAI 兼容 TTS,可选择音色、音量和语速。 |
| 记忆宫殿 | 保存有来源的长期事实,回复前自动召回、压缩前补存;支持查看关系、精读、更正、遗忘和备份。 |
| QQ 陪伴 | 配对主号私聊;显式启用的群中真实 @ 触发回复,支持语音条、主题表情与消息摘要看板。 |
| 语音通话 | 手动开始的半双工通话,复用当前会话、模型与记忆;可以静音、打断、挂断,也能展开文字输入。 |
| 记账挂件 | DSH 窗口内显示账务与陪伴挂件,支持触点声音,显示与音效可独立开关。 |
退出鲸鱼娘模式后,陪伴记忆与自动朗读停用;挂件可以继续独立显示。DSH 文字会话的自动朗读、通话语音与 QQ 语音分别管理。
技术栈与参考部署
下面是已核对的参考技术链。插件通过服务接口接入这些组件,使用者可以配置自己的兼容服务。
| 层次 | 具体技术 | 在本项目中的职责 |
|---|---|---|
| 宿主与模型调用 | DeepSeek Harness、Cordis、Node.js ES Modules | 注册插件、接入会话与配置页面;对话模型在 DSH 中选择。 |
| 本地语音服务 | VoiceStudio,引擎 ID 为 audiocpp |
管理音色并提供兼容的 POST /v1/audio/speech 接口,接收台词与 instructions 情绪指令。 |
| 云端语音服务 | BreezeBlue API | 读取账号音色,以原生 text-to-speech 接口发送台词、音色与情绪指令,返回 WAV。 |
| 本地语音推理 | audio.cpp,GGUF / ggml | 在本机执行语音模型推理。 |
| 情绪语音模型 | Breeze TTS 2 | 结合选定的参考音色与语气指令合成声音;最终效果需要试听。 |
| QQ 网关 | NapCatQQ | 通过 OneBot v11 正向 WebSocket 收发消息;插件主动连接网关。 |
| 语音识别 | DSH speechToText;参考配置为 SenseVoice ONNX |
通话识别沿用 DSH 当前选择,图中的 SenseVoice 是参考配置。 |
| 记忆存储与检索 | Markdown 事实文件、JSON 状态与索引、自实现本地检索 | 关键词、别名及实体/属性/时间约束召回;后台整理复用会话模型。 |
| 语速处理 | FFmpeg | 对合成结果进行可选的保音高调速。 |
本地语音链路: 插件 → HTTP → VoiceStudio(audiocpp)→ audio.cpp → Breeze TTS 2 → WAV → FFmpeg 按需调速 → 播放或发送。
云端语音链路: 插件 → HTTPS → BreezeBlue 官方 API → WAV → 播放或发送。
QQ 链路: QQ ↔ NapCatQQ ↔ OneBot v11 正向 WebSocket ↔ 插件 ↔ DSH 会话。
开始使用
1. 准备运行环境
| 组件 | 用途 |
|---|---|
| DeepSeek Harness 桌面版及已配置的对话模型 | 插件宿主、聊天和记忆整理;其他版本需自行核对接口兼容性。 |
| BreezeBlue 官方 API,或 VoiceStudio+audio.cpp+Breeze TTS 2,或 OpenAI 兼容 TTS API | 选择云端或本地语音。本地 audiocpp 与 BreezeBlue 官方 API 支持情绪指令。 |
| DSH 语音识别器 | 使用通话时需要,识别配置沿用 DSH。 |
| NapCatQQ 或兼容 OneBot v11 正向 WebSocket 网关 | 使用 QQ 时需要,登录与运行由网关管理。 |
| FFmpeg | 使用非 1 倍语速的保音高调速时需要。 |
插件负责配置与编排,对话模型、语音模型和 QQ 网关由使用者准备。
2. 从仓库地址安装
在 DSH 的插件安装入口粘贴以下地址,确认安装并按提示启用:
https://github.com/wz20/dsh-dafeiyu-dot
地址末尾保持为仓库名。当前 DSH 基线可以直接识别普通 GitHub 仓库地址。
也可以使用 DSH 命令行:
dsh plugin --profile desktop add "https://github.com/wz20/dsh-dafeiyu-dot" --ignore-scripts
安装后从侧栏「大肥鱼」进入配置中心。安装插件后,还需按下文配置自己的语音服务、音色,以及可选的 QQ 网关。
本地源码开发安装
下载或取得源码后,在 dsh-dafeiyu-dot 项目目录执行:
dsh plugin --profile desktop add "link:$PWD" --ignore-scripts
dsh 是 DSH 提供的命令行入口。重启 DSH,在侧栏点击「大肥鱼」打开配置中心。
3. 配置自己的大肥鱼
- 角色:填写名字、称呼和提示词,选择陪伴会话,开启鲸鱼娘模式。
- 语音:选择本地,或在 API 中选择「BreezeBlue 官方 API」/「OpenAI兼容 API」。填写对应密钥,读取并选择音色,检查连接后手动试听。各服务分别保存配置和密钥,首次安装的音色由你选择。
- 记忆:开启陪伴记忆,查看宫殿中的事实与来源;需要保存到工作区时配置
memoryPalaceRoot。 - QQ(可选):运行 NapCatQQ 等网关,启用 OneBot v11 正向 WebSocket,保存地址与令牌,选择陪伴会话,再完成主号配对。群回复需逐群启用。
- 通话与挂件(可选):从会话顶栏或配置中心进入语音通话;按需开启挂件与触点音效。
服务地址、素材覆盖方式和详细步骤见 安装与配置。
使用 BreezeBlue 官方 API
在「大肥鱼 → 语音」选择 API → BreezeBlue 官方 API,默认地址为 https://api.breeze.blue/v1,模型为 breeze-tts-2。填写你自己的 API Key,点击「保存并读取音色」,选择音色或填写 voice_id,再检查连接、试听语气。云端路线需要可用的 BreezeBlue 账号和额度,语音模型由服务端运行。详细步骤与错误排查见 配置说明。
界面预览
记忆关系图
从人物、主题与事实之间的关系进入内容,查看来源,再进行更正或遗忘。长期记忆以文件保存,关系图是浏览入口。

QQ 消息看板
集中查看连接、配对、语音与表情发送状态,以及近期消息摘要;群聊仍按已启用范围与真实 @ 规则处理。

简洁语音通话
点击「开始」后打开麦克风,识别、思考与播放阶段暂停收音。需要时展开文字区打字或切换模型;挂断后停止本次采音与播报。

架构与流程
插件如何连接各个能力
DSH 提供会话及已配置的对话模型、语音识别调用接口,实际模型服务可以在本机或通过 API 运行。大肥鱼插件组织角色、语音、记忆、挂件与 QQ。参考部署使用 VoiceStudio 管理 audio.cpp 和 Breeze TTS 2,并通过 NapCatQQ 接入 QQ;这些服务独立运行,本机运行数据由插件单独管理。

图中的 SenseVoice 表示参考识别配置,实际沿用 DSH 当前识别器。NapCatQQ 与插件使用 OneBot v11 正向 WebSocket 双向通信;私聊与群成员使用各自的会话及记忆范围。
上下文有限,记忆怎样延续
记忆分为「回复前读取」和「持久保存」两条链路。召回从本地索引取有限的相关事实;后台整理使用对话模型提取候选事实,再核对真实用户来源。

- 回复前:核对会话范围 → 本地检索 → 注入有限相关记忆 → 模型回复。当前最多召回 6 条,总注入不超过 3,600 字符;需要细节时可按 ID 精读。
- 完成本轮或压缩前:核对并过滤来源 → 写入持久待办 → 模型提取 → 证据核验 → 保存 Markdown 与索引。
- 压缩保护:合格来源安全入队后才允许压缩;事实整理可以继续在后台进行,来源写入失败时暂停压缩。
- 准确性与归属:保留来源与时间,更正优先、遗忘受墓碑保护;主人私聊、不同群和不同群成员分开存储。
新观察范围内的合格来源才会自动整理,已有事实与持久待办可以恢复。关闭记忆或离线期间未观察的历史不会自动补录;崩溃前尚未入队的内容仍可能丢失。长期保存与每次都能准确召回是不同的能力,当前检索以关键词、别名和结构化约束为主。详见 记忆宫殿。
同一音色如何表达情绪
开启情绪并选择本地 audiocpp 或 BreezeBlue 官方 API 时,原始回复分别进入台词清洗与语气判断:动作线索可以帮助判断情绪,实际朗读只使用清洗后的台词。两条支持链路均将台词、情绪指令和选定音色一起合成。
下图展示本地与 OpenAI 兼容服务的参考链路。BreezeBlue 官方 API 复用同一语气判断流程,通过官方原生接口合成。

More in Just for Fun
dsh-pet
by pc2005-cloud
DSH Web 界面桌面宠物:51 个透明 webm 动画随机链播、屏幕漫游、点击/拖拽;附提示词配方+AI 视频素材生成链可自造宠物
dsh-tavern
by flizzywine
SillyTavern 类文字游戏 Agent:候选项生成、对话式人物卡编辑、剧本模板。
dsh-dafeiyu
by qcytsn
Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.
dsh-meme
by yyh-001
表情包插件:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图。
