部署与维护

从 Bridge 迁移

在 Mac 上预检并导入旧 Bot、群和会话，核对导入结果。

使用指南5 分钟

更新于 2026-11-04

用过 Feishu Codex Bridge 的 Mac，可以把旧 Bot、群绑定和设置带到 Vonvon Bot。导入一次处理检测到的全部 Bot；先读预检结果和迁移变化，再决定是否开始。本版仅支持 macOS 上的旧 Bridge 数据，不从 Windows、WSL 或 Linux 导入。

流程示意：预检只读取旧数据；导入完成后仍需逐个检查连接。

开始前检查什么

在原来运行 Bridge 的 Mac 上打开 Vonvon Bot，进入全局「设置 → Bridge 导入」。如果检测到旧 Bridge，会出现「从 Bridge 导入」。若没有找到旧数据，先确认旧目录仍在这台 Mac 上，并点「重新检测」；不要在另一台设备上凭相同的 Bot 名称重建导入。

点「查看导入」进入预检。它只读取旧数据，不会停止 Bridge。预检会列出 Bot 数量、群绑定、连接凭据、工作区、旧服务和审批 Hook 的状态。只有显示“可以导入”、且列出的 Bot 与群符合预期，才继续。遇到“需要处理”，按页面逐项修复后重新检查。

导入会沿用原来的飞书应用，转入 Bot、群绑定、模型与规则设置和管理员名单，也会接续原有的 Codex 线程、Claude 会话、评论提示词与已发文件记录。原群目录继续作为工作区，不会自动搬运文件。

有些旧行为会变化：群设置转换为规则模式；管理员与访客权限不同时取较严格的一档；多 Bot 群各自只参与自己的话题。旧版“咖啡一下”不再提供，旧审批 Hook 会移除，审批回到原终端。日志、缓存、已下载的 Claude SDK 和 Codex Fast 不迁移。

请保留旧 Bridge 目录和原来的 Codex 用户目录。原有项目与旧会话还可能用到其中的文件；导入完成也不要立刻清理。确认迁移变化后勾选「我已了解迁移变化」，按钮才可用于开始导入。

在预检结果中再次核对 Bot 和群，确认没有“需要处理”的问题。
勾选已了解迁移变化，点击「开始导入」。它会停止旧 Bridge、保护旧数据、转换资料并连接飞书 Bot。期间让 Vonvon 保持运行。
观察进度直到显示「导入完成」；打开导入回执，核对 Bot 与群的数量和名称。
回到 Bot 列表，逐个打开「连接与设置」检查飞书权限、事件与卡片回调；再到测试群发一条真实消息，确认 Bot 能回复。旧 Bridge 的部分权限可能需要在飞书后台补开和发布。

“导入完成”说明迁移步骤结束，不代表每个 Bot 都已经完成飞书连接验收。若页面暂时只检测到完成记录而没有详细回执，可以继续检查 Bot 的连接与权限，并在需要时重新打开导入状态。

出现“导入没有完成”时，先读页面给出的原因和当前步骤。若显示「已回滚」，旧数据已保留；处理问题后重新检测与预检。若显示「回滚尚未完成」且提供「重试回滚」，先用它完成恢复，再继续检查。不要删除旧 Bridge 目录。

如果窗口断开或提示正在重新连接导入状态，后台操作可能仍在继续。重新打开「Bridge 导入」查看进度或上次结果，别马上再点一次「开始导入」。如果一直读不到结果，到「设置 → 诊断」查看后台日志，并记录页面错误文字、Vonvon 版本与 macOS 版本后反馈。

先在Provider 检测确认当前 Mac 的 Codex 或 Claude 可用，再按Bot 不回复的排错步骤检查每个群。需要让其他电脑管理这台 Mac 时，再看远程连接。