AI 技能AI 评测提示工程人工智能媒体生成【免费下载链接】seedance-2.0Comprehensive production pipeline for quad-modal AI filmmaking with Seedance 2.0项目地址https://gitcode.com/gh_mirrors/se/seedance-2.0点击查看免费下载导读本文面向希望把 Seedance 2.0 提示词工程接入自动化管线的开发者完整讲解仓库中references/json-schema.md定义的 Prompt JSON Schema 与 V6 序列状态 Schema 族从顶层字段的枚举取值、规划元数据与最终自然语言提示的分层原则到schemas/目录下五份机器可校验 Schema 的结构、条件约束与配套验证器实现。读完本文你将能够用同一份 JSON 规划结构承载模式、参考、分镜、连续性锚点、色彩、字幕与交付信息并借助scripts/schema_check.py、scripts/project_state_check.py与scripts/continuity_chain_check.py让序列级数据资产可校验、可追溯。一、Schema 在管线中的定位规划层与生成层分离Seedance 2.0 是一条覆盖文生视频t2v、图生视频i2v、视频生视频v2v、参考生视频r2v、首尾帧转换flf2v、剪辑edit、延长extend、音频驱动audio-led等多模态生成能力的生产管线。JSON Schema 在其中的角色不是提示词模板而是规划层的稳定契约当用户需要结构化输出、或自动化管线需要稳定字段时使用 JSON 包装wrapper记录规划意图最终交给模型的提示词仍然是自然语言——references/json-schema.md明确强调The JSON wrapper is for planning. The final prompt still needs to read naturallyJSON 包装用于规划最终提示词仍需读起来自然。这意味着所有 JSON 结构都属于规划工件planning artifact而不是生成请求本身。真正落到生成环节的只有final_prompt顶层 Schema或natural_language_promptprompt-spec字段承载的自然语言文本。二、顶层 Prompt JSON Schema字段与枚举全解references/json-schema.md给出的顶层规划结构如下完整继承自原文档{ mode: t2v | i2v | v2v | r2v | flf2v | edit | extend | audio-led, duration: string, aspect_ratio: string, references: [ {tag: Image1, role: identity | product | pose | environment | style | first_frame | last_frame | reference_image}, {tag: Video1, role: motion | camera | pacing | blocking | source_clip | reference_video}, {tag: Audio1, role: voice | rhythm | ambience | music | tempo | reference_audio} ], characters: [], production: { phase: brief | preproduction | generation | review | post | localization | delivery, role: director | dp | producer | editor | colorist | sound | localization | qc, delivery_surface: web | broadcast | social | theatrical | client_review | archive, approval_owner: }, shot_list: [ { shot_id: S01_SH01, purpose: establish | reveal | demonstrate | emotional_turn | end_card, shot_contract: shot size, angle, lens feel, camera move, endpoint, start_frame: , end_frame: , risks: [] } ], continuity_anchors: { character: [], product: [], wardrobe: [], props: [], location: , screen_direction: , eyeline: , lighting_state: , audio_state: }, scene: , camera: , motion: , lighting: , style: , audio: , color_pipeline: { look_intent: , working_assumption: , output_transform: SDR Rec.709 | HDR PQ | theatrical | social, show_lut_or_cdl_notes: , qc_notes: [] }, subtitle_plan: { subtitles: false, sdh: false, forced_narrative: false, dubbing: false, textless_required: false, languages: [] }, audio_deliverables: { full_mix: true, stems: [], m_and_e: false, loudness_target: , sync_cues: [] }, delivery: { frame_rate: , resolution: , aspect_ratio: , safe_area: , version_name: , qc_checks: [] }, safety_notes: [], final_prompt: }2.1 mode生成模式枚举mode决定了本次任务的生成入口是唯一同时出现在顶层 Schema 与clip-contract、prompt-spec等序列 Schema 中的核心维度。取值包括取值含义t2v文本生成视频Text-to-Videoi2v图片生成视频Image-to-Videov2v视频生成视频Video-to-Video常用于序列衔接r2v参考内容生成视频Reference-to-Videoflf2v首帧/尾帧转换生成视频First-Last-Frame-to-Videoedit剪辑/编辑模式extend时长延长模式audio-led音频驱动模式在仓库真实实例中examples/sequence-airport-arrival/project-state.json的 clip_01 使用generation_mode: T2V而 clip_02、clip_03 使用generation_mode: V2V并携带source_clip_tag——这与顶层 Schema 中references的role枚举相互印证Video1可承担source_clip | reference_video等角色source_clip正是 v2v 序列衔接的载体。2.2 references多模态参考角色references数组按模态图片/视频/音频分组每个条目用tag定位素材、用role声明用途图片Imageidentity身份、product产品、pose姿态、environment环境、style风格、first_frame首帧、last_frame尾帧、reference_image通用参考图视频Videomotion运动、camera运镜、pacing节奏、blocking走位调度、source_clip源片段、reference_video通用参考视频音频Audiovoice人声、rhythm节奏、ambience环境声、music音乐、tempo速度、reference_audio通用参考音频。2.3 production制片信息块production四个字段把导演/制片语境下沉为结构化元数据phasebrief | preproduction | generation | review | post | localization | delivery标识当前所处制作阶段roledirector | dp | producer | editor | colorist | sound | localization | qc标识当前视角导演、摄影指导、制片、剪辑、调色、声音、本地化、质检delivery_surfaceweb | broadcast | social | theatrical | client_review | archive交付面approval_owner审批责任人用于多人协作流程中对齐签字权。2.4 shot_list分镜契约shot_list数组把镜头语言写成可审计的契约条目shot_id镜头编号如S01_SH01purpose镜头意图枚举establish建立、reveal揭示、demonstrate演示、emotional_turn情绪转折、end_card片尾卡shot_contract自由文本但应按固定语义书写——景别shot size、角度angle、镜头质感lens feel、运镜camera move、落点endpointstart_frame/end_frame首尾帧标记配合flf2v模式使用risks该镜头的风险清单。2.5 continuity_anchors连续性锚点连续性锚点记录跨镜头必须保持不变的要素是序列项目防漂移的核心character角色、product产品、wardrobe服装、props道具、location地点、screen_direction银幕方向如左到右移动、eyeline视线方向、lighting_state光照状态、audio_state音频状态。这个字段与examples/sequence-airport-arrival/project-state.json中每个 clip 的continuity_locks一一对应——机场实例把canonical_identity_id、wardrobe、travel_direction、vehicle_identity、creased paper airline tag、persistent_environment列为锁正是锚点思想的序列化落地。2.6 镜头语言五要素scene场景、camera运镜、motion运动、lighting光照、style风格五个顶层字段承载单镜头的自然语言描述与仓库references/下 cinematography-shot-language.md、directing-engine.md 等导演语言文档互补。2.7 color_pipeline色彩管线look_intent调色意图working_assumption工作假设如拍摄/素材色彩空间假设output_transform输出变换枚举SDR Rec.709 | HDR PQ | theatrical | socialshow_lut_or_cdl_notesLUT/CDL 说明qc_notes调色质检备注。与仓库 color-pipeline-aces.md 描述的色彩交付约束一致。2.8 subtitle_plan字幕与本地化五个布尔开关加一个语言列表subtitles普通字幕、sdh听障字幕、forced_narrative强制叙事字幕、dubbing配音、textless_required是否要求无字版以及languages目标语言数组。对应仓库的 subtitles-localization.md 多语言本地化实践。2.9 audio_deliverables音频交付物full_mix完整混音默认truestems分轨列表m_and_e音乐与效果声ME轨loudness_target响度目标如 -23 LUFS具体以交付面为准sync_cues同步点提示。与 audio-post-delivery.md、sync-budget-protocol.md 构成音频交付体系。2.10 delivery交付规格frame_rate帧率、resolution分辨率、aspect_ratio宽高比、safe_area安全区、version_name版本名、qc_checks质检项。可在生成前声明也可作为后期交付的核对清单。2.11 safety_notes 与 final_promptsafety_notes记录安全与合规备注final_prompt是最终真正提交给模型的自然语言提示词——规划结构到此收敛为一段可读文本与仓库 seedance-prompt、seedance-pipeline 技能所倡导的自然语言提示词实践一致。2.12 使用原则哪些字段进提示词哪些只作交接元数据原文档给出的铁律production、shot-list、continuity、localization、audio、color、delivery 字段应作为交接元数据handoff metadata保存在规划层不要全部塞进提示词。理由很实际提示词越长、语义越拥挤模型对核心动作的执行越不稳定把制片/交付信息留在 JSON 层可以让final_prompt保持聚焦、自然、可读。三、V6 序列状态 Schema 族schemas/ 下的五份机器校验契约references/json-schema.md指出V6 在schemas/目录下增加了机器可校验的状态夹具machine-valid state fixtures。五份 Schema 分工明确全部采用 JSON Schema Draft 2020-12Schema 文件职责project-state.schema.json项目状态故事、场景、节拍、片段血缘、take 历史、正典修订、参考注册表clip-contract.schema.json当前片段的生产任务契约take-review.schema.json已观测起止状态、接受的偏差、完成的节拍、拒绝/修复裁决prompt-spec.schema.json内部提示词编译元数据generation-run.schema.json合成基准与本地运行记录3.1 project-state.schema.json整部序列的总账这是五个 Schema 中结构最重的一份required列表包含 18 个顶层字段schema_version、state_revision、project_id、project_mode、surface、clip_budget_sec、prompt_budget、story、world_bible、reference_registry、scenes、beats、clips、take_history、current_clip_id、canon_revision、updated_at。关键设计点版本与修订state_revision、canon_revision均为minimum: 1的整数schema_version为字符串——仓库实例中为6.6.0project_mode枚举standalone_clip | sequence_project区分单片段与序列项目故事层 storylogline、story_promise、objective、initial_condition、final_outcome、target_duration_sec、tone、medium八个必填字段场景层 scenearc_position枚举open | rising | turn | climax | releasemax_chain_depth约束在0–3status枚举planned | current | completed | omitted | replaced节拍层 beatstatus同场景枚举dependencies声明节拍依赖take_history_itemverdict枚举accept | accept_with_deviation | repair | rejectevidence上限 4096 字符数组上限 4096 条血缘约束allOf当sequence_index 1时parent_clip_id必须为null否则必须提供非空parent_clip_id当status为accepted/accepted_with_deviation时observed_end_state必须为非空对象minProperties: 1当status为rejected时observed_end_state必须为null。3.1.1 authoring_state导演读解的规范化project-state 与 clip-contract 共享authoring_state定义用oneOf在两类导演读解Directors Read之间二选一narrative_authoring_state叙事读解必填dramatic_function戏剧功能、turn转折、pov视角、power_shift权力转移、hidden_want_objective隐藏欲望目标、obstacle_tactic障碍策略、subtext_contradiction潜台词矛盾、visible_suppressed_behavior可见的压抑行为、non_transferable_detail不可转移细节、non_transferable_detail_provenancesource_bound | authored_choice、non_transferable_detail_source、stock_solution_refused拒绝的套路化方案、value_before、value_after、prompt_carriers提示词载体至少 1 条、去重non_narrative_authoring_state非叙事读解仅utility_intent实用意图与non_narrative_refusal非叙事拒绝两行。其中visible_one_line_text定义值得注意它是一条必须含可见字符、不得含换行的单行文本约束通过一个巨大的 Unicode 正则把纯标点、纯空白、控制字符排除在外。non_transferable_detail_provenance与non_transferable_detail_source还有联动约束source_bound时source必须匹配标识符 [行号]、[引用]、URL 或file:/ref:/evidence:前缀authored_choice时source必须为null。3.1.2 血缘可追溯authoring_state_sha256contract_authoring_state_snapshotsproject-state与authoring_state_provenanceclip-contract用{project_id, clip_id, canon_revision, state_revision, authoring_state_sha256}五元组做指纹sha256正则约束为^[0-9a-f]{64}$additionalProperties: false。这意味着契约与其 authoring_state 的快照可以被哈希审计——机场实例中 clip_01 的快照哈希d71f3ea0...与examples/sequence-airport-arrival/clip-01-contract.json内嵌的authoring_state_provenance完全一致正是这条链路的真实佐证。3.2 clip-contract.schema.json单个片段的生成任务契约对比 project-state 的 clip 定义clip-contract 是单片段视角的精简版必填 17 个字段并新增shot_structure枚举compact_single_take | phased_single_take | dense_multishot | first_last_frame_transition | video_edit_contract——对应仓库 examples/golden-prompts 中的五类金句提示词模式。其allOf条件约束与 project-state 中 clip 的约束逻辑一致首片段父节点为空、接受态必须有观测尾态、拒绝态尾态为 null。3.3 take-review.schema.json观测与裁决记录这是回放核查的数据契约必填 17 个字段additionalProperties: false不允许多余字段混入source_status枚举generated | reviewed | accepted | accepted_with_deviation | repair | rejectedverdict枚举accept | accept_with_deviation | repair | rejectcompleted_beats/incomplete_beats/unexpected_completed_beats三组节拍清单区分完成、未完成、意外完成observation_confidence枚举low | medium | highuncertainties与requires_user_confirmation表达观测的不确定性与是否需人工确认条件约束verdict reject时accepted_deviations必须为空数组maxItems: 0——拒绝态不容忍已接受偏差。仓库真实记录examples/sequence-airport-arrival/clip-01-take-review.json展示了完整用法clip_01 实测停在门前两步completed_beats为[beat_terminal_exit]incomplete_beats为[beat_reach_car]continuity_breaks记planned endpoint not reachedaccepted_deviations记final frame is two steps before the door最终裁决accept_with_deviation——这与 project-state 中 clip_01 的status: accepted_with_deviation、accepted_deviations、open_motion_vectors完全闭环。3.4 prompt-spec.schema.json编译元数据记录内部提示词编译的输入输出必填 10 个字段关键枚举sequence_relationstandalone | sequence_first_clip | seamless_continuation | intentional_next_shot | bridge_between_known_states | repair_tail | reanchor_after_drift——这七个取值精确描述了片段在序列中的关系其中seamless_continuation无缝续接、repair_tail修复尾部、reanchor_after_drift漂移后重新锚定直接对应序列漂移治理场景opening_state_sourceplanned_start_state | observed_end_state | user_supplied_final_frame | source_clip——声明开场状态来源completed_beat_exclusions/reserved_future_exclusions从已完成节拍与保留节拍中提取的禁写区防止提示词重放旧内容或提前泄漏未来内容natural_language_prompt最终自然语言提示词minLength: 1。仓库夹具 validation/fixtures/prompt-spec.valid.json 展示了seamless_continuation的完整写法opening_state_source: observed_end_statecompleted_beat_exclusions排除下电梯、查航班牌reserved_future_exclusions排除走出航站楼、上车自然语言提示词明确要求不重放旧节拍、不离开航站楼。3.5 generation-run.schema.json运行记录用于合成基准synthetic benchmark与本地运行审计必填 11 个字段run_id、project_id、clip_id、surface、prompt_version、input_mode、reference_tags、prompt、result_status、is_synthetic_fixture等。result_status枚举not_run_fixture | submitted | generated | reviewed | accepted | rejected其中not_run_fixture专门标记合成夹具——仓库以 validation/fixtures/generation-run.valid.json 作为该 Schema 的合法实例。四、Schema 的机器执行schema_check.py 与 schema-instances.json光有 Schema 定义还不够——仓库用 scripts/schema_check.py 让 Schema真正以 Schema 的身份执行而不是靠 Python 里重复声明字段清单强制覆盖读取 validation/schema-instances.jsonschemas/下每个.schema.json必须在instances中声明至少一个合法实例否则报错——新增 Schema 而不带证明其可接受的实例是不可能的引用审计reference_audit遍历$ref/$dynamicRef只跟踪 Draft 2020-12 的 schema 值关键字allOf、anyOf、oneOf、properties、$defs等把字面数据const、enum、examples里的内容与活跃引用区分开外部$ref一律禁止refuse_schema_retrieval直接抛错fail-closed严格数字类型通过type_checker重定义integer/number拒绝把浮点数当整数、拒绝把1e2之类伪装成普通数字的写法复用 scripts/strict_json.py 的is_json_number/json_integer实例校验对清单中每个实例用Draft202012ValidatorFormatChecker执行iter_errors按 JSON Pointer 输出精确诊断路径退出码成功打印Schema check passed: every schema executed against its declared instances.缺少依赖时jsonschema未安装提示按 requirements-validation.lock 安装并返回 2。配套测试 tests/test_schema_check.py 覆盖了清单缺失、外部引用禁用、实例不合法等失败路径保证校验器本身的行为契约稳定。五、真实实例机场到达序列的 Schema 闭环examples/sequence-airport-arrival/project-state.json 是五份 Schema 的合演现场三枚片段构成一条完整血缘链clip_01T2Vphased_single_takestatus: accepted_with_deviation观测尾态为距车门两步open_motion_vectors记录旅行者继续左到右走两步、摄影机继续横向跟拍handoff_requirements规定clip_02 从距车门两步处开始、不得重放航站楼出口、不得从车内开始——这些字段正是为下一条生成请求提供接续输入clip_02V2Vseamless_continuationparent_clip_id: clip_01source_clip_tag: [Video 1]already_happened含beat_terminal_exitthis_clip_only含beat_reach_car、beat_enter_carextension_depth: 1clip_03V2Vprovisional_next_shotparent_clip_id: clip_02handoff_requirements明确clip_02 被接受前不得定稿extension_depth: 2。同一目录下 clip-01-contract.json 与 clip-01-take-review.json 分别承载契约与裁决三份文件以clip_id、take_id、authoring_state_sha256互相咬合——这就是references/json-schema.md所说machine-valid state fixtures的完整含义。其余合法实例还包括 examples/sequence-observed-deviation漂移前后状态、examples/sequence-mixed-lane、examples/standalone-clip。六、边界与最佳实践Schema 能做什么、不能做什么6.1 JSON Schema 的图级盲区project-state 与 clip-contract 的$comment都直言了 JSON Schema 的结构性局限无法表达片段 ID 唯一性、父节点存在性、自引用拒绝、父先于子排序、环路自由、父状态/端点可用性等跨记录图级语义。因此两份 Schema 都要求配合语义验证器使用scripts/project_state_check.py校验项目状态记录的图级语义scripts/continuity_chain_check.py校验连续性链条。对应测试见 tests/test_project_state.py、tests/test_continuity_chain.py。实践原则是Schema 负责单记录结构合法性语义脚本负责多记录图级一致性两者缺一不可。6.2 规划层与生成层的纪律顶层 JSON 与五份序列 Schema 都只是规划工件除非用户明确要求结构化输出最终提示词保持自然语言production、shot_list、continuity、localization、audio、color、delivery作为交接元数据留在 JSON 层不进提示词新增 Schema 必须先补合法实例并登记进validation/schema-instances.json否则scripts/schema_check.py直接失败——这条约束保证Schema 与示例永不漂移。结语从references/json-schema.md的顶层 Prompt JSON Schema到schemas/下的五份序列状态契约再到scripts/schema_check.py的机器执行与机场序列的真实闭环Seedance 2.0 把提示词工程升级成了可规划、可校验、可追溯的提示词数据工程。实践中记住三条主线即可顶层 Schema 管单次生成的规划意图序列 Schema 族管跨片段的状态与血缘schema_check 语义脚本管结构合法性与图级一致性——自然语言提示词负责表达JSON 层负责纪律。进一步阅读序列状态的完整字段语义见 sequence-project-state.md血缘契约设计见 lineage_contract.py金句提示词模式见 examples/golden-prompts。赞分享AI 技能AI 评测提示工程人工智能媒体生成【免费下载链接】seedance-2.0Comprehensive production pipeline for quad-modal AI filmmaking with Seedance 2.0项目地址https://gitcode.com/gh_mirrors/se/seedance-2.0点击查看免费下载相关推荐为什么选择 Pydantic 做数据校验—— 类型提示驱动的校验、序列化与 JSON Schema 全解读为什么选择 Pydantic 做数据校验—— 类型提示驱动的校验、序列化与 JSON Schema 全解读 本文基于 Pydantic 官方文档 Why u后端序列化Fastify 校验与序列化完全指南基于 JSON Schema 的输入校验与输出序列化机制Fastify 校验与序列化完全指南基于 JSON Schema 的输入校验与输出序列化机制 Fastify 采用基于 Schemaschema base后端Web框架TanStack Router Search Params 完全指南JSON 优先的状态校验、序列化与中间件实战TanStack Router Search Params 完全指南JSON 优先的状态校验、序列化与中间件实战 导读 本指南基于当前仓库 router co前端路由SSR上一篇PalEdit幻兽编辑器完整指南打造你的专属幻兽世界下一篇OpenWebRX Docker部署教程5分钟搭建跨平台SDR服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Seedance 2.0 Prompt JSON Schema 全解：结构化提示规划与序列状态校验实战
AI 技能AI 评测提示工程人工智能媒体生成【免费下载链接】seedance-2.0Comprehensive production pipeline for quad-modal AI filmmaking with Seedance 2.0项目地址https://gitcode.com/gh_mirrors/se/seedance-2.0点击查看免费下载导读本文面向希望把 Seedance 2.0 提示词工程接入自动化管线的开发者完整讲解仓库中references/json-schema.md定义的 Prompt JSON Schema 与 V6 序列状态 Schema 族从顶层字段的枚举取值、规划元数据与最终自然语言提示的分层原则到schemas/目录下五份机器可校验 Schema 的结构、条件约束与配套验证器实现。读完本文你将能够用同一份 JSON 规划结构承载模式、参考、分镜、连续性锚点、色彩、字幕与交付信息并借助scripts/schema_check.py、scripts/project_state_check.py与scripts/continuity_chain_check.py让序列级数据资产可校验、可追溯。一、Schema 在管线中的定位规划层与生成层分离Seedance 2.0 是一条覆盖文生视频t2v、图生视频i2v、视频生视频v2v、参考生视频r2v、首尾帧转换flf2v、剪辑edit、延长extend、音频驱动audio-led等多模态生成能力的生产管线。JSON Schema 在其中的角色不是提示词模板而是规划层的稳定契约当用户需要结构化输出、或自动化管线需要稳定字段时使用 JSON 包装wrapper记录规划意图最终交给模型的提示词仍然是自然语言——references/json-schema.md明确强调The JSON wrapper is for planning. The final prompt still needs to read naturallyJSON 包装用于规划最终提示词仍需读起来自然。这意味着所有 JSON 结构都属于规划工件planning artifact而不是生成请求本身。真正落到生成环节的只有final_prompt顶层 Schema或natural_language_promptprompt-spec字段承载的自然语言文本。二、顶层 Prompt JSON Schema字段与枚举全解references/json-schema.md给出的顶层规划结构如下完整继承自原文档{ mode: t2v | i2v | v2v | r2v | flf2v | edit | extend | audio-led, duration: string, aspect_ratio: string, references: [ {tag: Image1, role: identity | product | pose | environment | style | first_frame | last_frame | reference_image}, {tag: Video1, role: motion | camera | pacing | blocking | source_clip | reference_video}, {tag: Audio1, role: voice | rhythm | ambience | music | tempo | reference_audio} ], characters: [], production: { phase: brief | preproduction | generation | review | post | localization | delivery, role: director | dp | producer | editor | colorist | sound | localization | qc, delivery_surface: web | broadcast | social | theatrical | client_review | archive, approval_owner: }, shot_list: [ { shot_id: S01_SH01, purpose: establish | reveal | demonstrate | emotional_turn | end_card, shot_contract: shot size, angle, lens feel, camera move, endpoint, start_frame: , end_frame: , risks: [] } ], continuity_anchors: { character: [], product: [], wardrobe: [], props: [], location: , screen_direction: , eyeline: , lighting_state: , audio_state: }, scene: , camera: , motion: , lighting: , style: , audio: , color_pipeline: { look_intent: , working_assumption: , output_transform: SDR Rec.709 | HDR PQ | theatrical | social, show_lut_or_cdl_notes: , qc_notes: [] }, subtitle_plan: { subtitles: false, sdh: false, forced_narrative: false, dubbing: false, textless_required: false, languages: [] }, audio_deliverables: { full_mix: true, stems: [], m_and_e: false, loudness_target: , sync_cues: [] }, delivery: { frame_rate: , resolution: , aspect_ratio: , safe_area: , version_name: , qc_checks: [] }, safety_notes: [], final_prompt: }2.1 mode生成模式枚举mode决定了本次任务的生成入口是唯一同时出现在顶层 Schema 与clip-contract、prompt-spec等序列 Schema 中的核心维度。取值包括取值含义t2v文本生成视频Text-to-Videoi2v图片生成视频Image-to-Videov2v视频生成视频Video-to-Video常用于序列衔接r2v参考内容生成视频Reference-to-Videoflf2v首帧/尾帧转换生成视频First-Last-Frame-to-Videoedit剪辑/编辑模式extend时长延长模式audio-led音频驱动模式在仓库真实实例中examples/sequence-airport-arrival/project-state.json的 clip_01 使用generation_mode: T2V而 clip_02、clip_03 使用generation_mode: V2V并携带source_clip_tag——这与顶层 Schema 中references的role枚举相互印证Video1可承担source_clip | reference_video等角色source_clip正是 v2v 序列衔接的载体。2.2 references多模态参考角色references数组按模态图片/视频/音频分组每个条目用tag定位素材、用role声明用途图片Imageidentity身份、product产品、pose姿态、environment环境、style风格、first_frame首帧、last_frame尾帧、reference_image通用参考图视频Videomotion运动、camera运镜、pacing节奏、blocking走位调度、source_clip源片段、reference_video通用参考视频音频Audiovoice人声、rhythm节奏、ambience环境声、music音乐、tempo速度、reference_audio通用参考音频。2.3 production制片信息块production四个字段把导演/制片语境下沉为结构化元数据phasebrief | preproduction | generation | review | post | localization | delivery标识当前所处制作阶段roledirector | dp | producer | editor | colorist | sound | localization | qc标识当前视角导演、摄影指导、制片、剪辑、调色、声音、本地化、质检delivery_surfaceweb | broadcast | social | theatrical | client_review | archive交付面approval_owner审批责任人用于多人协作流程中对齐签字权。2.4 shot_list分镜契约shot_list数组把镜头语言写成可审计的契约条目shot_id镜头编号如S01_SH01purpose镜头意图枚举establish建立、reveal揭示、demonstrate演示、emotional_turn情绪转折、end_card片尾卡shot_contract自由文本但应按固定语义书写——景别shot size、角度angle、镜头质感lens feel、运镜camera move、落点endpointstart_frame/end_frame首尾帧标记配合flf2v模式使用risks该镜头的风险清单。2.5 continuity_anchors连续性锚点连续性锚点记录跨镜头必须保持不变的要素是序列项目防漂移的核心character角色、product产品、wardrobe服装、props道具、location地点、screen_direction银幕方向如左到右移动、eyeline视线方向、lighting_state光照状态、audio_state音频状态。这个字段与examples/sequence-airport-arrival/project-state.json中每个 clip 的continuity_locks一一对应——机场实例把canonical_identity_id、wardrobe、travel_direction、vehicle_identity、creased paper airline tag、persistent_environment列为锁正是锚点思想的序列化落地。2.6 镜头语言五要素scene场景、camera运镜、motion运动、lighting光照、style风格五个顶层字段承载单镜头的自然语言描述与仓库references/下 cinematography-shot-language.md、directing-engine.md 等导演语言文档互补。2.7 color_pipeline色彩管线look_intent调色意图working_assumption工作假设如拍摄/素材色彩空间假设output_transform输出变换枚举SDR Rec.709 | HDR PQ | theatrical | socialshow_lut_or_cdl_notesLUT/CDL 说明qc_notes调色质检备注。与仓库 color-pipeline-aces.md 描述的色彩交付约束一致。2.8 subtitle_plan字幕与本地化五个布尔开关加一个语言列表subtitles普通字幕、sdh听障字幕、forced_narrative强制叙事字幕、dubbing配音、textless_required是否要求无字版以及languages目标语言数组。对应仓库的 subtitles-localization.md 多语言本地化实践。2.9 audio_deliverables音频交付物full_mix完整混音默认truestems分轨列表m_and_e音乐与效果声ME轨loudness_target响度目标如 -23 LUFS具体以交付面为准sync_cues同步点提示。与 audio-post-delivery.md、sync-budget-protocol.md 构成音频交付体系。2.10 delivery交付规格frame_rate帧率、resolution分辨率、aspect_ratio宽高比、safe_area安全区、version_name版本名、qc_checks质检项。可在生成前声明也可作为后期交付的核对清单。2.11 safety_notes 与 final_promptsafety_notes记录安全与合规备注final_prompt是最终真正提交给模型的自然语言提示词——规划结构到此收敛为一段可读文本与仓库 seedance-prompt、seedance-pipeline 技能所倡导的自然语言提示词实践一致。2.12 使用原则哪些字段进提示词哪些只作交接元数据原文档给出的铁律production、shot-list、continuity、localization、audio、color、delivery 字段应作为交接元数据handoff metadata保存在规划层不要全部塞进提示词。理由很实际提示词越长、语义越拥挤模型对核心动作的执行越不稳定把制片/交付信息留在 JSON 层可以让final_prompt保持聚焦、自然、可读。三、V6 序列状态 Schema 族schemas/ 下的五份机器校验契约references/json-schema.md指出V6 在schemas/目录下增加了机器可校验的状态夹具machine-valid state fixtures。五份 Schema 分工明确全部采用 JSON Schema Draft 2020-12Schema 文件职责project-state.schema.json项目状态故事、场景、节拍、片段血缘、take 历史、正典修订、参考注册表clip-contract.schema.json当前片段的生产任务契约take-review.schema.json已观测起止状态、接受的偏差、完成的节拍、拒绝/修复裁决prompt-spec.schema.json内部提示词编译元数据generation-run.schema.json合成基准与本地运行记录3.1 project-state.schema.json整部序列的总账这是五个 Schema 中结构最重的一份required列表包含 18 个顶层字段schema_version、state_revision、project_id、project_mode、surface、clip_budget_sec、prompt_budget、story、world_bible、reference_registry、scenes、beats、clips、take_history、current_clip_id、canon_revision、updated_at。关键设计点版本与修订state_revision、canon_revision均为minimum: 1的整数schema_version为字符串——仓库实例中为6.6.0project_mode枚举standalone_clip | sequence_project区分单片段与序列项目故事层 storylogline、story_promise、objective、initial_condition、final_outcome、target_duration_sec、tone、medium八个必填字段场景层 scenearc_position枚举open | rising | turn | climax | releasemax_chain_depth约束在0–3status枚举planned | current | completed | omitted | replaced节拍层 beatstatus同场景枚举dependencies声明节拍依赖take_history_itemverdict枚举accept | accept_with_deviation | repair | rejectevidence上限 4096 字符数组上限 4096 条血缘约束allOf当sequence_index 1时parent_clip_id必须为null否则必须提供非空parent_clip_id当status为accepted/accepted_with_deviation时observed_end_state必须为非空对象minProperties: 1当status为rejected时observed_end_state必须为null。3.1.1 authoring_state导演读解的规范化project-state 与 clip-contract 共享authoring_state定义用oneOf在两类导演读解Directors Read之间二选一narrative_authoring_state叙事读解必填dramatic_function戏剧功能、turn转折、pov视角、power_shift权力转移、hidden_want_objective隐藏欲望目标、obstacle_tactic障碍策略、subtext_contradiction潜台词矛盾、visible_suppressed_behavior可见的压抑行为、non_transferable_detail不可转移细节、non_transferable_detail_provenancesource_bound | authored_choice、non_transferable_detail_source、stock_solution_refused拒绝的套路化方案、value_before、value_after、prompt_carriers提示词载体至少 1 条、去重non_narrative_authoring_state非叙事读解仅utility_intent实用意图与non_narrative_refusal非叙事拒绝两行。其中visible_one_line_text定义值得注意它是一条必须含可见字符、不得含换行的单行文本约束通过一个巨大的 Unicode 正则把纯标点、纯空白、控制字符排除在外。non_transferable_detail_provenance与non_transferable_detail_source还有联动约束source_bound时source必须匹配标识符 [行号]、[引用]、URL 或file:/ref:/evidence:前缀authored_choice时source必须为null。3.1.2 血缘可追溯authoring_state_sha256contract_authoring_state_snapshotsproject-state与authoring_state_provenanceclip-contract用{project_id, clip_id, canon_revision, state_revision, authoring_state_sha256}五元组做指纹sha256正则约束为^[0-9a-f]{64}$additionalProperties: false。这意味着契约与其 authoring_state 的快照可以被哈希审计——机场实例中 clip_01 的快照哈希d71f3ea0...与examples/sequence-airport-arrival/clip-01-contract.json内嵌的authoring_state_provenance完全一致正是这条链路的真实佐证。3.2 clip-contract.schema.json单个片段的生成任务契约对比 project-state 的 clip 定义clip-contract 是单片段视角的精简版必填 17 个字段并新增shot_structure枚举compact_single_take | phased_single_take | dense_multishot | first_last_frame_transition | video_edit_contract——对应仓库 examples/golden-prompts 中的五类金句提示词模式。其allOf条件约束与 project-state 中 clip 的约束逻辑一致首片段父节点为空、接受态必须有观测尾态、拒绝态尾态为 null。3.3 take-review.schema.json观测与裁决记录这是回放核查的数据契约必填 17 个字段additionalProperties: false不允许多余字段混入source_status枚举generated | reviewed | accepted | accepted_with_deviation | repair | rejectedverdict枚举accept | accept_with_deviation | repair | rejectcompleted_beats/incomplete_beats/unexpected_completed_beats三组节拍清单区分完成、未完成、意外完成observation_confidence枚举low | medium | highuncertainties与requires_user_confirmation表达观测的不确定性与是否需人工确认条件约束verdict reject时accepted_deviations必须为空数组maxItems: 0——拒绝态不容忍已接受偏差。仓库真实记录examples/sequence-airport-arrival/clip-01-take-review.json展示了完整用法clip_01 实测停在门前两步completed_beats为[beat_terminal_exit]incomplete_beats为[beat_reach_car]continuity_breaks记planned endpoint not reachedaccepted_deviations记final frame is two steps before the door最终裁决accept_with_deviation——这与 project-state 中 clip_01 的status: accepted_with_deviation、accepted_deviations、open_motion_vectors完全闭环。3.4 prompt-spec.schema.json编译元数据记录内部提示词编译的输入输出必填 10 个字段关键枚举sequence_relationstandalone | sequence_first_clip | seamless_continuation | intentional_next_shot | bridge_between_known_states | repair_tail | reanchor_after_drift——这七个取值精确描述了片段在序列中的关系其中seamless_continuation无缝续接、repair_tail修复尾部、reanchor_after_drift漂移后重新锚定直接对应序列漂移治理场景opening_state_sourceplanned_start_state | observed_end_state | user_supplied_final_frame | source_clip——声明开场状态来源completed_beat_exclusions/reserved_future_exclusions从已完成节拍与保留节拍中提取的禁写区防止提示词重放旧内容或提前泄漏未来内容natural_language_prompt最终自然语言提示词minLength: 1。仓库夹具 validation/fixtures/prompt-spec.valid.json 展示了seamless_continuation的完整写法opening_state_source: observed_end_statecompleted_beat_exclusions排除下电梯、查航班牌reserved_future_exclusions排除走出航站楼、上车自然语言提示词明确要求不重放旧节拍、不离开航站楼。3.5 generation-run.schema.json运行记录用于合成基准synthetic benchmark与本地运行审计必填 11 个字段run_id、project_id、clip_id、surface、prompt_version、input_mode、reference_tags、prompt、result_status、is_synthetic_fixture等。result_status枚举not_run_fixture | submitted | generated | reviewed | accepted | rejected其中not_run_fixture专门标记合成夹具——仓库以 validation/fixtures/generation-run.valid.json 作为该 Schema 的合法实例。四、Schema 的机器执行schema_check.py 与 schema-instances.json光有 Schema 定义还不够——仓库用 scripts/schema_check.py 让 Schema真正以 Schema 的身份执行而不是靠 Python 里重复声明字段清单强制覆盖读取 validation/schema-instances.jsonschemas/下每个.schema.json必须在instances中声明至少一个合法实例否则报错——新增 Schema 而不带证明其可接受的实例是不可能的引用审计reference_audit遍历$ref/$dynamicRef只跟踪 Draft 2020-12 的 schema 值关键字allOf、anyOf、oneOf、properties、$defs等把字面数据const、enum、examples里的内容与活跃引用区分开外部$ref一律禁止refuse_schema_retrieval直接抛错fail-closed严格数字类型通过type_checker重定义integer/number拒绝把浮点数当整数、拒绝把1e2之类伪装成普通数字的写法复用 scripts/strict_json.py 的is_json_number/json_integer实例校验对清单中每个实例用Draft202012ValidatorFormatChecker执行iter_errors按 JSON Pointer 输出精确诊断路径退出码成功打印Schema check passed: every schema executed against its declared instances.缺少依赖时jsonschema未安装提示按 requirements-validation.lock 安装并返回 2。配套测试 tests/test_schema_check.py 覆盖了清单缺失、外部引用禁用、实例不合法等失败路径保证校验器本身的行为契约稳定。五、真实实例机场到达序列的 Schema 闭环examples/sequence-airport-arrival/project-state.json 是五份 Schema 的合演现场三枚片段构成一条完整血缘链clip_01T2Vphased_single_takestatus: accepted_with_deviation观测尾态为距车门两步open_motion_vectors记录旅行者继续左到右走两步、摄影机继续横向跟拍handoff_requirements规定clip_02 从距车门两步处开始、不得重放航站楼出口、不得从车内开始——这些字段正是为下一条生成请求提供接续输入clip_02V2Vseamless_continuationparent_clip_id: clip_01source_clip_tag: [Video 1]already_happened含beat_terminal_exitthis_clip_only含beat_reach_car、beat_enter_carextension_depth: 1clip_03V2Vprovisional_next_shotparent_clip_id: clip_02handoff_requirements明确clip_02 被接受前不得定稿extension_depth: 2。同一目录下 clip-01-contract.json 与 clip-01-take-review.json 分别承载契约与裁决三份文件以clip_id、take_id、authoring_state_sha256互相咬合——这就是references/json-schema.md所说machine-valid state fixtures的完整含义。其余合法实例还包括 examples/sequence-observed-deviation漂移前后状态、examples/sequence-mixed-lane、examples/standalone-clip。六、边界与最佳实践Schema 能做什么、不能做什么6.1 JSON Schema 的图级盲区project-state 与 clip-contract 的$comment都直言了 JSON Schema 的结构性局限无法表达片段 ID 唯一性、父节点存在性、自引用拒绝、父先于子排序、环路自由、父状态/端点可用性等跨记录图级语义。因此两份 Schema 都要求配合语义验证器使用scripts/project_state_check.py校验项目状态记录的图级语义scripts/continuity_chain_check.py校验连续性链条。对应测试见 tests/test_project_state.py、tests/test_continuity_chain.py。实践原则是Schema 负责单记录结构合法性语义脚本负责多记录图级一致性两者缺一不可。6.2 规划层与生成层的纪律顶层 JSON 与五份序列 Schema 都只是规划工件除非用户明确要求结构化输出最终提示词保持自然语言production、shot_list、continuity、localization、audio、color、delivery作为交接元数据留在 JSON 层不进提示词新增 Schema 必须先补合法实例并登记进validation/schema-instances.json否则scripts/schema_check.py直接失败——这条约束保证Schema 与示例永不漂移。结语从references/json-schema.md的顶层 Prompt JSON Schema到schemas/下的五份序列状态契约再到scripts/schema_check.py的机器执行与机场序列的真实闭环Seedance 2.0 把提示词工程升级成了可规划、可校验、可追溯的提示词数据工程。实践中记住三条主线即可顶层 Schema 管单次生成的规划意图序列 Schema 族管跨片段的状态与血缘schema_check 语义脚本管结构合法性与图级一致性——自然语言提示词负责表达JSON 层负责纪律。进一步阅读序列状态的完整字段语义见 sequence-project-state.md血缘契约设计见 lineage_contract.py金句提示词模式见 examples/golden-prompts。赞分享AI 技能AI 评测提示工程人工智能媒体生成【免费下载链接】seedance-2.0Comprehensive production pipeline for quad-modal AI filmmaking with Seedance 2.0项目地址https://gitcode.com/gh_mirrors/se/seedance-2.0点击查看免费下载相关推荐为什么选择 Pydantic 做数据校验—— 类型提示驱动的校验、序列化与 JSON Schema 全解读为什么选择 Pydantic 做数据校验—— 类型提示驱动的校验、序列化与 JSON Schema 全解读 本文基于 Pydantic 官方文档 Why u后端序列化Fastify 校验与序列化完全指南基于 JSON Schema 的输入校验与输出序列化机制Fastify 校验与序列化完全指南基于 JSON Schema 的输入校验与输出序列化机制 Fastify 采用基于 Schemaschema base后端Web框架TanStack Router Search Params 完全指南JSON 优先的状态校验、序列化与中间件实战TanStack Router Search Params 完全指南JSON 优先的状态校验、序列化与中间件实战 导读 本指南基于当前仓库 router co前端路由SSR上一篇PalEdit幻兽编辑器完整指南打造你的专属幻兽世界下一篇OpenWebRX Docker部署教程5分钟搭建跨平台SDR服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
学习指南)
