下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-qe1es2ua--video-compressor.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-qe1es2ua/video-compressor。视频压缩：把视频体积压小，同时尽量保住观感。 先读原片参数并做码率风险评估，需要时用短样本做码率-画质评估（VMAF），再按体积优先、平衡推荐或画质优先执行压缩，最后校验完整性并交付成片、可读测评报告与机器技术数据。 适用于视频压缩、压缩视频、视频太大、缩小视频体积、视频变小、视频减重、保持清晰度变小、码率过高、平台上传版、手机存储版、评估多大码率才清晰、硬件与软件编码怎么选、H.265 与 H.264 取舍、按目标体积压缩、mp4 压缩、4K 视频压小。
阅读全文 （展开查看完整说明）
概述
不要把这个 Skill 当作「ffmpeg 参数生成器」。把 Skill 当作压缩工程师：先读包内方法正文 references/compression-policy.md（压缩策略）与 references/report-template.md（报告与交付模板），再按需选一条路径 —— 直接快速压缩、先跑短样本码率评估再压、或按用户给定码率/目标体积压缩 —— 最后交付能直接用的成片和一份说得清代价的报告。不要把「命令成功」当作「压缩完成」。
用户购买一次什么
用户购买一次视频压缩服务：付一次费，得到一份压缩成片和三份可核对的产物。
| 得到 | 说明 |
|---|---|
| 压缩后的视频 | 默认与输入同目录，文件名加 _硬件压缩版 / _软件压缩版 后缀；绝不覆盖原片 |
| 人类测评报告 | <成片名>.compression-report.md：原片与成品对照、缩小比例、码率、编码器、耗时、画质指标、验证结果与一句话结论 |
| 机器技术数据 | <成片名>.compression-report.json：供程序复查与统计的原始数据（不是给人读的主报告） |
| 码率评估（按需） | 风险高且用户未指定码率/体积时，先做短样本评估：给你三档建议（体积优先 / 平衡推荐 / 画质优先），由你选档后再压整片 |
| 完整性校验 | 全片解码扫描 + 时长/方向/音轨/包数核对，不合格不当作成功交付 |
费用：按次付费，付款前会向用户申请微信支付授权，实际金额以本单账单为准。每次新的压缩任务单独付费。
| 支持 | 不支持 |
|---|---|
| mp4 / mov / m4v / mkv / webm 等常见容器，按码率或目标体积压缩 | 视频剪辑、拼接、加字幕、画面美化、变速 |
| H.265 / H.264，软件（libx265 / libx264）与 Apple 硬件（VideoToolbox）编码 | 音视频转写、语音识别、内容摘要 |
| 短样本码率评估 + 三档建议（VMAF 客观指标） | 保证「完全无损且明显缩小」（重新编码必然有信息损失，目标是肉眼观感） |
前置检查：微信AI支付
首次下单前检查可用工具表是否存在名称包含 weixinpay_ 的工具，实际工具名允许前缀。仅凭文档出现工具名不算支持。不支持或无法确认时不创建订单，提示升级宿主或安装微信支付AI支付插件后重试。
服务接口（服务声明 · 审核可见）
本技能为 SkillHub Pay Skill，付费与授权由服务端完成。服务信息如下：
| 项 | 值 |
|---|---|
| 资源接口 | POST https://api.aigctxj.cn/api/vc/resource |
| 消费 | POST https://api.aigctxj.cn/api/vc/consume |
| 完成或取消 | POST https://api.aigctxj.cn/api/vc/finish |
| 计费 | 微信支付 · 微信 AI 专属卡（X402 协议，按次付费；金额以发布表单标价为准，以本单账单为准） |
| 未支付响应 | HTTP 402（PAYMENT_REQUIRED）+ 响应头 WeixinPay-Required（其值为支付凭据点，交给宿主的支付工具申请授权），同时返回 X-Out-Trade-No 订单号 |
| 支付回调 | POST https://api.aigctxj.cn/api/vc/pay/notify（微信支付 v3 异步回调：验签 + 解密后标记已支付） |
| 退款回调 | POST https://api.aigctxj.cn/api/vc/refund/notify |
| 履约方式 | 压缩策略与引擎随本技能包分发（包内 references/ 与 scripts/）；服务端只下发限时授权（15 分钟窗口）与方法指纹，不下发策略正文、不下发引擎代码。压缩在用户本机完成。同一订单幂等，重复取件返回原授权，不会重复扣费 |
服务端只接收任务随机标识与版本号，不接收视频、不接收文件路径、不调用模型、不跑 ffmpeg。新任务新订单；同一任务恢复使用原请求文件。
怎么跑（客户端流程）
先把技能根目录存成绝对路径：
SKILL_DIR="/absolute/path/to/video-compressor"- 先做环境体检（缺组件时它会给出补齐命令；硬依赖不齐就先别下单）：
python3 "$SKILL_DIR/scripts/check-env.py"- 开始新任务（生成随机单号，不要复用旧单）：
node "$SKILL_DIR/scripts/request.mjs" --start- 拿到
exit_code: 10+WeixinPay-Required→ 交给宿主的微信支付工具申请授权（有weixinpay_前缀工具时由你调用；没有时宿主自动弹卡）。支付后用同一个request_file继续：
node "$SKILL_DIR/scripts/request.mjs" --request-file "<request_file>" --consume--consume成功后，返回值里的execution_instructions就是压缩策略正文，engine.commands是引擎命令示例。按策略执行：先看计划与风险，必要时先评估再压整片：
python3 "$SKILL_DIR/scripts/compress_video.py" "<原片路径>" "<成片路径>" --dry-run
# 下一行仅 Apple 设备（硬件 VideoToolbox）可用；其它平台直接跳到「压缩」那一步，
# 用 --video-bitrate 或 --target-size-mb 给定参数即可。
python3 "$SKILL_DIR/scripts/assess_hardware_compression.py" "<原片路径>"
python3 "$SKILL_DIR/scripts/compress_video.py" "<原片路径>" "<成片路径>"
--assessment "<原片>.hardware-assessment.json" --recommendation balanced
--evaluate light --verify full- 读一遍 Markdown 报告，确认完整性校验通过、画质结论可接受，再收尾：
node "$SKILL_DIR/scripts/request.mjs" --request-file "<request_file>" --finish --output "<成片路径>"收尾与付费的补充约定
- 凭据每轮只取一份、只用一次。 不要复用历史轮次的凭据，也不要反复打印或重复调用 —— 一轮只触发一次支付。只有退出码
10（code=PAYMENT_REQUIRED）才处理支付，金额以本单账单为准；工具表里有weixinpay_pay时，把返回的WeixinPay-Required字段值原样作为paymentCode传入（不解码、不改写、不附带其他内容）；没有该工具时由支持支付的宿主拦截凭据自动弹卡，不要再手动调用任何支付工具。 - 唯一该主动调支付工具的场景：用户上次取消或关闭了支付，现在明确要求继续付同一笔订单 —— 此时用同一个请求文件加
--resume-payment，不重新下单：
node "$SKILL_DIR/scripts/request.mjs" --request-file "<request_file>" --resume-payment- 任务失败、用户取消或无法产出成品时，执行收尾注销本单：
node "$SKILL_DIR/scripts/request.mjs" --abort --request-file "<request_file>"- 不要对还没开始执行的任务跑
--finish/--abort：那会先把本地记录标记成「待收尾」，而服务端对未执行的订单不会回TASK_FINISHED，本地记录会一直停在待重试状态。只想看任务状态用：
node "$SKILL_DIR/scripts/request.mjs" --status --request-file "<request_file>"环境要求（缺依赖怎么处理）
引擎在用户本机运行，需要 Python 3 与 FFmpeg（含 ffprobe）：
- 缺 FFmpeg / ffprobe：这是硬依赖，缺了无法压缩。体检脚本会明确报出缺什么并给出一条可执行的补齐命令 —— 请照它给的命令补齐后重试。这一步是本技能正常运行必需的环境准备，不是可选优化。
- FFmpeg 不带硬件编码（VideoToolbox）：属能力项。Apple 设备上的硬件路径与短样本码率评估会自动降级为软件编码，报告里会写明，不中断压缩。
- FFmpeg 不带
libvmaf：属能力项。会跳过客观画质指标（VMAF / SSIM / PSNR），报告里明确写「本次未生成客观画质指标」，绝不给出编造的分数，仍照常交付成片与完整性校验结果。
环境完整时的自检方式：先跑一次压缩，若引擎退出码为 0 且三件产物齐全（成片能播放、报告非空），即说明环境齐备。
网络访问与失败降级：客户端只连接上表所列 api.aigctxj.cn 固定域名（http 回环地址仅用于本机联调），其他任何地址一律拒绝；单次请求超时 30 秒，超时或失败时保留原订单重试并如实告知用户，不自动重下单、不静默重试、不降级到其他地址。
来源与声明
本技能的压缩策略与引擎随技能包分发，服务端不接触用户视频。用户原片与产出的成片、报告均不出本机，也不会上传到任何第三方服务。
