TimeTrace 部署文档¶
TimeTrace 项目的部署与设计文档
📋 文档列表¶
| 文档 | 描述 |
|---|---|
| DEPLOY-CHECKLIST.md | 一次性部署清单（手把手） |
| Better Agent 设计 | 分层记忆金字塔 + 薄路由器（激进重设计总纲） |
Better Agent 设计（2026-06-02）¶
问题：agent 在 query-time 现读原始帧，两次大 read 就破 50K 上下文。一天 ~5000 帧 ≈ 500K token，装不进任何 read 路径。
核心倒置：把贵的「读」从 query-time 挪到 write-time 一次性摊销。数据建成 L0→L4 金字塔，查询时 agent 从上往下按需下探。
支撑 spec：
| 文档 | 内容 |
|---|---|
| PLAN-BETTER-AGENT.md | 总纲：金字塔 + 薄路由器、token 数学、prior-art 对比、Phase 1-5 路线 |
| pyramid-schema.md | episodes/digests/signals DDL sketch、幂等键、回填、删除传播 |
| episode-and-rollup-pipeline.md | 写时 builder 挂载、分段算法、降级契约、并发预算 |
| thin-router-agent.md | 6 个分层工具、路由 persona、子 agent fallback、MCP 折叠 |
项目简介¶
TimeTrace 是一个时间追踪系统，包含 Server 和 Client 两部分。
- Server：部署在小主机上，通过 systemd 管理
- Client：运行在本机，采集窗口切换等数据
- 部署方式：GitHub Actions → SSH 跳板 → FRP → 小主机
最后更新：2026 年 6 月 2 日