MiniMax H3 全参考结构检查

适用场景

在 MiniMax H3 全参考模式或 Ref2VA 工作流前，检查重写稿是否具备主体定义、任务摘要、保留分析、详细描述、环境声和非画面音乐六个区块，并确认引用标签有声明、有使用。脚本只处理脱敏文本，不上传媒体、不调用模型。

前置条件

• - Python 3.9 或更高版本
• 一份不含图片、视频、音频、原始路径、密钥和个人信息的结构化重写稿
• 用户已确认每个引用资产的用途与权利，并知道目标平台使用的参考模式

输入与输出

输入包含 workflow_mode、references 和 sections。输出目录生成 context_ir_validation.json 与 context_ir_validation.md，状态为 ready_for_review 或 blocked。

安装或导入

保持目录结构，直接运行 scripts/validate_context_ir.py。不需要第三方包。

执行步骤

CODEBLOCK0

脚本要求模式为 ref2va 或 full_reference，区块顺序固定为 subject_definitions、summary、retention_analysis、detailed_description、overall_soundscape、non_diegetic_music。它不判断内容是否真实匹配媒体。

错误恢复

补齐缺失区块，保持区块顺序，并让每个 reference_label 在文本中至少出现一次。若图片或声音内容无法由当前模型实例读取，改用用户提供的脱敏文字描述，不要凭空补写媒体细节。

权限、隐私与不可逆边界

只读取脱敏结构化文本，不读取媒体、不上传、不调用 MiniMax、不创建任务、不扣费。引用角色和保留关系的正确性需要用户人工核对，检查通过不代表模型会准确执行。

验收方法

运行示例输入，确认输出为 ready_for_review。删除一个区块或删除某个引用标签在正文中的使用，确认脚本以非零退出码阻断。