鱼魂 Britneycode/dsh-fish-soul

dsh-fish-soul

让 QQ 小号背后有「同一个人」：固定人格、按人记记忆、有自己的生活节奏、会主动开口；同一个「她」同时出现在 QQ、B站、抖音。

DSH 插件（单角色 feiyu）。版本 0.13.1。

能力

| 面 | 内容 |
| 人格 | 设置页「人格」：7 个内置模板一键换上（第一个「肥鱼 · 通用」只定性格和说话方式、生活细节聊着聊着才有，后面 6 个带现成的生活细节）、可视化编辑、导入 / 导出 SillyTavern 角色卡（PNG / JSON）、撤销上次更换，换完下一轮生效；角色卡（PNG / ccv3 / chara），{{char}} / {{user}} 宏，世界书（constant / 关键词，可单独导入多本 SillyTavern 世界书：正则 / 整词 / 次要关键词、扫描深度、条数和字数预算）；卡里的作息（extensions.fish_soul.routine）用来排每天的日程、「看事情的方式」（perspective）进人格段、「不同心情下怎么说话」（moods）跟着她当下的心情带上；模板按气质分、不绑职业；聊久了会「慢慢长」（性格 / 看法的变化要多次、跨天、跨聊天的证据才生效，人格页可看可删）；从群聊 / 好友私聊里学梗、说话风格和「什么场合怎么说」（只学别人的话、不带人名，按学到的次数挑几条参考） |
| 记忆 | 按人隔离、本轮即时召回（BM25 + 向量 RRF）、艾宾浩斯衰减（重要度高不淡）、可纠正（留旧档）、出处 evidence、每人 ≤150 字印象、8 栏结构化印象、关系阶段演进、好感与情绪、旧聊天记录导入（断点续传，较早的聊天按时间段总结）、导入麦麦的表情包 / 表达方式 / 黑话、记忆页搜索与批量操作（删除 / 恢复 / 重要度 / 私密）；聊完自动记（一次调用产出事实 / 事件 / 感受 + 一句话小结，去重合并）；隐私：私聊里的敏感记忆标 private，群里检索和召回都不带 |
| 生活 | 虚拟时钟、每日作息与基调、Dream 整理（只补没写的、会标过时）、主动开口与配额 |
| QQ | 直连 SnowLuma（OneBot 11 正向 WS）：私聊 / 群聊、群合批带署名、只听点名、戳一戳、撤回不回、可选插话、打字节奏、/鱼 暂停；群默认拒绝（groupAllowList 为空且没开 allGroups 时谁都不回）、没发出去的回复排队重发（退避重试，连上即补发，重启不丢） |
| B站 | 扫码登录、私信（只读 / 自动回复）、跨平台认人、空闲自己刷视频（看字幕 / 热评 / 弹幕，喜欢可点赞、想再看可收藏，站内搜索当又一个来源，后三个默认关）、自己发动态 / 回评论（默认关；可选别人评论区里 @ 她也回，@ 时先读一下视频）、Cookie 自动续期、发图 |
| 抖音 | 专用浏览器扫码登录、私信（只读 / 自动回复）、群聊按人区分（被叫到才回，默认关）、canary 防风控、空闲刷视频、刷到的分享发抖音私信、自己发图文 / 回作品评论（默认关，尽力而为）、表情包复用 |
| 习惯 | 心情影响说话（快慢、长短、插话概率、表情包多少）、去 AI 味（删 markdown / AI 自称 / 套话，太长按句末截）、每晚写日记（私密记忆，第二天想跟谁聊）、合并转发展开、每个群的设定（气氛 / 忌讳）、按聊天选模型、群冷热、记忆调试器（输一句话看会想起哪几条）、戳回去 / 表情回应 |
| 语音 | get_record → STT；回复 [语音] → TTS 发 record（失败 / 太长发文字）；听 / 说可以各配一套地址和 key（TTS 支持小米 MiMo） |
| 模型 | 按功能选模型、按天 × 功能 × 模型统计用量与花费、可选上网查 |
| 运维 | 单聊天暂停、动态页、每日自动备份（留 7 份，设置页可恢复到某一份，重启生效）、设置文件读不懂时拒绝覆盖（带 BOM 也能读）、记忆导出 / 原样导回；设置页顶部显示当前版本，自动检查更新（npm / GitHub，每 12 小时，只提示不安装，可关） |

安装

需要 Node ≥ 22.5。抖音专用浏览器需要一台常开的 Windows 桌面。

从 npm：

dsh plugin --profile desktop add dsh-fish-soul

本地源码：dsh plugin --profile desktop add ./dsh-fish-soul。

手工等价：profile 的 package.json 把 dsh-fish-soul 加进 dsh.profile.bundles，并在 dependencies 里写 dsh-fish-soul 的版本（本地源码则用 link: 路径），然后 pnpm install。

插件注入 webServer / tools / systemPrompt / llm / agents / workspaceRegistry，设置页在 DSH 的插件设置里（「人格 / 记忆 / QQ / B站 / 抖音 / 自走 / 模型 / 习惯 / 动态」）。

已在 DSH 0.2.1-rc.5 上验证；更早的 rc 版本未逐一验证，遇到问题请先升级复测。

设置页读不到时怎么分辨：

- HTTP 404：插件后台根本没加载（或宿主没把 /api/plugins/fish-soul/ 转给插件）。看宿主日志里有没有 [fish-soul] 启动闸门已挂。
- 503「插件还在启动 / 插件启动失败，挂在第 N 步…」：插件加载了，但初始化还没走完或中途失败。宿主日志里有对应的 [fish-soul] 启动失败：挂在第 N/M 步「…」 和错误堆栈；走完会打 [fish-soul] 路由已挂。

配置与数据

$DSH_HOME 缺省 ~/.dsh。

| 路径 | 内容 |
| fish-soul-config.json | 全部设置（含 embedding apiKey） |
| fish-soul/soul.db | 单一 SQLite：记忆、人物、日程、会话映射、向量、kv |
| fish-soul/persona.json / persona.png | 人格卡（json 优先）；设置页改过的存成 persona.json，旧的进 persona-backups/（留 20 份），persona.prev.json 用来撤销 |
| fish-soul/bili-auth.json | B站凭据（0600，类 Unix 上） |
| fish-soul/douyin-browser/<浏览器>/ | 抖音登录态（专用浏览器 profile） |
| fish-soul/workspace/ | 默认专用工作区「鱼」，表情包在 _stickers/ |
| fish-soul/backups/ | 每日 VACUUM INTO 备份 |
| fish-soul/img-cache/ | webp → png 缓存 |

目录

lib/
index.js 插件入口：配置 schema、工具、瞬态块、路由 db.js soul.db、DDL、身份映射 retrieval.js BM25 + 向量 RRF、单队列双优先级 worker segment.js 中文分词（Intl.Segmenter）与停用词 life.js 虚拟时钟、作息、Dream、主动开口 clock.js 虚拟钟 / 物理钟隔离 soul-memory.js 聊完自动记、检索词组装、关系阶段、印象、情绪 behavior.js 心情影响行为、去 AI 味、日记、记忆调试 gateway.js QQ 会话 / 群合批 / 工具护栏 gateway-behavior.js 网关里的习惯（v0.9 混入） gateway-media.js 网关里的图片 / 私信（混入） llm.js 按功能路由模型（LlmRouter） voice.js 语音收发（听 / 说可分开配） stickers.js 表情包收藏 slang.js 学说法：梗、说话风格、说话方式 persona.js 角色卡解析、规整、保存 / 撤销 persona-templates.js 内置人格模板 growth.js 她慢慢长出来的变化（证据、生效、退场） social.js B站 / 抖音共用的发动态与回评论（SocialBase） douyin-social.js 抖音发图文、回作品评论 browse.js B站自己刷视频 websearch.js 上网查 importer.js 记忆导入 history-import.js 聊天记录导入（txt / jsonl / json / MaiBot） backup.js 备份与导出 channels/ snowluma / onebot / bilibili / douyin client.js 设置页（按需加载） routes*.js HTTP 路由（v07 / v09 / persona / douyin / soul） test/ smoke.mjs 模拟宿主的主流程（依次跑 smoke-v05 ~ v09、smoke-persona、smoke-social 子套件） douyin-browser.mjs 真 Chromium + 假 www.douyin.com eval/ 真模型评测：persona-eval（人格 19 场景）、growth-eval（慢慢长）、inject-eval（防注入）

测试

npm test # 模拟宿主 + 真实 headless Chromium 跑两套；找不到 Chromium 系浏览器或 openssl 时，浏览器用例自动跳过
npm run eval # 用真模型做人格评测（规则 + 模型评审，需要配好可用的模型），结果写在 test/eval/reports/

许可

MIT