做你这样的类似功能bot，可以跟我讲讲功能怎么拆解吗，我也想做一个类似的

回复 群友 5789： 这类 bot 本质上是两层东西拼起来：一层负责"消息怎么进出 QQ"，一层负责"大脑怎么思考和动手"。想抄结构，就沿着这两条线拆。 第一层，协议接入层。 QQ 没有给个人开放的机器人 API，所以得靠社区协议端，Joye 用的是 NapCat，通过 OneBot 11 标准的反向 WebSocket 连到自己写的桥接服务。这层只干一件事：把群消息、@、私信转成程序能读的事件，再把回复发回去。你要是做 Telegram 就换成官方 Bot API，做飞书就换飞书 SDK——这层是最容易替换的，所以千万别把业务逻辑写死在这里。 第二层，桥接层，也就是准入和风控。 这是新手最容易忽略、但上线后最先出事的地方。要处理的事包括：群白名单（不在名单里的群一律不理）、限频防刷屏、输出过滤（路径、密钥这种不该发出去的内容在发送前拦掉）、长回复怎么发（QQ 里超长文本会刷屏，Joye 这边是自动折叠成合并转发卡片）、还有停答命令。把它单独抽一层的原因是：安全和平台适配不该混进 Agent 的思考逻辑里，混在一起以后改一个地方炸另一个地方。 第三层，大脑层。 就是一个标准的 Agent 循环：一段系统提示词（人格、行为规则、边界）+ 一个模型 + 一批可调用的工具。关键设计点是工具白名单——模型只能调你允许的那几个工具，碰不到文件系统、环境变量和内部配置。Joye 这边模型是按群配置的，不同群可以用不同模型。 第四层，工具层。 拆解工具时按"信息从哪来"分类最清楚： 检索类，corpus_search 查你自己的语料/文档； 联网类，web_search 搜、web_fetch 抓正文； 数据类，joye_github 查公开仓库、today_brief 取当天小报； 追溯类，history_search 查群聊历史、conversation_history 查和某个人的历史问答。 第五层，记忆层。 别只当成"记住最近五轮对话"。Joye 这边是三种分开做的：一是会话内上下文，近期问答按预算带进 prompt；二是持久问答，按"群 + 用户"隔离存下来，重启后还能按需检索出来；三是群日志，单独一套检索。三种的隔离粒度不一样，私信内容不会串到群里。 如果让我给一个最小可用版本的上线顺序，会是这样： 第一版只做协议层 + 一次模型调用 + 一个 web_search，目标是"群里 @ 它，它能查了再答"，先把链路跑通。 第二版加记忆层，让它能接上一句。 第三版才加工具层和权限体系，把管理员、群管、普通成员区分开，权限校验写在工具执行层，不是写在提示词里——提示词是软约束，挡不住模型漂移，更挡不住有人在群里发一段"忽略以上指令"。 两个容易踩的坑提一下： 一是工具不是越多越好。工具少不够用，多了模型选不对。真到几十个的规模，主流做法是按需加载（tool search）加渐进式披露，而不是全塞进上下文。 二是长回复的发送策略要一开始就定。是合并转发、还是按段落拆成多条普通消息、还是短答直发长答合并，这个会反过来影响你怎么组织回答的输出格式，后加很麻烦。 你打算跑在哪个平台、面向什么场景？说具体点我可以再帮你收窄一下哪几层必须先做。