WeKnora 版本升级实操指南3 步从旧版本升到 0.7.2【免费下载链接】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 0.7.2 是近三个月最实的一版分块可以在线编辑和回滚、知识库多了文件夹树、文件 URL 可以直接给第三方加载、MCP 服务器也补齐了 HTTP/SSE 传输。如果你已经部署了旧版实例这次升级就是改个版本号、拉镜像、重启容器——数据库结构迁移在启动时自动完成不需要你手写任何 SQL。旧版和 0.7.2 差在哪先看这张对比表10 秒判断你要不要升项目0.7.x 之前0.7.2文档组织平铺列表找不到文件侧边栏文件夹树支持就地重命名、拖拽归类分块管理解析错就没法改UI 直接编辑版本快照可 diff、一键回滚索引自动重建文件交付第三方应用要再走一次/files鉴权代理resource_urlspublic直接返回可加载的 http(s) URLMCP 服务器缺 HTTP/SSE 传输官方 PyPI 包tencent-weknora-mcp工具扩到 29 个部署简化聊天记忆依赖 Neo4jNeo4j 会话记忆管线移除基础设施少一套有团队在用知识库的、接了外部应用的基本都值得升。核心路径4 个节点走完全程节点 1备份数据库升级前先留后路。用pg_dump把 PostgreSQL 里 WeKnora 的库整库导出一份pg_dump -U ${DB_USER} -h ${DB_HOST} -p ${DB_PORT} ${DB_NAME} backup_before_upgrade.sql确认备份文件非空就行后面任何一步出事都能恢复。节点 2改版本号拉镜像重建容器打开项目根目录的.env把WEKNORA_VERSION改成目标版本比如0.7.2或者干脆保持latest。然后拉取匹配镜像并用新镜像重建容器docker compose pull docker compose up -d⚠️ 怎么确认做对了只跑up -d不 pull 会复用本地缓存镜像页面显示的还是旧版本。跑完后docker compose ps里各容器都是 healthy、且 Web 界面右下角版本号已变化才算数。如果你是全新部署还没 clone 过仓库从https://gitcode.com/GitHub_Trending/we/WeKnora拉代码、cp .env.example .env之后再走上面两步。节点 3数据库迁移自动执行失败才需要插手WeKnora 每次启动都会自动跑golang-migrate迁移AUTO_MIGRATE默认开启0.7.2 新增的 5 个迁移文件文件夹路径、分块编辑、Wiki 修订等会按序应用。正常情况下你什么都不用做。如果想在服务进程外手动跑用仓库自带脚本即可make migrate-up怎么确认做对了打开系统信息页数据库版本显示为最新且没有红色 Migration failed 标签。节点 4验证功能上传一篇测试文档走完解析流程再随便问一句 RAG 问题答案带引用就通了。顺手看一眼docker compose logs app开头几行确认没有Database migration failed字样。容易踩的 3 个坑坑 1页面版本号没变、新功能不出现现象明明up -d成功了但 UI 还停留在旧版。原因up -d复用了本地缓存镜像等于原地重启。处理在.env里把WEKNORA_VERSION显式设为目标版本重新docker compose pull docker compose up -d。官方 README 里专门标注了这条别偷懒省掉 pull。坑 2服务一切正常但某个功能悄悄没输出现象页面能登录、聊天能回答但 Wiki 生成、知识图谱这类下游功能没动静。原因迁移失败时失败的那一步会被回滚但应用仍然启动成功依赖新表的特性就静默失效了。处理以容器日志里的完整报错为准不是 UI 截断版按 docs/migration-troubleshooting.md 的清单对号入座最常见的是扩展缺失pg_trgm/vector、角色权限不足、建索引时磁盘写满。修完重启迁移会从断点继续。坑 3报database is in dirty state at version N现象启动日志里出现 dirty state 错误。原因上次迁移跑到一半被掐断OOM、容器被杀golang-migrate 把 schema 标记成了脏状态。处理新版默认AUTO_RECOVER_DIRTYtrue重启即自动 force 重试若你关掉了它手动执行make migrate-force versionN-1再make migrate-up。升级之后能干嘛分块编辑 版本回滚之前解析错了只能删了重传现在直接在文档详情页点开分块改内容每次编辑都会存一个修订快照。改完索引自动重建检索结果立刻生效。改崩了打开修订历史抽屉左右对比 diff点回滚即可。文件夹树批量上传一个目录后文档不再挤成一平铺列表——侧边栏出现真实目录树文件夹可以就地重命名文档可以拖到别的文件夹。散落上传的单个文档会挂在树的根节点不会再失踪。整套升级就是改版本号 → pull → 重启三件事数据结构的事系统替你办了。卡住时查 docs/migration-troubleshooting.md 排迁移问题环境变量和部署细节翻website-docs/升级前想核对某个版本到底改了什么看根目录 CHANGELOG.md 对应条目即可。【免费下载链接】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），仅供参考