前言¶
DeepSeek Harness（DSH）裏的 Agent 默認跑在你本機進程裏：寫文件、開終端、改倉庫，權限和可見範圍都貼着當前環境。若你希望 Agent 在獨立 CPU、內存和持久工作區裏多輪執行命令、傳文件，甚至操作真實桌面，又不想把本機 checkout 當成「第二真相源」，就需要把「雲上的 Linux 機器」接進 Harness，並在會話層明確區分本地與雲端路由。
下面介紹社區插件 dsh-rayrun-computer（維護者 RayrunOS，分類爲客戶端）。它在 DSH 側邊欄裏創建、管理 Rayrun 雲電腦，用 noVNC 在頁面內打開遠程桌面，並通過一組 rayrun_* 工具把沙箱、命令、文件同步和整任務委派交給同一臺機器；Token 保存在 Harness vault，頁面側不直接拿到憑證。
這是什麼¶
dsh-rayrun-computer 把 Rayrun 雲電腦嵌進 DeepSeek Harness：側邊欄嚮導創建 Linux 實例，內聯或新窗口打開桌面，或讓 Agent 在機器上跑非交互命令、傳文件、截圖點按桌面、在機器內再跑一層 Agent 任務。設計原則是 local-first——本地 checkout 仍是來源；push 以 git bundle 加固 dirty/untracked，兩側比對 patch 的 SHA-256；pull 只把雲端 diff 寫到 .dsh/incoming/<timestamp>/，不自動合併進工作區。
插件在 README 中標註已在 DeepSeek Harness 0.2.1-rc.5 上測試（桌面應用或 dsh web）；許可證 MIT（package.json 版本 1.0.0）。機器來自 rayrunos.com，按秒計費；側邊欄頭部顯示餘額與總機時。
核心功能¶
側邊欄雲電腦¶
通過嚮導選擇鏡像、vCPU、內存；若機器內 Agent 要調模型，可配置模型憑證。支持啓動、暫停、恢復、關機、重命名、銷燬。卡片展示狀態、鏡像、規格、IP 與機時。
頁面內真實桌面¶
創建時開啓 remote desktop 的機器會暴露 noVNC 端口，可內聯、新窗口或全屏打開；一鍵查看 VNC 密碼。部分鏡像空 /etc/hosts 會導致 websockify WebSocket 1011，插件在桌面連接時會自動修復。
Agent 工具¶
| 工具 | 作用 |
|---|---|
rayrun_sandbox |
創建、列表、 inspect、啓停、暫停、恢復、銷燬 |
rayrun_exec |
非交互命令（/bin/sh -c 或 argv），返回退出碼與 stdout/stderr |
rayrun_desktop |
X11 桌面截圖，再點擊、輸入、按鍵或滾動 |
rayrun_files |
列出、上傳、下載機器工作區文件 |
rayrun_agent |
把整任務交給機器內 Agent 並等待流式結果 |
rayrun_dsh |
worker 層 sync/status/delegate；或 start + result 異步委派 |
rayrun_workspace |
校驗後 push 本地 checkout；pull 雲端 diff 供審閱 |
按會話的雲端 / 本地路由¶
Composer 裏的切換是真實路由而非提示詞：雲端模式下宿主會拒絕本地 pwsh / bash / write / edit，避免 Agent 悄悄在本機幹活；只讀類工具仍可用於審閱。
登錄與 Token¶
支持用戶名密碼或微信登錄（微信僅 Chrome/Edge）；插件爲你創建 API Token 並存入 Harness vault，僅宿主側持有。頁面通過同源 /plugins/rayrun/rpc 通信，不接收 Token；密碼僅駐內存。
可選行爲¶
任務結束後可按空閒時間自動 stop（不 destroy）；頁面可在一版新 bundle 發佈後更新。Bundle 默認在 cordis.patch.yml，可在 profile 裏按需覆蓋。
安裝與啓用¶
依賴（來自 README Quick start）：
- DeepSeek Harness
0.2.1-rc.5（桌面或dsh web） - Rayrun 賬號
- 微信登錄時需 Chrome 或 Edge
當前 尚未發佈到 npm，需從源碼目錄安裝。README 給出的步驟如下。
1、獲取插件目錄（官方 README 示例）：
git clone https://github.com/RayrunOS/dsh-rayrun-computer.git
2、在 DSH 裏添加該目錄的絕對路徑：Plugins → Add plugin，或終端：
dsh plugin --profile web add /abs/path/dsh-rayrun-computer
桌面應用與 dsh web 使用不同 profile（desktop 與 web），請裝到你實際打開的那一側。
3、重啓 DSH（客戶端部分僅在頁面啓動時加載）。
4、打開 Cloud Computer → Connection settings，用 Rayrun 賬號登錄或粘貼 API Token。
5、New computer → 選鏡像、至少 2 GB 內存、開啓 remote desktop → Create and open（約 15 秒）。
自檢：讓 Agent 列出機器；無 Token 時應返回 token_required，而不是假裝已完成操作。更多路徑與排錯見倉庫 installation guide。
典型用法¶
配置片段¶
在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 中可覆蓋 bundle 默認值（鍵名以 usage 手冊 爲準）：
- id: rayrun-cloud
name: 'dsh-rayrun-computer'
config:
sandboxName: dsh-workspace
idle_stop_minutes: 15 # 空閒 stop，不 destroy
egress_allow: # 新機默認無出站網絡
- api.deepseek.com
Worker 層與同步¶
可將 DSH worker 層推入機器 headless profile 並用 hash 校驗；用 rayrun_dsh 的 delegate 帶目標與驗收條件委派任務，多輪取回結果。工作區用 rayrun_workspace 的 push/pull 與本地-first 規則配合。
文檔索引¶
詳細說明以中文文檔爲主：Usage manual（桌面、路由、同步、委派、配置與工具）；Parity design 說明雲 worker 層設計。
適用場景與注意¶
適合： 需要在隔離 Linux 環境跑 Agent 命令與文件操作、偶爾要肉眼確認 GUI（noVNC）、並希望 push/pull 可校驗、會話級強制走雲端的 DSH 用戶。
務必知曉：
destroy不可恢復，機器與工作區一併刪除。- 默認無出站網絡，須在
egress_allow中列出允許訪問的主機。 - 雲鏡像已是 root，且無 bubblewrap；worker 層用
danger-full-access變通以啓用 shell——這是權宜之計，不是強隔離。 - Bundle 宿主代碼在 DSH 進程內運行；安裝前請自行審閱源碼與 MIT 許可證，僅信任來源。
社區插件目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係；DSH 生態是「一切皆插件」，目錄爲獨立站點。
結尾¶
dsh-rayrun-computer 把 Rayrun 雲電腦、noVNC 桌面和 rayrun_* 工具收進 DSH 側邊欄與會話路由，在 local-first 同步規則下讓 Agent 在遠端 Linux 上持續幹活。進一步瞭解可訪問目錄頁 skillhub.cn/plugins/RayrunOS/dsh-rayrun-computer 與源碼 github.com/RayrunOS/dsh-rayrun-computer。
