学习路径

L1 起点：先能跑起来，再按需加深。不必一次读完所有文档。

Zhin.js 文档按三条跑道组织，对应不同目标。

L1 — 能用

目标：安装、配置、让机器人收到消息并回复。

建议阅读顺序：

1. 快速开始 / 安装与启动
2. 配置文件
3. 任选：Remote Console（管理 bot 与 Sandbox）
4. 任选：消息如何流转（一页弄清「消息从哪来到哪去」）

这一阶段不必了解：@zhin.js/kernel、AsyncLocalStorage 出站上下文、PluginBase、双轨路由细节。

L2 — 会写业务插件

目标：用 usePlugin 加命令、简单处理消息、读配置。

在 L1 基础上继续：

1. 核心概念（插件、命令）
2. 命令系统
3. 插件系统

可选：

• 中间件与消息调度（L2～L3，建议先读 消息如何流转）
• 适配器概览（多平台同跑、群管工具）
• 平台适配器索引（各平台安装与配置，一适配器一篇）

L3 — 扩展与贡献

目标：理解全链路、AI 与工具、适配器/仓库结构，向社区贡献。

推荐阅读：

1. 架构概览
2. 消息如何流转（与源码、AGENTS.md 对齐）
3. AI 模块
4. 工具与技能
5. 贡献指南 与 仓库结构与模块化约定

术语速查：术语表

L3+ — AI 与 MCP 进阶

目标：在跑通 Stable 路径后，理解 Agent 编排、接入 MCP、启用 Advanced 能力。

建议在 L3 之前或并行阅读（概念优先于配置细节）：

1. Agent 概念入门
2. AI 模块
3. MCP 集成
4. 工具与技能
5. Agent 安全与角色

验证环境：examples/test-bot（厨房水槽，非默认模板）。

L4 — 全维度参考

目标：在 Stable 之上验收硬编排、语义记忆、MCP Agent Mesh、多适配器（Sandbox + NapCat + KOOK）。

建议阅读：

1. Agent Mesh 硬编排
2. MCP 集成
3. examples/full-bot README 与 ACCEPTANCE.md

验证：pnpm check:l4（仓库根）；Stable 仍用 pnpm check:stable（仅 minimal-bot）。

进阶路径：Stable（minimal-bot）→ L4（full-bot）→ 厨房水槽（test-bot）。

我现在该读哪篇？

仓库内给 AI/自动化代理的速查表见根目录 AGENTS.md（维护者向，可与 L3 对照阅读）。