Meta 目录视频残留审计

适用场景

当 Meta Commerce Manager 或商品目录中存在历史视频、动态广告出现不相关素材，或 Shopify/Feed 同步后难以确认视频来自哪个商品时，使用本技能生成一份目录级清理队列。

前置条件

• - Python 3.9 或更高版本。
• 从有权限的 Meta 目录或内部资产表导出的脱敏 CSV。
• 当前商品 ID、商品链接、视频 ID、视频来源、最后确认时间和权利负责人等字段。

输入与输出

输入至少包含 catalog_id、product_id、product_url、video_id、video_source、last_verified_at、active、rights_owner。可选 expected_product_id、expected_product_url、campaign_scope 和 notes。输出 JSON/Markdown，列出残留阈值、跨商品复用、商品链接错配、已下架商品仍挂视频、权利负责人缺失和建议的人工清理动作。

安装与运行

无需第三方依赖。将本目录导入支持本地 Python 技能的 Agent 环境，或直接运行：

CODEBLOCK0

脚本只读取脱敏 CSV，不登录 Meta、不读取 Token、不调用 Graph API、不删除或解绑商品媒体。

处理规则

1. 1. 使用 as-of 与 stale-days 计算最后确认时间是否过期；不会用本机当前时间替代用户给定日期。
2. 检查同一 video_id 是否挂到多个商品，商品链接和预期商品 ID 是否一致，已下架商品是否仍保留视频，以及视频来源和权利负责人是否缺失。
3. 每条记录输出 KEEP_FOR_REVIEW 或 CLEANUP_REVIEW_REQUIRED，并提供不会直接执行的人工动作建议。
4. 生成稳定的 audit_hash，方便清理前后比对；delete_executed 和 unlink_executed 永远为 false。

错误恢复

• - CSV 缺少必需列时退出并指出缺失列。
• 日期不符合 ISO YYYY-MM-DD 时标记为人工复核，不猜测日期。
• 空视频 ID、空商品 ID 或无效布尔字段会进入清理复核。
• 不支持直接解析后台页面时，请导出脱敏 CSV 后重新运行，不能绕过登录或验证码。

权限、隐私与不可逆边界

只处理用户主动提供的目录导出和资产登记元数据。不得放入账号、Cookie、Token、买家数据或订单资料。脚本不执行删除、解绑、上传、投放修改或广告发布；任何 Meta 清理动作必须由有权限的广告/目录管理员人工确认并保留平台审计记录。

验收

使用示例运行后，应得到 catalog-video-report.json 和 catalog-video-report.md。JSON 必须包含 summary、items、findings、audit_hash、delete_executed=false 和 unlink_executed=false；示例应识别过期视频、跨商品复用、URL/商品 ID 错配、下架商品挂载和权利负责人缺失。