Athena-Public
给任意大模型装上持久记忆层 — 本地Markdown文件存储,跨模型、跨会话、Git版本控制的个人AI认知增强工具
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
给任意大模型装上持久记忆层 — 本地Markdown文件存储,跨模型、跨会话、Git版本控制的个人AI认知增强工具
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
图1:Athena 项目 banner,展示了「你的记忆、你的机器、任意模型」的核心价值主张
想象一个场景:你花三个月时间,通过无数次对话,把 ChatGPT 调教成了一位了解你工作风格、熟悉你业务背景、甚至能预判你决策偏好的私人顾问。然后某天早上,你打开对话框,发现一切归零——模型更新,所有记忆清空。
这不只是假设。这是每一个重度 AI 使用者都真实经历过的噩梦。
Project Athena 正是为解决这个问题而生。它不是又一个 AI 聊天机器人,而是一个开源的「认知增强层」——把你的记忆层从云端平台迁移到本地机器,以 Markdown 文件的形式持久化存储,让记忆真正属于你,并可跨任意大模型使用。
Athena 并非出自某个大厂实验室。它的作者 Winston Koh 是一位新加坡独立开发者,在 1800 多次与 AI 的对话中,逐步构建出了这套系统。
项目在 GitHub 上积累 509 star,拥有 MIT 许可证,已进入 9.9.4 版本(v9.9.4,2026年6月21日更新)。作者的个人博客 winstonkoh87.com 记录了这套方法论的演进:从最初的简单笔记系统,到后来的协议(Protocol)框架,再到感知模型(Perception Model)——前后迭代超过 50 个版本。
这是一个典型的个人工具 → 开源产品的演进路径:先解决自己的真实痛点,在长期使用中打磨出完整方法论,最终将沉淀下来的工作流打包成开源工具。
Athena 的自我定位是「AI 代理的 Linux 发行版」——它的架构参考了大量 Linux 系统的设计哲学:
记忆持久化层(相当于 Linux 的文件系统):不是把对话历史丢给平台存储,而是将所有信息以结构化的 Markdown 文件形式存放在本地 .context/ 目录中。session_logs(会话日志)、case_studies(案例库)、memory_bank(记忆银行)——这些文件夹构成了 AI 的长期记忆。Git 版本控制天然支持,你可以随时回溯、比对、审计任何历史记忆。
协议系统(Protocols,相当于 Linux 的系统调用):Athena 内置了 402 个主动协议,覆盖决策、交易、心理学、商业、工程等 34 个领域。每个协议是一个 Markdown 文件,定义了特定场景下的标准操作流程。比如 RSN-524-conviction-decisiveness-split.md 定义了在低确定性场景下如何同时保持精准性和灵活性;trading-risk-gate 协议在涉及资金决策时自动触发风险门控。
技能包(Skills,相当于 Linux 的软件包):41 个主动技能,每个技能是一个协议_bundle_,比如 trading-risk-gate 技能整合了 5 个交易风险相关协议,therapeutic-ifs 技能整合了心理治疗框架 IFS(内部家庭系统)的操作规程。
引导命令(Workflows,相当于 Linux 的命令行工具):68+ 个斜杠命令,包括 /start(完整引导,~10K tokens)、/end(会话收尾,自动提取决策到记忆银行)、/ultrastart(深度引导,~20K tokens)、/think(结构化推理)等。通过 AI IDE 的 chat panel 触发。
认知架构(Perception Model,相当于 Linux 的内核调度):这是 Athena 最独特的技术创新。它模拟人类大脑的感知处理流程,分为四个阶段:① 并行转导(7个检索通道同时激活:语义记忆、向量搜索、SQLite、标签、文件名、框架、外脑);② 注意门控(RRF 加权融合 + 置信度阈值过滤);③ 执行功能(Lambda 评分决定推理深度,Law #1 风险门控,熔断器抑制);④ 主动认知层(守护进程,基于时间/行为模式主动提醒)。
图2:Athena 的认知架构 — 感知模型(Perception Model)示意图,展示从并行激活到注意门控到执行功能的完整信息流,以及主动认知层(Daemon)的反馈回路
重要澄清:Athena 不是 Web 服务,无法通过浏览器访问。它需要运行在支持本地文件读取的 AI 增强型 IDE 中,包括:Cursor、Antigravity(Google)、Claude Code、VS Code + Copilot、Kilo Code、Gemini CLI、Roo Code。
安装流程(约30分钟):
git clone 仓库到本地目录(如 ~/Projects/Athena-Public)pip install -e .(轻量安装)或 pip install -e ".[full]"(完整安装,含向量搜索和重排序依赖)/start 启动完整引导/tutorial 开始新手教程(约20分钟)可选云服务:向量语义搜索需要 Google Gemini API Key 和 Supabase(PostgreSQL + pgvector);纯本地模式仅需 Python 环境。
硬件需求:无 GPU 要求,普通笔记本即可运行(4GB RAM + 2GB 磁盘)。
从代码结构看,Athena 的 SDK 核心位于 src/athena/(72个Python文件),主要模块:
| 模块 | 职责 |
|---|---|
core/ | 核心逻辑:推理引擎、编排层、检索、反思 |
memory/ | 记忆管理:持久化、压缩、索引 |
intelligence/ | 智能层:生成器、代理 |
tools/ | 工具集:文件读写、Shell执行、搜索 |
auditors/ | 安全审计:风险评估、合规检查 |
boot/ | 引导逻辑:启动序列、健康检查 |
cli/ | 命令行接口 |
mcp_server.py | MCP(Model Context Protocol)服务器实现 |
Python 依赖(轻量安装):python-dotenv、requests、pydantic、diskcache、rich — 非常轻量。
完整安装额外依赖:google-genai、sentence-transformers、flashrank、torch、anthropic、supabase — 涉及 ML 向量化和云存储。
MCP Server:基于 FastMCP v3.x 实现,提供了 smart_search、agentic_search、quicksave、health_check、recall_session、governance_status 等工具,stdio 传输协议,与 Gemini CLI / Antigravity 集成。
很多人第一反应是:为什么要这么大费周章?直接写一个很长的 system prompt 不就行了?
Athena 的设计哲学回答了这个问题:平台记忆不可靠、不透明、且绑定单一供应商。具体来说:
Athena 的记忆是纯文本文件,任何文本编辑器都能读取,Git 版本控制天然支持,跨模型、跨设备、跨平台完全可移植。
作者 Winston Koh 在文档中提出了一个核心论点:Athena 的护城河不是代码,而是数据。
任何人都可以 fork 这份代码,但没有人能 fork 你 1800 次会话积累下来的案例库、决策框架和会话日志。随着使用时间的增长,你的 Athena 实例变得越来越个性化,越来越有价值——这种数据积累效应是线性增长的代码无法复制的。
这种「先发优势」类似于个人知识管理系统(PKM):Notion、Obsidian 谁都能用,但用了五年的人的笔记库是无法被新用户复制的。
Athena 也有一些明显的局限性,开发者在文档中并没有回避:
设置门槛较高:不是开箱即用的产品,需要一定的技术理解力(Python 环境、Git、AI IDE 配置)。纯小白用户可能会在安装阶段就卡住。
数据隐私依赖用户自觉:虽然记忆存在本地,但 Supabase 向量存储是云端服务,若使用完整搜索功能,个人数据会上传到云端。
记忆文件可能膨胀:长期使用后 .context/ 目录会积累大量文件,A Athena 通过渐进式加载(Progressive Disclosure)优化了 token 开销,但管理成本仍然存在。
不适合实时性要求高的场景:作为本地 AI 工作流工具,不适合需要毫秒级响应的实时应用场景。
Athena 代表的趋势是:AI 基础设施从「云端集中」向「本地主权」迁移。随着 AI 模型能力的同质化(GPT-5、Claude、Gemini 在很多场景下差距已经不大),数据层和记忆层正在成为新的差异化竞争点。
项目在 2026 年 Reddit 帖子获得了 100 万+浏览量,说明「AI 记忆持久化」这个需求在用户端有着强烈的共鸣。GitHub 上 509 star 虽然不算特别高,但考虑到项目的主要传播渠道是个人博客和 Reddit(而非传统的开发者社区),这是一个相当可观的有机增长数据。
从技术实现看,Athena 的感知模型(Perception Model)和 Linux 类比架构是近年来开源 AI Agent 框架中最有思想深度的设计之一——它不仅仅是一个工具集,更是一套关于「AI 如何真正理解一个人」的认知论框架。
总结:Athena 是那种会让你思考「为什么没有早点想到这个」的项目。它用最简单的技术(Markdown 文件 + AI IDE)解决了 AI 时代最核心的个人数据主权问题,同时通过精心设计的认知架构让记忆真正可推理、可追溯、可复用。509 star 或许只是开始。