> ## 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-Hant/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-Hant/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-Hant/superun/integrations/superun-agent)
* [superun AI](/zh-Hant/superun/integrations/ai)
* [superun 檔案儲存](/zh-Hant/superun/integrations/storage)


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