Tvheadend录制文件命名模式中$n参数的应用限制解析

在Tvheadend 4.3开发版本中，用户反馈了一个关于录制文件命名模式的有趣现象。当使用类似$t/%F-$n/00001.$x的命名模板时，发现其中的$n序号参数并未按预期应用于目录名称，而是仅作用于文件名。本文将从技术角度解析这一设计行为的内在逻辑。

核心机制解析

Tvheadend的录制文件命名系统采用了一套灵活的变量替换机制，其中$n是一个特殊的序号变量。根据官方设计规范，该变量具有以下特性：

1. 增量特性：当检测到目标路径已存在同名文件时，系统会自动递增$n的值
2. 作用域限制：该序号机制仅针对文件层级生效，不适用于目录层级
3. 冲突解决：主要功能是解决文件命名冲突，而非目录结构管理

典型应用场景示例

假设我们设置录制模板为：/recordings/%F-$n/00001.ts

当首次执行录制时：

• 创建目录：/recordings/2025-05-23-$n/ （保持原始变量名）
• 创建文件：00001.ts （无序号）

当检测到文件冲突时：

• 目录保持不变：/recordings/2025-05-23-$n/
• 新文件命名为：00001-1.ts （应用序号）

技术实现建议

对于需要实现目录序号化的需求，建议采用以下替代方案：

1. 预处理脚本：通过TVH的录制前脚本动态创建带序号的目录结构
2. 后处理方案：利用DVR的post-processor功能配合filemovedAPI实现录制后的文件重组
3. 定时任务：通过外部脚本定期整理录制目录结构

系统设计考量

这种限制性设计主要基于以下工程考量：

• 目录存在性检查成本较高（需要递归验证）
• 保持录制任务的原子性（避免因目录操作导致录制失败）
• 简化冲突解决逻辑（专注处理文件层级的竞争条件）

理解这些底层机制有助于用户更合理地规划录制存储方案，避免在自动化管理过程中出现意外行为。