DeepSeekBot

文档

Computer 导出与迁移

把 Computer 搬到另一台机器——一个归档文件导出,一个归档文件导入。

Computer 的整套桌面——登录态、书签、下载与文件——都保存在一个 Docker 具名卷上。导出把整个卷打包成单个归档;导入在本机或另一台机器上还原。一个文件出去,一个文件进来。

文件都放在哪里

  • 所有持久内容都在挂载于 /config 的具名卷上(即桌面用户的家目录)。删掉容器是安全的;卷本身就是这台 Computer。
  • 工作区约定:人类与 Bot 产出的文件放在 ~/workspace(即 /config/workspace)。每次启动都会在缺失时创建该目录;它在卷上,会随导出 → 导入一起迁移。浏览器状态则单独存放在 ~/.config/chromium 下。
  • 导出目录是宿主机上的路径:未配置时默认为 ~/Desktop/BotHarness Exports(家目录没有 Desktop 时为 ~/BotHarness Exports),在 Settings → BotHarness → Computer 中有目录选择器时可以更改。归档文件出现在该目录;导入也只列出并接受该目录内的文件。

导出

  1. 打开 Settings → BotHarness → Computer。无需任何配置——导出目录已显示当前(默认)路径;有目录选择器时可以用**选择…**换一个目的地。
  2. 点击导出到…(或导出),选择目标目录并确认。Computer 会先优雅关闭浏览器、停止、打包卷,并在原本运行时重新启动;设置行会实时显示阶段与已用时。
  3. 完成后,提示会显示归档路径——一个带时间戳的 .tar 文件。在没有可用选择器(目录固定)的部署上,文件夹还会自动在宿主机文件管理器中打开。

在另一台机器上导入

  1. 在目标机器上安装容器运行时(Docker 或 Colima)以及带 BotHarness 的 DeepSeek Harness;先把 profile 启动一次让 Computer 插件加载。
  2. 把 .tar 归档拷过去(U 盘、scp、网络共享均可)。
  3. 在 Settings → BotHarness → Computer 里查看目标机器的导出目录(默认路径无需配置即可使用),并把归档放进该目录。
  4. 点击导入…,选中归档并确认。Computer 会重建卷、解包并启动——登录态、书签和 ~/workspace 里的文件都会回来。

浏览器下载与上传

在 Web 部署(没有目录选择器、打不开宿主文件夹)下,传输走浏览器而不是宿主路径:

  • 导出完成后点下载,经浏览器保存对话框取回——流式传输,约 1 GB 的文件不会驻留内存。导出目录仍作为服务端列表位置。
  • 导入时选择归档文件…挑选本地 .tar,再点授权并导入流式上传并执行标准导入。长文件名会截断省略显示,悬停可见全名;上传字节到齐后才会替换同名旧归档。

体积与耗时预期

  • 归档是卷内容的未压缩 tar。正常使用后卷通常在 1 GB 左右(浏览器配置、缓存与工作区文件);可查看生成的文件大小,或用 docker system df -v 查看在线卷。
  • 在开发机上,约 1 GB 的本地导出与导入通常各需不到一分钟(受磁盘限制;导入还会校验固定镜像已存在)。

把归档当作机密对待

归档里含 Computer 的 Cookie 与已保存的登录态——敏感度等同浏览器配置备份,请相应地存放与传输。它是 profile 级的导出面,永远不并入 PersonaBot 导出。

查看开发者诊断

GET /api/computer/diagnostics 返回有界的生命周期、容器与 viewer 事件日志(新的在后)。viewer 卡片会在其中自述挂载、画面阶段变化、重连与重试——画面异常时先看这里,而不是猜。

参见

  • ADR-0052 —— 存储留在具名卷上;可携带性是显式导出。
  • ADR-0062 —— 导出前静默浏览器与 ~/workspace 约定。

在 GitHub 查看原文