UnisKB/deploy_artifacts/VALIDATION_20261106.md

4.1 KiB
Raw Blame History

升级准备与验证记录 · 2026-11-06

已完成

  • 原工作区 deploy_artifacts/ 归档到 MaxKB v3.2,本地提交 e34d9011e;未加入镜像、模型或私有配置。
  • 补齐重构版已引用但未跟踪的功能源码、knowledge 0006 迁移及回归脚本;整理前端 pnpm 11.23.0 锁文件。临时构建、缓存不纳入发布。
  • 新离线构建入口重新编译 admin/chat,将静态文件写入实际运行路径;CUDA/CoreX 解析镜像分开标记,入口使用 Bash,保留厂商二进制依赖约束。
  • 升级使用数据副本和独立网络,保留旧容器/镜像,提供冷备及共享 PostgreSQL 在线一致性备份两种模式。

真实环境发现

52.118 的源码目录仍显示 v3.2 / develop,但有增量功能修改,不能按分支名认定实际内容。源码服务未切换分支或覆盖文件。

原 airag、mineru-api、mindmap-web、unis-gateway 均已停止;运行中的 ares-pg 使用 /home/tlw/unis/maxkb/data/postgresql/pgdata。因此不能启动原 airag 的内置 PostgreSQL,默认冷备升级会拒绝继续。在线模式从 ares-pg 取得 pg_basebackup,恢复到独立目录,原数据库保持运行。

该机为 NVIDIA RTX 3070 Ti 8 GB;没有 MR100 实机验收条件。

验证结果

检查 结果及边界
升级脚本测试 本机 Windows 15 项、52.118 Linux 15 项均通过;使用模拟 Docker 调用,不是完整发布测试
Compose 配置 CUDA / CoreX 均由 52.118 的 Docker Compose v5.5.1 校验通过,未启动对应解析业务镜像
网关 使用已有 Nginx 镜像对新模板执行 nginx -t 通过,未替换在线网关
前端 本机 admin/chat 的 Vite 生产构建通过;存在既有 eval 和大 chunk 警告;未做完整 TypeScript 检查或新 Docker 页面验收
知识版本 本机 SQLite 回归 35 项,2 项跳过;未访问共享数据库/Redis
组件/总结/工作台/上下文 Linux 候选源码中 SQLite 与模拟接口回归 120 项通过,未调用真实模型或外部 MCP
Python 应用源码和升级脚本编译检查通过
Shell 两仓打包脚本 Bash 语法检查通过

在线备份与副本迁移检查

有效演练目录:/home/tlw/unis/upgrade-rehearsal-20261106-144635。该目录中的 database.tar 来自在线 pg_basebackup(含 WAL),非数据库文件另存。早期直接 tar 的副本不作为一致性备份或验收依据。

在候选源码、现有测试机 Python 依赖和独立临时 PostgreSQL 中执行了完整 migrate --plan、migrate --noinput、migrate --check。未启动 Web、Redis 或任务消费者。检查前后:

表 检查前 检查后
user 13 13
knowledge 8 8
document 8 8
paragraph 738 738
embedding 1021 1021
application 9 9
model 7 7

该共享库已经应用当前全部迁移,本轮新增执行的迁移数为 0。 这证明此备份可独立启动、当前候选可连接并检查已有结构,记录数保留;不能据此声称纯旧版 v3.2 库首次前向迁移已经验证。临时数据库已停止,四个原业务容器保持停止,ares-pg 和源码测试服务继续运行。

发布前仍需完成

  1. 在构建机实际构建两个 GPU 镜像包,检查依赖解析与模型路径;本轮未构建或导入候选业务镜像。
  2. 使用尚未应用重构迁移的独立旧版数据库备份执行首次升级,并进行登录、权限、问答、文件、向量和聊天记录验收。
  3. 完成导图解析资源与平台模型的映射及授权,处理旧浏览器未保存内容。此部分不是旧 MINDMAP_LLM_* 环境变量自动迁移。
  4. 在候选 Docker 8989/9898 入口检查 admin/chat、登录/注册及导图完整流程;NVIDIA、MR100 分别做真实模型/PDF 验收。
  5. 在开放写入前明确最终数据时间点与回退边界;共享源码环境与新 Docker 数据副本后续不会自动同步。

升级命令及限制见 README_UPGRADE.md。本记录不等于上线完成报告。