WeKnora 升级指南LLM 文档理解 / RAG 知识库如何平滑升到最新 0.7.x【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnoraWeKnora 是把原始文档变成可查询 RAG 知识库、推理 Agent 和自维护 Wiki 的开源 LLM 文档理解平台。本文带你从任意旧版本平稳升级到最新 0.7.x先判断风险、再按域动手、边改边验不翻车。升级前先看它改了什么在 0.6.x 到 0.7.2 这一大段区间里真正影响你升级动作的就这么几件事。先扫一眼下表心里有个风险底变更引入版本类型风险你会遇到什么weknoraCLI 命令面重构session resume取代continue、新增model/skills等组0.6.0 / 0.6.3 / 0.7.0破坏性 中旧脚本、CI 里的 CLI 调用会直接失败移除 Neo4j 会话记忆管线0.7.1破坏性 中设置页里相关开关消失Neo4j 依赖可整体撤掉数据库迁移 000061→000079多标签、嵌入渠道、存储后端、Wiki 修订、分块编辑、目录树……0.6.x / 0.7.x结构变更 中启动时自动顺序执行失败可回滚到前一版本安全加固全链路 SSRF 防护、密钥脱敏、refresh token 收紧0.7.0行为变更 中部分走内网的抓取/连接行为可能变严格需要调白名单文档目录树、分块可编辑修订历史、Wiki 版本回滚、多实例存储后端0.7.0 / 0.7.2新功能 低纯增益升级后直接可用注册密码特殊字符修复、SQLite 向量过滤修复、MCP stdio 崩溃修复等0.7.1 / 0.7.2安全/缺陷修复 低建议尽快升级尤其开了 IM/嵌入渠道的结论很简单只要你的数据库不是空的这次升级就必须先备份如果你依赖 CLI 脚本额外预留半小时改命令。你在哪个版本区间先定位再决定怎么升WeKnora 的结构变更全部走版本化迁移migrations/versioned/180 个文件启动时按序自动执行所以不存在必须逐版本跳的硬性门槛——任何旧版都能直升最新版。但跨的区间越大你要人工核对的变更就越多你现在跨过的关键变更升级姿势0.7.0 / 0.7.1只有补丁级迁移拉新镜像、重启五分钟搞定0.6.xCLI 破坏性变更、Neo4j 记忆移除、存储后端多实例走下文四域流程重点核配置≤ 0.5.x上面全部 嵌入渠道/多标签/资源注册表等大版本迁移走四域流程数据库域多留时间判断起点最快的办法看系统信息页里的版本号或docker compose里WEKNORA_VERSION的取值。动手前把数据、文件、依赖先兜住备份按变更域来分而不是按执行顺序——升级时哪个域要动你就翻出对应那份备份。️ 数据库域最重要的那份# PostgreSQL完整逻辑备份 pg_dump -U ${DB_USER} -h ${DB_HOST} ${DB_NAME} weknora_backup_$(date %F).sql # 如果用 ParadeDB 或自建向量库向量数据也一起导出按你的向量库工具 文件域Docker 部署下文件都在命名卷里重点保住这几个data-files用户上传的原始文档对应容器内/data/filespostgres-data数据库主数据./config/config.yaml你的检索与知识库配置config/config.yaml.env镜像版本、JWT、存储后端凭据等全部运行时参数# 卷级备份示例 docker run --rm -v weknora-data-files:/data alpine tar czf># .env 中 WEKNORA_VERSIONv0.7.2或你要的目标 tag docker compose pull docker compose up -d✅ 本域验证docker compose ps里 app / frontend / docreader 全部 healthy浏览器打开系统信息页版本号已是 0.7.2。源码部署则是git pullmake build后重启。数据库域结构怎么升WeKnora 启动时会用golang-migrate自动跑完待执行迁移多数情况下你什么都不用做。想提前单独跑一遍、或排查问题时用仓库自带入口./scripts/migrate.sh up # 或 make migrate-up make migrate-version # 查看当前已到的版本号✅ 本域验证make migrate-version输出的版本号等于 migrations/versioned/ 里最大的那个系统信息页没有红色 Migration failed 标签。配置域合并 .env 和 config.yaml对着新版 .env.example 把你现有的.env过一遍原则是缺的补、废的删0.7.1 之后 Neo4j 会话记忆相关变量可以删掉0.7.0 引入多实例存储后端后检查你原有的对象存储配置是否还在生效config/config.yaml的 key 变动很少但建议 diff 一下示例文件新增项按需补# config/config.yaml —— 保持原有 server / conversation / knowledge_base 段不动 # 只追加新版本示例里出现的缺省项不要整文件覆盖✅ 本域验证重启后日志没有unknown field/ 变量缺失告警设置页各卡片正常加载。前端域资源怎么更新镜像部署推荐前端已经包含在weknora-ui镜像里代码域pull时已一起更新此域无操作。源码构建需要手动重建并部署产物cd frontend npm install npm run build # 将 dist 部署到前端静态目录见 frontend/Dockerfile 的 dist 约定✅ 本域验证强刷页面CtrlShiftR确认新版 UI 元素出现例如知识库列表的目录树侧栏而不是旧版样式。起点不同重点不同上面四域对谁都一样但不同起点有各自的多看一眼从 0.7.0/0.7.1 过来直接 pull 重启数据库域可能只跑一两个迁移重点验证系统信息页版本号即可。从 0.6.x 过来多花 10 分钟在配置域——删 Neo4j 记忆残留、确认 CLI 脚本改过session continue→session resume如果你还开着 Neo4j 容器顺手从 compose 里摘掉。从 ≤0.5.x 过来迁移脚本最多目录树、分块编辑、Wiki 修订、嵌入渠道等全在你身后数据库域验证完再抽测一个老知识库文档列表、历史对话、Wiki 页面都能打开。升级完这样确认没翻车最后一轮端到端验收按这个清单点一遍每项都过才算完docker compose ps所有服务 healthy无重启循环系统信息页版本号正确无Migration failed 标签登录 → 进入任一老知识库历史文档和聊天会话可正常打开上传一份新 PDF/Markdown走完解析→检索→回答全流程引用来源正确抽一个老文档做 RAG 提问回答能命中原文用了 CLI/嵌入渠道/IM 渠道的各跑一条最常用命令或发一条测试消息Wiki 与任务队列Runtime Queues 面板有正常流转不静默为空翻车了对着症状查别急着回滚先拿症状对下表——绝大多数升级故障都在这几条里启动后系统信息页出现 Migration failed 红标但 UI 还活着→ 应用会保留可访问状态帮你诊断。先抄下容器日志里Database migration failed:后面的完整报错然后对照 docs/migration-troubleshooting.md 的通用诊断清单定位报错版本号对应的migrations/versioned/N_*.up.sql手动复现那条语句拿到精确错误。报错含gin_trgm_ops does not exist/type vector does not exist→ 缺 PostgreSQL 扩展。用超级用户进库执行CREATE EXTENSION IF NOT EXISTS pg_trgm;、CREATE EXTENSION IF NOT EXISTS vector;ParadeDB 环境补pg_search确认pg_extension里真的加载后再重启。database is in dirty state at version N→ 上次迁移中途被打断留下的脏状态。make migrate-force versionN-1然后make migrate-up新版默认AUTO_RECOVER_DIRTYtrue直接重启也能自动恢复。No space left on device或建索引失败→ GIN/pgvector 索引吃临时空间。给 PGDATA 卷腾出至少 2 倍数据量的余量后重启迁移会自动续跑。页面还是旧版 UI或白屏→ 前端镜像没拉到docker compose pull时漏了 frontend或源码模式下 dist 没重建。拉weknora-ui对应 tag 后docker compose up -d frontend。升级后老脚本/CI 里的 CLI 命令全挂→ 0.7.x 的 CLI 是破坏性重构。对照新命令面逐项改session resume、kb config set、doc reparse等退出码契约也变了。升级后 RAG 搜索静默返回空→ 十有八九是迁移没跑完导致新表/索引缺失回到数据库域把migrate-version对齐到最新再重启让自动恢复接管。升级后顺手做这两个增值动作性能把并发与可观测性用起来。0.7.x 引入了按模型并发治理和 Runtime Queues 面板——给WEKNORA_MODEL_MAX_CONCURRENCY一个贴合你模型配额的数值默认 32然后打开 Runtime Queues 观察各阶段队列深度再挂上 Langfuse已迁到 OTLP 标准提示词缓存命中率、检索/重排耗时都能直接看到调参有依据。详见 docs/worker-pool-governance.md。安全按最小权限收敛。0.7.0 之后的安全加固值得用足给自动化流程发带 capability 范围的租户 API Key别再图省事用 owner 角色嵌入渠道配域名白名单限流.env里的 JWT/AES 密钥在升级后确认没被示例值覆盖对外只暴露 API 与前端两个端口。收尾到这里你的 WeKnora 已经从旧版完整走到了 0.7.x数据库迁移自动对齐、配置合并干净、四域各自验证过——升级这件事最忌讳的盲跳版本在版本化迁移面前已经被拆成了四个可控的小动作。想继续看部署与配置细节website-docs/常见问题速查docs/QA.md迁移故障完整诊断docs/migration-troubleshooting.md下期预告《WeKnora RAG Pipeline 调优指南检索、重排与提示词缓存的实战参数》【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考