
WeKnora 版本升级指南3 步把旧实例升到 0.8.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.8.2 的升级只有三件事改.env里的版本号、docker compose pull拉新镜像、重建容器。数据库结构迁移在启动时自动执行全程不用手写任何 SQL。新版多了什么工作区要自己给客户端配 MCP → 内置 MCP Server每个工作区在 设置 → 集成 → MCP Server 发布/mcp/endpoint_id端点页面直接生成 mcpServers 配置token 可轮换技能、MCP 服务散落在设置页各处 → 收进侧边栏 Toolbox旧设置链接自动跳转会话跑错了只能从头再问 → 支持追加要求、从任意历史问题分叉、原地回滚到检查点生成的文件只在对话里散落 → Artifacts 产物库按类型和日期汇总全部会话产物带版本历史沙箱只能执行技能 → 沙箱面板新增可重连终端和浏览器端 XFCE 桌面升级分三步走第一步备份数据库记下现状升级前用pg_dump整库导出一份占位符按.env里的实际值替换pg_dump -U ${DB_USER} -h ${DB_HOST} -p ${DB_PORT} ${DB_NAME} backup_before_upgrade.sql怎么算做完了备份文件非空。⚠️ 再打开.env看一眼SYSTEM_AES_KEY这行——0.8.2 起新部署才生成密钥旧部署必须原样保留改了就解不开库里存的凭据。顺手记下当前版本docker compose exec app curl -s localhost:8080/api/v1/system/info | head -c 200第二步改版本号、拉镜像、重建容器打开.env把WEKNORA_VERSION从latest显式改成0.8.2然后按顺序执行docker compose pull docker compose up -d⚠️ 顺序不能反只跑up -d不 pull会复用本地缓存镜像等于原地重启页面还是旧版本。怎么算做完了docker compose ps里 app、frontend、docreader 全部 healthy刷新页面后右下角版本号显示 0.8.2。第三步确认迁移、走一遍核心流程、扫日志0.8.2 默认AUTO_MIGRATEtrue新增的迁移000091–000110含 MCP 端点、产物库、模型目录、会话检查点等 20 张表/列的变更会按序自动应用。怎么算做完了三条都过才算数打开系统信息页数据库迁移显示正常没有红色 Migration failed 标签上传一篇测试文档等解析完成问一句 RAG 问题答案带引用扫一眼日志关键字docker compose logs app | grep -iE migration failed|dirty state无输出即通过。卡住了先查这里现象up -d成功了但版本号没变、新菜单不出现。原因复用了本地缓存镜像旧版原地重启。 处理在.env里把WEKNORA_VERSION显式写成0.8.2重新docker compose pull docker compose up -d。现象服务正常、能登录能问答但 MCP 端点、Artifacts 这类新功能悄悄没输出。原因某一步迁移失败被回滚但应用仍然启动成功依赖新表的功能静默失效。 处理以容器日志里的完整报错为准不是 UI 截断版按 常见问题与升级排障 对号入座最常见的是扩展缺失、角色权限不足、建索引时磁盘写满。修完重启迁移会从断点继续。现象启动日志报database is in dirty state at version N。原因上次迁移跑到一半被掐断schema 被 golang-migrate 标记为脏。 处理默认AUTO_RECOVER_DIRTYtrue重启即自动 force 后重试如果你关掉了它手动执行make migrate-force versionN-1后再make migrate-up。升级后马上试的新功能内置 MCP Server进 设置 → 集成 → MCP Server 新建一个端点页面直接生成 Cursor / VS Code / Claude Desktop 的mcpServers配置和一行 Claude Code 命令token 支持轮换。Artifacts 产物库点侧边栏 Artifacts 页面跨会话的生成文件按类型过滤、按日期分组点开可看版本历史还能直接删文件。Toolbox 与会话控制侧边栏 Toolbox 里完成技能、MCP 服务和本机浏览器配对回到任一在跑的会话追加要求、从历史问题分叉、原地回滚都在这一次 0.8.2 里给齐了。整条升级路径就是备份 → 改版本号 → pull 重启三步数据库结构的事 0.8.2 替你办了。卡住时查 常见问题与升级排障想核对某个版本具体改了什么翻 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),仅供参考