类型 场景 个人用户 网页浏览 个人用户 影片观看 个人用户 赛事观看 个人用户 游戏画面 个人用户 教学视频 个人用户 科普内容 企业用户 企业安全培训 企业用户 医学教学影像 企业用户 房源销售展示 企业用户 汇报演示内容 企业用户 视频会议

参数 说明 基本信息 工单名称 输入您待提交工单的名称。 基本信息 工单类型 选择需要授权的工单类型，根据业务需求选择如下四种类型： 资产访问授权 字符命令授权 文件传输授权 数据库命令授权 资产 选择模式 取值范围： 全部资产 选择资产（组） 资产 资产 选择您需要访问的资产或者命令，可多选。 资产 资产组 选择您需要访问的资产组，可多选。 账号 资产账号 选择您需要授权的资产账号。 注意 若选择授权的资产账号为二次登录账号（例如root），需同时授权二次登录的源账号（例如添加root资产账号时配置的二次登录源账号testuser），否则将无法完成二次登录。 协议 服务 （仅工单类型选择“资产访问授权”时需要配置）默认全部服务，也支持选择单个服务。 敏感命令 工单类型：字符命令授权 敏感命令 提示符正则 输入待授权命令的提示符正则式。 敏感命令 命令正则式 输入待授权命令的正则式。 敏感命令 工单类型：文件传输授权 敏感命令 文件传输 选择需要授权的文件传输操作，包括上传、下载、删除等。 敏感命令 文件或目录 配置策略生效的文件或目录的正则表达式，可配置多个，多个以回车进行分隔。 敏感命令 工单类型：数据库命令授权 敏感命令 待执行命令 输入待执行的sql命令，多条命令按英文分号“;”隔开，不超过1000个字符。 敏感命令 sql库名 填写命令生效的SQL库名。 授权时间 生/失效日期 配置权限生效的起始和截止日期。 支持选择1天、3天、7天、15天、长期有效，或者自定义选择日期。 授权时间 生/失效时间 配置权限生效的具体时间点。 支持选择全天、闲时（0点~6点），或者自定义时间。 其他 描述 填写申请工单的相关描述。

操作步骤 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在左侧导航栏单击“备份管理”，选择需要恢复的备份，单击操作列的“恢复”。 您也可在“实例管理”页面，单击指定的实例名称，在左侧导航栏单击“备份恢复”，在“全量备份”页签下单击目标备份对应的操作列中的“恢复”。 步骤 5 选择需要的恢复方式，单击“确定”。 新实例：将备份恢复到新创建的实例上。 选择恢复到“新实例”，单击“确定”，跳转到“恢复到新实例”的服务选型页面： − 新实例的数据库引擎和数据库版本，自动与原实例相同。 − 存储空间大小默认和原实例相同，且必须大于或等于原实例存储空间大小。 − 其他参数默认，用户如需设置，请参见购买RDS for MySQL实例。 步骤 6 查看恢复结果。 恢复到新实例 为用户重新创建一个和该备份数据相同的实例。可看到实例由“创建中”变为“正常”，说明恢复成功。 恢复成功的新实例是一个独立的实例，与原有实例没有关联。如需使用只读实例，请重新在该实例上进行创建。 新实例创建成功后，系统会自动执行一次全量备份。 恢复到当前实例 在“实例管理”页面，可查看目标实例状态为“恢复中”，恢复完成后，实例状态由“恢复中”变为“正常”。如果目标实例下存在只读实例，只读实例的状态与目标实例一致。 恢复成功后，会执行一次全量备份。 恢复到已有实例 在“实例管理”页面，可查看目标实例状态为“恢复中”，恢复完成后，实例状态由“恢复中”变为“正常”。如果目标实例下存在只读实例，只读实例的状态与目标实例一致。 恢复成功后，会执行一次全量备份。 您可以通过“任务中心”查看详细进度和结果。 结束

配置稀疏备份策略 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在“实例管理”页面，选择指定的实例，单击实例名称。 步骤 5 在左侧导航栏，单击“备份恢复”。 步骤 6 在页面右上方，选择“修改备份策略 > 同区域备份策略”。您可以查看到已设置的备份策略，如需修改备份策略，请调整以下参数的值。 备份时间段：默认为24小时中，间隔一小时的随机的一个时间段 ，例如01:00～02:00，12:00～13:00等。备份时间段并不是指整个备份任务完成的时间，指的是备份的开始时间，备份时长和实例的数据量有关。 说明 建议根据业务情况，选择业务低峰时段。备份时间段是以本地浏览器所在的UTC时区保存，如果碰到夏令时/冬令时切换，备份时间段会因时区变化而改变。 稀疏备份策略： 基础策略为按周备份，至少选择一周中的1天，备份文件的保留天数可设置1~732天。 支持添加多个稀疏备份策略，新增的策略可以选择按周、按月、或按年备份。1个实例最多支持9个稀疏备份策略。 表 稀疏备份策略 备份周期 时间 保留天数 每周 至少选择一周中的一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 每月 至少选择一月中的一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 每年 选择一年中的具体某一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 如果多条备份策略涉及在同一天备份，那么在这一天系统仅会产生一个备份，该备份将与这些策略中保留时长最长的策略关联，保留时长由该条策略的保留时长决定。 配置稀疏备份策略后，如果某天的备份窗口内没有成功生成备份（由于和其他操作冲突导致的无法下发备份操作，或者备份执行失败），则该天的备份将被跳过，并不会额外保留备份。 删除稀疏备份策略时，由于备份策略可能关联了已产生的备份集，可以选择是否保留此策略关联的备份数据。如果选择不保留，所有关联此策略的备份数据会被立刻删除；如果选择保留，所有关联此策略的备份数据仍会按原保留时长保留。 步骤 7 单击“确定”，确认修改。 结束

此小节介绍云堡垒机安全设置。 云堡垒机安全设置模块支持您自定义密码强度、账户保护规则。 密码组成：配置用户密码策略，包括配置密码安全强度，密码字符组成。 密码事件：可设置安全登录事件、强制改密时间和首次登录改密。 账号策略：可设置账号空闲事件。 设置密码组成 1. 使用“管理角色”账号登录云堡垒机。 2. 在左侧导航栏选择“系统设置 > 安全管理”，进入“安全管理”模块。 3. 选择密码组成模块，配置密码规则。 设置密码事件 密码事件包含恶意登录事件、密码过期事件、强制改密，用户可根据使用需求对事件进行设置开启或关闭，单击“保存”后生效。 恶意登录事件：根据设置的时间和密码错误次数生效，触发后账号锁定，状态变更为“锁定F”，可联系管理员操作解锁。 密码过期事件：根据设置的有效时间生效，有效时间到期后，触发账号锁定，状态变更为“锁定P”，可联系管理员操作解锁。 强制改密：默认开启，开启强制改密后，用户首次登录堡垒机跳转强制改密界面，强制用户改密后登录。 设置账号事件 账号事件包含账号空闲事件、账号登录事件，您可根据使用需求对事件进行设置开启或关闭，单击“保存”后生效。 账号空闲事件：根据设置的空闲时间生效，距离上一次登录时间达到设置时间后，触发账号锁定，状态变更为“锁定L”，可联系管理员操作解锁。 账号登录事件：根据配置的唯N性值，限制同一账号同时登录数。

本章节指导如何审批工单。 1. 登录云堡垒机系统。 2. 在左侧导航栏单击“工单管理 > 工单审批”，进入工单审批页面。 3. 查找需要待审批的工单，单击“操作”列的“审批”按钮。 4. 在弹出的“工单审批”对话框中，查看待审批的工单内容，选择是否批准。 其他操作 批准：审批人批准后，流转到达下一节点；admin批准后，跳过其他节点（如有），直接最终变为“已批准”。 驳回：“待审批”和“审批中”的工单可以驳回；流程中的任一审批人驳回，则流程驳回到申请人，支持重新编辑和提交。 取消授权：任一审批人单击“取消授权”，则授权取消；admin可以对所有工单取消授权。

名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用

接口 说明 createdirectory 创建目录 readfile 读取文本文件内容，支持按偏移量和长度读取 writefile 写入文本文件内容，支持覆盖、追加和新建 movefile 移动或重命名文件、目录 searchfiles 搜索文件

本文介绍AIuse云电脑的产品特点 AIuse云电脑致力为AI构建任务执行平台，它依托天翼AI云电脑的强大算例，通过意图识别，模拟用户操作，自动完成任务的规划、决策与实施，助力AI的商业化落地。 多场景覆盖 搭建可定制云端桌面环境，依托标准化接口实现传统桌面软件自动化调用与批量操作，适配政企办公，研发测试等多场景使用。 灵活接入 提供标准化工具链与弹性运行环境、支持WebSdk、MCP等主流接入方式，无缝对接各种AI agent，兼容轻量调用与专业部署方式。 高效运行 依托天翼云强大算力底座，实现算力弹性伸缩与并发场景高效运行，保障桌面操作、软件运行及数据处理的流畅性与可靠性。 安全防护 采用企业级沙箱防护方案，构建多层次安全体系，用过严格权限隔离防范各类安全风险，保障企业核心业务数据安全合规。

52060 指定桌面不属于当前用户如何处理？ 请确认 AccessKey 是否关联了目标云电脑，并检查当前租户下是否拥有该云电脑资源。

浏览器场景说明 当前版本可通过 Computer Use 操作云电脑中的浏览器，例如点击页面、输入文本、滚动页面和截屏观察。 需要注意的是，当前文档不将其描述为独立的 Browser Use 能力。若后续提供浏览器专用 API、标签页管理、网络请求观测、DOM 级操作等能力，可再独立建设 Browser Use 文档。 调用方式 Computer Use 能力可通过以下方式接入： SDK：适合业务系统主动编排任务流程。 MCP：适合 MCP Client、Agent 宿主或 IDE 插件以工具方式调用。 操作坐标说明 鼠标相关接口通常使用桌面屏幕坐标。坐标原点一般位于屏幕左上角，X 轴向右递增，Y 轴向下递增。 在实际自动化流程中，建议先截图确认窗口位置和分辨率，再执行坐标点击或拖拽操作。对于分辨率、窗口布局可能变化的任务，应尽量通过截图识别、固定窗口布局或前置校验降低误操作风险。 使用建议 在执行点击前，建议先通过截图确认目标界面处于预期状态。 对页面加载、软件启动、弹窗出现等耗时操作，应加入等待和状态检查。 对重要操作，如提交、删除、付款等，应增加二次确认逻辑。 对需要批量执行的任务，应记录每一步操作结果，便于后续审计和问题排查。 能力边界 Computer Use 主要面向 GUI 自动化，不等同于业务系统 API。对于可通过接口直接完成的任务，优先使用业务接口通常更稳定、更可审计。对于界面变化频繁、坐标不稳定或存在复杂验证码的场景，需要结合业务策略评估可行性。

工具名 说明 createdirectory 创建目录 readfile 读取文本文件 writefile 写入文本文件 movefile 移动或重命名文件、目录 searchfiles 搜索文件

本文汇总 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 展示的工具调用结果为准。

能力 说明 读取文件 支持按路径读取文件内容，可按偏移量和长度读取片段 写入文件 支持覆盖写入、追加写入和新建写入模式 创建目录 支持创建目录，并可自动补齐父目录 移动文件 支持文件或目录移动，也可用于重命名 搜索文件 支持按通配符、正则或精确文件名搜索 获取文件信息 支持获取文件大小、类型、路径等元数据 下载文件 大文件或二进制文件可通过临时地址传输，具体能力以发布版本为准

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

项目 要求 Node.js 建议 Node.js 18 或以上 LTS 版本 npx 本地可执行 npx v MCP Client 支持本地 STDIO MCP Server AccessKey 已获取 AccessKey ID 和 AccessKey Secret 云电脑 已获取目标云电脑的 desktopCode ，且云电脑在线

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

资源对象 说明 AccessKey 调用 SDK 或 MCP 时使用的身份凭证 云电脑 执行桌面任务的云端桌面资源 桌面编码 SDK 或 MCP 连接指定云电脑时使用的资源标识，对应 desktopCode 关联关系 AccessKey 与可操作云电脑之间的绑定关系

本文介绍在 AIuse 云电脑中执行桌面自动化任务时,如何管理应用启动、运行、结果确认和任务收尾。 本文侧重于基于 Computer Use 和 FileSystem 能力的实践建议。 生命周期阶段 桌面应用自动化通常包含以下阶段： 阶段 说明 准备 确认云电脑在线、应用已安装、工作目录可用 启动 通过桌面快捷方式、开始菜单或命令入口启动应用 初始化 等待应用窗口出现，并处理登录、弹窗或加载状态 执行 通过鼠标键盘完成业务操作 结果确认 通过截图、文件读取或界面状态确认任务结果 收尾 保存文件、关闭窗口、释放会话 推荐流程： plaintext 准备资源 > 创建 Session > 截图观察 > 启动应用 > 等待就绪 > 执行业务操作 > 确认结果 > 文件归档 > 关闭 Session 启动应用 可通过以下方式启动应用： 点击桌面快捷方式。 通过开始菜单搜索并启动。 操作资源管理器打开指定文件或程序。 使用业务系统预先配置的启动入口。 由于不同应用启动耗时不同，建议启动后加入截图确认。SDK 当前没有独立 wait 方法时，可以在业务代码中使用 setTimeout、任务轮询或截图状态判断实现等待。 等待应用就绪 建议使用以下方式判断应用是否就绪： 截图中出现目标窗口标题或关键界面元素。 鼠标点击输入框后可正常输入。 目标输出目录已生成预期文件。 界面不再处于加载状态。

本文介绍 AIuse 云电脑在接入、凭证管理、资源隔离和文件传输方面的安全建议。 凭证安全 AIuse 云电脑通过 AccessKey 进行调用鉴权。AccessKey ID 和 AccessKey Secret 应作为敏感信息管理。 建议： 不要将 AccessKey Secret 提交到代码仓库。 不要在前端页面或客户端安装包中内置 Secret。 不要在日志、截图或错误信息中输出完整 Secret。 不同项目、环境和任务批次使用不同 AccessKey。 AccessKey 疑似泄露时立即禁用并更换。 权限最小化 AccessKey 应只关联必要的云电脑。对于临时任务、测试任务和生产任务，建议使用不同 AccessKey，并分别控制其可访问资源。 桌面环境隔离 AIuse 云电脑任务运行在云端桌面环境中。为降低任务之间的相互影响，建议： 高风险任务使用独立云电脑。 不同业务线使用不同云电脑。 批量任务按资源池分配桌面。 任务完成后清理临时文件和中间结果。 文件安全 FileSystem 能力可读取和写入云电脑中的文件。业务系统应对可访问路径进行限制，避免误操作系统目录或敏感目录。 建议： 为任务分配独立工作目录。 对输入和输出文件进行命名规范管理。 对临时下载地址设置有效期。 对重要文件写入前进行路径校验。 对任务输出中的敏感数据进行脱敏或加密处理。 截图安全 截图可能包含业务数据、个人信息或系统敏感信息。建议： 仅在必要时保存截图。 对截图设置访问权限和保存期限。 对外共享截图前进行脱敏。 不在公开文档、工单或即时通讯中传播包含敏感信息的截图。

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

开源组件名称 许可协议 代码是否修改 网址 axios MIT License 否 fastapi MIT License 否 aiohttp Apache License 2.0 否 xdotool BSD 3Clause License 否 scrot MIT License 否

错误处理建议 调用方应区分以下两类问题： MCP Server 启动或协议层问题：通常表现为 Qoder 中工具列表加载失败、MCP Server 状态异常或工具不可见。 业务执行问题：工具已被调用，但因桌面不在线、AccessKey 无权限、参数缺失或文件路径无效导致失败。 排查时建议优先确认： CTGAPIKEY 和 CTGAPISECRET 是否正确。 AccessKey 是否已关联目标云电脑。 目标云电脑是否在线。 工具参数中是否包含 desktopCode。 文件路径是否存在，或是否具备读写权限。

52060 指定桌面不属于当前用户如何处理？ 请确认 AccessKey 是否关联了目标云电脑，并检查当前租户下是否拥有该云电脑资源。

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

项目 要求 Node.js 建议 Node.js 18 或以上 LTS 版本 npx 本地可执行 npx v MCP Client 支持本地 STDIO MCP Server AccessKey 已获取 AccessKey ID 和 AccessKey Secret 云电脑 已获取目标云电脑的 desktopCode ，且云电脑在线

参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 startX 是 滚动位置 X 坐标 startY 是 滚动位置 Y 坐标 direction 是 滚动方向，支持 up 、 down 、 left 、 right amount 是 滚动次数或滚动量，具体效果取决于目标系统

本文以 Qoder 为例,演示如何配置 AIuse 云电脑 MCP Server,并调用工具完成基础桌面操作和文件操作。 本文以 Qoder 为例，演示如何配置 AIuse 云电脑 MCP Server，并调用工具完成基础桌面操作和文件操作。 场景目标 本教程完成以下动作： 1. 在 Qoder 中配置 MCP Server。 2. 确认可用工具列表。 3. 截取云电脑屏幕。 4. 创建一个测试目录。 5. 写入并读取一个文本文件。 6. 执行一次鼠标移动或文本输入。 准备信息 请准备以下信息： 参数 示例 AccessKey ID youraccesskeyid AccessKey Secret youraccesskeysecret desktopCode xxx 服务地址 配置 MCP Server 在 Qoder 的 MCP 设置页面中添加自定义 MCP Server，并粘贴以下配置： plaintext { "mcpServers": { "aiusedesktop": { "command": "npx", "args": ["y", "@ctyun/desktopagentmcp"], "env": { "CTGAPIKEY": "youraccesskeyid", "CTGAPISECRET": "youraccesskeysecret", "CTGSERVICEURL": " } } } } 保存后刷新或重启 Qoder。 确认工具加载 初始化完成后，Qoder 应能展示 MCP 工具列表。当前版本工具包括： movemouse clickmouse dragmouse scroll presskey typetext screenshot getcursorposition createdirectory readfile writefile movefile searchfiles 如果工具列表为空或 MCP Server 状态异常，请先检查 Node.js、npx、包名和 AccessKey 配置。

接口 说明 createdirectory 创建目录 readfile 读取文本文件内容，支持按偏移量和长度读取 writefile 写入文本文件内容，支持覆盖、追加和新建 movefile 移动或重命名文件、目录 searchfiles 搜索文件

名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用

环境变量 说明 AIUSEAPIKEY AccessKey ID AIUSEAPISECRET AccessKey Secret AIUSEDESKTOPCODE 桌面编码 AIUSESERVICEURL 服务地址

文本输入 plaintext await session.computer.typetext({ text: 'Hello from AIuse' }); 截图 plaintext const result await session.computer.screenshot(); 截图可用于： 确认应用是否启动成功。 判断页面是否加载完成。 记录任务执行过程。 作为自动化任务下一步决策的观察输入。 获取鼠标位置 plaintext const position await session.computer.getcursorposition(); 稳定性建议 不建议在没有截图确认的情况下连续执行大量固定坐标点击。 对窗口位置敏感的任务，建议先最大化窗口或恢复固定布局。 对加载时间不稳定的页面，建议加入等待和状态检查。 对关键操作进行截图留痕，便于排查。 任务结束后应关闭会话，避免资源长期占用。