文件夹监控

TODO（新增截图）：监控配置与任务面板（App 2.0） 建议包含：监控配置列表（运行/暂停）、新增配置弹窗、历史任务与失败重试区。 建议文件名：watch-folder-panel-v2.png

功能边界

文件夹监控（Watch）用于自动化处理目录中的音视频文件，核心能力：

• 监控配置管理（新增/编辑/暂停/恢复）
• 新文件自动入队转录
• 活跃任务与历史任务追踪
• 失败重试、批量操作、自动导出

适用场景

• 会议录音目录自动入库
• 内容团队素材文件夹持续处理
• 夜间批量离线转录任务

操作步骤

1. 进入左侧导航“监控”页面。
2. 新建监控配置：选择目录、命名、递归策略、导出策略。
3. 启动监控并观察“进行中任务”与“历史任务”。
4. 对失败任务执行重试，对重复任务选择保留/跳过策略。
5. 定期检查导出目录与磁盘占用，保证任务连续性。

配置建议（避免误触发）

• 监控目录尽量保持“单一用途”，不要混放非媒体文件。
• 文件命名建议加入来源与日期，便于异常定位与追溯。
• 超大目录建议按项目或月份拆分，减少初扫耗时。
• 避免把高频变更的临时目录直接接入监控。

名词解释（便于排障）

• 递归监控：是否同时监听子目录；开启后覆盖范围更大但事件更多。
• 历史任务：已经完成或失败的任务记录，用于复盘与重试。
• 重复任务策略：发现同名或同源文件时，如何保留、跳过或覆盖。

示例流程（会议录音自动入库）

1. 把会议软件导出的录音统一落到一个目录。
2. 对该目录开启监控并设置自动导出 TXT/SRT。
3. 每天只需处理失败任务和异常文件，减少手工重复操作。

真实场景（内容团队夜间批处理）

如果团队每天晚上会产出大量素材，推荐把“监控 + 夜间队列”固定为标准流程：

1. 下班前把素材归档到约定目录。
2. 夜间由监控自动入队，第二天只处理失败任务。
3. 每周复盘一次失败原因，逐步优化命名与目录策略。

常见问题

Q: 为什么新增文件没有自动转录？
A: 先确认配置是否处于运行中、路径是否可访问、文件格式是否受支持。

Q: 可以监控多个目录吗？
A: 可以，具体数量与高级选项由账号功能配额决定。

Q: 监控任务会影响手动转录吗？
A: 会共享计算资源，建议按设备性能设置并发与调度优先级。

常见误区与替代做法

• 误区：把下载目录直接作为监控目录
  替代：先落地到“待处理目录”，再由监控统一接管。
• 误区：所有项目共用一个超大目录
  替代：按项目/月份拆分，降低初扫与排障成本。
• 误区：失败任务长期不清理
  替代：每日固定 10 分钟清理失败队列，防止积压滚大。

队列积压时处理建议

1. 优先降低并发并暂停非核心监控配置。
2. 先处理失败任务，再回放长尾历史任务。
3. 对超大文件先转码压缩，减少单任务占用时间。

限制说明

• 监控能力受账号套餐、目录权限和磁盘空间影响。
• 网络盘/可移动磁盘在断连时可能导致监控中断。
• 超大目录初次扫描耗时较长，建议分层配置。
• 平台：Windows 与 macOS 均支持监控，文件系统事件延迟与路径权限规则存在差异。