当前服务器 WeKnora v0.7.1 发布包
本目录固化 2026-08-26 正在运行的 WeKnora 核心版本,并提供迁移到新服务器时使用的无密钥部署模板。
版本身份
- WeKnora 源码:
c64a48647cd6f7eb8b0fb020b2e8fec74ee375fb - 上游标签:
v0.7.1 - App 镜像:
wechatopenai/weknora-app:v0.7.1@sha256:d88bef9912f6abb8bc7c22144ee7f314016055b8075bda4ea8fbb28af41c3bcf - UI 镜像:
wechatopenai/weknora-ui:v0.7.1@sha256:169678d4ba4c1f127b36c5f58a6ad567bd745d48488d693e4d3eb4117689c730 - DocReader 镜像:
wechatopenai/weknora-docreader:v0.7.1@sha256:262bab1a4b12f24dd99958e32868ffc2d2cb09270465a88820420ac378c0e149 - 当前 App 二进制 SHA-256:
aa6c6223f9980ef08120e65cdc091996b1eadbc828c69540e7e6b9cdc24bbca3
runtime-manifest.json 保存运行容器、镜像内容 ID 和源码修订的脱敏取证结果。当前 App 容器的 OCI revision 与源码 Commit 一致。
与上游 v0.7.1 的唯一代码差异
当前 MCP 镜像需要 MCP Python SDK 1.x,因此本分支保留两处运行修复:
mcp-server/requirements.txt将依赖固定为mcp>=1.0.0,<2.0.0;mcp-server/Dockerfile在构建期验证Server.list_tools()契约。
WeKnora App、UI、DocReader本身使用上述官方不可变镜像,没有把钉钉专用分支混入当前运行版本。
文件用途
compose.managed-data-plane.yaml:新阿里云服务器部署核心服务的模板;RDS PostgreSQL、Elasticsearch、Redis和私有OSS从环境变量接入。.env.example:只包含变量名和非敏感默认值;复制为.env后填写真实值。runtime-manifest.json:当前服务器运行版本取证,不用于保存运行数据。
静态检查:
cp deploy/server-running-v0.7.1/.env.example deploy/server-running-v0.7.1/.env
# 填写所有 REQUIRED 值后:
docker compose \
--env-file deploy/server-running-v0.7.1/.env \
-f deploy/server-running-v0.7.1/compose.managed-data-plane.yaml \
config --quiet
.env受Git忽略。生产密钥必须由服务器上的0600文件或云Secret管理注入。
不进入 Gitea 的内容
- 当前服务器
.env和所有API Key、Token、密码、SYSTEM_AES_KEY; - PostgreSQL、Redis、Elasticsearch、Neo4j、ClickHouse数据卷;
- OSS对象、上传文档、
/data/files、日志、缓存和验收中的业务数据; - 已构建的DobotAI二进制;
- 旧的本地API Adapter目录。Adapter和DobotAI必须使用各自独立仓库及固定Commit部署。
新服务器迁移边界
此分支固化了“代码和部署契约”,不等于已经迁移数据。迁移时还必须单独完成:
- PostgreSQL原生逻辑备份和隔离恢复验证;
- OSS对象清单、大小和SHA-256核对;
- Elasticsearch索引重建或受控迁移;
- 保管并恢复原
SYSTEM_AES_KEY,否则数据库内模型凭据无法解密; - 健康、文档解析、混合检索、引用、图片、Agent和Adapter端到端验收;
- 回滚副本验证。
v0.7.1 PostgreSQL连接当前使用sslmode=disable。接入阿里云RDS时必须走私有VPC;若目标强制TLS,需要先改造并验证连接配置,不能直接上线。