使用服务端调用 SDK

建议在服务端或可信执行环境中调用 SDK，不建议在浏览器前端、移动端客户端或用户可反编译的安装包中直接保存 AccessKey Secret。

按任务创建会话

推荐每个自动化任务创建独立会话，任务完成后关闭会话。

const session = await client.createSession();

try {
  // 执行业务操作
} finally {
  await session.close();
}

观察后再操作

GUI 自动化的稳定性依赖界面状态。建议在关键操作前后都进行截图或状态确认。

示例流程：

1. 截图确认页面已打开。

2. 点击目标输入框。

3. 输入文本。

4. 点击查询按钮。

5. 等待结果加载。

6. 再次截图确认结果。

控制单次任务范围

不建议将过长、不可恢复的业务流程放在一个连续脚本中执行。可将复杂任务拆分为多个阶段，每个阶段完成后记录状态，便于失败后从可控节点恢复。

管理文件路径

建议为每个任务分配独立目录：

D:/ai-use/tasks/{taskId}/input
D:/ai-use/tasks/{taskId}/output
D:/ai-use/tasks/{taskId}/logs

这样可以降低文件冲突和误覆盖风险，也便于任务结束后清理。

保护敏感信息

• 日志中不要输出完整密钥。

• 截图中可能包含业务数据，保存和使用时应遵循企业数据安全要求。

• 文件内容可能包含敏感信息，对外共享前应进行脱敏。

• 对外共享排查材料前应进行脱敏。

处理失败任务

失败任务建议记录：

• 当前步骤。

• 最近一次截图。

• 关键输入参数。

• 错误码和错误信息。

• 文件输出情况。

对于可重试任务，应在重试前确认当前桌面状态，避免重复提交或重复写入。

上线检查

上线前建议确认：

• AccessKey 权限范围最小化。

• 云电脑资源数量满足并发需求。

• 会话关闭逻辑可靠。

• 关键操作有截图或状态校验。

• 错误码已映射到业务告警或人工处理流程。

• 任务日志已脱敏。