OpenChronicle 完全指南开源本地 AI 记忆系统如何让 Agent 拥有持久大脑【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicleOpenChronicle是一个开源、本地优先的 AI Agent 记忆系统它在你的 Mac 上后台运行自动捕获你正在做什么屏幕内容、应用、窗口再交给 LLM 压缩成可读的 Markdown 记忆文件并通过 MCP 工具接口让 Claude Code、Codex、opencode 等任意工具型 Agent 随时查询。简单说它就是给 AI 装上一块持久大脑而且所有数据都留在本机。为什么 Agent 需要持久记忆你大概都有过这样的体验每次开新的 AI 对话都要重新告诉它我在做什么项目、偏好什么、刚才聊到哪了。Agent 一关对话就失忆而你的工作上下文——正在写的项目、定下的决策、常用工具、相关的人——恰恰是最该被记住的。OpenChronicle 的思路是Local-first记忆全部存在你自己的机器上Markdown SQLite不上传模型无关本地 Ollama、LM Studio、OpenAI、Anthropic 等任何 LiteLLM 兼容提供商都能用工具友好任何能调用工具的 Agent 都能接不绑定单一协议可检查记忆就是磁盘上的 Markdown随时可 grep、可 diff、可手改开源MIT 协议解析器、记忆逻辑、集成方式都可以改详细设计见 docs/architecture.md。一键安装两步跑起来⚠️ 当前版本仅支持macOS 13需要 Xcode Command Line Toolsxcode-select --install安装。git clone https://gitcode.com/gh_mirrors/op/OpenChronicle cd openchronicle bash install.sh然后启动并查看状态openchronicle start # 后台启动守护进程 openchronicle status # 查看运行状态与模型配置 openchronicle pause # 暂停捕获写代码累了/开会时 openchronicle resume # 恢复捕获 openchronicle stop # 停止几个实用命令openchronicle capture-once # 手动抓一帧屏幕上下文验证采集正常 openchronicle timeline list # 查看已生成的一分钟时间线块 openchronicle rebuild-index # 重建本地 SQLite 全文索引配置存放在~/.openchronicle/config.toml运行时参数全部集中在这一个文件可用openchronicle config随时查看解析结果。它如何工作五步流水线OpenChronicle 只有一条确定性管线无模式切换核心逻辑在 src/openchronicle/daemon.py 中编排步骤做什么对应模块① 捕获上下文监听 macOS 无障碍事件切窗口、打字、标题变化提取焦点元素、可见文本、URL防抖去重src/openchronicle/capture/② 压缩成时间线每 60 秒把 1 分钟的原始快照规范化成逐字保留的活动块src/openchronicle/timeline/③ 切分工作会话空闲 5 分钟 / 长时间切到无关应用 3 分钟 / 最长 2 小时三条规则自动切会话src/openchronicle/session/④ 写入持久记忆Reducer 把会话压缩成每日事件条目Classifier 从中提炼你是谁、你在做什么项目等持久事实src/openchronicle/writer/⑤ 供 Agent 查询内置 MCP 服务器 SQLite FTS5 全文检索src/openchronicle/mcp/为什么不用截图 OCR 而是AX 优先因为结构化的无障碍树文本成本更低、意图捕捉更准、记忆更干净——它天然包含你在输入什么、当前 URL、聚焦的输入框截图只是辅助信号保留给未来的视觉模型路径。你得到的记忆人也能读的 Markdown所有记忆落在~/.openchronicle/memory/每个实体一个文件前缀即分类前缀存什么示例user-关于你本人的持久事实user-profile.mdproject-有明确边界的项目project-openchronicle.mdtool-软件 / 服务 / 命令行工具tool-cursor.mdtopic-知识领域或持续关注的话题topic-rust-async.mdperson-你打交道的人person-alice.mdorg-公司 / 团队 / 机构org-anthropic.mdevent-每日会话级活动日志event-2026-04-22.md两个让记忆可信的细节Supersede-not-delete覆盖不删除事实变了旧条目打删除线并标注指向新条目完整时间线永不丢失压缩有护栏文件变大触发压缩时正则事实保留检查会拒绝任何丢失超 5% 名词短语的改写坏压缩绝不会悄悄吃掉信息完整格式规范见 docs/memory-format.md。最快接入你的 AgentMCP 一步搞定守护进程在http://127.0.0.1:8742/mcp常驻一个只读 MCP 服务器各客户端有一条 install 命令openchronicle install claude-code # Claude Code openchronicle install claude-desktop # Claude Desktop openchronicle install codex # Codex CLI / IDE openchronicle install opencode # opencode接入后Agent 获得两层记忆工具压缩记忆层list_memories/read_memory/searchBM25 全文检索/recent_activity原始屏幕层current_context你现在在干嘛/search_captures搜屏幕上出现过的词/read_recent_capture回溯到具体某一分钟的屏幕内容典型效果问它我下午两点在改什么文件它能直接查回那一刻的原始捕获。更多客户端配置见 docs/mcp.md。配置模型云端或全本地所有 LLM 阶段走 LiteLLM在config.toml的[models.*]中按阶段配置。分档是省钱关键——timeline 每分钟跑一次配小模型即可classifier 负责事实提炼要配强模型[models.default] model gpt-5.4-nano api_key_env OPENAI_API_KEY想完全本地指向 Ollama 即可无任何云依赖[models.default] model ollama/llama3.1:8b base_url http://localhost:11434 api_key_env 改完配置openchronicle stop openchronicle start即可status会对每个阶段的模型做连通性探测密钥错误当场暴露而不是几小时后才炸。完整参数说明见 docs/config.md。常见问题速查捕获刷屏 / 没捕获到内容优先检查ax_depthElectron 应用如 VS Code、Claude Desktop 需要 100别低于 20详见 docs/capture.md想清空记忆openchronicle clean memory确认后清空 memory/ 与 FTS 表配置文件不受影响手改了 Markdown跑openchronicle rebuild-index重建索引即可更多排查docs/troubleshooting.md谁适合用它如果你在跑 Claude Code、Codex 这类编码 Agent又希望它记得你——记住你的项目、你的偏好、你正在读的那篇文档——OpenChronicle 目前就是开源界最完整的答案捕获、压缩、提炼、检索全链路打通且每一步产物capture-buffer 的 JSON、时间线块、记忆 Markdown、SQLite 索引你都能直接打开检查。项目仍处 alpha 阶段特别欢迎为浏览器、终端、Slack、Notion 等应用贡献解析器。【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考