✨ 功能

• 📚 书籍迁移: 书籍元数据、书架、阅读进度、书签、批注（包括 PDF 批注）
• 📖 漫画迁移: 漫画元数据、书架、阅读进度
• 📰 RSS 迁移: 订阅源、分组、文章、已读状态
• 🎙️ 播客迁移: 播客、剧集、播放进度
• 📁 文件复制: 自动复制书籍和漫画文件到新库目录
• 🔄 外部服务: 支持 Inoreader、Feedbin、Miniflux、NewsBlur、Google Reader API 配置迁移

📦 安装

前置条件: 需要安装 .NET 10 SDK

dotnet tool install --global Richasy.ReaderCopilotMigration

🚀 使用

基本用法

readercopilot-migration --source <源库目录> --target <目标库目录>

参数说明

参数	简写	说明	必填
--source	-s	ReaderCopilot 的库目录 (LibraryPath)	✅
--target	-t	新库目录（必须为空或不存在）	✅
--lang	-l	服务实例名称语言 (zh-CN / en-US)，默认 zh-CN	❌
--dry-run		模拟运行，不实际写入数据	❌
--continue-anyway		遇到错误时继续迁移（默认出错则回滚）	❌
--verbose	-v	显示详细日志	❌

示例

# 基本迁移 readercopilot-migration -s "D:\ReaderCopilot\Library" -t "D:\RodelReader\Library" # 模拟运行（预览迁移内容） readercopilot-migration -s "D:\ReaderCopilot\Library" -t "D:\RodelReader\Library" --dry-run # 英文服务名称 + 详细日志 readercopilot-migration -s "D:\ReaderCopilot\Library" -t "D:\RodelReader\Library" -l en-US -v # 遇错继续 readercopilot-migration -s "D:\ReaderCopilot\Library" -t "D:\RodelReader\Library" --continue-anyway

📋 迁移内容

书籍 (Books)

• ✅ 书籍元数据（标题、作者、出版社、ISBN 等）
• ✅ 书架分类
• ✅ 阅读进度
• ✅ 书签
• ✅ 文本批注和高亮
• ✅ PDF 批注
• ✅ 书籍文件（EPUB、PDF、Mobi、FB2、TXT 等）

漫画 (Manga)

• ✅ 漫画元数据
• ✅ 书架分类
• ✅ 阅读进度
• ✅ 漫画文件/目录（CBZ、ZIP、目录）

RSS

• ✅ 本地订阅源
• ✅ 分组
• ✅ 文章缓存
• ✅ 已读/收藏/稍后阅读状态
• ✅ 外部服务配置（Inoreader、Feedbin、Miniflux、NewsBlur、Google Reader API）

播客 (Podcasts)

• ✅ 播客订阅
• ✅ 剧集缓存
• ✅ 播放进度
• ⚠️ 哔哩哔哩订阅（新应用不支持，将被跳过）

⚠️ 注意事项

1. 目标目录必须为空或不存在：工具会在目标目录创建全新的库结构
2. 封面会自动生成：新应用首次打开时会自动从书籍/漫画文件中提取封面
3. 外部服务需重新认证：部分外部服务（如 NewsBlur）需要在新应用中重新登录
4. 哔哩哔哩不支持：新版应用不支持哔哩哔哩播客订阅
5. 建议先模拟运行：使用 --dry-run 预览迁移内容

🔧 故障排除

找不到 bookStore.sqlite

确保 --source 指向的是 ReaderCopilot 的库目录（通常包含 bookStore.sqlite、mangaStore.sqlite 等文件）。

目标目录非空

使用 --continue-anyway 选项会清空目标目录后继续，或选择一个空目录。

迁移失败后回滚

默认情况下，迁移失败会自动清理目标目录。使用 --continue-anyway 可跳过回滚。

📄 License

MIT © Richasy