Skip to content

v2.4.1

Latest

Choose a tag to compare

@github-actions github-actions released this 10 Nov 06:04
· 2 commits to main since this release

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 进行反馈