免费开源AI软件.桌面单机版,可移动的AI知识库,察元 AI桌面版:装错位置怎么办 把已建知识库连数据带配置搬到新目录
装错位置怎么办 把已建知识库连数据带配置搬到新目录第一次装察元AI 桌面单机版的时候CHAYUAN_ROOT 被默认放在了 C 盘。后来 C 盘空间紧张知识库膨胀到几个 G对话历史也越积越多意识到这个目录该挪到别的分区。或者更糟糕的是你装在了 OneDrive 同步的目录里发现性能受影响。这一篇讲怎么把 chayuan-desktop 的整个状态从一个目录搬到另一个目录。先理解清楚 CHAYUAN_ROOT 的指向是怎么决定的。Tauri 主进程在启动时会读自己的配置文件在 AppData 或 ~/.config 下找到上次记的 CHAYUAN_ROOT 路径再以环境变量的形式注入给 sidecar 子进程。所以搬目录这件事的关键是改 Tauri 那一份配置让它指向新位置。第一步关闭 chayuan-desktop。任务管理器或 ps 命令确认 chayuan-server sidecar 也已经退出。这一步必做否则 SQLite 文件正在被使用搬过去之后会损坏。第二步确认旧 CHAYUAN_ROOT 路径。打开 chayuan-desktop 关掉的话进不去那就去 Tauri 配置目录里看。Windows 上通常是 %APPDATA%\com.chayuan.desktop\config.json 或类似路径。打开看 dataDir 字段就是当前 CHAYUAN_ROOT。或者你之前自己选的位置记得就直接用。第三步把整个旧 CHAYUAN_ROOT 目录复制到新位置。注意不是移动先复制确认新位置完整无误再删旧的。复制时如果目录大含 vectors 几个 G用 robocopyWindows或 rsyncLinux/macOS效率高于资源管理器拖拽。命令示例robocopy “C:\OldChayuan” “D:\Chayuan” /E /COPYALLrsync -avh /old/chayuan/ /new/chayuan/。第四步改 Tauri 配置指向新目录。打开 config.json把 dataDir 改成新路径保存。注意路径的反斜杠在 JSON 里要转义Windows 路径写成 D:\Chayuan 或者用正斜杠 D:/Chayuan 都可以。改完文件存盘。第五步启动 chayuan-desktop 验证。主界面打开后看历史对话是否在、知识库列表是否在、模型供应商是否在。挑一个老对话点开看是否能正常加载新建对话挑一个 KB 问问题看引用气泡是否能展开原文。第六步删旧目录。前面五步都没问题再把旧 CHAYUAN_ROOT 删掉。如果想保留备份把旧目录打成 zip 存到外置硬盘。迁移过程中可能遇到的问题。第一路径中有中文或空格。Tauri 和 sidecar 都支持中文路径但部分 PyInstaller 打包的扩展特别是 sqlite-vec在中文路径上偶尔出问题。建议新目录用纯英文路径比如 D:\Chayuan 而不是 D:\察元数据。第二folder-sync 知识库的源路径失效。folder-sync 类型的 KB 记录的是文件夹路径比如 D:\Documents。如果你只是搬 CHAYUAN_ROOTfolder-sync 源路径不变没事。如果同时换了源文件夹位置进 KB 设置里改源路径再触发完整重扫。第三模型权重没拷过去。CHAYUAN_ROOT/models 里有 bge-m3-onnx、RapidOCR、bce-reranker 等权重复制时一定要带上否则首启动会重新下载。如果是无外网环境下载失败会让 RAG 入库失败。第四credentials 目录的密钥派生跟操作系统用户绑定但跟 CHAYUAN_ROOT 路径无关。所以同一台电脑搬目录钥匙仍然能用。换电脑搬目录才会失效。第五logs 目录里的旧日志可以一起拷过去但建议直接删掉重建新位置的诊断信息会更清晰。国产化支持下的几个细节。麒麟 UOS 上跨分区拷贝大目录建议用 cp -ar 加 rsync 双重确认龙芯架构上注意目标分区文件系统不要是非主流的格式否则 sqlite-vec 加载有时不稳ARM 架构机器上模型权重 ONNX 文件可以通用不需要重新下载。WPS AI 插件 chayuan-wps 不需要任何改动。它通过 127.0.0.1:62581 连后端CHAYUAN_ROOT 在哪不影响连接。重启 chayuan-desktop 后加载项立刻可用。整套搬目录流程做完察元AI 的所有积累都跟着新目录走了。免费开源的AI软件 在数据可移动性上的优势在这种场景下体现得最直接。