Athena：把 AI agent 的记忆留在自己的磁盘上

项目用途

Athena-Public 面向这样一类工作流：你在 IDE 中频繁使用 AI agent，却不希望个人上下文、项目决策和会话记忆被锁定在单一模型或平台里。项目将记忆层放到本地磁盘，以纯 Markdown 文件保存，并允许用户进行版本控制；模型则可以更换。它采用 MIT License。

它更像一个围绕 AI agent 的本地知识管理与工作流层，而不是独立的通用聊天应用。README 将其描述为“local-first memory and guardrails”，核心目标是让 agent 在新会话中重新获取相关背景，同时用 hooks 而不只是提示词实施部分规则。

已知功能

基础循环是启动、工作、保存：/start 加载上下文，/end 保存会话；复杂规划还提供 /ultrastart 和 /ultraend。项目列出轻量、标准和深度三种模式，并报告各模式约为 500、2K–10K 和 20K token 的使用量。不过这些是 README 中的设计说明，不代表所有模型或任务下的实际消耗。

记忆由会话日志和规范事实组成，搜索包含关键词与可选向量检索，并支持跨编码器重排。项目还列出秘密扫描、grounding 检查和 ruin check。可选的 Supabase pgvector 用于云同步与重排相关的完整安装路径，意味着本地模式和云端增强模式存在不同依赖。

兼容性方面，README 列出了 Claude Code、Antigravity、Cursor、Gemini CLI、VS Code、Kilo Code 和 Roo Code，并为它们展示相应配置文件。v10.0.1 release 还记录了交付物审计模式、隔离审计包以及多 agent CLI 检测方面的改动。

适合哪些人

Athena 适合已经在 IDE 中使用 AI agent、希望把长期上下文保存在自己控制的文件中的开发者、研究者和个人知识工作者。它尤其适合愿意阅读 Markdown、管理本地仓库，并接受通过 /start 与 /end 维持工作节奏的人。

如果你的主要需求只是临时问答，或不愿维护本地记忆结构，Athena 的工作流可能显得多余。它也不是把“记忆”自动变成可靠事实的证明系统；用户仍需检查被保存、检索和引用的内容。

采用前的限制与部署考虑

最重要的限制是护栏并不等于安全边界。README 明确写出 ruin check 只覆盖 16 类破坏性命令中的 14 类，并存在两个已知绕过。因此不应仅依靠 Athena 防止数据删除、错误操作或 agent 误判。秘密扫描也不能替代密钥管理、权限隔离和常规代码审查。

项目对个性化效果采取较谨慎的表述：跨长期会话的效果主要是作者 1,900 多次会话的 N=1 证据，并无多用户研究；反迎合机制也仅被标为部分缓解。因此，部署到团队或高风险流程前，应建立自己的评估集、审计记录和回滚方案。

部署时需要决定记忆文件是否进入 Git、哪些内容允许同步到 Supabase，以及 IDE hooks 能获得什么权限。云同步会扩大数据流和凭据管理范围；纯本地模式则减少云端依赖，但不自动解决备份、访问控制或磁盘加密问题。项目提供 athena doctor 进行诊断，具体安装方式应以官方文档和目标 IDE 的当前配置为准。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-30