技能介绍

解决什么问题

脚本完成后，制作团队仍要面对一连串断裂的决策：分场边界怎么切、每段用什么视觉策略、候选素材从哪里来、选择依据是否可追溯。ScriptMate 处理的正是脚本到制作清单之间的这个结构化空白，而不是直接把剧本变成成片。

核心能力与工作步骤

ScriptMate 会把输入脚本拆成语义分段，为每个分段生成视觉策略，并对素材和图像候选进行排序，附上透明评分、选择理由和来源链接。它产出的是一套可审阅的素材匹配包。

准备阶段需要脚本文本或 UTF-8 文本文件、输出目录、宽高比（9:16、16:9、4:3、3:4、1:1）、目标分辨率（4K、1080 或 720），以及可选的 provider 配置和已授权本地媒体库。运行时要求 Python 3.9 或更新版本和 FFmpeg；launcher 会在用户缓存中创建隔离 runtime，并运行该技能自带的源码包。必要时可用 SCRIPTMATE_CACHE_DIR 或 SCRIPTMATE_PYTHON 覆盖缓存位置或 Python 解释器。

配置 API key 时，应通过环境变量或被忽略的本地 config.toml 传入。需要检查配置时优先使用配置显示命令，它会遮蔽凭据，避免完整密钥进入终端记录或共享文件。

执行流程可分阶段：先只分析脚本而不联网取材；再索引本地媒体库；最后生成完整的素材匹配包。若素材来自本地授权资产，用 --library-root 和 --library-meta 指定库根目录与元数据。联网搜索会在命令真正执行前说明可能消耗 API quota，除明确需要本地媒体文件外，--download 保持禁用。

适用边界与注意点

自动选出的素材只能当作推荐。发布前仍需人工核对相关性、授权、署名和事实是否贴合脚本语境。ScriptMate 不会静默启用 planner、judge、search 或生成素材的 fallback；任何 --allow-*-fallback 选项都必须取得明确同意后才能加入。judge vision 仅在所配模型支持图像且 token 开销可接受时开启。遇到 provider、网络、quota、FFmpeg 或配置失败，技能要求直接报错，而不是声称成功。最终审阅包中仍会保留来源链接和署名要求。