Skip to content

数据导出

CineRename 不仅能重命名您的文件,还允许您以标准化格式导出有用的数据,以便为其他工具(电子表格、脚本、数据库)提供支持。

导出重命名报告

Studio 中,完成模拟或确认重命名后,您可以点击工具栏上的 导出报告 (Export report) 按钮。

生成的文件包含精确的演练预览 (dry-run) 和修改信息,可选择以下格式:

  • CSV (逗号分隔值):非常适合在 Excel 或 Google Sheets 中打开。包含列:statussource_pathcurrent_namesuggested_nametarget_pathmedia_kinddetected_kindsource_labelconfidencetemplate_namewarningserror_message
  • JSON:结构化对象,包含 generatedAtbatchIdsummary (totalItemsreadyCountreviewCountblockedCount) 和 items 数组。
  • Markdown (.md):格式化表格,展示批次摘要、计数和状态指示。

匹配状态说明:

  • ready:高可信度匹配,可直接执行
  • review:低置信度或有歧义,需要人工复核
  • blocked:验证错误、文件冲突或无法解析路径

JSON 报告示例

json
{
  "generatedAt": "2026-09-07T10:00:00Z",
  "batchId": "preview-20260907-001",
  "summary": {
    "totalItems": 1,
    "readyCount": 1,
    "reviewCount": 0,
    "blockedCount": 0
  },
  "items": [
    {
      "itemId": "item-1",
      "status": "ready",
      "sourcePath": "/downloads/Breaking.Bad.S01E01.mkv",
      "currentName": "Breaking.Bad.S01E01.mkv",
      "suggestedName": "Breaking Bad - S01E01 - Pilot.mkv",
      "targetPath": "/media/Series/Breaking Bad/Season 01/Breaking Bad - S01E01 - Pilot.mkv",
      "mediaKind": "series",
      "detectedKind": "series_episode",
      "sourceLabel": "TheTVDB",
      "confidence": 98,
      "templateName": "Default Series",
      "warnings": [],
      "errorMessage": null
    }
  ]
}

导出剧集列表(时间表)

如果您在 CineRename 中加载了一部剧集,软件会从 TheTVDB 或 TVmaze 获取该剧集的完整结构(包括缺失的或尚未播出的剧集)。

您可以导出这个完整的列表来追踪您的观看进度或计划您的下载:

  1. 点击侧面板中剧集名称旁边的 剧集选项 (Series options) 图标(三个小点)。
  2. 点击 导出剧集列表 (Export episodes list)
  3. 选择格式:
    • CSV
    • TSV (制表符分隔值)
    • JSON

导出内容包括:

  • 剧集标题
  • 季数和集数
  • 剧集标题(使用您首选的语言)
  • 官方首播日期 (Air Date)
  • 绝对标识符(对于动漫很有用)

自动化

如果您使用 CLI (cinerename),您可以使用 --json 标志强制以 JSON 格式输出,以在标准输出 (stdout) 上检索所有元数据,这相当于自动导出。

CineRename 文档