[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DJMNNFVCY0V3DEZKSX9B65":3,"skill-same:01M6DJMNNFVCY0V3DEZKSX9B65":55},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":29,"linkOnly":30,"markdownContent":31,"markdownBody":32,"frontMatter":33,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":40,"install":41,"resources":54},"01M6DJMNNFVCY0V3DEZKSX9B65","viewport-operations",null,"OpenGeoLab 3D 视口操作完整参考：capture_viewport, camera, selection, labels, visibility, pick_area; enforce describe_action then execute_action with exact schema","HATTER-LONG\u002FOpenGeoLab","HATTER-LONG","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F31438141?v=4","01M6DJKYBT07BT5RXA143RV4PZ","Layton","01M6DJKYFSP4TF6WRMYHT9WVKX",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab\u002Fblob\u002Fmain\u002Fplugins\u002Fai_chat_plugin\u002Fprompts\u002Fviewport-operations\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28],"operations","viewport operations","3D","pick","capture","execute","schema","camera","selection","enforce","2026-11-10 10:12:30",false,"---\nname: viewport-operations\ndescription: OpenGeoLab 3D 视口操作完整参考：capture_viewport, camera, selection, labels, visibility, pick_area; enforce describe_action then execute_action with exact schema\n---\n\n# Viewport Operations\n\n## 目标与边界\n\n本 skill 覆盖 `scene` 模块全部 20 个 action，用于：\n\n- 视口观察与截图\n- 相机控制\n- 选择与框选\n- 标签管理\n- 可见性与场景管理\n\n工具调用约定：\n\n- `describe_action(\"scene\", action_name)`：先拿 schema\n- `execute_action(\"scene\", action, params)`：再执行\n\n## 强制执行流程\n\n每次调用 action 都遵循以下顺序，不跳步：\n\n1. 明确目标 action\n2. 先调用 `describe_action(\"scene\", action)` 获取最新 schema\n3. 按 schema 组装参数（字段名、类型、必填严格一致）\n4. 调用 `execute_action(\"scene\", action, params)`\n5. 校验返回：`ok == true` 才进入下一步；`ok == false` 时读取 `summary`\u002F`error`，修正后重试\n\n## 参数名陷阱（高频错误）\n\n| 使用场景 | 实体类型字段名 |\n|----------|----------------|\n| `select` \u002F `deselect` \u002F `query_selection` \u002F `set_hover` | `type` |\n| `add_label` \u002F `remove_label` \u002F `describe_labels` | `entityType` |\n\n有效的实体类型值：\n\n| 类别 | 值 |\n|------|-----|\n| 几何 | `GeoVertex`、`GeoEdge`、`GeoWire`、`GeoFace`、`GeoSolid` |\n| 网格 | `MeshNode`、`MeshEdge`、`MeshElement` |\n\n⚠️ **实体类型必须精确匹配**：先 `query_selection` 查到精确的 `type`，再原样传给 `deselect`。\n\n字段映射速查：\n\n```json\n{\n   \"selectionEntity\": {\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3},\n   \"labelEntity\": {\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3}\n}\n```\n\nID 规则：\n\n- `shapeId`：来自 geometry 创建\u002F导入结果，0-based\n- `localId`：拓扑局部编号，**1-based**，不要传 0\n\n---\n\n## 观察与查询（4 个）\n\n### capture_viewport\n\n捕获视口截图与结构化元数据。\n\n| 参数 | 类型 | 必填 | 默认 | 说明 |\n|------|------|------|------|------|\n| `width` | integer | 否 | 1024 | 截图宽度（像素） |\n| `height` | integer | 否 | 768 | 截图高度（像素） |\n| `includeMetadata` | boolean | 否 | true | 包含结构化元数据 |\n| `captureImage` | boolean | 否 | true | 返回 base64 图片（JSON 中） |\n| `outputPath` | string | 否 | — | 绝对路径，PNG 直接写入文件 |\n\n返回元数据结构：\n\n```json\n{\n  \"viewport\": {\"width\": 1024, \"height\": 768},\n  \"camera\": {\"eye\": [x,y,z], \"target\": [x,y,z], \"up\": [x,y,z]},\n  \"visibleShapes\": [{\"shapeId\": 0, \"name\": \"Box\", \"screenBBox\": {\"x\": 100, \"y\": 50, \"w\": 200, \"h\": 150}}],\n  \"selections\": [{\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3}],\n  \"labels\": [{\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3, \"text\": \"Face 3\"}],\n  \"hover\": null\n}\n```\n\n行为说明：\n\n- `outputPath` 成功时返回 `savedPath`；失败时返回 `savedPathError`\n- `captureImage=false` + `outputPath` = 只写文件不返回 base64\n- `captureImage=true` 时，若 5 秒内渲染线程未返回：`image=null` 且带 `imageError`\n- `includeMetadata=false` + `captureImage=false` + 无 `outputPath` = 仅返回最小成功结果\n\n### list_nodes\n\n查询所有场景节点。无参数。\n\n返回：`{ok, nodes: [{sourceType, sourceId, name, visible}]}`\n\n### query_selection\n\n返回当前选中实体。无参数。\n\n返回：`{ok, selections: [{shapeId, type, localId}]}`\n\n### describe_labels\n\n查询所有标签状态。无参数。\n\n返回：`{ok, labels: [{text, shapeId, entityType, localId, color}]}`\n\n---\n\n## 相机（3 个）\n\n### set_camera\n\n直接设置相机位置、目标和上方向。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `position` | array [x,y,z] | **是** | 相机眼点位置 |\n| `target` | array [x,y,z] | **是** | 注视目标点 |\n| `up` | array [x,y,z] | **是** | 上方向向量 |\n\n返回：`{ok}`\n\n### set_view_preset\n\n应用预设视角。\n\n| 参数 | 类型 | 必填 | 有效值 |\n|------|------|------|--------|\n| `preset` | string | **是** | `\"Front\"` \u002F `\"Back\"` \u002F `\"Top\"` \u002F `\"Bottom\"` \u002F `\"Left\"` \u002F `\"Right\"` \u002F `\"Isometric\"` |\n\n返回：`{ok}`\n\n### fit_to_scene\n\n相机适配场景范围。无参数。\n\n返回：`{ok}`\n\n---\n\n## 选择（6 个）\n\n### select\n\n添加实体到选择集。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entities` | array | **是** | `[{shapeId, type, localId}]` |\n| `append` | boolean | 否 | true=追加, false=替换当前选择（默认追加） |\n\n返回：`{ok, selected: \u003C数量>}`\n\n### deselect\n\n从选择集移除实体。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entities` | array | **是** | `[{shapeId, type, localId}]` — type 必须精确匹配 |\n\n返回：`{ok, removed: \u003C数量>}`\n\n### clear_selection\n\n清空选择集。无参数。\n\n返回：`{ok}`\n\n### pick_area（异步）\n\n框选区域内的实体。\n\n| 参数 | 类型 | 必填 | 默认 | 说明 |\n|------|------|------|------|------|\n| `x0` | number | **是** | — | 框选起点 X |\n| `y0` | number | **是** | — | 框选起点 Y |\n| `x1` | number | **是** | — | 框选终点 X |\n| `y1` | number | **是** | — | 框选终点 Y |\n| `coordType` | string | 否 | `\"normalized\"` | `\"normalized\"` (0-1) 或 `\"pixel\"` |\n| `pickAction` | string | 否 | `\"Add\"` | `\"Add\"` 或 `\"Remove\"`（首字母大写） |\n\n⚠️ 返回 `{ok, async: true}` 仅表示已排队，**不代表选择已完成**。必须后续调用 `query_selection` 获取最终选择结果。\n\n### set_pick_mode\n\n设置拾取模式和掩码。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `pickMask` | integer | 否 | uint32 拾取掩码位域 |\n| `enabled` | boolean | 否 | 启用\u002F禁用拾取 |\n\n返回：`{ok}`\n\n### set_hover\n\n设置或清除悬停高亮实体。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entity` | object 或 null | 否 | `{shapeId, type, localId}` 设置悬停；`null` 或省略则清除 |\n\n⚠️ 是**单个 `entity` 对象**（可选），不是 3 个独立参数。\n\n返回：`{ok}`\n\n---\n\n## 标签（5 个）\n\n### add_label\n\n为实体创建或替换标签。标签文本**自动生成**（无 text 输入参数）。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `shapeId` | integer | **是** | 形状 ID |\n| `entityType` | string | **是** | 实体类型（注意是 `entityType` 不是 `type`） |\n| `localId` | integer | **是** | 子形状编号 |\n\n返回：`{ok, text: \"生成的标签文本\"}`\n\n### remove_label\n\n移除实体标签。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `shapeId` | integer | **是** | 形状 ID |\n| `entityType` | string | **是** | 实体类型 |\n| `localId` | integer | **是** | 子形状编号 |\n\n返回：`{ok}`\n\n### clear_labels\n\n清除所有标签。无参数。\n\n返回：`{ok}`\n\n### set_labels_visible\n\n控制标签渲染显示。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `visible` | boolean | **是** | true=显示, false=隐藏 |\n\n返回：`{ok}`\n\n### set_auto_label\n\n控制自动标签功能。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `enabled` | boolean | **是** | true=启用, false=禁用 |\n\n返回：`{ok}`\n\n---\n\n## 场景管理（2 个）\n\n### set_visibility\n\n批量设置节点可见性。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `type` | string | **是** | 源类别：`\"geometry\"` \u002F `\"mesh\"` \u002F `\"node\"` |\n| `nodes` | array | **是** | `[{id, visible}]` |\n\n`id` 语义随 `type` 变化：\n- `type=\"geometry\"` → id 是 shapeId\n- `type=\"mesh\"` → id 是 meshId（通常等于 shapeId）\n- `type=\"node\"` → id 是内部 nodeId\n\n返回：`{ok, updated: \u003C数量>, skipped: \u003C数量>}`\n\n### new_model\n\n重置工作区（清空所有几何体、网格、标签、选择）。无参数。\n\n⚠️ **破坏性操作**，执行前应确认用户意图。\n\n返回：`{ok}`\n\n---\n\n## 推荐任务模板\n\n### 看当前视图里有什么\n\n```\nexecute_action(\"scene\", \"capture_viewport\", {})\n→ 从 metadata.visibleShapes、metadata.selections、metadata.labels 解释视图\n```\n\n### 保存视口截图到文件\n\n```\nexecute_action(\"scene\", \"capture_viewport\", {\"captureImage\": false, \"outputPath\": \"C:\u002Fpath\u002Foutput.png\"})\n→ 检查返回 savedPath 确认写入成功\n```\n\n### 选择一个面并打标签\n\n```\nexecute_action(\"scene\", \"select\", {\"entities\": [{\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3}], \"append\": false})\nexecute_action(\"scene\", \"add_label\", {\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3})\nexecute_action(\"scene\", \"capture_viewport\", {})  \u002F\u002F 复核结果\n```\n\n### 框选区域\n\n```\nexecute_action(\"scene\", \"pick_area\", {\"x0\": 0.2, \"y0\": 0.3, \"x1\": 0.8, \"y1\": 0.7, \"coordType\": \"normalized\"})\nexecute_action(\"scene\", \"query_selection\", {})  \u002F\u002F 获取最终选中实体\n```\n\n### 隐藏一个几何体\n\n```\nexecute_action(\"scene\", \"set_visibility\", {\"type\": \"geometry\", \"nodes\": [{\"id\": 0, \"visible\": false}]})\n```\n\n### 切换相机视角\n\n```\nexecute_action(\"scene\", \"set_view_preset\", {\"preset\": \"Front\"})\n\u002F\u002F 或自定义：\nexecute_action(\"scene\", \"set_camera\", {\"position\": [0, 0, 100], \"target\": [0, 0, 0], \"up\": [0, 1, 0]})\n```\n\n---\n\n## 屏幕坐标系\n\n- 原点 (0,0) 在**左上角**\n- X 向右增大，Y 向下增大\n- `screenBBox` 以像素为单位，相对于截图分辨率\n- `pick_area` 归一化坐标：(0,0) 左上 → (1,1) 右下\n\n## 完成判定\n\n1. 目标 action 全部 `ok=true`\n2. 关键返回字段存在且结构正确\n3. 异步选择（pick_area）已做二次查询（query_selection）\n4. 最终用 `capture_viewport` 二次确认\n\n## 失败恢复\n\n当 `ok=false`：\n\n1. 先读 `summary`\u002F`error`\n2. 重新 `describe_action` 校验参数名和类型\n3. 修正后重试，避免盲目改动多个字段\n\n禁止行为：\n\n- 跳过 `describe_action` 直接猜参数\n- 混用 `type` 与 `entityType`\n- 对 `pick_area` 的返回直接当作最终选择结果\n","# Viewport Operations\n\n## 目标与边界\n\n本 skill 覆盖 `scene` 模块全部 20 个 action，用于：\n\n- 视口观察与截图\n- 相机控制\n- 选择与框选\n- 标签管理\n- 可见性与场景管理\n\n工具调用约定：\n\n- `describe_action(\"scene\", action_name)`：先拿 schema\n- `execute_action(\"scene\", action, params)`：再执行\n\n## 强制执行流程\n\n每次调用 action 都遵循以下顺序，不跳步：\n\n1. 明确目标 action\n2. 先调用 `describe_action(\"scene\", action)` 获取最新 schema\n3. 按 schema 组装参数（字段名、类型、必填严格一致）\n4. 调用 `execute_action(\"scene\", action, params)`\n5. 校验返回：`ok == true` 才进入下一步；`ok == false` 时读取 `summary`\u002F`error`，修正后重试\n\n## 参数名陷阱（高频错误）\n\n| 使用场景 | 实体类型字段名 |\n|----------|----------------|\n| `select` \u002F `deselect` \u002F `query_selection` \u002F `set_hover` | `type` |\n| `add_label` \u002F `remove_label` \u002F `describe_labels` | `entityType` |\n\n有效的实体类型值：\n\n| 类别 | 值 |\n|------|-----|\n| 几何 | `GeoVertex`、`GeoEdge`、`GeoWire`、`GeoFace`、`GeoSolid` |\n| 网格 | `MeshNode`、`MeshEdge`、`MeshElement` |\n\n⚠️ **实体类型必须精确匹配**：先 `query_selection` 查到精确的 `type`，再原样传给 `deselect`。\n\n字段映射速查：\n\n```json\n{\n   \"selectionEntity\": {\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3},\n   \"labelEntity\": {\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3}\n}\n```\n\nID 规则：\n\n- `shapeId`：来自 geometry 创建\u002F导入结果，0-based\n- `localId`：拓扑局部编号，**1-based**，不要传 0\n\n---\n\n## 观察与查询（4 个）\n\n### capture_viewport\n\n捕获视口截图与结构化元数据。\n\n| 参数 | 类型 | 必填 | 默认 | 说明 |\n|------|------|------|------|------|\n| `width` | integer | 否 | 1024 | 截图宽度（像素） |\n| `height` | integer | 否 | 768 | 截图高度（像素） |\n| `includeMetadata` | boolean | 否 | true | 包含结构化元数据 |\n| `captureImage` | boolean | 否 | true | 返回 base64 图片（JSON 中） |\n| `outputPath` | string | 否 | — | 绝对路径，PNG 直接写入文件 |\n\n返回元数据结构：\n\n```json\n{\n  \"viewport\": {\"width\": 1024, \"height\": 768},\n  \"camera\": {\"eye\": [x,y,z], \"target\": [x,y,z], \"up\": [x,y,z]},\n  \"visibleShapes\": [{\"shapeId\": 0, \"name\": \"Box\", \"screenBBox\": {\"x\": 100, \"y\": 50, \"w\": 200, \"h\": 150}}],\n  \"selections\": [{\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3}],\n  \"labels\": [{\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3, \"text\": \"Face 3\"}],\n  \"hover\": null\n}\n```\n\n行为说明：\n\n- `outputPath` 成功时返回 `savedPath`；失败时返回 `savedPathError`\n- `captureImage=false` + `outputPath` = 只写文件不返回 base64\n- `captureImage=true` 时，若 5 秒内渲染线程未返回：`image=null` 且带 `imageError`\n- `includeMetadata=false` + `captureImage=false` + 无 `outputPath` = 仅返回最小成功结果\n\n### list_nodes\n\n查询所有场景节点。无参数。\n\n返回：`{ok, nodes: [{sourceType, sourceId, name, visible}]}`\n\n### query_selection\n\n返回当前选中实体。无参数。\n\n返回：`{ok, selections: [{shapeId, type, localId}]}`\n\n### describe_labels\n\n查询所有标签状态。无参数。\n\n返回：`{ok, labels: [{text, shapeId, entityType, localId, color}]}`\n\n---\n\n## 相机（3 个）\n\n### set_camera\n\n直接设置相机位置、目标和上方向。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `position` | array [x,y,z] | **是** | 相机眼点位置 |\n| `target` | array [x,y,z] | **是** | 注视目标点 |\n| `up` | array [x,y,z] | **是** | 上方向向量 |\n\n返回：`{ok}`\n\n### set_view_preset\n\n应用预设视角。\n\n| 参数 | 类型 | 必填 | 有效值 |\n|------|------|------|--------|\n| `preset` | string | **是** | `\"Front\"` \u002F `\"Back\"` \u002F `\"Top\"` \u002F `\"Bottom\"` \u002F `\"Left\"` \u002F `\"Right\"` \u002F `\"Isometric\"` |\n\n返回：`{ok}`\n\n### fit_to_scene\n\n相机适配场景范围。无参数。\n\n返回：`{ok}`\n\n---\n\n## 选择（6 个）\n\n### select\n\n添加实体到选择集。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entities` | array | **是** | `[{shapeId, type, localId}]` |\n| `append` | boolean | 否 | true=追加, false=替换当前选择（默认追加） |\n\n返回：`{ok, selected: \u003C数量>}`\n\n### deselect\n\n从选择集移除实体。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entities` | array | **是** | `[{shapeId, type, localId}]` — type 必须精确匹配 |\n\n返回：`{ok, removed: \u003C数量>}`\n\n### clear_selection\n\n清空选择集。无参数。\n\n返回：`{ok}`\n\n### pick_area（异步）\n\n框选区域内的实体。\n\n| 参数 | 类型 | 必填 | 默认 | 说明 |\n|------|------|------|------|------|\n| `x0` | number | **是** | — | 框选起点 X |\n| `y0` | number | **是** | — | 框选起点 Y |\n| `x1` | number | **是** | — | 框选终点 X |\n| `y1` | number | **是** | — | 框选终点 Y |\n| `coordType` | string | 否 | `\"normalized\"` | `\"normalized\"` (0-1) 或 `\"pixel\"` |\n| `pickAction` | string | 否 | `\"Add\"` | `\"Add\"` 或 `\"Remove\"`（首字母大写） |\n\n⚠️ 返回 `{ok, async: true}` 仅表示已排队，**不代表选择已完成**。必须后续调用 `query_selection` 获取最终选择结果。\n\n### set_pick_mode\n\n设置拾取模式和掩码。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `pickMask` | integer | 否 | uint32 拾取掩码位域 |\n| `enabled` | boolean | 否 | 启用\u002F禁用拾取 |\n\n返回：`{ok}`\n\n### set_hover\n\n设置或清除悬停高亮实体。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `entity` | object 或 null | 否 | `{shapeId, type, localId}` 设置悬停；`null` 或省略则清除 |\n\n⚠️ 是**单个 `entity` 对象**（可选），不是 3 个独立参数。\n\n返回：`{ok}`\n\n---\n\n## 标签（5 个）\n\n### add_label\n\n为实体创建或替换标签。标签文本**自动生成**（无 text 输入参数）。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `shapeId` | integer | **是** | 形状 ID |\n| `entityType` | string | **是** | 实体类型（注意是 `entityType` 不是 `type`） |\n| `localId` | integer | **是** | 子形状编号 |\n\n返回：`{ok, text: \"生成的标签文本\"}`\n\n### remove_label\n\n移除实体标签。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `shapeId` | integer | **是** | 形状 ID |\n| `entityType` | string | **是** | 实体类型 |\n| `localId` | integer | **是** | 子形状编号 |\n\n返回：`{ok}`\n\n### clear_labels\n\n清除所有标签。无参数。\n\n返回：`{ok}`\n\n### set_labels_visible\n\n控制标签渲染显示。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `visible` | boolean | **是** | true=显示, false=隐藏 |\n\n返回：`{ok}`\n\n### set_auto_label\n\n控制自动标签功能。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `enabled` | boolean | **是** | true=启用, false=禁用 |\n\n返回：`{ok}`\n\n---\n\n## 场景管理（2 个）\n\n### set_visibility\n\n批量设置节点可见性。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `type` | string | **是** | 源类别：`\"geometry\"` \u002F `\"mesh\"` \u002F `\"node\"` |\n| `nodes` | array | **是** | `[{id, visible}]` |\n\n`id` 语义随 `type` 变化：\n- `type=\"geometry\"` → id 是 shapeId\n- `type=\"mesh\"` → id 是 meshId（通常等于 shapeId）\n- `type=\"node\"` → id 是内部 nodeId\n\n返回：`{ok, updated: \u003C数量>, skipped: \u003C数量>}`\n\n### new_model\n\n重置工作区（清空所有几何体、网格、标签、选择）。无参数。\n\n⚠️ **破坏性操作**，执行前应确认用户意图。\n\n返回：`{ok}`\n\n---\n\n## 推荐任务模板\n\n### 看当前视图里有什么\n\n```\nexecute_action(\"scene\", \"capture_viewport\", {})\n→ 从 metadata.visibleShapes、metadata.selections、metadata.labels 解释视图\n```\n\n### 保存视口截图到文件\n\n```\nexecute_action(\"scene\", \"capture_viewport\", {\"captureImage\": false, \"outputPath\": \"C:\u002Fpath\u002Foutput.png\"})\n→ 检查返回 savedPath 确认写入成功\n```\n\n### 选择一个面并打标签\n\n```\nexecute_action(\"scene\", \"select\", {\"entities\": [{\"shapeId\": 0, \"type\": \"GeoFace\", \"localId\": 3}], \"append\": false})\nexecute_action(\"scene\", \"add_label\", {\"shapeId\": 0, \"entityType\": \"GeoFace\", \"localId\": 3})\nexecute_action(\"scene\", \"capture_viewport\", {})  \u002F\u002F 复核结果\n```\n\n### 框选区域\n\n```\nexecute_action(\"scene\", \"pick_area\", {\"x0\": 0.2, \"y0\": 0.3, \"x1\": 0.8, \"y1\": 0.7, \"coordType\": \"normalized\"})\nexecute_action(\"scene\", \"query_selection\", {})  \u002F\u002F 获取最终选中实体\n```\n\n### 隐藏一个几何体\n\n```\nexecute_action(\"scene\", \"set_visibility\", {\"type\": \"geometry\", \"nodes\": [{\"id\": 0, \"visible\": false}]})\n```\n\n### 切换相机视角\n\n```\nexecute_action(\"scene\", \"set_view_preset\", {\"preset\": \"Front\"})\n\u002F\u002F 或自定义：\nexecute_action(\"scene\", \"set_camera\", {\"position\": [0, 0, 100], \"target\": [0, 0, 0], \"up\": [0, 1, 0]})\n```\n\n---\n\n## 屏幕坐标系\n\n- 原点 (0,0) 在**左上角**\n- X 向右增大，Y 向下增大\n- `screenBBox` 以像素为单位，相对于截图分辨率\n- `pick_area` 归一化坐标：(0,0) 左上 → (1,1) 右下\n\n## 完成判定\n\n1. 目标 action 全部 `ok=true`\n2. 关键返回字段存在且结构正确\n3. 异步选择（pick_area）已做二次查询（query_selection）\n4. 最终用 `capture_viewport` 二次确认\n\n## 失败恢复\n\n当 `ok=false`：\n\n1. 先读 `summary`\u002F`error`\n2. 重新 `describe_action` 校验参数名和类型\n3. 修正后重试，避免盲目改动多个字段\n\n禁止行为：\n\n- 跳过 `describe_action` 直接猜参数\n- 混用 `type` 与 `entityType`\n- 对 `pick_area` 的返回直接当作最终选择结果\n",{"name":5,"description":7},"main","af9eb983789f2ca07f2ed05de89230334ca3cf9b","plugins\u002Fai_chat_plugin\u002Fprompts\u002Fviewport-operations",1,"https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab","https:\u002F\u002Fgithub.com\u002FHATTER-LONG","2026-08-19 16:11:13",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add HATTER-LONG\u002FOpenGeoLab --skill viewport-operations",{"tool":47,"command":48},"bunx","bunx skills add HATTER-LONG\u002FOpenGeoLab --skill viewport-operations",{"tool":50,"command":51},"pnpm","pnpm dlx skills add HATTER-LONG\u002FOpenGeoLab --skill viewport-operations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab\u002Fblob\u002Fmain\u002Fplugins\u002Fai_chat_plugin\u002Fprompts\u002Fviewport-operations\u002FSKILL.md",true,[],[56,67,72],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":29},"01M6DJM8CMSXXC6JFCYZ28FJF2","opengeolab-commands","OpenGeoLab 命令协议与完整 action 参数参考；先 describe_action 再 execute_action，涵盖 geometry mesh scene 三大模块","https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab\u002Fblob\u002Fmain\u002Fplugins\u002Fai_chat_plugin\u002Fprompts\u002Fopengeolab-commands\u002FSKILL.md",[],[63,64,65,24,66],"commands","opengeolab commands","mesh","geometry",{"skillNo":68,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":29},"01M6DJM6846KAFPN1G18S3RY2Y","https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab\u002Fblob\u002Fmain\u002Fdocs\u002Fsuperpowers\u002Fskills\u002Fviewport-operations\u002FSKILL.md",[],[19,20],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":29},"01M6DJM3DHWT8TWPAV85N8SZCZ","action-remote-call","需要通过 HTTP 控制 OpenGeoLab 时使用 — 创建几何体、截取视窗、控制相机、管理选择、生成网格，或通过 REST API 远程调用任意 Action","https:\u002F\u002Fgithub.com\u002FHATTER-LONG\u002FOpenGeoLab\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Faction-remote-call\u002FSKILL.md",[],[79,80,81,82,83,84,85],"call","action remote call","http","REST","api","生成","rest api"]