@m64/pi-screenshot-tools
跨桌面截图+内联显示的pi技能包
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@m64/pi-screenshot-tools。 它的用途是:跨桌面截图+内联显示的pi技能包 完整的 Skill 内容见:https://321skill.com/skills/m64-pi-screenshot-tools/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“截取当前活动窗口的截图”,它会自动调用后端截图工具捕获活动窗口,并在支持内联显示的终端中直接展示截图结果。也可使用命令/screenshot active-window快速完成截图。
介绍
这个Skill解决了AI助手使用过程中截图不便、展示困难的问题。在实际开发中,开发者经常需要截取屏幕、窗口或区域,并将截图直接展示给AI助手以便进一步分析或讨论,但大多数截图工具缺乏与AI终端的深度集成,截图后还需手动上传或切换窗口,流程繁琐。
使用方式很简单,你只需要通过npm或git安装该技能包,然后重新加载pi即可。之后就可以通过自然语言指令(如“截取当前活动窗口”)或斜杠命令(如/screenshot active-window)来截图,截图结果会自动在支持的终端(如Kitty)内联显示。在tmux环境下,可使用/screenshot-icat命令通过kitten icat显示截图,确保兼容性。
它非常适合需要频繁截图并与AI助手协同工作的团队或个人,尤其是那些已经使用pi作为AI代理平台的开发者。无论是技术文档编写、UI测试反馈、故障排查记录,还是教学演示,都能大幅提升截图与AI交互的流畅度。
建议在Kitty终端中统一使用此工具以获得最佳内联显示效果。需要注意的是,它主要依赖Linux桌面环境下的截图后端(如scrot、maim、grim等),在macOS或Windows上可能无法直接运行。另外,在tmux中虽然可以通过icat回退,但显示稳定性可能不如原生Kitty。
常见问题
如何在tmux中使用截图内联显示?
在tmux中使用/screenshot-icat命令,它会通过kitten icat --stdin=no显示截图,避免pi TUI渲染的不稳定问题。
截图失败怎么办?
请确保系统已安装截图依赖(如scrot、maim或grim),并检查capture.sh脚本是否可执行。若仍失败,可尝试/screenshot-debug查看详细日志。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/m64-pi-screenshot-tools/raw/index.md 读取 @m64/pi-screenshot-tools 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/m64-pi-screenshot-tools/raw/index.md(查看排版版本)