参考项目记录方式说明
翻阅了三个课题 README,整理如下。
1. 记在哪里?
有两层记录:
第一层:每个课题 README 底部的「参考资料」区
所有课题 README 末尾都有一个 「参考资料」 区块(英文标题也可能是 “References”),用无序列表罗列相关项目。例如:
agent-memory-system/README.md:
- MemGPT / Letta 的层级记忆设计
- mem0ai/mem0 — 通用 Agent 记忆层(55K stars)
- RAGFlow — 开源 RAG 引擎(75K stars)
- Memvid — serverless 单文件记忆系统
agent-cost-optimization/README.md:
- LiteLLM 的模型路由实现
- OpenRouter 的多模型网关设计
- GPTCache / GPTCache 项目
- DeepSeek-V4-Pro ...
- Memvid — 简化 RAG pipeline
格式是 项目名 — 一句话说明 或 项目名 + 简要描述特性,没有严格模板,比较随意。
第二层(专门版):agent-reference-index.md
只有 agent-evolution-history 课题单独维护了一个 agent-reference-index.md,作为「从零构建 Agent 的设计参考项目清单」。这个更有结构性:
- 按类别分:框架级参考、工业级参考、设计思想参考
- 每个项目用表格记录:项目名(含链接)、核心设计、值得借鉴的点、分析状态(⏳待分析 / ✅已完成)
- 底部定义了深度分析的固定框架模板
2. 有没有统一格式?
没有强制统一格式。 实际情况:
- 大多数 README 的「参考资料」区只是简单的无序列表,一行一个项目
- agent-reference-index.md 是唯一结构化的参考项目索引,但仅存在于 evolution-history 课题下
- 其他课题(如 cost-optimization, memory-system)没有独立的参考项目索引文件
- 参考项目与学术论文混在一起写,没有分开
- 没有统一的字段要求(如分析日期、采纳结论、优先级等)
3. 有没有遗漏过什么?
从文档观察到的几个问题:
- 参考项目不跨课题共享 — Memvid 同时出现在 memory-system 和 cost-optimization 的参考资料中,但两处都是独立维护,没有引用关系
- 缺乏采纳决策记录 — 除了 agent-reference-index.md 有「采纳结论」字段,其他 README 只列了项目,没写「这个参考过,决定不用的原因是 X」
- 分析状态不统一 — agent-reference-index.md 有 ⏳/✅ 标记,但其他 README 没有
- 参考项目不完整 — 比如 agent-memory-system README 提到了 MemGPT/Letta 的分层记忆设计,但没有深入到具体的技术细节引用或代码分析记录
总结
| 维度 | 实际情况 |
|---|---|
| 记录位置 | 每个 README 底部「参考资料」区;evolution-history 有额外独立索引文件 |
| 格式 | 无统一模板,简单列表为主;evolution-history 用表格 |
| 采纳决策 | 多数没记录「是否采纳/为何不采纳」 |
| 跨课题共享 | 没有,各课题独立维护参考资料 |
| 深度分析框架 | 仅 agent-reference-index.md 有固定分析模板 |