dsh-dafeiyu-dot 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-dafeiyu-dot 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-dafeiyu-dot 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-dafeiyu-dot 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/11/2。

大肥鱼陪伴 wz20/dsh-dafeiyu-dot

DeepSeek Harness

wz200 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

DeepSeek Harness 陪伴插件：情绪语音、记忆宫殿、QQ、语音通话与记账挂件。

31.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/11/3 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add wz20/dsh-dafeiyu-dot

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · platform

装得上吗

本站尚未做安装检查

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 0 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 58 处，展示前 53 条）

发起网络请求
client.js:84
const response = await fetch(BASE + path, {
写入剪贴板
client.js:380
await navigator.clipboard.writeText(lastReply.text);
写入剪贴板
client.js:784
try { await navigator.clipboard.writeText(palace.palaceRoot); setNotice('记忆宫殿路径已复制'); }
发起网络请求
client.js:802
try { const response=await fetch(ASSET+'persona.md',{credentials:'same-origin'}); if(!response.ok)throw new Error('暂时无法载入角色原稿。'); setSection('role',{p
写入剪贴板
client.js:1101
pairing?.code&&h('div',{className:'dfc-qq-pair-code',role:'status'},h('p',null,'请用主号在QQ私聊发送：'),h('strong',null,'配对 '+pairing.code),h('p',null,'有效期十分钟，
读取本地文件
lib/config.js:7
const persona = readFileSync(new URL('../assets/persona.md',import.meta.url),'utf8');
写入本地文件
lib/memory.js:116
function atomic(path,text){mkdirSync(dirname(path),{recursive:true,mode:0o700});const temp=path+'.'+randomUUID()+'.tmp';try{writeFileSync(temp,text,{m
写入本地文件
lib/memory.js:116
function atomic(path,text){mkdirSync(dirname(path),{recursive:true,mode:0o700});const temp=path+'.'+randomUUID()+'.tmp';try{writeFileSync(temp,text,{m
删除本地文件递归
lib/memory.js:116
function atomic(path,text){mkdirSync(dirname(path),{recursive:true,mode:0o700});const temp=path+'.'+randomUUID()+'.tmp';try{writeFileSync(temp,text,{m
写入本地文件
lib/memory.js:116
function atomic(path,text){mkdirSync(dirname(path),{recursive:true,mode:0o700});const temp=path+'.'+randomUUID()+'.tmp';try{writeFileSync(temp,text,{m
读取本地文件
lib/memory.js:117
function readJson(path,fallback){try{return JSON.parse(readFileSync(path,'utf8'));}catch(e){if(e.code==='ENOENT')return fallback;throw e;}}
读取本地文件
lib/memory.js:119
try{const value=JSON.parse(readFileSync(path,'utf8'));if(!value||typeof value!=='object'||Array.isArray(value)||!Array.isArray(value.memories))throw n
读取本地文件
lib/memory.js:120
catch(error){if(error.code==='ENOENT')return path;if(!(error instanceof SyntaxError)||!existsSync(join(palaceRoot??join(dirname(path),'记忆宫殿'),'.state'
写入本地文件
lib/memory.js:120
catch(error){if(error.code==='ENOENT')return path;if(!(error instanceof SyntaxError)||!existsSync(join(palaceRoot??join(dirname(path),'记忆宫殿'),'.state'
读取本地文件
lib/memory.js:123
function files(root){const out=[];function walk(dir){for(const item of readdirSync(dir,{withFileTypes:true})){const path=join(dir,item.name);if(item.i
写入本地文件
lib/memory.js:123
function files(root){const out=[];function walk(dir){for(const item of readdirSync(dir,{withFileTypes:true})){const path=join(dir,item.name);if(item.i
读取本地文件
lib/memory.js:125
function parse(path,root){const raw=readFileSync(path,'utf8'),mtime=statSync(path).mtime.toISOString();let meta={},body=raw;
读取本地文件
lib/memory.js:125
function parse(path,root){const raw=readFileSync(path,'utf8'),mtime=statSync(path).mtime.toISOString();let meta={},body=raw;
写入本地文件
lib/memory.js:141
this.palaceRoot=resolve(palaceRoot??join(dirname(path),'记忆宫殿'));this.statePath=join(this.palaceRoot,'.state','state.json');this.indexPath=join(this.pa
删除本地文件
lib/memory.js:192
if(existing){const changed=existing.content!==candidate.content||existing.value!==candidate.value;const sameSpace=existing.spaceId===candidate.spaceId
删除本地文件
lib/memory.js:201
async remove(id,options={}){if(typeof id!=='string'||!id)throw fail('请选择记忆。');return this._transaction(()=>{options.admit?.();const found=this.value.m
读取本地文件
lib/routes.js:43
const meta=await stat(selected);if(!meta.isFile()||meta.size>15_000_000)throw Object.assign(Error('资源不可用。'),{status:404});
读取本地文件
lib/routes.js:44
const bytes=await readFile(selected),cache=personal?'private, no-store':['.css','.js'].includes(extname(target))?'no-cache':'public, max-age=3600';res
读取本地文件
lib/singing.js:38
const info=await stat(path);
读取本地文件
lib/singing.js:40
return readFile(path);
读取本地文件
lib/singing.js:53
const info=await stat(settings.envFile);
读取本地文件
lib/singing.js:55
text=await readFile(settings.envFile,'utf8');
写入本地文件
lib/singing.js:144
await mkdir(directory,{recursive:true,mode:0o700});admit();
写入本地文件
lib/singing.js:145
await writeFile(join(directory,'song.wav'),audio,{mode:0o600,flag:'wx'});admit();
写入本地文件
lib/singing.js:146
await writeFile(join(directory,'metadata.json'),JSON.stringify(metadata),{mode:0o600,flag:'wx'});admit();
删除本地文件递归
lib/singing.js:149
await rm(directory,{recursive:true,force:true}).catch(()=>{});
读取本地文件
lib/singing.js:157
try{value=typeof settings==='function'?await settings():settings??JSON.parse(await readFile(join(root,'singing.json'),'utf8'));}
写入本地文件
lib/singing.js:269
await mkdir(directory,{recursive:true,mode:0o700});admit();
写入本地文件
lib/singing.js:270
await writeFile(join(directory,'song.wav'),audio,{mode:0o600,flag:'wx'});admit();
写入本地文件
lib/singing.js:273
await writeFile(join(directory,'metadata.json'),JSON.stringify(metadata),{mode:0o600,flag:'wx'});admit();
删除本地文件递归
lib/singing.js:276
await rm(directory,{recursive:true,force:true}).catch(()=>{});
写入本地文件
lib/group-conversations.js:61
const cwd=join(root,'groups',groupId,'members',senderId);mkdirSync(cwd,{recursive:true,mode:0o700});
读取本地文件
lib/qq-stickers.js:72
try{root=resolve(typeof localAssetRoot==='string'&&existsSync(join(localAssetRoot,'catalog.json'))?localAssetRoot:assetRoot instanceof URL?fileURLToPa
读取本地文件
lib/qq-stickers.js:76
const base=await realpath(root),body=await limitedFile(join(base,'catalog.json'),MAX_CATALOG_BYTES),manifest=JSON.parse(body.toString('utf8'));
读取本地文件
lib/qq-stickers.js:88
const path=join(base,entry.file),actual=await realpath(path);signal?.throwIfAborted();if(dirname(actual)!==base)throw unavailable();
写入本地文件
lib/storage.js:10
mkdirSync(dirname(path), {recursive:true,mode:0o700});
读取本地文件
lib/storage.js:11
try { this.value = JSON.parse(readFileSync(path,'utf8')); }
写入本地文件
lib/storage.js:21
try { await writeFile(temp,JSON.stringify(value,null,2)+'\n',{mode:0o600});await rename(temp,this.path); }
写入本地文件
lib/storage.js:21
try { await writeFile(temp,JSON.stringify(value,null,2)+'\n',{mode:0o600});await rename(temp,this.path); }
删除本地文件
lib/storage.js:22
catch (error) { await unlink(temp).catch(()=>{});throw error; }
读取本地文件
lib/speech-speed.js:32
try{await access(file,constants.X_OK);return file;}catch{}
读取本地文件
lib/local-assets.js:8
const base=await realpath(root),file=await realpath(resolve(base,name));
读取本地文件
lib/local-assets.js:10
const info=await stat(file);
发起网络请求
vendor/widget/lib/index.js:1262
res = await fetch(BALANCE_URL, {
发起网络请求
vendor/widget/lib/index.js:2342
const res = await fetch(u, init)
发起网络请求
vendor/widget/lib/index.js:3821
const req = https.get(url, { timeout: timeoutMs, headers: { 'user-agent': 'dsh-whale-widget', accept: 'application/json' } }, (res) => {
执行外部命令固定命令
vendor/widget/lib/index.js:3850
exec('npm view dsh-whale-widget version', { timeout: timeoutMs, windowsHide: true }, (err, stdout) => {
读取本地文件
lib/qq-media.js:4
const faceNames=new Map(Object.entries(JSON.parse(readFileSync(new URL('../assets/qq-faces.json',import.meta.url),'utf8'))));

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-tools@deepseek-ai/dsh-credentials@deepseek-ai/dsh-llm@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

README

由 DeepSeek 最新模型翻译生成

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，可选择音色、音量和语速。

展开完整文档（README 剩余 1 节）

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. 配置自己的大肥鱼

1. 角色：填写名字、称呼和提示词，选择陪伴会话，开启鲸鱼娘模式。
2. 语音：选择本地，或在 API 中选择「BreezeBlue 官方 API」／「OpenAI兼容 API」。填写对应密钥，读取并选择音色，检查连接后手动试听。各服务分别保存配置和密钥，首次安装的音色由你选择。
3. 记忆：开启陪伴记忆，查看宫殿中的事实与来源；需要保存到工作区时配置 memoryPalaceRoot。
4. QQ（可选）：运行 NapCatQQ 等网关，启用 OneBot v11 正向 WebSocket，保存地址与令牌，选择陪伴会话，再完成主号配对。群回复需逐群启用。
5. 通话与挂件（可选）：从会话顶栏或配置中心进入语音通话；按需开启挂件与触点音效。

服务地址、素材覆盖方式和详细步骤见 安装与配置。

使用 BreezeBlue 官方 API

在「大肥鱼 → 语音」选择 API → BreezeBlue 官方 API，默认地址为 https://api.breeze.blue/v1，模型为 breeze-tts-2。填写你自己的 API Key，点击「保存并读取音色」，选择音色或填写 voice_id，再检查连接、试听语气。云端路线需要可用的 BreezeBlue 账号和额度，语音模型由服务端运行。详细步骤与错误排查见 配置说明。

界面预览

记忆关系图

从人物、主题与事实之间的关系进入内容，查看来源，再进行更正或遗忘。长期记忆以文件保存，关系图是浏览入口。

记忆关系图：虚构人物、项目和偏好之间的关系

QQ 消息看板

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

QQ 看板：连接概况、消息摘要与语音表情状态，均为演示数据

简洁语音通话

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

语音通话：开始通话、文字区与模型选择，使用演示数据

架构与流程

插件如何连接各个能力

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

手绘系统架构图：DSH、大肥鱼插件、VoiceStudio、audio.cpp、Breeze TTS 2、NapCatQQ 与本机文件存储的关系

图中的 SenseVoice 表示参考识别配置，实际沿用 DSH 当前识别器。NapCatQQ 与插件使用 OneBot v11 正向 WebSocket 双向通信；私聊与群成员使用各自的会话及记忆范围。

上下文有限，记忆怎样延续

记忆分为「回复前读取」和「持久保存」两条链路。召回从本地索引取有限的相关事实；后台整理使用对话模型提取候选事实，再核对真实用户来源。

手绘记忆流程图：回复前召回，以及正常轮次和压缩前来源进入持久队列、提取与核验的过程

- 回复前：核对会话范围 → 本地检索 → 注入有限相关记忆 → 模型回复。当前最多召回 6 条，总注入不超过 3,600 字符；需要细节时可按 ID 精读。
- 完成本轮或压缩前：核对并过滤来源 → 写入持久待办 → 模型提取 → 证据核验 → 保存 Markdown 与索引。
- 压缩保护：合格来源安全入队后才允许压缩；事实整理可以继续在后台进行，来源写入失败时暂停压缩。
- 准确性与归属：保留来源与时间，更正优先、遗忘受墓碑保护；主人私聊、不同群和不同群成员分开存储。

新观察范围内的合格来源才会自动整理，已有事实与持久待办可以恢复。关闭记忆或离线期间未观察的历史不会自动补录；崩溃前尚未入队的内容仍可能丢失。长期保存与每次都能准确召回是不同的能力，当前检索以关键词、别名和结构化约束为主。详见 记忆宫殿。

同一音色如何表达情绪

开启情绪并选择本地 audiocpp 或 BreezeBlue 官方 API 时，原始回复分别进入台词清洗与语气判断：动作线索可以帮助判断情绪，实际朗读只使用清洗后的台词。两条支持链路均将台词、情绪指令和选定音色一起合成。

下图展示本地与 OpenAI 兼容服务的参考链路。BreezeBlue 官方 API 复用同一语气判断流程，通过官方原生接口合成。

手绘情绪语音流程图：原始回复并行生成朗读台词和情绪指令，本地与 OpenAI 兼容 API 分路合成，再校验、调速和输出语气判断复用 DSH 选定的对话模型，单独发起一次调用，不开放任何工具。台词作为 input，选定音色作为 voice，情绪指令作为 instructions，经 VoiceStudio 的 audiocpp 引擎传给 audio.cpp 与 Breeze TTS 2。BreezeBlue 官方 API 使用 text、model_id、voice_id 与 instructions，情绪强度传入 voice_settings.guidance_scale。走 OpenAI 兼容路线或关闭情绪时，直接使用清洗后的普通台词，不再额外调用语气判断。合成结果先做 WAV 校验，需要时由 FFmpeg 保音高调速，再由 DSH 播放，或经 NapCatQQ 发送 QQ 语音。最终效果取决于服务、音色与模型能力，需要实际试听确认。

本地数据与隐私

默认运行目录为 $DSH_HOME/dsh-dafeiyu-dot/；未设置 DSH_HOME 时使用 ~/.dsh/dsh-dafeiyu-dot/。

| 内容 | 保存位置与处理方式 |
| 配置、配对、运行状态 | 本机插件运行目录。 |
| 长期记忆、来源队列与遗忘状态 | 默认在运行目录的 memory-palace/，也可指定工作区位置；备份须包含隐藏的 .state/。 |
| 自定义角色图、表情与声音 | 运行目录的 assets/，由本机覆盖公开默认素材。 |
| API 密钥与网关令牌 | 通过 DSH 凭据服务管理。 |

内置记账挂件还沿用 DSH 数据目录下的 .dshw-*.json 账务/偏好文件、whale-roles/、whale-audio/ 和 whale-bubble-imgs/ 媒体目录，并兼容读取 profiles/web/ 下的对应位置。这些同样属于本机运行数据，备份或公开工作区时需要一并考虑。

配对主号的 QQ 私聊复用所选鲸鱼娘会话，以及该会话已启用的 DSH 工具权限；请使用自己的可信账号配对。群聊使用按群、成员隔离的会话与受限工具列表。

源码提供通用角色素材、10 张主题贴纸和可配置的默认值。个性化音色、账号配对、聊天记录、记忆及自定义素材属于运行数据，发布源码时应留在本机。

数据是否离开本机取决于所选服务：远程对话模型会收到对应的会话、召回内容及记忆整理输入，远程 TTS 会收到待合成台词。请按自己的数据需求选择服务。发布检查与素材来源见 发布与隐私、素材与许可。

故障恢复

- QQ 断线：按逐步增加的间隔重连，最高 30 秒；点击「重新连接」会打开插件内的 NapCat 扫码窗口，支持刷新二维码、手机确认后的自动恢复。首次填写自己的本机管理地址和 WebUI Token；密钥由 DSH 保管。账号发生变化时暂停自动恢复并等待核对。
- 送达状态不明：尚未确认的语音、文字和表情不会自动重发。
- 语音服务异常：先在语音页检查连接、模型与音色；QQ 语音合成失败时保留文字回复。
- 记忆整理失败：持久待办支持有限重试，管理页可查看失败并手动重试；保存失败不会标记为成功。

恢复步骤见 故障恢复。

开发与文档

npm test # 功能测试
npm run check # 入口与前端语法检查
npm run privacy # 公开源码与归档隐私检查

| 文档 | 内容 |
| 安装与配置 | 服务、音色、配对、素材和通话入口。 |
| 记忆宫殿 | 召回、来源、压缩保护、隔离与备份。 |
| 故障恢复 | QQ、语音与记忆任务的恢复方式。 |
| 验收方法 | 功能验证步骤与人工判断范围。 |
| 发布与隐私 | 源码、运行数据和公开归档的检查方式。 |
| 素材与许可 | 默认素材、演示截图及生成图的来源。 |

通话采用半双工交互，语音听感由使用者验收；QQ 可用性依赖网关及账号登录状态。提交问题时，请使用虚构复现数据，并去除凭据、账号和私人聊天内容。

许可与致谢

本项目源码使用 MIT License。记账挂件基于 dsh-whale-widget 扩展；角色提示词、Tabler 图标与挂件代码保留各自的许可声明，详见 第三方说明。

外部服务与模型遵循各自许可。Breeze TTS 2 的模型权重、衍生模型和自托管输出适用研究及非商业使用限制，具体范围见其官方许可说明；插件源码的 MIT 许可与模型许可分别适用。