← 交互式学习

Pi 上下文压缩流程

上下文 · 分步讲解 · 整理于 2026-10-27

逐步走过阈值检查、切点选择、摘要与上下文重建,对比标准压缩、超大单轮和再次压缩。

点击场景并按“下一步”推进;窄屏可左右滑动流程图。

Pi 上下文压缩流程 从 token 阈值检查,经切分、序列化、模型总结、写入压缩记录,最终重建上下文。
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 计算与触发 estimateContextTokens
shouldCompact
core/compaction/compaction.ts 优先使用最近一次有效 assistant usage;尾部消息按约 字符数 / 4 估算,并判断是否越过阈值。
寻找切点 findCutPoint
findTurnStartIndex
core/compaction/compaction.ts 从后向前保留近期 token;不以 toolResult 作为切点,并识别单轮被拆分的情况。
准备与生成 prepareCompaction
compact
core/compaction/compaction.ts 整理待摘要消息、上次摘要、文件操作;调用模型并合并 split-turn 摘要。
消息序列化 serializeConversation core/compaction/utils.ts 将消息转成带角色标签的纯文本;工具结果在摘要输入中最多保留约 2,000 字符。
记录与恢复 CompactionEntry
buildSessionContext
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 提供。