# @tian\.zuo/pi-image-cache 中文文档

规范地址：https://npmcn.com/package/%40tian.zuo/pi-image-cache/

版本：0\.1\.3
npm 元数据更新时间：2026-11-02T15:04:15.234Z
中文译文更新时间：2026-11-02T16:49:54.012Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40tian.zuo/pi-image-cache
原文对照：https://npmcn.com/package/%40tian.zuo/pi-image-cache/?lang=original
项目主页：https://github.com/TianZuo555/pi-extensions#image-cache
源码仓库：https://github.com/TianZuo555/pi-extensions

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：52.3 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-08-21T02:03:52.660Z
- 最新版本发布：2026-11-02T15:04:14.810Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

用于pi编码代理的具有紧凑占位符的临时粘贴图像缓存。

## 安装

```sh
npm install @tian.zuo/pi-image-cache
```

也可以使用：`pnpm add @tian.zuo/pi-image-cache`、`yarn add @tian.zuo/pi-image-cache`、`bun add @tian.zuo/pi-image-cache`

## README

# @tian.zuo / pi-image-cache

版本说明: [更新日志](https://github.com/TianZuo555/pi-extensions/blob/main/packages/pi-image-cache/CHANGELOG.md) · [GitHub版本](https://github.com/TianZuo555/pi-extensions/releases)

具有紧凑占位符的临时粘贴图像缓存 [PI编码剂](https://pi.dev/).

```bash
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` -清空缓存。

## 许可证

[麻省理工学院](https://npmcn.com/package/LICENSE) ©田左

## 常见问题

### @tian\.zuo/pi-image-cache 是什么？

用于pi编码代理的具有紧凑占位符的临时粘贴图像缓存。

### 如何安装 @tian\.zuo/pi-image-cache？

在项目目录运行 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 需要手动安装。

### @tian\.zuo/pi-image-cache 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/tian\.zuo\_\_pi-image-cache 是否存在。

### @tian\.zuo/pi-image-cache 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @tian\.zuo/pi-image-cache 可以商用吗？

@tian\.zuo/pi-image-cache 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @tian\.zuo/pi-image-cache 还在维护吗？

最新版本 0\.1\.3 发布于 2026/11/02（今天）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。