本节介绍应用市场的开通与试用流程。 管理员可以在AI云电脑（政企版）控制台的协同套件功能中选择“试用”或“开通”不同版本的应用市场服务。 1.登录AI云电脑（政企版）控制台，选择菜单“协同套件”，打开应用市场可选择开启试用，每个租户只有一次免费试用机会，试用期90天，试用版具备与旗舰版一致的完整功能，且不限制管控桌面数，可用存储为100GB。 2.在开通功能页面，可选择所需的应用市场版本、桌面数、可用存储空间等。 3.应用市场提供基础版与旗舰版，功能与价格有所差异，开通时请按需选择。 版本 功能 价格 基础版 提供企业自建应用库 免费 旗舰版 基础版功能上，提供应用分发、黑白名单管控、日志记录等 10元/台/月 4.自建应用存储空间按25GB步长增减；自建应用存储空间适用AI云电脑数据盘资源包资费：40元/100GB/月。 5.使用资源包抵扣支付开通按计算包1C2G41元/月，存储包100GB＝40元/月的价格换算抵扣，每1C2G或100GB约开通4个管控桌面，当余数不足4个桌面时按4个桌面进行资源包扣除。支持计算包和存储包组合抵扣，实际抵扣额请以开通页面为准。 举例：开通旗舰版和7个开通桌面数，需2C4G计算包进行抵扣。 6.开通后，可根据使用需求进行版本升级、扩容、续订、退订等操作，并可在应用市场菜单中使用和配置相关功能。

获取应用 在“日志记录桌面应用”页面，管理员可查看所有桌面已安装的应用，支持按应用或桌面两种维度查看。也可在这里选择应用通知用户卸载或强制卸载。并可以通过“获取桌面应用”查看桌面实时的应用信息。 注： 1、桌面应用上报功能默认未开启，需前往“应用管控设置”页面开启后方可查看，所有桌面将每天定时上报应用信息。 2、应用上报的三种方式： (1) 开启应用上报后，桌面（处于离线运行或在线运行状态）接收到信令后，在5分钟内上报应用，以后每隔24小时的同一时间进行增量上报； (2) 页面上点击“获取桌面数据”按钮，桌面将会立即增量上报应用信息； (3) 桌面重启后，会增量上报应用信息。 卸载应用 在应用视图，点击应用右侧的蓝色图标，可以查看具体的已装桌面。在此页面中，可以选择具体的桌面，在桌面中卸载该应用。 卸载方式分为，触发卸载和通知卸载。 “触发卸载”，会直接触发所选桌面内应用的卸载程序，并弹窗告知用户。 “通知卸载”，仅弹窗告知用户并引导卸载应用。 在桌面视图，点击应用右侧的蓝色图标，可以查看桌面具体安装的应用。在此页面中，可以选择具体的应用，在桌面卸载该应用。

问题描述 当主机使用Windows2012浏览器时，部分场景下需要将Windows2012自带的.net framework 4.5版本卸载，卸载之后可能会遇到黑屏、无法进入系统桌面的问题。 可能原因 如遇这种情况，可能是因为系统由完整模式Full变为了核心模式Core。 处理方法 1. 登录弹性云主机，点击Win键，在开始菜单中选择任务管理器。 2. 选择“文件 > 运行新任务”。打开“新建任务”窗口。 3. 输入“cmd”，然后按回车键。 4. 在弹出的命令行窗口执行以下命令，将系统由核心模式切换到完整模式。 Dism /online /enablefeature /all /featurename:ServerGuiMgmt /featurename:ServerGuiShell /featurename:ServerCoreFullServer 5. 根据提示重启云主机，再次登录系统后就可以正常显示桌面。

安全中心重置系统密码 忘记Windows系统密码时，安全中心点击"系统密码"进行重置系统密码。（适用于Windows桌面的Administrators账户） 悬浮球 控制中心点击“悬浮球”，快速开启悬浮球，开启后悬浮球将展示在桌面内。 音频设置 提示：仅Ubuntu客户端、安卓瘦终端支持音频设置。 控制中心点击“音频设置”，调出音频设置功能。 音频设置页面（Ubuntu客户端）。 AI云电脑配置 控制中心点击“AI云电脑配置”，查看AI云电脑的配置信息。 最小化 工具栏最小化功能仅支持Windows系统客户端、Mac客户端、国产化客户端。Ubuntu瘦终端，安卓瘦终端或安卓一体机显示为全屏模式，不支持最小化功能。

本节介绍Computer Use 在AIuse 云电脑面向 Agent 和自动化系统提供的图形用户界面操作能力。 Computer Use 是 AIuse 云电脑面向 Agent 和自动化系统提供的图形用户界面操作能力。调用方可以通过 SDK 或 MCP 对云电脑执行鼠标、键盘、截图等操作，使 Agent 能够像用户一样观察和操作桌面环境。 能力概述 Computer Use 当前重点覆盖以下能力： 能力 说明 鼠标控制 支持移动、点击、双击、右键、按下、释放、拖拽和滚动 键盘控制 支持按键、组合键和文本输入 屏幕观察 支持截取当前桌面屏幕，用于 Agent 观察界面状态 坐标获取 支持获取当前鼠标位置 等待控制 支持在自动化流程中等待页面或应用响应 工作方式 Computer Use 的典型工作流程如下： 1. 调用方创建连接或会话。 2. 调用截图能力获取当前桌面画面。 3. Agent 或业务逻辑根据界面状态生成下一步操作。 4. 调用鼠标或键盘工具执行操作。 5. 重复观察、决策和执行，直到任务结束。 6. 关闭会话并释放资源。 适用场景 Computer Use 适用于以下场景： 需要操作传统桌面软件，但软件本身不提供开放 API。 需要让 Agent 通过图形界面完成表单填写、信息录入、批量查询等任务。 需要在云端隔离环境中执行桌面自动化。 需要对浏览器、办公软件、业务系统客户端等 GUI 程序进行自动化操作。 需要结合截图能力进行视觉观察和步骤决策。

本节介绍Computer Use 在AIuse 云电脑面向 Agent 和自动化系统提供的图形用户界面操作能力。 Computer Use 是 AIuse 云电脑面向 Agent 和自动化系统提供的图形用户界面操作能力。调用方可以通过 SDK 或 MCP 对云电脑执行鼠标、键盘、截图等操作，使 Agent 能够像用户一样观察和操作桌面环境。 能力概述 Computer Use 当前重点覆盖以下能力： 能力 说明 鼠标控制 支持移动、点击、双击、右键、按下、释放、拖拽和滚动 键盘控制 支持按键、组合键和文本输入 屏幕观察 支持截取当前桌面屏幕，用于 Agent 观察界面状态 坐标获取 支持获取当前鼠标位置 等待控制 支持在自动化流程中等待页面或应用响应 工作方式 Computer Use 的典型工作流程如下： 1. 调用方创建连接或会话。 2. 调用截图能力获取当前桌面画面。 3. Agent 或业务逻辑根据界面状态生成下一步操作。 4. 调用鼠标或键盘工具执行操作。 5. 重复观察、决策和执行，直到任务结束。 6. 关闭会话并释放资源。 适用场景 Computer Use 适用于以下场景： 需要操作传统桌面软件，但软件本身不提供开放 API。 需要让 Agent 通过图形界面完成表单填写、信息录入、批量查询等任务。 需要在云端隔离环境中执行桌面自动化。 需要对浏览器、办公软件、业务系统客户端等 GUI 程序进行自动化操作。 需要结合截图能力进行视觉观察和步骤决策。

接口功能介绍 创建池化桌面池 接口约束 无 URI POST /v3/commonDesktopPool/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 桌面池名称，只能包含汉字、数字、英文字母、中划线和下划线，长度限制116个字符 maxm0926 orgOid 是 String 归属部门ID org3fzj92gzwkf9g730m4shf resourcePackOid 是 String 资源包ID rspa94bn3qnadp0pgiv4mhxo templateOid 是 String 规格ID，当前仅支持Windows系统的政企版规格（暂不支持GPU规格） dftvfi8ld7okixldvv4xer4p imageOid 是 String 镜像ID，当前仅支持Windows系统、非GPU镜像 mip4ij5apxcvse44qid3kec sysDiskType 是 String 系统盘类型（hio高IO） hio sysDiskSize 是 Integer 系统盘大小（单位：GB），需为10的倍数，范围：[max{镜像系统盘大小,80},200] 80 subnetOid 是 String 子网ID snw3b8o6cb7afw4l3vd3bgb desktopCount 是 Integer 云电脑数量，云电脑与用户数量比例为1:3，至少为1 1 pubUserOidList 是 Array of Strings 用户ID列表，池化桌面与用户数量比例为1:3，可设置一个或多个，单次数量上限30 upgm611u6q1vm9hekeo5dckl keepDuration 否 Integer 用户断开连接后，云电脑的保留时长（单位：分钟），至少是3，默认值为3 3 afterReleaseAction 否 String 云电脑释放后操作（rebuild还原;stop关机），默认值为rebuild rebuild rebuildAfterStopOrReboot 否 String 关机/重启后还原系统（on开启;off关闭），默认值为off off

本文向您介绍如何使用Debian系列弹性云主机安装图形化界面。 操作场景 为给用户提供纯净的云主机系统，目前使用的Debian系列弹性云主机默认没有安装图形化界面，若有相关需要，详见本篇内容进行安装。 约束与限制 本文所用系统为Debian 9.0.0 64位。 安装图形化界面前请确保云主机内存不小于2GB，以免出现安装失败等问题。 操作步骤 1. 远程登陆云主机后，执行以下命令对软件库进行更新和升级。 apt update apt upgrade 2. 若没有安装tasksel执行以下命令进行安装。 apt install tasksel 3. 执行以下命令使用tasksel安装gnome图形化界面并等待其安装完成。 tasksel install desktop gnomedesktop 4. 执行以下命令设置图形化界面为默认启动。 systemctl setdefault graphical.target 5. 图形化桌面安装后系统禁止root用户登陆，需要新添加子账号用于登陆图像化桌面，此处以user001为例。 adduser user001 除密码外后续信息均可回车跳过，最后输入“Y”确定。 6. 执行reboot命令重启云主机并使用步骤5中创建的子账号登陆即可完成。

本节介绍天翼量子AI云电脑客户端的使用操作。 拖动工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，点击“拖动”图标，支持工具栏任意位置移动，支持隐藏在桌面顶部和左右两侧屏幕边。 锁定/解锁工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，支持锁定和解锁工具栏 自动隐藏工具栏 工具栏拖动至屏幕边缘时，自动吸附隐藏，隐藏后可按Alt+T快速唤起。 窗口切换 如AI云电脑账号下有多个AI云电脑，工具栏点击“窗口切换”功能，支持多个AI云电脑同时运行。 （1）安卓瘦终端仅支持快速切换，不支持多台AI云电脑同时在线运行 （2）外设重定向：如果当前AI云电脑在使用某一USB外设，其他AI云电脑该USB设备显示置灰，避免冲突，不能同时并行使用，提醒“该USB设备已连接到其他AI云电脑，如需使用请先在其他AI云电脑取消该设备的连接。

本节介绍云智助手的产品介绍。 产品介绍 云智助手（原AI应用中心）是天翼AI云电脑3.0推出全系统级AI应用，全面接入DeepSeek大模型，并基于星辰大模型和合作伙伴大模型能力，提供一系列场景化AI能力，升级全场景智能化体验。通过AI赋能，重塑AI云电脑使用体验，让AI云电脑更智能、更简单、更好用。 应用场景 云智助手通过打造了AI助手、AI空间两大功能模块，赋能办公、教育、创作、生活等场景，提升工作、生活效率。 使用说明 使用范围 （1）公有云：所有天翼AI云电脑（公众版）、天翼AI云电脑（政企版）均可使用云智助手； （2）私有云：可联系天翼云客服、大区、售前经理了解私有化部署要求。 获取方式 （1）已在AI云电脑镜像中预装，在桌面找到“云智助手”点击即可直接使用； （2）如未在桌面找到或已卸载，可前往AI云电脑应用市场，搜索“云智助手”下载。 使用条件 （1）云智助手当前支持Windows、UOS等各类操作系统； （2）天翼AI云电脑客户端建议升级至v2.4.3及以上版本； （3）移动端可以通过下载天翼云云电脑APP（3.1.1以上版本）使用云智助手。

本节介绍云智助手的产品介绍。 产品介绍 云智助手（原AI应用中心）是天翼AI云电脑3.0推出全系统级AI应用，全面接入DeepSeek大模型，并基于星辰大模型和合作伙伴大模型能力，提供一系列场景化AI能力，升级全场景智能化体验。通过AI赋能，重塑AI云电脑使用体验，让AI云电脑更智能、更简单、更好用。 应用场景 云智助手通过打造了AI助手、AI空间两大功能模块，赋能办公、教育、创作、生活等场景，提升工作、生活效率。 使用说明 使用范围 （1）公有云：所有天翼AI云电脑（公众版）、天翼AI云电脑（政企版）均可使用云智助手； （2）私有云：可联系天翼云客服、大区、售前经理了解私有化部署要求。 获取方式 （1）已在AI云电脑镜像中预装，在桌面找到“云智助手”点击即可直接使用； （2）如未在桌面找到或已卸载，可前往AI云电脑应用市场，搜索“云智助手”下载。 使用条件 （1）云智助手当前支持Windows、UOS等各类操作系统； （2）天翼AI云电脑客户端建议升级至v2.4.3及以上版本； （3）移动端可以通过下载天翼云云电脑APP（3.1.1以上版本）使用云智助手。

本例我们以Windows Server 2012数据中心版为例。 操作步骤 1. 与本地主机操作一致，首先通过VNC或其余远程登录方式登录轻量型云主机。 2. 右键单击桌面，选择屏幕分辨率，在弹出页面，选择合适的分辨率，点击确定、应用即可。

本节介绍天翼云电脑大屏客户端中云电脑管理操作。 卡片/列表视图切换 登录成功后，在桌面列表页左上角，点击“卡片视图和列表视图”切换图标，可进行卡片视图和列表视图切换，还可以查看云电脑账号有多少台云电脑。 卡片视图 列表视图 进入云电脑 在卡片/列表视图，点击“进入云电脑”按钮进入云电脑。 自动进入 在卡片/列表视图，勾选“自动进入”成功后，对应桌面默认排在第一位，下次登录自动进入对应桌面。若取消“自动进入”，取消勾选即可。 关机、重启 在卡片/列表视图，点击“关机”、“重启”，可对云电脑进行“关机”、“重启”操作。 配置 在卡片/列表视图，点击“配置”，查看云电脑信息ID、名称以及修改名称、云电脑的CPU、内存、系统盘、数据盘配置信息。

本节介绍天翼量子AI云电脑客户端的使用操作。 1. 拖动工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，点击“拖动”图标，支持工具栏任意位置移动，支持隐藏在桌面顶部和左右两侧屏幕边。 2. 锁定/解锁工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，支持锁定和解锁工具栏。 3. 自动隐藏工具栏 工具栏拖动至屏幕边缘时，自动吸附隐藏，隐藏后可按Alt+T快速唤起。 4. 窗口切换 如AI云电脑账号下有多个AI云电脑，工具栏点击“窗口切换”功能，支持多个AI云电脑同时运行。 （1）安卓瘦终端仅支持快速切换，不支持多台AI云电脑同时在线运行 （2）外设重定向：如果当前AI云电脑在使用某一USB外设，其他AI云电脑该USB设备显示置灰，避免冲突，不能同时并行使用，提醒“该USB设备已连接到其他AI云电脑，如需使用请先在其他AI云电脑取消该设备的连接。 5.

接口功能介绍 并发桌面池功能请联系客户经理开通。 操作前请确保并发桌面池中没有云电脑。 接口约束 无 URI POST /v3/concurrentDesktopPool/delete 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpw8djg4dwv35w4c19o932 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx"} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

使用指引 1.Windows桌面，开机会自启动“OpenClaw后台启动服务”，等待服务启动，直至以下画面出现； 点击“OpenClaw进入应用”，会自动打开浏览器，即可开始体验； 2.妙逸/Ubuntu桌面，点击桌面“OpenClaw” 应用图标，即可开始聊天。 说明 为方便用户零门槛快速体验，天翼云默认提供少量 Tokens试用，数量有限；如需获得更优使用体验与效果，请自行购买原生匹配的大模型和Tokens，参照“进阶用户使用”步骤配置。 典型场景演示 场景一、在桌面创建openclaw.txt文件 在 OpenClaw交互页面输入框中，输入指令：请在桌面创建OpenClaw.txt文件，同时写入 “提醒我 10 点开会” 的内容，帮助用户快速记录待办事项。 场景二：统计桌面有多少个txt文件 在 OpenClaw交互页面输入框中，输入指令：统计桌面有多少个txt文件。 说明 为方便用户零门槛快速体验，天翼云默认提供少量 Tokens试用，数量有限；如需获得更优使用体验与效果，请自行购买原生匹配的大模型和Tokens，参照“[进阶用户使用](

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

本节介绍天翼云电脑移动终端的功能使用说明。 拖动工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，点击“拖动”图标，支持工具栏任意位置移动，支持隐藏在桌面顶部和左右两侧屏幕边。 锁定/解锁工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，支持锁定和解锁工具栏。 自动收起工具栏 工具栏在不使用时会自动收起吸附在屏幕边缘，点击可快速展开 。 退出/重启/关机 工具栏“退出”模块，包含以下操作： 退出：点击“退出“，断开AI云电脑连接，退出到AI云电脑列表页。 重启：点击“重启”，将对AI云电脑进行重启，同时退出到AI云电脑列表页。 关机：点击“关机”，仅对AI云电脑进行关机（而非终端关机），同时退出到AI云电脑列表页。 网络状态 工具栏点击“网络状态”，可查看详细的网络状态，包括往返时延，网速上下行。 当AI云电脑遇到卡顿情况时，可点击“一键优化”开启智能检测，优化程序。

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

本节介绍天翼AI云电脑移动终端的功能使用说明。 拖动工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，点击“拖动”图标，支持工具栏任意位置移动，支持隐藏在桌面顶部和左右两侧屏幕边。 锁定/解锁工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，支持锁定和解锁工具栏。 自动收起工具栏 工具栏在不使用时会自动收起吸附在屏幕边缘，点击可快速展开 。 退出/重启/关机 工具栏“退出”模块，包含以下操作： 退出：点击“退出“，断开AI云电脑连接，退出到AI云电脑列表页。 重启：点击“重启”，将对AI云电脑进行重启，同时退出到AI云电脑列表页。 关机：点击“关机”，仅对AI云电脑进行关机（而非终端关机），同时退出到AI云电脑列表页。 网络状态 工具栏点击“网络状态”，可查看详细的网络状态，包括往返时延，网速上下行。 当AI云电脑遇到卡顿情况时，可点击“一键优化”开启智能检测，优化程序。

本文介绍通过 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 否 是否仅释放鼠标

本文介绍通过 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 否 是否仅释放鼠标

本节介绍云电脑高可用的使用说明。 支持的操作系统 AI云电脑高可用（通用版）：Windows 10、Windows server 2008、Windows server 2016、Windows server 2019、统信uos v20、麒麟 v10、Ubuntu18.04、centos7.6。 AI云电脑高可用（个性版）：Windows 10、Windows server 2008、Windows server 2016、Windows server 2019。 支持的资源池 目前支持的资源池有：芜湖2、重庆2、福州4。 性能规格 性能规格 AI云电脑高可用（通用版） AI云电脑高可用（个性版） RPO（恢复点目标） 10分钟 系统文件30分钟、数据文件<10秒 RTO（恢复时间目标） <10分钟 <10分钟 使用限制 规格 限制 AI云电脑高可用（通用版） 1、不支持AI云电脑加入和退出并发桌面池； 2、故障期间，AI云电脑绑定的弹性IP会变化； 3、故障期间，已开通的增值服务：翼甲卫士、翼共享、安全云应用不可用； 4、故障期间，已创建的对等连接不可用； 5、故障期间，已开通的VPN不可用； AI云电脑高可用（个性版） 1、不支持AI云电脑加入和退出并发桌面池； 2、不支持AI云电脑变更VPC和子网； 3、故障期间，AI云电脑绑定的弹性IP会变化； 4、故障期间，已开通的增值服务：翼甲卫士、翼共享、安全云应用不可用； 5、故障期间，已创建的对等连接不可用； 6、故障期间，已开通的VPN不可用； 7、故障期间，系统盘Windows、Program Files、Program Files(X86)目录的文件修改（包括系统配置修改、应用安装卸载）在故障恢复后不保留； 8、故障期间，删除的文件在故障恢复后会被还原；

接口功能介绍 编辑池化桌面池策略 接口约束 无 URI POST /v3/commonDesktopPool/editPolicy 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 池化桌面池ID dpucod37vk0gca50kur44j4 keepDuration 否 Integer 用户断开连接后，云电脑的保留时长（单位：分钟），至少是3 33 afterReleaseAction 否 String 云电脑释放后操作（rebuild还原;stop关机） null rebuildAfterStopOrReboot 否 String 关机/重启后还原系统（on开启;off关闭） null 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无

接口功能介绍 适用于此操作的云电脑需要满足全部条件：1. 计费方式为单实例、资源包。2. 不属于池化桌面池或并发桌面池的云电脑。 此操作将先进行云电脑关机操作。 接口约束 无 URI POST /v3/desktop/resizeSystemDisk 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID diskSize 是 Integer 扩容后系统盘大小（单位：GB）。需为10的倍数，取值范围：(当前系统盘大小,200] autoPay 否 Boolean 是否自动支付（仅创建单独付费云电脑有效），默认false。取值范围： true:是。（仅订购类型为包周期类型有效，需账号有足够金额） false:否。（仅订购类型为包周期类型有效） 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 newOrderNo String 订单号（仅创建单独付费云电脑有效）。 newOrderId String 订单id（仅创建单独付费云电脑有效）。 totalPrice String 总价格（仅创建单独付费云电脑有效）。 operation Object 扩容云电脑系统盘操作。可用于查询操作状态（相关接口：查询操作列表）。 operation 表 operation 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 type String 操作类型。枚举值范围：Common通用型;Task任务型。

本文以 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 配置。

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

应用退后台桌面断连 天翼云电脑应用切换至手机后台后，可设定时长，让云电脑桌面自动断开连接。 面容/指纹识别 如需手机系统支持面容/指纹识别，可启用安全登录，我账号与安全点击“面容/指纹识别”。 虚拟MFA 开启MFA可以对登录、敏感操作进行二次认证，提高账户的安全性。 实名认证 用户需进行实名认证才能订购AI云电脑，目前仅支持安卓移动端提供实名认证入口， 实名认证步骤如下： 1. 打开天翼AI云电脑 APP，我账号与安全点击“实名认证”。 2. 用户按需求可选择“个人用户”进行认证，然后通过“手机号码认证”或“身份证认证”进一步完成实名认证的操作。 3. 根据提示补充相应资料，认证通过即可。 退出登录 如需退出AI云电脑登录账号，我点击页面底部“退出登录”，二次确认之后即可退出AI云电脑登录账号。

本文整理 AIuse 云电脑接入和使用过程中的常见问题,供开发者、运维人员和业务人员排查参考。 产品与能力 AIuse 云电脑主要解决什么问题？ AIuse 云电脑为 Agent 和自动化系统提供云端桌面执行环境。调用方可以通过 SDK 或 MCP 操作云电脑中的图形界面，并读取或写入文件，从而将 Agent 的决策结果落地到真实桌面任务中。 当前支持哪些接入方式？ 当前重点支持 SDK 和 MCP 两种接入方式。SDK 适合业务系统主动编排任务，MCP 适合支持 MCP 的客户端、Agent 宿主或 IDE 插件调用工具。 是否支持 Browser Use？ 当前可通过 Computer Use 操作云电脑中的浏览器，例如点击、输入、滚动和截图。若需要浏览器专用 API、DOM 操作、标签页管理等能力，请以产品后续发布为准。 是否支持 Mobile Use 或 CodeSpace？ 当前文档不建议将 Mobile Use 或 CodeSpace 作为已发布能力描述。如后续正式开放，可补充独立文档。[待确认] SDK 接入 SDK 安装失败怎么办？ 请检查： 本地网络是否可访问 npm 源。 Node.js 版本是否满足要求。 包名是否与正式发布版本一致。 当前项目是否有包管理器权限或代理限制。 创建会话失败怎么办？ 请检查： AccessKey ID 和 Secret 是否正确。 AccessKey 是否已启用。 AccessKey 是否关联目标云电脑。 desktopCode 是否填写正确。 云电脑是否在线。 为什么需要主动关闭会话？ 会话用于承载一次桌面操作上下文。任务结束后主动关闭会话，有助于释放资源、减少异常占用，并降低后续任务受到影响的概率。 MCP 接入

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI POST /v3/concurrentDesktopPool/editPolicy 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpurmb31l1two2so9us14ro keepDuration 否 Integer 用户断开连接后，云电脑所占并发额度的保留时长（单位：分钟），至少是3 33 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxx","keepDuration":33} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码

本文整理 AIuse 云电脑接入和使用过程中的常见问题,供开发者、运维人员和业务人员排查参考。 产品与能力 AIuse 云电脑主要解决什么问题？ AIuse 云电脑为 Agent 和自动化系统提供云端桌面执行环境。调用方可以通过 SDK 或 MCP 操作云电脑中的图形界面，并读取或写入文件，从而将 Agent 的决策结果落地到真实桌面任务中。 当前支持哪些接入方式？ 当前重点支持 SDK 和 MCP 两种接入方式。SDK 适合业务系统主动编排任务，MCP 适合支持 MCP 的客户端、Agent 宿主或 IDE 插件调用工具。 是否支持 Browser Use？ 当前可通过 Computer Use 操作云电脑中的浏览器，例如点击、输入、滚动和截图。若需要浏览器专用 API、DOM 操作、标签页管理等能力，请以产品后续发布为准。 是否支持 Mobile Use 或 CodeSpace？ 当前文档不建议将 Mobile Use 或 CodeSpace 作为已发布能力描述。如后续正式开放，可补充独立文档。[待确认] SDK 接入 SDK 安装失败怎么办？ 请检查： 本地网络是否可访问 npm 源。 Node.js 版本是否满足要求。 包名是否与正式发布版本一致。 当前项目是否有包管理器权限或代理限制。 创建会话失败怎么办？ 请检查： AccessKey ID 和 Secret 是否正确。 AccessKey 是否已启用。 AccessKey 是否关联目标云电脑。 desktopCode 是否填写正确。 云电脑是否在线。 为什么需要主动关闭会话？ 会话用于承载一次桌面操作上下文。任务结束后主动关闭会话，有助于释放资源、减少异常占用，并降低后续任务受到影响的概率。 MCP 接入

本节介绍翼家云电脑的功能介绍 产品介绍 翼家云电脑推出一站式“1+N”家庭场景解决方案，满足家长办公、家庭管理，孩子学习，老人娱乐等家庭多样化场景。 注意 翼家云电脑功能仅支持 家庭管理 “翼家”当前对天翼云电脑（公众版）开放，家长可通过手机号邀请成员或管理员加入家庭管理。组建家庭关系后，家长和管理员可对家庭成员云电脑查看学习、绿色管控、远程接入、解绑云电脑等操作。 家庭管理入口 电脑端： 1.登录天翼云电脑客户端； 2.前往“家庭管理”入口。 桌面列表“家庭管理”。 云电脑内“家庭管理”。 移动端： 1.登录天翼云电脑客户端； 2.前往“家庭管理”入口。 我“家庭管理”。 云电脑内“家庭管理”。