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

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

天翼AI云电脑用户基础功能隐私政策生效，详情请参见++这里++。 +天翼AI云电脑用户基础功能隐私政策 历史版本（20211111）++

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

参数 是否必填 参数类型 说明 示例 下级对象 cycleType 是 Integer 取值范围：3表示按月订购，5表示按一年订购，6表示按两年订购、7表示按三年订购。与cycleCount配合使用，cycleCount属性为1，cycleType取值为3 表示订购1个月。 3 cycleCount 是 Integer 续订周期数量。 2表示续订2个月（值需大于零，不超过384个月） 1 resourceIds 是 Array of Strings String数组，主虚拟资源ID（批量续订时资源不能超过10个）可通过【根据主订单id查询订单详情】接口返回的masterResourceId字段获取 [ "48cd3a5e9b964657a1f31c58a8b98ae4"]

枚举参数 无 请求示例 请求url 请求头header { "regionId":"81f7728662dd11ec810800155d307d5b" } 请求体body { "resourceIds": [ "resourceId" ] } 响应示例 { "message": "SUCCESS", "returnObj": { "errorMessage": "", "submitted": true, "orderPlacedEvents": [ { "errorMessage": "", "submitted": true, "newOrderId": "24190b4b848a477daa32d1c5e45cea89", "newOrderNo": "20221102175910054091", "totalPrice": 542.0 } ] }, "statusCode": 800 } 状态码 请参考 状态码 错误码 请参考 错误码

参数名 是否必选 参数类型 说明 默认值 role 是 str 聊天角色，user或者assistant content 是 str 消息内容 type 是 str "text":文本， "image"图片， "browserresult" :互联网检索 ref 否 ChatMessageRef 文件（图片）内容，支持多模态的模型可以使用该字段，带上该字段的消息示例格式 { "role":"user", "content":"图里有什么", "ref":{ "type":"image", "image":[{"url":"", "filesize":60994} ] } }

其他设置 其他设置中可以开启或关闭“桌面应用上报”的功能。

本节介绍应用市场客户端的应用安装、升级、卸载等功能。 应用管理 搜索应用 支持通过应用名称等关键字搜索相关应用，也可以根据分类与行业快速检索所需应用。 安装应用 用户找到想要安装的应用后，可点击安装按钮安装，或进入应用详情页中下载安装。 安装方式 应用的安装方式可分为“一键安装”（静默安装）和“手动安装”两种。 “一键安装”，用户无需对应用进行设置，应用将直接下载并安装至虚机系统盘； “手动安装”，需要用户根据应用的安装指引进行安装。 注：可一键安装的应用，也支持手动安装。 应用升级 当已安装的应用有新版本可更新时，“我的应用”菜单将出现红点提示，可选择指定应用升级或全部升级。 应用卸载 我的应用菜单中，还可以选择“应用卸载”。应用卸载列表中展示的是桌面内已安装的应用（和控制面板中相同）。点击“卸载”按钮，将拉起桌面内应用的卸载程序。卸载完成后，应用将从列表中消失。

本节介绍应用市场客户端的下载方式。 用户可通过客户端安装、升级、卸载平台和企业提供的各类应用，并且能处理各类安全审批相关的记录。目前AI云电脑中已预装此客户端，如未预装，可通过AI云电脑工具栏的快捷入口触发安装，或前往客户端下载页面进行下载。

本节介绍翼甲控制台监控首页内容。 监控首页 用户进入翼甲卫士控制台后，可在监控首页页面对防护概览进行了解。 基础信息总览：可看到当前防火墙的各组件版本信息及资源使用率。 防护总览：可看到按照不同时间维度查（最近一小时、一天、一周）询流量趋势以及桌面防护情况。 告警监控总览：可以按照不同时间维度（最近一小时、一天、一周）查阅告警事件详情及处理结果。

本节介绍如何创建AIuse云电脑所需的服务凭证和关联云电脑操作。 您可以为您的不同场景/不同项目创建不同的AccessKey，用于灵活的分权控制对应的云电脑来实现不同的任务。 创建AccessKey 1. 进入协同套件Aiuse云电脑功能专区； 2. 再专区卡片点击前往管理； 3. 在服务管理页面，点击创建AccessKey； 4. 在输入框中输入AccessKey名称等相关信息，点击确定。 注意：AccessKey为重要鉴权凭证，为了您的信息安全请妥善保管，切勿随意分享给他人。 命名建议 建议 AccessKey 名称包含业务含义，便于后续管理和排查。 名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用 关联云电脑 AccessKey需要关联指定的云电脑范围才可使用 1. 进入服务管理页面； 2. 在操作列点击关联云电脑； 3. 在弹窗中搜索和选择需要关联的云电脑； 4. 点击确认操作，完成绑定。 注意;目前仅支持Windows操作系统云电脑 查看AccessKey 1. 进入服务管理页面，在列表中即可查看名称、ID、Secret和关联云电脑数量等信息； 2. 在AccessKey Secret信息列，可点击对应的按钮显示完整信息和复制信息。

登录云网门户，在“控制台”>“个人中心”>“第三方账号绑定 ”，通过创建或者查看获取ak，sk。

天翼AI云电脑服务协议生效，详情请参见++这里++。

本地智库 1.首次开通和本地智库盘安装：专属智库个人智库列表页，本地智库文件夹，双击或者点击更多进行安装； 2.云智助手查看本地智库文件：安装成功后，点击进入查看本地智库文件； 3.文件管理器查看本地智库：安装成功后，进入文件管理器，查看本地智库盘。 注意 本地智库挂载盘需要云电脑内使用，需要当前云电脑账号与云智助手登录账号保持一致才可使用。 网页地址添加 说明 云智助手支持将网页地址添加到个人智库。需要v2.5.4以上版本支持。 1.进入云智助手客户端，进入“专属智库”模块； 2.点击“上传”中的“网页链接”入口，出现输入弹窗； 3.用户可将网页地址提交至个人智库，添加的网页URL必须保证链接可公开访问，且网站内容可复制，同时URL需以

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj

网络环境与传输需求 NAS 共享盘：在天翼AI云电脑局域网环境下，能够提供高速且稳定的传输速度，支持大文件传输。如果您的使用场景主要集中在AI云电脑局域网内，对文件传输速度和大文件处理能力有较高要求，NAS 共享盘可以确保文件的快速、稳定传输，提高工作效率。例如，设计团队在局域网内共享大型设计文件、视频制作团队传输高清视频素材等场景。 网络共享盘：虽然在天翼AI云电脑中的速度有一定上限，但它支持公网访问，适合混合云访问场景。如果企业员工需要在不同网络环境下（如公网环境）随时随地访问共享文件，网络共享盘能够满足这种需求。例如，企业员工出差时需通过公网访问共享文件，网络共享盘可支持其随时随地访问与操作。 性能参数 功能项 网络共享盘 NAS共享盘 最大支持挂载数 1万台 1000台（天翼云电脑） 最大读写并发 1000 200 翼共享盘大小上限 30TB 30TB 单用户端最大上传速度（Windows） 30MB/S 40～50MB/S 单用户端最大下载速度（Windows） 30MB/S 50～60MB/S 单用户端最大上传速度（Linux） 暂不涉及 100MB/S 单用户端最大下载速度（Linux） 暂不涉及 150MB/S 翼共享盘文件夹数量上限 1万 5000 单个文件夹内文件数量上限 1万 1万 单路4K读延迟 15ms 7ms 单路4K写延迟 15ms 17ms 最大读吞吐 5Gb/s 5Gb/s 最大写吞吐 5Gb/s 5Gb/s 文件路径层级 路径长度限制238 路径长度限制238 注意 单用户端最大上传、下载速度为理论上限，受文件大小以及天翼AI云电脑资源池网络影响。

本节介绍IPSec VPN绑定跨域互联入云使用场景说明。 IPsec VPN与资源池VPC互通 图21 客户侧防火墙或其他VPN设备通过IPsec VPN与资源池A互通 客户办公区防火墙或其他VPN设备通过IPsec VPN与资源池A的VPC互通，创建IPsec VPN实例时只需把资源池的VPC加载到IPsec VPN实例，如图21 IPsec VPN绑定跨域互联 图22 客户侧防火墙或其他VPN设备通过IPsec VPN绑定跨域互联与跨资源池B互通 客户侧防火墙或其他VPN设备结合IPsec VPN通过跨域互联与跨资源池VPC互通，需要将IPsec VPN实例与相关跨域互联实例绑定并加载指定的VPC，如图22，客户办公区需要与跨资源池B的VPC1互通，则在IPsec VPN实例中绑定该跨域互联VPC1即可。

重试建议 可以有限重试的场景： 临时网络抖动。 截图短暂失败。 应用加载未完成。 文件尚未生成。 不建议盲目重试的场景： 删除文件。 覆盖写入文件。 点击提交、确认、支付等具有业务副作用的按钮。 已明确返回鉴权失败或权限不足。 排查信息 提交问题时建议提供以下信息： 调用时间。 租户信息或项目标识。 脱敏后的 AccessKey ID。 桌面编码。 sessionId。 接口名称和请求参数摘要。 错误码和错误信息。 必要的截图或日志。 请勿在工单、邮件或聊天工具中发送完整 AccessKey Secret。

本节介绍企业云网的简介。 企业云网是天翼云自研的一系列云网络产品，通过VPN，企业可以实现一站式快速上云，云上云下高效协同办公。 企业云网可以提供的主要功能有： 跨域互联 IPSece VPN iVPN app 云专线绑跨域互联

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

本节介绍Windows防火墙可以设置为关闭状态或者添加入站访问规则的操作流程。 Windows防火墙可以设置为关闭状态或者添加入站访问规则。 下面以Win10为例演示关闭Windows防火墙与设置具体的IP段的入站访问规则。 关闭Windows防火墙 1.打开Windows防火墙，点击“启用或关闭Windows防火墙”。 2.将Windows防火墙设置为关闭状态。 添加入站访问规则 1.打开Windows防火墙，进入“高级设置”； 2.新建入站规则； 3.选择自定义规则类型； 4.点击“作用域”，添加需要放行的远端地址； 5.点击“名称”，输入规则名称，点击“完成”即可。

本节介绍天翼云电脑电教室的功能简介。 功能概述 电教室是教育行业最典型的场景，天翼云电脑可统一控制、集中运维等优势非常适用于电教室场景。极域课堂管理系统能够协助教师进行课堂互动教学，提供多样化的课堂管理功能，从传统PC时代开始积累了大量的教育客户，是最广泛使用的课堂管理软件之一。结合电教室的使用场景，天翼云电脑推出了极域电教室方案，通过与极域联合研发，支持在云电脑中进行局域网广播、一键式批量控制终端、切换课程镜像。 功能特点 局域网广播：将教师云电脑画面通过局域网广播给学生，屏幕广播效果更加清晰、流畅。 一键式终端控制：在极域教师端一键式批量启动/关闭学生终端，终端控制更加便捷。 课程切换：在极域教师端批量切换学生课程镜像，课程切换更加简便、快捷。 使用场景 教育客户建设电教室，使用该方案进行日常教学。

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

Windows Installer服务被禁用解决办法 方法一： 1. 用鼠标右键点击【计算机】，再单击下拉菜单中的【管理】； 2. 在【计算机管理】的界面里单击【服务和应用程序】； 3. 单击【服务】； 4. 找到并点击【Windows Installer】，再点击【启动】生效该服务。 方法二： 1. 鼠标右键点击【开始】菜单，并单击【运行】； 2. 【运行】中输入【services.msc】，最后点击【确定】； 3. 找到并点击【Windows Installer】，再点击【启动】生效该服务。 提示“系统盘容量不足”怎么办？ 请查看本地计算机系统盘（Windows系统下一般默认为C盘）剩余空间情况，建议彻底删除垃圾文件或将文件迁移到其他磁盘，以释放系统盘空间，确保其剩余容量大于600M。

本节介绍白名单规则下有程序运行被阻止时,用户申请放行的流程。 申请放行 应用放行功能涉及审批流程，请先开通企业审批服务后使用该功能。开通及配置方法与上架审批相似，此处需先在“应用管理设置审批设置”开启应用放行审批，再前往审批流程流程配置中开通相应流程并设置审批人。 用户在桌面内运行不在白名单内的应用会被阻止并出现提示弹窗，可在弹窗中查看详情或发起申请。有多个程序被阻止时，可批量操作。 注： 1、当运行某款应用时出现未执行也未被阻止的无响应状况，可能已被Windows系统默认为风险拦截。遇此情况，右键该应用，并在在属性中解除Windows拦截即可。 2、绑定黑名单规则时，被阻止的应用不允许申请放行。 应用放行审批 申请人提交的应用放行申请，会展示在此列表下，审批人可逐条或批量处理；也可在客户端中进行审批，详细请见处理事项 。 结果通知 应用放行申请经审批人处理后，申请人会收到相关处理结果的通知。

本节介绍企业应用的创建流程。 企业管理员可以通过创建专属的企业应用，以满足员工日常办公需求。 应用列表展示了管理员添加的各类应用与菜单。管理员可在列表中查看应用的相关版本以及进行更多操作。 如需快速查找应用，可以在搜索框中输入应用名称进行搜索，也可通过应用分类或上架状态来筛选。 点击页面左上角“新增”按钮，在新增应用弹窗页面中填入完整的应用信息，即可创建新的应用。新增的应用只包含基础应用信息，不包含应用的版本，版本管理详细请见版本管理 。 注：应用不允许重名。

本节介绍天翼量子AI云电脑客户端中的AI云电脑与AI云手机管理操作。 卡片/列表视图切换 在桌面列表页左上角，点击“卡片/列表视图”切换图标，可进行卡片视图和列表视图切换，还可以查看AI云电脑账号有多少台AI云电脑。 卡片视图 列表视图 左侧列表支持展示用户账号下的AI云电脑和AI云手机 编辑桌面名称、复制桌面ID 点击桌面名称，可直接自定义桌面名称，按Enter即可确认；复制桌面ID，点击桌面ID后面的图标即可复制桌面ID。 进入AI云电脑/云智手机 在卡片/列表视图，点击“进入AI云电脑”按钮进入AI云电脑。

黑名单列表 管理员还可以在黑名单列表中手动添加需要加入黑名单的应用。

本节介绍应用市场的日志记录功能。 普通用户可以通过弹窗查看被阻止运行的程序记录，可以在页面上直接申请应用放行，并能查看申请处理进度。管理员则可以在弹窗中查看到其他用户的推荐、放行、上架等申请，并可以在弹窗处直接处理。 注：目前仅天翼AI云电脑电脑客户端（支持版本：Windows、Linux、Mac）支持消息弹窗 阻止记录 在此页面，可查看所有桌面内应用运行被阻止的记录。 申请记录 申请记录分为三种：程序放行、应用推荐和应用发布。 在程序放行页面，可查看所有桌面应用被阻止后申请放行的记录。 在应用推荐页面，可查看所有用户提交的企业应用的推荐记录。 在应用发布页面，可查看管理员用户提交的所有企业应用的上架申请记录

本节介绍跨区域互联的开通说明和开通步骤。 产品定义 跨域互联可为客户提供同租户下不同VPC相同资源池或跨资源池互通的能力。 应用场景 场景1：同一租户下A资源池VPC1与VPC2互通。 场景2：同一租户下A资源池VPC1与B资源池VPC1互通（需要开通跨域带宽）。 使用限制 在开通跨域互联前需确认：需互通的资源池和虚拟私有云（vpc）的相关信息。VPC开通详情可查看“管理虚拟私有云”的相关操作指引。 注意 所有互通的VPC子网不可重叠，且跨域互联只能绑定同一个租户下的VPC。 跨域互联开通步骤 （1）创建跨域互联 （2）加载其他VPC或者子网 （3）开通跨域带宽并设置域间带宽 （4）设置桌面安全组与Windows防火墙

本文演示一次完整的 SDK 调用流程:创建会话、执行桌面操作、创建文件、读取文件并关闭会话。 完整示例 plaintext import Client from '@ctyun/desktopagentsdk'; async function main() { const client new Client({ apiKey: process.env.AIUSEAPIKEY, apiSecret: process.env.AIUSEAPISECRET, desktopCode: process.env.AIUSEDESKTOPCODE, serviceURL: process.env.AIUSESERVICEURL ' }); let session null; try { session await client.createSession(); console.log('会话创建成功:', session.sessionId); await session.computer.screenshot(); await session.computer.movemouse({ x: 500, y: 300 }); await session.computer.clickmouse({ x: 500, y: 300 }); await session.computer.typetext({ text: 'Hello from AIuse SDK!' }); await session.filesystem.createdirectory({ path: 'C:/aiusertest' }); await session.filesystem.writefile({ path: 'C:/aiusertest/hello.txt', mode: 'overwrite', content: 'Hello from AIuse SDK' }); const fileResult await session.filesystem.readfile({ path: 'C:/aiusertest/hello.txt', offset: 0, length: 0 }); console.log('文件内容:', fileResult.data?.content); } catch (error) { console.error('操作失败:', error); } finally { if (session) { await session.close(); console.log('会话已关闭'); } } } main().catch(console.error); 运行前检查 已安装 Node.js 18 或以上版本。 已安装 @ctyun/desktopagentsdk。 环境变量 AIUSEAPIKEY、AIUSEAPISECRET、AIUSEDESKTOPCODE 已正确配置。 AccessKey 已关联目标云电脑。 目标云电脑在线。 实践建议 先截图确认桌面状态，再执行鼠标和键盘操作。 复杂 GUI 任务建议拆分为多个阶段，每个阶段记录结果。 文件操作建议使用独立任务目录，避免误覆盖业务文件。 异常场景下也要关闭会话。