nanobot 速查参考
这里不是另一套教程，而是学完核心路线后用于“快速回到证据”的入口。遇到问题时，先按问题类型选择一张表，再回到对应专题理解上下文。
按问题找入口
| 你正在问什么 | 先查 | 再读 |
|---|---|---|
| 某个术语与相近概念有什么区别？ | 术语表 | 对应专题文档 |
| 某项行为在哪个文件、类、函数和测试中？ | 源码与测试索引 | 源码目录与阅读顺序 |
| 一个配置字段或环境变量控制什么？ | 配置与环境变量索引 | 官方 Configuration 文档 |
| 一条消息、事件或流式数据属于哪一层？ | 事件与协议索引 | 流式输出、错误与停止 |
| nanobot 没有按预期运行，先检查哪里？ | 故障定位表 | 最小故障定位流程 |
使用原则
- 表格只负责定位，不代替理解调用链；
- 路径均相对于当前
example/nanobot/code-EN； - 配置和协议的完整公开清单优先查官方文档；
- 下划线开头的 metadata 字段属于内部协作约定，不应直接当成稳定公共 API；
- 找到源码后，至少再读一个相邻测试，确认可观察行为。
速查表也是当前源码快照
本区内容以当前工作区源码和测试为准，不承诺适用于其他 nanobot 版本。
推荐检索命令
Set-Location "example\nanobot\code-EN"
# 找定义
rg -n "class AgentLoop|class AgentRunner|class SessionManager" nanobot
# 找调用方
rg -n "process_direct\\(|run_turn\\(|publish_inbound\\(" nanobot tests
# 让测试名帮助你理解行为
rg -n "cancel|fallback|stream|session" tests返回：学习路线总览