iDesktopX 桌面 Agent 助手

要解决的问题

当大模型直接操作 SuperMap 同源桌面产品时，常见风险不是“能不能点”，而是命令入口不确定、版本不匹配、REST 已启用却重复启用、success=true 被误认为业务完成，以及模态对话框阻塞后续命令。idesktopx-skills 针对这类桌面自动化场景，把目标产品包根目录、DesktopCLI wrapper、在线 HTTP 与 CLI 兜底路径约束到同一会话中。它适用于 iDesktopX、TransformX、ImageX、iMaritimeEditor、ActiveMap 等同源产品，但实际根目录以用户提供为准。

技能如何工作

该技能先要求 能力分流：优先使用语义最贴近的 domain skill，如 tree/*、form/*、map/*、dataset/*，只有缺少独立 domain 能力时才落到 component/*、dialog/* 或 python 子能力。

会话首次业务前，它会完成几道强制门禁：

• 读取可选的用户级配置，恢复或询问目标产品包根目录
• 绑定该根目录下的 idesktopx / idesktopx.cmd 绝对路径
• 调用 desktop/version_get 校验版本前缀，当前兼容 12.1.
• 通过 rest status 复用已启用 REST，未启用才执行 rest enable
• 在线请求优先走 GET /api/v1/health、POST /api/v1/{domain}/{action} 等 HTTP 端点

执行时强调 最小探测 与 回读验证：form/activate 后要再查 form/active，table/setvalue 后要查 table/getvalue，GPA 异步任务以 gpa/status 终态为准。遇到 BLOCKED_DIALOG 时，必须暂停业务命令，读取阻塞窗口和组件结构，再按用户决策处理。

适用边界

它更适合已有桌面产品运行实例的自动化任务，不适合绕过用户授权修改或删除原数据。配置只是缓存，不是必要前提；版本不匹配、根目录不明确或 REST 入口不可读时，应停止并确认，而不是切换到 PATH 中其它同名命令。