OpenChronicle 时间线机制揭秘1 分钟块如何 100% 保留你敲下的每一行字【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicleOpenChronicle 是一款开源、本地优先的 AI 记忆工具它在 macOS 上持续捕获你的屏幕活动再把它压缩成人类可读的 Markdown 记忆。而整条流水线里最关键的一站就是时间线机制Timeline——它用对齐真实时钟的1 分钟块把你正在编辑的文字、URL、窗口标题逐字保留下来再交给下游模型加工。本文将完整揭秘这套「100% 保真」机制的设计原理与实现细节 时间线是什么记忆的「保真层」先厘清一个常见误解时间线不是摘要器而是归一化器。原始 AX 树动辄 200–400 KB直接塞给下游模型会撑爆提示词预算但下游阶段又必须知道「你到底输入了什么」——一条 TODO、一段消息草稿、一个搜索词。时间线恰好卡在两者之间见 docs/timeline.md保留你亲手敲的文字、URL、窗口标题、文件名、专有名词一字不改剥掉UI 装饰工具栏按钮、侧边栏骨架、重复的被动阅读快照留给下游真正的压缩发生在再下一站的会话归约器S2 reducer。官方定义Timeline 是强制开启、逐字保留verbatim-preserving的归一化层没有任何关闭开关。为什么是 1 分钟块时钟对齐的巧妙设计时间线窗口默认是window_minutes 1且对齐真实时钟[10:00, 10:01)、[10:01, 10:02)……而不是从某个启动时刻滚动计时配置见 docs/config.md 的[timeline]一节。这带来三个实际好处好处说明不重叠守护进程重启、多实例、时钟漂移都不会产生交叠块可幂等块以(start_time, end_time)作为唯一键重复生产自动跳过好推理人可以直接谈论「10:15 那个块」无需心算偏移为什么选 1 分钟而不是 5 分钟原因有二详见 docs/timeline.md短窗口 少快照。归一化提示词必须让每段输入文字「原样往返」窗口里事件越少模型越不会顺手改写或丢弃内容压缩另有其人。下游 flush 本来就是 5 分钟节奏一次 flush 恰好消费约 5 个时间线块分工干净。1 分钟块如何做到 100% 保留你敲下的字这是整篇文章的核心。在 src/openchronicle/timeline/aggregator.py 中聚合器不读原始 AX 树只消费 S1 解析器提取的focused_element、visible_text、url三个结构化字段然后把它们填入归一化提示词。提示词 src/openchronicle/prompts/timeline_block.md 里有四条硬性规则堪称「防丢字」保险丝逐字保留可编辑输入框里的内容必须加引号原样带入条目禁止改写、禁止用「用户输入了一条笔记」这类泛化动词替代反幻觉同一个 App 里多个独立对话多个聊天、多个标签页互不串线A 对话里的人绝不能被安到 B 对话头上作者身份护栏在搜索框/地址栏打字不算「参与聊天」会被描述为搜索或导航有限去重连续相同的被动阅读快照合并为一条正在编辑的草稿只保留最长、最新版本——这是对原创内容唯一允许的去重方式。每条输出的标准形状是[应用] 上下文标题/URL/文件: 发生了什么。逐字原文如有。Involving: 本对话中的人物/主题/文件。举例你在备忘录里把购物清单从 milk, eggs, flour 逐字补写成 milk, eggs, flour, butter块里保留的正是最终完整版本而不是「用户写了一个清单」。每分钟自动生产幂等与容错守护进程内src/openchronicle/timeline/tick.py 的run_forever每 60 秒醒一次流程非常克制从timeline_blocks表读取已有块的最新结束时间作为游标首次运行最多回溯cold_lookback_minutes避免启动时补录几小时历史从游标扫到「当前时刻减去一个窗口」只处理已关闭窗口——正在进行的半截窗口留在缓冲区当「尾部快照」每个没有块的窗口调用produce_block_for_window生产一个新块扫描结束后顺手清理已被块吸收且超期的捕获文件。可靠性设计同样值得一提零事件窗口跳过 LLM 调用空分钟零成本LLM 失败也不丢窗JSON 解析失败、超时、空返回时代码退化为基于应用名的启发式条目绝不让一个窗口无声消失生产幂等手动执行openchronicle timeline tick永远安全。块最终写入index.db的timeline_blocks表含entries条目数组、apps_used、capture_count等字段与 FTS 表同库共存。时间线块如何变成持久记忆 时间线本身只是「保真层」真正的落地靠下游 S2 会话归约器每次 5 分钟 flush它按时间范围查询重叠的时间线块SQL 见 docs/timeline.md连同墙钟区间一起交给 LLM产出形如[13:25-13:30, Cursor] edited tick.py; fixed _stem_to_dt for negative offsets的子任务条目追加到当天的event-YYYY-MM-DD.md。完整链路可参考 docs/architecture.md原始捕获侧的细节见 docs/capture.md。一句话概括整条漏斗捕获 →时间线1 分钟块逐字保真→ 会话归约5 分钟压缩 → 分类器持久记忆快速上手查看你的时间线块装好 OpenChronicle 后macOS 13克隆仓库后运行bash install.sh两条命令即可亲眼验证 1 分钟块机制openchronicle timeline tick # 同步构建所有已关闭窗口 openchronicle timeline list -n 24 # 查看最近 24 个块由于生产是幂等的这两条命令随时执行都安全。想彻底重跑openchronicle clean timeline会清空时间线数据下次 tick 会自动从缓冲区重建。写在最后OpenChronicle 的时间线机制证明了一件事保真与压缩不矛盾——用 1 分钟块对齐时钟、用提示词把「逐字保留」变成硬规则、用启发式兜底防丢窗AI 记忆系统就能在控制成本的同时100% 记住你敲下的每一行字。更多调优细节窗口大小取舍、模型速度瓶颈都在 docs/timeline.md 的 Tuning 一节欢迎深入源码 src/openchronicle/timeline/ 亲自验证 ✨【免费下载链接】OpenChronicle项目地址: https://gitcode.com/gh_mirrors/op/OpenChronicle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考