WeKnora 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/WeKnora已部署旧版 WeKnora 的实例想升到 0.7.2实际操作只包含三件事备份数据库、改一个版本号、用新镜像重建容器。数据库结构变化由系统在启动阶段自动完成你不需要手写任何 SQL。全文按是否值得升 → 升级前准备 → 执行与验收 → 故障修复 → 新能力验收的顺序展开每一步都给出可核对的完成标志。这次升级带来什么0.7.2 与旧版的行为变化先回答值不值得动线上实例。相对 0.7.x 之前的版本0.7.2 在五个方面改变了默认行为维度旧版本的表现0.7.2 的表现文档组织平铺列表文件多了很难找侧边栏文件夹树支持就地重命名与拖拽归类分块处理解析出错只能删掉重传UI 内直接编辑快照可 diff、可一键回滚索引自动重建文件交付第三方应用需经/files鉴权代理二次调用resource_urlspublic直接返回可加载的 http(s) URLMCP 服务器缺少 HTTP/SSE 传输官方 PyPI 包tencent-weknora-mcp工具数量扩至 29 个部署依赖聊天记忆依赖 Neo4jNeo4j 会话记忆管线移除基础设施少一套维护知识库、或有外部应用集成 WeKnora 的团队以上任一项都足以构成升级理由。完整的逐版本改动见根目录 CHANGELOG.md 中 0.7.2 对应条目。升级前准备整库备份与版本号固定先用 pg_dump 导出整份数据库结构迁移虽然自动执行但出问题时唯一的恢复手段就是你手里的备份。把 WeKnora 使用的 PostgreSQL 库完整导出一份pg_dump -U ${DB_USER} -h ${DB_HOST} -p ${DB_PORT} ${DB_NAME} backup_before_upgrade.sql验收点备份文件存在且非空。把 WEKNORA_VERSION 固定到目标版本打开项目根目录的.env将WEKNORA_VERSION显式设为0.7.2或保持latest不变。显式指定目标版本可以避免latest在拉取时漂移到其他版本也让升级是否到位多出一个可核对的依据。全新部署、尚未 clone 过仓库的话先从https://gitcode.com/GitHub_Trending/we/WeKnora获取代码执行cp .env.example .env然后按下面正常流程操作。数据库结构本身不用提前处理启动时系统会自动按序应用 0.7.2 新增的 5 个迁移文件文件夹路径、分块编辑、Wiki 修订等。执行升级两条命令拉镜像并重建docker compose pull docker compose up -dpull负责取回与版本号匹配的镜像up -d让各容器以新镜像重建。注意up -d本身不检查镜像新旧跳过pull它会直接使用本地已有镜像。如果不想进入服务进程等自动迁移也可以在仓库外手动触发make migrate-up完成标志全部满足才算升完docker compose ps中各容器状态为 healthyWeb 界面右下角显示 0.7.2系统信息页里数据库版本为最新、无红色Migration failed标签docker compose logs app开头几行没有Database migration failed字样上传一篇测试文档走完解析流程随后提一个 RAG 问题答案带引用来源即说明检索链路正常。三类失败信号根因与恢复动作升级后页面版本号没有变化根因本地缓存镜像被复用up -d实际只是原地重启容器还在跑旧版本。恢复动作在.env里显式设置WEKNORA_VERSION重新执行docker compose pull与docker compose up -d。应用正常启动Wiki 或图谱功能却没有任何输出这是最容易被忽略的一类。迁移失败时失败的那一步会被回滚但应用仍然能启动成功——依赖新表的特性就静默不可用了登录、聊天这些不依赖新结构的功能照常工作。恢复动作以容器日志中的完整报错为准不要只看 UI 上的截断信息对照 迁移失败排查清单 逐项核对。高频根因特征处理缺少pg_trgm/vector扩展建表或建索引时报错在 PostgreSQL 中补齐扩展数据库角色权限不足permission denied类报错为角色授予建表、建索引权限磁盘写满建索引阶段中断清理空间后重启迁移从断点继续修完后直接重启服务迁移会从断点继续执行无需从头再来。启动日志出现 database is in dirty state at version N根因上一次迁移执行到一半被掐断OOM、容器被杀golang-migrate 把 schema 标记成了脏状态。恢复动作新版本默认AUTO_RECOVER_DIRTYtrue重启即自动 force 后重试若你关闭了该开关手动执行make migrate-force versionN-1 make migrate-up0.7.2 新能力的验收方法分块编辑与版本回滚。进入文档详情页点开某个分块即可修改内容每次编辑都会存一个修订快照改完后索引自动重建检索结果立即生效。改错时打开修订历史抽屉做 diff 对比点回滚恢复。文件夹树。批量上传一个目录后文档不再挤在平铺列表里——侧边栏出现真实目录树文件夹可就地重命名文档可拖入其他文件夹散落上传的单篇文档会挂在树的根节点不会再失踪。文件 URL 直达。响应按请求参数或部署配置返回resource_urlspublic时聊天回答、引用、知识检索和嵌入渠道直接给出可加载的 http(s) URL第三方应用不必再对/files代理做一次鉴权调用。MCP 服务器。HTTPstateless_http与 SSE 传输恢复可用官方 PyPI 包为tencent-weknora-mcp工具总数扩至 29 个。遇到问题去哪找答案需要核对某个版本具体改了什么翻 CHANGELOG.md 对应条目迁移报错了按 docs/migration-troubleshooting.md 的清单对号入座环境变量和部署细节website-docs/目录下的文档站点按主题分好了章节。升级这件事做完备份、拉镜像、重启之后剩下的就是按上面的完成标志逐项打勾。【免费下载链接】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），仅供参考