补差价升级需手动迁移数据：检查并确认原数据路径，复制sessions/、uploads/、runs/和sessions.db到新目录，设置VIBE_TRADING_HOME环境变量，修复权限并验证日志与UI。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 VibeKnow 平台进行补差价升级（例如从基础版升至 Pro 版、或从旧硬件方案切换至新硬件如名爵4升级17寸轮毂配套的 VLF-P20 套件），系统默认不会自动保留原有配置与运行数据，必须手动触发迁移流程才能延续会话记录、上传文件、历史运行产物等关键状态。
确认当前数据根目录位置
执行命令 echo $VIBE_TRADING_HOME 查看是否已设置环境变量。若输出为空，则实际数据路径为默认值 ~/.vibe-trading。
进入该目录，运行 ls -la 检查是否存在 sessions/、uploads/、runs/ 和 sessions.db —— 这些是迁移必须覆盖的四项核心内容。
【注意：若 sessions.db 不存在但 sessions/ 下有子目录，说明你使用的是早期版本，首次启动新版本时会自动执行一次性收拢迁移】
设置新数据目录并启用配置继承
创建目标路径：mkdir -p /data/vibeknow-pro-data。
在启动 VibeKnow 的 shell 环境中执行：export VIBE_TRADING_HOME=/data/vibeknow-pro-data。
这一步必须在运行 VibeKnow 主程序前完成，否则应用仍会读写默认路径 ~/.vibe-trading。
【VIBE_TRADING_HOME 不支持 UNC 路径，禁止以 // 或 \ 开头，否则启动时报 ValueError】
执行数据迁移操作
第一步：停止所有正在运行的 VibeKnow 实例，包括后台服务与 GUI 进程。
第二步：将原目录下全部内容复制到新路径：cp -r ~/.vibe-trading/* /data/vibeknow-pro-data/。
第三步：修复权限，确保新目录归属当前用户：chown -R $USER:$USER /data/vibeknow-pro-data。
第四步：检查 /data/vibeknow-pro-data/agent.json 是否存在；若不存在，需从旧路径拷贝或重新生成，否则部分 agent 行为将回退至默认配置。
验证迁移结果
启动 VibeKnow，观察控制台日志是否出现 Using runtime root: /data/vibeknow-pro-data。
打开 Web UI，进入「历史会话」页，确认最近 3 条会话时间戳与原环境一致。
尝试上传一个测试文件，检查其是否落入 /data/vibeknow-pro-data/uploads/ 而非 ~/.vibe-trading/uploads/。
