avenoxai/avenoxbeyin

项目介绍

AvenoxBeyin 给 AI 代理加一层本地记忆：重要信息不留在聊天记录里，而是让代理写进普通 Markdown 笔记，下次会话再通过本地检索找到相关笔记和出处，并把选中的上下文交给当前使用的客户端。笔记可以在 Obsidian 或任意文本编辑器里直接查看，索引保存在本机。

它不会自动把整段聊天历史转成知识，只有你要求代理写下的内容才会持久保留。安装会放入四个 skill：beyin 负责找笔记、存信息和建任务，beyin-doktor 检查连接与安装问题，beyin-guncelle 处理更新与回滚，beyin-kontrol 用于核对记忆是否仍然准确、只在你要求时运行。公共源码位于 .agents/skills，已有的个人 skill 不会被静默覆盖。

支持的客户端包括 Claude Code、Codex、Google Antigravity、Kiro、Hermes Agent、OpenCode、OMP / Oh My Pi 和 Pi，各自的 hook 与信任流程不同；README 明确说明 Codex Desktop 的自动 hook 投递尚未被视为已验证。

快速使用

准备条件：Python 3.11+ 和一个受支持的 AI 客户端（客户端及其账号需单独安装）。不需要 Git、pip、Mem0 账号、额外 API key 或常开服务器，Obsidian 可选。

1. 选一个文件夹，可以是新建目录，也可以是已有的 Obsidian vault，笔记无需迁移。
2. 在该文件夹中打开 AI 客户端，确保安装在正确目录执行。
3. 把下面这段消息贴给代理：

https://avenox.io/beyin.md adresini oku. Bu klasöre ikinci beynimi kur.
Mevcut kurulum varsa notlarımı koruyarak güncelle. Gerekli indirme ve
kurulum adımlarını sen yap. Sonunda örnek bir bilgiyi kaydedip yeni
oturumda geri okuyarak birlikte doğrulayalım.

代理会下载稳定版安装包、校验 checksum 并执行安装；按客户端提示完成文件夹或 hook 的信任确认，然后在同一文件夹中开新会话（Codex 需在 /hooks 里查看新增的 hook 定义）。

想从终端自己装，可从最新版本下载 beyin-v3-X.Y.Z.zip 和随附的 .sha256 文件（不要选 GitHub 的 Source code 压缩包），比对哈希并解压后，在解压出的包目录中运行：

python3 scripts/install_v3.py --vault "/完整路径/Beynim"

Windows 上用 py -3 代替 python3，路径写成 C:\Notlar\Beynim 这类形式。安装器会把引擎、客户端连接和四个入门 skill 写入 vault，之后可以关掉安装包目录。各客户端的差异见安装指南。

验证时，让代理把一个示例决策存成笔记，再开新会话问当时选了哪个方案、为什么，并要求给出源笔记。可选功能包括本地网页视图（python3 beyin.py web ac，加 --read-only 只读；仅在本机打开，闲置 30 分钟关闭）和单键捕获收件箱（python3 beyin.py yakala kur），可收集视频、推文、文章、邮件和 Word 文档，让代理处理后把卡片关联进笔记。

使用约束

• 检索基于本地关键词匹配，并不保证每个问题都能召回正确笔记；重要决策应主动写成笔记，任务结果记录也只是代理的陈述，不等于独立验证。
• 笔记是本机 Markdown 文件，但选中的上下文会发送给你使用的 AI 客户端及其模型供应商，「本地记忆」不等于整段对话离线。给笔记打敏感标记会影响 Beyin 的上下文和网页过滤，但对已获得文件访问权的代理不构成操作系统级保护。
• 基础本地检查不调用模型；交给代理的工作和附加的上下文会计入客户端正常用量。客户端关闭时没有后台服务持续扫描记忆。
• 更新后需要重新运行捕获安装命令，vault 的工作数据库不宜像普通同步文件那样在多台机器间共享；从 V2 迁移和多机使用各有独立步骤。
• 许可证为 MIT。

HotRepo 点评

站内只记录到 2026-11-13 的 Python 日榜：当天第 5 名、新增 46 Star，累计 436 Star、74 Fork。这一条快照只能说明它在 Python 日榜有过一个靠前的位置，不足以判断趋势；它没有全部语言日榜名次，也没有更长的同口径序列。技术上值得注意的取向是把记忆留在用户掌控的 Markdown 里、并适配多个代理客户端，而不是把数据锁进某一家聊天产品；README 也愿意写明关键词检索和 Codex Desktop hook 未验证这类限制，这对评估是否采用更实际。

项目源码与说明