> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# superun 云电脑

> 为应用接入可查看、可操作的 Linux 云电脑，支持远程桌面、命令执行和智能体控制，使用算力值统一结算。

## 这是什么

「superun 云电脑」为你的应用提供一台运行在云端的 Linux 电脑。用户可以在应用里查看和操作桌面、使用浏览器、处理文件，也可以把任务交给智能体完成。

在项目对话中描述需求，superun 会帮你接入云电脑、编写后端逻辑并搭建对应界面。例如：

```text theme={null}
给我的应用加一个云电脑功能。用户能创建自己的电脑、打开桌面操作浏览器，
查看电脑状态，并在不用时删除。
```

适合需要浏览器操作、桌面软件或命令执行的应用，也能与 [superun 通用智能体](/zh-Hans/superun/integrations/superun-agent) 配合，让智能体在电脑里执行任务。

***

## 启用与实例管理

打开项目，进入 **研发 → 技能库**，找到 **「superun 云电脑」**。也可以直接在项目对话中要求接入，由 superun 完成必要的启用和代码搭建。

启用后，插件页面提供项目内的实例管理：

* **创建实例**：选择规格并设置运行时限。
* **查看实例**：查看实例状态和 CPU、内存、硬盘规格，按状态筛选；列表默认展示运行中的实例。
* **打开桌面**：进入已有实例的桌面预览并操作。
* **查看详情**：通过时间轴查看运行、浅休眠和深休眠等阶段；悬停查看对应时段的算力值。
* **删除实例**：销毁不用的实例。
* **消费明细**：查看已结算的云电脑算力值消耗。

这是项目维护者的管理入口。应用用户看到的电脑列表、桌面界面和操作权限，由 superun 根据你的产品需求搭建。插件页面不提供模板创建或编辑。

***

## 把云电脑放进应用

告诉 superun 哪些用户能使用电脑、每台电脑归谁，以及需要哪些操作。例如：

```text theme={null}
为每位登录用户绑定自己的云电脑。页面左侧展示电脑列表，右侧展示远程桌面。
用户只能查看和操作自己的电脑，支持创建、删除和查看状态。
```

应用可以分成两个区域：**管理区**负责创建、查看、续期、休眠、恢复和删除；**工作区**负责桌面操作、浏览器、文件和命令执行。可以按需组合，不必把全部管理功能展示给终端用户。

平台中的预览入口不会自动成为你应用里的页面；应用内的桌面预览和交互由 superun 按你的需求实现。

***

## 选择电脑控制方式

| 方式 | 怎么使用 | 需要开启什么 |
| - | - | - |
| 直接操作 | 用户在远程桌面上操作，或应用通过 SDK 执行指定动作 | 云电脑 |
| 通用智能体控制 | 应用里的通用智能体通过工具观察和操作电脑 | 云电脑、通用智能体 |
| 云电脑内的 DSH 控制 | 把自然语言任务交给电脑内预装的 DSH，由它执行并返回进度和结果 | 云电脑、superun AI；由通用智能体委派时还需开启通用智能体 |

### 让通用智能体操作电脑

例如：

```text theme={null}
让应用里的通用智能体操作用户选中的云电脑：打开浏览器、填写表单，
用户能在右侧桌面看到操作过程。
```

智能体优先读取软件的界面结构来识别和操作控件；遇到无法读取的控件，再使用截图、鼠标和键盘操作。不同软件的支持程度不同，应使用实际业务软件验证效果。

### 推荐：通过 DSH 交付电脑任务

DSH（DeepSeek Harness）是预装在云电脑里的智能体框架。应用可以向它交付任务，获取任务 ID，继续对话、查看进度或等待结果。例如：

```text theme={null}
用云电脑里预装的 DSH 做一个电脑助手。用户描述要完成的任务，
页面展示任务进度、最终结果和远程桌面，并支持继续对话或取消任务。
我选择 DSH 方案，接受它额外产生的 superun AI 模型费用。
```

<Warning>
  DSH 方案需要先开启 [superun AI](/zh-Hans/superun/integrations/ai)。除云电脑费用外，还会额外消耗 DSH 调用模型的算力值；已有通用智能体的费用也照常计算。superun 会说明区别，由你选择是否使用 DSH。
</Warning>

DSH 适合由自然语言驱动的电脑任务。只需要远程桌面或固定 SDK 动作时，可以选择直接控制，不额外引入 DSH 的模型调用。其他智能体框架也可以接入云电脑，并不限于 superun 通用智能体。

***

## 运行时限、休眠与数据

* **运行时限是生命周期倒计时**，不是无操作时长。打开桌面或持续执行命令不等于自动续期；需要长期使用时，让 superun 实现续期策略。
* **休眠和删除不同**：休眠用于保留状态后恢复；删除会销毁实例。重要文件应先保存到应用的持久存储中。
* **休眠不等于免费**：运行、浅休眠和深休眠的计费方式不同，深休眠仍有快照存储费用。
* **关闭页面不等于停止电脑**：不用时应按需休眠或删除；关闭插件也不代替实例销毁。

如需“闲置一段时间自动休眠、再次使用时恢复”，请在需求中明确说明，由 superun 在应用后端实现。

***

## 怎么计费与查账

云电脑按实例规格、实际所处阶段和持续时间消耗 **算力值**，与平台其他服务统一结算。通常每小时结算一次，销毁等关键状态变更会触发结算。

查看费用时：

* 在插件的 **消费明细** 中查看已结算的消耗。
* 在实例 **详情** 的时间轴中查看不同阶段及对应时段的算力值。

<Note>
  消费明细和时间轴中的费用可能存在结算延迟。刚创建或状态刚变化时，尚未展示消耗不代表免费；以最终结算记录为准。
</Note>

***

## 常见问题

<AccordionGroup>
  <Accordion title="通用智能体也有沙箱，为什么还需要云电脑？">
    通用智能体自带的沙箱随会话启停，适合在对话中运行代码、处理文件等任务。云电脑的生命周期可以独立管理：按需续期、休眠、恢复或删除，更适合需要保留工作环境、分多次继续的复杂长期任务。你也可以让通用智能体操作同一台云电脑，在后续会话中继续工作。云电脑仍需管理运行时限和费用，并不代表永久运行或无限保留。
  </Accordion>

  <Accordion title="必须使用智能体吗？">
    不需要。可以只提供人工操作的远程桌面，也可以通过 SDK 实现指定动作。需要自然语言控制时，再选择通用智能体或 DSH 接入方案。
  </Accordion>

  <Accordion title="启用云电脑后，应用就自动有电脑页面了吗？">
    不会。启用提供服务能力和项目内管理入口；应用中的电脑页面、用户归属和权限，需要在项目对话中要求 superun 实现。
  </Accordion>

  <Accordion title="需要把访问密钥放在前端吗？">
    不需要。云电脑连接凭证由应用的 Supabase 后端使用。接入 DSH 时，再通过应用后端代理模型调用；平台模型密钥不放进云电脑。主机内使用的业务凭证仍可能被有系统权限的用户或工具读取，应按业务限制其权限和范围。
  </Accordion>

  <Accordion title="能管理或上传自己的桌面模板吗？">
    当前插件页面只提供实例管理，不提供模板操作。可选择的规格和环境以产品内实际提供的内容为准。
  </Accordion>
</AccordionGroup>

具体接口和代码示例，启用云电脑后由 superun 读取配套技能完成接入。

## 相关文档

* [superun 通用智能体](/zh-Hans/superun/integrations/superun-agent)
* [superun AI](/zh-Hans/superun/integrations/ai)
* [superun 文件存储](/zh-Hans/superun/integrations/storage)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.