浏览用户指南

工具参考

Shotomatic 为 AI 智能体提供的所有 MCP 工具:每个工具的作用、哪些会先征求你的确认,以及哪些部分需要 Pro。

更新日期 2026年11月16日

查看 Markdown
本页内容

本页列出 Shotomatic 1.10.1 向已批准的智能体提供的 MCP 工具。智能体连接时会读取同一份列表,并附带完整的输入结构。这些工具不需要你亲自调用,但了解它们有助于你把请求写清楚,也更容易看懂智能体的汇报。

什么任务用什么工具

你想让智能体……使用的工具
检查权限、版本和正在运行的任务get_status
查看屏幕上有什么list_capture_sources, capture_snapshot, capture_window_snapshot
按键并反复截取某个窗口start_auto_capture, get_job, control_job
记录逐步点击指南start_action_capture, get_job, control_job
截取网页preview_website, capture_websites, get_job, control_job
复用或定时运行网页设置website_capture_options, website_workflows
查找并查看以前的截图list_capture_sessions, get_capture_session, view_images
创建和编辑文档list_documents, get_document, create_document, add_pages, edit_document
导出文件export, get_job
整理delete_items, rename_capture_session
更改截图和导出设置update_settings

耗时的任务会立即返回任务 ID。智能体用 get_job 跟踪任务,每次调用最多等待 50 秒,所以长时间的截图会在两次调用之间继续在 Shotomatic 中运行。

状态与截图来源

get_status

返回应用版本、是否已授予屏幕录制和辅助功能权限、你的版本以及今天还能使用的免费截图数、功能限制、正在运行的任务、网页浏览器是否已安装,以及当前设置。智能体会先调用它,在你修好某个问题后也会再调用一次。

list_capture_sources

列出 Shotomatic 可以截取的窗口和屏幕,包括 ID、名称和所属应用名称。

capture_snapshot

预览某个窗口或屏幕,确认打开的是正确的页面。预览是较小的 JPEG,不会保存到截图历史,也不占用免费截图数。

capture_window_snapshot

截取一个窗口的 PNG 快照并返回给智能体。和 capture_snapshot 一样不会保存。

截图与任务

start_auto_capture

按固定间隔截取一个窗口,并可以在每次截图后按一个键,例如用向右方向键翻页。Shotomatic 会把窗口调到最前面;如果其他窗口在前面或屏幕已锁定,它不会按键,而是暂停任务。设置了按键时,页面不再变化就会自动停止。停止条件取决于你的版本,详见停止条件、时间间隔和按键。

start_action_capture

启动 Action Capture:在所选窗口中每点击一次就保存一个步骤,截图停止时生成文档。Shotomatic 不会点击。点击由你来做,或者由具备自身电脑操作能力的智能体来做。

get_job

检查之前启动的截图、网页批量任务或导出,并可以等待进度。

control_job

控制正在运行的任务。自动截图:暂停、继续或停止,已截取的截图会保留。Action Capture:停止并生成文档,或不点击直接保存一个步骤。网页批量任务:取消整个批次,或取消、重试单个页面。

网页截图

preview_website

用指定选项在 Shotomatic 的浏览器中渲染一个网址,并把结果给智能体看,便于在批量截取前调整选项。预览不会保存。

capture_websites

按整页或可见区域、桌面·平板·手机尺寸截取一组网页,保存为一个截图会话;也可以立即运行已保存的工作流。不会使用你的屏幕。需要安装网页浏览器,详见网页截图快速入门。

website_capture_options

列出、读取或保存网页截图的已保存选项。智能体不能删除已保存选项。

website_workflows

列出、读取、保存、暂停或继续工作流。计划可以是至少 5 分钟的间隔,或每天的固定时间。保存带计划的工作流或继续工作流时,会等待你的确认;暂停则不需要。计划运行只在 Shotomatic 打开时进行,应用关闭期间错过的运行不会补上。智能体不能删除工作流。

截图历史

list_capture_sessions

按从新到旧列出截图会话,附带画面数量,以及由该会话生成的文档(如有)。

get_capture_session

读取一个会话:摘要、画面文件路径(每次最多 200 个),网页截图还会给出每个页面及其状态。

rename_capture_session

修改会话在 Shotomatic 中显示的名称。

view_images

把截图历史中的画面或文档页面作为图片给智能体看,每次最多 6 张,总计不超过 8 MB。文档页面显示为原图,不含裁剪和标注。智能体查看过的图片会成为它对话的一部分。

文档

list_documents

按最近修改的顺序列出文档。

get_document

读取文档:标题、修订版本、各页面的文字、画面范围和标注。

create_document

用截图会话中的画面、图片文件或空白页面创建文档。如果选择的整个会话已经有文档,会返回那份文档,而不是副本。

add_pages

用截图会话中的画面或图片文件添加页面,放在末尾或指定页面之后。

edit_document

一次性修改文档:标题、页面标题和说明、画面范围、标注、页面顺序、复制或删除页面以及水印。只要有一处失败,就不会做任何更改。模糊、标记、点击标记和水印需要 Pro。如果文档正在编辑器中打开,编辑器会重新载入它。

导出与设置

export

把文档导出为 PDF、PNG、JPG、WebP 或 ZIP,把截图会话的画面导出为 ZIP、PNG、JPG、可搜索 PDF 或 MP4。文件会以新名称保存到导出文件夹,不会覆盖已有文件,屏幕上也不会打开任何内容。

update_settings

更改自动导出(开或关,PNG 或 JPG)、JPG 质量,以及截图历史保留的会话数。如果新上限会删除会话,会先问你。导出文件夹、语言、预设和许可证无法更改。

删除

delete_items

一次请求最多删除 50 个文档或截图会话。Shotomatic 会显示一张列出所有项目的确认卡片,最多等待一分钟。删除截图会话不会删除由它生成的文档。请参阅批准与确认。

如果工具返回错误,请参阅智能体错误与解决方法。

工具参考 | 用户指南 | Shotomatic