本节主要介绍GetRequests。 此操作用来查询用户的请求次数。 请求参数 名称 描述 是否必须 Action GetRequests。 是 BeginDate 指定查询请求次数的起始时间，统计数据的起始时间（时区为：UTC+8）为开始日期的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate EndDate 指定查询请求的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询请求次数的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求次数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询请求次数的数据位置。如果不指定数据位置，则查询账户名下所有数据位置的请求次数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 InternetType 指定返回的请求次数网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网请求次数和非互联网请求次数。 internet：指定返回互联网的请求次数。 noninternet：指定返回非互联网的请求次数。 默认值为all。 否 RequestsType 指定返回的请求类型。 类型：字符串 取值： all：指定返回所有类型的请求次数。 get：指定返回get类型的请求次数。 head：指定返回head类型的请求次数。 put：指定返回put类型的请求次数。 post：指定返回post类型的请求次数。 delete：指定返回delete类型的请求次数。 others：指定返回除上述外的其他类型的请求次数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为ZhengZhou、20191015至20191016标准存储数据的流量。 plaintext GET /?ActionGetTraffics&BeginDate20191015&EndDate20191016& StorageClassSTANDARD&Bucketexamplebucket&FreqbyDay&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 06:41:57 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 06:41:57 GMT xamzrequestid: c1bd7162b01e4a45 ContentLength: 1316 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun.cn usertest1 STANDARD UTC +0800 all all all byDay examplebucket ZhengZhou 20191015 86400 259200 432000 604800 172800 345600 518400 691200 ...

本节主要介绍GetRestoreCapacity。 此操作用来查询数据取回量。用户可以根据需求，查询指定存储桶、指定存储类型的数据取回量。 请求参数 名称 描述 是否必须 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询数据取回量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARADIA：低频访问类型。 默认值为ALL。 否 Bucket 指定查询数据取回量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的数据取回量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询数据取回量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的数据取回量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

请求示例 plaintext HEAD /ObjectName HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 15 Nov 2021 06:39:41 GMT ContentType: application/octetstream Connection: KeepAlive Authorization: SignatureValue 响应示例 plaintext HTTP/1.1 200 OK ContentLength: 1467326 ETag: "5db44ee68a1e577907c2699c8f582107" LastModified: Mon, 15 Nov 2021 06:39:39 GMT ContentType: application/xjavaarchive ContentMD5: XbRO5ooeV3kHwmmcj1ghBw xctyunmetadatalocation: ChengDu xctyundatalocation: ZhengZhou Date: Mon, 15 Nov 2021 06:39:41 GMT xamzrequestid: 4ae1a5d637614e3d137f838a928a8c9251535747494b4d4f51 Server: CTYUN

参数 是否必填 说明 path 是 文件路径 offset 否 起始字节偏移，默认 0 length 否 最多读取字节数，默认 0 表示读取剩余内容

参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 path 是 写入目标路径 content 是 写入文本内容 mode 否 overwrite 覆盖写入、 append 追加写入、 createnew 仅新建写入

工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置

本节介绍FileSystem功能操作能力。 FileSystem 是 AIuse 云电脑面向 Agent 和自动化系统提供的文件操作能力，用于在云电脑环境中读取、写入、搜索、移动和管理文件。 能力概述 FileSystem 当前规划和技术方案覆盖以下能力： 能力 说明 读取文件 支持按路径读取文件内容，可按偏移量和长度读取片段 写入文件 支持覆盖写入、追加写入和新建写入模式 创建目录 支持创建目录，并可自动补齐父目录 移动文件 支持文件或目录移动，也可用于重命名 搜索文件 支持按通配符、正则或精确文件名搜索 获取文件信息 支持获取文件大小、类型、路径等元数据 下载文件 大文件或二进制文件可通过临时地址传输，具体能力以发布版本为准 设计目标 FileSystem 能力的目标是为 Agent 提供统一、可控的文件系统语义。 典型场景 读取应用生成的日志、报表或结果文件。 将 Agent 生成的内容写入云电脑工作目录。 查找指定目录下的文件。 将文件移动到指定目录，完成任务归档。 配合 Computer Use 完成“操作软件生成文件，再读取文件内容”的闭环任务。 示例流程 1. 通过 Computer Use 操作桌面软件生成文件。 2. 使用 FileSystem 搜索输出目录。 3. 读取目标文件内容。 4. 将结果返回业务系统或 Agent。

创建测试目录 在 Qoder 中输入： plaintext 在 desktopCodexxx 桌面，创建一下 C:/aiusertest 文件夹。 结构化工具调用等价于： plaintext { "name": "createdirectory", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest" } } 写入文件 plaintext { "name": "writefile", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest/hello.txt", "mode": "overwrite", "content": "Hello from AIuse MCP" } } 读取文件 plaintext { "name": "readfile", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest/hello.txt", "offset": 0, "length": 0 } } length 为 0 时表示读取从 offset 开始的剩余内容。 执行 GUI 操作 移动鼠标： plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 输入文本： plaintext { "name": "typetext", "arguments": { "desktopCode": "xxx", "text": "Hello from AIuse MCP" } } 排查建议 如果没有看到工具列表，请检查： npx 是否可用。 MCP Server 包名是否正确。 CTGAPIKEY 和 CTGAPISECRET 是否填写正确。 AccessKey 是否已关联目标云电脑。 云电脑是否在线。 如果工具调用失败，请检查： 指令或工具参数中是否包含 desktopCode。 文件路径是否存在或可写。 鼠标键盘操作前是否已通过截图确认界面状态。

字段 是否必填 说明 command 是 启动命令，当前示例使用 npx args 是 启动参数，包含 MCP Server 包名 CTGAPIKEY 是 AccessKey ID CTGAPISECRET 是 AccessKey Secret CTGSERVICEURL 否 服务地址，未配置时使用默认服务地址

本文介绍通过 MCP 调用 AIuse 云电脑 Computer Use 工具的方法。 本文介绍通过 MCP 调用 AIuse 云电脑 Computer Use 工具的方法。以下示例以 desktopCodexxx 为例，实际调用时请替换为目标云电脑的桌面编码。 工具列表 工具名 说明 movemouse 移动鼠标 clickmouse 点击鼠标 dragmouse 拖拽鼠标 scroll 滚动 presskey 按下键盘按键 typetext 输入文本 screenshot 截图 getcursorposition 获取鼠标位置 movemouse 移动鼠标到指定坐标。 plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 参数说明： 参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 x 是 目标 X 坐标 y 是 目标 Y 坐标 clickmouse 在指定坐标点击鼠标。 plaintext { "name": "clickmouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300, "clickMode": "left" } } 参数说明： 参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 x 是 X 坐标 y 是 Y 坐标 clickMode 否 left、right、middle、doubleleft，默认 left pressMode 否 是否仅按下鼠标 releaseMode 否 是否仅释放鼠标

维度 建议 项目隔离 不同业务项目使用不同 AccessKey 环境隔离 开发、测试、生产环境使用不同 AccessKey 权限最小化 AccessKey 只关联必要的云电脑 生命周期管理 临时任务结束后及时禁用或删除 AccessKey 审计追踪 AccessKey 名称建议包含项目、环境和用途

错误码 说明 建议处理方式 52060 指定桌面不属于当前用户 检查 AccessKey 与云电脑关联关系 92006 桌面不在线 确认云电脑状态，必要时启动或更换云电脑 92100 通过 sessionId 找不到 session 检查会话是否已关闭或过期 92101 消息发送失败 检查网络、桌面状态和服务可用性 92102 请求内容长度超过限制 减少单次请求内容，文件内容建议分片读取或分批写入 92103 找不到请求记录 检查请求状态和会话状态 92104 功能未开放，请联系管理员 确认租户是否已开通对应能力 92105 功能未开放，请联系管理员 确认租户是否已开通对应能力

处理失败任务 失败任务建议记录： 当前步骤。 最近一次截图。 关键输入参数。 错误码和错误信息。 文件输出情况。 对于可重试任务，应在重试前确认当前桌面状态，避免重复提交或重复写入。 上线检查 上线前建议确认： AccessKey 权限范围最小化。 云电脑资源数量满足并发需求。 会话关闭逻辑可靠。 关键操作有截图或状态校验。 错误码已映射到业务告警或人工处理流程。 任务日志已脱敏。

执行业务操作 执行业务操作时，建议将任务拆分为多个小步骤，每个步骤都具备明确的输入、动作和结果判断。 示例： 1. 打开目标页面。 2. 输入查询条件。 3. 点击查询按钮。 4. 等待结果区域刷新。 5. 导出结果文件。 6. 使用 FileSystem 读取导出文件。 结果确认 结果确认可以结合以下方式： 使用 screenshot 留存界面状态。 使用 readfile 读取导出的文本文件。 使用 searchfiles 检查输出目录是否生成目标文件。 使用业务系统自身的状态接口或任务记录进行交叉验证。 异常处理 桌面应用可能出现弹窗、卡顿、登录过期、网络异常等情况。建议为以下异常设计处理策略： 应用启动失败。 窗口未出现在预期位置。 输入后无响应。 点击后出现错误弹窗。 导出文件未生成。 文件读取失败。 对无法自动恢复的异常，应保留截图、会话 ID 和任务日志，便于人工排查。 收尾建议 关闭当前任务打开的窗口。 将输出文件移动到约定目录。 清理任务执行过程中产生的临时内容。 关闭 SDK 会话。 记录任务结果和关键日志。

审计建议 建议记录以下审计信息： 调用时间。 调用方系统或任务 ID。 脱敏后的 AccessKey ID。 桌面编码。 会话 ID。 调用工具名称。 结果状态和错误码。 审计日志中不应包含完整 Secret、敏感文件正文或未脱敏截图。 合规说明 如需对外提供合规材料，建议由产品、安全和法务共同确认以下内容： 数据存储位置。 日志保存周期。 临时文件清理周期。 权限模型和审计能力。 适用的企业安全认证或合规声明。

movefile 移动或重命名文件、目录。 plaintext { "name": "movefile", "arguments": { "desktopCode": "xxx", "source": "C:/aiusertest/result.txt", "destination": "C:/aiusertest/archive/result.txt" } } searchfiles 在指定目录下搜索文件。 plaintext { "name": "searchfiles", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest", "pattern": ".txt", "matchMode": "wildcard" } } matchMode 支持： matchMode 说明 wildcard 通配符匹配，例如 .txt regex 正则表达式匹配 exact 精确文件名匹配 使用建议 建议为每个任务分配独立工作目录，例如 C:/aiuse/tasks/{taskId}。 写入文件前应明确 mode，避免误覆盖。 文件读取当前面向文本文件，二进制文件不建议通过 readfile 读取。 文件系统工具具备读写目标云电脑文件的能力，应仅对可信任务开放。 searchfiles 当前返回文件匹配结果，不作为完整目录列表接口使用。

本节介绍Aluse云电脑支持的第三方开源软件清单。 开源组件名称 许可协议 代码是否修改 网址 axios MIT License 否 fastapi MIT License 否 aiohttp Apache License 2.0 否 xdotool BSD 3Clause License 否 scrot MIT License 否

本文汇总 AIuse 云电脑 MCP Server 当前版本开放的工具、参数风格和返回结构。 协议能力 当前 MCP Server 基于 MCP STDIO 通信，主要面向以下 MCP 能力： initialize notifications/initialized ping tools/list tools/call 通用参数 所有 AIuse 云电脑 MCP 工具都需要明确目标桌面编码。当前版本通过工具参数传入 desktopCode： plaintext { "desktopCode": "xxx" } 在 Qoder 等支持自然语言工具调用的客户端中，也可以在指令中说明： plaintext 在 desktopCodexxx 桌面，截取当前屏幕。 Computer Use 工具 工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置 FileSystem 工具 工具名 用途 createdirectory 创建目录 readfile 读取文本文件内容 writefile 写入文本文件内容 movefile 移动或重命名文件、目录 searchfiles 搜索文件 返回结构 当前 MCP Server 将工具调用结果以文本内容返回，结构如下： plaintext { "content": [ { "type": "text", "text": "The operation(movemouse) was successfully executed on the desktop code xxx,the result is ..." } ] } 如果业务调用失败，返回文本中会包含失败信息： plaintext { "content": [ { "type": "text", "text": "The operation(clickmouse) failed on the desktop code xxx,the error message is desktop is offline" } ] } 当前版本未承诺返回 structuredContent 或 isError 字段。调用方应以 MCP Client 展示的工具调用结果为准。

MCP Client 中看不到工具列表怎么办？ 请检查： 本地是否能执行 npx v。 MCP Server 包名是否正确。 MCP 配置是否保存并刷新。 环境变量是否传入 APIKEY、APISECRET 和 DESKTOPCODE。 MCP Client 是否支持本地 stdio MCP Server。 MCP 配置中的 Secret 是否安全？ Secret 属于敏感信息。建议使用 MCP Client 支持的环境变量、密钥引用或本地安全配置方式，避免将 Secret 提交到代码仓库或公开配置中。 Computer Use 鼠标点击位置不准确怎么办？ 请先截图确认当前分辨率、窗口位置和界面状态。对于窗口位置不固定的应用，建议在任务开始时最大化窗口或执行固定布局操作。 输入文本后没有反应怎么办？ 请检查输入焦点是否位于目标输入框。建议先点击目标输入框，再输入文本，并在输入后截图确认。 页面加载慢时如何处理？ 建议在点击或打开页面后加入等待，并通过截图或文件状态判断加载是否完成。不要只依赖固定等待时间。 写入文件时如何避免误覆盖？ 写入前请明确 mode。如不希望覆盖已有文件，可使用 createnew 模式。具体模式支持范围以正式接口为准。 文件搜索结果不完整怎么办？ 搜索结果可能因响应长度限制被截断。请缩小搜索目录、使用更精确的 pattern。 错误码 92006 桌面不在线如何处理？ 请在控制台确认云电脑状态。如云电脑未启动或不可用，请先恢复桌面状态后再重试。

项目 说明 租户权限 已开通 AIuse 云电脑服务 AccessKey 已创建 AccessKey ID 和 AccessKey Secret 云电脑资源 已准备可用云电脑，并获取桌面编码 desktopCode 运行环境 Node.js 18 或以上版本，建议使用维护期内 LTS 版本 网络访问 运行 SDK 的环境可访问 AIuse 云电脑服务地址

presskey 按下键盘按键或组合键。 plaintext await session.computer.presskey({ key: 'Enter' }); await session.computer.presskey({ key: 'ctrl c' }); typetext 输入文本。 plaintext await session.computer.typetext({ text: 'Hello World' }); screenshot 截取当前桌面屏幕。 plaintext const result await session.computer.screenshot(); getcursorposition 获取当前鼠标位置。 plaintext const result await session.computer.getcursorposition(); 成功时，data 中通常包含： plaintext { "PositionX": 500, "PositionY": 300 } FileSystemAPI createdirectory 创建目录。 plaintext await session.filesystem.createdirectory({ path: 'C:/aiusertest' }); readfile 读取文本文件。 plaintext const result await session.filesystem.readfile({ path: 'C:/aiusertest/demo.txt', offset: 0, length: 1024 }); writefile 写入文本文件。 plaintext await session.filesystem.writefile({ path: 'C:/aiusertest/result.txt', mode: 'overwrite', content: 'result content' }); movefile 移动或重命名文件、目录。 plaintext await session.filesystem.movefile({ source: 'C:/aiusertest/result.txt', destination: 'C:/aiusertest/archive/result.txt' }); searchfiles 搜索文件。 plaintext const result await session.filesystem.searchfiles({ path: 'C:/aiusertest', pattern: '.txt', matchMode: 'wildcard' }); close 关闭当前会话。 plaintext await session.close(); 建议在 finally 中调用，确保异常场景也能释放会话。 常见错误码 错误码 说明 52060 指定桌面不属于当前用户 92006 桌面不在线 92100 通过 sessionId 找不到 session 92101 消息发送失败 92102 请求内容长度超过限制 92103 找不到消息记录 92104 功能未开放，请联系管理员 92105 功能未开放，请联系管理员

本文介绍 AIuse 云电脑 MCP Server 的接入方式、环境要求和配置说明。 本文介绍 AIuse 云电脑 MCP Server 的接入方式、环境要求和配置说明。MCP 接入适用于支持 MCP 协议的客户端、AI 开发工具或 IDE 插件。当前版本建议采用本地 STDIO MCP Server 方式接入。 接入模型 MCP Client 通过本地 STDIO 启动 AIuse 云电脑 MCP Server。MCP Server 读取 AccessKey 配置后，通过 AIuse 云电脑服务创建会话、发送工具调用请求，并将结果返回给 MCP Client。 简化流程如下： plaintext Qoder / MCP Client > 本地 STDIO MCP Server > AIuse 云电脑服务 > 目标云电脑执行 Computer Use / FileSystem 操作 > 返回结果 环境要求 项目 要求 Node.js 建议 Node.js 18 或以上 LTS 版本 npx 本地可执行 npx v MCP Client 支持本地 STDIO MCP Server AccessKey 已获取 AccessKey ID 和 AccessKey Secret 云电脑 已获取目标云电脑的 desktopCode，且云电脑在线 Node.js 安装方式如下： 1. 打开 Node.js 官网下载页面 2. 选择维护期内的 LTS 版本安装包 3. 按安装向导完成安装 4. 安装完成后重新打开终端 5. 依次执行 node v 和 npx v，确认命令可正常使用 如果本地已安装 Node.js，但仍无法执行 npx，请检查： 1. Node.js 是否安装完整 2. 当前终端是否已重新打开 3. Node.js 安装目录是否已加入系统 PATH

getcursorposition 获取当前鼠标位置。 plaintext { "name": "getcursorposition", "arguments": { "desktopCode": "xxx" } } 使用建议 坐标操作依赖当前屏幕分辨率和窗口位置，建议先使用 screenshot 观察界面。 对关键操作建议截图确认后再继续下一步。 不建议在未确认界面状态的情况下连续执行大量固定坐标点击。 调用时必须明确目标 desktopCode。

参数 示例 AccessKey ID youraccesskeyid AccessKey Secret youraccesskeysecret desktopCode xxx 服务地址

参数名 类型 是否必填 说明 apiKey string 是 控制台创建的 AccessKey ID apiSecret string 是 控制台创建的 AccessKey Secret desktopCode string 是 云电脑桌面编码 serviceURL string 否 服务地址，默认值以 SDK 发布版本为准

处理失败任务 失败任务建议记录： 当前步骤。 最近一次截图。 关键输入参数。 错误码和错误信息。 文件输出情况。 对于可重试任务，应在重试前确认当前桌面状态，避免重复提交或重复写入。 上线检查 上线前建议确认： AccessKey 权限范围最小化。 云电脑资源数量满足并发需求。 会话关闭逻辑可靠。 关键操作有截图或状态校验。 错误码已映射到业务告警或人工处理流程。 任务日志已脱敏。

参数 是否必填 说明 path 是 文件路径 offset 否 起始字节偏移，默认 0 length 否 最多读取字节数，默认 0 表示读取剩余内容

类型 示例 处理建议 鉴权异常 AccessKey 错误、Secret 错误 检查密钥配置和权限 资源异常 云电脑不在线、桌面不属于当前用户 检查资源状态和绑定关系 会话异常 session 不存在、会话过期 重新创建会话 参数异常 坐标缺失、路径为空、消息过长 校验请求参数 执行异常 点击无响应、截图失败、文件读取失败 结合截图和日志排查

阶段 说明 准备 确认云电脑在线、应用已安装、工作目录可用 启动 通过桌面快捷方式、开始菜单或命令入口启动应用 初始化 等待应用窗口出现，并处理登录、弹窗或加载状态 执行 通过鼠标键盘完成业务操作 结果确认 通过截图、文件读取或界面状态确认任务结果 收尾 保存文件、关闭窗口、释放会话

本节介绍AccessKey的管理操作说明。 AccessKey 是调用 AIuse 云电脑 SDK 和 MCP 能力的身份凭证。调用方需要使用 AccessKey ID、AccessKey Secret 和桌面编码建立连接，并在授权范围内操作云电脑。 创建 AccessKey 操作步骤如下： 1. 登录 AIuse 云电脑控制台。 2. 进入“协同套件 AIuse 云电脑”功能专区。 3. 在服务管理页面单击“创建 AccessKey”。 4. 输入 AccessKey 名称等信息。 5. 确认创建。 创建完成后，请妥善保存 AccessKey ID 和 AccessKey Secret。AccessKey Secret 属于敏感凭证，不应通过截图、聊天工具、工单附件或公开仓库传播。 命名建议 建议 AccessKey 名称包含业务含义，便于后续管理和排查。 名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用 关联云电脑 AccessKey 创建后，需要关联指定云电脑才可使用。 操作步骤如下： 1. 在服务管理页面找到目标 AccessKey。 2. 单击“关联云电脑”。 3. 在弹窗中搜索并选择需要绑定的云电脑。 4. 单击确认，完成绑定。 AccessKey 只能操作已关联的云电脑。若调用时返回“指定桌面不属于当前用户”或类似错误，请优先检查 AccessKey 与云电脑的关联关系。 查看与复制密钥 在 AccessKey 列表中，可以查看 AccessKey ID、AccessKey Secret 和关联云电脑数量。复制密钥时，请确认当前环境安全，避免在录屏、投屏或共享屏幕场景下展示 Secret。

并发控制 如果同一台云电脑同时被多个任务操作，可能出现鼠标、键盘和窗口状态互相影响的问题。建议按以下原则控制并发： 同一台云电脑同一时间只执行一个强交互 GUI 任务。 批量任务可分配到不同云电脑并行执行。 对需要共享文件目录的任务，应设计文件命名和锁机制。 对异常退出的任务，应释放会话并恢复桌面到可用状态。 配置检查清单 上线前建议检查： AccessKey 是否已关联正确云电脑。 desktopCode 是否对应目标环境。 服务地址是否为预期环境。 日志是否已脱敏。 异常路径是否会关闭会话。 任务失败后是否保留必要排查信息。