Repository navigation
BaiduPCS-Rust v2.4.1 发行说明
发布日期:2026-11-10
🎯 版本说明
v2.4.1 是在 v2.4.0 基础上的维护版本,核心是把分享同步的过滤、补传和可见性补齐,并改善移动端与分享列表的日常使用:
- 包含规则白名单:只同步命中通配符 / 正则的文件,目录继续扫描以便找到其中匹配的内容
- 排除更清楚:精确排除可以勾到单个文件;选择器重开回填已选项;运行明细写明命中了哪条规则
- 网盘目标补传:分享侧没变、但网盘上文件被删或大小对不上时补转存
- 分享列表与通知:按百度
nextpage翻页、失效分享可高亮;分享同步通知可列出文件名 - 移动端与稳定性:文件列表多选批量操作;删除下载任务不再跟协程打架;对话框回车不再刷新页面
✅ 平滑升级:本版本不涉及破坏性数据迁移,从
v2.4.0升级无感知。新增配置字段都有默认值,老配置文件缺字段自动兼容。仍建议升级前按惯例备份数据目录(见下方「升级说明」)。
⚠️ 一个方向性注意:新增的「包含规则」写在订阅配置的include_patterns/include_regex_patterns里。若之后回退到v2.4.0,旧版本不认识这两个字段,不会执行这些包含规则(订阅本身照常可用,只是少了一层白名单),请留意回退后可能多同步一些内容。
✨ 分享同步·包含规则白名单
订阅可以加一组包含规则(通配符或正则),与排除规则对称:
- 任意包含规则非空时,文件须至少命中一条才进入快照;未添加则不额外限制
- 目录不会因为名称未命中就被跳过,会继续扫描其中的文件;目录路径本身命中时,该目录及全部内容一起包含
- 命中包含规则之后,仍会再应用排除规则
- 未命中、下面也没有存活文件的目录不进快照,避免在目标端建出一堆空目录;目录本身命中规则时即使是空目录也保留
语法、校验上限与排除规则相同(完整路径、区分大小写;正则是 Rust 语法,不支持 lookaround / 反向引用)。旧订阅缺这两个字段按空处理。
✨ 分享同步·精确排除文件与选择器回填
感谢 @cloudiful 贡献 PR #189。对应 issue #122。
精确排除(exclude_paths)除目录外也可以勾到单个文件:文件只排除自身,目录仍连同整棵子树排除且不再递归扫描。
选择「同步内容 / 排除内容」重开时回填已选项。分享根路径与 sharelink0-<id> 等合成前缀对齐到同一份内容,界面展示时隐藏该前缀。文件名里的空白(含结尾空格)原样保留,不会把「报告. 」与「报告.」当成同一个文件。
在已整体选中的文件夹(或整个分享)里取消个别项目,会把它改成逐项选择,并提示之后新增内容不再自动包含 / 排除。只想跳过个别内容、并让目录继续自动跟进新文件时,建议保留整体选择,改用「排除内容」。
✨ 分享同步·排除命中记录
被排除规则剔除的条目写入运行明细(动作 / 状态为「已排除」),原因写成「命中排除内容 / 通配符 / 正则」加上规则原文。这些条目只记录、不执行,也不参与收尾统计。
- 每轮最多记录 500 条,超出只计数并提示「明细只记录了前 N 条」
- 每个订阅只保留最近 20 次运行的排除明细
- 运行详情可按「已排除」筛选,点计数即可切过去
落在其他账号的目标显示昵称(如「网盘→账号B」);编辑页说明「网盘账号」只决定转存到哪个账号,不改变订阅所属。
✨ 消息通知·分享同步列出文件名
分享同步推送的正文会列出文件名:新增 / 更新优先,其次失败的并标「(失败)」;超出显示「等 N 个文件」。
- 条数在设置 → 消息通知 → 「列出文件数」,默认 5,范围 0–50,填 0 不列文件名
- Webhook 模板新增占位符
{{files}},默认 Body 模板带上该字段 - 老配置缺字段按 5 处理;自定义模板没写
{{files}}时,文件名仍在正文「文件:」一段里
✨ 我的分享·按 nextpage 翻页与失效分享高亮
百度 /share/record 并不返回总数(total 恒为 0),分页看的是本页条数 count 和下一页页码 nextpage。没有总数时列表改用「上一页 / 下一页」,顶部显示「本页 N 条」,不再出现「0 条分享记录」。
失效分享(文件已删除 / 已过期)可以一眼认出来:
- 高亮失效分享(
ui.highlight_dead_shares,默认开):已删除浅红底,已过期浅黄底 - 失效分享只能取消(
ui.disable_dead_share_actions,默认关):提取码 / 复制链接 / 修改有效期置灰,只留「取消分享」 - 状态文案按失效类型显示「已删除 / 已过期」
两项都在系统设置 → 界面偏好。
✨ 文件管理·移动端多选批量操作
手机上网盘文件列表和本地文件列表可以勾选,吸底操作栏(在底部导航上方)提供批量操作:
- 网盘:下载 / 复制 / 移动 / 分享 / 删除;多账号时「更多」里用其他账号下载或复制/移动
- 本地:删除
- 显示已选数量,可全选当前已加载项或取消
- 切目录、刷新、搜索后清空勾选,与桌面端表格换数据后清空勾选一致
🐛 分享同步·网盘目标缺失或不一致时不补传
问题:分享侧没有变化时,网盘目标上被删掉或大小对不上的文件不会再转存。整目录转存碰到目标已有同名文件时,百度返回「已存在」,会被当成已经完成,坏文件一直留着。
修复:按执行腿列举网盘目标,缺失或大小不一致的补转存。大小不一致按冲突策略先删除(覆盖)或改名(新版本)再单独转存,不进整目录批量。
- 跨账号订阅各账号各自校验,一个账号缺文件不会让别的账号走冲突策略
- 本地已完好、只缺网盘的文件只转存到网盘,不再重复下载
- 手动「立即同步」强制校验;定时轮询默认 24 小时节流(目标路径 / 账号 / 冲突策略变化则立刻重验)
- 列举失败(如 HTTP 429)不误判成全量重传
🐛 下载·删除任务时下载协程仍在写文件
对应 issue #192。
问题:删除任务不等下载与收尾协程退出,临时文件可能还在写就被清掉,或清完又被写回来。启动、入队、重排还可能把正在删除的任务复活,并泄漏下载槽位。
修复:删除先标记删除意图,等下载与收尾协程退出再清文件。启动、入队、重排看到删除意图就放弃,并按任务 id 回收槽位。不删本地文件时,已完成的成品保留。
🐛 对话框·回车刷新页面
问题:新建文件夹、重命名等对话框里按回车,会触发表单原生提交,整个页面刷新,刚填的内容也丢了。
修复:回车走组件自己的提交,并阻止原生 submit。
🐛 移动端·搜索框错位与顶部工具栏排版
问题:搜索框展开用绝对定位,把旁边按钮挤飞;分享页标题和操作折成两行;侧栏用户名过长撑破布局;各页工具栏与列表左右对不齐。
修复:搜索展开后独占一行铺满;分享页标题与按钮同一行;用户名过长省略;各页工具栏与列表左右对齐,账号筛选独占一行。
🔧 升级说明
Docker 用户
# 升级前建议先备份挂载的 data 卷
# 拉取指定版本镜像
docker pull komorebicarry/baidupcs-rust:v2.4.1
# 或使用 latest 标签
docker pull komorebicarry/baidupcs-rust:latest
# 重启容器
docker-compose down && docker-compose up -d二进制用户
从 Releases 页面下载对应平台的二进制文件,替换原有可执行文件后重启服务。
配置与数据
- 本版本无破坏性数据迁移,从
v2.4.0升级无需任何手动操作。 - 升级仍建议按惯例备份
backend/config/与backend/wal/(Docker 用户备份挂载的data卷)。 - 默认端口仍为
18888,不影响现有反向代理 / 防火墙 / 书签。 - 新增配置项(都有默认值,老配置缺字段自动兼容):
- 订阅的
include_patterns/include_regex_patterns(默认空 = 不额外限制) notification.share_sync_file_list_limit(默认5,0 表示通知里不列文件名)ui.highlight_dead_shares(默认true)ui.disable_dead_share_actions(默认false)
- 订阅的
exclude_paths现在也可以是文件路径;老订阅里的目录路径语义不变。- Webhook 默认 Body 模板新增
{{files}};已保存的自定义模板不受影响,文件名仍写在通知正文里。
📁 下载
| 平台 | 文件名 |
|---|---|
| Windows (x86_64) | BaiduPCS-Rust-v2.4.1-windows-x86_64.zip |
| Linux (x86_64) | BaiduPCS-Rust-v2.4.1-linux-x86_64.tar.gz |
| Linux (ARM64) | BaiduPCS-Rust-v2.4.1-linux-aarch64.tar.gz |
| macOS (x86_64) | BaiduPCS-Rust-v2.4.1-macos-x86_64.tar.gz |
| macOS (ARM64) | BaiduPCS-Rust-v2.4.1-macos-aarch64.tar.gz |
| Docker 镜像 | BaiduPCS-Rust-v2.4.1-docker.tar.gz |
完整更新日志:参见项目根目录的 CHANGELOG.md
问题反馈:欢迎通过 GitHub Issues 进行反馈