Cognee 是 GitHub 仓库 topoteretes/cognee 维护的开源 AI 智能体记忆框架，采用 Apache-2.0 许可证，可把文档、代码和对话整理成能持续检索、更新的知识图谱。2026 年 10 月 16 日发布的 v1.6.5 把代码文档字符串纳入图谱，新增 Memify 接口，并改进执行轨迹的批量处理。本文为资料核验，未安装实测。
按 README 的说明，Cognee 把文本拆成实体、关系和可检索的文本块，把代码整理成符号与依赖关系图；查询时按需取回图谱、向量或代码上下文，应用可以先检查取回的证据，再回答问题或继续智能体任务。核心操作有四个：remember（存入记忆）、recall（检索）、improve（补充与反馈）和 forget（删除）。[1]
它要求 Python 3.10–3.14，可用 pip 或 uv 安装，另提供命令行、REST API、MCP 服务，以及 Claude Code、Codex 等工具的插件。未配置大模型密钥时，可用本地 GLiNER 模型抽取图谱、本地嵌入模型做检索，此时只返回匹配的原文片段；需要生成式回答时，再接入 OpenAI 或 Ollama 等模型。[1,5]
v1.6.5 的主要变化
v1.6.5 于 2026 年 10 月 16 日发布，是 2026 年 10 月 20 日核对时 Releases 页面上最新的正式版；同一天还有一个 v1.6.5.dev0 开发版，两者内容不同，不应混用。PyPI 上 cognee 的当前版本同为 1.6.5。[3–5]
发布说明列出的主要变化如下：[3]
- 代码文档字符串入图：函数、类和模块的 docstring 作为独立文档存入代码图谱，并与对应的代码符号相连，检索代码时可以一并取回说明文字。
- 新增 Memify 接口：服务端新增端点并接入命令行，可通过 API 把文件、消息等内容直接转成记忆条目。
- 执行轨迹处理合并：一个会话积压的轨迹（交互事件、步骤与日志）可合并保存为一份文档，轨迹窗口也改在一次 cognify 运行中构建。官方称这能减少数据库写入和流水线重复运行。
- 其他改进：已绑定数据集的会话跳过不必要的重复读取，过期或无效的绑定会被拒绝；记忆提炼只读取需要的问答轮次；活动记录增加嵌入 token 用量；在服务商支持时可请求 base64 编码的嵌入结果。
升级时注意一项破坏性变更：自行生成自定义图模型的用户，需要把 datamodel-code-generator 升级到 0.56.0 或以上。litellm 的依赖范围也调整为 >=1.102.2,<2.0.0。[3]
科研场景中的用途
一项研究的知识往往分散在论文 PDF、研究笔记、分析脚本、实验日志和模型配置里，彼此之间有不少关联：某张图由哪个脚本生成，脚本用了哪份数据，参数为何修改。Cognee 的思路是把这些材料放进同一个记忆层，按实体和关系连接，再供智能体按需检索。根据官方文档，科研中可能的用途包括：[1]
- 为长期课题搭建可检索的资料库，把文献笔记和分析代码放在一起查询；
- 借助 v1.6.5 的文档字符串入图，在检索代码时同时看到函数说明，适合注释较完整的分析代码库；[3]
- 为编程或写作智能体提供跨会话的项目记忆，保留以往的决策、修复记录和约定；
- 研究智能体记忆或知识图谱检索的人员，可以把它当作可阅读源码的参考实现。
这些是依据文档整理的适用场景，不是实测效果。README 给出的 BEAM 评测分数来自项目方在特定配置下的运行，官方也提醒与其他系统比较前先阅读方法和局限说明。[1]
局限与注意事项
- 未经实测：本文为资料核验，未安装实测，功能描述均来自 README 与发布说明。
- 抽取结果需要核对：图谱中的实体和关系由模型自动抽取，可能出错或遗漏。用于科研时应保留原始文件与出处，关键结论回到原文核对。README 也说明，自带的 GLiNER 抽取器只是小模型流程的演示。[1]
- 数据去向：配置 LLM_API_KEY 后，处理和生成回答都会调用外部模型服务。涉及未公开数据、受试者信息或保密材料时，应先确认数据会发往何处，或改用本地模型。[1]
- 部署安全：Docker 示例中关闭访问控制的设置只适合单用户本地使用；多人或对外部署需要另行配置认证和持久化存储。[1]
- 开源范围：用 Postgres 作为图存储目前是演示功能，官方称生产可用版本以授权产品形式提供，另有托管服务。Apache-2.0 覆盖的是本仓库代码，不代表相关服务都免费开放。[1,2]
- 版本变化快：从 2026 年 9 月 18 日的 v1.6.0 到 10 月 16 日的 v1.6.5，一个多月内已发布多个版本。升级前应查看对应版本的破坏性变更，科研项目最好固定版本号。[1,4]
参考文献
[1] topoteretes/cognee GitHub 仓库与 README [2] 仓库 LICENSE（Apache-2.0） [3] v1.6.5 发布说明，2026-10-16 [4] Cognee Releases 列表 [5] PyPI：cognee 1.6.5
除发布说明外，上述页面为滚动更新内容，均按 2026 年 10 月 20 日核对时的内容引用。