winstonkoh87/Athena-Public

这是什么？

核心功能

• 01以 Markdown 和 JSONL 纯文本文件将记忆与上下文保存在本地磁盘。
• 02混合检索，结合 BM25 全文搜索、pgvector 与 ONNX cross-encoder 重排。
• 03问题框架账本，支持可证伪假设与 Brier 校准评分。
• 04决策筛选模块，覆盖期望经济价值、三分之一凯利、破产概率、MCDA 与蒙特卡洛，并生成 SHA-256 凭证。
• 05提供两个 MCP 服务器，分别用于记忆检索和用 DuckDB 查询 CSV、JSON、Parquet 文件。
• 06通过钩子拦截部分破坏性命令并扫描密钥。

适用场景

• 在 Claude Code、Cursor、Gemini CLI 等工具之间切换时，保持 AI 编程助手的项目上下文一致。
• 记录并复盘带有明确假设与证伪条件的结构化决策。
• 让 LLM 智能体查询大型 CSV 或 Parquet 数据集，而无需把数据全部放入上下文窗口。
• 为 AI 智能体会话增加本地治理钩子。

快速上手

1. 1

   克隆仓库并进入目录

   git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public
2. 2

   创建并激活 Python 虚拟环境

   python3 -m venv .venv && source .venv/bin/activate
3. 3

   安装轻量版软件包

   pip install -e ".[local]"
4. 4

   为你的 IDE 初始化 Athena 并运行健康检查

   athena init --ide claude && athena doctor

使用前须知

• !长期个性化的证据仅来自作者一人的使用（N=1），并非多用户研究。
• !在没有生命周期钩子的 IDE 中，部分防止谄媚的保护仅依赖智能体自行判断。
• !检索质量一般：在作者的黄金测试集上，严格口径的 Hit@5 为 0.569。
• !完整安装需要可选的云服务（如 Supabase）来进行同步。

收录于专题

标签

常见问题

Athena-Public 是什么？

面向 AI 智能体的本地优先记忆与决策层，以 Markdown 和 JSONL 文件保存上下文，可跨多款 IDE 与大模型使用。 Athena 将 AI 助手的记忆、问题框架和决策记录以 Markdown 与 JSONL 文件的形式保存在本机，切换模型或编辑器时上下文仍然保留。项目以 Python 包安装，通过两个 MCP 服务器暴露功能：一个用于检索与治理，另一个基于 DuckDB 做分析查询。

Athena-Public 可以免费使用吗？用的什么许可证？

Athena-Public 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Athena-Public 还在维护吗？

活跃维护中。Athena-Public 最近一次提交是在 2026年11月6日。

Athena-Public 适合用来做什么？

在 Claude Code、Cursor、Gemini CLI 等工具之间切换时，保持 AI 编程助手的项目上下文一致。 记录并复盘带有明确假设与证伪条件的结构化决策。 让 LLM 智能体查询大型 CSV 或 Parquet 数据集，而无需把数据全部放入上下文窗口。 为 AI 智能体会话增加本地治理钩子。

Athena-Public 怎么安装和运行？

克隆仓库并进入目录: git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public 创建并激活 Python 虚拟环境: python3 -m venv .venv && source .venv/bin/activate 安装轻量版软件包: pip install -e ".[local]" 为你的 IDE 初始化 Athena 并运行健康检查: athena init --ide claude && athena doctor

在哪里获取 Athena-Public？

源代码和安装说明在 GitHub 上：https://github.com/winstonkoh87/Athena-Public