第十六章 · 研究方法论回顾
这章为谁设计
你想了解「这套研究是怎么做出来的」，或者你自己要做类似的开源项目调研。
调研方法
信息源优先级
- 本地代码（最可靠）：
find目录结构 > README > 配置文件 - GitHub Issue（最真实）：文档说「高性能」，issue 说「I/O 慢 10 倍」——信 issue
- 项目 README（需验证）：定位和特性声明，但可能过时
- CLAUDE.md / AGENTS.md（独家）：AI 配置文件揭示内部约束
- 社区文档（补充）：官方文档站、博客
调研节奏
- 先横后纵：先读全景对比（6 项目一览表），建立心智模型
- 先文档后代码：先读 README 和 architecture.md，再读 src/
- 先 issue 后 PR：issue 暴露真实问题，PR 展示解决方案
- 用类比建模型：汽车工业类比帮助理解项目间关系
遇到的工具问题
| 问题 | 解决方式 |
|---|---|
| gh CLI 对非当前仓库不可用 | 用 gh search issues --repo <owner>/<repo> |
| GitHub issue 详情页 404 | 用 gh issue view --repo 替代 WebFetch |
| E2B 核心代码不在本地 | 明确标注信息缺口，不强行解读不存在的内容 |
| 并行调用被 cancel | 改为串行执行 |
证据等级标注体系
本导读引用的所有结论都附有证据等级：
| 标签 | 含义 |
|---|---|
[源码] |
直接从本地代码读取 |
[已有] |
前序研究已记录 |
[Issue] |
GitHub Issue 中的真实数据 |
[文档] |
项目官方文档 |
[社区] |
业界共识或社区通用知识 |
[推断] |
基于数据推算，未经生产验证 |
[实测] |
本地实际测试验证 |
遇到 [推断] 标签的内容，请保持审慎——这些结论是基于公开数据的推算，可能与实际生产环境有差异。
导读目录：README.md 上一章：第十五章 · 6 个项目的 AI 配置揭秘 下一章：第十七章 · 推荐阅读顺序