seedance-2.0 渐进式披露架构解析:根路由器、子技能与按需引用加载机制
发布时间:2026/9/29 9:33:01 锦皓数字建站

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点击查看免费下载这篇技术指南以 references/progressive-disclosure.md 为骨架讲解 seedance-2.0 这个面向 Agent 的 Seedance 2.0 视频创作技能包是如何用根技能路由、子技能决策、引用按需加载的分层结构把上下文窗口控制在最小、把权重只加载到任务真正需要的时刻。读完本文你将掌握该仓库的文件分层模型、重引用与轻引用的区分规则、类型内容所有权划分、平台事实的新鲜度约束以及 scripts/validate_skills.py 是如何用静态校验把这套披露方案固化为 CI 契约的。为什么需要渐进式披露渐进式披露Progressive Disclosure来自 Agent Skills 的通用约定Agent 首先看到技能的名称、描述与路径只有当技能与当前任务匹配时才加载完整的SKILL.md正文。references/agent-compatibility.md 明确记录了这一点并说明本仓库严格遵循该模式根技能元数据与路由放在SKILL.md任务级子技能放在skills/*/SKILL.md密集参考材料放在references/*.md。问题在于一个面向四模态 AI 电影制作的技能包如果把所有导演知识、平台事实、类型模板一次性塞进活跃上下文会让每个请求都背负巨大的 token 成本而且真正的路由逻辑会被海量细节淹没。本仓库的设计答案是根技能负责路由子技能负责决策引用负责携带密集表格与易变事实。活跃上下文保持小权重只在任务挣到时才被加载。三层文件模型谁负责什么references/progressive-disclosure.md 用一张表定义了真实的文件分层层文件加载条件根路由器SKILL.md总是加载。拥有 Fast Lane、各道门gate、Sequence Gate 与 Load Map不含任何密集内容子技能28 个skills/seedance-*/SKILL.md当任务属于该技能职责时加载。每个都是中等重量承载意图、契约与路由而非数据库引用59 个references/*.md按需加载由某道门或 Load Map 中的一行命名。多数廉价少数沉重见下节根路由器SKILL.md仓库根目录的 SKILL.md 是整个系统的入口frontmatter 中的description使用第三人称激活措辞This skill should be used when ...以便工具在缩短的技能列表中匹配。正文则刻意保持精简Fast Lane快速通道单条独立短片、非专家用户、无 IP/肖像/品牌/安全标记、无平台事实疑问的请求直接走seedance-interview-short→seedance-prompt-short跳过完整门循环各道门gatesDirectors Read Gate、Source Gate、Professional Gate、Sequence Gate、Mode Gate、Multilingual Gate、Safety Gate 等每一道门只在自己被挣到时才要求加载对应引用Sequence Gate 与不变式序列项目的九条不变式lineage、accepted observed state、rejected footage 排除等Load Map一张情境 → 加载内容的大表是运行时的权威路由依据例如长故事/连续片段/多代生成对应加载 skills/seedance-sequence/SKILL.md 与 references/sequence-project-state.md。agents/openai.yaml 以display_name: Seedance 2.0 Skill OS和allow_implicit_invocation: true定义了 Codex 侧的可隐式调用入口默认提示词为Use $seedance-20与根技能名对齐。28 个子技能scripts/validate_skills.py 中的EXPECTED_SKILLS常量精确列出 28 个子技能从seedance-interview、seedance-prompt、seedance-camera、seedance-lighting、seedance-motion、seedance-audio到seedance-sequence、seedance-continuation、seedance-vocab-*en/es/ja/ko/ru/zh与seedance-examples-*zh/ja/ko等。每个子技能都被要求包含## Intent小节解释它存在的理由——这是 CI 强制项之一见 scripts/validate_skills.py。59 个引用文件引用层承载密集表格与易变事实。注意一个细节progressive-disclosure.md自己的表格写的是 59 个references/*.md而 docs/RELEASE_v6.2.0.md 发布时点数是 58 个——这是两个快照的差异恰好印证了引用集合是持续演进的事实。重引用与轻引用按需披露的代价分层渐进式披露最关键的分寸是区分可以自由加载的轻引用与必须按任务触发才加载的重引用。references/progressive-disclosure.md 明确规定不要把大数据库搬回活跃的子技能正文也不要默认加载重引用。仓库中的重引用包括references/directing-engine.md更深的导演推理层——一致性原则Coherence Principle、机位选择、导演之声Directors Voice与长片脊柱long-form spine。只有当场景需要差异化处理、设定不清晰或需要一种声音贯穿多个片段时才在规范的 Directors Read 之后加载references/directing-engine-genre-library.md33 个完整打磨的类型示例。只通过 genre/examples 的 Load Map 行加载永远不由常开的 Direction 步骤加载references/api-status.md、references/platform-surface-matrix.md、references/api-workflow.md带日期的、易变的平台事实只挂在 Source Gate 之后加载并受下文新鲜度规则约束references/pro-filmmaking-standards.md专业制作脊柱只挂在 Professional Gate 之后加载。唯一的廉价例外Directors Readreferences/directors-read.md 是每次路由都会加载的廉价例外它承载规范的剧情分类与预编译契约。叙事作品完成完整的十字段记录dramatic function、turn、POV、power shift、hidden want、obstacle/tactic、subtext、visible suppressed behavior、non-transferable detail、stock solution refused非叙事作品只记录两行——utility intent与non-narrative refusal不编造戏剧冲突。这条规则的代价权衡很清晰一个必须每轮使用的判断契约值得常驻上下文而一个 33 种类型的示例库不值得。CI 如何守护重引用披露scripts/validate_skills.py 专门检查progressive-disclosure.md必须文档化directing-engine.md与directing-engine-genre-library.md这两个重引用disclosure root / references / progressive-disclosure.md if os.path.lexists(disclosure): disclosure_text read_repo_text(rootroot, pathdisclosure) for needed in (directing-engine.md, directing-engine-genre-library.md): if needed not in disclosure_text: errors.append(fprogressive-disclosure.md must document the heavy reference {needed})也就是说披露方案本身是受验证的事实如果将来有人把重引用悄悄改成默认加载或删掉披露文档中的对应条目python scripts/validate_skills.py .会直接返回非零退出码。类型内容所有权一处来源各自分工类型genre工艺在三个地方出现为避免三者持续分叉每个位置只负责一件工作位置拥有的内容职责references/directing-engine.md references/directing-engine-genre-library.md推导derivation一个类型为什么这样拍摄、布光、表演read → intention → voice → setupreferences/genre-guides.md优先级priorities每个类型最需要保护什么产品身份、口型同步、节拍同步seedance-recipes references/examples-by-mode.md骨架skeletons可直接复制的起始模板规则是一个类型事实的唯一真源single source of truth是其推导文件另外两处只引用它而不是复述它。这避免了同一事实三处维护、互相矛盾的经典腐烂模式。子技能 skills/seedance-recipes/SKILL.md 负责类型模板而 Load Map 中类型模板/示例/特定类型的导演示例行同时点名 recipes、examples-by-mode、genre-guides 与 genre-library——但加载路径与常开的 Direction 步骤严格分离。新鲜度规则易变平台事实不许漂移带日期的平台引用api-status、platform-surface-matrix、api-workflow 等不允许落后于 references/api-status.md 的last_verified日期太多如果api-status.md前进而一个新鲜度关键的引用仍引用旧的验证日期发布前必须重新验证并重新盖章或确认其仍然准确。有意冻结的快照如 references/research-2026-05-30.md 豁免——它们的日期本身就是其身份的一部分。这条规则有源码级执行 scripts/source_registry_check.py 中freshness_critical列表内的引用必须携带格式为YYYY-MM-DD的last_verified字段并以api-status.md的last_verified为锚点检查漂移天数--enforce-freshness参数会在漂移超限时直接失败。例如 references/api-status.md 当前头部为last_verified: 2026-08-01并附带逐段日期说明哪些段落在哪个日期验证过以及 2026-09-07 的范围更新说明——这就是每段事实都知道自己何时被验证的披露纪律。V6 序列披露状态细节下沉到引用序列sequence是上下文膨胀的高危区。V6 的披露方案明确划分了职责根 SKILL.md 只拥有Sequence Gate 与不变式九条序列不变式全部写在根技能里例如每个序列提示词都必须有project_id与clip_idlineage、被接受的观察状态覆盖计划状态skills/seedance-sequence/SKILL.md 拥有全局规划与当前片段编译——plan globally, generate locally规划整个故事但只编译下一个未解决的片段skills/seedance-continuation/SKILL.md 拥有已接受素材的续写与重新锚定密集的状态细节下沉到 references/sequence-project-state.md、references/continuation-handoff.md 与 references/prompt-compiler.md。这样设计的效果是根技能不膨胀不背序列状态字段序列技能不背全部细节只背规划与编译逻辑而真正易变、按片段变化的状态已接受片段的 observed end state、continuation 类型、编译契约全部由按需引用的引用层承载。这与 docs/RELEASE_v6.2.0.md 记录的架构加固一致把 454 行的导演引擎拆分为渐进式披露合规的结构33 类型示例库移到单独引用常开的 Direction 步骤不再拉取整个库。路由可移植性链接即契约渐进式披露的物理载体是普通相对 Markdown 链接而不是宿主私有的技能/引用别名。SKILL.md 开篇就声明每个活跃运行时路由都是相对 Markdown 链接客户端即使没有私有别名也可以直接打开目标文件静态验证保证每个链接都停留在安装包内部、命中大小写精确的文件以及存在 fragment 时的标题锚点但不承诺宿主会自动加载——客户端必须自行跟随链接或提供原生路由。scripts/validate_skills.py 用三个正则把这个契约落地为可执行的校验OPAQUE_ROUTE_RE拒绝[skill:name]、[ref:name]这类不透明路由强制使用可移植的相对路径MARKDOWN_LINK_RE解析普通 Markdown 链接逐个验证目标必须落入skills/或references/根、路径必须使用正斜杠、不得有冗余的../爬升、文件名必须大小写精确存在、fragment 必须能在目标文件中解析出 Markdown 标题锚点_heading_anchors会把标题规整成小写连字符锚点UNLINKED_ROUTE_REUNLINKED_ROUTE_DIRECTIVE_RE识别以代码文本形式出现的路由指令——当句子用 load/read/open/consult/follow/see/use/check/review 等动词命令加载某个反引号包裹的.md文件或出现 record/write/append/save/store/log/update/edit/add 等写回动词时判定为未链接路由并报错。active_runtime_markdown_paths依据 validation/install-payload.txt 清单判定哪些 Markdown 参与运行时路由排除了references/migrated等仅供阅读的树防止仓库里存在但未随包安装的文档悄悄变成路由契约。也就是说渐进式披露不仅是文档策略还是一条可被python scripts/validate_skills.py .自动证明的安装契约。实操要点与落地建议判断加载优先级面对一个新任务先问这属于哪个子技能的职责再问它需要哪个引用——不要默认把重引用全部拉入上下文。快速单片段请求直接走 Fast Lane 的两个短技能只有触及 Source/Professional/Sequence 门时才加载对应重引用。检查链接可移植性任何文档中的路由都应写成从当前文件出发的普通相对 Markdown 链接并确保目标文件在安装清单内、大小写精确。运行python scripts/validate_skills.py .可以一次性发现不透明路由、代码文本路由、路径爬升、大小写不匹配与失效锚点。维护平台事实新鲜度引用 references/api-status.md 的last_verified日期更新任何平台事实时同步重盖章冻结快照如 research 文件保持原日期不改。类型内容只写一处推导写入 directing-engine 系优先级写入 genre-guides骨架写入 recipes/examples-by-mode其余位置只引用不复述。序列状态下沉序列项目的状态字段进引用sequence-project-state、continuation-handoff、prompt-compiler根技能只保留门与不变式。这套分层不是单纯的文档组织偏好而是被 CI 守护的架构决定它让同一个技能包既能服务只想要一条短片的普通用户Fast Lane 全速通过也能服务需要跨 20 个片段保持导演之声的剧情长片Sequence Gate 加载完整状态链而这两者共享同一个永不膨胀的根上下文。赞分享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 AI 按需能力Capabilities on Demand用 load_capability 构建渐进式披露的 AgentPydantic AI 按需能力Capabilities on Demand用 load_capability 构建渐进式披露的 Agent Pydant人工智能大模型AI Agent工具调用MCP ClientsEmscripten渐进式加载实现WebAssembly应用的按需加载Emscripten渐进式加载实现WebAssembly应用的按需加载 在现代Web开发中WebAssemblyWasm已成为提升应用性能的关键技术。然编译器WebAssembly开发工具构建工具IronClaw 渐进式工具披露协议Agent 如何按需发现并调用隐藏工具IronClaw 渐进式工具披露协议Agent 如何按需发现并调用隐藏工具 导读 IronClaw定位为以隐私、安全与可扩展性为核心的 Agent OS在人工智能AI 应用交互助手AI Agent上一篇5分钟精通Video-subtitle-extractor本地视频字幕提取工具完整指南下一篇Windows Cleaner终极指南如何5分钟解决C盘爆红问题让电脑重获新生创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。