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/WeKnoraWeKnora是一个把文档变成可查询RAG、推理Agent和自维护Wiki的开源LLM知识平台。最新版0.7.2带来知识库文件夹树、分块编辑与修订历史、Wiki版本回滚并修复了含特殊字符密码被破坏、WeCom长连接死锁、MCP stdio协议崩溃等一批问题。这篇WeKnora版本升级指南带你把系统从任意旧版本升到0.7.2。一、先回答一个问题你需不需要升级动手前先对照你现在跑的版本关键差异都记在 CHANGELOG.md 里你的版本主要差距建议 0.7.0没有能力作用域API Key、多实例存储后端、运行时队列面板、文档解析trace时间线该升。0.7.0还批量关闭了SSRF、密钥脱敏、令牌伪造等安全问题0.7.0 ~ 0.7.1没有文件夹树、分块编辑、Wiki修订历史缺0.7.2对特殊字符密码、MCP stdio崩溃的修复该升0.7.2—不用动⚠️ 注意0.7.0 包含破坏性变更CLI v0.10如session continue改名为session resume。如果你的运维脚本调过 CLI 命令升级前先对照 CHANGELOG 里 CLI 小节改一遍。二、动手前检查与备份升级路径是 docker compose 还是源码部署都不影响这四件事备份数据库。WeKnora 默认跑在 Postgres官方 compose 用 ParadeDB 镜像上先把整库导出pg_dump -U postgres -h localhost WeKnora backup_weknora_$(date %F).sql备份数据目录和配置。compose 部署对应根目录的./data、config/config.yaml和.env数据库连接、WEKNORA_VERSION都在这里。确认PG卷磁盘余量。这次新增的迁移000075~000079里有建索引操作GIN/向量索引构建会吃不少临时空间空间不足迁移会中途失败。不用预装迁移工具。docker compose 部署时 WeKnora 每次启动自动执行 golang-migrate就是数据库结构自动升级机制AUTO_MIGRATE默认 true只有源码部署才需要手动跑。三、升级主线按顺序做这几步步骤1把版本钉到0.7.2改 compose 根目录.env里的版本变量别用latest# .env WEKNORA_VERSION0.7.2步骤2拉新镜像并重启docker compose pull docker compose up -d只跑docker compose up -d会复用本地缓存镜像你以为升级了其实没升。官方安装文档专门提示了这个坑见 website-docs/01-getting-started/02-installation.md。步骤3等自动迁移跑完app 容器启动后会顺序执行 migrations/versioned/ 下的增量迁移0.7.2 相比 0.7.1 新增 000075Wiki 修订、000078分块编辑、000079文件夹树几版。docker compose logs app里看到启动日志走到 listen 阶段就说明跑完了。源码部署则手动执行make migrate-up底层是仓库里的 scripts/migrate.sh支持 up/down/version/force/goto。步骤4确认服务活着docker compose ps应看到 frontend、app、docreader、postgres、redis 全部 running/healthy再执行curl -f http://localhost:8080/health返回 200。四、怎么确认升级成功命令通过后还要人工点一遍新功能对应各版本新增的迁移系统信息页设置页确认版本号 0.7.2且 DB 迁移状态没有红色 Migration failed 标签——有这个标签说明迁移失败被回滚了依赖新表的功能不会生效。文件夹树新建知识库上传一个文件夹文档列表侧栏应出现真实目录树可重命名、可换文件夹归位。分块编辑改一个检索分块确认分块详情里有修订历史可 diff、可一键回滚。Wiki 修订打开任意 Wiki 页面版本抽屉应列出历史版本、行级 diff 和回滚按钮。0.7.0 升级者加测进 API Integration Playground 创建一个能力作用域 API Key 并实际调用一次。0.7.2 加测用带特殊字符如!、?的密码注册或重置一次确认可正常登录——这是本版本修的 bug。✅ 全部通过升级完成。五、卡住了常见故障速查完整排查流程在 docs/migration-troubleshooting.md这里摘三个高频场景现象1启动报迁移失败Wiki、知识图谱等功能静默不产出原因多半是 PG 缺扩展pg_trgm/vector/pg_search或数据库角色权限不足失败的迁移已被自动回滚。先看错误里的版本号对照migrations/versioned/下的.up.sql找到出错的语句用 psql 手动跑一遍拿到具体报错。缺扩展时以超级用户执行CREATE EXTENSION IF NOT EXISTS pg_trgm; CREATE EXTENSION IF NOT EXISTS vector;然后重启 WeKnora下次启动会从失败处继续。现象2database is in dirty state at version N上一次迁移中途崩溃OOM、容器被杀导致状态表变脏。执行make migrate-force versionN-1 make migrate-up或直接重启容器——新版本默认开启自动恢复AUTO_RECOVER_DIRTYtrue启动时会自己 force 加重跑。现象3页面版本号和你拉取的 release 对不上漏了docker compose pull跑的是本地缓存镜像。补跑 pull 再docker compose up -d即可。新功能的用法细节看仓库内官方文档站 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），仅供参考
