Files
Auto_Bangumi/docs/ja/dev/plugins/points/media-files.md
Estrella Pan 3258fcca4b docs(4.0-P7): 插件开发文档拆分为总览加每个扩展点一页,补齐中英日三语
- docs/dev/plugins.md 改为总览与导航,旧内容拆入 docs/dev/plugins/
- 新增核心概念、配置表单、事件、前端挂载点、命令行、签名与分发、内置插件、示例页
- 每个扩展点一页,侧边栏由页面表生成
- 改正旧文档中下载器配置、hardlink path_map 与补链按钮的过时描述
2026-10-08 14:51:00 +02:00

1.1 KiB

ファイル分類 (media_files)

トレント内のどのファイルを本編として、どのファイルを字幕としてリネームするか、どれを無視するかを決めます。@provider(points.MEDIA_FILES, id=...) は MediaFiles を返します。

from ab_sdk.rename import MediaFiles, MediaKind

class ByExtension:
    def classify(self, path: str) -> MediaKind:
        if path.endswith((".mkv", ".mp4")):
            return "media"
        if path.endswith((".ass", ".srt")):
            return "subtitle"
        return "ignore"
  • media(本編としてリネーム)、subtitle(本編と一緒にリネーム)、ignore(処理しない)のいずれかを返します。
  • ホストの実装 default は拡張子で判定します:.mp4 と .mkv は本編、.ass と .srt は字幕です。
  • plugins.slots.media_files で Provider の id を選びます(既定は default)。選ばれた id が登録されていない場合(プラグインが無効、またはブレーカー作動中)は、default に戻ります。