OpenBitFun 独立数据迁移器

September 8, 2026 · View on GitHub

English

这是一个可选的独立桌面工具，用于将旧版 BitFun 数据导入 OpenBitFun。 无需安装或启动主应用；工具有自己的窗口、版本和配置，完成后只关闭自身。 主应用不会捆绑、自动下载、自动启动迁移器，也不会因为旧版数据而阻止正常启动。

下载和使用

在 GitHub Releases 寻找 OpenBitFun Data Migrator、标签以 data-migrator-v 开头的独立发布。 迁移器不在主应用安装包内；如果尚未列出独立发布，请按下文从源码构建。

系统下载文件启动方式
Windows x64openbitfun-data-migrator-v<版本>-windows-x64.zip解压后双击 openbitfun-data-migrator.exe
macOS Apple Siliconopenbitfun-data-migrator-v<版本>-macos-arm64.dmg打开 DMG 中的迁移器
macOS Intelopenbitfun-data-migrator-v<版本>-macos-x64.dmg打开 DMG 中的迁移器
Linux x64openbitfun-data-migrator-v<版本>-linux-x64.AppImage添加可执行权限，在桌面会话中启动

Windows 需要 Microsoft Edge WebView2；macOS 使用系统 WebView，Linux 包以 Ubuntu 22.04 为构建基线。迁移不需要登录或联网，目前不产出 Windows/Linux ARM 安装包。

  1. 关闭 BitFun、OpenBitFun、CLI 实例及其后台数据写入进程。
  2. 启动迁移器，检查来源和目标目录。两侧各有设置与数据、主目录数据、Skills、SSH 四个位置；如需修改，先点击“使用这些目录”。
  3. 选择迁移范围，扫描数据，再运行预检。
  4. 确认目标、范围和冲突后开始迁移。发现已知写入进程时会等待其退出，不会强制终止进程。
  5. 查看结果，根据提示重新登录或修复路径，关闭迁移器，再自行打开 OpenBitFun。

界面使用离线打包的共享设计系统，跟随系统深浅色和高对比度设置，并提供中英文切换。

支持范围与数据保护

声明支持的来源是 BitFun >=0.2.0,<1.0.0，仓库保存的集成验证样本是 0.2.19。 支持以实际数据格式和各领域校验为准，不代表已验证范围内的每个旧版本。 未知格式、损坏数据会明确报告并保留。

扫描会按单个会话、运行事件日志、Skill、MiniApp 和 Agent 定义隔离异常；有效条目继续迁移， 跳过的条目保留在来源中并记录到报告。旧会话的 Turn 计数以实际文件为准，仅在迁移副本中重建。 整个数据域不可用时，只跳过该域及依赖它的域。执行时某域失败会先回滚，再继续无依赖的数据域； 无法安全回滚时仍会停止。请在重试前查看警告与迁移报告。

目标是 OpenBitFun：配置 schema 1、工作区格式 1、任务协调数据库 schema 2， 以及此源码版本共享存储模块支持的会话、记忆、扩展和连接格式。未知产品/配置格式以及 超出支持范围的数据库、会话版本会被拒绝。未来数据格式变更需要发布新的迁移器， 工具版本无需与主应用版本相同；此工具不支持定制品牌产品的数据。

可迁移设置与凭据、用户 Agents/Skills/MiniApps、工作区与会话及任务记录、记忆、 本机保存的远程连接与设备记录。已有目标值优先，部分冲突会按领域规则保留双方。 缓存、锁、进程发现文件、内置可执行内容和请求追踪不迁移；不可解密的凭据需重新登录。

来源不会被自动删除。写入使用一致性快照、暂存、校验、备份、迁移锁和原子替换。 迁移期间请保持相关应用关闭；取消或关闭窗口会等到安全边界，已验证完成的领域可能已导入。

协调数据库不再要求历史 Session/Turn 引用、父子关系、计数、时间戳或 Swarm 层级完整有效。 无法解析或不能写入目标表约束的记录会单独跳过；缺少 Agent 主键映射的任务也单独跳过， 不会误挂到目标库中同号的 Agent。合并仍保持目标已有记录优先，并映射新增 Agent 主键和任务引用。 导入历史任务状态不会启动或恢复 Agent 执行。

中断恢复与诊断

任务保存在：

<目标设置与数据目录>/data/migrations/bitfun-to-openbitfun/runs/<任务 ID>/

重新打开迁移器，选择原来的目录，在“历史迁移任务”中查看或恢复。恢复会校验计划、 来源指纹和原目录，并沿用日志，不受原来十分钟交接请求有效期限制。 已完成任务仍可查看报告；新扫描会创建新任务，不会覆盖旧日志。 旧版交接流程留下的计划与日志仍可读取，即使 request.json 已过期；恢复前须选择原目录。 无法读取的任务文件不会被删除或重置。

迁移器只在自己的 com.openbitfun.data-migrator 配置目录中记住所选位置，不写主应用的 引导或提醒状态。“导出失败诊断”生成包含结果码和执行阶段的去敏文件。 完整本地报告与备份可能含敏感信息，请保留在本机。

迁移器只操作运行电脑可访问的文件，不接入远程工作区执行、远程控制、Peer Device Mode 或 Detached Dispatch。请在数据所在电脑上运行；迁移连接记录并不连接或迁移远端主机。

开发与独立发布

安装 Rust、Node、pnpm 和对应系统的 Tauri 构建依赖后，在仓库根目录执行：

pnpm install
pnpm run data-migrator:dev       # 独立窗口，无需主应用或开发服务器
pnpm run data-migrator:build     # 独立发行包
cargo build -p openbitfun-data-migrator --bin openbitfun-data-migrator

直接 Cargo 构建使用已提交的静态 UI 和设计系统 CSS。修改主题源后运行 pnpm run data-migrator:theme:generate；独立打包入口会自动生成。 主应用开发和构建不再构建迁移器。两者仍在同一源码工作区共享稳定的数据契约和存储模块， 以保证格式一致，但迁移器不依赖主应用 Core、运行时组装、Web UI、安装器或更新器。

版本由迁移器自己的 Cargo.toml 和 tauri.conf.json 维护。Data Migrator Package 工作流支持手动构建，或通过 data-migrator-v<版本> 标签生成独立发布草稿。 标签发布使用专用的 DATA_MIGRATOR_SIGNING_PRIVATE_KEY、 DATA_MIGRATOR_SIGNING_PRIVATE_KEY_PASSWORD、DATA_MIGRATOR_SIGNING_PUBKEY， 完成签名和校验后创建草稿，审核后再发布。手动运行只生成 CI 构建产物。 迁移器发布不会触发主应用打包或更新源。

每个产物带 SHA-256 校验文件和 base64 编码的 minisign .sig，同时提供 SHA256SUMS 与 data-migrator.minisign.pub。验证签名前应通过可信渠道确认公钥。 独立文件签名不等于 Apple/Authenticode 系统代码签名；当前工作流尚未配置这些证书及 macOS 公证。

开发约束和针对性检查见 AGENTS.md。

损坏旧数据的处理粒度

设置和模型、工作区登记、记忆记录和文件、SSH 连接、Remote Connect 文件和 Bot、会话和扩展均按条目处理。损坏会话仍会恢复可读取的 Turn，重建 Turn 数量和工作区引用列表；相同 Turn 副本去重，身份冲突的 Turn 会跳过并报告。记忆笔记支持嵌套目录。旧记忆库的 jobs 不读取、不迁移，运行时按需创建任务，目标库已有 jobs 保留。Skill 或 MiniApp 不可用不会阻止 Agent 定义迁移。

有独立存储边界的条目在暂存失败时会从提交清单中排除，报告会显示遗漏和会话部分恢复提示。旧数据保持只读；无法读取的目标存储、路径越界、不支持的格式、输入变更和事务写入失败仍会保护相关域，成功回滚后其余独立域可继续。回滚失败时停止执行。