更新日志

为 YouTube 订阅新增已结束直播回放过滤，并修复手动提交、自动下载刷新和小屏失败任务列表体验。

• 为 YouTube 订阅新增“排除已结束直播回放”选项，可从预览结果、节目列表和 RSS 输出中隐藏直播回放内容。
• 修复手动提交的下载任务，使其会立即进入统一下载队列，不再游离于正常下载流程之外。
• 修复自动下载刷新时部分符合条件的新节目可能被跳过的问题，确保命中规则的内容能稳定进入下载队列。
• 优化小屏手机上的失败任务列表布局，并让错误详情更容易查看。

新增失败下载自动重试、主动告警与 yt-dlp 运行时切换，并优化 RSS 节目描述可读性。

• 新增失败下载自动重试调度，采用指数退避策略处理临时性异常，减少用户立刻手动干预的需求。
• 新增失败下载通知，支持 Email 与 Webhook 配置，并在自动重试全部耗尽后发送摘要告警。
• 控制台新增 yt-dlp 运行时管理，可直接查看可用运行时并切换当前生效版本，便于快速恢复下载能力。
• 将 RSS 节目描述中的 source video 文本和链接移动到末尾，让 show notes 更易阅读。

为 YouTube Data API 和 yt-dlp 新增自定义代理支持，同时带来公开分享与可信环境免登录能力。

• 为 YouTube Data API 与 yt-dlp 新增自定义代理支持，让 PigeonPod 更适合受限网络或自管网络环境部署。
• 新增一键节目分享与精简公开页，用户无需登录即可直接在 Web 端播放分享内容。
• 新增可信环境自动登录，优化移动端订阅搜索，并修复元数据同步、并发任务卡死和 RSS 标签错误。
• 扩展 BiliBili Cookie 管理，补强多平台内容接入体验。

优化订阅默认配置与 RSS 安全输出，并提升下载与封面显示稳定性。

• 在订阅源默认配置中新增 minimumDuration，并将其单位从分钟改为秒。
• 在 Web 端剧集标题中新增源视频链接，并移除未下载剧集封面跳转逻辑以统一封面点击行为。
• 在 RSS 中新增 <itunes:block> 标签，降低私有订阅被播客平台意外索引的风险。

增强来源可见性与字幕控制，同时修复 YouTube 播放列表 URL 识别问题。

• Web 界面新增频道来源徽标，并在播放列表 RSS 中加入来源文本。
• 新增订阅级“禁用字幕”配置选项。
• 修复部分 YouTube 播放列表 URL 识别错误。

引入 Bilibili、S3、历史批量下载与高级过滤，并显著优化同步性能与稳定性。

• 新增 Bilibili 订阅、S3 存储、全局下载默认配置与 YouTube API 用量统计。
• 新增历史节目批量下载、关键字 OR+AND 过滤及 RSS iTunes 元信息。
• 优化大播放列表同步性能并分离频道/播放列表视图，避免同源干扰。

增强可维护性与可迁移性，同时完善章节与过滤相关体验。

• 新增应用内更新 yt-dlp、自动下载延迟与全局最大剧集保留配置。
• 新增 OPML 导出与独立 chapters.json（遵循 Podcasting 2.0）。
• 优化自定义 yt-dlp 参数展示与关键词输入界面。

降低更新过程的存储压力，并补充账户安全能力。

• 将元数据更新与媒体下载拆分，减少不必要的磁盘占用。
• 删除节目时默认仅删除媒体文件，保留节目元数据。
• 登录页新增可选验证码，并优化 Feed 页面布局。

新增搜索/排序/过滤并修复设置页刷新问题。

• 支持配置自定义 yt-dlp 参数。
• Feed 列表新增搜索、排序、过滤能力。
• 修复用户设置页面刷新问题并优化 Feed UI。

将用户名修改规则与登录校验保持一致。

• 用户名修改应用与登录表单相同的字符长度限制。
• 避免超长用户名导致无法登录的问题。

支持浏览器一键下载，并修复自动清理后 RSS 生成异常。

• 节目卡片新增“下载到本地”按钮。
• 修复自动清理节目后后台生成 RSS 报错问题。

解决播放列表自定义头像无法更新的问题。

• 修复 Playlist 设置中自定义头像更新失败。

解决播放列表中重复节目引发的处理异常。

• 优化播放列表去重与异常处理逻辑。

媒体下载流程新增独立封面图自动保存。

• 下载媒体文件时自动拉取并保存封面文件。

容器镜像补充 curl-cffi 以支持 impersonation 场景。

• 更新 Docker 镜像依赖，加入 curl-cffi 运行支持。

下载的音视频文件可自动写入 YouTube 封面。

• 新增下载媒体文件的自动封面嵌入能力。

修复 initialEpisodes、maximumEpisodes、audioQuality 清空后无法保存的问题。

• 修复关键订阅配置字段空值持久化异常。

视频文件与音频文件分目录存储，结构更清晰。

• 为下载视频引入独立存储路径。

支持按时长上限过滤超长节目。

• 可配置最大单集时长并自动排除超限节目。

修复重要清理缺陷，并在自动清理时保留节目元数据。

• 修复剧集自动清理逻辑中的关键 Bug。
• 自动清理仅删除文件，不删除元数据，便于后续展示和手动下载。

新增字幕下载配置能力，并将订阅配置拆分为简易与专业模式。

• 新增自定义日期格式与字幕自动下载（支持全局与订阅级）。
• 支持字幕语言与格式设置，并明确不同客户端兼容限制。
• 订阅配置页拆分为“简易模式”和“专业模式”。

支持应用内直接播放音视频，并增强下载稳定性。

• 新增应用内直接播放音频与视频节目能力。
• 已下载节目新增 VIDEO/AUDIO 标签。
• 增加 remote-components ejs:npm 支持，修复近期视频下载报错。

拆分信息获取与内容下载流程，并完成 YouTube 链路重构。

• 将剧集信息抓取与媒体下载拆分，历史节目管理更友好。
• 改为完整拉取播放列表元数据，保证与 YouTube 保持一致。
• 重构大量 YouTube 工具代码，提升可维护性。

订阅详情页新增即时刷新按钮。

• 可在订阅详情页直接一键刷新订阅源。

修复 1.12.3 之后的下载失败，并重新支持 Cookie 文件下载。

• 解决 1.12.3 后下载回归问题并恢复 Cookie 支持。

支持在一个入口管理全部节目。

• 新增统一的节目管理能力，减少分散操作。

修复版本信息和夜间显示问题，同时补充 Cookie 状态展示。

• 修复 Docker 镜像版本号丢失问题。
• Cookie 管理页新增“当前 Cookie 状态”。
• 修复首页等待状态卡片在夜间模式下文字不清晰。

新增订阅级同步控制与任务可视化，并修复升级后封面丢失。

• 新增 PIGEON_COVER_FILE_PATH，修复升级后自定义封面丢失。
• 新增订阅级自动同步开关。
• 新增任务统计面板并优化订阅配置页面 UI。

Docker 增加 Deno 运行时，并要求升级后清理旧 Cookie。

• Dockerfile 新增 Deno runtime 依赖，缓解 403 下载失败。
• 升级后需清理之前上传的 Cookie。

由于容器内 ffmpeg 限制，取消 --embed-thumbnail 支持。

• 移除 --embed-thumbnail 以避免容器环境中的运行异常。

新增描述级过滤，并修复重启后下载任务卡死问题。

• 支持按节目描述中的包含/排除关键词过滤。
• 新增 Docker latest 标签支持，并完善下载文件的章节/元信息/缩略图写入。
• 修复服务重启后未完成 DOWNLOADING 任务卡死。

支持视频编码选择，并将默认音频下载编码切换为 AAC。

• 新增视频编码选择，推荐 1080P + H.264 组合。
• 默认音频下载改为 AAC，减少转码开销。
• 修复自定义标题在 RSS 中不生效。

新增自定义订阅源形象、视频质量控制与自动 API Key 初始化。

• 支持自定义订阅源标题与封面。
• 支持视频文件下载并可配置下载质量。
• 历史下载数量改为后置验证，用户初始化自动生成 API Key。

发布新 Logo，并在播放列表订阅时新增节目顺序设置。

• 发布全新 PigeonPod Logo。
• 订阅详情页封面新增订阅类型标识。
• YouTube 播放列表订阅时支持节目排序设置。

新增音频下载质量设置。

• 支持按需选择音频下载质量。

修复播放列表发布日期不一致与更新提示不准确问题。

• 修复 PigeonPod 与 YouTube 播放列表发布日期可能不一致。
• 修复更新提示不准确问题。

优化下载流程，解决任务卡在 QUEUED 状态。

• 简化 Episode 状态机并优化下载链路。
• 修复任务长期卡在 QUEUED 的问题。

新增播放列表订阅能力，并完成较大规模代码重构。

• 支持直接订阅 YouTube 播放列表。
• 重构大量代码，提升结构清晰度与可扩展性。

修复历史节目下载准确性问题并优化 YouTube 抓取链路。

• 修复下载历史节目时节目不准确的问题。
• 修复历史节目下载时节目说明不完整问题。
• 重构并优化 YouTube 节目抓取逻辑。

支持按数量下载历史节目，并补全节目时长翻译。

• 频道详情页新增“下载历史节目数量”配置。
• 补全节目时长的翻译支持。

重构 RSS 音频地址与资源读取逻辑，提升多语言订阅兼容性。

• 重构 RSS 音频 URL 生成与资源读取逻辑。
• 确保不同语言类型节目都可正确订阅。
• 修复删除频道时提示信息错误。

内置新版本检测，降低漏更概率。

• 新增版本检测能力，便于及时发现更新。

扩展平台与语言支持，并修复容器字符与 RSS 音频访问关键问题。

• Docker 新增 ARM64 支持，并扩展多语言 UI/README。
• 修复容器内 non-ASCII 字符乱码。
• 新增任务状态自动更新并修复 RSS 音频不可访问问题。

重构下载流水线，解决 SQLite 并发死锁并提升大任务稳定性。

• 重构并发下载流程，解决大量任务下 SQLite 死锁。
• 优化下载文件路径组织，按频道/标题更易查看。
• 新增大初始拉取异步化，并完善包含/排除关键词优先级规则。

修复账户与频道 ID 订阅关键问题，并调整默认密码策略。

• 修复无法修改密码问题。
• 修复通过 YouTube ID 无法订阅频道问题。
• 默认密码调整为更清晰的 Root@123。

提升频道添加精度与默认下载吞吐，并优化直播处理策略。

• 新增通过 YouTube 频道 ID 精准搜索频道。
• 默认下载线程提升，增强并发下载速度。
• 直播节目默认过滤，结束后自动更新并下载完整节目。

优化账户设置体验，并支持通过 Cookie 处理下载限制场景。

• 优化账户设置页面。
• 支持用户配置 Cookie 以应对 YouTube 下载限制。

PigeonPod 首次对外稳定版本发布。

• 发布首个稳定基线版本，作为后续持续迭代的起点。

现在可以不订阅整个频道或播放列表，直接导入单个 YouTube 或 Bilibili 视频，同时存储提醒、播放控制和大文件处理也有提升。

• 现在支持将单个 YouTube 或 Bilibili 视频直接导入到 Individual Episodes，无需先订阅整个频道或播放列表。
• 导入独立节目之前，会先展示节目预览和当前名额使用情况，免费与付费用户都能更清楚地确认导入限制。
• 当云存储空间接近上限时，系统会主动发送提醒邮件；播放器也支持更细粒度的倍速调整，首页接着听与播放队列顺序也更贴近你刚刚的收听位置。
• 大体积媒体上传到云存储时的稳定性已提升，处理长视频或较大文件时更不容易失败。

PigeonPod SaaS 现已正式上线，带来更完整的账单管理、中国区一次性访问包、更顺滑的结账恢复，以及更稳定的订阅状态同步。

• 账号页新增更完整的套餐与账单管理能力，可查看当前套餐状态、切换月付或年付、进入账单门户管理订阅，并在扣款失败时更快修复付款方式。
• 中国大陆用户现在可以通过支付宝或微信支付购买中国区一次性访问包，无自动续费；支付入口也会结合语言和地区更准确地显示。
• 登录或注册后会保留原本的付费跳转意图，已有有效国际区订阅时也会阻止重复创建结账；扣款、回调和定期校准后的套餐状态同步更及时稳定。
• 播放列表 RSS 的节目顺序与频道内排序进一步对齐，节目列表无限滚动更稳定，自动清理任务的扫描条件也已与实际规则保持一致。

新增账号级和订阅级自动清理规则，并修复存储统计、验证码流程、重新订阅预览等稳定性问题。

• 新增节目自动清理规则，支持账号默认规则和单个订阅专属规则，让付费用户管理云存储空间时更省心。
• 账号设置新增语言偏好，云存储提醒邮件会尽量按你的语言发送；桌面端节目封面也补上了媒体类型和文件大小标识，浏览效率更高。
• 导入设置结构更清晰，Feed 预览与 RSS 输出规则进一步对齐，播客客户端订阅链接更可靠，手动同步和自动下载的触发结果也更一致。
• 重新订阅时会刷新过期预览数据；当订阅停用、取消或节目不再符合保留条件时，云存储占用会更及时释放；邮箱验证码流程和自动清理对手动保护设置的继承也已修正。

新增单集最长时长筛选、音频或视频下载类型选择、Web 视频播放，以及桌面端播客 App 二维码订阅。

• 订阅规则新增“单集最长时长”筛选，可与关键词和最小时长组合使用，更精细地控制哪些节目会被自动保留。
• 每个订阅现在都能单独选择下载音频或视频版本，Web 播放器也支持直接预览视频内容，保留视频订阅时更直观。
• 桌面端新增播客 App 订阅二维码，导入 RSS 更快；同时 Feed 页面操作流程、节目状态多语言文案和云存储说明也一起变得更清晰。
• 云存储配额统计现在会排除不再命中过滤条件的自动节目，已停用的 RSS 链接也会明确返回无权限状态，避免模糊失败。

修复桌面端 Feed 分页问题，播放列表同步和下载会跳过付费剧集，菜单文案也更清晰统一。

• 修复桌面端 Feed 详情页的节目列表自动翻页逻辑，切换分页和加载更多时更稳定。
• 播放列表同步和下载任务现在会自动跳过付费剧集，避免无效处理和异常任务状态。
• 调整桌面端 Feed 菜单文案，让各个入口的命名更清晰一致。

修复了「接下来播放」页面筛选结果异常的问题。

• 修复「接下来播放」页面的筛选逻辑错误，列表过滤恢复正常。
• 给「最新节目」页面的筛选值添加缓存功能，方便下次访问时直接恢复。
• 新上线 PigeonPod SaaS 服务状态监控页面，服务状态随时可知。

PigeonPod SaaS Beta 访问现已正式开放。

• PigeonPod SaaS Beta 访问现已正式开放。