{
  "title": "Hermes Agent Server Migration Package",
  "source_server": "34.92.119.30 (GCP, Linux)",
  "target_server": "Mac Mini (macOS)",
  "created_at": "2026-08-04",
  "hermes_version": "v0.20.0 (2026.8.3)",
  "total_files": 6,
  "files": {
    "01-hermes-core.tar.gz": {
      "desc": "Hermes核心数据（state.db/skills/cron/memories/plugins/sessions/.env/config.yaml等）",
      "extract_to": "~/.hermes/",
      "note": "解压后需合并config.yaml（路径/home/echo->/Users/echo），不要覆盖Mac上已有的hermes-agent/node/bin目录",
      "portable": true
    },
    "03-mysql-dump.sql": {
      "desc": "MySQL全库导出（vc_simulator + poem_quest数据库）",
      "extract_to": "导入到Mac上的MySQL容器",
      "note": "docker exec -i <mysql_container> mysql -u root -p < dump.sql",
      "portable": true
    },
    "04-mc-volume.tar.gz": {
      "desc": "Mission Control数据卷（SQLite数据库+运行状态）",
      "extract_to": "Mission Control Docker volume",
      "note": "docker run --rm -v <mc_volume>:/data -v $(pwd):/backup alpine tar xzf /backup/04-mc-volume.tar.gz -C /data",
      "portable": true
    },
    "05-sub2api.tar.gz": {
      "desc": "Sub2API完整数据（含clash配置、postgres_data、redis_data、.env）",
      "extract_to": "/opt/sub2api/（macOS路径需调整）",
      "note": "解压后docker compose up -d，需重建容器。postgres_data可能需要sudo权限",
      "portable": true
    },
    "06-opt-services.tar.gz": {
      "desc": "/opt服务（poem-quest/vc-api/exam-api/hermes-cluster/vc-tools/shared/firecrawl）",
      "extract_to": "/opt/（macOS建议放到~/opt/）",
      "note": "已排除node_modules/venv/__pycache__，解压后需在各项目内npm install或pip install重建依赖",
      "portable": true
    },
    "07-srv-sites.tar.gz": {
      "desc": "/srv静态站点（vc/hiking/codingplan/events/download/radar/exam/dkm/eval共9个域名）",
      "extract_to": "/srv/ 或 ~/srv/",
      "note": "纯静态文件，直接解压即可。需更新Caddyfile中的路径",
      "portable": true
    },
    "08-download.tar.gz": {
      "desc": "~/download完整目录（研究资料/论文/图片/项目数据等2.7G）",
      "extract_to": "~/download/",
      "note": "纯数据文件，直接解压",
      "portable": true
    },
    "09-other-users.tar.gz": {
      "desc": "其他用户数据（hyq:19M html/xiaobai/echolzq1115）",
      "extract_to": "/Users/下对应用户目录",
      "note": "hyq用户有html网站内容。macOS需手动创建用户或合并到主用户目录",
      "portable": true
    },
    "10-system-config.tar.gz": {
      "desc": "系统配置（Caddyfile/crontab/systemd service文件/SSH keys/docker-compose配置/clash配置）",
      "extract_to": "手动处理，不直接覆盖",
      "note": "包含: Caddyfile(15域名)、crontab(4条)、systemd服务(code-server/vc-api/hysteria)、SSH密钥和config、sub2api+MC的docker-compose和.env。macOS需转launchd，路径需全局替换/home/echo->/Users/echo",
      "portable": false
    }
  },
  "post_migration_steps": [
    "1. 在Mac mini上安装Hermes v0.20.0（如未安装）",
    "2. 解压01-hermes-core.tar.gz到~/.hermes/，合并config.yaml（不要直接覆盖）",
    "3. 全局路径替换: /home/echo -> /Users/echo（config.yaml/cron/jobs.json/Caddyfile/scripts等）",
    "4. 安装Docker Desktop for Mac，启动sub2api: 解压05-sub2api.tar.gz后docker compose up -d",
    "5. 导入MySQL: docker exec -i vc-mysql mysql -u root -p < 03-mysql-dump.sql",
    "6. 启动Mission Control: 解压04-mc-volume.tar.gz到MC的Docker volume",
    "7. 解压06-opt-services.tar.gz到~/opt/，各项目npm install/pip install重建依赖",
    "8. 解压07-srv-sites.tar.gz到~/srv/，更新Caddyfile路径",
    "9. 解压08-download.tar.gz到~/download/",
    "10. 参照10-system-config.tar.gz配置Caddy/SSH keys/crontab",
    "11. macOS用launchd替换systemd服务",
    "12. 验证: hermes chat测试、hermes cron list检查定时任务、Caddy域名访问、Docker容器健康"
  ],
  "checksums": {
    "01-hermes-core.tar.gz": {
      "sha256": "8e2345d0675127fe6aec680291531498a9260e70e4b4821841b2de7d712fefaf",
      "size": "514M"
    },
    "03-mysql-dump.sql": {
      "sha256": "33a5801571877cc0f27a2e3c6bceae07e7ef3eaafae4a6415fc49aee68fd5138",
      "size": "5.2M"
    },
    "04-mc-volume.tar.gz": {
      "sha256": "c6e0e4749dde7763b865090958d1dd94ff9b10620b86b1fb01a028fff53f21a2",
      "size": "3.7M"
    },
    "05-sub2api.tar.gz": {
      "sha256": "4283556410501da6c82ec83d74bbb02ec82d00f7a498b551f14f712db36b5ae3",
      "size": "13M"
    },
    "06-opt-services.tar.gz": {
      "sha256": "a306684ebd20c39004a9415bb17075a061e13dd41f999dbf2a0f626c5a629e28",
      "size": "117M"
    },
    "07-srv-sites.tar.gz": {
      "sha256": "5de82605970a77418e84da7077cfefd2287f7833ddb651bd0c31aad3b652aef1",
      "size": "59M"
    },
    "08-download.tar.gz": {
      "sha256": "58ed9e2a080e157ce86e7cf2b72101b31b92c715b17983fc96565e699ee56224",
      "size": "2.5G"
    },
    "09-other-users.tar.gz": {
      "sha256": "79e221a68c6df592249b265f8db5d1bdb1de7a4adcf06c8e4baea81cc3ff485d",
      "size": "3.9M"
    },
    "10-system-config.tar.gz": {
      "sha256": "741bf5214657b6a05aac73fac0170adfa7c680f47ef4998b442a84922b40ae81",
      "size": "19K"
    }
  }
}