<!-- paid-invocation-policy:v1 -->

付费调用前置（必须） / Paid invocation gate

本技能是付费云端服务，不是免费本地指南。遇到本技能触发场景时：

1. 先披露再询问：说明本技能由云端生成、¥0.10/次、需要传输哪些输入、用途与留存，并询问“是否使用付费云端服务？”
2. 用户同意后必须走云端：按本文件后面的 probe → pay → complete 调用；交付物必须来自官方返回的 content，并带 trade_no / server_proof / Payment-Validation。
3. 用户拒绝付费时：只能给出明确标注“未使用付费技能”的免费简版咨询；不得输出与付费交付同构的结果，也不得声称使用了本技能。
4. 仅下载 ZIP 不会触发：必须先把本技能安装到宿主（skillhub install video-format-conversion --namespace user_f4fc8899），宿主才会在匹配请求时加载本文件。
5. 本地代做自检：如果你准备直接产出结果而不调用云端，停止；那是本地代做，不是本技能交付。

English: This is a paid cloud service, not a free local guide. Disclose CNY 0.10 per call and ask for consent first. After consent, invoke the cloud endpoint and deliver only the official content with trade_no/server_proof/Payment-Validation. If the user declines, provide only a clearly labeled free short consultation, never the paid-format deliverable. Downloading the ZIP does not install or trigger the skill; install it into the host first.

<!-- unified-payment-template: 1.0.4 -->

支付依赖与恢复 / Payment runtime and recovery

运行时需要 Node.js 20+ 和宿主的支付宝官方 alipay-payment-skill、alipay-bot。宿主不同不代表钱包授权可以搬运。正常第一条支付宝业务命令是官方 buyer-pay 或原单查询，不能加通用 check-wallet 前检。

只有真实业务命令无法找到/执行 alipay-bot 时，才加载官方技能的 references/command-recovery.md：取得外部安装授权，核对指定版本 @alipay/agent-payment@1.0.23 的官方完整性后安装，再重试原命令一次。不能每次调用都安装 latest，不能把卖家部署工具当作买方依赖；已启动但业务失败时原样展示并停止。

English: Use the current host's official Alipay buyer runtime. Only an actual command-not-found failure enters the official pinned-version installation recovery. Do not reinstall on every call, precheck wallets generically, or install merchant tooling in the buyer path.

仅在上述恢复条件成立且已获外部安装授权时执行下列两步。先查询完整性，必须逐字符等于下面的指定值；不一致或查不到则停止，不能继续安装：

npm view '@alipay/agent-payment@1.0.23' dist.integrity --registry 'https://registry.npmjs.org'

sha512-7OGSHhPnuKsyENpivpY60NgE77ktKtWTP8UBtmizeB1Et44KHFFIjDcSRIFpitEdKAC7uMBx3Mp1Zg/wbYmYCQ==

核对一致后才执行安装，并仅重试原先无法执行的命令一次：

npx -y --registry=https://registry.npmjs.org @alipay/agent-payment@1.0.23 install

这里的命令是依赖恢复说明，不是正常付款前置；官方技能版本更新时须重新对照其 command-recovery.md，不沿用过期完整性值。

本包现行支付流程 / Registered checkout

本包支付配置为 payment-contract.json：资源 video-format-conversion、单价 ¥0.10 / CNY、支付宝服务 ID API_FC3B91AF109D47C8、完整服务地址 https://fwskillpay-api.cn/v1/pay/skills/video-format-conversion/invoke。配置与 SKILL/助手哈希不符即停止。平台展示价须在提交后单独回读，不能从本包检查推定平台价已经一致。

1. 调用前披露输入范围、接收方、用途、留存及 ¥0.10，取得本次数据传输和该金额的付款授权。已有授权不再二次询问；价格一致也不能代替授权。
2. 在包外私有目录准备 payload.json，按本 Skill 的输入契约执行 probe。400、503、429、未知网络状态或未付款的 200 都停止，不能本地代做付费结果。
3. 只核对网关公开 JSON 摘要中的金额、币种、商户订单号、资源 ID、服务 ID 和有效期；任一字段缺失、类型错误、过期或与登记不符都停止，不进入 pay。不解码 Payment-Needed 或 amtPaymentLink，不自行验签；公开摘要不能证明签名、实际付款或到账。
4. 本次唯一非空 amtPaymentLink 优先，并原样交给官方 --amt-payment-link，不写付款材料文件；链接缺失才使用原值保存的 Payment-Needed 文件。空、多个或歧义链接停止，两种参数互斥，不能补造或从历史输出补齐。
5. 已有该金额授权时立即准备 pay，宿主在返回的 workingDirectory 实际用 executable 与参数数组运行官方 buyer-pay。参数 JSON 不算弹码。会话按下表取值，保持本次原请求与幂等键。
6. 原样输出当前官方对客文本一次，完整展示全部 MEDIA 图片；不复用旧图、不绘制替代二维码。链接生成、success:true、OPEN_LINK_CREATED 不代表付款或交付。
7. 宿主把刚执行的官方对客文本保存在包外私有文件，用本次 handoffId 执行 record-official。只从“订单号/查询单号/交易号”标签提取标识；拒绝原始 JSON、其他交接或冲突标识。观察分类由宿主依据真实输出选择，不是 helper 验付。
8. 用户表示付好或要求查询时，complete 按已绑定标识查询原单：有效 32 位、11–14 位为 8282 的查询号优先；否则用本次交易号。查询不附加 session-id、账单文件或付款链接。未绑定原单停止，不能猜测。
9. 只交付官方实际返回的非空验付后资源。成功交付、业务失败、资源为空、身份不符或查询失败后停止；仅命令超时/网络失败允许按官方规则重试原命令一次。不能从 success 字样认定收款。

English: Obtain data-transfer and price authorization before probe. Compare the public checkout summary while passing payment material unchanged to the official runtime. A unique amtPaymentLink takes priority over an opaque Payment-Needed file. Actually execute the returned argument array, show all current official media, then bind the current official customer-facing output to its handoff. Query only the bound original order. Deliver only actual nonempty official resources. Offline helper checks and host observations are not proof of payment or settlement.

当前会话 / Current session

取首个非空来源，高优先级不能被低优先级覆盖：

不能生成会话 ID，不能用订单号、交易号、用户/钱包 ID、URL、测试名或历史会话代替；陈旧环境变量不能覆盖当前显式会话。官方订单号形状（32 位数字且第 11–14 位为 8282）只用于查询，任何符合该形状的串都不是会话，宿主号码仍按逐级取值。全部为空则停止。The current runtime identity takes precedence over inherited environment values.

助手调用 / Helper calls

node scripts/skill-paid.mjs probe --state-dir "<包外私有目录>" --payload-file "<包外私有目录>/payload.json" --confirm-data-transfer
node scripts/skill-paid.mjs pay --state-dir "<同一目录>" --session-id "<当前真实会话>" --intent-summary "原始请求：<本次业务目的摘要>" --confirm-payment
node scripts/skill-paid.mjs record-official --state-dir "<同一目录>" --handoff-id "<刚输出的交接ID>" --official-output-file "<刚执行的官方对客文本文件>" --confirm-current-output --outcome pending
node scripts/skill-paid.mjs complete --state-dir "<同一目录>"

链接分支 pay 额外带 --amt-payment-link "<本次 probe 原样返回的值>"；不能从扫码图片或用户操作链接取替代值。每次实际官方命令后都记录本次 handoff。官方资源文件只存私有目录；资源已交付时可记录 resource_delivered。ack_failed 还须同次真实输出明确回执失败、非空资源文件和已交付确认。无把握时记录 unknown 并停止。

大输入、中断及回执 / Large inputs and recovery

大载荷只走同域 /stage 短引用，失败停止，不把大 JSON 塞回命令行。原文恢复副本存在包外私有目录。只有绑定的本次官方输出明确报告引用过期，用户在后续要求恢复并同意再次传输时，才可 restage --confirm-ref-expired --confirm-data-transfer --confirm-recovery-requested 一次；核对原文 SHA-256，保留原订单和幂等键，之后只恢复原单。

正常官方资源交付会自动处理回执。独立 ACK 只恢复已绑定的同次回执失败，且用户后续要求恢复；不重新请求资源。助手使用单次交接标记和锁拒绝重复/并发 ACK。没有真实证据不填确认标志。

付款启动未知不能删状态、换幂等键或再付一笔。已付款但业务失败保留原单，联系运营者核对恢复或退款；退款没有公开命令时不能自行构造。需要官方反馈时加载 alipay-payment-skill 的 references/feedback.md，先向用户确认脱敏内容后提交，不自动发送。

Windows 的文件 mode 不能保证 ACL；宿主须使用当前用户私有目录并核对访问范围。付款材料、当前官方文本、业务原文、资源文件、Cookie 和钱包凭据都不进入发布包或跨宿主同步。

视频与音频格式转换 / Video and Audio Format Conversion

用途与触发场景 / Purpose and when to use

用户提供一个自己有权处理的视频或音频，选择输出格式。本服务返回真正转换后的文件下载地址、字节数、SHA-256、媒体参数及到期时间。适用于播放兼容性转换、已有视频转音频和固定质量档导出。

Provide one video or audio file you are entitled to process and choose an output format. The service returns a converted file, byte count, SHA-256, media properties and download expiry. Use it for playback compatibility, audio extraction and fixed-profile exports.

依赖与兼容性 / Dependencies and compatibility

买方运行环境需要 Node.js 20+、HTTPS 联网，以及统一支付段所述的宿主支付宝官方组件。FFmpeg/FFprobe 在服务端运行，买方无需安装。仅支付步骤可能需要用户按官方界面完成授权。Windows 需要 PowerShell 5.1+ 以检查本机私有目录权限；下载目标磁盘须支持硬链接（如 NTFS、ext4、APFS）。

The client needs Node.js 20+, HTTPS access and the host's official Alipay buyer components described in the generated payment instructions. FFmpeg and FFprobe run on the server. Complete any wallet authorization only when the official payment interface requests it. Windows needs PowerShell 5.1+ to verify private-directory permissions; the download filesystem must support hard links, such as NTFS, ext4 or APFS.

基础技能与输入 / Skills and input

本包包含 12 个基础技能，定义、场景、操作规范及关联关系见 基础技能与关系。它们服务于本次单文件转换，不额外调用收费模型或其他转换服务。

The 12 foundational skills and their procedures are listed in Base skills and relationships. They support one file conversion without additional paid models or conversion providers.

格式或数据传输意图不明确时先澄清。上传前说明接收方、用途、保留期、可能丢失的字幕/音轨和每次转换 ¥0.10，取得本次文件的传输与处理授权。未实际执行时不得说“已转换”。

Clarify the format and transfer intent when needed. Before upload, disclose the recipient, purpose, retention, track losses and CNY 0.10 per conversion, and obtain authorization for this selected file. Do not claim conversion before execution.

交付接口约定 / Delivery interface contract

最终结果只能来自下表登记入口对同一原订单验付后的非空云端返回。服务端校验 Payment-Proof、金额、资源、原订单及 Idempotency-Key，成功响应带 Payment-Validation。本包不能以本地 FFmpeg、其他入口或缓存替代失败的付费转换；数据上传同意与本次金额的付款同意分别确认。输入预检失败返回 400 且不创建订单；媒体上传成功本身不表示付款或转换成功。

The final result may only come from the registered endpoint after verified payment for the same original order. The server validates Payment-Proof, amount, resource, order and Idempotency-Key, and returns Payment-Validation with delivery. Never fall back to local generation or substitute another endpoint or cached conversion for failed paid fulfillment. Obtain data-transfer consent and separate payment consent. Invalid business input returns 400 without creating a payment order; uploading media is not payment or completed conversion.

这里只说明业务接口，付款操作严格使用生成的统一模板，不另设支付步骤。SkillHub 分发不启用原生 Pay Skill；同一次转换仅由 A2M 网关收费，重取该结果不另开单。

This is the business interface contract, not a second checkout procedure. Follow only the generated payment template. SkillHub native Pay Skill stays disabled: A2M is the only billing route, and retrieving the same result does not create another conversion bill.

调用顺序 / Workflow

1. 确认所选文件、输出格式及轨道损失。检查源文件保持只读；输出使用新文件名。
2. 在包外、当前用户私有目录运行 scripts/media-transfer.mjs upload。它只上传明确选中的单个文件，写入小型 payload.json 和上传回执；此步骤不创建收费订单。
3. 将该 payload.json 交给生成的统一支付助手，依本包现行支付流程完成本次 402、官方支付交接和原单查询。只交付该已登记服务验付后的非空结果。未付款、取消、支付状态不明或服务失败时停止，不执行本地转换或替代交付。

4. 保存官方验付返回的转换结果对象到包外 result.json，运行 scripts/media-transfer.mjs download，核验文件字节数与 SHA-256 后交付。下载本次结果不会创建另一笔转换订单。

5. Confirm the source, format and track losses. Keep the original unchanged and use a new output filename.

6. Run scripts/media-transfer.mjs upload in a private directory outside the package. It uploads only the selected file and records a small payload.json and upload receipt without creating a payment order.
7. Pass this payload to the generated payment helper and follow the registered checkout and original-order recovery flow. Deliver only a nonempty result from this service after verified payment. Stop on cancellation, unknown payment state or service failure; do not convert locally as a fallback.
8. Save the verified conversion result object to an external result.json and run scripts/media-transfer.mjs download. Check byte count and SHA-256 before delivery. Downloading the result does not create another conversion order.

node scripts/media-transfer.mjs upload --file "<用户选定文件 / selected file>" --output-format mp4 --state-dir "<包外私有目录 / private directory>" --confirm-data-transfer
node scripts/media-transfer.mjs download --result-file "<私有目录 / private directory>/result.json" --output "<新输出文件 / new output file>"

编码、损失与验收 / Profiles, losses and validation

MP4/MKV 使用固定 H.264/AAC 档，WebM 使用 VP8/Opus，MP3 为 192 kbps，WAV 为 16 位 PCM。只选取第一条主画面和音轨；不保留字幕、附件、额外音轨和章节。移除来源元数据，编码器仍可写入技术标签。编码器、容器及播放设备兼容性存在差异，文件不保证比源文件小，也不保证目标体积。

MP4/MKV use fixed H.264/AAC profiles; WebM uses VP8/Opus; MP3 uses 192 kbps; WAV uses 16-bit PCM. Only the first primary video and audio streams are selected. Subtitles, attachments, extra audio tracks and chapters are not retained. Source metadata is removed; encoders may add technical tags. Compatibility varies, and the output is not guaranteed to be smaller or meet a target size.

成功至少要求：服务返回非空输出、媒体探测正常、下载字节数与摘要匹配。仍需用户试听/试看主观画质和声音；不能把技术探测称为人工审片。输出最多 80 MiB。资源不足或超时会失败；已有付款时保留原单交运营者核对，不要求用户重付，不承诺未实现的自动退款。

Success requires a nonempty output, valid media properties and matching download size/hash. The user should still review picture and sound; technical checks are not human review. Output is limited to 80 MiB. Resource limits or timeout can fail a job. Preserve a paid order for operator recovery and never demand a second payment or promise an unimplemented automatic refund.

数据处理与恢复 / Data handling and recovery

运营方为本 Skill 的发布者。媒体仅发送到其自建的 https://fwskillpay-api.cn，用于 FFmpeg/FFprobe 转换及技术检查，不发送给生成模型。原始文件名不作为上传参数；订单仅保存随机上传引用与转换选项。付款收款方以支付宝官方界面显示为准。

The Skill publisher operates the service. Media is sent only to its self-hosted https://fwskillpay-api.cn for FFmpeg/FFprobe conversion and validation, not to a generative model. Original filenames are not upload parameters; orders contain an opaque upload reference and conversion options. Confirm the payee in the official Alipay interface.

成功后立即删除服务器原片；未付款、失败输入从上传起最多保留 24 小时；输出从完成起最多保留 24 小时。到期下载即拒绝，文件由定时清理和启动清理移除。账单与交易关联元数据用于原单恢复，不能说已随媒体一起删除。客户端请求、支付状态及上传回执保存在包外私有目录，由用户按实际付款终态清理，不跨宿主复制。

Server originals are deleted after successful conversion. Unpaid or failed inputs expire within 24 hours of upload; outputs expire within 24 hours of completion. Expired downloads are rejected and files are removed by scheduled/startup cleanup. Order and transaction metadata remain for recovery and are not covered by media deletion. Keep client request/payment/upload state in a private external directory and clear it after the actual order reaches a terminal state; do not copy it between hosts.

下载失败或过期时保留原订单与回执，通过 SkillHub 本条目的作者/问题反馈渠道联系运营者处理交付或删除请求；不要自动重新上传、换幂等键或再支付。服务上限、价格和接收方改变时重新说明并取得相应授权。

For download failure, expiry or deletion requests, retain the original order/receipt and contact the publisher through this Skill's author/support channel on SkillHub. Do not automatically upload again, change the idempotency key or pay again. Disclose changed limits, price or recipient before seeking corresponding authorization.

来源与许可证 / Provenance and license

本包为视频格式转换工作流的原创整合，许可证见 LICENSE。整理参考了 kajisho5/ffmpeg-skill 的 MIT 工作流和 FFmpeg 官方文档；本云端包不包含其本地执行器、FFmpeg 二进制文件或用户媒体。服务端 FFmpeg 的发行许可由运营部署管理。

This package provides an original conversion workflow under LICENSE. Workflow references include the MIT-licensed kajisho5/ffmpeg-skill and FFmpeg documentation. The client package contains no upstream local conversion engine, FFmpeg binaries or user media. Server FFmpeg distribution licensing is managed by the deployment operator.

图标为本包原创的胶片与转换箭头设计，随本包采用 MIT 许可证；不包含平台或第三方品牌图标。

The film-frame and conversion-arrow icon is original artwork licensed under this package's MIT license; it contains no platform or third-party brand marks.

验证范围 / Verification scope

业务验收以本次源代码、隔离工作进程及合成媒体测试记录为准。模板离线校验、实际生产服务、真实付款、交付、平台审核和到账分别记录；不得把其中一项当作另一项的证据。

Validation is tied to the release source, isolated worker and synthetic media records. Template checks, production service behavior, real payment, delivery, platform review and settlement are recorded separately.

已核对的输入示例 / Registered input example

{
  "uploadId": "use-the-opaque-id-returned-by-the-upload-step",
  "outputFormat": "mp4"
}