AI 工作区数据管理 TL;DR

本文档提供了管理 AI 工作区生命周期的快速参考，包括使用单行引导脚本进行备份、恢复、迁移和卸载。

setup-ai-workspace-all-in-one.sh 脚本作为一个强大的编排器。你可以使用 -- 或 -s 在 bash 管道的末尾传递特殊的子命令。

1. 备份 (Backup)

创建整个工作区（金库密钥、LiteLLM 数据库、QMD 记忆、会话状态和插件配置）的 AES-256 加密归档。

默认备份: （默认将备份到 ~/ai_workspace_backup.tar.gz.enc）

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- backup

自定义输出路径:

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- backup --output /data/my_cold_backup.tar.gz.enc

2. 恢复 (Restore)

从冷备份归档中恢复 AI 工作区。这将会无缝地把金库 K/V 机密、PostgreSQL 数据库状态以及所有配置设置重新注入到一个工作环境中。

默认恢复: （默认查找 ~/ai_workspace_backup.tar.gz.enc）

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- restore

自定义输入路径:

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- restore --input /data/my_cold_backup.tar.gz.enc

3. 跨主机迁移 (Migrate)

使用安全的 SSH 路径 (rsync) 和 qmd sync，将 AI 工作区从远程节点无缝迁移并合并到本地机器。这会在保持远程主机非破坏性状态的同时，将状态、向量索引和记忆网络带到本地主机。

从远程用户/主机迁移:

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- migrate --source ubuntu@openclaw.svc.plus

(在运行此命令之前，请确保你拥有免密 SSH，或者已为 ubuntu@openclaw.svc.plus 加载了活动的代理)。

4. 卸载清理 (Uninstall)

卸载 AI 工作区组件和配置。

标准卸载: （停止服务并移除二进制文件，但保持数据缓存完整）

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall

清除卸载: （停止服务并销毁所有数据库、缓存、配置和用户状态。请极度谨慎使用！）

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall --purge

技术说明

安全性: 备份归档高度敏感。它们包含金库导出的机密和 LiteLLM 数据库转储。它们会通过使用部署的对称密钥（Vault Password 或 AI_WORKSPACE_AUTH_TOKEN）经 AES-256-CBC 自动加密。
依赖关系: 迁移、备份和恢复例程会在执行其特定的 Ansible 负载之前，自动确保相关依赖（如 PostgreSQL 和 Vault 服务）已完全运行。

3.3 KiB Raw Permalink Blame History Unescape Escape