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