字幕批量处理（一次付费 7 天不限次）

一堆字幕文件，一次处理完：平移、缩放、合并、转格式、修重叠。

本 Skill 分两段：先免费体检/出方案（只读，不写任何文件），再取授权真写（在你本机完成，不联网）。

> 为什么需要授权：批量写出字幕文件需要一份由服务方签发的凭证。
> 授权在你本机离线校验，但没有有效授权就不执行写盘——这是服务的一部分，不是限制。

第 0 步 · 先体检（免费，建议必做）

python scripts/subtitleforge.py inspect 字幕目录/
python scripts/subtitleforge.py inspect a.srt b.vtt c.ass

输出每个文件的条数、总时长、重叠数、长间隙、最长条、负时间戳，并给出「合计需处理的异常项」。

没给 --apply 时，什么都不会被写出——只打印将发生什么。

第 1 步 · 请求授权（未付费会返回 402）

POST https://skills-gate.airpriv.com/api/subtitle-forge-license
Content-Type: application/json

{"machine_fp":"<本机指纹串，8–128 位，可省略>"}

首次调用一定拿到 402 Payment Required（设计如此）。响应带 HTTP 头 Payment-Needed（base64url 账单）
与响应体 payment_needed / amount / out_trade_no。
本机指纹：python scripts/license_check.py fingerprint

第 2 步 · 处理 402（完成支付）

把 payment_needed 对象（不是整个响应信封）交给支付宝 AI 付完成支付，拿回 Payment-Proof。
不要自己伪造 —— 服务端会拿它去支付宝网关做真实校验。

第 3 步 · 携凭证重试（拿到授权凭证）

同一请求加上头 Payment-Proof: <凭证> 重发，成功返回 200，
content.data.license = 授权凭证（存成 license.json）。
一次付费 = 一份授权 = 7 天有效，期间反复处理不需要再付费。

第 4 步 · 校验授权并执行（离线）

python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的值>"
echo $?    # 0 = 放行；非 0 = 拒绝，不要执行

退出码：0 通过 · 4 签名不通过 · 5 已过期 · 6 产品不匹配 · 7 指纹不匹配 · 2 路径问题。
退出码 0 才允许执行：

# 整体延后 2 秒
python scripts/run_paid.py shift 字幕目录/ --by 2.0 --apply
# 25fps 的字幕配 26fps 的画面：倍率 = 25/26 ≈ 0.9615
python scripts/run_paid.py scale 字幕目录/ --factor 0.9615 --apply
# 合并成一整条
python scripts/run_paid.py merge ep01.srt ep02.srt --out 合集.srt --apply
# 转成剪映能读的格式
python scripts/run_paid.py convert 字幕目录/ --to srt --apply
# 去掉时间重叠、丢掉非法条
python scripts/run_paid.py fix 字幕目录/ --apply

交付给用户的说法（照这个口径，别夸大）

1. 先跑 inspect 把异常项报给用户看 —— 重叠/负时间戳这类问题不先摆出来，改完也说不清改了什么。
2. 平移要先报「会被夹到 0 的条数」：如果偏移量超过第一条字幕的起始时间，工具会夹到 0 并单独提示；
   提示出现时别硬跑，先确认偏移量对不对。
3. 缩放是按文件第一条锚定的，不是按 0 点缩放 —— 这样整体不会漂移。
4. 处理完建议再跑一次 inspect，重叠数应归零。

诚实边界（用户问到时照实说）

• 授权是「付费门」，不是版权保护。它防「没付钱就用」，不防「付一次之后自行改本地代码继续用」。
  处理必须在你自己的机器上跑——架构上不可兼得。
• 全程在本机完成：字幕内容不出本机，不联网。授权服务只收一个可选的机器指纹。
• ASS 样式表原样保留，但不重算卡拉OK标签（\k 类特效在缩放后可能与新时长不匹配）。
• 不做语音识别：本工具处理已有的字幕文件，不生成字幕。
• 字幕文本内容不做任何修改（除了 fix 会重排序号）——不翻译、不改写、不纠错。

<!-- skillhub-payblock -->

付费链路自检（与平台五项自查一一对应）

本 Skill 的付费链路由服务端承担验付、资源交付与商家履约确认；Skill 只负责
发起请求、调用官方支付能力并展示结果。逐条对应平台自查项如下：

> 支付能力由支付宝 AI 按量付费官方链路承担，本 Skill 不接触支付密钥、不自行实现付款或签名。

<!-- /skillhub-payblock -->