前言¶

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 工具¶

按会话的云端 / 本地路由¶

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。