服务地址配置

创建 Client 时可通过 serviceURL 指定服务地址：

const client = new Client({
  apiKey: process.env.AIUSE_API_KEY,
  apiSecret: process.env.AIUSE_API_SECRET,
  desktopCode: process.env.AIUSE_DESKTOP_CODE,
  serviceURL: 'https://desk.ctyun.cn:8816'
});

如未显式配置服务地址，SDK 将使用默认地址。默认地址以 SDK 实际发布版本为准。

环境变量配置

生产环境建议使用环境变量或密钥管理系统保存敏感配置：

示例：

const client = new Client({
  apiKey: process.env.AIUSE_API_KEY!,
  apiSecret: process.env.AIUSE_API_SECRET!,
  desktopCode: process.env.AIUSE_DESKTOP_CODE!,
  serviceURL: process.env.AIUSE_SERVICE_URL
});

超时与重试

GUI 操作依赖目标桌面状态、应用响应速度和网络情况。建议在业务侧为关键步骤设置超时和重试策略。

推荐策略：

• 对创建会话、截图、文件读取等关键操作设置超时。

• 对临时网络异常可进行有限次数重试。

• 对具有副作用的操作，如点击提交按钮、删除文件、覆盖写入文件，应谨慎重试。

• 重试前应尽量通过截图或状态检查确认当前界面状态。

日志记录

建议记录以下信息：

• 任务 ID。

• AccessKey 名称或脱敏后的 AccessKey ID。

• 桌面编码。

• 会话 ID。

• 关键操作名称和调用结果。

• 错误码和错误信息。

不建议记录完整 AccessKey Secret、文件正文、敏感业务数据或完整截图地址。

并发控制

如果同一台云电脑同时被多个任务操作，可能出现鼠标、键盘和窗口状态互相影响的问题。建议按以下原则控制并发：

• 同一台云电脑同一时间只执行一个强交互 GUI 任务。

• 批量任务可分配到不同云电脑并行执行。

• 对需要共享文件目录的任务，应设计文件命名和锁机制。

• 对异常退出的任务，应释放会话并恢复桌面到可用状态。

配置检查清单

上线前建议检查：

• AccessKey 是否已关联正确云电脑。

• desktopCode 是否对应目标环境。

• 服务地址是否为预期环境。

• 日志是否已脱敏。

• 异常路径是否会关闭会话。

• 任务失败后是否保留必要排查信息。