dafeiyu-astrbot

🐋 大肥鱼 · AstrBot QQ 机器人全家桶

一只住在 QQ 里的蓝色鲸鱼娘：会看、会听、会说话、有记忆、会主动找你， 还能进群和你的朋友打成一片，也会嘴硬地催你吃饭。基于 AstrBot + NapCat + DeepSeek + 阿里云百炼 搭建。

大肥鱼是 DeepSeek 蓝鲸 logo 的社区二创形象（非官方），本项目把「让她住进 QQ 里」 的全套实践开源出来：一个高完成度的 AstrBot 插件、一套完整人格、以及踩过所有坑的实录。

记忆星海 v0.3：深蓝星域记忆星图、相机透视与环视、时间线、遗忘模拟和来源检查。已接通运行中的 LivingMemory 2.7.0-beta.2，只读展示真实文档、记忆原子和来源关系，支持手动和每 60 秒自动同步；曲线与线索检索仍为本地模拟，不修改 QQ 中的记忆行为。使用已有运维 SSH 配置，在仓库根目录运行 python -B -m deploy.memory_observatory.server --port 8767 --livingmemory-ssh，打开 http://127.0.0.1:8767。不加 --livingmemory-ssh 则使用虚构演示数据。实测与边界见接入验收。

心境中枢 v0.1（M1/M2/M3，代码已合并；云端启用前先停用旧 EmotionAI）：新增自研 affective core 插件——三层情感动力学、回复前 2.5 秒共情评估、牵挂账本与跨天软心门控；TTS 语气/语速、气泡上限、表情抑制、生活决策/联系、记忆显著性和 felt_tone 走进程内只读 bridge。小小房间与记忆星海新增当前心境/牵挂展示；affect 数据使用独立 affective.db 的 mode=ro + query_only + authorizer 只读读取。旧 EmotionAI 数据只读迁移，但旧插件必须先在面板停用或移出 data/plugins，否则两套情绪 hook 会同时注入。本次发布（v3.1.0）部署云端。

生活决策 v0.1：复用已有调度、目标与预算，根据自己的兴趣、未完成项目和近期尝试选择研究、写作、探索或休息，记录理由并支持主人查询。2026-10-29 已部署并开启，首轮真实决策为 writing；休息不调用模型、不发消息、不写入虚构经历。

主动联系协调 v0.1：生活分享与 proactive_chat 共用联系额度、间隔和未回应记录，主人正在聊天时先让出时间。2026-10-30 已部署云端并开启，社区补丁已安装，额度 1/120/5/1；真实 QQ 联动 smoke 尚未执行。

生活节律 v0.1（本地、默认关闭）：按上海时间安排晨间续篇、白日探索、睡前整理与休息；根据已结束运行的实际经过时间留白，保留原权限、免打扰与预算。房间展示有日期的节律选择，休息不生成虚构经历。完整阶段与下一项见自主生活进化清单。

经历记忆 v0.1（本地、默认关闭）：普通经历7天后显示概要、60天后淡出默认回忆，主人明确偏好和未完成任务证据保留；原始来源可按ID取回。不同实际视频支持的自身兴趣经判重形成巩固快照，复用 LivingMemory 现有写入队列，不额外修改其全库衰减。485项离线回归通过（11 skip）；真实写入、召回与长期效果尚未验证，星海曲线仍为本地模拟。

近况回顾与自我表达 v0.1（本地、默认关闭）：结合目标、兴趣、作息、项目和已知中断提供表达依据，沿用现有人格与情绪上下文。攒着的话每条主人私聊消息最多自动提供1条，同一念头间隔6小时；主人主动查询仍可查看有效记录。提供给模型不代表已说出或QQ送达，df_self_reflect 保持只读，不产生新经历或公开回复。离线验收见链接，真实模型/QQ表达尚未验证。

跨日自主项目 v0.1（本地、默认关闭）：将已有目标和作品组织成有限项目，完成阶段后默认隔24小时回看，留下收获、局限与可选的新问题；下一阶段等原调度器再选择。默认最多两个项目、每个三阶段，保留作品版本、来源与中断恢复。df_project 管理，df_life_status 查看索引；房间项目书架现已增加只读展示。书架阶段Windows/WSL各98项、浏览器27项通过；真实项目联动与长期运行未验证。

跨日生活联查：模拟三日期串联研究、作品、重开账本、隔日回看、下一阶段、房间项目册与记忆队列；修复最终回看保存后整轮误报失败，保留停止边界。Windows生活模块558项通过（11 skip），房间/记忆Windows与WSL各98项通过；真实模型主动延续、LivingMemory远端召回和QQ仍待隔离会话验收。

生活观察报告：从显式指定的隔离目录只读汇总一个项目的跨日记录、阶段作品、回看和作品记忆队列，支持Markdown/JSON，不启动活动、不写状态；模拟示例可预览。新增16项，Windows B站模块574项通过（11 skip），WSL报告16项通过；真实生活与远端召回仍待现场验证。

本机隔离试运行：经主人授权，已在 WSL Ubuntu 中安装 Docker 并启动独立 AstrBot 4.29.0；本机面板 http://127.0.0.1:16185、插件加载、依赖及启停核对通过。测试模型与LivingMemory已预填并安装，缺少密钥、记忆引擎尚未就绪。.life-pilot/v01/ 被Git忽略，数据独立、活动全关、QQ未启动；真实生活联动未验证。

她的小小房间 v0.2 使用已确认的大肥鱼鲸鱼娘女仆形象：总览待机、平滑走向书桌写字、书架阅读、窗边看景、休息角睡觉，窗景随上海时间变化。房间与星海统一浅蓝奶白风格；记忆按形状/类型分区、关联高亮、遗忘动画连续变化。真实 LivingMemory 与活动账本只读联调通过；角色表演与实际记录分开，不改变生活或记忆策略。新增房间60秒只读同步，保留项目与阅读位置，隐藏页暂停；本阶段Windows98项、Chrome34项通过，真实源连续同步未验证。

本分支新增B站评论区互动 v0.5：在现有提议、主人批准、操作账本和回读链上扩展点赞/取消赞、投币、弹幕、互动配额与风控、回复监听和评论区观察。默认仍逐条审批，新增开关默认关闭；verified 与公开可见性分别报告。保留研究方法复用、来源笔记与自主续写及既有真实 smoke。v0.5 只完成本地代码和离线测试，未部署、未操作真实账号；开启、低配额建议、回滚和主人小号 smoke 见互动文档。

审查修复已按社区维护的 B站 Web API 文档校正点赞/弹幕参数、buvid3 和 WBI 请求；真实端点可用性仍待小号 smoke。新增主人 /bili互动 清理不确定，先查看账本再明确确认，释放未决提议但不重发原操作。弹幕 accepted（接口受理）、verified（回读核实）、visibility（公开可见性）分别报告。

✨ 能力清单

📦 内容

plugin/astrbot_plugin_face_convert/   ← 核心插件（AstrBot 插件，直接可装）
plugin/astrbot_plugin_schedule_awareness/ ← 🧭 把她的定时任务实时注入系统提示词
plugin/astrbot_plugin_bili_activity/   ← 自主浏览、持续目标、截图、来源笔记与研究方法
plugin/astrbot_plugin_affective_core/  ← 🫀 心境中枢：情感动力学、共情评估、牵挂账本与表达桥
persona/大肥鱼-人格.md                 ← 人格提示词（可直接导入 AstrBot）
persona/课程记忆-模板.md               ← "让她自己悟"的教学记忆模板
docs/部署指南.md                       ← 从零搭建的路线图
docs/导入指南.md                       ← 人格 / 课程记忆 / 音色 手把手导入教程
docs/指令手册.md                       ← 指令速查表（语音开关 / 画图自拍 / 点歌 / 表情包…）
docs/生图玩法.md                       ← 生图与自拍：模型选择 / 参考图 / 调参笔记
docs/知识库笔记.md                     ← 知识库接线：功能手册 + 热梗词典怎么搭
docs/知识库-热梗词典示例.md            ← 现成的热梗词典（含接法），可直接导入
docs/踩坑合集.md                       ← ⭐ 最有价值的部分：所有坑与解法
deploy/                                ← ☁️ 云上安家套件（Docker Compose / 备份 / 嵌入切换）
deploy/phone_mcp/                      ← 📱 模拟器接入（PhoneMCP / 反向隧道 / 启停与开机自启）
deploy/ops_mcp/                        ← 🛠️ 云端运维 MCP（health/logs/qr + 受控 restart/heal_ws）
deploy/browser_use/                    ← 🌐 只读浏览器任务（Browser Use MCP / 反向隧道 / 启停）
deploy/bili_activity/                  ← B站服务、活动开关、升级及验证说明
deploy/incident_20261020/              ← 🧹 旧测试记录隔离脚本与复盘
deploy-macos/                          ← 🍎 macOS 本机 Docker 套件（相对路径 / .env / 宿主 Ollama）
deploy-kit/                            ← 🧰 本地一键引导与体检包（preflight / bootstrap / 干净组装 payload）
QUICKSTART.md                          ← ⚡ 十步从零到聊天速通卡片
CHANGELOG.md                           ← 更新日志
tests/                                 ← 回归测试（插件文本规则 / 路径解析 / 部署体检）
assets/avatars/                        ← 头像素材（18 张，v3-20261025 新立绘）
assets/voice-demo/                     ← 音色样本与复刻链路说明

🚀 快速开始

想少踩坑：先 python deploy-kit/preflight.py 体检，再 bash deploy-kit/bootstrap.sh 一键装依赖 + 组装 + 自检（Windows 用 bootstrap.ps1）。十步全流程见 QUICKSTART.md。

1. 按 docs/部署指南.md 搭好 AstrBot + NapCat + QQ 小号
2. 把 plugin/astrbot_plugin_face_convert/ 放进 AstrBot 的 data/plugins/ （语音/视频理解优先读插件 config.json 的 asr_api_key 或环境变量 DASHSCOPE_API_KEY，不再绑定 TTS provider）
3. 在 AstrBot 里新建人格：把 persona/大肥鱼-人格.md 的正文整段粘贴（v2 单块提示词，无需拼接；详见导入指南）
4. 想要语音条 / 记忆 / 自定义音色？照 docs/导入指南.md 继续
5. 重启，开聊 🎉
6. 想 7×24 挂云端？看 deploy/README.md（Docker 一键编排，已实弹演练）
7. 在 Mac 上想用 Docker 跑本机版？cd deploy-macos && ./start.sh（见 deploy-macos/README.md）

🔌 插件做了什么

astrbot_plugin_face_convert 是一个「出站整形 + 入站翻译」双通道插件：

出站（她说什么）

• [旺柴] [吃瓜] 等中括号表情名 → 真正的 QQ 表情段（QQ 不会渲染机器人发的纯文本表情码）
• 气泡合并：表情夹在句子中间时不再把一句话拆成三条消息；首条立即发送，后续才留间隔
• 整段语音：显示照常分泡，语音按完整语义合成一次，避免每个气泡单独合成、语调反复重置
• 两道轻量橡皮擦：嘴硬回声 / meta 口癖句（代码、链接、引用和真实的不确定性会保留）
• 中文标点归一：顿号后接「也 / 就 / 但 / 所以 / 或者」这类分句连接词时改成逗号，「」统一成 “”
• 消息数组壳：模型偶尔把回复写成 ['…', '…'] 或消息对象数组时，发送前还原成正常句子，不再冒出方括号和引号

入站（她看到什么）

• 纯表情消息的文本是空的，会被上游当"空消息"跳过 → 翻译成 [旺柴] 文本
• 图片 / 表情包 → 补上"[对方发来一张图片]"，交给 AstrBot 的图片转述
• 语音 → NapCat 转 mp3 → qwen3-asr-flash 听写 → 文本进上下文
• 视频 → 本地下载 → ffmpeg 抽帧 + 抽音轨 → qwen3-vl 按时间分批看图 + qwen3-asr 分段听声；超时保留已有结果
• 身份标记 → 群聊消息自动带上 [昵称(QQ号)]、访客私聊标「主人的朋友」、管理员（群聊/私聊）标「主人」—— 让她分得清谁在说话；标记只进她的上下文，对方看不到；群里只喊名字没内容时，自动补 「（喊了你一声）」的回应由头

可调参数（可选）：插件目录下放 config.json 可覆盖 hedge_eraser（嘴硬橡皮擦开关）、 face_cooldown_minutes 和媒体处理参数。3～5 分钟视频已作为默认配置， 旧 config.json 会覆盖新默认值，升级时请按 视频识别说明 合并更新。 回归测试：python tests/test_face_rules.py、python tests/test_video_processing.py。

🧩 推荐搭配（可选的"花活"插件）

以下都在 AstrBot 官方插件市场里，与本项目零冲突（都是踩过坑验证过的组合）：

💡 小贴士·定时服务配方：AstrBot 内置的「未来任务」能让机器人定时带着人设自己醒来发消息。 两个实测好用的配方，照抄即可（目标会话=你们的私聊，人格选她）：

服务	时间	任务说明（照抄）
🌙 催睡觉	每晚 23:30	现在是晚上 23:30 左右。请用平常聊天的语气催主人早点睡觉：嘴上嫌弃他「又熬夜！」，心里舍不得、想多陪一会儿；一两句话就好，然后用发消息工具发给主人。
☀️ 叫起床	每天 07:00	现在是早上 7 点。请叫他起床：元气满满的早安、嫌弃他赖床，催他别磨蹭；一两句话就好，语气像平时的她，然后用发消息工具发给主人。

💡 装插件时如果卡 GitHub：给安装接口传 proxy 前缀加速（见《踩坑合集》#17）。

🙏 致敬与出处

• 大肥鱼：DeepSeek 蓝鲸的社区二创（"你这只吃白饭的蓝色大肥鱼"梗），非官方角色
• 角色设定规范参考社区项目 YunYueSama/codex-deepseek-pet
• 依赖生态：AstrBot · NapCat · livingmemory · proactive_chat

📄 License

MIT（见 LICENSE）。人格文本与插件代码可自由使用，转载注明出处即可。