mcpField
S
screenshot

screenshot

github.com/ninehills生产力27738 次安装18 周前更新
代码仓库

关于 screenshot

Screenshot 是面向 macOS 的截图 Skill，通过 Bash 调用 screencapture 捕获屏幕、窗口或指定区域。它强调先缩小图像再读取，以控制图像进入模型上下文时的大小。

主要功能

  1. 01捕获全屏截图
  2. 02交互选择窗口截图
  3. 03按坐标截取指定区域
  4. 04调整图像尺寸与压缩质量
  5. 05获取图像尺寸信息

适用场景

  1. 01截取屏幕以供视觉检查
  2. 02捕获特定窗口或界面区域
  3. 03缩小截图后再交由模型读取

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ninehills/skills --skill screenshot

安装后在 Claude Code 中输入/screenshot确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
agents/
openai.yaml
scripts/
ensure_macos_permissions.sh
macos_display_info.swift
macos_permissions.swift
macos_window_info.swift
take_screenshot.ps1
take_screenshot.py

详细介绍

截图技能

通过 Bash 使用 macOS screencapture 命令截图。

重要提示：始终调整尺寸以便纳入上下文

全分辨率截图（尤其是在 Retina/5K 显示器上）会生成体积巨大的 base64 数据，超出模型的上下文长度。读取前务必先调整尺寸。

截图并查看

# 1. Capture full screen
/usr/sbin/screencapture -x -t jpg /tmp/alma-screenshot.jpg

# 2. Resize to 1024px wide (critical for context size!)
/usr/bin/sips --resampleWidth 1024 --setProperty formatOptions 60 /tmp/alma-screenshot.jpg --out /tmp/alma-screenshot-thumb.jpg 2>/dev/null

# 3. Get dimensions
/usr/bin/sips -g pixelWidth -g pixelHeight /tmp/alma-screenshot.jpg 2>/dev/null

然后使用 Read 工具读取 /tmp/alma-screenshot-thumb.jpg（调整尺寸后的版本，而不是原始尺寸的版本）。

截图选项

# Full screen (default)
/usr/sbin/screencapture -x -t jpg /tmp/alma-screenshot.jpg

# Interactive window selection
/usr/sbin/screencapture -x -w -t jpg /tmp/alma-screenshot.jpg

# Specific region (x,y,w,h)
/usr/sbin/screencapture -x -R 0,0,800,600 -t jpg /tmp/alma-screenshot.jpg

# With 3-second delay
/usr/sbin/screencapture -x -T 3 -t jpg /tmp/alma-screenshot.jpg

向用户发送截图（Telegram）

如果用户希望直接查看截图，可以使用 alma CLI，也可以直接描述你看到的内容。全分辨率文件位于 /tmp/alma-screenshot.jpg。

提示

  • 读取到上下文之前务必先调整尺寸——使用缩略图版本
  • -x 标志用于关闭截图声音
  • -t jpg 会输出 JPEG（比 PNG 更小）
  • 如需更高压缩率，可使用 sips --setProperty formatOptions 60

评论

支持 Markdown