@ar-llm/pi-custom-compaction

用LLM生成智能会话摘要,替代默认压缩

开发流程 优化Token消耗存档历史会话管理对话历史 通用 ★ 1 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@ar-llm/pi-custom-compaction。
它的用途是:用LLM生成智能会话摘要,替代默认压缩
完整的 Skill 内容见:https://321skill.com/skills/ar-llm-pi-custom-compaction/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'压缩当前会话,使用 GPT-4 生成一份 200 字以内的摘要,并保存到历史记录中,保留所有关键决策和代码变更记录。' 它会调用 LLM 分析对话内容,生成结构化摘要,替换原有压缩占位符,同时在本地存储完整摘要供后续回溯。

介绍

这个Skill解决了在长时间编码会话中,默认压缩方式丢失关键上下文的问题。实际开发中,当会话超过上下文窗口时,Pi 编码代理会截断历史,导致丢失重要信息,影响后续交互的连贯性。

使用方式很简单,你只需要通过 npm 安装该扩展,然后在 Pi 配置中启用它。之后可以通过自然语言指令来触发压缩,例如要求使用特定模型(如 GPT-4)生成摘要,也可以为不同 LLM 提供商设置独立的请求参数(如温度、最大 token 数)。扩展会自动替换原有压缩内容,保留结构化摘要。

它非常适合需要长期维护复杂项目、频繁切换上下文或依赖大量历史信息的开发者。尤其是那些使用 Pi 代理进行代码重构、调试、技术调研的用户,可以避免因上下文丢失而重复描述问题。

建议在会话长度接近模型限制时统一使用此工具,以平衡 token 消耗与信息保留。需要注意的是,它依赖外部 LLM 服务,会产生额外的推理成本,建议根据实际需求选择合适的模型(如低成本模型用于日常摘要,高精度模型用于关键会话)。

常见问题

如何配置使用的模型?

在 Pi 配置文件中设置 `model` 参数,例如 `gpt-4` 或 `claude-3-opus`,也可通过环境变量或扩展专属配置项指定。

支持哪些 LLM 提供商?

支持所有兼容 OpenAI API 格式的提供商,如 OpenAI、Anthropic、本地 Ollama 等,需在请求参数中配置各自的 API 端点和密钥。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/ar-llm-pi-custom-compaction/raw/index.md 读取 @ar-llm/pi-custom-compaction 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。