screenshot

用途

screenshot 是一个截图查看类技能，用于快速查找并显示系统中最近的截图。它属于 0xdarkmatter/claude-mods。其核心目的是让用户无需手动打开文件管理器，就能在对话中直接调出最近的截图进行查看、分析和讨论。

主要能力

• 自动检测截图目录：按优先级检查系统中常见的截图存放路径，使用第一个存在的目录。
• 查找最近截图：使用 Glob 查找图片文件（png、jpg、jpeg、gif、webp），按修改时间排序。
• 可视化显示：使用 Read 工具在对话中展示截图，便于分析。
• 支持自定义数量：默认为 5，可通过参数指定。

使用方式

命令形式如下：

• /screenshot — 显示最近 5 张截图（默认）
• /screenshot 1 — 仅显示最近一张
• /screenshot 10 — 显示最近 10 张

带自定义目录的形式：

• /screenshot 5 --dir="C:\Custom\Path"

参数说明：count 参数默认值为 5，表示要显示的截图数量。

检测的截图目录

Windows 优先级顺序：

1. %USERPROFILE%\Pictures\Screenshots（Windows 11 原生）
2. %USERPROFILE%\Documents\ShareX\Screenshots（ShareX）
3. %USERPROFILE%\Pictures\Greenshot（Greenshot）
4. %USERPROFILE%\OneDrive\Pictures\Screenshots（OneDrive 同步）
5. %USERPROFILE%\Pictures（兜底）

macOS：

1. ~/Desktop（macOS 默认位置）
2. ~/Screenshots（自定义文件夹）
3. ~/Pictures（兜底）

Linux：

1. ~/Pictures/Screenshots（GNOME/KDE）
2. ~/Pictures（兜底）
3. ~/Desktop（备选）

查找与显示

查找最近截图时按修改时间排序，例如在 Unix 类系统中使用 fd 或 find 命令筛选图片扩展名并排序取前 N 个；Windows 下用 PowerShell 的 Get-ChildItem 按 LastWriteTime 排序。显示阶段对每张找到的截图调用 Read 工具进行可视化呈现，并标注文件名、大小和修改时间（如“2 分钟前”）。

可选配置

可在项目中创建 .claude/screenshot.json 进行配置，示例：

{
  "directory": "C:\\Custom\\Screenshots",
  "default_count": 3,
  "file_extensions": ["png", "jpg", "webp"]
}

适用场景

• 与 /explain 配合，解释截图中的内容。
• 与 /review 配合，审查截图中的 UI 或代码。
• 与浏览器自动化工具配合，验证截图是否与预期状态一致。

限制与边界情况

• 未找到截图目录：提示已检查的位置，并给出解决建议（如按 Win+Shift+S 截图，或用 --dir 指定自定义目录）。
• 目录存在但无截图：提示该目录下无图片文件。
• 请求数量超过实际数量：会显示全部可用截图并说明实际数量。
• 仅扫描顶层目录，忽略子目录。
• 按修改时间排序（最新的在前）。
• 支持常见图片格式：png、jpg、jpeg、gif、webp。
• 性能方面：使用文件系统工具（fd 或系统原生命令）而非读取全部文件；只读取所需数量；较大的截图会由 Read 工具自动缩放以节省 token。