用途：为 AstrBot 插件与核心开发提供权威参考与工作流指导，适用于编写插件、钩子、装饰器与消息处理器，以及处理消息模型、平台适配器、Agent 系统（工具/提供方/人格/子智能体/沙箱/定时任务）、上下文管理与插件配置等主题。
主要能力：覆盖消息模型与事件流、消息链转换、平台适配器接口与消息转换模式、插件配置 schema、生命周期与钩子、Agent Runner（v4.7.0+）与上下文管理（会话分支、历史操作、上下文注入、压缩策略）。工作流要求从单一入口开始，避免宽泛加载：先看 plugin-development-workflow.md 与 design_standards/core_concepts.md，再按主题进入 agent/、plugin_config/、messages/、platform_adapters/ 目录。
使用方式：建议本地安装 SDK 作为 API 参考与 IDE 补全：python -m pip install -U astrbot。插件项目建议包含 main.py、metadata.yaml、README.md、.gitignore、LICENSE，并创建 requirements.txt。metadata.yaml 需声明 name、display_name、desc、version、author、repo、astrbot_version。代码使用 async def，避免硬编码 provider ID 与密钥，配置项放入 _conf_schema.json；v4.5.7+ 推荐用 dataclass 模式定义 Tool 并通过 self.context.add_llm_tools(MyTool()) 注册。KV 存储可用 await self.put_kv_data(...)、await self.get_kv_data(...)、await self.delete_kv_data(...)。
限制与注意：若文档与代码不一致，以代码为准；针对特定版本可用 git -C <astrbot-repo> describe --tags 核对。核心代码位于 astrbotcore/astrbot/core/。写核心代码若涉及文档更新，需向 AstrBot-docs 仓库提交 PR。钩子分两层（插件事件钩子与 Agent Runner 钩子），不可混用。建议插件体积小于 32MB，大资源用 CDN。具体收费、价格与更多细节暂未提供。