点击场景并按“下一步”推进;窄屏可左右滑动流程图。
1 / 6
当前上下文
118,400 tokens
超过阈值 6,784
触发阈值
111,616 tokens
128k − 16,384近期原文保留
≈ 20,000 tokens
从最新消息向前累计
被摘要的旧内容
LLM 结构化摘要
原样保留的近期内容
输出预留
输入与输出示例
进入摘要模型的输入
[Previous summary]
用户正在重构支付模块……
[User]
把重试逻辑迁移到 PaymentRetryPolicy。
[Assistant tool calls]
read(path="src/payment/service.ts")
edit(path="src/payment/retry-policy.ts", ...)
[Tool result]
测试失败:timeout 分支仍调用旧实现……
生成并持久化的输出
## Goal
重构支付重试逻辑并保持行为兼容。
## Progress
### Done
- [x] 新建 PaymentRetryPolicy
### In Progress
- [ ] 迁移 timeout 分支
## Key Decisions
- 策略对象不负责记录 usage。
## Next Steps
1. 修改 service.ts
2. 运行 payment 测试
<read-files>src/payment/service.ts</read-files>
<modified-files>src/payment/retry-policy.ts</modified-files>
SessionEntry 如何变化
原始记录不会被删除。
新增的
CompactionEntry 只决定下一次构造模型上下文时,哪些历史由摘要替代。
关键代码位置
| 阶段 | 函数 / 类型 | 位置 | 职责 |
|---|---|---|---|
| Token 计算与触发 | estimateContextTokensshouldCompact |
core/compaction/compaction.ts | 优先使用最近一次有效 assistant usage;尾部消息按约 字符数 / 4 估算,并判断是否越过阈值。 |
| 寻找切点 | findCutPointfindTurnStartIndex |
core/compaction/compaction.ts | 从后向前保留近期 token;不以 toolResult 作为切点,并识别单轮被拆分的情况。 |
| 准备与生成 | prepareCompactioncompact |
core/compaction/compaction.ts | 整理待摘要消息、上次摘要、文件操作;调用模型并合并 split-turn 摘要。 |
| 消息序列化 | serializeConversation |
core/compaction/utils.ts | 将消息转成带角色标签的纯文本;工具结果在摘要输入中最多保留约 2,000 字符。 |
| 记录与恢复 | CompactionEntrybuildSessionContext |
core/session-manager.ts | 保存 summary、firstKeptEntryId、tokensBefore,恢复为“摘要 + 近期原文”。 |
| 本项目持久化约束 | pi_session_entries |
docs/architecture.md §7.3 / §8.2 / §8.3 / M3 |
Pi SessionEntry 作为 append-only 原始事实写入 PostgreSQL;投影可重建,不能修改或删除原始历史。 |
仓库当前只有架构文档,尚无已安装依赖或锁文件;函数位置依据 Pi 上游源码梳理。接入锁定版本后,应以 node_modules 中对应版本为最终依据。
评论
评论由 GitHub Discussions 提供。