Repository navigation
Releases
2.1.2 — 设备日志限容与旧索引批量校验
2.1.2 — 2026-11-17
- V2 改用设备独立的滚动日志。正常同步复用同一个文件,最多保留 64 批变更、256 KiB;旧记录原样保留。
- 大量旧格式记录积压时改用目录分页校验,不再逐条下载已完成的 JSON;未完成记录继续复查,不伪造完成状态。
- 检测日志断档、回滚和缺失,回退完整目录校验;断网未确认或崩溃后保留旧日志并换用新标识,避免迟到请求覆盖后续日志。
- 设备标识存放在设备本机存储中;重启后先核对云端内容,避免从旧备份恢复后覆盖较新的日志。
- 回归覆盖 1,000 次写入限容、2,000 个文件/旧记录的请求计数、日志轮换、异常上传、旧备份恢复、双设备及 Android/iOS 浏览器环境。
- 升级说明:建议所有设备一起更新。旧版遇到新日志会回退完整校验。本次不删除历史记录、不实现跨设备同文件写锁;不要在多个设备同时修改并同步同一文件,以免发生覆盖。长期未完成任务仍可能增加检查耗时。
验证:npm test、npm run typecheck、npm run build、git diff --check 全部通过。
升级要求:Obsidian 1.14.4+。请各设备更新到同一版本;手动安装仅替换 main.js、manifest.json、styles.css,保留配置、同步状态及备份。
2.1.1 — 快照定期合并与授权提示
2.1.1 — 2026-11-13
- 同步时定期将已完成的变更记录合并到云端快照,未完成的操作继续复查;旧记录保留,不自动删除。
- 快照上传失败时保留原记录,并在后续同步重试;每 24 小时的完整校验仍然保留。
- 授权过期、缺少续期凭据或网盘返回 errno -6 时显示更明确的提示;更改 AppKey / AppSecret 后立即更新 API 客户端。
- Android 真机和 Mac 隔离测试验证快照合并、跨设备读取、未完成记录与旧记录保留。
2.1.0 — 云端索引快照与同步优化
2.1.0 — 2026-11-12
- 新增云端文件清单快照,新设备可读取有效快照并检查后续变更;已有基线但缺失索引、快照异常或过期时回退完整扫描。直接在网盘修改的文件仍依赖定期完整校验。
- 首次完整扫描跳过逐条下载已成对的历史变更记录,未完成及后续记录继续检查;旧记录保留。
- 新增 v2 批量变更记录;旧版设备遇到新目录可能回退完整扫描,建议所有设备更新。
- 批量接受远端版本时按目录分组复查,批量获取下载链接,保留本地备份与变化检查;移动端显示下载进度和速度。
- 同步提示说明完整扫描中断后的处理;修复远端检查进度及超时,并限制并发读取。
2.0.4 — 远端检查进度与超时处理
修复远端记录检查长时间无反馈:显示检查数量,单个只读网络请求 30 秒超时后明确提示失败,不使用不完整清单执行同步。手机手动模式下,请在冲突处理完成后点击立即同步。
通过类型检查、全部回归测试和新增超时测试。远端网络故障时需检查网络并重试。
2.0.3 — Remove plugin name from settings heading
Remove the redundant plugin name from the settings heading: “Baidu Sync Safe 设置” is now “同步设置”.
Validation: TypeScript typecheck and production build passed.
Requires Obsidian 1.14.4+. The fixes from 2.0.2 remain included.
2.0.2 — 版本提示、同步进度与原始文件时间修复
修复反馈问题 1、3、5:
- 明确最低 Obsidian 1.14.4 要求,设置页显示实际插件版本;阻止不支持的客户端加载新版并停止历史兼容回退。已经安装旧版的用户仍需先升级 Obsidian,再更新插件。
- 同步排队立即显示等待,清空上一轮状态;成功且无待处理冲突后 3 秒自动关闭窗口,错误或剩余冲突时保留。当前冲突计数随处理更新,全部处理后空冲突窗口自动关闭。后台仍不主动弹窗。
- 上传保存 local_mtime/local_ctime;下载优先恢复原始修改时间,并保留原子写入及恢复保护。创建时间尽力保留,受系统限制;网盘时间精度为秒。旧文件未保存的时间无法还原,回退到服务器修改时间。
验证:类型检查、完整回归测试、新增版本/进度/时间测试、实际桌面文件系统 mtime 检查通过。Android/iOS 为适配器测试,非实机测试。本次没有使用真实百度账号进行端到端上传验证。
安装:桌面覆盖 main.js、manifest.json、styles.css;手机解压 zip,将 baidu-sync 文件夹复制到知识库 .obsidian/plugins/。保留 data.json、同步状态和备份,重新加载插件。
2.0.1 — 全端后台同步不再自动弹窗
修复启动、定时同步自动弹窗。桌面、Android、iOS 统一仅在主动点击同步或查看进度时显示窗口。
后台同步、冲突及恢复信息保留在状态栏和日志中;关闭进度窗口后不会自动出现浮动卡片,同步继续。
验证:TypeScript 类型检查、完整同步测试及三端静默进度回归测试通过。
安装:将 main.js、manifest.json、styles.css 覆盖到知识库 .obsidian/plugins/baidu-sync/,然后重新加载插件。保留原有 data.json 和同步状态文件。
2.0.0 — 批量上传/删除调度、双向哈希映射缓存与高可靠同步架构
Release Notes / 版本发布说明
2.0.0 批量上传/删除调度、双向哈希映射缓存与高可靠同步架构
- 分批上传调度与有界并发控制:
- 上传任务按每 20 个文件为一组分批切片,各批次严格受控于配置的 1–5 并发度。
- 每个文件保持独立的预创建、分片上传、校验与基线检查点持久化,杜绝多文件耦合引发级联失败,网络中断后可无缝断点续传。
- 云端批量删除与严格逐项回执校验:
- 云端远端删除接入百度网盘官方批量管理接口(
filemanager?opera=delete),每批最多 50 个路径,大幅减少网络往返耗时。 - 删除前实时复核本地与云端最新状态;仅对接口明确回执成功或文件已不存在(
errno: 0 / -9)的文件移除基线。 - 遇到异常、失败或网络断开时坚决保留基线并立即中断后续批次,防止云端与本地状态失步。本地删除继续通过 Obsidian 原生回收站执行。
- 云端远端删除接入百度网盘官方批量管理接口(
- 本地与云端专有哈希映射缓存:
- 适配百度网盘专有哈希特性,建立安全持久化的内容哈希映射缓存。
- 跨路径比对与重命名场景下秒级识别相同内容,避免无意义的重复拉取与冗余流量开销。
1.0.9 本地扫描极速剪枝、10秒自动同步与防频繁同步冷却
- 本地变更零 I/O 快速指纹筛查(Fast-path Check):
- 核心解决在包含数千文件(如 2848 个文件)的大型仓库中,每次同步都需要从磁盘完整读取每个文件并计算 MD5 导致的高耗时、发热和掉电问题。
- 引入基于 Obsidian 内存缓存的
stat.mtime与stat.size快速指纹筛查:未修改的文件直接复用基线哈希,0 毫秒完成判定。数千文件扫描耗时从数十秒暴降至 50 毫秒以内。
- 编辑防抖延迟安全下限 (>= 3 秒):
- 设置面板中为编辑防抖延迟限制最低 3 秒,避免用户误设过短与 Obsidian 自身 Auto-save 机制冲突,杜绝打字期间高频碎片化上传。
- 全量同步防频繁冷却 (10 秒 Cooldown):
- 手动或自动全量同步之间增加 10 秒冷却保护,防止连击状态栏或短时间高频触发全库比对对网盘造成频控压力。
- 自动同步支持最短 10 秒:
- 设置面板支持秒级配置后台自动同步周期,最短可设置为 10 秒。
- 桌面端与移动端统一进度 UI:
- 桌面 App 端与移动端共用实时同步浮动卡片与详情弹窗,桌面端自适应固定于右下角。
1.0.8 安卓防闪退分片拉取、相同内容冲突自动消解与独立并发设置
- 安卓端超大文件分片流式下载(彻底解决 OOM 闪退):
- 排查根因:通过 ADB 系统日志深入定位,安卓版 Obsidian 运行于 Capacitor 容器,调用原生
requestUrlAndroid拉取大文件(如 60MB+ 的 PDF 或音视频)时,Java 堆分配 Base64 字符串会瞬间突破安卓 Dalvik/ART 虚拟机的 256MB 堆内存硬上限,引发java.lang.OutOfMemoryError并导致系统发送SIG 9强制闪退。 - 核心修复:重构底层
downloadFile实现,对超大文件采用 HTTPRange: bytes=start-end4MB 分片流式拉取,各分片在 Java 层内存仅占 ~20MB 并即时回收,最后在 JavaScript V8 原生内存高效拼接。真机实测 60.93MB 大文件 25.4 秒稳定拉取无闪退。
- 排查根因:通过 ADB 系统日志深入定位,安卓版 Obsidian 运行于 Capacitor 容器,调用原生
- 相同内容冲突自动消解与冗余副本清理:
- 解决因手机文件系统与百度网盘修改时间戳(mtime)存在秒级偏差导致实质内容相同的文件反复被判为冲突的问题。
- 改用 MD5 内容哈希(
sameFileContent)判定:同步启动时自动巡检历史冲突,若两端哈希相同立即自动标记为已解决、更新基准线并静默清理冗余的.conflict-...副本文件,告别人工繁琐确认。
- 有界并发下载与写盘防覆盖安全防线:
- 下载通道支持 1~3 有界并发(
runBounded),显著提升多文件拉取速度。 - 增加下载落盘前本地文件二次哈希复核:若排队等待期间本地发生了编辑,立即阻断覆盖并升级至冲突安全保护,绝不覆盖用户最新编辑。文件写盘继续采用
AtomicFileSystem事务日志与互斥锁,确保原子落盘与断网自愈。
- 下载通道支持 1~3 有界并发(
- 独立设置上传与下载并发数:
- 设置面板中将「上传并发数」与「下载并发数」正式拆分为独立选项(1
3 自由调节),手机端建议保持 12 并发以兼顾省电与内存稳定。
- 设置面板中将「上传并发数」与「下载并发数」正式拆分为独立选项(1
1.0.7 移动端前台亮屏提醒与网络异常指引
- 移动端前台亮屏注意事项:进度弹窗与设置面板中增加明确指引,提醒用户在全量同步期间保持手机亮屏并停留在 Obsidian 前台,切勿锁屏息屏或切出后台(Android 系统电池省电策略在休眠时会切断网络,引发
UnknownHostException域名解析失败)。 - 友好网络错误诊断:对网络断开、超时及系统域名解析失败自动解析并给出排查建议(检查 WiFi/网络、关闭科学上网代理或系统专用 DNS)。
- 真机双向同步验证:通过 Android 真机 ADB 实时连通性监控,实测通过 2700+ 项文件目录索引与文档附件传输。
1.0.6 安卓可见同步进度
- 手机手动同步自动打开详情,收起保留底部进度卡片,不依赖桌面状态栏。
- 显示当前阶段已完成/总文件数、耗时、当前文件、上传/下载/跳过/冲突/失败数量和最近记录。
- 设置新增“查看进度”,新增命令“查看百度同步进度”。关闭面板不会取消同步,重复点击手动同步复用当前任务。
- 进度按当前阶段文件数量计算,不虚构整体字节百分比;目录扫描没有计数时显示不定进度。
1.0.5 移动端首发适配与手动同步防护
- 支持 Android 与 iOS 移动设备纯 Web 环境安全加载,解耦桌面端 Node.js 原生 API。
- 新增
mobileManualSync设置项,手机端默认采用明确手动同步,避免后台意外休眠导致写入异常。
1.0.4 预创建协议优化与社区规范
- 修复预创建接口返回类型处理:区分
return_type=1(分块上传)与return_type=2(秒传),修复大文件分块合并报错31500。 - 修复 Multipart 请求在部分平台由 Obsidian 自动计算 Content-Length,防止
ERR_INVALID_ARGUMENT。 - 遵循社区审核规范优化设置布局、日志严重级别颜色与配对码动态遮罩。
1.0.3 Git 风格行内冲突标记与增量同步
- 新增 Git 风格单文件行内标记合并模式(
git_merge):笔记内标出<<<<<<< LOCAL / ======= / >>>>>>> REMOTE,不产生额外副本。 - 引入基于网盘服务端事件记录的增量同步模块(
remote-index.ts),非首次同步无需全量扫描整个网盘。 - 修复仅
fsId变化但内容 MD5 实际未变时的误报冲突。
1.0.2 差异同步、可视化冲突解决与并发上传
- 差异同步(Delta Sync):本地未修改保存直接跳过网络请求,全量未修改跳过网盘建目录与基线重写。
- 可视化冲突人工解决:提供双向对比(Diff View),支持直接在界面内合并保存或批量选择接受版本。
- 有界并发上传:1~3 线程受控并发池,实测上传提速约 2.97 倍。
1.0.1 / 1.0.0 核心基础架构
- 两阶段提交原子文件系统(
AtomicFileSystem),确保断电或意外退出不损坏文档。 - 状态基准库(
SyncStateStore),持久化同步基准数据。 - 百度网盘 OAuth 2.0 自动续期与可选 AES-256-GCM 端到端加密(E2EE)。
1.0.9
Release Notes / 版本发布说明
1.0.9 本地扫描极速剪枝、10秒自动同步与防频繁同步冷却
- 本地变更零 I/O 快速指纹筛查(Fast-path Check):
- 核心解决在包含数千文件(如 2848 个文件)的大型仓库中,每次同步都需要从磁盘完整读取每个文件并计算 MD5 导致的高耗时、发热和掉电问题。
- 引入基于 Obsidian 内存缓存的
stat.mtime与stat.size快速指纹筛查:未修改的文件直接复用基线哈希,0 毫秒完成判定。数千文件扫描耗时从数十秒暴降至 50 毫秒以内。
- 编辑防抖延迟安全下限 (>= 3 秒):
- 设置面板中为编辑防抖延迟限制最低 3 秒,避免用户误设过短与 Obsidian 自身 Auto-save 机制冲突,杜绝打字期间高频碎片化上传。
- 全量同步防频繁冷却 (10 秒 Cooldown):
- 手动或自动全量同步之间增加 10 秒冷却保护,防止连击状态栏或短时间高频触发全库比对对网盘造成频控压力。
- 自动同步支持最短 10 秒:
- 设置面板支持秒级配置后台自动同步周期,最短可设置为 10 秒。
- 桌面端与移动端统一进度 UI:
- 桌面 App 端与移动端共用实时同步浮动卡片与详情弹窗,桌面端自适应固定于右下角。
1.0.8 安卓防闪退分片拉取、相同内容冲突自动消解与独立并发设置
- 安卓端超大文件分片流式下载(彻底解决 OOM 闪退):
- 排查根因:通过 ADB 系统日志深入定位,安卓版 Obsidian 运行于 Capacitor 容器,调用原生
requestUrlAndroid拉取大文件(如 60MB+ 的 PDF 或音视频)时,Java 堆分配 Base64 字符串会瞬间突破安卓 Dalvik/ART 虚拟机的 256MB 堆内存硬上限,引发java.lang.OutOfMemoryError并导致系统发送SIG 9强制闪退。 - 核心修复:重构底层
downloadFile实现,对超大文件采用 HTTPRange: bytes=start-end4MB 分片流式拉取,各分片在 Java 层内存仅占 ~20MB 并即时回收,最后在 JavaScript V8 原生内存高效拼接。真机实测 60.93MB 大文件 25.4 秒稳定拉取无闪退。
- 排查根因:通过 ADB 系统日志深入定位,安卓版 Obsidian 运行于 Capacitor 容器,调用原生
- 相同内容冲突自动消解与冗余副本清理:
- 解决因手机文件系统与百度网盘修改时间戳(mtime)存在秒级偏差导致实质内容相同的文件反复被判为冲突的问题。
- 改用 MD5 内容哈希(
sameFileContent)判定:同步启动时自动巡检历史冲突,若两端哈希相同立即自动标记为已解决、更新基准线并静默清理冗余的.conflict-...副本文件,告别人工繁琐确认。
- 有界并发下载与写盘防覆盖安全防线:
- 下载通道支持 1~3 有界并发(
runBounded),显著提升多文件拉取速度。 - 增加下载落盘前本地文件二次哈希复核:若排队等待期间本地发生了编辑,立即阻断覆盖并升级至冲突安全保护,绝不覆盖用户最新编辑。文件写盘继续采用
AtomicFileSystem事务日志与互斥锁,确保原子落盘与断网自愈。
- 下载通道支持 1~3 有界并发(
- 独立设置上传与下载并发数:
- 设置面板中将「上传并发数」与「下载并发数」正式拆分为独立选项(1
3 自由调节),手机端建议保持 12 并发以兼顾省电与内存稳定。
- 设置面板中将「上传并发数」与「下载并发数」正式拆分为独立选项(1
1.0.7 移动端前台亮屏提醒与网络异常指引
- 移动端前台亮屏注意事项:进度弹窗与设置面板中增加明确指引,提醒用户在全量同步期间保持手机亮屏并停留在 Obsidian 前台,切勿锁屏息屏或切出后台(Android 系统电池省电策略在休眠时会切断网络,引发
UnknownHostException域名解析失败)。 - 友好网络错误诊断:对网络断开、超时及系统域名解析失败自动解析并给出排查建议(检查 WiFi/网络、关闭科学上网代理或系统专用 DNS)。
- 真机双向同步验证:通过 Android 真机 ADB 实时连通性监控,实测通过 2700+ 项文件目录索引与文档附件传输。
1.0.6 安卓可见同步进度
- 手机手动同步自动打开详情,收起保留底部进度卡片,不依赖桌面状态栏。
- 显示当前阶段已完成/总文件数、耗时、当前文件、上传/下载/跳过/冲突/失败数量和最近记录。
- 设置新增“查看进度”,新增命令“查看百度同步进度”。关闭面板不会取消同步,重复点击手动同步复用当前任务。
- 进度按当前阶段文件数量计算,不虚构整体字节百分比;目录扫描没有计数时显示不定进度。
1.0.5 移动端首发适配与手动同步防护
- 支持 Android 与 iOS 移动设备纯 Web 环境安全加载,解耦桌面端 Node.js 原生 API。
- 新增
mobileManualSync设置项,手机端默认采用明确手动同步,避免后台意外休眠导致写入异常。
1.0.4 预创建协议优化与社区规范
- 修复预创建接口返回类型处理:区分
return_type=1(分块上传)与return_type=2(秒传),修复大文件分块合并报错31500。 - 修复 Multipart 请求在部分平台由 Obsidian 自动计算 Content-Length,防止
ERR_INVALID_ARGUMENT。 - 遵循社区审核规范优化设置布局、日志严重级别颜色与配对码动态遮罩。
1.0.3 Git 风格行内冲突标记与增量同步
- 新增 Git 风格单文件行内标记合并模式(
git_merge):笔记内标出<<<<<<< LOCAL / ======= / >>>>>>> REMOTE,不产生额外副本。 - 引入基于网盘服务端事件记录的增量同步模块(
remote-index.ts),非首次同步无需全量扫描整个网盘。 - 修复仅
fsId变化但内容 MD5 实际未变时的误报冲突。
1.0.2 差异同步、可视化冲突解决与并发上传
- 差异同步(Delta Sync):本地未修改保存直接跳过网络请求,全量未修改跳过网盘建目录与基线重写。
- 可视化冲突人工解决:提供双向对比(Diff View),支持直接在界面内合并保存或批量选择接受版本。
- 有界并发上传:1~3 线程受控并发池,实测上传提速约 2.97 倍。
1.0.1 / 1.0.0 核心基础架构
- 两阶段提交原子文件系统(
AtomicFileSystem),确保断电或意外退出不损坏文档。 - 状态基准库(
SyncStateStore),持久化同步基准数据。 - 百度网盘 OAuth 2.0 自动续期与可选 AES-256-GCM 端到端加密(E2EE)。
1.0.8 — Android OOM fix, identical conflict auto-resolution, 5-worker concurrency
1.0.8 发布说明
🚀 重点修复与新功能
-
安卓端超大文件分片流式下载(彻底解决 OOM 内存溢出闪退):
- 彻底解决 Capacitor 原生层在处理 30MB~60MB+ 大文件(如 PDF 或音频)时,Java 堆分配 Base64 字符串(170MB)突破安卓 256MB ART 限制导致 App 闪退(
SIG 9)的问题。 - 采用 HTTP
Range: bytes=start-end4MB 分片流式拉取,Java 原生层分片内存仅占 ~20MB 并即时回收,最后在 JavaScript V8 原生内存拼接。真机实测 60.93MB PDF 文件 25.4s 稳定下载无闪退。
- 彻底解决 Capacitor 原生层在处理 30MB~60MB+ 大文件(如 PDF 或音频)时,Java 堆分配 Base64 字符串(170MB)突破安卓 256MB ART 限制导致 App 闪退(
-
相同内容冲突自动消解与冗余副本清理:
- 彻底解决因手机与百度网盘修改时间戳偏差导致实质内容相同的文件反复冲突的问题。
- 改用精准 MD5 哈希(
sameFileContent)判定:同步启动时自动消解历史相同冲突、更新基线,并自动安全清理冗余的.conflict-...副本文件。
-
独立设置上传与下载并发数(支持 1~5 并发):
- 将「上传并发数」与「下载并发数」正式拆分为独立配置项,支持
1(串行)/ 2 / 3(标准)/ 4 / 5(高速)自由调节。
- 将「上传并发数」与「下载并发数」正式拆分为独立配置项,支持
-
双重哈希防覆盖安全检查:
- 并发下载排队等待期间,若本地文件被编辑,下载完成后会自动复核本地哈希,阻断覆盖并升级至冲突保护,绝不静默覆盖本地修改。
-
移动端前台亮屏注意事项与网络异常排查:
- 增加全量同步期间保持亮屏提醒,防止 Android 熄屏省电策略切断后台网络引发
UnknownHostException。
- 增加全量同步期间保持亮屏提醒,防止 Android 熄屏省电策略切断后台网络引发
📦 包含资源 (Release Assets)
main.js,manifest.json,styles.cssbaidu-sync-1.0.8-android.zip(移动端开箱即用离线安装包)