@8monkey/pi-session-gzip
自动压缩/解压Pi会话文件，节省磁盘空间
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@8monkey/pi-session-gzip。 它的用途是：自动压缩/解压Pi会话文件，节省磁盘空间 完整的 Skill 内容见：https://321skill.com/skills/8monkey-pi-session-gzip/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我恢复上次压缩的会话'，它会自动执行`/resume-compressed`命令，找到最新的压缩会话文件并解压重新打开。你也可以说'恢复会话ID为abc123的压缩文件'，它会根据ID精准恢复对应的会话。整个过程无需手动操作文件路径。
介绍
这个Skill解决了Pi代理会话文件占用大量磁盘空间的问题。在实际使用中，Pi会在~/.pi/agent/sessions/目录下生成大量JSONL格式的会话文件，随着会话数量增长，磁盘空间迅速被消耗。该Skill在每次关闭Pi时自动将当前会话的session.jsonl压缩为session.jsonl.gz并删除原始文件，让闲置会话以压缩状态存储，而活跃会话不受影响。
使用方式很简单，你只需要通过pi install npm:@8monkey/pi-session-gzip安装即可。之后Pi会在退出时自动压缩当前会话；需要恢复时，对AI说“恢复上次压缩的会话”或直接运行/resume-compressed命令，它会自动解压并重新打开对应的会话文件。你也可以指定会话ID或文件路径来恢复特定的压缩会话。整个过程无需手动干预，零运行时依赖。
它非常适合需要长期保留大量会话历史的Pi用户，尤其是那些每天产生大量对话、磁盘空间有限的开发者或运维人员。对于需要频繁回溯历史会话、但又不想让磁盘被JSONL文件填满的团队来说，这个Skill是理想的存储优化方案。它也适用于在资源受限的服务器上运行Pi代理的场景。
建议在安装后立即测试一次压缩/恢复流程，确保工作正常。需要注意的是，它只在Pi正常退出时压缩，如果进程被强制杀死则不会触发压缩；恢复操作是幂等的，重复执行不会产生副作用。另外，空会话和--no-session模式下的会话会被自动跳过，不会生成压缩文件。
常见问题
如何恢复一个被压缩的会话？
运行`/resume-compressed`命令，不带参数时会恢复当前会话的.gz文件，或自动选择本Skill最新压缩的会话。也可以传入会话ID或文件路径恢复指定会话。
压缩后原来的session.jsonl文件还在吗？
不在了，压缩成功后原始JSONL文件会被删除，只保留同名的.gz文件。恢复时会自动解压并重新生成JSONL文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/8monkey-pi-session-gzip/raw/index.md 读取 @8monkey/pi-session-gzip 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/8monkey-pi-session-gzip/raw/index.md（查看排版版本）