基于 nanbengxian-cyber/dafeiyu-qq-bot(上游,公开)的 WSL2 / Docker 本地部署快照。这里记录的是「我在自己机器上怎么把它跑起来、改了什么、加了哪些插件」, 不是上游原创。
upstream : nanbengxian-cyber/dafeiyu-qq-bot 上游原作者
origin : zzyoxml/dafeiyu-deploy 本部署仓库
本仓库只存部署配置 + 插件源码 + 复现脚本,不含运行期数据、模型权重、密钥。 克隆后需先手动加远程(git 不会把 remote 存进仓库):
git remote add upstream https://github.com/nanbengxian-cyber/dafeiyu-qq-bot.git git fetch upstream && git log upstream/main --oneline -5 git diff HEAD upstream/main --stat
cp robot.env.example robot.env # 填自己的 key(见「密钥」)
bash _setup.sh # 首次部署:建目录、生成 token、装插件
docker compose up -d日常操作(Windows 侧双击即可):start.bat / status.bat / stop.bat,
详见 使用说明.md、README-部署工作区.md。
QQ ── NapCat(Docker)── AstrBot(Docker)
│
├── 67 个 dsh-* 插件(data/astrbot/plugins/)
├── 生图:智谱 cogview / Agnes / pollinations
├── 语音:Edge TTS + RVC 流萤音色
└── 唱歌:yt-dlp + demucs + RVC
Windows 侧:guard.sh 守护 + 开机自启
完整清单在 data/astrbot/plugins/。 下面是按用途分组的主要能力,标 ★ 的是有独立文档的。
| 插件 | 能力 | 文档 |
|---|---|---|
| dsh-imagegen ★ | AI 文生图:群友 /画图 描述、自然语言「画一只猫」、LLM 工具、模型只嘴上答应时的兜底、主动概念草图;机器人自己还有 5% 概率把当前群聊话题画成一张图;主备模型降级、冷却、并发、统一画风 |
画图功能搭建与接入指南.md |
| dsh-voice | TTS 语音(Fish Audio / 悟声 / Edge 兜底),/说话、LLM 工具 |
|
| dsh-voice-liuying | 普通回复 20% 概率自动出语音,Edge TTS → RVC 换流萤音色,/流萤说 |
自建插件说明.md |
| dsh-sing | 点歌 AI 翻唱:yt-dlp 搜歌 → demucs 分轨 → RVC 流萤音色,带 LRU 歌曲缓存 | 同上 |
| dsh-video | 抽帧理解群视频、/做视频 后台出片、概念短片 |
|
| dsh-sticker / dsh-steal | 表情包贴纸;偷群里反复发、能看懂意思的表情包 | |
| dsh-vischain / dsh-imgctx / dsh-listen / dsh-stt-clean | 识图主备链、图片上下文、语音转写、STT 结果清洗 |
dsh-persona-core(人格核心)、dsh-mind(内在状态总线)、dsh-emotion(单一主情绪)、
dsh-will(被踩线时的执行层)、dsh-desire(分层动机)、dsh-agency(自主意志协调)、
dsh-selfaware(机器自我感知)、dsh-selfworth(不认账/不自贬)、dsh-fatigue(话题疲劳)、
dsh-interest(兴趣时间线)、dsh-social(社交距离)、dsh-poke(戳一戳)、
dsh-scene(群级背景与作息)、dsh-drift(注意力漂移)。
dsh-decide(该不该插话)、dsh-human(真人打字形状)、dsh-humanizer、dsh-aiflavour(拦截说教腔)、
dsh-typo(低概率同音错别字)、dsh-noise(真人噪点)、dsh-style(模仿本群短句)、
dsh-slang(群聊黑话学习)、dsh-glossary(黑话词表)、dsh-homophone(谐音识别)、
dsh-quote / dsh-quoteref(引用关系与引用回复)、dsh-mention(智能 @)、
dsh-merge(艾特风暴重扫)、dsh-followup(免艾特续聊)、dsh-repeat(复读)、
dsh-clarify(语境疑问闸门)、dsh-spine(累积牵引感知)、dsh-effect(回复效果观察)。
dsh-acl(指令权限三档)、dsh-guard(违规判定与禁言)、dsh-claimguard(拦虚构战绩/支配称呼)、
dsh-armor(防破甲/提示词注入)、dsh-leakguard(防系统提示词泄露)、dsh-factguard(自身属性事实表)、
dsh-selfguard(出口自制力)、dsh-reply-guard(限流 10 条/60s)、dsh-mute(群内禁言)、
dsh-joinguard(入群 AI 审核)、dsh-welcome(入群欢迎)、dsh-pay(收款引导)、
dsh-awake(唤醒判定)、dsh-ctxclean(清理陈旧注入块)。
dsh-memory(分层长期记忆)、dsh-awareness(群事件感知)、dsh-awareness、dsh-initiate(冷场主动开口)、
dsh-proactive(兴趣探头)、dsh-web(联网搜索)、dsh-qzone(QQ 空间说说)、
dsh-fwd(合并转发消息)、astrbot_plugin_anysearch(免费联网检索)。
早期 6 个自建插件的设计思路与踩坑实录见 自建插件说明.md。
CodeBuddy CN(buddy 渠道)无法调用模型的修复,已单独开源为 zzyoxml/ofm-buddy-channel-fix (含一键补丁脚本与完整定位文档)。
docker-compose.yml NapCat + AstrBot 编排
robot.env.example 环境变量模板(真实密钥不进仓库)
_setup.sh 首次部署脚本
data/astrbot/plugins/ 部署中的插件(自建 + 上游 + 第三方,67 个)
repo/plugins/ 上游插件原始拷贝,用于对照改了哪些
patches/ NapCat 等第三方组件适配
docs/ 专题文档(画图接入、自建插件、wslconfig)
probe/ WSL 部署/排障脚本 + 一键补丁脚本
dafeiyu-local/ Windows + WSL2 本地部署包(指南、模板、探针)
win/ wsl/ Windows / WSL 侧启停与守护脚本
*.bat / guard.sh / ... 工作区根目录的日常操作入口
真实密钥不在本仓库,以下文件已被 .gitignore 排除:
robot.env—— 智谱 key、OneBot token 等cmd_config.json—— 面板密码、JWT secret、ws_reverse_tokenonebot11.json、运行期图片/日志/*.pth模型权重
首次部署:
cp robot.env.example robot.env
# 编辑 robot.env 填入你自己的 key
chmod 600 robot.env
⚠️ 含真实凭据的本地文件与运行期图片在.gitignore里已逐项排除; 提交前脚本probe/secret_audit.sh、probe/find_secrets.sh可再扫一遍。
仓库只含源码(约 7.4MB)。以下约 3.2G 全被排除,由脚本重建:
| 排除项 | 体积 | 重建方式 |
|---|---|---|
sing/venv/ |
~1.9G | probe/install_sing.sh |
sing/model/、sing/rvc/ |
~590M | 同上(自动下载权重) |
temp/、stickerthief/、audio/ |
~680M | 运行期自动生成 |
流萤唱歌技能包(代码部分)在 dafeiyu-local/sing-skill/; 模型权重按包内 README 重新下载。
| 文档 | 内容 |
|---|---|
| 画图功能搭建与接入指南.md | AI 画图:怎么搭、群友怎么用、5% 随机生图、防刷、FAQ |
| 自建插件说明.md | 早期 6 个自建插件的设计与踩坑 |
| ofm-buddy-channel-fix | CodeBuddy CN 渠道修复(独立开源仓库) |
| 使用说明.md | 日常双击操作、面板地址、群里怎么用 |
| README-部署工作区.md | WSL2 本地部署包说明 |
| patches/README.md | 对第三方组件做过哪些本地适配 |
| probe/ | 部署与排障脚本,每个都带注释说明解决什么问题 |
- CPU 推理:60 秒的歌约 3.5 分钟(demucs 占大头);RVC 只能单实例(
asyncio.Lock)。 - Edge TTS 可能间歇 403:微软校验 Chromium 版本号,需
edge-tts >= 7.3.1; 合成强制走挂载卷sing/venv,容器重建不受影响。 docker restart不重读env_file:改robot.env后必须docker compose up -d --no-deps --force-recreate astrbot(见画图指南 2.3 节)。- 本地部署 = 电脑关了机器人就下线;QQ 有风控,建议用小号。
- 部分渠道(如 WorkBuddy)需要单独登录凭据,未配置时返回「未配置凭据」。