从旧版迁移
将 ReaderCopilot (小幻阅读旧版) 数据迁移到 Rodel.Reader
如果你之前使用过 ReaderCopilot（小幻阅读旧版），可以通过官方提供的命令行工具将数据迁移到新版 Rodel.Reader。
支持的迁移内容
| 模块 | 迁移内容 |
|---|---|
| 书籍 | 元数据、书架、阅读进度、书签、批注、PDF 批注、书籍文件 |
| 漫画 | 元数据、书架、阅读进度、漫画文件/目录 |
| RSS | 订阅源、分组、文章缓存、已读/收藏/稍后阅读状态 |
| 播客 | 播客订阅、剧集缓存、播放进度 |
注意
- 封面图片不会被迁移，新版应用首次打开书籍/漫画时会自动从文件中提取封面
- 哔哩哔哩播客订阅无法迁移，新版应用不支持此功能
- 外部同步服务（如 Inoreader、Feedbin）可能需要在新应用中重新登录认证
前置条件
- 安装 .NET 10 SDK
- 确保你知道旧版书库的目录位置（通常包含
bookStore.sqlite文件） - 准备一个空文件夹作为新书库目录
安装迁移工具
打开终端（PowerShell 或命令提示符），运行：
dotnet tool install --global Richasy.ReaderCopilotMigration安装成功后，你可以使用 readercopilot-migration 命令。
迁移步骤
第一步：找到旧版书库目录
旧版书库目录通常包含以下文件：
旧版书库/
├── bookStore.sqlite # 书籍数据库
├── mangaStore.sqlite # 漫画数据库（如有）
├── RssCache/ # RSS 缓存（如有）
├── PodcastCache/ # 播客缓存（如有）
└── Books/ # 书籍文件如果你不确定目录位置，可以在旧版应用的设置中查看"库路径"。
第二步：执行迁移
运行迁移命令，替换路径为你的实际目录：
readercopilot-migration -s "D:\ReaderCopilot\Library" -t "D:\RodelReader\Library"参数说明：
-s或--source：旧版书库目录-t或--target：新版书库目录（必须为空或不存在）
工具会显示迁移进度和统计信息。
第三步：启动新版应用
迁移完成后：
- 启动小幻阅读
- 在欢迎页面选择打开现有书库
- 选择迁移目标目录（即
-t参数指定的目录）
应用会加载迁移后的数据，包括所有书籍、漫画、RSS 订阅和播客。
高级选项
模拟运行
在实际迁移前，可以先预览将要迁移的内容：
readercopilot-migration -s "D:\旧书库" -t "D:\新书库" --dry-run模拟运行不会实际写入任何数据，只显示源数据统计。
详细日志
如果迁移过程中出现问题，可以启用详细日志：
readercopilot-migration -s "D:\旧书库" -t "D:\新书库" -v遇错继续
默认情况下，遇到错误会回滚所有更改。如果希望跳过错误继续迁移：
readercopilot-migration -s "D:\旧书库" -t "D:\新书库" --continue-anyway英文服务名称
默认创建的服务使用中文名称（如"书库"、"漫画库"）。如需使用英文：
readercopilot-migration -s "D:\旧书库" -t "D:\新书库" -l en-US完整参数列表
| 参数 | 简写 | 说明 | 默认值 |
|---|---|---|---|
--source | -s | 旧版书库目录 | 必填 |
--target | -t | 新版书库目录 | 必填 |
--lang | -l | 服务名称语言 | zh-CN |
--dry-run | 模拟运行 | false | |
--continue-anyway | 遇错继续 | false | |
--verbose | -v | 显示详细日志 | false |
常见问题
找不到 bookStore.sqlite
确保 --source 指向的是正确的旧版书库目录。该目录应直接包含 bookStore.sqlite 文件。
目标目录非空
新版书库目录必须为空。请选择一个空文件夹，或删除目标目录中的所有文件后重试。
部分数据未迁移
- 检查是否使用了
--verbose查看详细错误 - 确认源文件是否完整（书籍/漫画文件是否存在）
- 哔哩哔哩播客订阅无法迁移（新版不支持）
外部服务需要重新登录
部分外部同步服务（如 NewsBlur）的认证信息无法直接迁移。迁移后需要在新应用的设置中重新输入账号密码。
下一步
迁移完成后，建议阅读以下文档了解新版应用的功能：