企业官网建设流程全解析

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/WeKnora

WeKnora 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_MIGRATE=true，新增的迁移（000091–000110，含 MCP 端点、产物库、模型目录、会话检查点等 20 张表/列的变更）会按序自动应用。

怎么算做完了，三条都过才算数：

1. 打开系统信息页，数据库迁移显示正常，没有红色 Migration failed 标签；
2. 上传一篇测试文档等解析完成，问一句 RAG 问题，答案带引用；
3. 扫一眼日志关键字：

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_DIRTY=true，重启即自动 force 后重试；如果你关掉了它，手动执行make migrate-force version=<N-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