尧图网站建设 
KOReader跨设备同步10分钟打通进度和批注的完整配置【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader周六晚上你在 Kindle 上读到第 180 页顺手标了几处高亮。周日换到手机打开同一本书进度条还停在 30 页批注也全没了——多设备读书的常见尴尬。KOReader 的跨设备同步功能就是为此设计的它分两条线进度走专用同步服务批注和统计等数据走云存储目录。跟着下面这套流程走10 分钟以内就能让两台设备自动对齐。能做什么不能做什么先把边界划清楚免得对功能有错误期待进度同步阅读位置推到 KOReader 同步服务器官方或自建两台设备双向对齐支持每翻 N 页自动推送。云存储接入内置 Dropbox、WebDAV、FTP 三种服务可以浏览、上传、下载云端文件。数据文件同步统计、词汇本这类按文件存的数据放到云端同一目录就能跨设备更新。批注和书签没有一键自动合并需要你把书的数据目录放到云端同一文件夹手动触发同步。不同步书文件本身每台设备要各自放一份完全相同的书文件名、内容一致否则系统认为不是同一本。界面设置不走同步字号、主题这些每台设备独立配置。边界清楚之后缺的东西不多下一页列个清单。动手前准备逐条打勾齐了就开工两台设备都装好 KOReaderKindle、Kobo、Android 手机、电脑都行版本一致在同步服务器注册了同一账号两台设备都用它登录Dropbox 开发者后台建了应用拿到 Refresh Token 和APP_KEY:APP_SECRET字符串想好了云端目录比如/KOReader/sync和本地目录两端保持一致两台设备都能上 WiFi自动同步依赖网络这点后面还会提凭证是新手最容易卡住的一步Dropbox 的短期令牌只有 4 小时有效期所以配置时填的是刷新令牌 应用密钥这对组合软件会自动换新令牌。准备齐全后进入实操。实操走查以 Dropbox 为例1. 添加云存储打开主菜单点云存储。列表左上角是加号点它在弹出的添加新服务器里选 Dropbox。2. 填凭证并保存弹出四项输入名称随便起比如我的网盘、Refresh Token 或长期令牌、APP_KEY:APP_SECRET、起始目录。粘贴后点保存。预期结果看到根目录的文件和文件夹列表。如果提示无法获取服务器内容请检查配置或网络连接九成是令牌填错回去重抄一遍。3. 指定同步目录长按刚添加的服务器名弹出操作框。点同步设置会显示当前的远程和本地目录初始都是未设置。分别点选择远程目录进云端挑文件夹长按选中和选择本地目录在本地挑目录两处都填上。4. 手动触发一次同步回到操作框点立即同步。它把云端文件的清单和本地逐个比对大小只下载不一致的全程有进度条。完成后弹提示已下载 N 个文件。之后每次想更新点同一个按钮即可。5. 顺手把进度也同步了主菜单进进度同步完成账号登录勾上自动保持文档同步再设每翻多少页推送一次0 表示不按翻页推送只在关书、挂起时推送。之后开书、关书、设备休眠进度都会自己上传。到这里云存储和进度两条线都通了接下来花 1 分钟看看背后的机制。它是怎么同步的数据同步用的是三文件比对本地文件、刚下载的云端文件加上上次上传后留存的缓存副本。只看本地和云端分不清我删掉了还是别人还没传拿缓存当参照物两边删掉的条目就能被识别出来合并后不会死灰复燃。上传还带 etag 校验云端文件的指纹期间别人改过就返回冲突状态软件会自动重试。核心逻辑就 200 来行集中在 Cloud:sync 里。进度同步是另一套机制客户端把书的指纹 百分比位置 设备名推给服务器拉取时比较时间戳决定要不要回跳位置推送失败会先进重试队列网络恢复后自动补传见 KOSync 主逻辑。机制不复杂但真出问题时还是那几处坑按图索骥即可。出了问题先查这四处提示无法获取服务器内容多半是网络或凭证问题。确认 WiFi 已连Dropbox 令牌过期就直接失效回开发者后台重新生成 Refresh Token 覆盖粘贴。拉取进度提示未找到该文档的进度先确认两台设备上的书完全一致——默认按文件二进制指纹匹配换个重排版的文件就算不上同一本。想要宽松些可在进度同步里把文档匹配方式改成按文件名。自动同步突然不灵了自动同步有前提已登录账号且设备在没网时能把 WiFi 动作设为自动开启。关掉自动同步会立即把当前进度推上去不用担心丢位置。批注合并不对劲按文件同步没有细粒度冲突检测以最后一次上传的版本为准。建议同步前先在每台设备上确认批注都已保存冲突后手动保留想留的那份。四处都排除掉还异常再翻日志细看。收尾前把关键动作过一遍。30秒回顾一台 Dropbox 应用刷新令牌 应用密钥就能接入支持 Dropbox / WebDAV / FTP 三种服务云端目录和本地目录一一映射立即同步只传有差别的文件三文件比对专门处理删除场景不会把删掉的内容拉回来进度同步在独立菜单支持按页数自动推送失败自动排队补传两台设备同一账号、同一版本、同一份书文件缺一不可参考文档可以对照着看doc/DataStore.md 讲了本地数据的存放结构plugins/cloudstorage.koplugin/cloudstorage.lua 是同步界面的完整实现想深挖 etag 重试细节直接看它。【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KOReader跨设备同步：10分钟打通进度和批注的完整配置
KOReader跨设备同步10分钟打通进度和批注的完整配置【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader周六晚上你在 Kindle 上读到第 180 页顺手标了几处高亮。周日换到手机打开同一本书进度条还停在 30 页批注也全没了——多设备读书的常见尴尬。KOReader 的跨设备同步功能就是为此设计的它分两条线进度走专用同步服务批注和统计等数据走云存储目录。跟着下面这套流程走10 分钟以内就能让两台设备自动对齐。能做什么不能做什么先把边界划清楚免得对功能有错误期待进度同步阅读位置推到 KOReader 同步服务器官方或自建两台设备双向对齐支持每翻 N 页自动推送。云存储接入内置 Dropbox、WebDAV、FTP 三种服务可以浏览、上传、下载云端文件。数据文件同步统计、词汇本这类按文件存的数据放到云端同一目录就能跨设备更新。批注和书签没有一键自动合并需要你把书的数据目录放到云端同一文件夹手动触发同步。不同步书文件本身每台设备要各自放一份完全相同的书文件名、内容一致否则系统认为不是同一本。界面设置不走同步字号、主题这些每台设备独立配置。边界清楚之后缺的东西不多下一页列个清单。动手前准备逐条打勾齐了就开工两台设备都装好 KOReaderKindle、Kobo、Android 手机、电脑都行版本一致在同步服务器注册了同一账号两台设备都用它登录Dropbox 开发者后台建了应用拿到 Refresh Token 和APP_KEY:APP_SECRET字符串想好了云端目录比如/KOReader/sync和本地目录两端保持一致两台设备都能上 WiFi自动同步依赖网络这点后面还会提凭证是新手最容易卡住的一步Dropbox 的短期令牌只有 4 小时有效期所以配置时填的是刷新令牌 应用密钥这对组合软件会自动换新令牌。准备齐全后进入实操。实操走查以 Dropbox 为例1. 添加云存储打开主菜单点云存储。列表左上角是加号点它在弹出的添加新服务器里选 Dropbox。2. 填凭证并保存弹出四项输入名称随便起比如我的网盘、Refresh Token 或长期令牌、APP_KEY:APP_SECRET、起始目录。粘贴后点保存。预期结果看到根目录的文件和文件夹列表。如果提示无法获取服务器内容请检查配置或网络连接九成是令牌填错回去重抄一遍。3. 指定同步目录长按刚添加的服务器名弹出操作框。点同步设置会显示当前的远程和本地目录初始都是未设置。分别点选择远程目录进云端挑文件夹长按选中和选择本地目录在本地挑目录两处都填上。4. 手动触发一次同步回到操作框点立即同步。它把云端文件的清单和本地逐个比对大小只下载不一致的全程有进度条。完成后弹提示已下载 N 个文件。之后每次想更新点同一个按钮即可。5. 顺手把进度也同步了主菜单进进度同步完成账号登录勾上自动保持文档同步再设每翻多少页推送一次0 表示不按翻页推送只在关书、挂起时推送。之后开书、关书、设备休眠进度都会自己上传。到这里云存储和进度两条线都通了接下来花 1 分钟看看背后的机制。它是怎么同步的数据同步用的是三文件比对本地文件、刚下载的云端文件加上上次上传后留存的缓存副本。只看本地和云端分不清我删掉了还是别人还没传拿缓存当参照物两边删掉的条目就能被识别出来合并后不会死灰复燃。上传还带 etag 校验云端文件的指纹期间别人改过就返回冲突状态软件会自动重试。核心逻辑就 200 来行集中在 Cloud:sync 里。进度同步是另一套机制客户端把书的指纹 百分比位置 设备名推给服务器拉取时比较时间戳决定要不要回跳位置推送失败会先进重试队列网络恢复后自动补传见 KOSync 主逻辑。机制不复杂但真出问题时还是那几处坑按图索骥即可。出了问题先查这四处提示无法获取服务器内容多半是网络或凭证问题。确认 WiFi 已连Dropbox 令牌过期就直接失效回开发者后台重新生成 Refresh Token 覆盖粘贴。拉取进度提示未找到该文档的进度先确认两台设备上的书完全一致——默认按文件二进制指纹匹配换个重排版的文件就算不上同一本。想要宽松些可在进度同步里把文档匹配方式改成按文件名。自动同步突然不灵了自动同步有前提已登录账号且设备在没网时能把 WiFi 动作设为自动开启。关掉自动同步会立即把当前进度推上去不用担心丢位置。批注合并不对劲按文件同步没有细粒度冲突检测以最后一次上传的版本为准。建议同步前先在每台设备上确认批注都已保存冲突后手动保留想留的那份。四处都排除掉还异常再翻日志细看。收尾前把关键动作过一遍。30秒回顾一台 Dropbox 应用刷新令牌 应用密钥就能接入支持 Dropbox / WebDAV / FTP 三种服务云端目录和本地目录一一映射立即同步只传有差别的文件三文件比对专门处理删除场景不会把删掉的内容拉回来进度同步在独立菜单支持按页数自动推送失败自动排队补传两台设备同一账号、同一版本、同一份书文件缺一不可参考文档可以对照着看doc/DataStore.md 讲了本地数据的存放结构plugins/cloudstorage.koplugin/cloudstorage.lua 是同步界面的完整实现想深挖 etag 重试细节直接看它。【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考