63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
---
|
||
name: desktop-screenshot
|
||
description: Capture Windows desktop screenshot with automatic file saving. When you need to show desktop state, capture application windows, or record operation results. IMPORTANT - must actually call this tool, never say 'screenshot done' without calling. Returns file_path for deliver_artifacts.
|
||
system: true
|
||
handler: desktop
|
||
tool-name: desktop_screenshot
|
||
category: Desktop
|
||
---
|
||
|
||
# Desktop Screenshot
|
||
|
||
截取 Windows 桌面屏幕截图。
|
||
|
||
## Important
|
||
|
||
**用户要求截图时，必须实际调用此工具。禁止不调用就说"截图完成"！**
|
||
|
||
## Parameters
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|-----|------|-----|------|
|
||
| path | string | 否 | 保存路径（可选，自动生成） |
|
||
| window_title | string | 否 | 只截取指定窗口（模糊匹配） |
|
||
| analyze | boolean | 否 | 是否用视觉模型分析，默认 false |
|
||
| analyze_query | string | 否 | 分析查询（需要 analyze=true） |
|
||
|
||
## Examples
|
||
|
||
**截取整个桌面**:
|
||
```json
|
||
{}
|
||
```
|
||
|
||
**截取指定窗口**:
|
||
```json
|
||
{"window_title": "记事本"}
|
||
```
|
||
|
||
**截取并分析**:
|
||
```json
|
||
{
|
||
"analyze": true,
|
||
"analyze_query": "找到所有按钮"
|
||
}
|
||
```
|
||
|
||
## Workflow
|
||
|
||
1. 调用此工具截图
|
||
2. 获取返回的 `file_path`
|
||
3. 用 `deliver_artifacts` 发送给用户
|
||
|
||
## Notes
|
||
|
||
- 如果只涉及浏览器内的网页操作，请使用 `browser_screenshot`
|
||
- 截图默认保存到用户桌面
|
||
|
||
## Related Skills
|
||
|
||
- `browser-screenshot`: 截取浏览器页面
|
||
- `deliver-artifacts`: 发送截图给用户
|
||
- `desktop-click`: 点击桌面元素
|