update

BACKUP_RECOVERY_GUIDE.md

@@ -0,0 +1,363 @@
+# OCNGX 备份和恢复方案
+
+## 概述
+
+OCNGX（OpenCode + Nginx）备份和恢复方案支持在同一个版本的不同 HuggingFace Space 之间进行无缝迁移。该方案确保数据完整性、配置一致性和服务连续性。
+
+## 系统架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     OCNGX System                          │
+├─────────────────────────────────────────────────────────────┤
+│  Frontend (Nginx:7860) │ Backend (OpenCode:3000)           │
+├─────────────────────────────────────────────────────────────┤
+│  配置文件                    │ 用户数据                      │
+│  - opencode.json            │ - projects/                   │
+│  - nginx/配置              │ - sessions/                   │
+│  - AGENT.md                 │ - config/                     │
+│  - 启动脚本                 │ - cache/                      │
+├─────────────────────────────────────────────────────────────┤
+│  运行时数据                   │ 日志                         │
+│  - 进程状态                 │ - nginx日志                   │
+│  - 网络连接                 │ - opencode日志                │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 备份内容
+
+### 1. 核心配置文件
+- `opencode.json` - OpenCode 主配置
+- `AGENT.md` - 系统代理配置
+- `docker-start.sh` - 容器启动脚本
+- `Dockerfile` - 容器构建文件
+- `nginx/` - Nginx 配置目录
+- `cron-jobs/` - 定时任务配置
+
+### 2. OpenCode 数据
+- `~/.opencode/projects/` - 项目数据
+- `~/.opencode/sessions/` - 会话数据
+- `~/.opencode/config/` - 用户配置
+- `~/.opencode/cache/` - 缓存数据
+- `~/.opencode/logs/` - 运行日志
+
+### 3. 运行时状态
+- 当前运行的进程信息
+- 网络连接状态
+- 最近的系统日志
+
+### 4. 元数据
+- 备份时间戳
+- 环境信息
+- 系统版本信息
+- 磁盘使用情况
+
+## 使用指南
+
+### 1. 快速开始
+
+#### 创建备份
+```bash
+# 执行完整备份
+./backup-scripts/backup.sh
+
+# 查看备份文件
+ls -la /var/backups/ocngx/
+```
+
+#### 恢复系统
+```bash
+# 恢复到新环境
+./backup-scripts/restore.sh /path/to/backup.tar.gz
+
+# 强制覆盖现有配置
+./backup-scripts/restore.sh --force backup.tar.gz
+
+# 跳过配置文件恢复
+./backup-scripts/restore.sh --skip-config backup.tar.gz
+```
+
+### 2. 部署到新环境
+
+#### 自动配置部署环境
+```bash
+# 自动检测并配置当前环境
+source deploy-config.sh
+configure_for_deployment
+
+# 验证配置
+verify_configuration
+```
+
+#### 手动部署到 HuggingFace Spaces
+```bash
+# 1. 克隆项目到新 Space
+git clone <项目地址> .
+cd <项目目录>
+
+# 2. 配置环境变量
+export SPACE_ID="your-space-name"
+export ADMIN_USERNAME="your-admin-user"
+export ADMIN_PASSWORD="your-admin-password"
+
+# 3. 自动配置
+source deploy-config.sh
+configure_for_deployment
+
+# 4. 恢复数据（如果有备份）
+./backup-scripts/restore.sh backup.tar.gz
+
+# 5. 启动服务
+docker-compose up -d
+```
+
+### 3. 使用 Docker Compose
+
+#### 启动完整服务
+```bash
+# 使用默认配置启动
+docker-compose up -d
+
+# 使用自定义环境变量
+OPENCODE_PUBLIC_URL=https://your-space.hf.space \
+docker-compose up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看日志
+docker-compose logs -f ocngx
+```
+
+#### 配置外部备份存储
+```bash
+# 创建 .env 文件
+cat >> .env << EOF
+BACKUP_S3_BUCKET=your-backup-bucket
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+AWS_DEFAULT_REGION=us-east-1
+EOF
+
+# 启动包含备份服务的完整系统
+docker-compose up -d
+```
+
+## 迁移流程
+
+### 从 Source Space 到 Target Space
+
+```bash
+# 1. 在 Source Space 创建备份
+ssh source-space
+./backup-scripts/backup.sh
+
+# 2. 下载备份文件
+scp user@source-space:/var/backups/ocngx/latest.tar.gz ./
+
+# 3. 在 Target Space 准备环境
+git clone <项目仓库> target-space
+cd target-space
+export SPACE_ID="target-space-name"
+
+# 4. 配置新环境
+source deploy-config.sh
+configure_for_deployment
+
+# 5. 恢复数据
+./backup-scripts/restore.sh latest.tar.gz
+
+# 6. 启动服务
+docker-compose up -d
+
+# 7. 验证迁移
+curl https://target-space.hf.space/health
+```
+
+## 备份策略
+
+### 自动备份
+- **���率**: 每日凌晨 2:00
+- **保留**: 最近 10 个备份
+- **压缩**: gzip 压缩
+- **校验**: SHA256 校验和
+
+### 手动备份
+```bash
+# 立即备份
+./backup-scripts/backup.sh
+
+# 指定备份目录
+BACKUP_DIR=/custom/backup/path ./backup-scripts/backup.sh
+```
+
+### 外部存储集成
+支持自动上传到 S3 存储：
+```bash
+# 配置 S3 环境变量
+export BACKUP_S3_BUCKET="my-backup-bucket"
+export AWS_ACCESS_KEY_ID="your-key"
+export AWS_SECRET_ACCESS_KEY="your-secret"
+
+# 备份时自动上传
+./backup-scripts/backup.sh
+```
+
+## 故障恢复
+
+### 恢复损坏的配置
+```bash
+# 恢复最近的备份
+./backup-scripts/restore.sh --force /var/backups/ocngx/latest.tar.gz
+
+# 重启服务
+docker-compose restart ocngx
+```
+
+### 数据库损坏恢复
+```bash
+# 只恢复数据，跳过配置
+./backup-scripts/restore.sh --skip-config backup.tar.gz
+
+# 手动恢复特定数据
+tar -xzf backup.tar.gz '*/opencode_data/*' -C /
+```
+
+### 回滚到之前版本
+```bash
+# 查看可用备份
+ls -la /var/backups/ocngx/
+
+# 恢复到指定版本
+./backup-scripts/restore.sh /var/backups/ocngx/ocngx_backup_20240101_120000.tar.gz
+```
+
+## 监控和维护
+
+### 健康检查
+```bash
+# 检查服务状态
+curl http://localhost:7860/health
+
+# 检查 OpenCode 状态
+curl http://localhost:3000/global/health
+
+# 检查备份状态
+./backup-scripts/backup.sh --dry-run
+```
+
+### 日志监控
+```bash
+# Nginx 日志
+tail -f logs/nginx/access.log
+tail -f logs/nginx/error.log
+
+# OpenCode 日志
+tail -f ~/.opencode/logs/opencode.log
+
+# 备份日志
+tail -f logs/backup.log
+```
+
+### 磁盘空间管理
+```bash
+# 查看备份占用空间
+du -sh /var/backups/ocngx/
+
+# 清理旧备份
+find /var/backups/ocngx -name "*.tar.gz" -mtime +30 -delete
+
+# 查看系统磁盘使用
+df -h
+```
+
+## 安全考虑
+
+### 敏感数据处理
+- 备份中不包含密码明文
+- 环境变量中的敏感信息会被过滤
+- 建议使用外部密钥管理服务
+
+### 访问控制
+```bash
+# 设置备份文件权限
+chmod 600 /var/backups/ocngx/*.tar.gz
+
+# 限制恢复脚本执行权限
+chmod 700 backup-scripts/restore.sh
+```
+
+### 网络安全
+- 备份传输使用加密通道
+- S3 上传使用服务器端加密
+- 定期轮换访问密钥
+
+## 故障排除
+
+### 常见问题
+
+#### 1. 备份失败
+```bash
+# 检查磁盘空间
+df -h
+
+# 检查文件权限
+ls -la /var/backups/
+
+# 查看详细错误
+./backup-scripts/backup.sh --debug
+```
+
+#### 2. 恢复失败
+```bash
+# 验证备份文件完整性
+sha256sum -c backup.tar.gz.sha256
+
+# 检查目标环境
+./backup-scripts/restore.sh --dry-run backup.tar.gz
+
+# 强制恢复
+./backup-scripts/restore.sh --force backup.tar.gz
+```
+
+#### 3. 服务启动失败
+```bash
+# 检查配置文件
+docker-compose config
+
+# 查看容器日志
+docker-compose logs ocngx
+
+# 重新构建容器
+docker-compose up -d --build
+```
+
+## 最佳实践
+
+### 1. 定期测试恢复
+```bash
+# 每月测试一次恢复流程
+./backup-scripts/backup.sh
+./backup-scripts/restore.sh --test /var/backups/ocngx/latest.tar.gz
+```
+
+### 2. 版本控制
+```bash
+# 记录每次重要变更
+git tag -a "v1.0.0-backup" -m "Backup before migration"
+```
+
+### 3. 文档更新
+- 记录每次迁移过程
+- 更新配置变更
+- 维护故障处理文档
+
+## 技术支持
+
+如遇到问题，请提供以下信息：
+1. 错误日志
+2. 系统环境信息
+3. 备份文件元数据
+4. 具体操作步骤
+
+联系支持：创建 Issue 并附上相关日志文件。

backup-scripts/backup.sh

@@ -0,0 +1,238 @@
+#!/bin/bash
+
+# OCNGX 完整备份脚本
+# 支持多环境部署的数据备份和恢复
+
+set -euo pipefail
+
+# 配置变量
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BACKUP_DIR="${BACKUP_DIR:-/var/backups/ocngx}"
+BACKUP_DATE=$(date '+%Y%m%d_%H%M%S')
+BACKUP_ID="ocngx_backup_${BACKUP_DATE}"
+TEMP_BACKUP_DIR="/tmp/${BACKUP_ID}"
+
+# 环境检测
+detect_environment() {
+    echo "🔍 检测运行环境..."
+    
+    if [[ -f /.dockerenv ]]; then
+        ENVIRONMENT="docker"
+        echo "  🐳 Docker 容器环境"
+    elif [[ -d /app && -f /app/opencode.json ]]; then
+        ENVIRONMENT="huggingface"
+        echo "  🤗 HuggingFace Spaces 环境"
+    else
+        ENVIRONMENT="local"
+        echo "  💻 本地环境"
+    fi
+    
+    # 检测 OpenCode 安装位置
+    if command -v opencode &> /dev/null; then
+        OPENCODE_CMD="opencode"
+        OPENCODE_DATA_DIR="${HOME}/.opencode"
+    elif npm list -g opencode-ai &> /dev/null; then
+        OPENCODE_CMD="opencode"
+        OPENCODE_DATA_DIR="${HOME}/.opencode"
+    else
+        echo "  ❌ 未找到 OpenCode 安装"
+        exit 1
+    fi
+    
+    echo "  📂 OpenCode 数据目录: ${OPENCODE_DATA_DIR}"
+}
+
+# 创建备份目录
+prepare_backup() {
+    echo "📁 准备备份环境..."
+    
+    mkdir -p "$BACKUP_DIR"
+    mkdir -p "$TEMP_BACKUP_DIR"
+    
+    # 创建备份元数据
+    cat > "${TEMP_BACKUP_DIR}/backup_metadata.json" << EOF
+{
+    "backup_id": "${BACKUP_ID}",
+    "backup_date": "$(date -Iseconds)",
+    "environment": "${ENVIRONMENT}",
+    "hostname": "$(hostname)",
+    "opencode_version": "$(opencode --version 2>/dev/null || echo 'unknown')",
+    "system_info": {
+        "os": "$(uname -s)",
+        "arch": "$(uname -m)",
+        "kernel": "$(uname -r)"
+    },
+    "disk_usage": {
+        "total": "$(df -h / | awk 'NR==2 {print $2}')",
+        "used": "$(df -h / | awk 'NR==2 {print $3}')",
+        "available": "$(df -h / | awk 'NR==2 {print $4}')"
+    }
+}
+EOF
+}
+
+# 备份配置文件
+backup_configs() {
+    echo "⚙️ 备份配置文件..."
+    
+    local config_dir="${TEMP_BACKUP_DIR}/configs"
+    mkdir -p "$config_dir"
+    
+    # 备份项目配置文件
+    [[ -f "${SCRIPT_DIR}/opencode.json" ]] && cp "${SCRIPT_DIR}/opencode.json" "$config_dir/"
+    [[ -f "${SCRIPT_DIR}/AGENT.md" ]] && cp "${SCRIPT_DIR}/AGENT.md" "$config_dir/"
+    [[ -f "${SCRIPT_DIR}/docker-start.sh" ]] && cp "${SCRIPT_DIR}/docker-start.sh" "$config_dir/"
+    [[ -f "${SCRIPT_DIR}/Dockerfile" ]] && cp "${SCRIPT_DIR}/Dockerfile" "$config_dir/"
+    
+    # 备份 Nginx 配置
+    if [[ -d "${SCRIPT_DIR}/nginx" ]]; then
+        cp -r "${SCRIPT_DIR}/nginx" "$config_dir/"
+    fi
+    
+    # 备份 Cron 配置
+    if [[ -d "${SCRIPT_DIR}/cron-jobs" ]]; then
+        cp -r "${SCRIPT_DIR}/cron-jobs" "$config_dir/"
+    fi
+    
+    # 备份环境变量（排除敏感信息）
+    env | grep -E '^(OPENCODE_|PUBLIC_|BASE_|GATEWAY_)' > "$config_dir/environment.txt" 2>/dev/null || true
+    
+    echo "  ✅ 配置文件备份完成"
+}
+
+# 备份 OpenCode 数据
+backup_opencode_data() {
+    echo "🤖 备份 OpenCode 数据..."
+    
+    if [[ -d "$OPENCODE_DATA_DIR" ]]; then
+        local data_dir="${TEMP_BACKUP_DIR}/opencode_data"
+        mkdir -p "$data_dir"
+        
+        # 备份核心数据目录
+        for subdir in "projects" "sessions" "config" "cache" "logs"; do
+            if [[ -d "${OPENCODE_DATA_DIR}/${subdir}" ]]; then
+                cp -r "${OPENCODE_DATA_DIR}/${subdir}" "$data_dir/"
+                echo "  📦 已备份: $subdir"
+            fi
+        done
+        
+        # 备份全局配置文件
+        [[ -f "${OPENCODE_DATA_DIR}/config.json" ]] && cp "${OPENCODE_DATA_DIR}/config.json" "$data_dir/"
+        [[ -f "${OPENCODE_DATA_DIR}/preferences.json" ]] && cp "${OPENCODE_DATA_DIR}/preferences.json" "$data_dir/"
+        
+        echo "  ✅ OpenCode 数据备份完成"
+    else
+        echo "  ⚠️ OpenCode 数据目录不存在，跳过"
+    fi
+}
+
+# 备份运行时状态
+backup_runtime_state() {
+    echo "🔄 备份运行时状态..."
+    
+    local runtime_dir="${TEMP_BACKUP_DIR}/runtime"
+    mkdir -p "$runtime_dir"
+    
+    # 备份当前运行的进程信息
+    ps aux | grep -E "(opencode|nginx|openresty)" > "$runtime_dir/running_processes.txt" 2>/dev/null || true
+    
+    # 备份网络连接状态
+    netstat -tlnp 2>/dev/null | grep -E ":(3000|7860)" > "$runtime_dir/network_state.txt" || true
+    
+    # 备份最近的日志
+    if [[ -d "/var/log" ]]; then
+        find /var/log -name "*nginx*" -o -name "*opencode*" -mtime -7 -exec cp {} "$runtime_dir/" \; 2>/dev/null || true
+    fi
+    
+    echo "  ✅ 运行时状态备份完成"
+}
+
+# 创建备份归档
+create_archive() {
+    echo "🗜️ 创建备份归档..."
+    
+    local archive_file="${BACKUP_DIR}/${BACKUP_ID}.tar.gz"
+    
+    # 创建压缩归档
+    tar -czf "$archive_file" -C "/tmp" "$BACKUP_ID"
+    
+    # 验证归档
+    if [[ -f "$archive_file" ]]; then
+        local archive_size=$(du -h "$archive_file" | cut -f1)
+        echo "  ✅ 备份归档创建成功: ${archive_file} (${archive_size})"
+        
+        # 生成校验和
+        sha256sum "$archive_file" > "${archive_file}.sha256"
+        echo "  🔐 校验和已生成: ${archive_file}.sha256"
+    else
+        echo "  ❌ 备份归档创建失败"
+        exit 1
+    fi
+}
+
+# 清理旧备份
+cleanup_old_backups() {
+    echo "🧹 清理旧备份..."
+    
+    cd "$BACKUP_DIR"
+    
+    # 保留最近 10 个备份
+    local backup_count=$(ls -1 ocngx_backup_*.tar.gz 2>/dev/null | wc -l)
+    if [[ $backup_count -gt 10 ]]; then
+        echo "  🗑️ 删除超过 10 个的旧备份..."
+        ls -t ocngx_backup_*.tar.gz 2>/dev/null | tail -n +11 | while read -r old_backup; do
+            echo "    删除: $old_backup"
+            rm -f "$old_backup" "${old_backup}.sha256"
+        done
+    fi
+    
+    # 显示备份状态
+    local remaining_count=$(ls -1 ocngx_backup_*.tar.gz 2>/dev/null | wc -l)
+    local total_size=$(du -sh "$BACKUP_DIR" 2>/dev/null | cut -f1)
+    echo "  📊 当前备份状态: $remaining_count 个文件, 总大小: $total_size"
+}
+
+# 上传到外部存储（可选）
+upload_to_external() {
+    if [[ -n "${BACKUP_S3_BUCKET:-}" ]]; then
+        echo "☁️ 上传备份到 S3..."
+        
+        local archive_file="${BACKUP_DIR}/${BACKUP_ID}.tar.gz"
+        
+        if command -v aws &> /dev/null; then
+            aws s3 cp "$archive_file" "s3://${BACKUP_S3_BUCKET}/ocngx-backups/" --storage-class STANDARD_IA
+            aws s3 cp "${archive_file}.sha256" "s3://${BACKUP_S3_BUCKET}/ocngx-backups/"
+            echo "  ✅ S3 上传完成"
+        else
+            echo "  ⚠️ AWS CLI 未安装，跳过 S3 上传"
+        fi
+    fi
+}
+
+# 主函数
+main() {
+    echo "🚀 OCNGX 完整备份开始..."
+    echo "📅 备份时间: $(date '+%Y-%m-%d %H:%M:%S')"
+    echo "🆔 备份ID: ${BACKUP_ID}"
+    echo ""
+    
+    detect_environment
+    prepare_backup
+    backup_configs
+    backup_opencode_data
+    backup_runtime_state
+    create_archive
+    cleanup_old_backups
+    upload_to_external
+    
+    # 清理临时目录
+    rm -rf "$TEMP_BACKUP_DIR"
+    
+    echo ""
+    echo "✅ 备份完成!"
+    echo "📁 备份位置: ${BACKUP_DIR}/${BACKUP_ID}.tar.gz"
+    echo "🔍 验证命令: tar -tzf ${BACKUP_DIR}/${BACKUP_ID}.tar.gz | head -10"
+}
+
+# 执行主函数
+main "$@"

backup-scripts/restore.sh

@@ -0,0 +1,409 @@
+#!/bin/bash
+
+# OCNGX 恢复脚本
+# 用于在不同的 HuggingFace Space 上恢复 OCNGX 系统
+
+set -euo pipefail
+
+# 配置变量
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+# 参数解析
+BACKUP_FILE=""
+FORCE_RESTORE=false
+SKIP_CONFIG=false
+
+usage() {
+    echo "用法: $0 [选项] <备份文件>"
+    echo ""
+    echo "选项:"
+    echo "  -f, --force      强制恢复，覆盖现有配置"
+    echo "  -s, --skip-config 跳过配置文件恢复"
+    echo "  -h, --help       显示帮助信息"
+    echo ""
+    echo "示例:"
+    echo "  $0 /path/to/ocngx_backup_20240101_120000.tar.gz"
+    echo "  $0 --force ocngx_backup_20240101_120000.tar.gz"
+    exit 1
+}
+
+# 解析命令行参数
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -f|--force)
+            FORCE_RESTORE=true
+            shift
+            ;;
+        -s|--skip-config)
+            SKIP_CONFIG=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            ;;
+        -*)
+            echo "未知选项: $1"
+            usage
+            ;;
+        *)
+            if [[ -z "$BACKUP_FILE" ]]; then
+                BACKUP_FILE="$1"
+            else
+                echo "错误: 只能指定一个备份文件"
+                usage
+            fi
+            shift
+            ;;
+    esac
+done
+
+# 检查备份文件
+if [[ -z "$BACKUP_FILE" ]]; then
+    echo "❌ 错误: 必须指定备份文件"
+    usage
+fi
+
+if [[ ! -f "$BACKUP_FILE" ]]; then
+    echo "❌ 错误: 备份文件不存在: $BACKUP_FILE"
+    exit 1
+fi
+
+# 验证备份文件完整性
+verify_backup() {
+    echo "🔍 验证备份文件..."
+    
+    # 检查文件格式
+    if [[ ! "$BACKUP_FILE" =~ \.tar\.gz$ ]]; then
+        echo "❌ 错误: 备份文件格式不正确，应为 .tar.gz 文件"
+        exit 1
+    fi
+    
+    # 验证校验和（如果存在）
+    local checksum_file="${BACKUP_FILE}.sha256"
+    if [[ -f "$checksum_file" ]]; then
+        echo "🔐 验证校验和..."
+        if sha256sum -c "$checksum_file" >/dev/null 2>&1; then
+            echo "  ✅ 校验和验证通过"
+        else
+            echo "  ❌ 校验和验证失败，备份文件可能已损坏"
+            exit 1
+        fi
+    else
+        echo "  ⚠️ 未找到校验和文件，跳过验证"
+    fi
+    
+    # 检查归档内容
+    echo "📦 检查归档内容..."
+    if ! tar -tzf "$BACKUP_FILE" >/dev/null 2>&1; then
+        echo "❌ 错误: 备份文件无法正常解压"
+        exit 1
+    fi
+    
+    echo "  ✅ 备份文件验证通过"
+}
+
+# 检查环境
+check_environment() {
+    echo "🔍 检查恢复环境..."
+    
+    # 检查是否为 HuggingFace Spaces 环境
+    if [[ -d "/app" && -f "/app/opencode.json" ]]; then
+        echo "  🤗 HuggingFace Spaces 环境检测到"
+        RESTORE_TARGET="/app"
+    else
+        echo "  💻 本地环境，恢复到项目目录"
+        RESTORE_TARGET="$PROJECT_DIR"
+    fi
+    
+    echo "  📂 恢复目标: $RESTORE_TARGET"
+    
+    # 检查磁盘空间
+    local backup_size=$(du -h "$BACKUP_FILE" | cut -f1)
+    local available_space=$(df -h "$RESTORE_TARGET" | awk 'NR==2 {print $4}')
+    echo "  💾 备份大小: $backup_size, 可用空间: $available_space"
+}
+
+# 预检查
+pre_restore_checks() {
+    echo "⚠️ 执行恢复前检查..."
+    
+    # 检查关键文件是否存在
+    local critical_files=("$RESTORE_TARGET/opencode.json" "$RESTORE_TARGET/docker-start.sh")
+    for file in "${critical_files[@]}"; do
+        if [[ -f "$file" ]] && [[ "$FORCE_RESTORE" != true ]]; then
+            echo "  ⚠️ 发现现有配置: $file"
+            echo "     使用 --force 选项强制覆盖"
+            echo "     或使用 --skip-config 选项跳过配置恢复"
+            exit 1
+        fi
+    done
+    
+    # 检查 OpenCode 是否运行
+    if pgrep -f "opencode" >/dev/null 2>&1; then
+        echo "  ⚠️ 检测到 OpenCode 正在运行"
+        echo "     建议停止服务后再执行恢复"
+        read -p "是否继续? (y/N): " -n 1 -r
+        echo
+        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+            echo "恢复已取消"
+            exit 0
+        fi
+    fi
+    
+    echo "  ✅ 预检查完成"
+}
+
+# 创建临时恢复目录
+prepare_restore() {
+    echo "📁 准备恢复环境..."
+    
+    TEMP_RESTORE_DIR="/tmp/ocngx_restore_$(date +%s)"
+    mkdir -p "$TEMP_RESTORE_DIR"
+    
+    echo "  📂 临时目录: $TEMP_RESTORE_DIR"
+    
+    # 解压备份文件
+    echo "📦 解压备份文件..."
+    tar -xzf "$BACKUP_FILE" -C "$TEMP_RESTORE_DIR"
+    
+    # 查找备份根目录
+    BACKUP_ROOT=$(find "$TEMP_RESTORE_DIR" -name "ocngx_backup_*" -type d | head -1)
+    if [[ -z "$BACKUP_ROOT" ]]; then
+        echo "❌ 错误: 无法找到备份根目录"
+        exit 1
+    fi
+    
+    echo "  ✅ 备份解压完成: $BACKUP_ROOT"
+}
+
+# 显示备份信息
+show_backup_info() {
+    echo "📋 备份信息:"
+    
+    local metadata_file="$BACKUP_ROOT/backup_metadata.json"
+    if [[ -f "$metadata_file" ]]; then
+        echo "  🆔 备份ID: $(jq -r '.backup_id' "$metadata_file" 2>/dev/null || echo "未知")"
+        echo "  📅 备份时间: $(jq -r '.backup_date' "$metadata_file" 2>/dev/null || echo "未知")"
+        echo "  🌍 环境: $(jq -r '.environment' "$metadata_file" 2>/dev/null || echo "未知")"
+        echo "  🖥️ 主机名: $(jq -r '.hostname' "$metadata_file" 2>/dev/null || echo "未知")"
+        echo "  🤖 OpenCode版本: $(jq -r '.opencode_version' "$metadata_file" 2>/dev/null || echo "未知")"
+    else
+        echo "  ⚠️ 未找到备份元数据"
+    fi
+    echo ""
+}
+
+# 恢复配置文件
+restore_configs() {
+    if [[ "$SKIP_CONFIG" == true ]]; then
+        echo "⏭️ 跳过配置文件恢复"
+        return
+    fi
+    
+    echo "⚙️ 恢复配置文件..."
+    
+    local config_source="$BACKUP_ROOT/configs"
+    if [[ ! -d "$config_source" ]]; then
+        echo "  ⚠️ 未找到配置文件备份"
+        return
+    fi
+    
+    # 备份现有配置
+    if [[ "$FORCE_RESTORE" == true ]] && [[ -f "$RESTORE_TARGET/opencode.json" ]]; then
+        echo "  💾 备份现有配置..."
+        mkdir -p "$RESTORE_TARGET/.backup_$(date +%s)"
+        cp -r "$RESTORE_TARGET"/opencode.json "$RESTORE_TARGET"/docker-start.sh "$RESTORE_TARGET/.backup_$(date +%s)/" 2>/dev/null || true
+    fi
+    
+    # 恢复核心配置文件
+    local files_to_restore=("opencode.json" "AGENT.md" "docker-start.sh" "Dockerfile")
+    for file in "${files_to_restore[@]}"; do
+        if [[ -f "$config_source/$file" ]]; then
+            cp "$config_source/$file" "$RESTORE_TARGET/"
+            echo "  ✅ 已恢复: $file"
+        fi
+    done
+    
+    # 恢复 Nginx 配置
+    if [[ -d "$config_source/nginx" ]]; then
+        cp -r "$config_source/nginx"/* "$RESTORE_TARGET/nginx/" 2>/dev/null || true
+        echo "  ✅ 已恢复: Nginx 配置"
+    fi
+    
+    # 恢复 Cron 配置
+    if [[ -d "$config_source/cron-jobs" ]]; then
+        cp -r "$config_source/cron-jobs"/* "$RESTORE_TARGET/cron-jobs/" 2>/dev/null || true
+        echo "  ✅ 已恢复: Cron 配置"
+    fi
+    
+    echo "  ✅ 配置文件恢复完成"
+}
+
+# 恢复 OpenCode 数据
+restore_opencode_data() {
+    echo "🤖 恢复 OpenCode 数据..."
+    
+    local data_source="$BACKUP_ROOT/opencode_data"
+    if [[ ! -d "$data_source" ]]; then
+        echo "  ⚠️ 未找到 OpenCode 数据备份"
+        return
+    fi
+    
+    # 确定 OpenCode 数据目录
+    local opencode_data_dir="${HOME}/.opencode"
+    mkdir -p "$opencode_data_dir"
+    
+    # 恢复数据目录
+    for subdir in "projects" "sessions" "config" "cache" "logs"; do
+        if [[ -d "$data_source/$subdir" ]]; then
+            cp -r "$data_source/$subdir" "$opencode_data_dir/"
+            echo "  📦 已恢复: $subdir"
+        fi
+    done
+    
+    # 恢复配置文件
+    local config_files=("config.json" "preferences.json")
+    for file in "${config_files[@]}"; do
+        if [[ -f "$data_source/$file" ]]; then
+            cp "$data_source/$file" "$opencode_data_dir/"
+            echo "  ⚙️ 已恢复: $file"
+        fi
+    done
+    
+    # 设置正确的权限
+    chmod -R 755 "$opencode_data_dir" 2>/dev/null || true
+    
+    echo "  ✅ OpenCode 数据恢复完成"
+}
+
+# 更新环境配置
+update_environment_config() {
+    echo "🔄 更新环境配置..."
+    
+    # 检测当前 HuggingFace Space URL
+    if [[ -n "${SPACE_ID:-}" ]]; then
+        local space_url="https://${SPACE_ID}.hf.space"
+        echo "  🌐 检测到 HuggingFace Space URL: $space_url"
+        
+        # 更新 docker-start.sh 中的 URL 配置
+        local docker_start_file="$RESTORE_TARGET/docker-start.sh"
+        if [[ -f "$docker_start_file" ]]; then
+            sed -i.bak "s|https://[^.]*\.hf\.space|$space_url|g" "$docker_start_file"
+            echo "  ✅ 已更新 Space URL 配置"
+        fi
+    fi
+    
+    # 设置正确的文件权限
+    chmod +x "$RESTORE_TARGET/docker-start.sh" 2>/dev/null || true
+    chmod +x "$RESTORE_TARGET/cron-jobs"/*.sh 2>/dev/null || true
+    
+    echo "  ✅ 环境配置更新完成"
+}
+
+# 验证恢复结果
+verify_restore() {
+    echo "🔍 验证恢复结果..."
+    
+    local errors=0
+    
+    # 检查关键文件
+    local critical_files=(
+        "$RESTORE_TARGET/opencode.json"
+        "$RESTORE_TARGET/docker-start.sh"
+        "$RESTORE_TARGET/Dockerfile"
+        "$RESTORE_TARGET/nginx/conf.d/default.conf"
+    )
+    
+    for file in "${critical_files[@]}"; do
+        if [[ -f "$file" ]]; then
+            echo "  ✅ 存在: $file"
+        else
+            echo "  ❌ 缺失: $file"
+            ((errors++))
+        fi
+    done
+    
+    # 检查数据目录
+    local opencode_data_dir="${HOME}/.opencode"
+    if [[ -d "$opencode_data_dir" ]]; then
+        echo "  ✅ OpenCode 数据目录存在"
+    else
+        echo "  ⚠️ OpenCode 数据目录不存在"
+    fi
+    
+    if [[ $errors -eq 0 ]]; then
+        echo "  ✅ 恢复验证通过"
+    else
+        echo "  ❌ 恢复验证失败，发现 $errors 个错误"
+        return 1
+    fi
+}
+
+# 清理临时文件
+cleanup() {
+    echo "🧹 清理临时文件..."
+    rm -rf "$TEMP_RESTORE_DIR"
+    echo "  ✅ 清理完成"
+}
+
+# 显示恢复后说明
+show_post_restore_info() {
+    echo ""
+    echo "🎉 恢复完成!"
+    echo ""
+    echo "📋 后续步骤:"
+    echo "1. 🔄 重启服务以应用新配置:"
+    echo "   docker-compose down && docker-compose up -d"
+    echo ""
+    echo "2. 🔍 验证服务状态:"
+    echo "   curl http://localhost:7860/health"
+    echo ""
+    echo "3. 📖 检查 OpenCode 状态:"
+    echo "   curl http://localhost:3000/global/health"
+    echo ""
+    echo "4. 🌐 访问 Web 界面:"
+    echo "   http://localhost:7860"
+    echo ""
+    if [[ "$SKIP_CONFIG" == true ]]; then
+        echo "⚠️ 注意: 配置文件恢复已跳过，请手动检查配置"
+    fi
+    if [[ "$FORCE_RESTORE" == true ]]; then
+        echo "💾 原始配置已备份到 .backup_*/ 目录"
+    fi
+}
+
+# 主函数
+main() {
+    echo "🚀 OCNGX 恢复开始..."
+    echo "📂 备份文件: $BACKUP_FILE"
+    echo "📅 恢复时间: $(date '+%Y-%m-%d %H:%M:%S')"
+    echo ""
+    
+    verify_backup
+    check_environment
+    pre_restore_checks
+    prepare_restore
+    show_backup_info
+    restore_configs
+    restore_opencode_data
+    update_environment_config
+    
+    if verify_restore; then
+        cleanup
+        show_post_restore_info
+        echo ""
+        echo "✅ 恢复成功完成!"
+    else
+        echo ""
+        echo "❌ 恢复过程中发现问题，请检查上述错误信息"
+        cleanup
+        exit 1
+    fi
+}
+
+# 错误处理
+trap 'echo "❌ 恢复过程中发生错误"; cleanup; exit 1' ERR
+
+# 执行主函数
+main "$@"

deploy-config.sh

@@ -0,0 +1,288 @@
+# OCNGX 部署配置文件
+# 用于不同环境的部署配置
+
+# ============================================================================
+# 基础配置
+# ============================================================================
+
+# 应用基本信息
+APP_NAME="ocngx"
+APP_VERSION="1.0.0"
+
+# 端口配置
+NGINX_PORT=7860
+OPENCODE_PORT=3000
+
+# 认证配置
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=admin123
+
+# ============================================================================
+# 环境检测与配置
+# ============================================================================
+
+detect_deployment_environment() {
+    if [[ -n "${SPACE_ID:-}" ]]; then
+        echo "huggingface"
+    elif [[ -f /.dockerenv ]]; then
+        echo "docker"
+    else
+        echo "local"
+    fi
+}
+
+# 获取当前环境的 URL
+get_base_url() {
+    local env=$(detect_deployment_environment)
+    case $env in
+        "huggingface")
+            echo "https://${SPACE_ID}.hf.space"
+            ;;
+        "docker")
+            echo "http://localhost:${NGINX_PORT}"
+            ;;
+        "local")
+            echo "http://localhost:${NGINX_PORT}"
+            ;;
+        *)
+            echo "http://localhost:${NGINX_PORT}"
+            ;;
+    esac
+}
+
+# ============================================================================
+# HuggingFace Spaces 环境配置
+# ============================================================================
+
+generate_hf_space_config() {
+    cat > .space_config.yaml << EOF
+title: OCNGX - OpenCode with Nginx
+emoji: 🤖
+colorFrom: green
+colorTo: blue
+sdk: docker
+pinned: false
+hardware: cpu-basic
+secrets:
+  - ADMIN_USERNAME
+  - ADMIN_PASSWORD
+  - BACKUP_S3_BUCKET
+  - AWS_ACCESS_KEY_ID
+  - AWS_SECRET_ACCESS_KEY
+EOF
+}
+
+# ============================================================================
+# 环境变量生成
+# ============================================================================
+
+generate_env_file() {
+    local env=$(detect_deployment_environment)
+    local base_url=$(get_base_url)
+    
+    cat > .env << EOF
+# OCNGX 环境配置
+# 生成时间: $(date)
+# 环境: $env
+
+# 基础配置
+GATEWAY_HOST=127.0.0.1
+GATEWAY_PORT=$OPENCODE_PORT
+NGINX_PORT=$NGINX_PORT
+
+# 认证配置
+USERNAME=$ADMIN_USERNAME
+PASSWORD=$ADMIN_PASSWORD
+
+# URL 配置
+OPENCODE_PUBLIC_URL=$base_url
+PUBLIC_URL=$base_url
+BASE_URL=$base_url
+
+# 环境标识
+DEPLOYMENT_ENV=$env
+SPACE_ID=${SPACE_ID:-}
+
+# 备份配置
+BACKUP_DIR=/var/backups/ocngx
+BACKUP_S3_BUCKET=${BACKUP_S3_BUCKET:-}
+
+# 日志配置
+LOG_LEVEL=${LOG_LEVEL:-info}
+
+# HuggingFace 特定配置
+EOF
+
+    if [[ "$env" == "huggingface" ]]; then
+        cat >> .env << EOF
+# HuggingFace Spaces 特定配置
+HF_SPACE_ID=${SPACE_ID}
+HF_HOME=/data
+TRANSFORMERS_CACHE=/data/.cache
+EOF
+    fi
+}
+
+# ============================================================================
+# Nginx 配置生成
+# ============================================================================
+
+generate_nginx_config() {
+    local env=$(detect_deployment_environment)
+    local base_url=$(get_base_url)
+    
+    # 更新 default.conf 中的代理配置
+    if [[ -f nginx/conf.d/default.conf ]]; then
+        cp nginx/conf.d/default.conf nginx/conf.d/default.conf.bak
+        
+        # 根据环境调整配置
+        sed -i "s|https://[^.]*\.hf\.space|$base_url|g" nginx/conf.d/default.conf
+        sed -i "s|listen 7860;|listen $NGINX_PORT;|g" nginx/conf.d/default.conf
+    fi
+}
+
+# ============================================================================
+# 启动脚本生成
+# ============================================================================
+
+generate_startup_script() {
+    local env=$(detect_deployment_environment)
+    local base_url=$(get_base_url)
+    
+    # 更新 docker-start.sh 中的 URL 配置
+    if [[ -f docker-start.sh ]]; then
+        cp docker-start.sh docker-start.sh.bak
+        sed -i "s|https://[^.]*\.hf\.space|$base_url|g" docker-start.sh
+        sed -i "s|export GATEWAY_PORT=3000|export GATEWAY_PORT=$OPENCODE_PORT|g" docker-start.sh
+    fi
+}
+
+# ============================================================================
+# 备份配置
+# ============================================================================
+
+setup_backup_configuration() {
+    # 创建备份目录
+    mkdir -p backups
+    mkdir -p logs
+    
+    # 设置备份脚本权限
+    chmod +x backup-scripts/*.sh
+    
+    # 创建备份配置
+    cat > backup-config.json << EOF
+{
+    "backup_schedule": "0 2 * * *",
+    "retention_days": 7,
+    "compression": "gzip",
+    "exclude_patterns": [
+        "*.tmp",
+        "*.log",
+        "cache/*",
+        "node_modules/*"
+    ],
+    "include_configs": true,
+    "include_data": true,
+    "include_logs": false
+}
+EOF
+}
+
+# ============================================================================
+# 主配置函数
+# ============================================================================
+
+configure_for_deployment() {
+    echo "🚀 配置 OCNGX 部署环境..."
+    
+    local env=$(detect_deployment_environment)
+    echo "📍 检测到环境: $env"
+    
+    echo "⚙️ 生成环境配置..."
+    generate_env_file
+    
+    echo "🌐 生成 Nginx 配置..."
+    generate_nginx_config
+    
+    echo "🔧 生成启动脚本..."
+    generate_startup_script
+    
+    echo "💾 设置备份配置..."
+    setup_backup_configuration
+    
+    if [[ "$env" == "huggingface" ]]; then
+        echo "🤗 生成 HuggingFace Space 配置..."
+        generate_hf_space_config
+    fi
+    
+    echo "✅ 部署配置完成!"
+}
+
+# ============================================================================
+# 验证配置
+# ============================================================================
+
+verify_configuration() {
+    echo "🔍 验证配置文件..."
+    
+    local errors=0
+    
+    # 检查必需文件
+    local required_files=(
+        "Dockerfile"
+        "docker-start.sh"
+        "opencode.json"
+        "nginx/conf.d/default.conf"
+        "backup-scripts/backup.sh"
+        "backup-scripts/restore.sh"
+    )
+    
+    for file in "${required_files[@]}"; do
+        if [[ -f "$file" ]]; then
+            echo "  ✅ $file"
+        else
+            echo "  ❌ $file"
+            ((errors++))
+        fi
+    done
+    
+    # 检查环境变量
+    if [[ -f ".env" ]]; then
+        echo "  ✅ .env 配置文件"
+    else
+        echo "  ❌ .env 配置文件"
+        ((errors++))
+    fi
+    
+    # 检查目录结构
+    local required_dirs=("nginx" "backup-scripts" "cron-jobs")
+    for dir in "${required_dirs[@]}"; do
+        if [[ -d "$dir" ]]; then
+            echo "  ✅ $dir/ 目录"
+        else
+            echo "  ❌ $dir/ 目录"
+            ((errors++))
+        fi
+    done
+    
+    if [[ $errors -eq 0 ]]; then
+        echo "✅ 配置验证通过"
+        return 0
+    else
+        echo "❌ 配置验证失败，发现 $errors 个问题"
+        return 1
+    fi
+}
+
+# ============================================================================
+# 导出函数（供其他脚本使用）
+# ============================================================================
+
+export -f detect_deployment_environment
+export -f get_base_url
+export -f generate_env_file
+export -f generate_nginx_config
+export -f generate_startup_script
+export -f setup_backup_configuration
+export -f configure_for_deployment
+export -f verify_configuration

docker-compose.yml

@@ -0,0 +1,84 @@
+version: '3.8'
+
+services:
+  ocngx:
+    build: .
+    container_name: ocngx
+    ports:
+      - "7860:7860"
+    environment:
+      # 基本配置
+      - GATEWAY_HOST=127.0.0.1
+      - GATEWAY_PORT=3000
+      - USERNAME=admin
+      - PASSWORD=admin123
+      
+      # HuggingFace Spaces 自动检测的环境变量
+      - SPACE_ID=${SPACE_ID:-}
+      - OPENCODE_PUBLIC_URL=${OPENCODE_PUBLIC_URL:-http://localhost:7860}
+      - PUBLIC_URL=${PUBLIC_URL:-http://localhost:7860}
+      - BASE_URL=${BASE_URL:-http://localhost:7860}
+      
+      # 备份配置（可选）
+      - BACKUP_S3_BUCKET=${BACKUP_S3_BUCKET:-}
+      - BACKUP_DIR=${BACKUP_DIR:-/var/backups/ocngx}
+      
+      # 日志级别
+      - LOG_LEVEL=${LOG_LEVEL:-info}
+    
+    volumes:
+      # 持久化数据目录
+      - opencode_data:/root/.opencode
+      - backup_data:/var/backups/ocngx
+      
+      # 日志目录
+      - ./logs:/var/log/nginx
+      
+      # 时区同步
+      - /etc/localtime:/etc/localtime:ro
+    
+    restart: unless-stopped
+    
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:7860/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    
+    networks:
+      - ocngx_network
+
+  # 可选：备份服务（用于自动备份到外部存储）
+  backup-scheduler:
+    image: alpine:latest
+    container_name: ocngx-backup
+    depends_on:
+      - ocngx
+    volumes:
+      - backup_data:/backups:ro
+      - ./backup-scripts:/scripts:ro
+    environment:
+      - BACKUP_S3_BUCKET=${BACKUP_S3_BUCKET:-}
+      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID:-}
+      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY:-}
+      - AWS_DEFAULT_REGION=${AWS_DEFAULT_REGION:-us-east-1}
+    command: >
+      sh -c "
+        apk add --no-cache curl tar jq &&
+        echo '0 2 * * * /scripts/backup.sh' > /etc/crontabs/root &&
+        crond -f -l 2
+      "
+    restart: unless-stopped
+    networks:
+      - ocngx_network
+
+volumes:
+  opencode_data:
+    driver: local
+  backup_data:
+    driver: local
+
+networks:
+  ocngx_network:
+    driver: bridge

migrate.sh

@@ -0,0 +1,504 @@
+#!/bin/bash
+
+# OCNGX 迁移工具
+# 用于在不同 HuggingFace Spaces 之间快速迁移系统
+
+set -euo pipefail
+
+# 配置变量
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MIGRATION_LOG="/tmp/ocngx_migration_$(date +%s).log"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log() {
+    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" | tee -a "$MIGRATION_LOG"
+}
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1" | tee -a "$MIGRATION_LOG"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1" | tee -a "$MIGRATION_LOG"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1" | tee -a "$MIGRATION_LOG"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1" | tee -a "$MIGRATION_LOG"
+}
+
+# 显示帮助信息
+usage() {
+    echo "OCNGX 迁移工具 - 在不同 HuggingFace Spaces 之间迁移系统"
+    echo ""
+    echo "用法: $0 [选项] <源Space> <目标Space>"
+    echo ""
+    echo "参数:"
+    echo "  <源Space>     源 HuggingFace Space 名称"
+    echo "  <目标Space>   目标 HuggingFace Space 名称"
+    echo ""
+    echo "选项:"
+    echo "  -b, --backup-only     仅创建备份，不执行迁移"
+    echo "  -r, --restore-only    仅恢复备份，不创建新备份"
+    echo "  -k, --keep-backup     保留本地备份文件"
+    echo "  -f, --force           强制覆盖目标配置"
+    echo "  -d, --dry-run         模拟运行，不执行实际操作"
+    echo "  -h, --help            显示帮助信息"
+    echo ""
+    echo "示例:"
+    echo "  $0 source-space target-space"
+    echo "  $0 --backup-only source-space"
+    echo "  $0 --restore-only --force target-space backup.tar.gz"
+    echo ""
+    exit 1
+}
+
+# 解析命令行参数
+SOURCE_SPACE=""
+TARGET_SPACE=""
+BACKUP_ONLY=false
+RESTORE_ONLY=false
+KEEP_BACKUP=false
+FORCE_MODE=false
+DRY_RUN=false
+BACKUP_FILE=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -b|--backup-only)
+            BACKUP_ONLY=true
+            shift
+            ;;
+        -r|--restore-only)
+            RESTORE_ONLY=true
+            shift
+            ;;
+        -k|--keep-backup)
+            KEEP_BACKUP=true
+            shift
+            ;;
+        -f|--force)
+            FORCE_MODE=true
+            shift
+            ;;
+        -d|--dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            ;;
+        -*)
+            log_error "未知选项: $1"
+            usage
+            ;;
+        *)
+            if [[ -z "$SOURCE_SPACE" ]]; then
+                SOURCE_SPACE="$1"
+            elif [[ -z "$TARGET_SPACE" ]]; then
+                TARGET_SPACE="$1"
+            elif [[ -z "$BACKUP_FILE" ]]; then
+                BACKUP_FILE="$1"
+            else
+                log_error "参数过多"
+                usage
+            fi
+            shift
+            ;;
+    esac
+done
+
+# 验证参数
+validate_parameters() {
+    log_info "验证参数..."
+    
+    if [[ "$RESTORE_ONLY" == true ]]; then
+        if [[ -z "$TARGET_SPACE" && -z "$BACKUP_FILE" ]]; then
+            log_error "恢复模式需要指定目标Space或备份文件"
+            usage
+        fi
+    else
+        if [[ -z "$SOURCE_SPACE" || -z "$TARGET_SPACE" ]]; then
+            log_error "必须指定源Space和目标Space"
+            usage
+        fi
+    fi
+    
+    log_success "参数验证通过"
+}
+
+# 检测当前环境
+detect_current_environment() {
+    log_info "检测当前环境..."
+    
+    if [[ -n "${SPACE_ID:-}" ]]; then
+        CURRENT_ENV="huggingface"
+        CURRENT_SPACE="$SPACE_ID"
+        log_info "当前环境: HuggingFace Space ($CURRENT_SPACE)"
+    elif [[ -f /.dockerenv ]]; then
+        CURRENT_ENV="docker"
+        CURRENT_SPACE="docker-container"
+        log_info "当前环境: Docker 容器"
+    else
+        CURRENT_ENV="local"
+        CURRENT_SPACE="local-machine"
+        log_info "当前环境: 本地机器"
+    fi
+}
+
+# 检查网络连接
+check_network_connectivity() {
+    log_info "检查网络连接..."
+    
+    # 检查 HuggingFace 连通性
+    if curl -s --connect-timeout 10 https://huggingface.co >/dev/null 2>&1; then
+        log_success "HuggingFace 连接正常"
+    else
+        log_error "无法连接到 HuggingFace"
+        exit 1
+    fi
+}
+
+# 创建源Space备份
+create_source_backup() {
+    log_info "在源Space创建备份: $SOURCE_SPACE"
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_warning "[DRY-RUN] 模拟在 $SOURCE_SPACE 创建备份"
+        return
+    fi
+    
+    # 这里需要SSH或API方式连接到源Space
+    # 实际实现取决于具体的访问方式
+    
+    local source_url="https://$SOURCE_SPACE.hf.space"
+    log_info "源Space URL: $source_url"
+    
+    # 方案1: 通过SSH访问（如果支持）
+    # ssh user@$SOURCE_SPACE.hf.space "./backup-scripts/backup.sh"
+    
+    # 方案2: 通过API触发备份
+    # curl -X POST "$source_url/api/backup"
+    
+    # 方案3: 通过HuggingFace CLI
+    # huggingface-cli space create-backup $SOURCE_SPACE
+    
+    # 临时方案: 假设可以SSH访问
+    log_warning "需要手动在源Space执行: ./backup-scripts/backup.sh"
+    log_info "等待用户确认备份已完成..."
+    read -p "确认备份已完成? (y/N): " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        log_success "源Space备份已确认"
+    else
+        log_error "备份未完成，终止迁移"
+        exit 1
+    fi
+}
+
+# 下载备份文件
+download_backup() {
+    log_info "下载备份文件..."
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_warning "[DRY-RUN] 模拟下载备份文件"
+        return
+    fi
+    
+    # 这里需要实现从源Space下载备份的逻辑
+    # 可能的实现方式：
+    
+    # 1. 通过SCP下载
+    # scp user@$SOURCE_SPACE.hf.space:/var/backups/ocngx/latest.tar.gz ./
+    
+    # 2. 通过HTTP下载
+    # wget "$source_url/download/backup/latest.tar.gz"
+    
+    # 3. 通过HuggingFace API下载
+    # huggingface-cli space download-backup $SOURCE_SPACE
+    
+    # 临时方案: 假设用户已手动下载
+    log_warning "需要手动从源Space下载备份文件到当前目录"
+    log_info "备份文件通常位于: /var/backups/ocngx/ocngx_backup_*.tar.gz"
+    
+    read -p "请输入备份文件路径: " backup_path
+    
+    if [[ -f "$backup_path" ]]; then
+        BACKUP_FILE="$backup_path"
+        log_success "备份文件已找到: $BACKUP_FILE"
+    else
+        log_error "备份文件不存在: $backup_path"
+        exit 1
+    fi
+}
+
+# 准备目标Space
+prepare_target_space() {
+    log_info "准备目标Space: $TARGET_SPACE"
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_warning "[DRY-RUN] 模拟准备目标Space"
+        return
+    fi
+    
+    # 1. 检查目标Space是否存在
+    local target_url="https://$TARGET_SPACE.hf.space"
+    log_info "目标Space URL: $target_url"
+    
+    # 2. 部署基础代码到目标Space
+    log_info "部署基础代码到目标Space..."
+    
+    # 这里需要实现部署逻辑
+    # 可能的实现方式：
+    
+    # 1. 通过Git部署
+    # git clone <项目仓库> target-deploy
+    # cd target-deploy
+    # git remote set-url origin git@hf.co:spaces/$TARGET_SPACE
+    # git push origin main
+    
+    # 2. 通过HuggingFace CLI部署
+    # huggingface-cli space create $TARGET_SPACE --space-type docker
+    
+    # 临时方案: 假设用户已手动部署
+    log_warning "需要手动将项目代码部署到目标Space: $TARGET_SPACE"
+    log_info "步骤:"
+    log_info "1. 创建新的Space: https://huggingface.co/new-space"
+    log_info "2. 克隆当前项目代码"
+    log_info "3. 推送到新Space"
+    
+    read -p "确认目标Space已准备完成? (y/N): " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        log_success "目标Space准备已确认"
+    else
+        log_error "目标Space未准备完成，终止迁移"
+        exit 1
+    fi
+}
+
+# 配置目标环境
+configure_target_environment() {
+    log_info "配置目标环境..."
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_warning "[DRY-RUN] 模拟配置目标环境"
+        return
+    fi
+    
+    # 这里需要在目标Space上执行环境配置
+    # 类似于 prepare_target_space 的逻辑
+    
+    log_warning "需要手动在目标Space配置环境:"
+    log_info "1. SSH连接到目标Space"
+    log_info "2. 设置环境变量: export SPACE_ID=$TARGET_SPACE"
+    log_info "3. 运行: source deploy-config.sh && configure_for_deployment"
+    
+    read -p "确认环境配置已完成? (y/N): " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        log_success "目标环境配置已确认"
+    else
+        log_error "环境配置未完成，终止迁移"
+        exit 1
+    fi
+}
+
+# 恢复数据到目标Space
+restore_to_target() {
+    log_info "恢复数据到目标Space..."
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_warning "[DRY-RUN] 模拟恢复数据到目标Space"
+        return
+    fi
+    
+    # 上传备份文件到目标Space
+    log_info "上传备份文件到目标Space..."
+    
+    # 实现上传逻辑
+    # scp backup.tar.gz user@$TARGET_SPACE.hf.space:/tmp/
+    
+    # 在目标Space执行恢复
+    log_info "在目标Space执行数据恢复..."
+    
+    # 实现恢复逻辑
+    # ssh user@$TARGET_SPACE.hf.space "./backup-scripts/restore.sh --force /tmp/backup.tar.gz"
+    
+    log_warning "需要手动在目标Space执行:"
+    log_info "1. 上传备份文件: scp $BACKUP_FILE user@$TARGET_SPACE.hf.space:/tmp/"
+    log_info "2. SSH连接到目标Space"
+    log_info "3. 运行: ./backup-scripts/restore.sh --force /tmp/$(basename $BACKUP_FILE)"
+    
+    read -p "确认数据恢复已完成? (y/N): " -n 1 -r
+    echo
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        log_success "数据恢复已确认"
+    else
+        log_error "数据恢复未完成，终止迁移"
+        exit 1
+    fi
+}
+
+# 验证迁移结果
+verify_migration() {
+    log_info "验证迁移结果..."
+    
+    local target_url="https://$TARGET_SPACE.hf.space"
+    
+    # 检查目标Space健康状态
+    if curl -s --connect-timeout 10 "$target_url/health" >/dev/null 2>&1; then
+        log_success "目标Space健康检查通过"
+    else
+        log_warning "目标Space健康检查失败，请手动验证"
+    fi
+    
+    # 检查OpenCode状态
+    if curl -s --connect-timeout 10 "$target_url/global/health" >/dev/null 2>&1; then
+        log_success "OpenCode服务状态正常"
+    else
+        log_warning "OpenCode服务状态异常，请手动检查"
+    fi
+}
+
+# 清理临时文件
+cleanup() {
+    log_info "清理临时文件..."
+    
+    if [[ "$KEEP_BACKUP" != true ]] && [[ -n "$BACKUP_FILE" ]] && [[ -f "$BACKUP_FILE" ]]; then
+        if [[ "$DRY_RUN" != true ]]; then
+            rm -f "$BACKUP_FILE"
+            log_success "已清理备份文件: $BACKUP_FILE"
+        fi
+    fi
+    
+    # 清理日志文件
+    # rm -f "$MIGRATION_LOG"
+}
+
+# 生成迁移报告
+generate_report() {
+    log_info "生成迁移报告..."
+    
+    local report_file="migration_report_$(date +%Y%m%d_%H%M%S).txt"
+    
+    cat > "$report_file" << EOF
+OCNGX 迁移报告
+===============
+
+迁移时间: $(date '+%Y-%m-%d %H:%M:%S')
+源Space: $SOURCE_SPACE
+目标Space: $TARGET_SPACE
+备份文件: $BACKUP_FILE
+当前环境: $CURRENT_ENV ($CURRENT_SPACE)
+
+迁移参数:
+- 强制模式: $FORCE_MODE
+- 仅备份: $BACKUP_ONLY
+- 仅恢复: $RESTORE_ONLY
+- 保留备份: $KEEP_BACKUP
+- 模拟运行: $DRY_RUN
+
+迁移日志:
+$(cat "$MIGRATION_LOG")
+
+后续步骤:
+1. 访问目标Space: https://$TARGET_SPACE.hf.space
+2. 验证所有功能正常
+3. 更新DNS或代理配置（如需要）
+4. 通知用户迁移完成
+
+注意事项:
+- 请保留此报告用于记录
+- 建议在迁移后24小时内监控系统状态
+- 如有问题，请检查迁移日志
+EOF
+
+    log_success "迁移报告已生成: $report_file"
+}
+
+# 主迁移流程
+execute_migration() {
+    log_info "开始迁移流程..."
+    log_info "源Space: $SOURCE_SPACE -> 目标Space: $TARGET_SPACE"
+    
+    if [[ "$BACKUP_ONLY" == true ]]; then
+        create_source_backup
+        download_backup
+        log_success "备份完成"
+        return
+    fi
+    
+    if [[ "$RESTORE_ONLY" == true ]]; then
+        if [[ -z "$TARGET_SPACE" ]]; then
+            # 本地恢复模式
+            log_info "本地恢复模式"
+            if [[ -z "$BACKUP_FILE" ]]; then
+                log_error "本地恢复需要指定备份文件"
+                exit 1
+            fi
+            ./backup-scripts/restore.sh ${FORCE_MODE:+--force} "$BACKUP_FILE"
+        else
+            prepare_target_space
+            configure_target_environment
+            restore_to_target
+        fi
+        verify_migration
+        log_success "恢复完成"
+        return
+    fi
+    
+    # 完整迁移流程
+    create_source_backup
+    download_backup
+    prepare_target_space
+    configure_target_environment
+    restore_to_target
+    verify_migration
+    
+    log_success "迁移完成!"
+}
+
+# 错误处理
+handle_error() {
+    log_error "迁移过程中发生错误"
+    cleanup
+    exit 1
+}
+
+# 主函数
+main() {
+    echo "🚀 OCNGX 迁移工具"
+    echo "=================="
+    
+    validate_parameters
+    detect_current_environment
+    check_network_connectivity
+    
+    trap handle_error ERR
+    
+    execute_migration
+    generate_report
+    cleanup
+    
+    echo ""
+    log_success "迁移流程执行完成!"
+    echo "📊 迁移日志: $MIGRATION_LOG"
+    echo "📋 如有疑问，请查看迁移报告"
+}
+
+# 执行主函数
+main "$@"