用于pi编码代理的具有紧凑占位符的临时粘贴图像缓存。
具有紧凑占位符的临时粘贴图像缓存 PI编码剂.
pi install npm:@tian.zuo/pi-image-cache
缓存粘贴的图像，使它们以紧凑的形式存在 [Image#NNN] 占位符和
在发送时重新附加到模型上。
在macOS, Ctrl+V 直接粘贴剪贴板图像-都是原始图像数据
（截图，“复制图像”）和在Finder中复制的图像文件，包括
同时处理多个文件。文件引用胜过粘贴图像数据，
因为Finder还在剪贴板上放了一个通用的1024×1024文档图标
在它复制的文件旁边。
藏物就在 ~/.pi/agent/cache/image-cache/ 24小时TTL，
每个非PNG图像都有一个小的PNG格式，因此可以进行内联预览
Kitty协议终端（Ghostty, Kitty, WezTerm）和一个会话后恢复。
Ctrl+V -粘贴剪贴板图片（macOS）。/images -列出缓存的图片。/image-cache-clear -清空缓存。麻省理工学院 ©田左
@tian.zuo/pi-image-cache 共发布 4 个版本，首次发布于 2026/08/21；过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。
| 版本 | 发布日期 | 距今 |
|---|---|---|
0.1.3latest | 2026/11/02 | 今天 |
0.1.2 | 2026/08/30 | 2 个月前 |
0.1.1 | 2026/08/29 | 2 个月前 |
0.1.0 | 2026/08/21 | 2 个月前 |
用于pi编码代理的具有紧凑占位符的临时粘贴图像缓存。
在项目目录运行 npm install @tian.zuo/pi-image-cache，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（*）、@earendil-works/pi-tui（*）、@earendil-works/pi-coding-agent（*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/tian.zuo__pi-image-cache 是否存在。
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@tian.zuo/pi-image-cache 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
最新版本 0.1.3 发布于 2026/11/02（今天）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。