# Baidu Netdisk Sync Notice

中文名：**百度网盘-同步提醒通知**

An Obsidian desktop plugin for vaults stored in Baidu Netdisk Sync Space. It
retries transient `EBUSY: resource busy or locked` save failures and lets users
control how sync-lock notices are displayed.

一个面向百度网盘同步空间用户的 Obsidian 桌面插件。它会自动重试短暂的
`EBUSY: resource busy or locked` 保存失败，并允许用户控制同步锁定提醒的
开关、透明度和显示样式。

## Features / 功能

- Retry transient `EBUSY` failures when writing notes, Canvas files, or other
  vault files.
- Show or hide only notices containing `EBUSY` or
  `resource busy or locked`; other Obsidian notices remain unchanged.
- Set notice opacity from 0% to 100%.
- Choose between the original technical error and a compact Chinese status
  message.
- Support the main window, the separate settings window, and pop-out windows.
- Preview both notice styles directly from the plugin settings.

## Requirements / 使用条件

- Obsidian Desktop 1.13.7 or later.
- Designed for Windows vaults stored in Baidu Netdisk Sync Space.
- Desktop only.

## Usage / 使用方法

1. Open **Settings → Community plugins** and enable
   **Baidu Netdisk Sync Notice**.
2. Open the plugin settings page.
3. Configure:
   - Sync-lock notice on/off
   - Opacity from 0% to 100%
   - Original or compact style
4. Use the two preview buttons to compare the styles.

## Important safety note / 重要安全提示

This plugin reduces transient save failures by retrying them, but it cannot
control Baidu Netdisk or guarantee that a persistently locked file will be
saved. Hiding notices or setting opacity to 0% can make a real save failure
invisible. Keep backups and pause the sync client when persistent lock errors
occur.

本插件只能缓解短暂文件占用，不能控制百度网盘，也不能保证持续锁定的文件
一定保存成功。关闭提醒或把透明度设为 0% 后，真实保存失败可能不可见。请保留
独立备份；如果锁定持续发生，建议编辑期间暂停同步。

## Privacy / 隐私

- No telemetry.
- No analytics.
- No network requests.
- No account or cloud credentials are accessed.
- No note contents are transmitted outside the vault.

## Manual installation / 手动安装

Copy these files into:

```text
<vault>/.obsidian/plugins/baidu-save-retry/
```

Required files:

- `main.js`
- `manifest.json`
- `styles.css`

Restart Obsidian, open **Settings → Community plugins**, and enable the plugin.

## License

[MIT](LICENSE)

## Author

杲源

## Disclaimer

This independent community project is not affiliated with, endorsed by, or
sponsored by Baidu or Obsidian.