文档
Computer 导出与迁移
把 Computer 搬到另一台机器——一个归档文件导出,一个归档文件导入。
Computer 的整套桌面——登录态、书签、下载与文件——都保存在一个 Docker 具名卷上。导出把整个卷打包成单个归档;导入在本机或另一台机器上还原。一个文件出去,一个文件进来。
文件都放在哪里
- 所有持久内容都在挂载于
/config的具名卷上(即桌面用户的家目录)。删掉容器是安全的;卷本身就是这台 Computer。 - 工作区约定:人类与 Bot 产出的文件放在
~/workspace(即/config/workspace)。每次启动都会在缺失时创建该目录;它在卷上,会随导出 → 导入一起迁移。浏览器状态则单独存放在~/.config/chromium下。 - 导出目录是宿主机上的路径:未配置时默认为
~/Desktop/BotHarness Exports(家目录没有 Desktop 时为~/BotHarness Exports),在 Settings → BotHarness → Computer 中有目录选择器时可以更改。归档文件出现在该目录;导入也只列出并接受该目录内的文件。
导出
- 打开 Settings → BotHarness → Computer。无需任何配置——导出目录已显示当前(默认)路径;有目录选择器时可以用**选择…**换一个目的地。
- 点击导出到…(或导出),选择目标目录并确认。Computer 会先优雅关闭浏览器、停止、打包卷,并在原本运行时重新启动;设置行会实时显示阶段与已用时。
- 完成后,提示会显示归档路径——一个带时间戳的
.tar文件。在没有可用选择器(目录固定)的部署上,文件夹还会自动在宿主机文件管理器中打开。
在另一台机器上导入
- 在目标机器上安装容器运行时(Docker 或 Colima)以及带 BotHarness 的 DeepSeek Harness;先把 profile 启动一次让 Computer 插件加载。
- 把
.tar归档拷过去(U 盘、scp、网络共享均可)。 - 在 Settings → BotHarness → Computer 里查看目标机器的导出目录(默认路径无需配置即可使用),并把归档放进该目录。
- 点击导入…,选中归档并确认。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 卡片会在其中自述挂载、画面阶段变化、重连与重试——画面异常时先看这里,而不是猜。