跟 Claude Code / Codex / Grok Build / Kimi Code / ZCode 这类 agent CLI 跑长周期任务时，你一定遇到过：
会话里把需求编号成了 N1、N2、N3……几小时后 agent 说 "N2 完成" —— N2 是啥来着？ 翻几万行 session 记录？算了。
Agent Timeline 实时跟踪本机 agent 的 session 文件，把你提交过的每条命令提炼成时间线节点，把任务代号收进一本自动维护的词典 —— 忘了就点一下。
| 🤝 五家 agent 一条时间线 | Claude Code · Codex · Grok Build · Kimi Code · ZCode 混排，来源徽标（CL/CO/GR/KI/ZC）+ 项目过滤；两端解析器逐条同语义，同一份语料解出同一批节点 |
| 🕰 命令时间线 | 每条你的原话 = 一个节点（最新在上），LLM 提炼标题 / 关键点 / 执行结果一句话；按 需求·任务·调研·学习·决策·修复 归类过滤 |
| 📖 代号词典 | N1: 登录改版 式定义自动登记（命令与 agent 回复双通道）；N2完成、T1 完成接下去执行T2 自动流转状态（✓完成 / ▶进行中 / △变更）；点击回看定义与出处 |
| 🫧 双墨线台账 | ❯ + 实线彩墨线 + 纸面块 = 你的话，✦ + 虚线灰墨线 = 机器话 —— 失焦半透明时，屏幕上唯一清晰的就是你说过的话 |
| 🪟 挂件级窗口 | menu bar / 托盘常驻；hover ≈95% 可读、失焦 ≈25% 不挡事，快淡入慢淡出；置顶开关；点击不抢焦点；全文划选复制；任意明暗背景自稳对比（scrim + 描边） |
| 🗂 折叠到标题栏 | 头部 chevron 一点收成只剩标题栏、再点展开回原高度，顶边不动像卷帘；折叠态锁住竖向尺寸（拖不动），状态与折叠前高度都记住，重启还在 |
| 🌏 四语界面 | 简体中文 · English · 日本語 · 한국어，设置里切换即时生效。状态关键词与类型识别四语常开——中文界面照样读得懂日文 agent 回复；已入库的历史保持原语言不重写 |
| 🔌 零配置摘要 | 默认复用本机 claude -p（备选 codex exec）headless；可换任意 OpenAI 兼容 provider；LLM 不可用时规则降级不断线 |
| 🔒 本地优先 | session 解析、存储（SQLite）、词典全部本地；仅摘要调用产生模型请求 |
Releases 提供双端产物（推 v* tag 由 CI 自动构建）：
AgentTimeline-macos-vX.Y.Z.zip— 解压得.app，拖入/Applications；AgentTimeline-windows-x64-vX.Y.Z.zip— 解压到任意目录运行AgentTimeline.exe（自包含 Windows App SDK，需 .NET 8 桌面运行时）。
版本单一事实源为根目录 VERSION，发布流程见 CHANGELOG.md 顶部说明。
cd macos
scripts/build-app.sh release # 产出 macos/dist/AgentTimeline.app
cp -R dist/AgentTimeline.app /Applications/
open /Applications/AgentTimeline.app # menu bar 时钟图标 ⏱
swift test # 106 项单测完整源码在 windows/，已完成实机运行验证：Core 解析层跨平台
冒烟 463 断言，WinUI 层过 CI 的 VS msbuild 硬门禁，分层验证清单全项注记见
windows/DEBUG-PLAYBOOK.md。开发构建用 Visual Studio 2022 打开
windows/AgentTimeline.sln，详见 windows/README.md。
| 双墨线台账 · 类型彩标 · 代号状态徽章 | 项目下拉 · 最近活跃 agent 徽标 | 代号词典 · 生命周期一屏回忆 |
|---|---|---|
 |
 |
 |
设置界面（摘要引擎三档 / 透明度 / agent 开关）：screenshot-windows-settings.png。
| 双墨线台账 · 类型彩标 · 代号状态徽章 | 项目下拉 · 最近活跃 agent 徽标 | 代号词典 · 生命周期一屏回忆 |
|---|---|---|
 |
 |
 |
设置界面：screenshot-macos-settings.png。两端同一演示数据集拍摄（docs/DEMO-DATASET.md），视觉规范同源 design/design-tokens.json。
两端同一演示数据、同一 dip 几何、同一背板，画布宽高比逐位相同故两行等高。 macOS 摄于 v0.7.6、Retina 2x（1618×1352）；Windows 摄于 v0.6.0、主屏 100% 缩放 （859×676，dip 几何与 mac 一致、像素密度为其一半）；README 显示宽度 290 下观感无差异。拍摄脚本：mac
macos/scripts/shots/、Windowswindows/scripts/shots/。
⚠️ 两行版本不同步：mac 一行是 v0.7.6 重拍的，词典面板里能看到 v0.7.6 新增的搜索框； Windows 一行仍是 v0.6.0 的旧图，看不到搜索框、设置窗也没有 v0.7.2 加的开机自启动开关。 功能两端都有（见核心能力表），只是 Windows 侧截图待重拍。
flowchart LR
A[("~/.claude<br/>~/.codex<br/>~/.grok<br/>~/.kimi-code<br/>~/.zcode")] -->|FSEvents 增量 tail| B[解析器<br/>Claude / Codex / Grok / Kimi / ZCode]
B -->|用户命令| C[(SQLite)]
B -->|agent 回复| D[代号词典<br/>定义·状态·出处]
C --> E[摘要引擎<br/>claude -p / provider / 规则]
E --> C
C --> F[半透明台账时间线]
D --> F
- 增量解析：按字节偏移 tail，重启不重读不丢行；各家 session 格式规范见 docs/SESSION-FORMATS.md
- 双端同源：视觉规范唯一事实源 design/design-tokens.json（mac 构建期嵌入二进制，win 生成 XAML 资源）、界面文案唯一事实源 design/strings.json（74 键 × 4 语言），两者副本漂移 CI 直接拦下
- 需求文档 docs/PRD.md · 架构 docs/ARCHITECTURE.md · 变更 CHANGELOG.md
菜单栏图标 → 设置：摘要引擎（CLI 模型 / 自定义 provider）、界面语言、透明度两档、置顶、回填天数、五家 agent 开关。各家 session 路径均内建自动发现（不是可配项——路径是产品事实不是用户偏好），格式规范见 docs/SESSION-FORMATS.md。
- M2：代号按项目命名空间（跨项目同名短码隔离）、搜索、词典管理界面
M3：Windows 端实机调试与双端视觉对齐验收✅ 完成（2026-07-26，11 处实机修复 + 全清单注记留档）M4：mac 端 zcode 解析器同步、Codex 技能回显路径剥离✅ 完成（2026-07-28）；剩真实鼠标交互项人值守复测收尾M4.5：四语界面与识别词表，双端同轮落地✅ 完成（2026-07-30）- M5：结果详情富文本渲染（代码块 / 表格 / 可点链接，即 TEXT-NORMALIZATION Phase D）。
前置：需先加
nodes.full_text列——L2 规整不可逆、agent 回复原文当前不落库， 历史节点无源可依；该列同时解锁「结果行读完整回复」与代号重放读原文（§5.2-1）。 排在 M2 之后：三级渐进披露已缓解「看不全」，而加列是不可回退的存储承诺， 宜与搜索需求一并定夺
MIT © litianyi