Files
ai-soulmate-local-deployment/README.md
T

3.8 KiB

AI SoulMate 本地部署与硬件适配

从这里开始

先阅读 Ubuntu 22.04 本地部署运行手册、后端本地部署、平台前端本地部署、管理端本地部署、Tripo 零积分压测方案、样机硬件评估报告 和 源码版本核对。当前可以启动 PostgreSQL、Redis、MinIO、平台后端、平台前端和 AI SoulMate 管理端;统一网关仍在后续阶段。

本仓库是 AI SoulMate 私有化部署的编排与留档仓库,用于固定源码版本、记录硬件基线、建设部署配置并沉淀压测结果。业务源码仍保留在各自仓库中,不复制源码、不改写原有 Git 历史。

当前结论

  • 当前 HP ZCentral 4R 样机适合做单机适配、功能跑通和容量边界测试,不作为生产高可用样板。
  • 第一阶段在中心服务器部署平台后端、平台前端、AI SoulMate 管理端、PostgreSQL、Redis、本地对象存储和统一网关。
  • Tripo 生产生成仍走外部 API,因此这是“业务数据和基础设施本地化”,不是完全离线部署;本地性能测试使用零外连、零积分的 mock 模式。
  • 农场端 ai-soulmate-client 暂不部署到中心服务器,后续放到靠近打印机的工作站。
  • 网关能力是必需的,但现有 nginx-server 的公网域名和固定路由不能原样交付,需要在本仓库形成私有部署配置。

仓库边界

内容 保存位置
Python/Vue 平台源码 ai-soulmate-server
农场端 Spring Boot/Vue 源码 ai-soulmate-client
管理端源码 mlkj-admin
部署编排、版本锁定、脚本和文档 本仓库
小型压测报告和容量结论 results/reports/
大型原始日志 results/raw/,默认不进入 Git
密钥、证书和真实密码 不进入 Git

目录

  • docs/:架构、改造路线、样机基线和压测方案。
  • docs/CROSS-COMPUTER-HANDOFF.md:换电脑继续工作的状态、重建 Git 和接管清单。
  • decisions/:影响交付方式的架构决策。
  • inventory/:参与部署的源码版本清单。
  • compose/:基础设施、平台后端和平台前端 Compose 编排。
  • scripts/:硬件与运行状态采集脚本。
  • benchmark/:压测场景和单次运行元数据模板。
  • results/:压测报告与不入库的原始数据。

推荐执行顺序

  1. 固化样机硬件、网络、系统和源码版本基线。
  2. 完成后端对象存储适配、生产镜像和单机 Compose。
  3. 完成平台前端、管理端 AI-only 模式和统一网关。
  4. 在样机上完成联网 POC,验证 Tripo 出站访问和全业务链路。
  5. 先测本地链路容量,再单独测包含 Tripo 的端到端体验。
  6. 增加农场工作站,验证任务下发、断线恢复和打印机适配。
  7. 根据重复压测数据形成不同客户硬件档位,不凭 CPU/内存规格直接承诺并发量。

详细任务见 改造路线。

样机首次采集

在 Ubuntu 样机上执行:

./scripts/collect-host-facts.sh > results/raw/host-facts-$(date +%Y%m%d-%H%M%S).txt

采集结果不包含 IP、MAC、磁盘序列号和机器 UUID。原始文件默认不入 Git;评审后将脱敏结论写入 results/reports/。

版本规则

  • 每次可复现部署必须记录三个源码提交、容器镜像 digest、配置版本和数据库迁移版本。
  • 建议用 poc-YYYYMMDD.N、rc-X.Y.Z、release-X.Y.Z 标记部署仓库版本。
  • 本仓库只保存示例变量名;真实值由现场 .env、密钥文件或客户密钥系统提供。