sting8k/pi-vcc

它解决了什么问题

pi-vcc 是 Pi AI 编码代理的算法型对话压缩工具。它解决了标准 LLM 基于摘要导致的上下文窗口溢出和信息丢失问题，其中历史记录常常被丢弃或产生幻觉。该工具在不依赖 LLM 调用进行压缩过程的情况下，将 token 使用量减少了 35%-99%。

它如何工作

pi-vcc 不使用 LLM 重写对话，而是采用纯粹的算法方法提取并格式化简短的对话摘要。它通过一个流水线处理对话，该流水线校准 token 估算、过滤噪声，并使用正则表达式和模式匹配提取关键语义部分（如会话目标、修改的文件和 git 提交）。

为防止永久性数据丢失，它包含一个 vcc_recall 工具，可直接读取原始会话 JSONL 文件，使代理即使在历史消息已被压缩出当前上下文后，仍能搜索并检索来自当前分支或所有分支的特定历史消息。

适用于谁

适用于希望以可搜索、确定性和低成本方式管理长对话历史记录，同时不丢失关键技术细节的 Pi AI 编码代理用户。

主要亮点

• 零 LLM 成本：通过算法执行压缩，消除了与摘要调用相关的 API 成本和延迟。
• 无损召回：通过直接读取原始会话文件绕过标准压缩，使整个历史记录可通过正则表达式和关键词搜索保持可检索性。
• 语义结构化：将压缩后的历史记录组织为五个特定部分：会话目标、文件与变更、提交、待处理上下文和用户偏好。
• 确定性输出：确保相同输入始终产生相同输出，消除了在历史压缩过程中 LLM 幻觉的风险。
• 可自定义压缩：支持通过 /pi-vcc 手动触发和“智能保留”逻辑，优化保留最近对话轮次的数量。