入门

这一部分面向系统使用者与项目维护者，优先解决“怎么装、怎么跑、出了问题去哪查”。

推荐阅读顺序

内容说明

快速开始：稳定入口、任务运行方式、什么时候切到维护者文档。
多 Agent 运行指南：解释 broker / direct / auto、Gemini 认证矩阵、桌面 broker 启动方式与回退逻辑。
任务场景：按“我要做什么”来选 stages、Task IDs 和 skills。
示例：按 systematic-review、empirical、qualitative、methods、theory 查看标准推荐路线。
安装：shell bootstrap、本地仓库安装、Python CLI 安装。
升级：无 Python 升级、Python CLI 升级、长期 clone 维护。
故障排除：统一错误码与定位建议。

什么时候离开这一部分

如果你要理解系统分层或契约关系，转到系统架构或规范约定。
如果你要配置 MCP / Zotero / 外部 Provider，转到高级文档。
如果你要修改系统本身，转到维护者文档。