# 知识中心发布包

发布编号：knowledge-20260916-100045

状态：2026-09-16 已部署并验收通过。详见 ../knowledge-deployed.md。

目标：192.168.110.111，服务目录 /opt/im-admin/deploy/im-admin。

## 内容

- payload.tar.gz：知识中心后端代码、测试、前端构建产物和 compose.yaml。
- manifest.json：每个文件的 SHA-256 与大小。
- Dockerfile.overlay：以备份的生产镜像为基础，仅覆盖本次代码与静态资源。

发布包不包含数据库、密钥、环境变量文件或聊天数据。

## 上线顺序

1. 确认当前镜像、生产源文件、磁盘空间及服务健康状态，对比生产改动。
2. 保存原源码、compose 配置和镜像标签；一致性备份数据库及密钥，验证备份。
3. 在 /home/ps 下的独立发布目录解包并核对 manifest.json，避免遍历生产备份目录。
4. 使用 Dockerfile.overlay 构建独立候选镜像。BASE_IMAGE 必须指定刚备份的生产镜像标签。
5. 在候选镜像中使用临时数据库运行 test_knowledge、test_model_gateway。
6. 安装审核过的源文件和 compose.yaml，保留生产 .env、data 目录；将候选镜像标为 current。
7. 执行 docker compose up -d --no-build api gateway knowledge-worker。
8. 检查 API、网关、worker、前端资源、鉴权、归档条数与数据库完整性；记录实际结果。

上线不自动提取四十万条聊天，不自动开启租户检索。管理员应先选定账号、小批量提取、审核发布，再开启检索。

## 回滚原则

停止 knowledge-worker，恢复备份的 compose、源码与静态资源，将备份镜像重新标为 current，再启动 api、gateway。新增知识表保留，不恢复旧数据库，以免丢失上线后新增的聊天。

## 部署结果

API 与网关健康，knowledge-worker 正常运行，三个容器重启计数为 0。生产镜像内 56 项测试通过，归档消息 414003 条，数据库完整性检查 ok。知识默认关闭，无加工任务。

大库首次索引构建使用磁盘临时目录已完成；操作经过及备份位置见 ../knowledge-deployed.md。