速查

**给 AI 编码助手看的浓缩版。**同样的事实，去掉教学性铺陈和反复强调，只留结构、签名、坑——方便整篇塞进上下文。

人读文档请走 指南 / 接口 / 进阶；这一层的取舍是"密度优先"，不适合当教程。

仓库根目录的 LLM.md 是按需加载入口， 让 AI 助手先读它，再按需要拉取下面这几篇。

文档	里面有什么
框架结构	目录职责、事件流水线、全部扩展点、内置服务名
插件开发	最小插件模板、ctx 常用面、已知坑（含 get_config 返回 None 这类）
调试排错	测试怎么跑（pytest 需显式列文件）、常见报错怎么定位
IIPC 内核链路	把事件总线 / DB / 插件编排搬到 Go 进程，插件仍用 Python 写并跑在独立进程；--iipc 模式下生效
安全加固	API / 前端抗探测与蜜罐体系。条目来自真浏览器抓包 + 黑盒压测复现，非读码推断

---

这几篇以"能被 AI 完整读完"为目标，如果你发现某篇太长或漏了关键信息，按同样密度补即可。