项目已在linux.do公开声明https://linux.do/
面向 Windows x64、微信 4.1.15.13 的 Python 插件框架。统一入口为 main.py，原生桥接负责文本收发与群图片接收，功能以插件加载。
完整操作说明见使用手册。已有用户可运行 python tools/migrate_memory.py 升级本地配置及数据库，再正常重启机器人。
本 fork 的维护仓库为 Inmata/helper，原始项目为 Prometheus-first/helper。日常更新从自己的 fork 获取；原项目保留为 upstream，按需评估后合并。
- 文件传输助手、好友和群聊文本收发，以及真正的群艾特。
- 成语接龙：全群合作闯关，默认接对 10 次通关；内置 29,502 条词库出题并保留常用接法，接法不足时逐级放宽，接不上可换开头续接，支持进度、个人贡献、提示、换题和胜负结算。普通群聊不受打扰，重启保留进度及帮助次数。详见接龙说明。
- 自动读取群成员的微信昵称；普通成员无需自助绑定，人物档案由管理员使用
/绑定维护。 /总结 昵称 [条数或今天]、/总结群聊 [条数或今天]：默认总结最近200条，可跨天。- 固定熟人损友语气；旧人格切换指令只显示兼容提示。
- 真正艾特机器人后，结合本人最近10条、全群最近50条和检索到的长期知识回复。
- 艾特时按需看图与联网搜索（本机 Magpie 工具，Jev 判断是否需要）：提问里明确说“看图、图里、这张图”时直接看；引用图片或 2 分钟内发的图（优先自己的，没有则认别人的）可识别；先发图、再单独艾特（只有艾特或很短的一句，字母和数字合计不超过 4 个）时自己刚发的那张直接看；回复不带网址，看图需要 V4 桥接。
- 原文与知识长期保存；管理员
/清空仅重置对话上下文，保留历史和知识。 /档案、/记忆、/纠正、/忘记：查询和维护有来源的成员资料、语言习惯与群梗。- 唯一维护者可在群聊、私聊使用
/管理；服务器控制台和离线命令行共用维护逻辑，支持人物、别名、知识归属、清空重学和操作历史。 - 可配置多份更新公告：按配置顺序，每次完整启动尝试发送尚未成功的公告；已发送成功的版本重启后自动跳过，失败或结果未确认的继续重试。
- 启动问候：没有待发公告时，每次重启在默认维护群说一句“来了”；有公告要发时改发公告。
- 可配置自动学习，以及北京时间09:00—23:00、参考近期群聊活跃度的随机主动发言。
- 按文本长度随机等待后发送。
- 插件启停、重载与开发模板。
Windows 10/11 x64、64 位 Python（已验证 Python 3.13）、requirements.txt 中的依赖，以及 Microsoft Visual C++ x64 运行库。
在项目目录运行：
python -m pip install -r requirements.txt
python tools/init_config.pybot_config.json：将wechat_account改为自己的机器人微信 ID。绑定保存的是账号 ID，重新登录后 PID 改变不影响选择；多开时会等待指定账号，不改用其他账号。members_config.json：在groups中添加自己要启用的群 ID，成员列表可以为空：
{
"database_file": ".runtime/member_data.sqlite3",
"history_enabled": true,
"daily_clear": false,
"owner_wxid": "wxid_example_owner",
"groups": {
"12345678@chatroom": []
}
}llm_config.json：填写自己的api_key、base_url和model。模板保留 DeepSeek 接口格式，密钥为空。- 模板默认关闭需要模型的
idiom_chain、chat_summary、mention_chat插件。填写模型配置后，把它们的enabled改为true。
owner_wxid 必须填写维护者本人账号，不能填写机器人本号。留空时聊天维护关闭，服务器命令行仍可用。旧 admin_wxids 不再授予权限。
账号 ID 必须是实际微信 ID；群 ID 以 @chatroom 结尾。test 消息会由 id_responder 插件回复当前会话 ID，chats 控制台命令可以列出本次连接收到消息的会话。所有示例 ID 和测试用名称均为虚构数据。
python main.py --check
python main.py--check 只检查配置、插件清单与语法，不注入微信，也不调用模型。正常运行前打开微信并登录配置中的账号。
也可以运行 start_bot.ps1：脚本优先使用项目的 .venv，其次使用 PATH 中的 Python；可通过 -Python 或环境变量 WXBOT_PYTHON 指定解释器，不依赖某台电脑的安装路径。
想关掉终端后继续运行，用 bot.cmd start（或 tools\bot_ctl.ps1 -Action start）通过计划任务后台启动，bot.cmd status 查看状态，bot.cmd stop 发送 quit 并等待桥接清理。详见使用手册第二节“后台启动与停止”。
控制台命令：
status
manage --room 群ID 帮助
chats
members [群ID]
history 称呼 [条数]
plugins
enable 插件名
disable 插件名
reload [插件名]
quit
增加群、修改账号或成员配置后重启。停止时使用 quit，等待正常卸载原生桥接；微信可以保持打开。
wechat_account 设为 null 时，原生收发层可以选择唯一登录账号；启用成员目录和群记录需要明确配置机器人账号，以隔离不同账号的数据。
| 目录 / 文件 | 职责 |
|---|---|
main.py |
统一入口 |
bot.cmd、tools/bot_ctl.ps1 |
后台启动、停止与状态；守护进程见 tools/bot_daemon.py |
wxbot_framework/ |
框架：app 应用层、conversation 会话、memory 记忆、messaging 消息、plugin_engine 插件引擎、storage 存储、integrations 适配 |
plugins/ |
各功能插件、共享只读契约（_shared）和开发模板（_template） |
native/ |
原生桥接源码、两个必要 DLL、版本指纹和 MinHook |
tests/ |
本地测试 |
tools/ |
本地配置初始化和发布前检查 |
docs/ |
计划、评测与架构配图 |
.spec/ |
架构与功能行为规范，每项一个 .spec/<id>/spec.md |
目录职责、依赖方向与扩展落点见架构规范。