{"id":19894321,"url":"https://github.com/vescrity/qbot_jiemeng","last_synced_at":"2025-10-31T20:03:15.352Z","repository":{"id":163919203,"uuid":"550198726","full_name":"Vescrity/QBot_Jiemeng","owner":"Vescrity","description":"适配OneBot, C++开发的QQ聊天机器人","archived":false,"fork":false,"pushed_at":"2024-04-13T15:37:33.000Z","size":18625,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-14T01:51:26.686Z","etag":null,"topics":["chatbot","onebot","qq"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vescrity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-10-12T11:09:09.000Z","updated_at":"2024-04-15T02:26:54.956Z","dependencies_parsed_at":null,"dependency_job_id":"54409612-a1f8-4ac9-96d5-7d670b954351","html_url":"https://github.com/Vescrity/QBot_Jiemeng","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vescrity%2FQBot_Jiemeng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vescrity%2FQBot_Jiemeng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vescrity%2FQBot_Jiemeng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vescrity%2FQBot_Jiemeng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vescrity","download_url":"https://codeload.github.com/Vescrity/QBot_Jiemeng/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252103874,"owners_count":21695381,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","onebot","qq"],"created_at":"2024-11-12T18:33:13.965Z","updated_at":"2025-10-31T20:03:15.332Z","avatar_url":"https://github.com/Vescrity.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QBot_Jiemeng\n\n[文档](https://vescrity.github.io/Jiemeng_Doc)|[样例](https://github.com/vescrity/Jiemeng_Example)\n\n桔梦(QBot_Jiemeng)是一个以 Onebot 标准的实现项目作为前端的 bot 项目。以词库匹配作为核心机制。\n\n## V26 计划\n\n- 将部分逻辑转移至 Lua 。\n- 理清处理逻辑，完善文档。\n- 词库是否应转为 Lua 表以实现与 Lua 更好的集成？\n- 标准化配置文件夹\n\n## 说明\n\n- 本说明适用于 v25\n- 项目主要用于个人开发练习。\n- 本说明用于介绍桔梦基本功能，组成，并帮助您快速上手。\n- 具体的详细说明请参照进阶说明。\n\n## 提示\n\nv25 为功能较为完善、稳定、易拓展的版本，但文档和处理逻辑仍不够完善。计划将于 v26 进行改善，不能保证兼容性。\n\n\n- 以下内容弃用/施工中\n\n---\n\n## 平台\n\n### 验证可用的平台\n\n- Linux-x86_64\n- Linux-aarch64 (Termux Proot-distro 内可构建、可使用)\n\n### 不支持的平台\n\n- Windows 等*非*类 UNIX 环境: 完全放弃兼容。\n\n## 已实现的特色应用场景举例\n\n1. 定时消息\n2. 远程指令执行\n3. 可简易配置的第三方api调用\n4. 用于 [Dice!](https://github.com/Dice-Developer-Team/Dice) 的牌堆调用兼容\n5. 群聊检测到满足条件的信息向 bot 主或特定群聊上报消息。\n\n\n## 特色\n\n### v25 新功能：Lua 脚本支持\n\n可以编写 Lua 脚本来一定程度上更自由的控制 Bot 了。\n\n### 词库配置为中心\n\n#### “一切皆消息”\n\n将所有的事件都转换为文本消息来处理，以“收到消息——词库检索——执行应答”的流程处理所有事件。\n\n#### 检索条件：使用正则表达式，\n\n- 为了解决使用单一正则表达式表达复杂的匹配逻辑时的困难与难以阅读，利用 json 数组的结构特点优化了表达\n\n#### 较复杂的应答选取逻辑\n\n- 提供了可调控概率的应答随机选取方法。\n- 树状逻辑的应答库嵌套，即一个应答可以是若干的应答的组合，可实现更丰富的应答。\n- 例如你预想的应答可分为3个部分，使用桔梦你可以很轻松的使你的随机输出可包括例如`A` `B1` `C2d` `3a` `Cb` 等等任意组合。\n\n#### 从应答库到控制一切\n\n结合 Lua，几乎可以控制 Bot 的所有行为。而应答库则可以为这个控制提供接口。将你需要的行为使用 Lua 实现，再将它注册到应答库中即可。\n\n\n## ~~开发者的一些废话~~\n\n~~非计算机相关专业，纯业余开发，技术稀烂，代码可读性极差，总之图一乐~~\n\n## 构建\n\n- 依赖：\n  - cmake\n  - g++\n  - nlohmann-json\n  - lua\n  - sol2\n  - boost\n\n\n执行 `./build.sh` 可在 `build` 目录下构建基础的工作文件夹。\n\n\n## 运行依赖\n\n- boost\n- lagrange 等支持正向 WebSocket 的 OneBot 实现\n- python(可选)\n- ...\n\n\n\n## 使用说明\n\n### 快速开始\n\n#### 1. 修改 `config.json`\n\n1. 将 `Self_ID` 字段的值改为 bot qq 号\n2. 在 `group_list` 中添加你想启用 bot 功能的群聊\n3. 将 `admin_list` 中 100 前的数字改为 bot 主的 QQ 号\n\n#### 2. 向 `Answer` 文件夹内添加内容\n\n这里应当是若干个标准的 json 文件。具体格式如下：\n\n```json\n{\n  \"Answers\": [\n\n  ]\n}\n```\n在这个中括号内部添加应答组。\n\n所有在这个文件夹中的json最后将会在运行时被合并到一起。\n\n#### 应答组\n\n\u003e 下一版计划使用 lua 表\n\n一个应答组至少要包含三个字段：`regex` `anss` `pri`。\n其运行的逻辑是：\n1. 将所有的应答组依照其 `pri` 值，从大到小排序。\n2. 收到消息后，依照顺序根据 `regex` 检查是否符合要求\n3. 若符合要求，依照 `anss` 来执行应答操作。\n\n\n### Lua 控制\n\n已将 Bot 控制相关的部分函数注册到了 Lua 环境中。另：\n- 启动时加载 `./init.lua`\n\n\n详细文档参考(这里)[code/luarc/README.md]\n\n### 应答内容替换\n\n| 原           | 替换后    |\n| ------------ | --------- |\n| [year]       | 年        |\n| [month]      | 月        |\n| [yday]       | 一年第x天 |\n| [mday]       | 一月第x天 |\n| [wday]       | 一周第x天 |\n| [hour]       | 时        |\n| [min]        | 分        |\n| [sec]        | 秒        |\n| [group_name] | 群名      |\n| [group_id]   | 群号      |\n| [user_name]  | 昵称/名片 |\n| [user_id]    | qq号      |\n\n\n### 开始使用：\n\n- 请确保已完成所有配置\n- 分别启动 OneBot 与 桔梦。\n\n---\n\n## 已知问题\n\n1. 各附加功能尚未完全支持\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvescrity%2Fqbot_jiemeng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvescrity%2Fqbot_jiemeng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvescrity%2Fqbot_jiemeng/lists"}