OpenChronicle 开发者指南3 大方向助你为 AI Agent 记忆生态贡献开源力量【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicleOpenChronicle 是一个开源、本地优先的AI Agent 记忆层项目它把你在 Mac 屏幕上的真实工作上下文压缩沉淀为可检查、可检索的 Markdown 记忆并经由 MCP 工具开放给任何会调用工具的 LLM Agent。如果你关心本地记忆、个人 AI 记忆或开放上下文基础设施这是一份帮你快速上手的开源贡献指南。为什么需要开源的 AI Agent 记忆层大多数 Agent 产品失忆每次对话从零开始不知道你是谁、在做什么项目、偏好什么。OpenChronicle 的答案是️事件驱动捕获通过 macOS 辅助功能AX事件感知你正在看的窗口、正在输入的内容本地可检查记忆就是磁盘上的 Markdown 文件 本地 SQLite 全文索引随时grep、diff、手改模型无关Ollama、LM Studio、OpenAI、Anthropic 等任何 LiteLLM 兼容服务都能用面向所有 Agent不绑定单一协议或应用MCP 客户端是今天支持最好的路径项目状态v0.1.0 · 仅支持 macOS · 早期 Alpha · MIT 许可整体架构是一条确定性漏斗捕获 → 时间线归一化 → 会话压缩 → 分类提取长期事实。详见 docs/architecture.md。5 分钟搭好 OpenChronicle 开发环境贡献前先让项目跑起来。要求macOS 13和 Xcode 命令行工具xcode-select --install。git clone https://gitcode.com/gh_mirrors/op/OpenChronicle cd OpenChronicle bash install.sh首次运行openchronicle status会在~/.openchronicle/config.toml生成带默认值的配置。之后用openchronicle start启动守护进程、openchronicle capture-once冒烟测试捕获链路。开发侧只需三条命令uv sync --all-extras uv run pytest uv run ruff check 提示status会探测每个 LLM 阶段的服务商连通性配置写错时第一次就能发现不会几小时后在 writer 里静默失败。配置细节见 docs/config.md。方向一贡献更好的上下文解析器Capture 层这是官方最想要的帮助之一为浏览器、终端、编辑器、Slack、Notion、Cursor、Linear、Figma 等具体应用补充专门的解析与归一化规则让记忆更准、更省 token。值得做的改进入手位置从 AX 树提取focused_element/visible_text/url等 S1 字段src/openchronicle/capture/s1_parser.pyAX 树转 Markdown 渲染、剪枝策略src/openchronicle/capture/ax_models.py防抖 / 去重 / 最小间隔等节流参数src/openchronicle/capture/event_dispatcher.py对应单测tests/test_s1_parser.py一个真实的坑Electron 应用VS Code、Slack、Notion 等把用户内容嵌套在 20–60 层深的树里默认ax_depth 100正是为此调出来的——调低到 8 时连侧边栏都看不全。这类应用特异性问题正是解析器贡献的空间。完整说明见 docs/capture.md。方向二改进记忆管理Writer / Session 层第二大赛道是记忆本身的质量会话切分、长期事实提取、压缩、覆盖supersede与合并逻辑、检索质量。✂️会话切分三条规则空闲硬切 5 分钟 / 单应用软切 3 分钟 / 2 小时超时定义在 src/openchronicle/session/manager.py规则动机见 docs/session.md️S2 reducer把时间线块压成event-YYYY-MM-DD.md条目实现在 src/openchronicle/writer/session_reducer.py️Classifier通过工具调用循环read / search / append / create / supersede / commit把持久事实分门别类写进user-*.md、project-*.md等文件核心在 src/openchronicle/writer/classifier.py 与 src/openchronicle/writer/tools.py️Compact文件膨胀后的保事实压缩失守即拒收见 src/openchronicle/writer/compact.py提示词本身也是贡献面四个 LLM 阶段的行为由 src/openchronicle/prompts/ 下的 session_reduce.md、classifier.md、compact.md 和 schema.md 定义记忆文件格式含只覆盖不删除的 supersede 语义详见 docs/memory-format.md两级 LLM 流水线的触发模型详见 docs/writer.md。方向三接入更多 AgentMCP 集成第三大方向让更多 MCP 客户端、IDE Agent、编码助手用上这套本地记忆。守护进程内置一个只读 MCP 服务器默认127.0.0.1:8742/mcp暴露 8 个工具工具面定义在 src/openchronicle/mcp/server.py层级工具用途压缩记忆list_memories/read_memory/search/recent_activity查我是谁、在做什么、偏好什么原始捕获current_context/search_captures/read_recent_capture回溯此刻屏幕上到底是什么参考get_schema理解记忆文件组织规范你可以做的事情新增客户端安装命令现有openchronicle install claude-code / codex / opencode / claude-desktop都是幂等的注册入口为新 Agent 框架补一个install目标是低门槛好起点补充集成文档docs/mcp.md 已覆盖 Claude Code、Codex、Cursor、ChatGPT Desktop 与通用mcpServersJSON缺哪个客户端就补哪篇改进检索质量原始捕获的 FTS 侧读辅助在 src/openchronicle/mcp/captures.py提交第一个 PR测试与代码风格项目对质量把关很直接改动后跑uv run pytest测试集中在 tests/ 目录如 test_session_reducer.py、test_mcp_tools.py跑uv run ruff check行宽 100规则集见 pyproject.toml涉及配置项的改动同步更新 docs/config.md涉及记忆行为的改动用openchronicle writer run手动验证一轮日志在~/.openchronicle/logs/下按组件分文件遇到问题先看 docs/troubleshooting.md——它收集了权限、编译、索引漂移等常见故障。快速上手清单你的技能点推荐方向第一站Python 文本处理上下文解析器docs/capture.mdPrompt 工程 / 信息抽取记忆管理docs/writer.mdAgent / MCP 生态集成docs/mcp.md本地优先的 AI Agent 记忆还处在早期每一次贡献——无论是修一个 Electron 应用的解析、调一条会话切分参数还是接入一个新的 MCP 客户端——都会直接塑造这个生态的形状。现在就是最好的参与时机。【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考