QQ机器人

这是什么

跑在自己服务器上的一只 QQ 机器人，形象是一条蓝色的大肥鱼： 蓝发蓝眼、鲸鱼鳍耳、白色蕾丝女仆装、胸前围裙上缝着一只小鲸鱼、身后拖着蓝尾巴。 她自己有名字有脾气，会陪聊、会记账、偶尔吐槽。 可以完成一些小任务。

架构

• 机器人框架：AstrBot + NapCat，Docker 部署
• 模型：DeepSeek 系对话模型（思考档位可调）
• 反向代理：Caddy，静态资源本地化托管
• 管理：面板 + 命令行，改动走 Git 提交

主要功能

• 表情包库 — 自动收集群里出现的表情包，视觉模型自动分类打标， 支持按情绪/关键词检索，库里五百余张，随时能被”顺手发一张”。
• 视频解读 — 收到 B 站分享卡片自动抽取字幕或语音转写，产出结构化总结。
• 长期记忆 — 向量检索 + 记忆注入，跨天记得住聊过的事。
• 主动聊天 — 会按节奏自己冒头打招呼，语气和作息都能感觉到。
• 市场ai软件大部分功能 — 文档处理能力，Word、PDF、Excel 的读写和转换、做表格做图，看图做图，后续可以按需求增加生成能力、语音能力、多端能力。

运维要点

• 端口收敛：对外只留必要入口，反向连接用的端口绝对不动。
• 面板首屏优化：静态资源全部本地化 + 反代压缩，主包从 4.5 MB 压到约 1.3 MB。
• 补丁管理：对第三方插件的本地修改都留说明文件，写明症状、锚点与重打方式。
• 密钥纪律：临时密钥最小权限、限时、用完即删。

踩过的坑

• 插件升级会覆盖本地补丁，改完必须写进说明，否则下次升级就”复活”。
• 有些补丁重载插件不生效，必须重启进程。
• 容器内用公网地址测自己的端口会被网络转发截走，得从外部节点验证。