基于 Python 异步架构的 QQ 机器人平台，搭载三层认知记忆架构与多 Agent Skills 系统，支持 OneBot V11 协议接入。
Undefined 是一个面向 QQ 群聊与私聊场景的高性能异步机器人平台，以认知记忆架构为核心差异化能力。其记忆系统分为三层：短期记忆自动维持对话连续性，认知记忆通过 AI 主动观察提取事实并经后台异步改写后存入向量数据库（支持语义检索、时间衰减、MMR 去重、跨群联动与自动侧写），置顶备忘录实现 AI 自我约束与待办管理。
平台内置 6 个智能体（信息查询、网络搜索、文件分析、代码分析、娱乐、代码交付），覆盖 64+ 工具调用能力，通过 callable.json 实现细粒度 Agent 间工具共享与白名单控制。Skills 系统支持热重载，11 类 Toolset 可按需扩展。
架构上采用八层分层设计与"车站-列车"队列模型，四级优先级调度确保高价值请求优先响应。支持多模型池并发比较择优、MCP 协议外部工具接入、Anthropic Skills 标准领域知识注入、本地知识库、全局表情包库、定时任务系统等。管理面提供 Management-first WebUI 与跨平台控制台，Management API 与 Runtime API 分离设计，即使配置缺失也可进入管理态完成初始化。
核心能力概览
- 三层记忆：短期记忆 / 认知记忆（向量检索+时间衰减+跨群联动） / 置顶备忘录
- 6 个内置 Agent：info_agent、web_agent、file_analysis_agent、naga_code_analysis_agent、entertainment_agent、code_delivery_agent
- 11 类 Toolset：group、messages、memory、contacts、group_analysis、notices、render、scheduler、cognitive、mcp、memes
- 多模型池：轮询/随机/用户指定，支持并发比较择优
- 四类模型独立配置：chat / vision / agent / security
- 本地知识库：纯文本向量化存入 ChromaDB，关键词/语义搜索
- MCP 协议：Agent 可拥有私有 MCP 配置连接外部工具
- 定时任务：Crontab 语法，支持 self_instruction 自调用
- 访问控制：群/私聊黑白名单
- 安全防护：内置独立安全模型检测注入与恶意内容
安装与快速开始
前置依赖：Python >= 3.11, < 3.14；uv（推荐）或 pip；OneBot V11 协议端（如 NapCat / Lagrange.Core）；AI 模型 API（OpenAI 兼容接口）。
git clone --recursive https://github.com/69gg/Undefined.git
cd Undefined
pip install uv
uv sync
uv run playwright install
uv run Undefined-webui
入口命令
uv run Undefined— 直接启动机器人uv run Undefined-webui— 启动管理控制台（推荐入口）
核心配置项（config.toml）
- 基础配置：
core.bot_qq、core.superadmin_qq、onebot.ws_url - 模型配置：
models.chat/models.vision/models.agent/models.security - 认知记忆：
cognitive.enabled、cognitive.query.*、models.embedding.* - WebUI：
webui.url、webui.port、webui.password - MCP：
mcp.config_path