@8monkey/pi-context-history
管理长对话上下文，自动修剪历史并保持摘要
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@8monkey/pi-context-history。 它的用途是：管理长对话上下文，自动修剪历史并保持摘要 完整的 Skill 内容见：https://321skill.com/skills/8monkey-pi-context-history/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我安装pi-context-history扩展，并设置历史保留天数为30天，关闭工具调用剥离功能。' 它会执行安装命令，然后通过环境变量配置`PI_HISTORY_DAYS=30`和`PI_STRIP_TOOL_HISTORY=false`。之后在长对话中，超过30天的消息会被自动修剪，而工具调用记录会保留，同时滚动摘要会持续更新并注入系统提示。
介绍
这个Skill解决了AI编码代理在长对话中上下文窗口膨胀的问题。在实际开发中，随着会话持续，旧消息和工具调用结果会不断累积，导致模型需要处理大量无关信息，既浪费Token又降低响应质量。该扩展会自动修剪过期的历史记录，剥离不再需要的工具调用，并生成滚动摘要注入系统提示，确保模型始终聚焦当前任务。
使用方式很简单，你只需要通过Pi的包管理器安装即可：pi install npm:@8monkey/pi-context-history。安装后所有功能默认开启，无需额外配置。你可以通过环境变量独立控制每个功能：设置PI_TRIM_HISTORY=false可关闭历史修剪，设置PI_STRIP_TOOL_HISTORY=false可保留工具调用记录。此外，还提供了/compact-session、/add-user-message、/add-assistant-message等命令，方便手动触发摘要生成或追加消息。
它非常适合需要长时间运行AI编码会话的开发者或团队。尤其是那些使用Pi作为编码代理、经常进行复杂重构或大型项目开发、需要保持对话连续性的用户。对于需要频繁切换上下文或回顾早期讨论的场景，该扩展能显著减少手动清理历史的工作量，让模型始终基于最新、最相关的信息进行推理。
建议在开始一个长期项目或复杂调试会话前安装此扩展。需要注意的是，它主要针对Pi编码代理环境设计，不适用于其他AI平台。摘要功能默认在会话过期3天后重新生成，你可以通过PI_COMPACT_STALENESS_DAYS调整这个阈值。如果希望自定义摘要生成提示词，可以在~/.pi/prompts/compact.md中覆盖内置模板。
常见问题
如何关闭某个功能？
设置对应的环境变量为false即可，例如`PI_TRIM_HISTORY=false`可关闭历史修剪。
如何自定义摘要生成的提示词？
在`~/.pi/prompts/compact.md`或项目`.pi/prompts/compact.md`中编写包含`{conversation_history}`占位符的提示词即可覆盖默认模板。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/8monkey-pi-context-history/raw/index.md 读取 @8monkey/pi-context-history 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/8monkey-pi-context-history/raw/index.md（查看排版版本）