【🔥 AstrBot 企业级分层架构 · 7大模块化设计】┌─────────────────────────────────────────┐│  7. 安全隔离层 Security    企业级安全防护  ││  6. 数据存储层 Data        本地存储+隐私安全││  5. 可视化管理层 WebUI     零代码网页后台   ││  4. 插件生态层 Plugin      1000+插件热加载 ││  3. AI引擎层 LLM Engine    核心AI能力载体  ││  2. 核心调度层 Core        事件总线+消息路由││  1. 平台接入层 Platform    10+IM平台统一对接│└─────────────────────────────────────────┘★ 设计理念：事件总线 + 流水线 + 分层架构★ 特点：低耦合、高扩展、易维护、支持分布式部署

【🚀 AstrBot 7大核心技术机制 · 行业领先】┌─────────────────────────────────────────┐│  1. Agent沙箱 Sandbox      安全隔离执行   ││  2. 混合检索 Hybrid        向量+BM25精准  ││  3. 上下文压缩+长记忆      省成本+不掉线   ││  4. 人格设定 Persona       专属AI形象     ││  5. 全模态支持             语音/图片/文档  ││  6. MCP协议+工具集         自主调用能力    ││  7. 前后端分离WebUI        手机/电脑通用   │└─────────────────────────────────────────┘

【🔥 AstrBot 企业级分层架构 · 7大模块化设计】┌─────────────────────────────────────────┐│  7. 安全隔离层 Security    企业级安全防护  ││  6. 数据存储层 Data        本地存储+隐私安全││  5. 可视化管理层 WebUI     零代码网页后台   ││  4. 插件生态层 Plugin      1000+插件热加载 ││  3. AI引擎层 LLM Engine    核心AI能力载体  ││  2. 核心调度层 Core        事件总线+消息路由││  1. 平台接入层 Platform    10+IM平台统一对接│└─────────────────────────────────────────┘★ 设计理念：事件总线 + 流水线 + 分层架构★ 特点：低耦合、高扩展、易维护、支持分布式部署【架构核心要点】1. 7大分层架构：接入层 → 调度层 → AI引擎 → 插件层 → WebUI → 数据层 → 安全层2. 企业级标准：模块化解耦，支持分布式部署与二次开发3. 全链路封闭：IM、AI、扩展、管理、存储、安全全覆盖---【完整运行流程】flowchart TD    A[用户消息 文本/图片/语音/文件] --> B[平台接入层 协议统一解析]    B --> C{消息类型判断}    C -->|纯文本指令| D[核心调度层 路由分发]    C -->|多媒体/文件| E[AI引擎层 多模态预处理]    E --> D    D --> F{功能匹配}    F -->|系统/群管| G[内置功能执行]    F -->|插件功能| H[插件生态层 加载运行]    F -->|AI对话| I[AI引擎 加载人设+上下文]    I --> J{是否需要工具/知识库}    J -->|需要工具| K[Agent沙箱 安全调用]    J -->|需要文档| L[混合检索引擎 精准查询]    J -->|普通闲聊| M[大模型生成回答]    K & L --> M    G & H & M --> N[格式适配 对应IM平台]    N --> O[回复消息给用户]    O --> P[数据存储层 日志/记录/记忆]    P --> Q[WebUI管理层 实时监控展示]---【🚀 AstrBot 7大核心技术机制】┌─────────────────────────────────────────┐│  1. Agent沙箱 Sandbox      安全隔离执行   ││  2. 混合检索 Hybrid        向量+BM25精准  ││  3. 上下文压缩+长记忆      省成本+不掉线   ││  4. 人格设定 Persona       专属AI形象     ││  5. 全模态支持             语音/图片/文档  ││  6. MCP协议+工具集         自主调用能力    ││  7. 前后端分离WebUI        手机/电脑通用   │└─────────────────────────────────────────┘【机制核心要点】1. Agent沙箱：独立隔离环境，安全执行代码/命令2. 混合检索：向量+BM25双引擎，中文优化，准确率95%+3. 上下文压缩+长记忆：自动精简对话，防Token超限，长期记忆4. 人格设定：可视化配置性格语气，定制专属AI5. 多模态全支持：语音、图片、文档原生内置6. MCP+工具集：大模型自主调用搜索、代码、API等工具7. React WebUI：响应式设计，电脑/手机通用，零代码管理

【标题】🌐 全平台IM互通 | 国内+海外全覆盖┌─────────────────────────────────────┐│ 国内主流平台                          ││ QQ ｜ 微信(个人/企业/公众号) ｜ 飞书 ｜ 钉钉 ｜ KOOK ││ 优势：协议稳定、完善防风控策略         ││                                     ││ 海外主流平台                          ││ Telegram ｜ Discord ｜ Slack ｜ LINE ││                                     ││ ✅ 10+平台一站式管理  ✅ 消息全局同步 ││ ✅ 一键配置  ✅ 低延迟高稳定          │└─────────────────────────────────────┘

【标题】🤖 全栈AI能力 | 云端/本地双模式 + 多模态交互┌─────────────────────────────────────┐│ 🔹 云端模型（开箱即用）               ││ 国外：GPT-4o、Gemini、Claude、Llama3 ││ 国内：GLM-4、通义千问、文心一言等     ││ 特点：输API Key即用，支持负载均衡     ││                                     ││ 🔹 本地模型（私有化）                 ││ 适配：Qwen、Llama3、DeepSeek-R1等     ││ 依托：Ollama/LM Studio/LLMTuner       ││ 特点：数据不出网、断网可用、零费用    ││ 硬件：最低1G内存，推荐4G+（GPU加速）  ││                                     ││ 🔹 多模态能力（重点升级）             ││ 语音(98%+准确率)｜图片OCR｜全格式文档 ││ 原生集成插件，中文场景深度优化        │└─────────────────────────────────────┘

【标题】🧠 Agent智能体 | 自主决策·复杂任务编排┌─────────────────────────────────────┐│ ✅ 智能工具调用：自主触发搜索/代码/API/数据库 ││ ✅ 子智能体协作：多Agent分工完成复杂任务      ││ ✅ 可视化定时任务：自动推送、备份、报表生成    ││ ✅ 运行时管控：动态改提示词、中断任务、查日志  ││ ✅ 复杂工作流：多步骤、多条件企业级自动化     ││ 核心：脱离固定指令，具备独立思考与执行能力     │└─────────────────────────────────────┘

【标题】📚 中文优化知识库 | 5分钟快速搭建┌─────────────────────────────────────┐│ 支持格式：PDF / DOCX / MD / EPUB / TXT ││ 核心检索：向量稠密检索 + BM25稀疏检索   ││ 效果：中文优化，检索准确率95%+，支持溯源 ││ 管理能力：多知识库隔离、权限控制、批量导入 ││ 亮点：零代码搭建，无缝对接AI对话        │└─────────────────────────────────────┘

【标题】🧩 1000+插件 | 全场景即装即用┌─────────────────────────────────────┐│ 🔹 工具类：天气、翻译、计算器、热搜      ││ 🔹 社群运维：欢迎语、关键词、禁言、签到  ││ 🔹 AI增强：人设、长记忆、多模型切换     ││ 🔹 第三方集成：飞书/钉钉/GitHub/数据库  ││ 🔹 娱乐类：笑话、抽签、小游戏           ││ 特性：一键安装、热加载、无需重启程序     ││ 拓展：支持自定义Python插件开发          │└─────────────────────────────────────┘

【标题】🖥️ 响应式Web后台 | 电脑/手机通用┌─────────────────────────────────────┐│ 📊 仪表盘：实时数据、资源监控、可视化图表 ││ ⚙️ 配置中心：模型、平台、安全、人设一站式配 ││ 🧩 插件市场：分类检索、版本管理、自动更新  ││ 📜 日志中心：日志查看、筛选、导出、故障排查 ││ 📚 知识库/用户管理：权限、文档、会话管控   ││ 特点：全中文界面，零代码，仅启动需命令行   │└─────────────────────────────────────┘

【标题】🛡️ 安全防护 | 7×24小时稳定运行┌─────────────────────────────────────┐│ 🔒 沙箱隔离：代码/命令执行隔离，防恶意攻击 ││ 🔒 密码防护：PBKDF2加密，随机强初始密码   ││ 🔒 流量限制：防刷量、控成本、保服务稳定   ││ 🔒 内容管控：自定义敏感词，违规内容拦截   ││ 🔒 自愈能力：异常自动重启，全天候在线     ││ 🔒 数据保障：定时备份，支持一键恢复       │└─────────────────────────────────────┘

# ==============================================# AstrBot 全平台部署教程（2026最新，v4.25.1）# 支持：Docker/uv/Windows一键安装/源码# 统一代码块，注释清晰，复制即用# ==============================================# ====================== 方式一：uv一键部署（推荐，最快，跨平台，小白首选） ======================# 1. 安装uv（Python包管理工具，极速安装，自动配置Python3.12）# macOS/Linux 终端执行：curl -LsSf https://astral.sh/uv/install.sh | sh# Windows PowerShell 执行（管理员权限）：# (Invoke-WebRequest -Uri "https://astral.sh/uv/install.ps1" -UseBasicParsing).Content | powershell -# 2. 安装AstrBot（自动安装Python3.12+依赖，指定最新版）uv tool install astrbot --python 3.12# 3. 初始化（仅首次运行，生成配置文件/数据目录）astrbot init# 4. 启动服务（后台运行，默认端口6185）astrbot run -d# 5. 查看初始密码（终端输出，首次登录WebUI用）astrbot password# 6. 访问WebUI：http://localhost:6185（本地）或 http://服务器IP:6185（服务器）# ====================== 方式二：Docker部署（推荐，生产环境，隔离性好，企业首选） ======================# 1. 安装Docker（自行安装，确保docker命令可用）# 2. 创建数据目录（持久化数据，防止容器删除丢失，必做）mkdir -p ~/astrbot/data# 3. 启动容器（国内用户用DaoCloud镜像，解决拉取失败问题；国外用官方镜像）# 国外用户（官方镜像）：# docker run -itd -p 6185:6185 -p 6199:6199 -v ~/astrbot/data:/AstrBot/data --name astrbot soulter/astrbot:latest# 国内用户（DaoCloud镜像，必用，极速拉取）：docker run -itd -p 6185:6185 -p 6199:6199 -v ~/astrbot/data:/AstrBot/data --name astrbot m.daocloud.io/docker.io/soulter/astrbot:latest# 4. 查看初始密码（容器日志中提取）docker logs astrbot | grep "初始密码"# 5. 访问WebUI：http://localhost:6185（本地）或 http://服务器IP:6185（服务器）# 6. 常用Docker命令（维护用）# 停止容器：docker stop astrbot# 启动容器：docker start astrbot# 重启容器：docker restart astrbot# 查看日志：docker logs -f astrbot# ====================== 方式三：Windows一键安装（小白专用，无需命令行，双击即用） ======================# 1. 访问官网：https://astrbot.app （2026最新）# 2. 进入「下载」页面，下载「Windows 一键安装器（v4.25.1）」# 3. 双击安装器，自动配置Python3.12、依赖、环境变量，无需手动操作# 4. 安装完成后自动启动AstrBot，浏览器自动打开 http://localhost:6185# 5. 查看控制台输出的初始密码，登录即可使用# 6. 支持开机自启、自动更新、一键重启# ====================== 方式四：源码部署（高级用户，二次开发，定制修改） ======================# 1. 克隆源码（国内建议用镜像，速度更快）git clone https://github.com/AstrBotDevs/AstrBot.git# 国内镜像（可选）：# git clone https://gitee.com/astrbotdevs/AstrBot.gitcd AstrBot# 2. 安装依赖（推荐用uv，极速安装；也可用pip）# 用uv（推荐）：uv pip install -r requirements.txt# 用pip（备选）：# pip install -r requirements.txt# 3. 初始化（生成配置文件/数据目录）uv run main.py init# 4. 启动服务（后台运行）uv run main.py -d# 5. 查看初始密码uv run main.py password# 6. 访问WebUI：http://localhost:6185# 7. 开发模式（实时调试，代码修改自动生效）# uv run main.py dev

=============================================场景1：基础AI对话（零代码 · 5分钟上手）=============================================┌─────────────┐     ┌─────────────┐     ┌─────────────┐│ 部署+登录WebUI │────▶│ 配置大模型+人设 │────▶│ 绑定QQ/微信  │└─────────────┘     └─────────────┘     └─────────────┘        │                                       │        └───────────────────┬───────────────────┘                            ▼                ┌─────────────────────────────┐                │ 发送文本/图片/语音/文档提问  │                └─────────────────────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ AI 多轮对话+上下文理解 响应  │                └─────────────────────────────┘操作步骤：1. 启动服务并登录WebUI后台2. 配置GLM-4等大模型，进入人格设定填写角色文案并保存3. 对接QQ/微信聊天平台4. 发送消息交互，支持文本、图片、语音、文档多模态对话核心亮点：零代码操作、上下文记忆、多轮连续对话、原生多模态支持=============================================场景2：企业级知识库问答（5分钟搭建 · 精准溯源）=============================================┌─────────────┐     ┌─────────────┐     ┌─────────────┐│ 进入知识库模块 │────▶│ 新建知识库命名 │────▶│ 上传办公文档  │└─────────────┘     └─────────────┘     └─────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ 自动解析/分块/向量存储+测试  │                └─────────────────────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ IM聊天窗口发起文档相关提问   │                └─────────────────────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ 检索作答 + 原文片段溯源展示  │                └─────────────────────────────┘操作步骤：1. WebUI进入知识库，创建并命名知识库（例：公司制度）2. 上传PDF/DOCX文件，等待系统自动处理3. 执行检索测试，校验问答效果4. 在聊天平台提问，AI调取知识库回答并标注原文5. 进阶：新建多个知识库，实现跨库联合问答核心亮点：全自动文档处理、检索精准、原文溯源、多库隔离管理=============================================场景3：Agent工具调用（高阶能力 · AI自主执行）=============================================┌─────────────┐     ┌─────────────┐     ┌─────────────┐│ 插件市场安装 │────▶│ 模型配置开启 │────▶│ 绑定IM平台  ││ Agent工具集  │     │ Agent能力   │     │             │└─────────────┘     └─────────────┘     └─────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ 发送需要外部工具协助的指令   │                └─────────────────────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ AI自主判断 → 调用对应工具    │                └─────────────────────────────┘                            │                            ▼                ┌─────────────────────────────┐                │ 工具执行完毕，整合结果回复   │                └─────────────────────────────┘操作步骤：1. 插件市场安装「Agent工具集」2. 模型配置中开启Agent能力并保存3. 对接QQ/微信/飞书等平台4. 发送查天气、计算题、周报编写等复杂指令5. AI自动调用搜索、代码、推送等工具完成全流程任务核心亮点：AI自主决策、支持复杂工作流、沙箱安全执行=============================================场景4：QQ/微信群管机器人（自动化运维 · 7×24值守）=============================================┌─────────────┐     ┌─────────────┐     ┌─────────────┐│ 绑定QQ/微信群 │────▶│ 安装群管插件  │────▶│ 配置各类规则  │└─────────────┘     └─────────────┘     └─────────────┘                                          │  ┌──────────────┬──────────┬──────────┬──┘  ▼              ▼          ▼          ▼┌─────────┐  ┌────────┐  ┌────────┐  ┌────────┐│自动欢迎 │  │关键词回复│  │违规拦截│  │定时推送│└─────────┘  └────────┘  └────────┘  └────────┘        │                │          │          │        └────────────────┴──────────┴──────────┘                            │                            ▼                ┌─────────────────────────────┐                │ 7×24小时全自动无人值守运行  │                └─────────────────────────────┘操作步骤：1. 完成QQ/微信群账号绑定2. 安装群管工具插件3. 配置自动欢迎、签到回复、敏感词拦截、定时播报规则4. 保存配置并重启服务，机器人自动运行核心亮点：一站式社群管理、违规自动管控、全天候无人值守

from astrbot.api import AstrBot, command@command("日期")def date_command(astrbot: AstrBot, event):    import datetime    today=datetime.datetime.now().strftime("%Y年%m月%d日")    event.reply(f"📅 今日日期：{today}")