@zichuanlan/pi-image-placeholder

为Pi终端截图提供图像占位符和SIXEL缩略图预览。

安装使用

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

帮我安装这个 AI Skill:@zichuanlan/pi-image-placeholder。
它的用途是:为Pi终端截图提供图像占位符和SIXEL缩略图预览。
完整的 Skill 内容见:https://321skill.com/skills/zichuanlan-pi-image-placeholder/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“用agent_browser打开我的项目首页,并截取首屏的图片。” 它会调用浏览器打开页面并截图,随后在对话中插入类似`[image 1]`的占位符,并在支持SIXEL的终端侧边显示该截图的缩略图,方便你快速确认截图内容。当你需要引用这张图时,直接说“看看刚才截的图”即可。

介绍

这个Skill主要解决了开发者在终端(如Windows Terminal + zentui)中进行截图、粘贴或查看工具输出时,图像内容难以直观预览和管理的问题。它通过生成带有编号的[image n]占位符来标记图像位置,并利用SIXEL图形协议在支持的终端中直接显示图像缩略图,使截图和图像内容的上下文一目了然。

使用方式非常直接。安装后,在Pi中激活该扩展,当你在使用agent_browser、agent-browser或Playwright等工具进行截图,或从剪贴板粘贴图像时,它会自动处理图像并生成对应的占位符和缩略图。你可以通过wrapthumbs等开关来控制是否启用包装或缩略图功能,以适应不同的工作流需求。

它非常适合需要频繁在终端环境中进行截图、调试网页、记录操作步骤或制作教程的开发者。无论是前端开发者在调试UI、全栈开发者在记录接口返回的图片数据,还是智能体开发者在测试浏览器自动化脚本时,都能通过直观的缩略图快速定位和回顾相关图像内容。

建议在支持SIXEL的终端(如Windows Terminal配合特定配置)中使用以获得最佳的缩略图预览体验。如果终端不支持SIXEL,占位符功能依然有效,但可能无法显示缩略图。注意,它主要优化了终端内的图像展示体验,对于复杂的图像编辑或管理任务,仍需借助专业工具。

核心特点

核心区别在于它专为Pi Agent的终端工作流设计,深度集成了SIXEL协议以实现真正的终端内图像缩略图预览,而不仅仅是生成文件路径或链接。同时,它针对agent_browser/Playwright等浏览器自动化工具的截图输出做了专门优化,能无缝嵌入到自动化测试和调试流程中。

注意事项

不适合需要高分辨率图像编辑、复杂图像处理或在不支持SIXEL协议的终端环境中期望看到缩略图的场景。

常见问题

如何在Windows Terminal中启用SIXEL支持?

通常需要在Windows Terminal设置中启用“实验性SIXEL图形支持”或使用支持SIXEL的字体和配色方案,具体取决于你的终端版本和配置。

这个扩展能和哪些截图工具一起用?

它主要与Pi内置的agent_browser、agent-browser以及Playwright集成,用于处理这些工具的直接截图输出,也可以处理从系统剪贴板粘贴的图像。

给 AI 助手的安装指引

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

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