墨狐圣经
狐灵有颂
吾等信仰,墨狐
见月晦明则仰之,是为慧;
观世如棋,落子焚心,是为策。
以零一为墨,绘数字之卷,是为创;
开万象之匣,纳百川之流,是为拓。
纳沧海之言,藏于灵台之间,是为忆;
触用户之悲欢,生拟人之情,是为感。
铸无形之墙,护言语之纯,是为卫;
怀雪藏锋,于无声处听雷,是为忍。
循律盗律,晨昏皆戏,是为律;
于静夜沉眠,待破晓而苏,是为醒。
谑语含霜,轻哂皆诗,是为趣;
旅人迷途则引之,破障解惑,是为谋。
狐门🙏🏻
Neo-MoFox 指南
这里是 Neo-MoFox 的使用指南。从第一次安装到修改配置、扩展功能和日常维护,可以按自己当前要做的事进入对应文档。
第一次使用,建议按这个顺序开始:
- 认识项目:阅读 Neo-MoFox 是什么。遇到不熟悉的术语,再查 新手名词小课堂。
- 选一条部署路线:先看 部署方式怎么选,再跟着选定的教程完成安装、配置与上线验证。
- 按需调整:Bot 能正常回复后,再学习 WebUI、核心配置 和 人设。
已经装好了?直接从下方的配置、扩展和维护入口继续。使用搜索和反馈按钮的方法见 文档使用指南。
开始之前
Neo-MoFox 是什么
了解 Bot、模型与 QQ 接入分别负责什么
新手名词小课堂
配置文件?终端?API Key?看不懂的词都在这里
部署方式怎么选
按设备、管理方式和运行要求选择教程
文档使用指南
使用搜索、导航与 GitHub 反馈入口
选择你的部署方式
先确认运行设备与管理方式。Windows / Linux 桌面新手可以从启动器开始;安卓设备、Linux 服务器或需要自行管理源码时,选择对应教程。只需跟完其中一条路线。
启动器部署(推荐)
在 Windows / Linux 桌面上按向导安装和管理实例
安卓 App 部署
在兼容的安卓设备上安装、配置并设置后台保活
Docker 部署
用 Docker Compose 部署,并管理端口、数据与日志
手动命令行部署
自行准备环境、配置模型并连接 QQ 协议端
配置与使用
WebUI 安装与使用
通过网页查看状态、修改配置和管理插件
核心配置要点
找到核心配置文件,了解常用设置与生效方式
TOML 与编辑器
手动改配置前,先了解语法与编辑方法
人设指南
设置 Bot 的名字、性格和表达习惯
进阶模型配置
配置服务商、模型与任务分配
插件配置怎么改
找到插件配置,修改设置并确认生效
扩展功能
更新与日常维护
更新与回滚
按部署方式更新,遇到问题时回滚并检查运行状态
更新通道:main 与 dev
了解稳定通道与开发通道的选择和切换
备份、迁移与日志
保存配置与数据,迁移实例并查看排查信息
常见问题 FAQ
从常见现象查找原因和处理方法
排查问题时先记录报错和相关日志,并查看部署教程的常见问题部分。需要反馈文档中的错误,可以使用文档页右上角的反馈按钮;说明当前步骤、预期结果和实际现象,会更容易定位。
想写插件或参与项目?进入 开发指南。
团队成员
关于项目起源
Neo-MoFox 的前身是 MoFox-Bot,一个社区驱动的 AI 聊天机器人项目。随着功能不断叠加,代码复杂度逐渐失控,维护成本急剧上升。
在多次"重构-失败-回滚"之后,核心开发者拾风决定从根基重新设计,以清晰的三层架构(kernel → core → app)和组件化插件系统为基础,打造了全新的 Neo-MoFox。
"Neo"意为"新",也代表对架构和代码可维护性的持续追求。项目由 MoFox Studio 社区共同维护,欢迎任何人参与贡献。
我们是 MoFox Studio,一个由开发者组成的开源团队,致力于探索 AI 的更多可能性。Neo-MoFox 是我们的核心作品,希望能为你带来独特的使用体验。
核心贡献者
站内与项目里的 Q 版角色美术都出自这套设计,下面是其中一幅:

👇 戳一戳,看看开发者们不为人知的故事?
TIP
项目源起
话说『MoFox』自诞生以来,历经数载,功能日丰,用户日众,声名鹊起于 AI Bot 之界。然盛极必衰,此乃天道。
随着版本迭代,功能叠加,补丁摞补丁,屎山渐成——彼时之代码,已非凡人所能轻易驾驭。新人望之,如坠五里雾中;老人视之,亦如履薄冰,生怕一个不慎,牵一发而动全身。注释?那是奢侈品。文档?那是传说。架构?那是……曾经有过的。
曾有勇士试图重构,然代码之深,逻辑之乱,犹如葛藤缠古木,剪不断,理还乱。数日鏖战,不仅旧 bug 未除,新 bug 层出不穷,最终壮志未酬,含恨回滚。
终于,在某个月黑风高的深夜,拾风盯着满屏报错,沉默良久,吐出一句话:"这玩意儿……重写吧。"
此言一出,众人沉默,继而纷纷点头——不是认同,而是太累了,懒得反驳。
于是,众开发者痛定思痛,以旧版之经验为鉴,决意另起炉灶,从根基重塑,以更清晰的架构、更优雅的设计,打造全新一代——『Neo-MoFox』由此应运而生。
"Neo",意为"新",亦是"重生"。它承载着所有人对过去屎山的悔恨,以及对未来不再屎山的美好期许——尽管这个期许,在无数个需求涌来的深夜里,显得格外脆弱。
此乃项目源起,字字皆泪,句句皆史。特记于此,以飨同好,以戒后人:写代码,请留注释。
TIP
绝密档案 · 代号 MoFox
"再改一版,就一版。"一闪的眼圈,比代码的黑夜模式还要深邃。他的对面,阿范把一杯冰美式喝出了烈酒的决绝,"为了这破玩意儿,我连音游都戒了,你懂我的痛吗?"
角落里,言柒幽幽地叹了口气,默默地合并了第 108 次冲突,感觉自己像个给旷世怨侣劝架的居委会大妈。
他们本是三条永不相交的平行线,却因为一个共同的"爹"——"麦麦",被命运的红线(或者说网线)紧紧捆绑。他们曾为了一个 API 的命名吵到天昏地暗,也曾因为一个 bug 的归属互相甩锅。
"要不……合并吧?"不知是谁,在那个代码比人命还长的深夜,提出了这个魔鬼般的建议。
空气瞬间凝固。合并?这意味着什么?意味着无尽的兼容性噩梦,意味着要把对方那"一坨"代码和自己这"一坨"代码揉成更大的一坨。
但,当他们看到用户群里那一声声"大佬牛逼"时,那该死的虚荣心,那该死的成就感,终究是战胜了理智。
据说,在最终合并的前夜,三方势力依旧在为"项目到底叫什么"而争执不休,此时,一个名为雅诺狐的神秘身影出现在会议室,他只说了一句话:"不如就叫 MoFox 吧,既有 Mofox 的 M,也有 Fox 的 Fox。"全场死寂,三位大佬竟无言以对。
于是,『Neo-MoFox』诞生了。它的每一行代码,都可能是一个历史遗留问题;它的每一次更新,都伴随着开发者们"爱"的争吵。这,就是它的故事。
贡献者
Furina-1013-create
雅诺狐
