功能概述 在不同网络环境及设备条件下，AI云电脑可以应用不同的基础策略。如：在互联网环境下不支持桌面拷入拷出、不允许使用某些外设设备，但在专线环境下需要支持。 功能优势 提供更加灵活的策略配置方案。 使用场景 用户想要通过接入环境条件来相应地设置桌面使用不同的基础策略。如： 1.当用户从互联网和专线接入时，桌面可以应用基础策略A。 2.当用户通过不同设备接入时，桌面可以应用基础策略B。 创建条件策略 1.进入“AI云电脑（政企版）”管理控制台； 2.点击左侧菜单“策略管理”“基础策略管理”，进入“基础策略管理”页面； 3.单击“新建策略”，把桌面实际需要执行的基础策略进行配置完成，配置操作可参考 基础策略； 4.把基础策略配置完成后，即可进入条件策略配置，.点击左侧菜单“策略管理”“条件策略”， 5.点击“新建”，进入条件策略创建页面，可对条件范围（互联网/专线/设备）、条件关系（针对条件范围），以及具体的执行策略、设备进行配置，具体使用方式如下图； 示例1：当用户从互联网或专线接入时，桌面可以应用”基础策略A”的策略。 示例2：当用户从专线接入时，桌面可以应用”基础策略B”的策略。 示例3：当用户通过专线且通过“Windows客户端”的设备接入时，桌面可以应用”基础策略C”的策略。 提示：如果同时满足多个条件，桌面会按照条件排序优先级进行生效。 6.配置完成后，点击“确定”即可。

云电脑OpenClaw默认模型 API 云电脑中的 OpenClaw ，会根据当下算力使用情况，默认动态调用如下大模型：Mini Max M2.5，GLM5，DeepSeek V3.2等。 如何切换模型（使用云电脑中云智助手） 在云智助手更新算力模型 1. 进入天翼AI云电脑的桌面端、移动端或小程序的AI云电脑列表页面； 2. 在进入【云电脑】桌面后找到【云智助手】客户端； 3. 在【云智助手】OpenClaw模块中找到云桌面名称（小龙虾住址）； 4. 在【云智助手】侧边栏中找到【AI算力】模块； 5. 在【AI算力】列表中，找到对应小龙虾（OpenClaw）桌面名使用的API，点击【编辑】； 6. 在【编辑】页面中，选择你想用的模型，保存后生效。 在云智助手中获取配置项 1. 打开云智助手AI算力列表，查看当前账号的模型API Key；若无API Key，需按流程手动创建； 2. 在算力列表页，点击【API接入】； 3. 在【API接入】页面获取模型参数：Base URL（基础URL）、模型ID、API协议类型。

接口功能介绍 查询池化桌面池列表 接口约束 无 URI GET /v3/commonDesktopPool/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 poolName 否 String 桌面池名称 testtest pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 1 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 desktopPoolOid String 桌面池ID dp2abarbp4482p6b2vxlw3t poolName String 桌面池名称 testtest desktopCount Integer 桌面池中云电脑数量 1 pubUserCount Integer 授权使用桌面池的终端用户数量 1 vpcOid String VPC ID vpcj2cqg2x69mjl4xugi3ape vpcName String VPC 名称 maxm0901AA osName String 操作系统名称 Windows 2016 Standard 64位 中文版（生产） status String 状态（Operating运维中；Running运行中） Running createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230919T11:26:03Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230929T16:00:00Z config Object 桌面池配置策略 config 表 config 参数 参数类型 说明 示例 下级对象 keepDuration Integer 用户断开连接后，云电脑的保留时长（单位：分钟） 3 afterReleaseAction String 云电脑释放后操作（rebuild还原;stop关机） rebuild rebuildAfterStopOrReboot String 关机或重启后还原系统（on开启;off关闭） on

云电脑OpenClaw默认模型 API 云电脑中的 OpenClaw ，会根据当下算力使用情况，默认动态调用如下大模型：Mini Max M2.5，GLM5，DeepSeek V3.2等。 如何切换模型（使用云电脑中云智助手） 在云智助手更新算力模型 1. 进入天翼AI云电脑的桌面端、移动端或小程序的AI云电脑列表页面； 2. 在进入【云电脑】桌面后找到【云智助手】客户端； 3. 在【云智助手】OpenClaw模块中找到云桌面名称（小龙虾住址）； 4. 在【云智助手】侧边栏中找到【AI算力】模块； 5. 在【AI算力】列表中，找到对应小龙虾（OpenClaw）桌面名使用的API，点击【编辑】； 6. 在【编辑】页面中，选择你想用的模型，保存后生效。 在云智助手中获取配置项 1. 打开云智助手AI算力列表，查看当前账号的模型API Key；若无API Key，需按流程手动创建； 2. 在算力列表页，点击【API接入】； 3. 在【API接入】页面获取模型参数：Base URL（基础URL）、模型ID、API协议类型。

本文介绍Ubuntu系列操作系统的云主机安装图像化界面的操作流程。 约束与限制 弹性云主机安装图形化界面前，请确保云主机内存不小于2GB，否则可能出现图像化界面安装失败，或安装后无法启动的问题。 操作步骤 本文操作以Ubuntu 22.04 64位弹性云主机为例。 1. 登录弹性云主机。 2. 执行以下命令，安装Ubuntu图形桌面组件。 aptget update 对于Ubuntu16.04版本，请执行以下命令： aptget install y scite xorg xubuntudesktop 对于Ubuntu18.04、20.04和22.04版本，请执行以下命令： aptget install y ubuntudesktop 说明 说明：安装前请确保云主机可以连通互联网，可以通过申请并绑定弹性IP连通互联网。 安装完成示例： 3. 安装完成后，编辑/root/.profile文件。 vim /root/.profile 注释掉末尾以 mesg 开头的行，并新添加一行 tty s && mesg n true，修改后该文件内容可参考下方图片： 4. 单击“Esc”退出编辑模式。 5. 执行以下命令，保存并退出文件。 :wq 6. (Ubuntu 20.04操作系统必选)添加子账号。 安装图形化桌面后，Ubuntu 20.04操作系统禁止root登录，因此需要在安装完成后添加子账号用于登录图像化桌面。 以添加user01用户为例，执行以下命令。

配置项 说明 服务状态 每个资源节点均可开通/退订AI云电脑服务。注意：退订桌面服务需要该账号下无桌面资源，包括资源包、桌面、带宽、VPC、防火墙等；服务一经退订，无法撤销，请谨慎操作。 企业ID 对于以“管理员激活”方式开通的AI云电脑账号，企业ID用于租户下AI云电脑统一的登录账号后缀，例如企业管理员开通AI云电脑时分配了名为“desk01”的用户账号，那么终端用户在AI云电脑客户端中输入的登录账号就应为“desk01企业ID”。 手机号必填 开启后，通过“邮件通知”激活AI云电脑用户时，终端用户必须填写手机号（手机号可用于设备验证、免密登录、找回密码等）。 邮箱必选 开启后，通过“邮件通知”激活的AI云电脑用户，默认使用通知邮箱作为账号邮箱。 修改密码 允许后，可限制未绑定通知邮箱的管理员激活用户，在客户端登录后修改密码的操作权限。 设备绑定 开启后，在设备登录AI云电脑客户端时，绑定手机号需要进行验证。 双因子认证登录 开启双因子认证登录后，如果用户绑定了手机号码，并且使用账号（包括用户账号、手机和邮箱）+用户密码登录时，每次登录必须通过短信验证才能完成登录。 记录终端SN码 开启后，将会收集终端SN码，用于用户登录记录中展示，仅限于部分机型。 密码定期强制更新 设置后，可强制要求用户在指定周期内必须修改密码，周期可设置为：无限制/1个月/3个月/6个月/12个月。 联系方式 配置后可在AI云电脑客户端的”AI云电脑配置“页面显示管理员的联系方式。 专线不通切换互联网 开启后，“专线接入”和“互联网接入”均开启时，在专线不通的情况下，才能自动使用互联网连接桌面。 互联网接入 可配置当前资源池下的虚拟私有云启用/禁用状态。如需配置接入互联的VPC，详见 专线接入 如需对接专线，请向您的专属客户经理提交申请，或拨打天翼云客服电话： 4008109889。

接口功能介绍 适用云电脑情况如下： 桌面池类型 系统类型 计费方式 是否支持GPU 无桌面池 Windows 资源包 是 无桌面池 Linux 资源包 否 并发 Windows 资源包 是 此操作将先进行云电脑关机操作。 接口约束 无 URI POST /v3/desktop/resizeDataDisk 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023091701178069 diskOid 是 String 磁盘ID voln2eb9hstn19f8shc65aa7 diskSize 是 Integer 扩容后数据盘大小（单位：GB）。需为10的倍数，取值范围：(当前数据盘大小,32000] 40 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 operation Object 扩容云电脑数据盘操作。可用于查询操作状态（相关接口：查询操作列表）。 operation 表 operation 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 cc2784e7c5c72681107118c35e6b1ebf type String 操作类型。枚举值范围：Common通用型;Task任务型。 Common

加密桌面管理找不到要处理的桌面 AI云电脑需要分配加密策略后才可以在加密桌面管理进行操作处理。如果您在加密桌面管理找不到要处理的AI云电脑，请先给这些AI云电脑分配加密策略。 新建用户无法正常提交脱密申请或无法正常走审批流程 添加的新用户，需要等待24小时，才会自动更新组织架构，生效审批流程。如需快速处理，也可以在【租户管理—审批流程—分管设置】，手动点击【同步组织机构】，立即生效审批流程。

本节介绍应用市场的产品简介，以便您了解应用市场。 应用市场，是一项对桌面内应用进行统一管理与全面管控的服务，既能帮助企业管理员对桌面内应用进行有效监管，也为企业统一分发应用、用户轻松获取应用提供了便捷的渠道。其由两大部分构成：天翼AI云电脑（政企版）控制台应用市场模块（以下简称控制台）、天翼AI云电脑应用市场客户端（以下简称客户端）。 控制台 企业管理员通过控制台可以进行应用上架、新增版本、推送应用等操作；也可以配置应用黑白名单集中管控桌面内应用的安装和运行；还能在日志记录中查看各管控桌面的应用阻止记录、用户申请记录，以及桌面已安装应用等数据。 客户端 桌面用户可通过客户端下载与安装天翼AI云电脑提供的免费应用以及企业上架的专属应用，还可查看管控状态下的各类阻止与申请记录。管理员也可以查看和处理其他桌面用户提交的多种申请。 如需下载应用市场客户端请前往：客户端下载页面 天翼AI云电脑应用市场用户协议生效，详情请参见这里。 天翼AI云电脑应用市场隐私政策生效，详情请参见这里。

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

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

本节介绍天翼AI云电脑（政企版）产品支持集中管控、安全管理、数据安全以及更多扩展功能的内容介绍。 集中管控 统一业务管理台，应用软件、操作系统等一键升级，快速批量创建桌面，实现桌面标准化，降低工作量。 集中管理：支持用户管理、AI云电脑资源管理和计费管理。 策略管理：可配置盘类设备的读写权限，避免企业敏感信息泄密。 集中存储：防止数据用户泄密。终端故障率低，免维护，省时省力。 安全管理 AI云电脑提供多种安全管理使用能力，满足不同用户级别、不同场景的安全需要，给你安全、干净、高效的办公桌面。 管理安全：分权分域控制，按角色分类控制管理员的权限，且按部门控制管理员可管理的桌面，对管理员操作生成审计日志。 登录日志：记录用户登录AI云电脑，包括终端设备信息、开始连接时间和结束连接时间，实现对异常使用AI云电脑情况可追溯。 安全水印：显性水印，防软件截图，防拍照泄密，事前威慑，事后追踪泄密来源。 安全组：具备状态检测和数据包过滤能力，用于在云端划分安全域。 异常处理：在发现使用AI云电脑存在异常情况，如用户在做非法行为，可立刻锁住该桌面，及时制止。

搜索云电脑 搜索功能默认不显示，若云电脑账号下超过6台云电脑，桌面列表右上角显示搜索功能。 全屏显示 登录成功后，在桌面列表页右上角，点击“全屏显示/退出全屏”切换图标，可进行客户端窗口切换。

调用方式 在 Qoder 中可以直接用自然语言说明目标桌面和任务： plaintext 在 desktopCodexxx 桌面，创建一下 C:/aiusertest 文件夹。 如果 MCP Client 展示结构化工具参数，则需要填写： plaintext { "desktopCode": "xxx", "path": "C:/aiusertest" } 接入流程 1. 准备 AccessKey ID、AccessKey Secret 和目标云电脑 desktopCode。 2. 确认本地 Node.js 和 npx 可用。 3. 在 Qoder 或其他 MCP Client 中添加 MCP Server 配置。 4. 保存配置并刷新 MCP Client。 5. 确认工具列表加载成功。 6. 调用 Computer Use 或 FileSystem 工具，并在请求中指定 desktopCode。 验证建议 建议先执行低风险工具验证配置是否可用： plaintext 在 desktopCodexxx 桌面，获取当前鼠标位置。 然后再执行文件或鼠标键盘操作： plaintext 在 desktopCodexxx 桌面，创建一下 C:/aiusertest 文件夹。 安全建议 不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。 多人共享开发环境时，应使用个人或项目级 AccessKey。 AccessKey 应只关联必要的云电脑资源。 AccessKey 泄露后应立即在控制台禁用。 文件系统工具具备读写目标云电脑文件的能力，建议只在可信任务和可信桌面中启用。

6.搜索AI云电脑 搜索功能默认不显示，若AI云电脑账号下超过6台AI云电脑，桌面列表右上角显示搜索功能。 7.全屏显示 登录成功后，在桌面列表页右上角，点击“全屏显示/退出全屏”切换图标，可进行客户端窗口切换。

本节介绍天翼AI云电脑（政企版）的产品优势。 统一管理，维护便捷 无需设立专门的前端维护人员，桌面维护全部在管理台进行可视化操作，一键完成开通桌面、重装系统、镜像升级等操作，并通过自动化批量方式，实现快速大规模的部署。 强化安全，自主可控 网络访问使用VPC、安全组、ACL、主机防火墙进行网络隔离及访问控制，通过防火墙实施安全审计与监控。 规格丰富，配置灵活 提供灵活多样的AI云电脑规格，支持资源包方式开通使用，灵活选择系统版本，网络可配置，并可使用池化桌面提高桌面利用率。 自主领先，畅游云端 自研的CLINK安全传输协议，低延时、高画质、带宽占用少，弱网环境下也可畅快使用。 随时随地，便捷访问 用户通过终端AI云电脑应用即可快速访问调取云端资源，随时随地享受数据共享、移动办公、休闲娱乐等功能。 说明 关于天翼AI云电脑（政企版）的产品规格说明，请参考 关于天翼AI云电脑（政企版）的产品功能说明，请参考 关于天翼AI云电脑（政企版）的客户端下载，请前往

桌面证书管理 启用流量加解密后，为保证加密流量审计功能正常，请为桌面安装证书。 （1）筛选：用户可根据业务需求对桌面进行筛选。 （2）安装证书：在列表勾选对应桌面后，点击“安装证书”，可完成对所选桌面安装证书，点击按钮后，证书状态更新可能有延迟。 （3）一件同步桌面用户：在列表勾选对应桌面后，点击“一键同步桌面”，可完成一键同步桌面用户。

验证建议 建议先执行低风险工具验证配置是否可用： plaintext 在 desktopCodexxx 桌面，获取当前鼠标位置。 然后再执行文件或鼠标键盘操作： plaintext 在 desktopCodexxx 桌面，创建一下 C:/aiusertest 文件夹。 安全建议 不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。 多人共享开发环境时，应使用个人或项目级 AccessKey。 AccessKey 应只关联必要的云电脑资源。 AccessKey 泄露后应立即在控制台禁用。 文件系统工具具备读写目标云电脑文件的能力，建议只在可信任务和可信桌面中启用。

本节介绍安全云应用的产品介绍。 产品简介 安全云应用是一种基于天翼云托管的应用程序流式传输服务，通过天翼云自研的clink传输协议，将音视频、图像、外设等信息传输到用户的远程设备上，实现跨平台、安全、易用的应用程序访问。 注意 目前安全云应用功能仅在部分资源池（石家庄3、郴州2、佛山3）开放，如当前资源池的AI云电脑（政企版）控制台没有安全云应用的功能菜单，请联系运维客服进行开通（运维客服邮箱：clouddesktop@chinatelecom.cn）。 应用场景 国产化转型 在国产操作系统上无缝运行Windows应用，确保用户业务系统的连续性，轻松实现国产化转型。 安全办公场景 远程访问应用，内外网隔离，兼顾外网访问需求的同时，最大限度保证用户数据安全。 支持的操作系统 服务桌面：承载云应用运行的AI云电脑，支持Windows Server 2019 用户桌面：用户使用的国产化AI云电脑，统信V20, 麒麟V10，中科方德 产品规格 规格类型 功能适用 规格参数 系统支持 基础版 适用于简单办公、文档编辑、客户服务等场景 2C4G 80G系统盘 Windows 标准版 适用于视频娱乐，在线会议，OA办公等场景 4C8G 80G系统盘 Windows 旗舰版 适用于高效办公，开发设计，视频监控等场景 8C16G 80G系统盘 Windows

本节介绍AI云电脑（政企版）的镜像管理。 操作场景 开通AI云电脑（政企版）实例时，系统默认会提供公共镜像让管理员选择。 若有公共镜像以外的需求，管理员可通过镜像导入功能，上传私有镜像文件制作AI云电脑。导入的镜像仅能用于制作模板镜像，管理员开通AI云电脑并完成个性化设置后，需创建自定义镜像后才可用于批量创建同类桌面。（适用win7、win10镜像，但镜像激活操作需由用户自行完成） 管理员可在现有AI云电脑Windows操作系统安装所需的应用软件，并对操作系统及应用软件进行个性化设置，完成AI云电脑设置后，即可基于此AI云电脑来创建用户自定义镜像，通过自定义镜像可批量创建拥有相同个性化设置的AI云电脑。 支持在同一资源池或跨资源池间的租户实现共享镜像。 创建自定义镜像 说明 1. 若租户超出1年没有订购的AI云电脑、翼加密、市场市场、翼共享、翼甲卫士等资源，系统将自动回收自定义镜像资源数据不可恢复，为了保证业务正常运行，请及时订购AI云电脑资源。 2. 单实例桌面暂不支持整机镜像创建功能。 3. 每个租户只能建默认5个自定义镜像。 1. 进入“AI云电脑（政企版）”管理控制台； 2. 展开“AI云电脑管理”菜单栏，选择“镜像管理”，选择“自定义镜像”，点击“创建自定义镜像”； 3. 进入“创建自定义镜像页面”； 1. 选择需要创建自定义镜像的桌面； 2. 填写“镜像名称”； 3. 点击“立即创建”，即完成自定义镜像的创建。

应用退后台桌面断连 天翼云电脑应用切换至手机后台后，可设定时长，让云电脑桌面自动断开连接。 面容/指纹识别 如需手机系统支持面容/指纹识别，可启用安全登录，我账号与安全点击“面容/指纹识别”。 虚拟MFA 开启MFA可以对登录、敏感操作进行二次认证，提高账户的安全性。 退出登录 如需退出AI云电脑登录账号，我点击页面底部“退出登录”，二次确认之后即可退出AI云电脑登录账号。

独立安全算力空间,多智能高效协同,任务一键交付 本次更新包含AIuse云电脑与Cospace，共同构成了天翼云AI云电脑的核心能力矩阵，为用户带来全新的智能办公体验。 Cospace智协空间：面向普通用户，通过自然语言交互实现跨终端远程智控。让你通过一句话命令即可跨终端远程智控云电脑，无论使用手机、平板还是电脑，都能随时随地完成文件查找、软件操作、任务执行等复杂办公需求。 AIuse云电脑：面向开发者，为开发者提供标准化SDK，支持程序化远程控制，助力AI自动化任务的高效落地。 两大功能依托天翼云强大的独立安全算力空间，构建企业级安全防护体系，让智能与安全兼得。现在就体验，开启云端智能办公新纪元! Cospace智协空间功能介绍 云电脑的桌面级智能体 CoSpace是云智助手新增的AI云电脑桌面智能体功能，作为办公场景下的全天候AI工作伙伴，主打"一句话命令、跨终端远程智控云电脑"核心能力。 对话式交互，实现系统级的桌面控制 用户无需额外下载，通过简单对话即可完成文件查找、办公软件操作、任务执行等复杂办公需求。

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

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

本文以 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 配置。 截图验证桌面 在 Qoder 中输入： plaintext 在 desktopCodexxx 桌面，截取当前屏幕。 结构化工具调用等价于： plaintext { "name": "screenshot", "arguments": { "desktopCode": "xxx" } }

本节为您接受如何为麒麟系统云主机配置图形化界面。 操作场景 为了提供纯净的弹性云主机系统给客户，麒麟系统云主机默认没有安装图形化界面，如果您需要图形化界面，请参见本节内容进行安装。 操作步骤 1. 配置网络，确保yum源可以正常使用。银河麒麟服务器操作系统在有外网的环境下可以直接使用yum源，而在无外网的环境下需要挂载镜像作为本地源。 2. 在字符界面执行以下命令，列出可安装的图形化包组 yum group list 3. 在字符界面执行yum groupinstall y "带GUI的服务器"命令，安装图形化桌面相关包，如下示例： yum groupinstall y "Server with UKUI GUI" 4. 在字符界面执行以下命令，设置系统默认的启动方式为graphical.target，即图形化启动 systemctl setdefault graphical.target 5. 在字符界面执行以下命令，重启系统使其生效 reboot 6. 重启系统后即可进入图形化界面 7. 输入用户名与密码，进入系统 安装图形化桌面相关包报错 操作背景 一般地，Linux 基础镜像不会默认安装图形化桌面相关包。银河麒麟高级服务器操作系统可按照本文档指导以上步骤自行安装。经用户反馈，有些条件下会有如下报错，可按以下方法进行解决。 经分析，银河麒麟高级服务器操作系统 V10 SP3（2303）使用以下路径的官方源。 < 存量基础镜像出于安全等因素所预装的 selinuxpolicy 相关包的版本是 3.14.276.se.29.01.ky10，但截至此篇 FAQ 发布时，官方源的最新版本已回退为 3.14.276.se.26.08.ky10，导致安装图形化桌面相关包时存在无法自动处理的依赖冲突问题。

本节介绍安全云应用客户端指南内容。 安全云应用由管理台统一管理和分发，用户登录国产化AI云电脑时，快捷方式会直接生成到用户桌面，用户无需手动安装客户端及应用，点击即可直接使用。 托盘功能 安全云应用提供了一个自运维工具，常驻在系统桌面右下角任务栏，用户可根据使用情况选择对应的功能，对服务进行维护与恢复。 USB设备管理：支持通过客户端调整外设的运行环境，例如需要把打印机从UOS同步到安全云应用的WPS环境时，可通过该功能，勾选对应打印机设备后即可使用。 网络参数配置：支持在国产化AI云电脑使用安全云应用中配置的网络代理，解决在国产化AI云电脑下无相关的vpn软件。 关闭所有应用：支持通过客户端从进程上直接结束应用，从而解决应用本身的卡死问题。 重启应用服务器：支持通过客户端直接重启安全云应用的实例虚机，从而重启整个服务，解决绝大部分的异常问题。 安全云应用输入法：输入法切换，使用安全云应用内输入法还是本机输入法。

对云电竞服务使用到的名词做解释。 串流 云电竞的串流处理是将云端服务器上运行的游戏画面传输至用户本地终端，并将本地终端的操作指令反馈到云端服务器上，实现低端设备畅玩海量游戏的效果。 云桌面 云桌面是替代传统电脑的一种新模式；采用云桌面后，用户无需再购买电脑主机，用户采用瘦终端（与电视机顶盒类似的设备）连接显示器和键鼠，用户安装客户端后通过特有的通信协议访问后端服务器上的云主机来实现交互式操作，达到与传统电脑一致的体验效果。 云电竞 云电竞指的是天翼云基于云桌面能力，向用户提供的无需高端硬件设施，也可让用户畅玩高配3A大作、热门网络游戏的功能服务。 瘦终端 瘦终端指小型行业专用商用PC，使用嵌入式处理器、小型本地闪存、轻量版操作系统来接入桌面，相较于传统 PC 来说，造价更低，部署更简。 边缘节点 边缘节点是相对于复杂网络结构提出的一个概念，指距离最终用户接入具有较少的中间环节的网络节点，对最终接入用户有较好的响应能力和连接速度。

本文介绍云主机是否有图形界面 Windows操作系统是桌面管理，有图形化界面。 Linux操作系统是命令行，用户如果需要可以自己设置图形管理。 弹性云主机安装图形化界面前，请确保云主机内存不小于2GB，否则可能出现图像化界面安装失败，或安装后无法启动的问题。

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

本文介绍如何通过 AIuse 云电脑 SDK 接入桌面自动化能力。SDK 适合由业务服务主动创建会话、编排桌面操作流程、批量执行标准化任务的场景。 当前 SDK 面向 Node.js 服务端或可信 Node.js 运行环境，不建议直接在浏览器前端、移动端客户端或用户可反编译的安装包中保存 AccessKey Secret。 适用场景 业务系统需要主动创建会话并执行桌面操作。 需要在代码中编排鼠标、键盘、截图和文件操作。 需要将 AIuse 云电脑能力集成到自有调度系统、自动化平台或智能应用服务中。 需要对任务流程、错误处理、重试策略和资源释放进行精细控制。 如果使用 Qoder 或其他支持 MCP 的客户端直接调用工具，建议参考《通过 MCP 接入》。 前提条件 项目 说明 租户权限 已开通 AIuse 云电脑服务 AccessKey 已创建 AccessKey ID 和 AccessKey Secret 云电脑资源 已准备可用云电脑，并获取桌面编码 desktopCode 运行环境 Node.js 18 或以上版本，建议使用维护期内 LTS 版本 网络访问 运行 SDK 的环境可访问 AIuse 云电脑服务地址 Node.js 安装方式如下： 1. 打开 Node.js 官网下载页面 2. 选择维护期内的 LTS 版本安装包 3. 按安装向导完成安装 4. 安装完成后重新打开终端 5. 依次执行 node v 和 npx v，确认命令可正常使用

本文介绍如何通过 AIuse 云电脑 SDK 接入桌面自动化能力。SDK 适合由业务服务主动创建会话、编排桌面操作流程、批量执行标准化任务的场景。 当前 SDK 面向 Node.js 服务端或可信 Node.js 运行环境，不建议直接在浏览器前端、移动端客户端或用户可反编译的安装包中保存 AccessKey Secret。 适用场景 业务系统需要主动创建会话并执行桌面操作。 需要在代码中编排鼠标、键盘、截图和文件操作。 需要将 AIuse 云电脑能力集成到自有调度系统、自动化平台或智能应用服务中。 需要对任务流程、错误处理、重试策略和资源释放进行精细控制。 如果使用 Qoder 或其他支持 MCP 的客户端直接调用工具，建议参考《通过 MCP 接入》。 前提条件 项目 说明 租户权限 已开通 AIuse 云电脑服务 AccessKey 已创建 AccessKey ID 和 AccessKey Secret 云电脑资源 已准备可用云电脑，并获取桌面编码 desktopCode 运行环境 Node.js 18 或以上版本，建议使用维护期内 LTS 版本 网络访问 运行 SDK 的环境可访问 AIuse 云电脑服务地址 Node.js 安装方式如下： 1. 打开 Node.js 官网下载页面 2. 选择维护期内的 LTS 版本安装包 3. 按安装向导完成安装 4. 安装完成后重新打开终端 5. 依次执行 node v 和 npx v，确认命令可正常使用