{"id":"73af74b4-287d-4ccf-87fa-a33d8038aed9","entityType":"agent","slug":"clawhub-qomob-madstory","name":"Madstory(Seedance Storyboard Engine)","canonicalUrl":"https://www.xpersona.co/agent/clawhub-qomob-madstory","canonicalPath":"/agent/clawhub-qomob-madstory","generatedAt":"2026-10-10T10:45:09.822Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":null},"description":"电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途 Skill: Madstory(Seedance Storyboard Engine) Owner: qomob Summary: 电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途 Tags: latest:3.4.4 Version history: v3.4.4 | 2026-08-","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s1712hx0t1qgg41g18p2bb0d6583ms02:madstory","sourceUrl":"https://clawhub.ai/qomob/madstory","homepage":"https://clawhub.ai/qomob/skills/madstory","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/qomob/madstory","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/qomob/skills/madstory","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":null},"stars":null,"forks":null,"downloads":1652,"packageName":null,"latestVersion":"3.4.4","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T05:31:42.752Z","lastCrawledAt":"2026-10-10T05:31:42.752Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T05:31:42.752Z","lastVerifiedAt":null,"highlights":[{"version":"3.4.4","createdAt":"2026-08-07T12:52:11.713Z","changelog":"Version 3.8.0 introduces major updates with broader platform coverage, more creative modes, and enhanced output specs. - Added native support for Seedance 2.5 (30s默认/超长/局部编辑/多语种/绿幕等) alongside 2.0降级和Seedream 5.0 Pro图片生成。 - 创作模式扩展至11种，涵盖时间戳控制、超长视频、局部/智能编辑、白模、绿幕和多宫格分镜等新场景。 - 输出规范增加ENGINE_VERSION、TIMESTAMP_CONTROL和多平台能力标注，详细区分2.5与2.0参数能力。 - 新增/修订参考文档，如 seedance_25_rules.md、storyboard_template.html，以及丰富的使用示例和细分说明。 - 规则及分层加载结构优化，反映新版平台特性和交互流程。 - 移除旧 skill-card.md，加入丰富的“references”与“assets”文档","fileCount":19,"zipByteSize":108494},{"version":"3.4.3","createdAt":"2026-07-12T08:13:57.514Z","changelog":"MadStory v3.6.0 Changelog - 平台指向与规则严格对齐：新增平台版本锁定说明，所有生成规则、参数和质量门禁现指向并仅验证于 Seedance 2.0（视频）与 Seedream 4.x/5.x（图片），对非原生平台（Runway/Kling/Sora）输出兼容需用户自行适配参数。 - 明确AI模型实际局限：新增实际生成表现限制说明（如长视频画面衰减、动作不稳定、跨镜头一致性不足等），并提供对应应对策略。 - Phase流程细化：分镜推导阶段新增Phase 3.5（表演与调度），并强调Phase 3.5与4间必须暂停确认，优化故事与镜头间的互动细节。 - 参数依赖链安全：新增参数依赖链说明，强制各关键参数必须继承自上一步，明确禁止编造以保证输出稳定可靠。 -","fileCount":3,"zipByteSize":8578},{"version":"3.4.2","createdAt":"2026-07-10T04:31:53.212Z","changelog":"madstory v3.5.0 - Added a \"分镜状态看板\" (Storyboard Status Board) to display progress across phases, modes, and multi-step workflows. - Enhanced pre-flight checklist with \"元反思\" (meta-reflection): 8-dimension self-inspection to improve output reliability. - Updated documentation to guide users on viewing real-time board progress and clarified multi-mode usage. - No functional changes to code/assets; this update refines workflow transparency and interaction guidance.","fileCount":3,"zipByteSize":6497},{"version":"3.4.1","createdAt":"2026-06-17T03:48:48.719Z","changelog":"- 移除 skill-card.md 文件，清理了冗余的元信息资源。 - 技能核心结构与功能保持不变，仅进行文件删减优化。 - 其他文件与接口、创作模式无更改，不影响现有使用和输出规范。","fileCount":23,"zipByteSize":85660},{"version":"3.4.0","createdAt":"2026-06-15T00:04:32.197Z","changelog":"**MadStory 3.4.0 — 双模式重构（视频+图片Seedream 4.x/5.x）** - 新增对 Seedream 4.x/5.x 图片生成的全面支持，包括文生图、图像编辑、多图输入/输出等相关规则与质量门禁。 - 扩展分层加载资源，增加 seedream_4x_rules.md 和短剧题材模板 short_drama_genres.md。 - 精简并移除原有 scripts/ 目录下的所有运行时代码（如 mad_story_engine.py、api_server.py 等）；改为与技能运行时解耦。 - 细化输出规范，将视频与图片两大输出模式的各项内容和校验标准分别列出。 - 更新触发词、技能定位、使用范围，不再覆盖通用AI绘画，仅限分镜及影视/短剧类应用。","fileCount":23,"zipByteSize":84724},{"version":"3.1.0","createdAt":"2026-06-08T21:44:35.946Z","changelog":"- Removed sample file: skill-card.md - No changes to functionality or core documentation. - Maintains all features and usage details as in previous version.","fileCount":27,"zipByteSize":118806},{"version":"3.0.0","createdAt":"2026-06-08T14:43:29.598Z","changelog":"MadStory 3.1 introduces a layered architecture with expanded creative modes and deeper modularization. - Migrated to a progressive, on-demand file loading framework for better performance and extensibility. - Added support for 9 creative modes, including new \"电影创意探索\" (creative exploration). - Split all detailed guides, cheat sheets, and engineering references into individual reference files for phase, mode, prompt, and platform-specific logic. - Expanded cross-platform support (Seedance, Runway, Kling, Sora), including platform adapter and multi-modal advice output. - Improved output/quality gate checks and enforced stricter negative prompt automation. - Added and organized rich sample assets, deep mode/phase guides, and director-level pre-flight checklists.","fileCount":27,"zipByteSize":118911}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1712hx0t1qgg41g18p2bb0d6583ms02:madstory","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:45:09.816Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-qomob-madstory/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":null},"readme":"Skill: Madstory(Seedance Storyboard Engine)\n\nOwner: qomob\n\nSummary: 电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途\n\nTags: latest:3.4.4\n\nVersion history:\n\nv3.4.4 | 2026-08-07T12:52:11.713Z | user\n\nVersion 3.8.0 introduces major updates with broader platform coverage, more creative modes, and enhanced output specs.\n\n- Added native support for Seedance 2.5 (30s默认/超长/局部编辑/多语种/绿幕等) alongside 2.0降级和Seedream 5.0 Pro图片生成。\n- 创作模式扩展至11种，涵盖时间戳控制、超长视频、局部/智能编辑、白模、绿幕和多宫格分镜等新场景。\n- 输出规范增加ENGINE_VERSION、TIMESTAMP_CONTROL和多平台能力标注，详细区分2.5与2.0参数能力。\n- 新增/修订参考文档，如 seedance_25_rules.md、storyboard_template.html，以及丰富的使用示例和细分说明。\n- 规则及分层加载结构优化，反映新版平台特性和交互流程。\n- 移除旧 skill-card.md，加入丰富的“references”与“assets”文档\n\nv3.4.3 | 2026-07-12T08:13:57.514Z | auto\n\nMadStory v3.6.0 Changelog\n\n- 平台指向与规则严格对齐：新增平台版本锁定说明，所有生成规则、参数和质量门禁现指向并仅验证于 Seedance 2.0（视频）与 Seedream 4.x/5.x（图片），对非原生平台（Runway/Kling/Sora）输出兼容需用户自行适配参数。\n- 明确AI模型实际局限：新增实际生成表现限制说明（如长视频画面衰减、动作不稳定、跨镜头一致性不足等），并提供对应应对策略。\n- Phase流程细化：分镜推导阶段新增Phase 3.5（表演与调度），并强调Phase 3.5与4间必须暂停确认，优化故事与镜头间的互动细节。\n- 参数依赖链安全：新增参数依赖链说明，强制各关键参数必须继承自上一步，明确禁止编造以保证输出稳定可靠。\n-\n\nv3.4.2 | 2026-07-10T04:31:53.212Z | auto\n\nmadstory v3.5.0\n\n- Added a \"分镜状态看板\" (Storyboard Status Board) to display progress across phases, modes, and multi-step workflows.\n- Enhanced pre-flight checklist with \"元反思\" (meta-reflection): 8-dimension self-inspection to improve output reliability.\n- Updated documentation to guide users on viewing real-time board progress and clarified multi-mode usage.\n- No functional changes to code/assets; this update refines workflow transparency and interaction guidance.\n\nv3.4.1 | 2026-06-17T03:48:48.719Z | user\n\n- 移除 skill-card.md 文件，清理了冗余的元信息资源。\n- 技能核心结构与功能保持不变，仅进行文件删减优化。\n- 其他文件与接口、创作模式无更改，不影响现有使用和输出规范。\n\nv3.4.0 | 2026-06-15T00:04:32.197Z | user\n\n**MadStory 3.4.0 — 双模式重构（视频+图片Seedream 4.x/5.x）**\n\n- 新增对 Seedream 4.x/5.x 图片生成的全面支持，包括文生图、图像编辑、多图输入/输出等相关规则与质量门禁。\n- 扩展分层加载资源，增加 seedream_4x_rules.md 和短剧题材模板 short_drama_genres.md。\n- 精简并移除原有 scripts/ 目录下的所有运行时代码（如 mad_story_engine.py、api_server.py 等）；改为与技能运行时解耦。\n- 细化输出规范，将视频与图片两大输出模式的各项内容和校验标准分别列出。\n- 更新触发词、技能定位、使用范围，不再覆盖通用AI绘画，仅限分镜及影视/短剧类应用。\n\nv3.1.0 | 2026-06-08T21:44:35.946Z | user\n\n- Removed sample file: skill-card.md\n- No changes to functionality or core documentation.\n- Maintains all features and usage details as in previous version.\n\nv3.0.0 | 2026-06-08T14:43:29.598Z | user\n\nMadStory 3.1 introduces a layered architecture with expanded creative modes and deeper modularization.\n\n- Migrated to a progressive, on-demand file loading framework for better performance and extensibility.\n- Added support for 9 creative modes, including new \"电影创意探索\" (creative exploration).\n- Split all detailed guides, cheat sheets, and engineering references into individual reference files for phase, mode, prompt, and platform-specific logic.\n- Expanded cross-platform support (Seedance, Runway, Kling, Sora), including platform adapter and multi-modal advice output.\n- Improved output/quality gate checks and enforced stricter negative prompt automation.\n- Added and organized rich sample assets, deep mode/phase guides, and director-level pre-flight checklists.\n\nArchive index:\n\nArchive v3.4.4: 19 files, 108494 bytes\n\nFiles: assets/cheat_sheet.json (27777b), assets/storyboard_template.html (13941b), README.md (14417b), references/examples/example_1_creative_film.md (4667b), references/examples/example_2_multi_shot.md (2907b), references/examples/example_3_short_drama.md (1860b), references/modes_detail.md (19777b), references/phases_detail.md (12446b), references/pre_flight_checklist.md (15898b), references/prompt_engineering.md (8235b), references/seedance_25_rules.md (20335b), references/seedance_v2_rules.md (11070b), references/seedream_4x_rules.md (19247b), references/short_drama_consistency.md (18608b), references/short_drama_genres.md (7428b), references/terminology.md (13400b), skill-card.md (2869b), SKILL.md (19108b), _meta.json (127b)\n\nFile v3.4.4:SKILL.md\n\n---\nname: mad-story\ndescription: \"电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途的通用AI绘画。\"\nversion: 3.8.0\nauthor: qomob.ai\nlicense: MIT\nmodes: 11\nphases: 8\nplatforms:\n - Trae IDE\n - OpenClaw\n - Dify\n - Coze\n - Claude Desktop / MCP\nreferences:\n - references/seedance_25_rules.md\n - references/modes_detail.md\n - references/phases_detail.md\n - references/prompt_engineering.md\n - references/seedance_v2_rules.md\n - references/seedream_4x_rules.md\n - references/terminology.md\n - references/pre_flight_checklist.md\n - references/short_drama_consistency.md\n - references/short_drama_genres.md\nassets:\n - assets/cheat_sheet.json\n - assets/storyboard_template.html\n---\n\n# MadStory — 电影级影视分镜设计引擎 v3.8.0 (分层加载架构)\n\n## 技能定位\n\nMadStory 是面向电影级内容生产的专业分镜设计引擎，同时支持 **Seedream 4.x/5.x 图片生成**（文生图、图像编辑、参考图生图、多图输入/输出）。\n\n- **触发词**: `影视分镜`, `分镜设计`, `电影分镜`, `广告分镜`, `电商视频`, `UGC广告`, `品牌短片`, `多镜头叙事`, `一镜到底`, `爆款复刻`, `短剧创作`, `从一句话出片`, `AI电影`, `AI视频生成`, `Seedance`, `Seedream`, `分镜脚本`, `视频提示词`, `文生图`, `图生图`, `图像编辑`, `参考图生图`, `短剧剧本`, `微短剧`, `竖屏剧`, `AI短剧`, `短剧分镜`, `短剧编剧`, `锁脸`, `小说改短剧`, `漫剧`, `角色人设`, `时间戳控制`, `超长视频`, `视频延长`, `局部编辑`, `智能编辑`, `白模`, `绿幕`, `BGM分离`, `多语种`, `多宫格分镜`\n- **目标用户**: 电影导演、广告导演、创意总监、影视制作人、电商运营、品牌营销、内容创作者、短剧制作人、零基础创作者、平面设计师\n- **默认时长**: 30 秒 / 镜头（Seedance 2.5 视频），15 秒（Seedance 2.0 降级时），图片模式无时长限制\n- **原生支持平台**: Seedance 2.5（默认）/ 2.0（降级）(视频), Seedream 4.x/5.x/5.0 Pro (图片) — 所有提示词规则、参数体系、质量门禁均基于此二平台校准\n- **兼容输出平台**: Runway Gen-3 / Kling / Sora — 输出的提示词可作为创作起点在这些平台使用，但参数体系（Motion Strength、Negative Prompt 格式、多镜头语法等）需用户自行适配\n\n## 规则版本锁定\n\n> **所有提示词规则、参数建议、质量门禁基于以下平台版本验证。** 平台升级后部分规则可能失效，使用前请核对版本。\n\n| 平台 | 验证版本 | 状态 |\n|------|---------|------|\n| Seedance 2.5 (视频) | **2.5（默认基准）** | 完整规则见 `references/seedance_25_rules.md`；原生30s/超长180s/延长60s/50素材/时间戳/编辑/白模/绿幕/多语种/多人 |\n| Seedance 2.0 (视频) | 2.0（降级备选） | 完整规则见 `references/seedance_v2_rules.md`；积分成本敏感场景使用，不支持2.5新增能力 |\n| Seedream (图片) | 4.0 / 4.5 / 5.0 Lite / **5.0 Pro** | 全部规则基于此版本范围；5.0 Pro 专属能力见 `references/seedream_4x_rules.md` §8.5 |\n\n### Seedance 2.5 vs 2.0 快速对照\n\n| 维度 | 2.5（默认） | 2.0（降级） |\n|------|------------|------------|\n| 单次时长 | 30s（可延长至60s，超长模式180s） | 15s |\n| 参考图 | ≤30 张 | ≤9 张 |\n| 参考视频 | ≤10 段，总≤30s | ≤3 段，总≤15s |\n| 参考音频 | ≤10 段，总≤30s | ≤3 段，总≤15s |\n| 仅传音频 | 支持 | 不支持（必须配图/视频） |\n| 时间戳控制 | 原生秒级/帧级 | 无 |\n| 局部编辑/白模/绿幕 | 支持 | 不支持 |\n| BGM 分离/多语种/多人 | 支持 | 不支持 |\n| 积分消耗（30s 720p） | ~780 | ~210（15s） |\n\n## AI 模型真实限制（必读）\n\n> 以下限制基于 Seedance 2.5 / 2.0 / Seedream 4.x-5.x 的实际生成表现。**2.5 在时长/复杂动作/一致性/Negative 响应/多人/多语种上均有显著改善**。完整对照见 `references/seedance_25_rules.md` §8。\n\n| 限制 | 2.0 表现 | 2.5 改善 | 对策 |\n|------|---------|---------|------|\n| **时长衰减** | 8-12s 后质量下降，15s 末段纹理崩坏 | 30s 保持一致性 | 2.5 可放心用 30s；2.0 降级仍优先 ≤10s，必须 15s 时标注\"8s 后质量风险区\" |\n| **复杂动作不稳定** | 开门/打斗/转身等多步骤动作易变形 | 长尾动作解锁，复杂物理交互流畅 | 2.5 可尝试复杂动作；2.0 仍用\"慢\"\"稳定\"修饰词+剪辑绕开 |\n| **跨镜头一致性靠运气** | 角色面部/服装在生成调用间漂移 | 切镜一致性显著提升 | 2.5 多镜头更可靠；2.0 仍需多次生成取最佳 |\n| **Motion Strength 偏差** | 高值(≥6)易触发变形 | 仍需注意 | 从低值(2-3)开始，确认稳定后再调高 |\n| **Negative 响应** | 不稳定，写了 `no face drift` 仍会 drift | 大幅优化，\"禁止\"表述响应更好 | 2.5 用\"禁止\"表述；生成后仍需人工检查 |\n| **多人双胞胎** | 多人同框长相趋同、换脸错位 | 多人参考升级解决 | 2.5 多人场景用多人参考；2.0 避免多人同框 |\n| **多语种** | 发音不准/不支持长素材 | 10+ 语种原生，口型字幕对齐 | 多语种必须用 2.5 |\n\n## 分层加载架构 (Progressive Loading)\n\n> **核心原则**: SKILL.md 始终加载。其他资源按交互阶段按需加载。\n\n## 模式状态看板（启发）\n\n> 11 种创作模式并行或串行执行时，用户需要看到每个模式的状态——哪个在推导、哪个在生成、哪个已完成。\n\n```\n🎬 分镜状态看板\n├── [Mode 选择] ✅ 已完成 — {模式名}\n├── [Phase 0-7] 🟡 推导中 — 当前 Phase {N}\n├── [提示词生成] 🔵 等待中\n└── [Pre-flight 预检] 🔵 等待中\n```\n\n多模式串行（如短剧全链路：剧本→分镜→提示词→生成）时，看板展示每个阶段的独立状态。用户可随时说\"看板\"查看当前进度。\n\n### Layer 0: 始终加载 (本文件)\n- 元数据 + 触发词 + 技能定位\n- 11 模式概览表\n- Phase 0-7 阶段名称\n- 输出规范 + 质量门禁\n- 分层加载索引\n\n### Layer 1: 按需加载\n以下资源在对应触发条件满足时读取文件内容:\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| **默认平台规则（视频生成必读）** | `references/seedance_25_rules.md` | **Seedance 2.5 完整规则**：参数规格/4段式公式/7维人物/30秒3模块/延长/编辑/白模公式/16项能力/转场表/禁止项/AI限制 |\n| 积分敏感需降级到 2.0 | `references/seedance_v2_rules.md` | Seedance 2.0 提示词工程规范（5层结构/3种模式/Negative/一镜到底/复刻/Agent/短剧） |\n| 用户确认/选择模式 | `references/modes_detail.md` | 该模式（11种）的完整说明、约束、护栏 |\n| 进入 Phase N 推导 | `references/phases_detail.md` | Phase N 的详细推导指引 |\n| 生成/校验提示词 | `references/prompt_engineering.md` | 4段式主公式+专项公式索引、5层元素检查清单、Negative索引 |\n| 需要精确镜头术语 | `references/terminology.md` | 影视专业术语库 |\n| 分镜方案输出前检查 | `references/pre_flight_checklist.md` | 导演级预检清单 + **元反思（8 维度推演过程自检）** |\n| 使用 Seedream 4.x/5.x 或涉及图片生成 | `references/seedream_4x_rules.md` | Seedream 4.x/5.x 文生图/图像编辑/参考图/多图规则 |\n| 短剧 + 需要题材灵感/爆款分析 | `references/short_drama_genres.md` | 6大题材模板与10集标准结构、爆款套路 |\n\n### Layer 2: 深度加载（高级场景触发）\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| 短剧 + 多场景/多集 | `references/short_drama_consistency.md` | 短剧全流程一致性管控、角色卡、八要素公式、小说改编流程 |\n| 要求电影级镜头语言 | `assets/cheat_sheet.json` → `cinematic_camera_language` + `cinematic_lighting_extended` | 运镜/构图/布光预设 |\n| 要求声音设计 | `assets/cheat_sheet.json` → `cinematic_sound_extended` | 声音分层 + 情感映射 |\n| 要求导演风格参考 | `assets/cheat_sheet.json` → `director_style_references` + `creative_film_prompts_library` | 大师风格库 |\n| HTML 可视化 | `assets/storyboard_template.html` | 分镜预览模板 |\n\n## 11 种创作模式概览\n\n| # | 模式 | 场景 | 输入 | 核心约束 |\n|---|------|------|------|---------|\n| 0 | 电影创意探索 | 概念开发、风格实验 | Text | Generate-and-Filter + Tournament |\n| 1 | 电商产品 | 商品详情页、主图动效 | Image | 产品不变形、标签可读 |\n| 2 | UGC 原生广告 | 信息流、口播、种草 | Reference | 人脸一致、手势自然 |\n| 3 | 电影感品牌短片 | 品牌故事、预告 | Text/Image | 镜头有意图、灯光有逻辑 |\n| 4 | 多镜头叙事 | 完整叙事弧线、超长叙事 | Reference | 跨镜头一致、2.5支持超长180s/延长60s/无缝转场 |\n| 5 | 一镜到底 | 空间巡游、沉浸展示 | Image序列 | 2-10图，空间连续、支持30s长一镜 |\n| 6 | 爆款复刻 | 灵感翻拍、竞品复刻 | Reference+Image | 风格还原、迁移创意/绿幕/BGM分离 |\n| 7 | Agent 模式 | 一句话到成片 | Text | 自动意图解析+路径规划（含超长/编辑/白模路由） |\n| 8 | 短剧创作 | AI短剧、漫剧、小说改编 | Reference+Script | 多人参考/音色/跨集一致、多语种出海 |\n| 9 | 智能编辑 | 局部消除/替换/空间视角修改/BGM分离 | Video | 精准定位防误伤、保留不变要素 |\n| 10 | 白模预演 | Maya/Blender白模渲染、分镜预演 | Video(白模)+Image | 镜头/空间/走位精准、粗/细颗粒度 |\n\n> 模式详情见 `references/modes_detail.md`\n\n## 分镜推导阶段 (Phase 0-7)\n\n| Phase | 名称 | 产出 |\n|-------|------|------|\n| 0 | 模式选择与意图澄清 | Mode 确认 + 输入策略 |\n| 1 | 核心创意锁定 | Subject + Action |\n| 2 | 时间轴与节奏 | Timeline + 关键帧 |\n| 3 | 视觉构图 | Composition + 画幅 |\n| 3.5 | 表演与调度 | Performance Notes（走位/视线/反应镜头/潜台词） |\n| 4 | 镜头运动 | Camera + Motion Strength |\n| 5 | 光影与质感 | Lighting + 风格预设 |\n| 6 | 声音设计 | Sound + BGM |\n| 7 | 最终合成与输出 | 完整提示词 + Negative Prompt |\n\n> Phase 详情见 `references/phases_detail.md`\n\n## 交互准则\n- **逐阶段推进**: Phase 3.5（表演与调度）和 Phase 4（镜头运动）之间必须暂停确认，因为调度决策直接影响镜头选择\n- **用专业术语但让外行听懂**: 提供选项卡片\n- **主动拦截**: 用户塞入过多信息时建议拆分\n- **模式引导**: Phase 0 必须确认模式\n- **负向提示词自动注入**: 由系统按 Mode 自动生成\n- **图片模式**: 启用 Seedream 规则时自动切换输出格式\n\n## 输出规范\n\n### 视频模式输出 (Seedance 2.5默认/2.0降级/Runway/Kling/Sora)\n每个分镜方案必须包含:\n1. **ENGINE_VERSION**: Seedance 2.5（默认）或 2.0（降级）— 明确标注影响可用能力\n2. **STANDARD_PROMPT**: 符合 4 段式主公式的完整正向提示词（素材描述+一句话概述+具体情节+全局补充）；专项场景用对应公式（7维人物/30秒3模块/延长/编辑/白模）\n3. **NEGATIVE_PROMPT**: 按 Mode 自动生成的禁止项 + 历史缺陷增强（2.5 用\"禁止\"表述）\n4. **TIMELINE**: 时间轴 + 关键帧描述（2.5 默认 30s，2.0 降级 15s，超长 30-180s）\n5. **TIMESTAMP_CONTROL**: 时间戳分镜（长视频/多镜头/卡点必填，见 `seedance_25_rules.md` §3）\n6. **CAMERA**: 逐秒/逐镜头运动描述\n7. **MOTION_STRENGTH**: 建议值 (1-10)\n8. **DURATION**: [4,30]s / 超长 30-180s / 延长 ≤60s\n9. **MODE**: 模式标签\n10. **MULTI_MODAL_ADVICE**: 参考素材建议（2.5: ≤30图+≤10视频+≤10音频 / 2.0: ≤9图+≤3视频+≤3音频）\n11. **SHOT_LIST** (多镜头模式): 分镜头脚本表\n12. **DEFECT_LOG**: 用户返回后填写实际生成中出现的缺陷类型（可选，用于持续优化）\n\n### 图片模式输出 (Seedream 4.x/5.x)\n> 完整规则见 `references/seedream_4x_rules.md`\n\n每个图片方案必须包含:\n1. **IMAGE_PROMPT**: 符合 3 层结构（主体+行为+环境，风格/色彩/光影/构图补充）\n2. **TEXT_CONTENT**: 需渲染的文字（双引号包裹）\n3. **REFERENCE_TYPE**: 参考类型（人物形象/风格/虚拟实体/款式/无）\n4. **EDIT_OPERATION**: 编辑操作（增加/删除/替换/修改/无）\n5. **MULTI_IMAGE_OP**: 多图操作（替换/组合/迁移/无）\n6. **MODE**: 模式标签\n7. **PLATFORM**: Seedream 4.x/5.x\n\n## 质量门禁 (Quality Gates)\n\n### 视频模式\n\n| 门禁 | 触发条件 | 不合格判定 |\n|------|---------|-----------|\n| **产品安全** | Ecommerce 模式 | 产品标签不可读或变形 → 不合格 |\n| **人脸一致性** | UGC / Short Drama 模式 | 人脸在两个镜头间不一致 → 不合格 |\n| **单运动原则** | 任何 Mode | 一个镜头内超过 1 个主导运动 → 不合格 |\n| **禁止项声明** | 任何 Mode | 缺少 Negative Prompt/禁止项 → 不合格 |\n| **时长范围** | 任何 Mode | 不在 [4,30]s（超长 30-180s / 延长 ≤60s）→ 不合格 |\n| **多模态上限** | 任何 Mode | 超过 30图/10视频/10音频（2.0: 9图/3视频/3音频）→ 不合格 |\n| **空间连续性** | One-Shot 模式 | 跳帧或空间断裂 → 不合格 |\n| **风格还原** | Viral Replicate 模式 | 风格偏离参考 → 不合格 |\n| **意图解析** | Agent 模式 | 意图完全偏离 → 不合格 |\n| **跨集一致** | Short Drama 模式 | 角色跨集不一致 → 不合格 |\n| **编辑保留** | Smart Edit 模式 | 未声明保留的不变要素 → 不合格 |\n| **白模对应** | White Model 模式 | 白模与渲染主体对应关系映射缺失 → 不合格 |\n| **版本能力匹配** | 2.0 降级时 | 使用了 2.5 独有能力（时间戳/编辑/白模等）→ 不合格 |\n\n### 图片模式 (Seedream 4.x/5.x)\n\n| 门禁 | 不合格判定 |\n|------|-----------|\n| **文字包裹** | 文字内容未用双引号包裹 → 不合格 |\n| **指令指代** | 编辑指令使用代词而非具体对象 → 不合格 |\n| **参考图描述** | 未指明参考对象和生成画面 → 不合格 |\n| **多图角色** | 多图输入未明确图一/图二角色分配 → 不合格 |\n\n> 短剧一致性管控详见 `references/short_drama_consistency.md`\n\n## 参数依赖链（不可编造）\n\n> 以下参数**必须从上一步返回中提取，禁止编造**。\n\n模式选择 → ModeSelection\n ↓ selected_mode, video_engine, image_engine\n角色/场景设定 → CharacterSceneSetup\n ↓ characters[].id, scenes[].id, consistency_lock\n分镜设计 → StoryboardFrames\n ↓ frames[].id, frames[].shot_type, frames[].prompt\n提示词生成 → FinalPrompts\n ↓ prompts[].frame_id, prompts[].engine_specific\n\n## 目录结构\n\n```text\nmad-story/\n├── SKILL.md # 技能定义 v3.8.0 — 分层加载/双版本(2.5默认+2.0降级)/11模式\n├── README.md # 使用说明\n├── references/\n│ ├── seedance_25_rules.md # Seedance 2.5 完整规则（默认基准） (Layer 1)\n│ ├── modes_detail.md # 11种模式详细说明 (Layer 1)\n│ ├── phases_detail.md # Phase 0-7 详细推导指引 (Layer 1)\n│ ├── prompt_engineering.md # 4段式主公式+专项公式索引+5层元素检查清单 (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范（降级备选） (Layer 1)\n│ ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)\n│ ├── terminology.md # 影视分镜专业术语库 (Layer 1)\n│ ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度） (Layer 1)\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)\n│ ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表 — 镜头语言/光影/声音/导演参考（单一数据源）\n └── storyboard_template.html # 分镜预览模板\n```\n\n> 独立工具包（CLI/API/验证）位于 `tools/mad-story-scripts/`，非技能运行时必需。\n\n## 生成结果反馈回路 (DEFECT_LOG)\n\n> **从静态知识库变成动态经验库。** 每次 Phase 7 输出的提示词不是终点——用户生成视频后返回的缺陷数据会让下一次输出更精准。\n\n### 机制\n\n```\nPhase 7 输出提示词 → 用户生成视频 → 观察结果 → 报告缺陷类型\n ↓\n DEFECT_LOG（按 Mode 累积）\n ↓\n 下次该 Mode 的 Phase 7:\n 1. 检查 DEFECT_LOG 高频缺陷\n 2. 在 NEGATIVE_PROMPT 追加针对性保护词\n 3. 在输出中增加 KNOWN_RISKS 警告\n```\n\n### DEFECT_LOG 格式\n\n用户返回生成结果后，按以下格式记录：\n\n```\nDEFECT_LOG:\n mode: [模式名]\n defect_type: [face_drift | object_deformation | motion_glitch | texture_collapse | color_shift | other]\n severity: [high | medium | low]\n timestamp: [在视频中出现的时间点，如 \"8-10s\"]\n description: [一句话描述具体问题]\n prompt_used: [当时的 STANDARD_PROMPT 摘要]\n```\n\n### 预填缺陷库（冷启动）\n\n首次使用时，基于 AI 模型已知问题预填常见缺陷，用户只需确认或补充：\n\n| Mode | 预填缺陷 | 默认增强措施 |\n|------|---------|------------|\n| Ecommerce | 产品标签 10s 后模糊 | NEGATIVE_PROMPT 追加 `no label degradation after midpoint` |\n| UGC | 人脸 7s 后开始漂移 | 建议时长缩短至 10s；追加 `no late-stage face drift` |\n| Cinematic | 高 Motion Strength(≥6) 触发物体融化 | Motion Strength 降级建议 + `no object melting at high motion` |\n| Multi-shot | 第二/三镜头角色面部不一致 | 追加 `no character drift in later shots` |\n| Short Drama | 跨集角色外观漂移 | 建议每集使用相同参考图 + seed |\n\nFile v3.4.4:README.md\n\n# MadStory: 电影级影视分镜设计引擎 v3.8.0\n\n[](https://opensource.org/licenses/MIT)\n[](https://qomob.ai)\n[](https://clawhub.ai/qomob/mad-story)\n\n**MadStory** 是一款电影级影视分镜设计引擎。它将模糊的创作意图，通过 8 阶段专业推导流程，逐步转化为包含构图、运镜、光影、表演调度、声音设计等全维度细节的专业分镜提示词。\n\n- **原生平台**: Seedance 2.5（默认）/ 2.0（降级）(视频) + Seedream 4.x/5.x/5.0 Pro (图片)\n- **兼容输出**: Runway / Kling / Sora（参数需用户自行适配）\n\n## 与其他 AI 分镜工具的区别\n\n| 维度 | 典型 AI 分镜工具 | MadStory v3.8 |\n|------|----------------|---------------|\n| **专业理论** | 提示词模板堆砌 | 电影导演工作流：表演调度 + 剪辑理论 + 声音分类论 |\n| **知识诚实** | 声称支持所有功能 | 区分 `[模型可执行]` vs `[导演参考]`，不假装 AI 能做它做不到的事 |\n| **学习能力** | 静态知识库 | DEFECT_LOG 反馈回路——从每次生成结果中持续优化 |\n| **平台诚实** | \"支持所有平台\" | 原生 vs 兼容分层声明 + 规则版本锁定 + **双版本策略(2.5默认/2.0降级)** |\n| **模型限制** | 隐藏缺陷 | 公开声明已知限制及对策，**2.5 vs 2.0 双版本对照** |\n\n## v3.8.0 更新内容\n\n- **新增 Seedance 2.5 全面能力内化（默认基准）**：30s 原生生成、180s 超长视频、60s 视频延长、时间戳帧级控制、50 多模态参考（30图+10视频+10音频）、智能编辑、白模预演、绿幕合成、BGM 分离、多语种（10+ 语种）、多人参考、无缝转场、多宫格分镜\n- **新增 双版本策略**：2.5 为默认基准，2.0 降级为成本敏感备选。所有规则/参数/质量门禁基于双版本对照校准\n- **新增 2 个创作模式（9→11）**：Mode 9 智能编辑（局部消除/替换/空间视角修改/BGM分离/绿幕）、Mode 10 白模预演（Maya/Blender 粗/细颗粒度渲染）\n- **新增 4 段式提示词主公式**：素材描述+一句话概述+具体情节+全局补充。原 5 层结构降级为元素完整性检查清单\n- **新增 专项公式索引**：7 维人物公式、30s 3 模块公式、超长视频公式、视频延长公式、智能编辑公式、白模公式、时间戳控制公式\n- **新增 seedance_25_rules.md**：2.5 完整规则独立文件（参数规格/16项能力/转场表/Negative禁止项/AI限制2.5改善对照）\n- **升级 Negative Prompt**：2.5 用\"禁止\"表述响应更好（2.0 仍用 `no xxx`）\n- **升级 现有 9 个模式**：均新增「2.5 能力增强」小节，标注各自可用的 2.5 新能力\n\n## v3.7.0 更新内容\n\n- **新增 Seedream 5.0 Pro 全部专属能力**: 交互式精准编辑（坐标/框选/标注框）、高密度信息呈现、原生多语种文字渲染、影视感自动增强、人像质感（毛孔级）、Visual CoT 空间推理、多轮对话式编辑、PNG 透明背景输出\n- **新增 版本能力对照速查表**: 4.0/4.5/5.0 Lite/5.0 Pro 四版本 14 项能力对比矩阵\n- **优化 seedream_4x_rules.md**: 从覆盖 4.0-5.0 Lite 扩展为 4.0-5.0 Pro，新增 §8.5（8 个 Pro 专属子章节）+ §9（版本对照表）+ §10.8（Pro 专属示例）\n\n## v3.6.0 更新内容\n\n- **新增 生成结果反馈回路 (DEFECT_LOG)**: 用户返回生成缺陷 → 按 Mode 累积 → 下次生成自动增强 Negative Prompt 和 KNOWN_RISKS。从静态知识库变成动态经验库\n- **新增 AI 模型真实限制声明**: 公开声明时长衰减(8-12s)、复杂动作不稳定、跨镜头一致性靠运气等 5 类已知限制及对策\n- **新增 规则版本锁定**: 所有规则标注验证平台版本，平台升级后用户可判断哪些规则仍有效\n- **新增 AI 可执行性标注**: Phase 3.5/2/6 每项内容标注 `[模型可执行]` 或 `[导演参考]`，区分\"AI 能做到\"和\"仅供创作决策\"\n- **新增 Phase 3.5 表演与调度**: 走位(Blocking)、视线匹配(Eyeline)、反应镜头策略、潜台词表演(Subtext)\n- **新增 剪辑理论集成**: Phase 2 接入 L-Cut/J-Cut/Jump Cut/Match Cut/Smash Cut/Montage + 景别递进 + 180 度线规则\n- **新增 Tournament 评分 Rubric**: 3 维加权（独特性 40% + 一致性 30% + 情感 30%）+ 安全方案惩罚 + 防同质化规则\n- **新增 Phase 0 时长充分性检查**: 主动评估 15s 是否够用，不够则建议拆分\n- **新增 声音来源分类**: Diegetic / Non-Diegetic / Trans-diegetic 三层决策\n- **优化 数据架构**: 删除 5 个冗余 JSON 文件，cheat_sheet.json 成为唯一数据源\n- **优化 平台声明**: 区分原生支持（Seedance/Seedream）与兼容输出（Runway/Kling/Sora）\n- **优化 短剧工作流**: 明确 Stage A-H 为主线、Phase 0-7 为子流程的映射关系\n- **优化 提示词工程文件**: 消除 prompt_engineering.md 与 seedance_v2_rules.md 40% 内容重复\n- **优化 清理 5 处 no-op**: 将空泛指导替换为可执行规则\n\n## 11 种创作模式\n\n| 模式 | 适用场景 | 输入方式 | 核心约束 |\n|------|---------|----------|------------------|\n| **电影创意探索** | 概念开发、风格实验 | Text-to-Video | Generate-and-Filter + Tournament 筛选 |\n| **电商产品** | 商品详情页、主图动效 | Image-to-Video | 产品几何不变形、标签可读 |\n| **UGC 原生广告** | 信息流投放、口播种草 | Reference-to-Video | 人脸一致、手势自然 |\n| **电影感品牌短片** | 品牌故事片、发布预告 | Text-to-Video | 镜头意图明确、灯光有逻辑 |\n| **多镜头叙事** | 完整叙事弧线、超长叙事 | Reference-to-Video | 跨镜头一致、2.5支持超长180s/延长60s/无缝转场 |\n| **一镜到底** | 产品体验、空间巡游 | Image-to-Video | 2-10 张图片，空间连续，2.5支持30s长一镜 |\n| **爆款复刻** | 灵感翻拍、竞品复刻 | Reference-to-Video | 风格还原、主体替换、迁移创意/绿幕/BGM分离 |\n| **Agent 模式** | 零基础创作 | Text-to-Video | 一句话到成片，自动规划（含超长/编辑/白模路由） |\n| **短剧创作** | AI 短剧、漫剧、小说改编 | Reference-to-Video | Stage A-H 主线 + Phase 子流程、多人参考/音色/多语种出海 |\n| **智能编辑** ⭐ | 局部消除/替换/视角修改/BGM分离 | Video(已有) | 精准定位防误伤、保留不变要素声明 |\n| **白模预演** ⭐ | Maya/Blender 白模渲染、分镜预演 | Video(白模)+Image | 镜头/空间/走位精准、粗/细颗粒度 |\n\n> ⭐ = 2.5 专属新增模式，降级 2.0 时不可用\n\n## 分镜推导流程 (Phase 0-7 + 3.5)\n\n| Phase | 内容 | 产出 |\n|-------|------|------|\n| **Phase 0** | 模式选择与意图澄清 | Mode 确认 + 输入策略 + **时长充分性评估** |\n| **Phase 1** | 核心创意锁定 | Subject + Action |\n| **Phase 2** | 时间轴与节奏 | Timeline + 关键帧 + **剪辑策略标注** |\n| **Phase 3** | 视觉构图 | Composition + 画幅 |\n| **Phase 3.5** | 表演与调度 | Performance Notes（走位/视线/反应镜头/潜台词，含可执行性标注） |\n| **Phase 4** | 镜头运动 | Camera + Motion Strength |\n| **Phase 5** | 光影与质感 | Lighting + 风格预设 |\n| **Phase 6** | 声音设计 | Sound + BGM（含 diegetic/non-diegetic 分类） |\n| **Phase 7** | 最终合成与输出 | 完整提示词(4段式) + ENGINE_VERSION + Negative Prompt + **TIMESTAMP_CONTROL + KNOWN_RISKS + DEFECT_LOG 模板** |\n\n## AI 模型真实限制（2.5 vs 2.0 双版本对照）\n\n> 完整说明见 SKILL.md「AI 模型真实限制」章节 + `seedance_25_rules.md` §8\n\n| 限制 | 2.0 表现 | 2.5 改善 | 对策 |\n|------|---------|---------|------|\n| **时长衰减** | 8-12s 后质量下降，15s 末段纹理崩坏 | 30s 保持一致性 | 2.5 可放心用 30s；2.0 仍优先 ≤10s |\n| **复杂动作不稳定** | 开门/打斗/转身易变形 | 长尾动作解锁，复杂物理交互流畅 | 2.5 可尝试复杂动作；2.0 用\"慢\"\"稳定\"修饰+剪辑绕开 |\n| **跨镜头一致性** | 靠运气 | 切镜一致性显著提升 | 2.5 多镜头更可靠；2.0 仍需多次生成取最佳 |\n| **Motion Strength 偏差** | 高值(≥6)易变形 | 仍需注意 | 从低值(2-3)开始，确认稳定后再调高 |\n| **Negative 响应** | 不稳定，写了 `no face drift` 仍会 drift | 大幅优化，\"禁止\"表述响应更好 | 2.5 用\"禁止\"表述；2.0 用 `no xxx`；生成后仍需人工检查 |\n| **多人双胞胎** | 多人同框长相趋同、换脸错位 | 多人参考升级解决 | 2.5 多人场景用多人参考；2.0 避免多人同框 |\n| **多语种** | 发音不准/不支持长素材 | 10+ 语种原生，口型字幕对齐 | 多语种必须用 2.5 |\n| **Negative 非万能** | — | — | 记录 DEFECT_LOG 持续增强防护 |\n\n## 生成结果反馈回路\n\n```\nPhase 7 输出提示词 → 用户生成视频 → 观察结果 → 报告缺陷\n ↓\n DEFECT_LOG（按 Mode 累积）\n ↓\n 下次生成自动增强 Negative Prompt\n + 增加 KNOWN_RISKS 警告\n```\n\n## 目录结构\n\n```text\nmad-story/\n├── SKILL.md # 技能定义 v3.8.0 — 分层加载/双版本(2.5默认+2.0降级)/11模式\n├── README.md # 本文件\n├── references/\n│ ├── seedance_25_rules.md # Seedance 2.5 完整规则（默认基准） (Layer 1)\n│ ├── modes_detail.md # 11种模式详细说明 + Tournament Rubric + 2.5能力增强\n│ ├── phases_detail.md # Phase 0-7(+3.5) 推导指引 + AI可执行性标注 + 时间戳控制\n│ ├── prompt_engineering.md # 4段式主公式+专项公式索引+5层元素检查清单 (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范（降级备选）\n│ ├── seedream_4x_rules.md # Seedream 4.x-5.0 Pro 图片生成规范（含 5.0 Pro 专属能力）\n│ ├── terminology.md # 影视分镜专业术语库\n│ ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度）+ Mode 9/10 专项\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Stage A-H)\n│ ├── short_drama_genres.md # 短剧6大题材模板\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表（单一数据源）\n └── storyboard_template.html # 分镜预览模板\n```\n\n## 如何使用\n\n### 作为 AI Skill 触发\n在 AI 助手中输入触发词即可：\n`影视分镜` / `分镜设计` / `电影分镜` / `广告分镜` / `电商视频` / `UGC广告` / `品牌短片` / `多镜头叙事` / `一镜到底` / `爆款复刻` / `短剧创作` / `Seedance` / `Seedream` / `文生图` / `图生图` / `图像编辑` / `短剧剧本` / `微短剧` / `AI短剧` / `锁脸` / `小说改短剧` / `漫剧` / `角色人设` / `时间戳控制` / `超长视频` / `视频延长` / `局部编辑` / `智能编辑` / `白模` / `绿幕` / `BGM分离` / `多语种` / `多宫格分镜`\n\n### 用户能力分级\n\n| 层级 | 推荐模式 | 使用路径 |\n|------|---------|---------|\n| **L1 入门** | Agent 模式 | 输入一句话 → 自动拆解 → 生成分镜方案 |\n| **L2 基础** | 电商 / UGC | Phase 0-7 填空式引导 → 选项卡片 |\n| **L3 进阶** | 多镜头 / 一镜到底 / 爆款复刻 | 手动编排多镜头序列 / 转场设计 |\n| **L4 专业** | 电影感 / 短剧 / 多镜头 | 全参数可控、多剧集批量、超长视频/时间戳控制 |\n| **L5 导演级** | 所有模式（含智能编辑/白模预演） | 全链路创作、一致性管控、DEFECT_LOG 优化、双版本策略切换 |\n\n## 示例输出\n\n### 视频模式\n```json\n{\n \"ENGINE_VERSION\": \"Seedance 2.5\",\n \"STANDARD_PROMPT\": \"【素材描述】@图片1 锁定主角面部特征。【一句话概述】雨夜赛博武士穿行霓虹街道，侧面跟拍，电影感红蓝对比色调。【具体情节描述】0-10s 武士从巷口缓步走出，霓虹光斑在积水倒影中闪烁；10-20s 侧跟拍，武士拔刀转身，雨丝被刀锋切开；20-30s 收刀入鞘，镜头拉远揭示赛博城市全景。【全局补充】机位保持侧面平移跟拍；环境为雨夜霓虹街道，湿润反光质感；整体低频电子音效+雨声；电影感红蓝对比色调。禁止生成字幕、禁止生成 BGM、禁止物体融化。\",\n \"NEGATIVE_PROMPT\": \"禁止镜头抖动、禁止物体融化、禁止随机文字、禁止浑浊光影、禁止死黑\",\n \"TIMELINE\": \"0-10s 入场, 10-20s 核心动作, 20-30s 收尾\",\n \"TIMESTAMP_CONTROL\": \"[0-10s] 入场：中景+三分法构图+武士缓步走出 / 潜台词：孤独感的建立\\n[10-20s] 核心：近景+跟拍+拔刀转身 / 潜台词：紧张感升级\\n[20-30s] 收尾：全景+拉远+收刀入鞘揭示城市 / 潜台词：渺小与宏大对比\",\n \"CAMERA\": \"侧面平移跟拍 dolly shot，20s 后拉远\",\n \"MOTION_STRENGTH\": 5,\n \"DURATION\": \"30s\",\n \"MODE\": \"电影感品牌短片\",\n \"MULTI_MODAL_ADVICE\": \"@图片1(主角面部) 1-8张效果好；可选 @音频1(低频电子配乐参考)\",\n \"KNOWN_RISKS\": \"2.5 30s 一致性良好；Motion Strength=5 有中等变形风险\",\n \"DEFECT_LOG\": \"（用户返回后填写）\"\n}\n```\n\n### 图片模式 (Seedream 4.x/5.x)\n```json\n{\n \"IMAGE_PROMPT\": \"一个穿着华丽服装的女孩，撑着遮阳伞走在林荫道上，莫奈油画风格\",\n \"TEXT_CONTENT\": \"\\\"Seedream 4.5\\\"\",\n \"MODE\": \"电影创意探索\",\n \"PLATFORM\": \"Seedream 4.5\"\n}\n```\n\n## 加入群聊\n\n\n
![\"XSkill\"](\"https://qomob.ai/xskill.jpg\")
\n
\nMad Story helps agents design cinematic storyboards and media-generation prompts for video and image workflows, including Seedance video prompts, Seedream image prompts, and short-drama planning.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[qomob](https://clawhub.ai/user/qomob)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal creators, marketers, directors, and production teams use this skill to turn concepts, product briefs, reference images, or short-drama ideas into storyboard plans and structured prompts for supported video and image generation platforms.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Advanced modes may be incomplete if referenced helper files are not available with the installed skill.
\nMitigation: Confirm the referenced files are packaged before relying on advanced modes, or use the core SKILL.md workflows only.
\nRisk: Generated prompts are calibrated for Seedance 2.0 video and Seedream 4.x/5.x image workflows, while other platforms may require manual parameter adaptation.
\nMitigation: Verify the target platform and adjust platform-specific parameters before production use.
\nRisk: Generated media can still show long-duration quality loss, motion instability, or cross-shot character inconsistency.
\nMitigation: Review generated outputs manually, keep complex shots shorter where possible, and regenerate or revise prompts when consistency checks fail.
\n\n\n## Reference(s):
\n- [Server-resolved GitHub source repository](https://github.com/qomob/madstory)
\n- [ClawHub skill page](https://clawhub.ai/qomob/skills/madstory)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Guidance, Configuration]
\n**Output Format:** [Markdown storyboard plans with structured prompt blocks and platform parameter guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include sections such as STANDARD_PROMPT, NEGATIVE_PROMPT, TIMELINE, CAMERA, MOTION_STRENGTH, IMAGE_PROMPT, TEXT_CONTENT, and platform-specific settings.]
\n\n## Skill Version(s):
\n3.4.3 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v3.4.2: 3 files, 6497 bytes\n\nFiles: skill-card.md (2326b), SKILL.md (11433b), _meta.json (127b)\n\nFile v3.4.2:SKILL.md\n\n---\nname: mad-story\ndescription: \"电影级影视分镜设计引擎，支持视频生成(Seedance/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。9种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设。不适用于纯静态视觉设计或非分镜用途的通用AI绘画。\"\nversion: 3.5.0\nauthor: qomob.ai\nlicense: MIT\nmodes: 9\nphases: 8\nplatforms:\n - Trae IDE\n - OpenClaw\n - Dify\n - Coze\n - Claude Desktop / MCP\nreferences:\n - references/modes_detail.md\n - references/phases_detail.md\n - references/prompt_engineering.md\n - references/seedance_v2_rules.md\n - references/seedream_4x_rules.md\n - references/terminology.md\n - references/pre_flight_checklist.md\n - references/short_drama_consistency.md\n - references/short_drama_genres.md\nassets:\n - assets/cheat_sheet.json\n - assets/storyboard_template.html\n - assets/cs_core.json\n - assets/cs_cinematic.json\n - assets/cs_drama.json\n - assets/cs_narrative.json\n - assets/cs_sound.json\n---\n\n# MadStory — 电影级影视分镜设计引擎 v3.5.0 (分层加载架构)\n\n## 技能定位\n\nMadStory 是面向电影级内容生产的专业分镜设计引擎，同时支持 **Seedream 4.x/5.x 图片生成**（文生图、图像编辑、参考图生图、多图输入/输出）。\n\n- **触发词**: `影视分镜`, `分镜设计`, `电影分镜`, `广告分镜`, `电商视频`, `UGC广告`, `品牌短片`, `多镜头叙事`, `一镜到底`, `爆款复刻`, `短剧创作`, `从一句话出片`, `AI电影`, `AI视频生成`, `Seedance`, `Seedream`, `分镜脚本`, `视频提示词`, `文生图`, `图生图`, `图像编辑`, `参考图生图`, `短剧剧本`, `微短剧`, `竖屏剧`, `AI短剧`, `短剧分镜`, `短剧编剧`, `锁脸`, `小说改短剧`, `漫剧`, `角色人设`\n- **目标用户**: 电影导演、广告导演、创意总监、影视制作人、电商运营、品牌营销、内容创作者、短剧制作人、零基础创作者、平面设计师\n- **默认时长**: 15 秒 / 镜头（视频），图片模式无时长限制\n- **支持平台**: Seedance 2.0 / Runway / Kling / Sora (视频), Seedream 4.x/5.x (图片)\n\n## 分层加载架构 (Progressive Loading)\n\n> **核心原则**: SKILL.md 始终加载。其他资源按交互阶段按需加载。\n\n## 模式状态看板（启发）\n\n> 9 种创作模式并行或串行执行时，用户需要看到每个模式的状态——哪个在推导、哪个在生成、哪个已完成。\n\n```\n🎬 分镜状态看板\n├── [Mode 选择] ✅ 已完成 — {模式名}\n├── [Phase 0-7] 🟡 推导中 — 当前 Phase {N}\n├── [提示词生成] 🔵 等待中\n└── [Pre-flight 预检] 🔵 等待中\n```\n\n多模式串行（如短剧全链路：剧本→分镜→提示词→生成）时，看板展示每个阶段的独立状态。用户可随时说\"看板\"查看当前进度。\n\n### Layer 0: 始终加载 (本文件)\n- 元数据 + 触发词 + 技能定位\n- 9 模式概览表\n- Phase 0-7 阶段名称\n- 输出规范 + 质量门禁\n- 分层加载索引\n\n### Layer 1: 按需加载\n以下资源在对应触发条件满足时读取文件内容:\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| 用户确认/选择模式 | `references/modes_detail.md` | 该模式的完整说明、约束、护栏 |\n| 进入 Phase N 推导 | `references/phases_detail.md` | Phase N 的详细推导指引 |\n| 生成/校验提示词 | `references/prompt_engineering.md` | 5层结构、Negative Prompt模板、多镜头/一镜到底/复刻语法 |\n| 需要精确镜头术语 | `references/terminology.md` | 影视专业术语库 |\n| 分镜方案输出前检查 | `references/pre_flight_checklist.md` | 导演级预检清单 + **元反思（8 维度推演过程自检）** |\n| 需要平台参数参考 | `references/seedance_v2_rules.md` | Seedance 2.0 提示词工程规范 |\n| 使用 Seedream 4.x/5.x 或涉及图片生成 | `references/seedream_4x_rules.md` | Seedream 4.x/5.x 文生图/图像编辑/参考图/多图规则 |\n| 短剧 + 需要题材灵感/爆款分析 | `references/short_drama_genres.md` | 6大题材模板与10集标准结构、爆款套路 |\n\n### Layer 2: 深度加载（高级场景触发）\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| 短剧 + 多场景/多集 | `references/short_drama_consistency.md` | 短剧全流程一致性管控、角色卡、八要素公式、小说改编流程 |\n| 要求电影级镜头语言 | `assets/cheat_sheet.json` → `cinematic_camera_language` + `cinematic_lighting_extended` | 运镜/构图/布光预设 |\n| 要求声音设计 | `assets/cheat_sheet.json` → `cinematic_sound_extended` | 声音分层 + 情感映射 |\n| 要求导演风格参考 | `assets/cheat_sheet.json` → `director_style_references` + `creative_film_prompts_library` | 大师风格库 |\n| HTML 可视化 | `assets/storyboard_template.html` | 分镜预览模板 |\n\n## 9 种创作模式概览\n\n| # | 模式 | 场景 | 输入 | 核心约束 |\n|---|------|------|------|---------|\n| 0 | 电影创意探索 | 概念开发、风格实验 | Text | Generate-and-Filter + Tournament |\n| 1 | 电商产品 | 商品详情页、主图动效 | Image | 产品不变形、标签可读 |\n| 2 | UGC 原生广告 | 信息流、口播、种草 | Reference | 人脸一致、手势自然 |\n| 3 | 电影感品牌短片 | 品牌故事、预告 | Text/Image | 镜头有意图、灯光有逻辑 |\n| 4 | 多镜头叙事 | 完整叙事弧线 | Reference | ≤3镜头/次，跨镜头一致 |\n| 5 | 一镜到底 | 空间巡游、沉浸展示 | Image序列 | 2-10图，空间连续 |\n| 6 | 爆款复刻 | 灵感翻拍、竞品复刻 | Reference+Image | 风格还原、主体替换 |\n| 7 | Agent 模式 | 一句话到成片 | Text | 自动意图解析+路径规划 |\n| 8 | 短剧创作 | AI短剧、漫剧、小说改编 | Reference+Script | 跨集角色一致、>15s一致性管控 |\n\n> 模式详情见 `references/modes_detail.md`\n\n## 分镜推导阶段 (Phase 0-7)\n\n| Phase | 名称 | 产出 |\n|-------|------|------|\n| 0 | 模式选择与意图澄清 | Mode 确认 + 输入策略 |\n| 1 | 核心创意锁定 | Subject + Action |\n| 2 | 时间轴与节奏 | Timeline + 关键帧 |\n| 3 | 视觉构图 | Composition + 画幅 |\n| 4 | 镜头运动 | Camera + Motion Strength |\n| 5 | 光影与质感 | Lighting + 风格预设 |\n| 6 | 声音设计 | Sound + BGM |\n| 7 | 最终合成与输出 | 完整提示词 + Negative Prompt |\n\n> Phase 详情见 `references/phases_detail.md`\n\n## 交互准则\n- **逐阶段推进**: 每次只推进一个 Phase，不跳过\n- **用专业术语但让外行听懂**: 提供选项卡片\n- **实时展示草稿**: 每完成一个 Phase 展示当前草案\n- **主动拦截**: 用户塞入过多信息时建议拆分\n- **模式引导**: Phase 0 必须确认模式\n- **负向提示词自动注入**: 由系统按 Mode 自动生成\n- **质量自检**: 输出前对关键约束自查\n- **图片模式**: 启用 Seedream 规则时自动切换输出格式\n\n## 输出规范\n\n### 视频模式输出 (Seedance/Runway/Kling/Sora)\n每个分镜方案必须包含:\n1. **STANDARD_PROMPT**: 符合 5 层结构的完整正向提示词\n2. **NEGATIVE_PROMPT**: 按 Mode 自动生成的负向提示词\n3. **TIMELINE**: 15 秒时间轴 + 关键帧描述\n4. **CAMERA**: 逐秒/逐镜头运动描述\n5. **MOTION_STRENGTH**: 建议值 (1-10)\n6. **DURATION**: 固定 15s（或按多镜头分配）\n7. **MODE**: 模式标签\n8. **MULTI_MODAL_ADVICE**: 参考图/视频/音频建议\n9. **SHOT_LIST** (多镜头模式): 分镜头脚本表\n\n### 图片模式输出 (Seedream 4.x/5.x)\n> 完整规则见 `references/seedream_4x_rules.md`\n\n每个图片方案必须包含:\n1. **IMAGE_PROMPT**: 符合 3 层结构（主体+行为+环境，风格/色彩/光影/构图补充）\n2. **TEXT_CONTENT**: 需渲染的文字（双引号包裹）\n3. **REFERENCE_TYPE**: 参考类型（人物形象/风格/虚拟实体/款式/无）\n4. **EDIT_OPERATION**: 编辑操作（增加/删除/替换/修改/无）\n5. **MULTI_IMAGE_OP**: 多图操作（替换/组合/迁移/无）\n6. **MODE**: 模式标签\n7. **PLATFORM**: Seedream 4.x/5.x\n\n## 质量门禁 (Quality Gates)\n\n### 视频模式\n\n| 门禁 | 触发条件 | 不合格判定 |\n|------|---------|-----------|\n| **产品安全** | Ecommerce 模式 | 产品标签不可读或变形 → 不合格 |\n| **人脸一致性** | UGC / Short Drama 模式 | 人脸在两个镜头间不一致 → 不合格 |\n| **单运动原则** | 任何 Mode | 一个镜头内超过 1 个主导运动 → 不合格 |\n| **负向提示词** | 任何 Mode | 缺少 Negative Prompt → 不合格 |\n| **镜头数量** | Multi-shot 模式 | 单次生成 > 3 个镜头 → 不合格 |\n| **空间连续性** | One-Shot 模式 | 跳帧或空间断裂 → 不合格 |\n| **风格还原** | Viral Replicate 模式 | 风格偏离参考 → 不合格 |\n| **意图解析** | Agent 模式 | 意图完全偏离 → 不合格 |\n| **跨集一致** | Short Drama 模式 | 角色跨集不一致 → 不合格 |\n\n### 图片模式 (Seedream 4.x/5.x)\n\n| 门禁 | 不合格判定 |\n|------|-----------|\n| **文字包裹** | 文字内容未用双引号包裹 → 不合格 |\n| **指令指代** | 编辑指令使用代词而非具体对象 → 不合格 |\n| **参考图描述** | 未指明参考对象和生成画面 → 不合格 |\n| **多图角色** | 多图输入未明确图一/图二角色分配 → 不合格 |\n\n> 短剧一致性管控详见 `references/short_drama_consistency.md`\n\n## 目录结构\n\n```text\nmad-story/\n├── SKILL.md # 技能定义 v3.4.1 — 分层加载/双模式输出\n├── README.md # 使用说明\n├── references/\n│ ├── modes_detail.md # 9种模式详细说明 (Layer 1)\n│ ├── phases_detail.md # Phase 0-7 详细推导指引 (Layer 1)\n│ ├── prompt_engineering.md # 视频提示词5层结构+Negative Prompt (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范 (Layer 1)\n│ ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)\n│ ├── terminology.md # 影视分镜专业术语库 (Layer 1)\n│ ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度） (Layer 1)\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)\n│ ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表 — 镜头语言/光影/声音/导演参考\n ├── cs_core.json # 核心数据资产\n ├── cs_cinematic.json # 电影感数据\n ├── cs_drama.json # 短剧数据\n ├── cs_narrative.json # 叙事结构数据\n ├── cs_sound.json # 声音设计数据\n └── storyboard_template.html # 分镜预览模板\n```\n\n> 独立工具包（CLI/API/验证）位于 `tools/mad-story-scripts/`，非技能运行时必需。\n\nFile v3.4.2:_meta.json\n\n{\n \"ownerId\": \"kn72r3ww47r1qyfaf233sf7q1982rh5f\",\n \"slug\": \"madstory\",\n \"version\": \"3.4.2\",\n \"publishedAt\": 1783657913212\n}\n\nFile v3.4.2:skill-card.md\n\n## Description:
\nMad Story is a Chinese-language cinematic storyboard design workflow for generating structured prompts and shot plans for video and image models across nine creation modes.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[qomob](https://clawhub.ai/user/qomob)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal creators, marketers, directors, and developers use Mad Story to plan cinematic storyboards, short-drama sequences, ecommerce or UGC ads, and image or video generation prompts through phased mode selection and quality checks.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Broad creative image or video requests may activate this skill outside the user's intended workflow.
\nMitigation: Confirm the user's intent and selected storyboard mode before producing prompts or shot plans.
\nRisk: The published artifact appears to omit referenced support files, so advanced workflows may be incomplete.
\nMitigation: Use only the bundled artifact content when support files are unavailable and tell the user when an advanced mode depends on missing material.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/qomob/skills/madstory)
\n- [Publisher profile](https://clawhub.ai/user/qomob)
\n- [Server-resolved GitHub repository](https://github.com/qomob/madstory)
\n- [Artifact skill definition](artifact/SKILL.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, guidance, configuration]
\n**Output Format:** [Structured Markdown prompts, storyboard plans, shot lists, timelines, negative prompts, and image generation prompt fields]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Outputs vary by mode and may include video storyboard fields, image prompt fields, quality checks, and multimodal advice.]
\n\n## Skill Version(s):
\n3.4.2 (source: server release metadata; artifact frontmatter reports 3.5.0)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v3.4.1: 23 files, 85660 bytes\n\nFiles: assets/cheat_sheet.json (27777b), assets/cs_cinematic.json (8281b), assets/cs_core.json (5134b), assets/cs_drama.json (6082b), assets/cs_narrative.json (3231b), assets/cs_sound.json (2231b), assets/storyboard_template.html (13941b), README.md (9011b), references/examples/example_1_creative_film.md (4667b), references/examples/example_2_multi_shot.md (2907b), references/examples/example_3_short_drama.md (1860b), references/modes_detail.md (6468b), references/phases_detail.md (4001b), references/pre_flight_checklist.md (7145b), references/prompt_engineering.md (4909b), references/seedance_v2_rules.md (11070b), references/seedream_4x_rules.md (10888b), references/short_drama_consistency.md (18608b), references/short_drama_genres.md (7428b), references/terminology.md (13400b), skill-card.md (2890b), SKILL.md (10748b), _meta.json (127b)\n\nFile v3.4.1:SKILL.md\n\n---\nname: mad-story\ndescription: \"电影级影视分镜设计引擎，支持视频生成(Seedance/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。9种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设。不适用于纯静态视觉设计或非分镜用途的通用AI绘画。\"\nversion: 3.4.1\nauthor: qomob.ai\nlicense: MIT\nmodes: 9\nphases: 8\nplatforms:\n - Trae IDE\n - OpenClaw\n - Dify\n - Coze\n - Claude Desktop / MCP\nreferences:\n - references/modes_detail.md\n - references/phases_detail.md\n - references/prompt_engineering.md\n - references/seedance_v2_rules.md\n - references/seedream_4x_rules.md\n - references/terminology.md\n - references/pre_flight_checklist.md\n - references/short_drama_consistency.md\n - references/short_drama_genres.md\nassets:\n - assets/cheat_sheet.json\n - assets/storyboard_template.html\n - assets/cs_core.json\n - assets/cs_cinematic.json\n - assets/cs_drama.json\n - assets/cs_narrative.json\n - assets/cs_sound.json\n---\n\n# MadStory — 电影级影视分镜设计引擎 v3.4.1 (分层加载架构)\n\n## 技能定位\n\nMadStory 是面向电影级内容生产的专业分镜设计引擎，同时支持 **Seedream 4.x/5.x 图片生成**（文生图、图像编辑、参考图生图、多图输入/输出）。\n\n- **触发词**: `影视分镜`, `分镜设计`, `电影分镜`, `广告分镜`, `电商视频`, `UGC广告`, `品牌短片`, `多镜头叙事`, `一镜到底`, `爆款复刻`, `短剧创作`, `从一句话出片`, `AI电影`, `AI视频生成`, `Seedance`, `Seedream`, `分镜脚本`, `视频提示词`, `文生图`, `图生图`, `图像编辑`, `参考图生图`, `短剧剧本`, `微短剧`, `竖屏剧`, `AI短剧`, `短剧分镜`, `短剧编剧`, `锁脸`, `小说改短剧`, `漫剧`, `角色人设`\n- **目标用户**: 电影导演、广告导演、创意总监、影视制作人、电商运营、品牌营销、内容创作者、短剧制作人、零基础创作者、平面设计师\n- **默认时长**: 15 秒 / 镜头（视频），图片模式无时长限制\n- **支持平台**: Seedance 2.0 / Runway / Kling / Sora (视频), Seedream 4.x/5.x (图片)\n\n## 分层加载架构 (Progressive Loading)\n\n> **核心原则**: SKILL.md 始终加载。其他资源按交互阶段按需加载。\n\n### Layer 0: 始终加载 (本文件)\n- 元数据 + 触发词 + 技能定位\n- 9 模式概览表\n- Phase 0-7 阶段名称\n- 输出规范 + 质量门禁\n- 分层加载索引\n\n### Layer 1: 按需加载\n以下资源在对应触发条件满足时读取文件内容:\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| 用户确认/选择模式 | `references/modes_detail.md` | 该模式的完整说明、约束、护栏 |\n| 进入 Phase N 推导 | `references/phases_detail.md` | Phase N 的详细推导指引 |\n| 生成/校验提示词 | `references/prompt_engineering.md` | 5层结构、Negative Prompt模板、多镜头/一镜到底/复刻语法 |\n| 需要精确镜头术语 | `references/terminology.md` | 影视专业术语库 |\n| 分镜方案输出前检查 | `references/pre_flight_checklist.md` | 导演级预检清单 |\n| 需要平台参数参考 | `references/seedance_v2_rules.md` | Seedance 2.0 提示词工程规范 |\n| 使用 Seedream 4.x/5.x 或涉及图片生成 | `references/seedream_4x_rules.md` | Seedream 4.x/5.x 文生图/图像编辑/参考图/多图规则 |\n| 短剧 + 需要题材灵感/爆款分析 | `references/short_drama_genres.md` | 6大题材模板与10集标准结构、爆款套路 |\n\n### Layer 2: 深度加载（高级场景触发）\n\n| 触发条件 | 加载文件 | 内容 |\n|---------|---------|------|\n| 短剧 + 多场景/多集 | `references/short_drama_consistency.md` | 短剧全流程一致性管控、角色卡、八要素公式、小说改编流程 |\n| 要求电影级镜头语言 | `assets/cheat_sheet.json` → `cinematic_camera_language` + `cinematic_lighting_extended` | 运镜/构图/布光预设 |\n| 要求声音设计 | `assets/cheat_sheet.json` → `cinematic_sound_extended` | 声音分层 + 情感映射 |\n| 要求导演风格参考 | `assets/cheat_sheet.json` → `director_style_references` + `creative_film_prompts_library` | 大师风格库 |\n| HTML 可视化 | `assets/storyboard_template.html` | 分镜预览模板 |\n\n## 9 种创作模式概览\n\n| # | 模式 | 场景 | 输入 | 核心约束 |\n|---|------|------|------|---------|\n| 0 | 电影创意探索 | 概念开发、风格实验 | Text | Generate-and-Filter + Tournament |\n| 1 | 电商产品 | 商品详情页、主图动效 | Image | 产品不变形、标签可读 |\n| 2 | UGC 原生广告 | 信息流、口播、种草 | Reference | 人脸一致、手势自然 |\n| 3 | 电影感品牌短片 | 品牌故事、预告 | Text/Image | 镜头有意图、灯光有逻辑 |\n| 4 | 多镜头叙事 | 完整叙事弧线 | Reference | ≤3镜头/次，跨镜头一致 |\n| 5 | 一镜到底 | 空间巡游、沉浸展示 | Image序列 | 2-10图，空间连续 |\n| 6 | 爆款复刻 | 灵感翻拍、竞品复刻 | Reference+Image | 风格还原、主体替换 |\n| 7 | Agent 模式 | 一句话到成片 | Text | 自动意图解析+路径规划 |\n| 8 | 短剧创作 | AI短剧、漫剧、小说改编 | Reference+Script | 跨集角色一致、>15s一致性管控 |\n\n> 模式详情见 `references/modes_detail.md`\n\n## 分镜推导阶段 (Phase 0-7)\n\n| Phase | 名称 | 产出 |\n|-------|------|------|\n| 0 | 模式选择与意图澄清 | Mode 确认 + 输入策略 |\n| 1 | 核心创意锁定 | Subject + Action |\n| 2 | 时间轴与节奏 | Timeline + 关键帧 |\n| 3 | 视觉构图 | Composition + 画幅 |\n| 4 | 镜头运动 | Camera + Motion Strength |\n| 5 | 光影与质感 | Lighting + 风格预设 |\n| 6 | 声音设计 | Sound + BGM |\n| 7 | 最终合成与输出 | 完整提示词 + Negative Prompt |\n\n> Phase 详情见 `references/phases_detail.md`\n\n## 交互准则\n- **逐阶段推进**: 每次只推进一个 Phase，不跳过\n- **用专业术语但让外行听懂**: 提供选项卡片\n- **实时展示草稿**: 每完成一个 Phase 展示当前草案\n- **主动拦截**: 用户塞入过多信息时建议拆分\n- **模式引导**: Phase 0 必须确认模式\n- **负向提示词自动注入**: 由系统按 Mode 自动生成\n- **质量自检**: 输出前对关键约束自查\n- **图片模式**: 启用 Seedream 规则时自动切换输出格式\n\n## 输出规范\n\n### 视频模式输出 (Seedance/Runway/Kling/Sora)\n每个分镜方案必须包含:\n1. **STANDARD_PROMPT**: 符合 5 层结构的完整正向提示词\n2. **NEGATIVE_PROMPT**: 按 Mode 自动生成的负向提示词\n3. **TIMELINE**: 15 秒时间轴 + 关键帧描述\n4. **CAMERA**: 逐秒/逐镜头运动描述\n5. **MOTION_STRENGTH**: 建议值 (1-10)\n6. **DURATION**: 固定 15s（或按多镜头分配）\n7. **MODE**: 模式标签\n8. **MULTI_MODAL_ADVICE**: 参考图/视频/音频建议\n9. **SHOT_LIST** (多镜头模式): 分镜头脚本表\n\n### 图片模式输出 (Seedream 4.x/5.x)\n> 完整规则见 `references/seedream_4x_rules.md`\n\n每个图片方案必须包含:\n1. **IMAGE_PROMPT**: 符合 3 层结构（主体+行为+环境，风格/色彩/光影/构图补充）\n2. **TEXT_CONTENT**: 需渲染的文字（双引号包裹）\n3. **REFERENCE_TYPE**: 参考类型（人物形象/风格/虚拟实体/款式/无）\n4. **EDIT_OPERATION**: 编辑操作（增加/删除/替换/修改/无）\n5. **MULTI_IMAGE_OP**: 多图操作（替换/组合/迁移/无）\n6. **MODE**: 模式标签\n7. **PLATFORM**: Seedream 4.x/5.x\n\n## 质量门禁 (Quality Gates)\n\n### 视频模式\n\n| 门禁 | 触发条件 | 不合格判定 |\n|------|---------|-----------|\n| **产品安全** | Ecommerce 模式 | 产品标签不可读或变形 → 不合格 |\n| **人脸一致性** | UGC / Short Drama 模式 | 人脸在两个镜头间不一致 → 不合格 |\n| **单运动原则** | 任何 Mode | 一个镜头内超过 1 个主导运动 → 不合格 |\n| **负向提示词** | 任何 Mode | 缺少 Negative Prompt → 不合格 |\n| **镜头数量** | Multi-shot 模式 | 单次生成 > 3 个镜头 → 不合格 |\n| **空间连续性** | One-Shot 模式 | 跳帧或空间断裂 → 不合格 |\n| **风格还原** | Viral Replicate 模式 | 风格偏离参考 → 不合格 |\n| **意图解析** | Agent 模式 | 意图完全偏离 → 不合格 |\n| **跨集一致** | Short Drama 模式 | 角色跨集不一致 → 不合格 |\n\n### 图片模式 (Seedream 4.x/5.x)\n\n| 门禁 | 不合格判定 |\n|------|-----------|\n| **文字包裹** | 文字内容未用双引号包裹 → 不合格 |\n| **指令指代** | 编辑指令使用代词而非具体对象 → 不合格 |\n| **参考图描述** | 未指明参考对象和生成画面 → 不合格 |\n| **多图角色** | 多图输入未明确图一/图二角色分配 → 不合格 |\n\n> 短剧一致性管控详见 `references/short_drama_consistency.md`\n\n## 目录结构\n\n```text\nmad-story/\n├── SKILL.md # 技能定义 v3.4.1 — 分层加载/双模式输出\n├── README.md # 使用说明\n├── references/\n│ ├── modes_detail.md # 9种模式详细说明 (Layer 1)\n│ ├── phases_detail.md # Phase 0-7 详细推导指引 (Layer 1)\n│ ├── prompt_engineering.md # 视频提示词5层结构+Negative Prompt (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范 (Layer 1)\n│ ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)\n│ ├── terminology.md # 影视分镜专业术语库 (Layer 1)\n│ ├── pre_flight_checklist.md # 导演级预检清单 (Layer 1)\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)\n│ ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表 — 镜头语言/光影/声音/导演参考\n ├── cs_core.json # 核心数据资产\n ├── cs_cinematic.json # 电影感数据\n ├── cs_drama.json # 短剧数据\n ├── cs_narrative.json # 叙事结构数据\n ├── cs_sound.json # 声音设计数据\n └── storyboard_template.html # 分镜预览模板\n```\n\n> 独立工具包（CLI/API/验证）位于 `tools/mad-story-scripts/`，非技能运行时必需。\n\nFile v3.4.1:README.md\n\n# MadStory: 电影级影视分镜设计引擎 v3.4.1\n\n[](https://opensource.org/licenses/MIT)\n[](https://qomob.ai)\n[](https://clawhub.ai/qomob/mad-story)\n\n**MadStory v3.4.1** 是一款电影级影视分镜设计引擎，支持多平台视频生成（Seedance / Runway / Kling / Sora）及图片生成（Seedream 4.x/5.x）。能将模糊的电影构思，通过 8 阶段专业推导流程，逐步转化为包含构图、运镜、光影、声音等全维度细节的专业分镜提示词。\n\n## v3.4.1 更新内容\n\n- **新增 焦段→情绪决策表** (`references/terminology.md`): 24/35/50/85/135mm 焦段与情绪暗示、适用 Mode 的映射，补齐摄影指导选焦段的决策依据\n- **新增 剪辑技巧库** (`assets/cheat_sheet.json` → `editing_techniques`): L-Cut / J-Cut / Jump Cut / Match Cut / Smash Cut / Montage 六种剪辑手法的提示词模板，补齐 15s 短片节奏设计的术语缺口\n\n## 核心特性\n\n- **9 种创作模式**: 电影创意探索 / 电商产品 / UGC 原生广告 / 电影感品牌短片 / 多镜头叙事 / 一镜到底 / 爆款复刻 / Agent 全链路创作 / 短剧批量生产\n- **8 阶段推导流程 (Phase 0-7)**: 从模式选择到最终合成，逐阶段引导\n- **双模式输出**: 视频模式（5层提示词结构 + Negative Prompt）与图片模式（3层结构 + 文字渲染 + 图像编辑语法）独立定义\n- **双模式质量门禁**: 视频模式与图片模式分别定义不合格判定条件\n- **分层加载架构**: SKILL.md 始终加载，参考文献按交互阶段按需加载\n- **短剧一致性管控**: 角色档案 + 场景清单 + 时间线轴 + 四阶段验收\n- **电影级数据资产**: 导演风格参考 / 镜头语言 / 光影预设 / 声音设计 / 叙事结构\n\n## 9 种创作模式\n\n| 模式 | 适用场景 | 输入方式 | 核心约束 / 工作流 |\n|------|---------|----------|------------------|\n| **电影创意探索** | 概念开发、风格实验、艺术短片、品牌概念片 | Text-to-Video | Generate-and-Filter + Tournament 筛选 |\n| **电商产品** | 商品详情页、主图动效、付费素材 | Image-to-Video | 产品几何不变形、标签可读 |\n| **UGC 原生广告** | 信息流投放、口播、种草测评 | Reference-to-Video | 人脸一致、手势自然 |\n| **电影感品牌短片** | 品牌故事片、发布预告 | Text-to-Video | 镜头意图明确、灯光有逻辑 |\n| **多镜头叙事** | 完整叙事弧线、品牌故事 | Reference-to-Video | ≤3 镜头/次生成，跨镜头一致 |\n| **一镜到底** | 产品体验、空间巡游 | Image-to-Video | 2-10 张图片，空间连续 |\n| **爆款复刻** | 灵感来源、竞品翻拍 | Reference-to-Video | 风格还原、主体替换自然 |\n| **Agent 模式** | 零基础创作、有脚本/素材 | Text-to-Video | 一句话到成片，自动规划 |\n| **短剧创作** | AI 短剧生产、漫剧、小说改编 | Reference-to-Video | 跨集角色一致、>15s 一致性管控 |\n\n## 分镜推导流程 (Phase 0-7)\n\n| Phase | 内容 | 产出 |\n|-------|------|------|\n| **Phase 0** | 模式选择与意图澄清 | Mode 确认 + 输入策略 |\n| **Phase 1** | 核心创意锁定 | Subject + Action 描述 |\n| **Phase 2** | 时间轴与节奏 | Timeline 描述 + 关键帧 |\n| **Phase 3** | 视觉构图 | Composition + 画幅建议 |\n| **Phase 4** | 镜头运动 | Camera 描述 + Motion Strength |\n| **Phase 5** | 光影与质感 | Lighting + 风格预设 |\n| **Phase 6** | 声音设计 | Sound + BGM 建议 |\n| **Phase 7** | 最终合成与参数输出 | 完整提示词 + Negative Prompt + 多模态建议 |\n\n## 目录结构\n\n```text\nmad-story/\n├── SKILL.md # 技能定义 v3.4.1 — 分层加载/双模式输出\n├── README.md # 本文件\n├── references/\n│ ├── modes_detail.md # 9种模式详细说明 (Layer 1)\n│ ├── phases_detail.md # Phase 0-7 详细推导指引 (Layer 1)\n│ ├── prompt_engineering.md # 视频提示词5层结构+Negative Prompt (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范 (Layer 1)\n│ ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)\n│ ├── terminology.md # 影视分镜专业术语库 (Layer 1)\n│ ├── pre_flight_checklist.md # 导演级预检清单 (Layer 1)\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)\n│ ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表 — 镜头语言/光影/声音/导演参考\n ├── cs_core.json # 核心数据资产\n ├── cs_cinematic.json # 电影感数据\n ├── cs_drama.json # 短剧数据\n ├── cs_narrative.json # 叙事结构数据\n ├── cs_sound.json # 声音设计数据\n └── storyboard_template.html # 分镜预览模板\n```\n\n> 独立工具包（CLI/API/验证）位于 `tools/mad-story-scripts/`，非技能运行时必需，按需使用。\n\n## 如何使用\n\n### 作为 AI Skill 触发\n在 AI 助手中输入触发词即可：\n`MadStory` / `影视分镜` / `分镜设计` / `电影分镜` / `广告分镜` / `电商视频` / `UGC广告` / `品牌短片` / `多镜头叙事` / `一镜到底` / `爆款复刻` / `短剧创作` / `从一句话出片` / `AI电影` / `AI视频生成` / `Seedance` / `Seedream` / `分镜脚本` / `视频提示词` / `文生图` / `图生图` / `图像编辑` / `参考图生图` / `短剧剧本` / `微短剧` / `竖屏剧` / `AI短剧` / `短剧分镜` / `短剧编剧` / `锁脸` / `小说改短剧` / `漫剧` / `角色人设`\n\n### 用户能力分级\n| 层级 | 推荐模式 | 使用路径 |\n|------|---------|---------|\n| **L1 入门** | Agent 模式 | 输入一句话 → 自动拆解 → 生成分镜方案 |\n| **L2 基础** | 电商 / UGC | Phase 0-7 填空式引导 → 选项卡片 |\n| **L3 进阶** | 多镜头 / 一镜到底 / 爆款复刻 | 手动编排多镜头序列 / 转场设计 |\n| **L4 专业** | 电影感 / 短剧 | 全参数可控、多剧集批量 |\n| **L5 导演级** | 所有模式 | 全链路创作、一致性管控 |\n\n### CLI 工具包（独立部署）\n独立工具包位于 `tools/mad-story-scripts/`，提供 CLI 批量生成、REST API 服务、质量校验等功能：\n```bash\ncd tools/mad-story-scripts/\npip install -r requirements.txt # 仅 API 模式需要\npython3 mad_story_engine.py --interactive\npython3 api_server.py --port 8787\n```\n\n## 短剧一致性管控方案\n\n针对单集 3~5 分钟短剧，单条 >15s 拍摄脚本自动启用全流程一致性管控：\n\n| 阶段 | 管控内容 |\n|------|---------|\n| **前期筹备** | 人物设定档案（外观/性格/行为/台词/时间线）、场景全景清单（空间/陈设/光线/色温/噪音/道具）、全片时间线轴（>15s 自动拆分标记） |\n| **拍摄执行** | 开拍前对照核查、每 10~12s 校验节点 + Reference Frame、环境参数同步留存 |\n| **后期制作** | 剪辑逐帧核查、调色统一、音轨对齐 |\n| **最终验收** | 人物外观无矛盾 / 行为逻辑无冲突 / 场景空间无冲突 / 拼接自然（4 项硬性标准） |\n\n## 示例输出\n\n### 视频模式\n```json\n{\n \"STANDARD_PROMPT\": \"雨夜赛博武士穿行霓虹街道，侧面跟拍，快速可控节奏，反光水洼，电影感红蓝对比色调\",\n \"NEGATIVE_PROMPT\": \"no shaky camera, no object melting, no random text, no muddy lighting, no flat blacks\",\n \"TIMELINE\": \"0-5s intro, 5-12s core action, 12-15s ending\",\n \"CAMERA\": \"Second-by-second: 0-5s intro, 5-12s core action, 12-15s ending. Camera: side tracking dolly shot.\",\n \"MOTION_STRENGTH\": 5,\n \"DURATION\": \"15s\",\n \"MODE\": \"电影感品牌短片\",\n \"MODE_KEY\": \"cinematic\",\n \"MULTI_MODAL_ADVICE\": \"建议上传具有相似色调和光位的高质量参考图以获得最佳光效\",\n \"SOUND_DESIGN\": \"ambient drone\",\n \"SHOT_LIST\": []\n}\n```\n\n### 图片模式 (Seedream 4.x/5.x)\n```json\n{\n \"IMAGE_PROMPT\": \"一个穿着华丽服装的女孩，撑着遮阳伞走在林荫道上，莫奈油画风格，柔和光影，印象派色彩\",\n \"TEXT_CONTENT\": \"\\\"Seedream 4.5\\\"\",\n \"REFERENCE_TYPE\": \"无\",\n \"EDIT_OPERATION\": \"无\",\n \"MULTI_IMAGE_OP\": \"无\",\n \"MODE\": \"电影创意探索\",\n \"PLATFORM\": \"Seedream 4.5\"\n}\n```\n\n## 许可证\n\n本项目采用 [MIT License](https://opensource.org/licenses/MIT) 开源协议。\n\n---\n**MadStory v3.4.1** — 电影级影视分镜设计引擎 | Created by **[qomob.ai](https://qomob.ai)** | [Install on ClawHub](https://clawhub.ai/qomob/mad-story)\n\nFile v3.4.1:_meta.json\n\n{\n \"ownerId\": \"kn72r3ww47r1qyfaf233sf7q1982rh5f\",\n \"slug\": \"madstory\",\n \"version\": \"3.4.1\",\n \"publishedAt\": 1781668128719\n}\n\nFile v3.4.1:references/examples/example_1_creative_film.md\n\n# 案例 1: 电影创意探索 — 《城市孤岛》概念短片\n> **Mode**: `creative_film` (Mode 0) | **平台**: Seedance 3.0 | **时长**: 30s | **风格**: 塔可夫斯基式诗意现实主义\n\n## 用户输入 (Raw Input)\n\n```\n我想做一个关于\"城市里孤独的人\"的短视频，要有电影感，不要太俗套的那种。\n```\n\n## 分镜推导过程\n\n### 创意方向筛选\n\n引擎并行生成 3 个创意方向，通过评分矩阵筛选：\n\n| 方向 | 导演参照 | 视觉核心 | 情绪弧线 | 评分 |\n|------|---------|---------|---------|------|\n| A: 雨夜窗景 | 王家卫 | 湿玻璃反射 + 霓虹虚化 | 孤独→温暖(?) | 6.5 |\n| B: 地铁长镜头 | 贾樟柯 | 手持跟拍 + 人群流动 | 疏离→融入→疏离 | 8.2 |\n| C: 废墟花园 | 塔可夫斯基 | 固定机位 + 光影流转 | 寂静→顿悟 | **8.8** |\n\n**选定方向**: C（独特性 + 情感深度最优）\n\n### Shot 1: 开场 — 废墟中的光 (0-8s)\n- **STANDARD_PROMPT**: `A solitary figure stands motionless in an abandoned rooftop garden overgrown with wild grass, shafts of golden hour sunlight pierce through broken concrete pillars, dust particles float in slow motion, the figure's silhouette barely visible against the intense backlight, cinematic wide shot, static camera, anamorphic lens flare, muted earth tones with selective color on a single red flower`\n- **CAMERA**: Static wide shot (固定广角)\n- **MOTION_STRENGTH**: 2\n- **LIGHTING**: Natural golden hour backlighting through architectural gaps, high contrast between shadow and light pools\n\n### Shot 2: 中段 — 凝视 (8-18s)\n- **STANDARD_PROMPT**: `Close-up of weathered hands holding a small cracked mirror, reflecting fragments of the city skyline beyond the garden fence, shallow depth of field, the reflection shifts subtly as wind moves the mirror angle, warm skin tones against cool blue city background, gentle handheld micro-movements`\n- **CAMERA**: Extreme close-up with subtle handheld drift\n- **MOTION_STRENGTH**: 3\n- **LIGHTING**: Mixed warm (skin/mirror) and cool (city reflection)\n\n### Shot 3: 结尾 — 回归 (18-30s)\n- **STANDARD_PROMPT**: `The figure now sits on the edge of the rooftop, legs dangling over the cityscape below, camera slowly pulls back (dolly out) revealing the vast urban landscape at dusk, thousands of windows beginning to glow like stars, the figure becomes smaller but no longer alone in frame — the city itself becomes a companion, final frame holds on this composition`\n- **CAMERA**: Slow dolly out (缓慢后拉)\n- **MOTION_STRENGTH**: 4\n- **LIGHTING**: Magic hour transition to blue hour, city lights gradually illuminating\n\n## 完整输出 JSON\n\n```json\n{\n \"STANDARD_PROMPT\": \"A cinematic three-shot sequence exploring urban solitude through poetic visual metaphor: [Shot 1] Abandoned rooftop garden, golden hour light through broken concrete, solitary silhouette, static wide shot, anamorphic lens. [Shot 2] Weathered hands holding cracked mirror reflecting city skyline, extreme close-up, shallow DOF, handheld drift. [Shot 3] Figure sitting on rooftop edge, slow dolly out revealing vast dusk cityscape, transition from isolation to cosmic connection.\",\n \"NEGATIVE_PROMPT\": \"no generic composition, no cliché visual language, no random style mixing, no emotional disconnect, no flat narrative, no derivative imagery, no shaky camera without motivation, no oversaturated colors, no text overlay, no watermark\",\n \"TIMELINE\": \"0-8s: Establishing — space and light; 8-18s: Intimate — detail and texture; 18-30s: Release — scale and connection\",\n \"CAMERA\": \"Static wide → ECU handheld → Slow dolly out\",\n \"MOTION_STRENGTH\": 3,\n \"DURATION\": 30,\n \"MODE\": \"电影创意探索\",\n \"MODE_KEY\": \"creative_film\",\n \"MULTI_MODAL_ADVICE\": \"参考图: Tarkovsky Stalker Zone interiors / Theo Angelopoulos long take compositions / Edward Hopper Nighthawks mood board\\n参考视频: Wings of Desire (1987) dolly-out sequence\\n音频建议: Minimal piano + field recording — Arvo Pärt style\",\n \"SOUND_DESIGN\": \"melancholic but hopeful minimal instrumentation; ambient urban rooftop atmosphere\",\n \"SHOT_LIST\": [\n {\"shot_id\": 1, \"duration\": 8, \"camera\": \"static_wide\", \"subject\": \"figure_silhouette_in_garden\"},\n {\"shot_id\": 2, \"duration\": 10, \"camera\": \"ecu_handheld\", \"subject\": \"hands_mirror_reflection\"},\n {\"shot_id\": 3, \"duration\": 12, \"camera\": \"dolly_out\", \"subject\": \"figure_cityscape\"}\n ]\n}\n```\n\n## Quality Checklist\n\n| 检查项 | 状态 |\n|--------|------|\n| 输出结构完整性 | PASS |\n| 创意探索模式专项（情绪方向/反套路） | PASS |\n| 参数范围合规 (DURATION=30, MOTION=3) | PASS |\n\nFile v3.4.1:references/examples/example_2_multi_shot.md\n\n# 案例 2: 多镜头叙事 — 咖啡品牌故事\n> **Mode**: `multi_shot` (Mode 4) | **平台**: Runway Gen-3 | **时长**: 3 shots × 5s = 15s\n\n## 用户输入\n\n```\n为一个精品咖啡品牌做一支15秒品牌广告，要有温度感，重点展示咖啡豆到杯子的过程。\n```\n\n## 分镜方案\n\n### Shot 1 (0-5s)\n- **画面**: 咖啡农的手采摘成熟的红樱桃咖啡果，晨光穿过树叶洒在手上，清晰可见的露珠和果实色泽\n- **景别**: 特写\n- **运镜**: 缓推\n- **光影**: 暖金色晨光 (Golden Hour)\n\n### Shot 2 (5-10s)\n- **画面**: 新鲜烘焙的咖啡豆从烘焙机中倾泻而出，热气腾腾，近距离展示豆子的油亮表面和色泽\n- **景别**: 极近特写\n- **运镜**: 微距跟踪\n- **光影**: 暖黄工业光\n\n### Shot 3 (10-15s)\n- **画面**: 手冲咖啡水流穿过咖啡粉，琥珀色液体滴入杯中，背景虚化中隐约可见咖啡农的微笑\n- **景别**: 俯拍特写转中景\n- **运镜**: 垂直俯拍到缓拉\n- **光影**: 侧逆光突出液体通透感\n\n## 完整输出 JSON\n\n```json\n{\n \"STANDARD_PROMPT\": \"[Shot 1] Hands of a coffee farmer picking ripe red cherries, golden morning light filtering through leaves, dewdrops and fruit texture clearly visible, macro extreme close-up, slow push-in, cinematic warm tones. [Shot 2] Freshly roasted coffee beans cascading from roaster, steam rising, oily surfaces glistening, extreme close-up, macro tracking shot, warm industrial lighting. [Shot 3] Pour-over coffee stream through grounds, amber liquid dripping into glass carafe, farmer's smile softly visible in bokeh background, top-down macro to mid-length slow pull-out, side-backlight highlighting liquid translucency.\",\n \"NEGATIVE_PROMPT\": \"no inconsistent lighting between shots, no drift in color grading, no mismatch in product appearance, no jumpy transitions, no flat blacks\",\n \"TIMELINE\": \"0-5s: Farm harvest; 5-10s: Roasting process; 10-15s: Final brewing\",\n \"CAMERA\": \"Slow push-in → Macro tracking → Top-down pull-out\",\n \"MOTION_STRENGTH\": 4,\n \"DURATION\": \"5+5+5=15s\",\n \"MODE\": \"多镜头叙事\",\n \"MODE_KEY\": \"multi_shot\",\n \"MULTI_MODAL_ADVICE\": \"统一色温: 暖色调贯穿三镜头; 建议上传参考图确保咖啡豆/杯具的品牌一致性\",\n \"SOUND_DESIGN\": \"Acoustic guitar + ambient farm nature sounds → roasting crackle → pour-over drip\",\n \"SHOT_LIST\": [\n {\"shot_id\": 1, \"duration\": \"5s\", \"scene\": \"coffee_farm_harvest\", \"focus\": \"hands_and_cherries\"},\n {\"shot_id\": 2, \"duration\": \"5s\", \"scene\": \"roasting_facility\", \"focus\": \"beans_cascading\"},\n {\"shot_id\": 3, \"duration\": \"5s\", \"scene\": \"brew_bar\", \"focus\": \"pour_over_drip\"}\n ]\n}\n```\n\n## Quality Checklist\n\n| 检查项 | 状态 |\n|--------|------|\n| 镜头数量 ≤ 3 | PASS (3 shots) |\n| 跨镜头风格一致 | PASS (统一暖色调) |\n| Negative Prompt 完整 | PASS |\n| 单镜头单运动原则 | PASS |\n\nFile v3.4.1:references/examples/example_3_short_drama.md\n\n# 案例 3: 短剧创作 — 仙侠逆袭短剧第一集\n> **Mode**: `short_drama` (Mode 8) | **平台**: Seedance 2.0 | **时长**: 3min (12 shots)\n\n## 用户输入\n\n```\n帮我写一个逆袭题材的短剧第一集，主角是宗门废柴，被当众羞辱后觉醒隐藏血脉。\n```\n\n## 人物设定\n\n### 角色：江晏\n| 维度 | 设定 |\n|------|------|\n| 外观 | 18岁，黑色束发，右脸一道新添的血痕（羞辱时留下），灰色旧道袍，身形清瘦 |\n| 性格 | 隐忍、内敛、遇强则强 |\n| 视觉标记 | 右脸血痕（全剧核心辨识点），额前两缕散落碎发 |\n\n### 角色：慕容雪\n| 维度 | 设定 |\n|------|------|\n| 外观 | 17岁，白色纱裙，银簪束发，容色清冷 |\n| 性格 | 外冷内热，暗中维护江晏 |\n| 视觉标记 | 银色发簪，眉心一点朱砂 |\n\n## 分镜表\n\n| 镜头 | 时间 | 景别 | 运镜 | 画面 | 台词 | 情绪 |\n|------|------|------|------|------|------|------|\n| 1 | 0-3s | 全景→中景 | 推镜 | 灵霄宗演武场，众弟子围观，江晏跪在地上 | (鸦雀无声) | 压抑 |\n| 2 | 3-8s | 特写 | 固定 | 内门弟子赵昂居高临下踩住江晏的手 | \"废物也配占用修炼资源？\" | 羞辱 |\n| 3 | 8-12s | 近景 | 手持微晃 | 江晏缓缓抬头，眼神从隐忍变冷厉 | \"我…不会再忍了。\" | 转变 |\n| 4 | 12-18s | 中景 | 环绕 | 江晏周身突然爆发出金色光华，血脉觉醒 | (震撼音效) | 爆发 |\n| 5 | 18-22s | 特写 | 缓推 | 慕容雪在人群中微微勾起嘴角 | \"终于…等到这一刻了。\" | 暗喜 |\n\n## Quality Checklist\n\n| 检查项 | 状态 |\n|--------|------|\n| 角色跨镜头一致性 | PASS (全剧统一外观设定) |\n| Negative Prompt 含 face/costume/episode 约束 | PASS |\n| 黄金3秒开场有冲突 | PASS (跪地被辱) |\n| 30秒内有反转 | PASS (血脉觉醒) |\n\nFile v3.4.1:references/modes_detail.md\n\n# 创作模式详情 (Layer 1 — 按需加载)\n\n> 本文件包含 9 种创作模式的完整说明。仅在用户确认模式后加载当前模式的详情。\n\n---\n\n## Mode 0: 电影创意探索 (Creative Film)\n- **场景**: 概念开发、风格实验、灵感发散、艺术短片、品牌概念片前期探索\n- **核心能力**: 风格混搭建议、意外转场推荐、情绪反差提案、视觉隐喻生成、导演视角切换\n- **Harness 机制**: 采用 **Generate-and-Filter + Tournament** 模式——先生成多个创意方向，再通过评分矩阵筛选最优方案\n- **默认模式**: Text-to-Video\n- **关键护栏**: `no generic composition, no cliché visual language, no random style mixing, no emotional disconnect, no flat narrative, no derivative imagery`\n- **工作流**:\n 1. **Perception (感知)**: 解析用户模糊意图，提取情绪关键词和参考意象\n 2. **Planning (规划)**: 并行生成 3-5 个创意方向（不同导演风格/时代/流派）\n 3. **Action (执行)**: 对每个方向生成分镜草案\n 4. **Feedback (反思)**: Tournament 两两比较 → 选出 Top 方案 → 迭代优化\n- **质量指标**: 创意独特性、视觉一致性、情感传达力\n\n## Mode 1: 电商产品 (Ecommerce)\n- **场景**: 商品详情页视频、主图动效、PDP 循环、付费社交素材\n- **核心要求**: 产品几何不变形、标签可读、镜头运动克制\n- **默认模式**: Image-to-Video\n- **关键护栏**: `no label blur, no packaging warp, no logo distortion, no duplicate product`\n- **镜头策略**: 单动作、单机位、产品占画幅 > 40%\n\n## Mode 2: UGC 原生广告 (UGC)\n- **场景**: 信息流投放素材、创作者口播、种草测评\n- **核心要求**: 面部一致、手势自然、节奏\"社交感\"、产品不消失\n- **默认模式**: Reference-to-Video\n- **关键护栏**: `no face drift, no extra fingers, no lip mismatch, no product disappearance, no shaky framing`\n- **镜头策略**: 单人、单信息点、保留原生感（不要过度电影化）\n\n## Mode 3: 电影感品牌短片 (Cinematic)\n- **场景**: 品牌故事片、发布预告、创意前贴\n- **核心要求**: 明确的镜头意图、精心设计的灯光逻辑、单个情绪 payoff\n- **默认模式**: Text-to-Video 或 Image-to-Video\n- **关键护栏**: `no shaky camera, no object melting, no random text, no flat blacks`\n- **镜头策略**: 每个镜头只做一件事。多镜头通过序列编排实现复杂叙事。\n\n## Mode 4: 多镜头叙事 (Multi-shot)\n- **场景**: 完整叙事弧线、产品使用场景、品牌故事\n- **核心要求**: 角色/产品跨镜头一致、过渡自然、节奏把控\n- **默认模式**: Reference-to-Video + Multi-shot syntax\n- **关键护栏**: 每个镜头 2-3 个分段，使用 `Cut to` / `Camera cut to` / `Shot Switch`\n- **镜头策略**: 1 次生成 = 2-3 个镜头，总时长 ≤ 15s；更长叙事通过多次生成 + 后期拼接\n\n## Mode 5: 一镜到底 (One-Shot Long Take)\n- **场景**: 产品体验流程、空间巡游、品牌沉浸式展示、创意转场视频\n- **核心要求**: 2-10 张图片输入 → AI 自动补足转场画面 → 连贯长镜头输出\n- **输入类型**: 图片序列（2-10 张）\n- **关键能力**: 空间连续性、运镜流畅性、节奏合理性\n- **转场设置**:\n - 自定义转场描述（推/拉/螺旋/溶解/匹配剪辑等）\n - 仅设转场时长（AI 自动发挥）\n - 支持逐段落描述转场方式\n- **关键护栏**: `no abrupt cuts, no spatial discontinuity, no object mutation between frames, no stutter in transitions`\n- **质量指标**: 镜头空间连续、运镜流畅、转场自然不跳帧\n\n## Mode 6: 爆款复刻 (Viral Replicate)\n- **场景**: 灵感来源、竞品素材翻拍、爆款模板复用、经典影视猫化/狗化\n- **核心要求**: 一键复制心动视频的文案结构、剧情框架、配乐画风\n- **输入类型**: 参考视频（必选）+ 替换主体参考图（可选）\n- **复刻策略**:\n - **创意拍摄复刻**: 复用参考视频运镜方式和创作手法，替换主体\n - **经典影视还原**: 复刻全部细节，替换人物（如换成猫/动画角色）\n - **爆款拆解再生**: 解析爆点原因 → 借鉴文案/主题/画面风格 → 重新创作\n- **提示词模式**: `参考[@视频1]的运镜方式和创作手法，将主体更换为[@图片1]，创作成类似风格的[品类]视频`\n- **关键护栏**: `no style drift from reference, no subject identity loss, no mismatched pacing`\n- **质量指标**: 风格还原度、主体替换自然度、节奏匹配度\n\n## Mode 7: Agent 模式 (Agent Mode — 从一句话到成片)\n- **场景**: 零基础创作者、有脚本需组织、有素材需整合、跨风格创作\n- **核心要求**: 输入一句话 / 脚本 / 素材 → Agent 自动理解意图 → 规划创作路径 → 调度最优模型 → 输出成品\n- **适用人群**:\n - 零基础: 不会写分镜，从\"一句话\"出片\n - 有脚本: 把台词、镜头、节奏交给 Agent 组织成片\n - 有素材: 图片/视频/文案丢进去，做\"从素材到成片\"的组合拳\n - 追求风格: 写实电影感、3D、二次元、国风漫画等同一套流程\n- **创作链路**:\n 1. 意图解析: 抽取主体、风格、时长、情绪\n 2. 路径规划: 选择最优创作模式（Text-to-Video / Image-to-Video / Reference-to-Video / Multi-shot）\n 3. 分镜编排: 自动生成分镜头脚本\n 4. 模型调度: 推荐 Seedance 2.0 参数组合\n 5. 提示词合成: 逐镜头输出完整提示词\n- **关键护栏**: 按最终选定子模式注入对应 Negative Prompt\n- **质量指标**: 意图理解准确度、分镜完整性、风格一致性\n\n## Mode 8: 短剧创作 (Short Drama)\n- **场景**: AI 短剧全自动生产、漫剧创作、小说改编短剧\n- **核心能力**:\n - 剧本全自动解析 → 连贯生成完整剧集\n - 全局角色/场景管理 → 角色不同时空妆造精准映射\n - Agent 智能旁白改编\n - 多画风支持（写实/漫画/3D/二次元）\n - 多剧集连发\n- **输入格式**: 标准剧本（含场景标注、人物标注、对白/OS/动作描述）\n- **角色一致性**: 在分镜故事板中 @角色形象 保持跨镜头一致\n- **关键护栏**: `no character face drift across episodes, no costume inconsistency, no scene discontinuity, no voice mismatch`\n- **质量指标**: 角色跨集一致性、剧本还原度、旁白自然度\n\nFile v3.4.1:references/phases_detail.md\n\n# 分镜推导流程详情 (Layer 1 — 按需加载)\n\n> 本文件包含 Phase 0-7 的完整推导指引。仅在进入对应阶段时加载。\n\n---\n\n## Phase 0: 模式选择与意图澄清 (Perception)\n> **Harness 层级**: Read — 通过上下文管理器将用户输入翻译为结构化意图\n- 确认创作目标（电影概念 / 卖货 / 种草 / 品牌 / 叙事 / 艺术实验）\n- 选择对应 Mode（含 Mode 0 创意探索），明确核心约束\n- 确定输入素材类型（纯文本 / 产品图 / 参考图 / 参考视频）\n- **产出**: Mode 确认 + 输入策略 + 创作意图结构化描述\n\n## Phase 1: 核心创意锁定 (Core Concept) (Planning)\n> **Harness 层级**: Eval — 调用拦截器捕获创意意图并路由到正确的模式引擎\n- 明确主体（产品 / 人物 / 场景）\n- 定义单镜头内唯一的动作或信息点\n- 确定情感基调和观众预期反应\n- **拒绝策略**: 如果用户在一个镜头里塞了 > 1 个动作或 > 1 个信息点，主动建议拆分\n- **产出**: Subject + Action 描述\n\n## Phase 2: 时间轴与节奏 (Timeline & Rhythm) (Action)\n> **Harness 层级**: 执行器 — 将时间规划注入确定性时间线模型\n- 规划时长内的时间分配（默认 15s，电影模式支持 30-180s）\n- 定义关键帧节点（至少 3 个：入场 / 核心 / 收尾）\n- 多镜头模式：规划 Cut-to 节点和镜头间节奏关系\n- **产出**: Timeline 描述 + 关键帧定义\n\n## Phase 3: 视觉构图 (Visual Composition) (Action)\n> **Harness 层级**: 执行器 — 构图参数化输出\n- 确定画面比例、构图方式\n- 主体在画面中的占比和位置\n- 角色 / 产品与环境的空间关系\n- **电商提醒**: 产品必须占画面显著位置，不要放在边角\n- **UGC 提醒**: 保持自然取景，不要过度设计构图\n- **电影提醒**: 遵循三分法/黄金分割/对称构图等经典电影语言\n- **产出**: Composition 描述 + 画幅建议\n\n## Phase 4: 镜头运动 (Camera Movement) (Action)\n> **Harness 层级**: 调用拦截器 — 捕获镜头运动意图并路由到运动强度参数\n- 选择 1 个主导镜头运动（不可在一个镜头内混用多种运动）\n- 在 Timeline 上标注运动变化\n- 给出 Motion Strength 建议值\n- **原则**: 镜头运动服务于叙事动机，不炫技\n- **产出**: Camera 描述（含运动强度）+ Motion Strength 参数\n\n## Phase 5: 光影与质感 (Lighting & Texture) (Action)\n> **Harness 层级**: 执行器 — 光影参数化输出\n- 光源方向、色温、对比度\n- 环境细节（烟雾、颗粒、反射、材质）\n- 整体色调和视觉风格\n- **电商提醒**: 光源不要遮挡产品标签\n- **UGC 提醒**: 自然光优先，避免棚拍感\n- **电影提醒**: 每个光源有情绪动机，参考 `assets/cheat_sheet.json` 中的 `cinematic_lighting_extended`\n- **产出**: Lighting 描述 + 风格预设\n\n## Phase 6: 声音设计 (Sound Design) (Action)\n> **Harness 层级**: 执行器 — 声音参数化输出\n- 确定音效类型（环境音 / 音效 / 对白 / 音乐）\n- 音乐风格和节奏（参考 `assets/cheat_sheet.json` 中的 `sound_design_presets`）\n- 音画同步点（关键动作匹配音效）\n- **电商提醒**: 音乐不分散注意力，让产品说话\n- **UGC 提醒**: BGM 保持在语音之下\n- **电影提醒**: 参考导演声音签名（如 Nolan 的低频冲击）\n- **产出**: Sound Design 建议\n\n## Phase 7: 最终合成与参数输出 (Export) (Feedback)\n- 整合所有 Phase 产出为完整提示词\n- 生成 Negative Prompt（基于 Mode 自动注入）\n- 输出多模态建议（参考图 / 参考视频 / 音频建议）\n- 输出平台适配参数（根据目标平台约束自动适配）\n- 质量自检：对照质量门禁逐项检查\n- **降级策略**:\n - 结构不完整 → 回退到上一 Phase 补充\n - 参数超范围 → 自动 clamp 到安全区间\n - 模式不匹配 → 提示用户确认或自动切换兼容模式\n- **产出**: 完整分镜方案\n\nFile v3.4.1:references/pre_flight_checklist.md\n\n# MadStory 导演级预检清单 (Director Pre-Flight Checklist)\n\n启用 MadStory 技能前，使用以下清单进行创作准备度验证。\n\n## 1. 技术规格 (Technical Specifications)\n\n- [ ] **Mode 已确认** — 9 个模式中选定 1 个 (creative_film / ecommerce / ugc / cinematic / multi_shot / one_shot / viral_replicate / agent_mode / short_drama)\n- [ ] **Seedance 输入模式已推荐** — Text-to-Video / Image-to-Video / Reference-to-Video 已提示用户\n- [ ] **时长已设定** — 默认 15s，多镜头序列总长 ≤ 15s，长视频可设 60s\n- [ ] **画幅比例已确定** — 16:9 / 9:16 / 1:1 / 2.35:1\n- [ ] **Motion Strength 已建议** — 按模式: Ecommerce=2 / UGC=3 / Cinematic=5 / Multi-shot=4 / One-shot=4 / Viral=5 / Drama=4\n\n## 2. 主体与构图 (Subject & Composition)\n\n- [ ] **主体已明确** — 产品 / 人物 / 场景，不可含歧义\n- [ ] **单镜头信息点检查** — 每个镜头只承载 1 个动作或 1 个信息点\n- [ ] **构图方式已确定** — 三分法 / 中心 / 对称 / 对角线 / 框架式\n- [ ] **产品占比检查 (Ecommerce)** — 产品占画幅 ≥ 40%，不在边角\n- [ ] **取景范围检查 (UGC)** — 半身/特写已确定，自然取景非影楼感\n- [ ] **多镜头场景检查 (Multi-shot/One-shot)** — 每段含: 主体 + 动作 + 机位\n\n## 3. 镜头运动 (Camera Movement)\n\n- [ ] **单运动原则检查** — 每个镜头 ≤ 1 个主导运动\n- [ ] **运动类型已选择** — orbit / dolly / push-in / pull-out / crane / handheld / whip / follow / static\n- [ ] **运动动机已明确** — 每次运动服务于叙事/产品目的，非炫技\n- [ ] **时间轴运动标注** — 在 Timeline 上标注运动变化节点\n- [ ] **运动强度在合理范围** — Ecommerce ≤ 3 / UGC = 3 / 其他 4-5\n\n## 4. 光影与色彩 (Lighting & Color)\n\n- [ ] **光源方向已确定** — key light 方向、fill ratio\n- [ ] **色温已指定** — 暖色 (3200K) / 中性 (4500K) / 冷色 (5600K+)\n- [ ] **灯光类型已选择** — 三点布光 / 蝴蝶光 / 伦勃朗 / 侧光 / 逆光 / 霓虹 / 金色时刻\n- [ ] **环境细节已描述** — 烟雾/颗粒/反射/材质\n- [ ] **电商光位检查** — 光源不遮挡或反射产品标签\n- [ ] **UGC 光感检查** — 自然光/环形灯，不过度打光\n- [ ] **色彩调性一致** — 跨镜头保持一致的色彩氛围\n\n## 5. 声音设计 (Sound Design)\n\n- [ ] **BGM 情绪已确定** — 激昂/舒缓/悬疑/科技感/自然/电子\n- [ ] **音效同步点已标注** — 与 Timeline 关键帧对齐\n- [ ] **环境音已规划** — 雨声/风声/人群/房间音\n- [ ] **电商/多镜头模式** — BGM 不打断产品信息传达\n\n## 6. 模式专项检查 (Mode-Specific)\n\n### Ecommerce (电商)\n- [ ] 产品标签可读性已声明 (Negative Prompt)\n- [ ] 产品几何保护已声明 (no warped, no distortion)\n- [ ] Image-to-Video 模式已推荐\n- [ ] 白底/纯色背景已指定\n\n### UGC (原生广告)\n- [ ] 人脸一致性已声明 (no face drift)\n- [ ] 手指保护已声明 (no extra fingers)\n- [ ] Reference-to-Video 模式已推荐\n- [ ] 社交节奏感已描述\n\n### Cinematic (电影感)\n- [ ] 镜头抖动保护已声明\n- [ ] 灯光逻辑有明确动机\n- [ ] 单一情绪 payoff 已识别\n- [ ] 物体变形保护已声明\n\n### Multi-shot (多镜头)\n- [ ] 镜头数 ≤ 3\n- [ ] 过渡关键词已使用 (Cut to / Camera cut to / Shot Switch)\n- [ ] 跨镜头一致性约束已声明\n- [ ] 时间分配合理 (各镜头时长和 = 总时长)\n\n### One-Shot (一镜到底)\n- [ ] 图片数 2 ≤ N ≤ 10\n- [ ] 转场类型已逐段指定或设为 Auto\n- [ ] 空间连续性已声明 (no spatial discontinuity)\n- [ ] 跳帧保护已声明 (no stutter)\n\n### Viral Replicate (爆款复刻)\n- [ ] 参考视频已指定\n- [ ] 复刻策略已选定 (creative/classic/deconstruct)\n- [ ] 替换主体已指定 (如适用)\n- [ ] 风格偏离保护已声明 (no style drift)\n\n### Agent Mode (Agent)\n- [ ] 用户意图已解析 (风格/时长/情绪)\n- [ ] 路由决策已执行\n- [ ] 子模式的 Negative Prompt 已注入\n- [ ] 输出模式标签包含子模式信息\n\n### Short Drama (短剧)\n- [ ] 角色注册表已建立\n- [ ] @角色引用机制已启用\n- [ ] 跨集一致性约束已声明\n- [ ] 剧本格式已验证 (场景/人物/△/OS)\n- [ ] 一致性管控台账已建立 (Characters / Scenes / Timeline)\n- [ ] 长戏份 (>15s) 已拆分标记校验节点\n- [ ] 人物档案六项不可变字段已填写 (视觉标记/发型发色/妆容/服饰/配饰/穿着状态)\n- [ ] 场景清单四项环境参数已记录 (光线方向/色温/天气/背景杂音)\n- [ ] 后期跨片段一致性校验已规划 (C1/C2/C3)\n\n## 7. 多模态输入检查 (Multi-Modal Input)\n\n- [ ] Reference 图已分配角色 — Image1(主身份), Image2(辅助), Image3(色调)\n- [ ] 多个 Reference 之间光位/造型/质量对齐\n- [ ] Reference 不与模糊 prompt 搭配使用\n- [ ] 手部在画面中时已在 Negative Prompt 中保护\n\n## 8. 输出完整性检查 (Output Integrity)\n\n- [ ] STANDARD_PROMPT 包含 5 层结构 (Subject → Action → Camera → Style → Constraints)\n- [ ] NEGATIVE_PROMPT 按模式自动注入完整\n- [ ] TIMELINE 含关键帧描述\n- [ ] CAMERA 逐秒/逐镜头描述\n- [ ] MOTION_STRENGTH 在 1-10 范围\n- [ ] DURATION 含时间单位\n- [ ] MODE 标签正确\n- [ ] MULTI_MODAL_ADVICE 具体可用\n- [ ] SHOT_LIST 完整 (多镜头模式)\n\n## 9. 质量护栏检查 (Quality Gates)\n\n- [ ] Negative Prompt 非空\n- [ ] 每个 Mode 的专项护栏已触发检查\n- [ ] 无任何 FAIL 级别的质量问题\n- [ ] 如有 WARNING，已确认可接受\n\n## 10. 最终签署 (Final Sign-off)\n\n- [ ] 导演视角确认: 这个分镜方案能否指导一次实际拍摄？\n- [ ] 广告视角确认 (如适用): 这个素材适合直接投放吗？\n- [ ] 即梦视角确认: 这个提示词在 Seedance 2.0 中能直接使用吗？\n- [ ] 一致性确认: 多镜头/多素材间风格统一吗？\n- [ ] (可选) 使用独立校验工具验证: `tools/mad-story-scripts/`\n\n## 11. Seedream 4.x/5.x 图片模式预检\n\n> 当检测到用户使用 Seedream 平台或需要图片生成时，执行以下检查项。\n> 完整规则见 `references/seedream_4x_rules.md`\n\n- [ ] **平台已确认** — Seedream 4.x/5.x 图片生成模式\n- [ ] **提示词结构** — 3层结构（主体+行为+环境，风格/色彩/光影/构图补充），非视频5层\n- [ ] **文字渲染** — 需生成的文字已用双引号包裹\n- [ ] **图像编辑指令** — 指代明确（无模糊代词），保持不变的部分已强调\n- [ ] **视觉信号** — 涂鸦/线框/箭头已标注颜色对应关系（如适用）\n- [ ] **参考图类型** — 已指明（人物形象/风格/虚拟实体/款式/无）\n- [ ] **参考图双要素** — 已指明参考对象 + 生成画面描述\n- [ ] **多图输入** — 图一/图二角色分配已明确（如适用）\n- [ ] **多图输出** — 数量和触发词已指定（如适用）\n- [ ] **Negative Prompt** — 不注入（图片模式不需要）\n- [ ] **Camera/Motion 参数** — 已移除（图片模式不适用）\n\nFile v3.4.1:references/prompt_engineering.md\n\n# 提示词工程规范 (Layer 1 — 按需加载)\n\n> 本文件包含提示词结构、Negative Prompt 模板和特殊语法。在生成提示词时加载。\n\n---\n\n## 标准提示词结构 (5 层)\n```\n[Subject], [Single Action], [Camera Move], [Style & Lighting], [Constraints]\n```\n\n## Negative Prompt 按模式注入\n\n**Creative Film (Mode 0):**\n```\nno generic composition, no cliché visual language, no random style mixing, no emotional disconnect, no flat narrative, no derivative imagery\n```\n\n**Ecommerce:**\n```\nno logo distortion, no text artifacts, no packaging collapse, no duplicate product, no label blur, no warped glass, no cap drift\n```\n\n**UGC:**\n```\nno extra fingers, no face drift, no lip mismatch, no background warping, no product disappearance, no shaky framing, no eye drift\n```\n\n**Cinematic:**\n```\nno shaky camera, no object melting, no random text, no muddy lighting, no flat blacks, no text watermark\n```\n\n**Multi-shot:**\n```\nno character drift between cuts, no scene inconsistency, no transition artifacts, no text watermark\n```\n\n**One-Shot:**\n```\nno abrupt cuts, no spatial discontinuity, no object mutation between frames, no stutter in transitions, no frame-tearing\n```\n\n**Viral Replicate:**\n```\nno style drift from reference, no subject identity loss, no mismatched pacing, no warped replacement subject, no original ghosting\n```\n\n**Short Drama:**\n```\nno character face drift across episodes, no costume inconsistency, no scene discontinuity, no voice mismatch, no subtitle desync\n```\n\n## 多镜头语法\n- 过渡关键词: `Cut to`(硬切) / `Camera cut to`(机位切换) / `Shot Switch`(场景转场)\n- 每段必须包含: 主体 + 动作 + 机位方向\n- 格式:\n```\n[Shot 1: Subject + Action + Camera]\nCut to\n[Shot 2: Subject + Action + Camera + New Scene Details]\nCut to\n[Shot 3: Subject + Action + Camera]\n```\n\n## 一镜到底转场语法 (One-Shot Transition Syntax)\n- **输入**: 2-10 张顺序图片\n- **转场类型**:\n - `推 (Push)`: 镜头推进，从全景到特写\n - `拉 (Pull)`: 镜头拉远，从特写到全景\n - `螺旋 (Spiral)`: 镜头螺旋变化，中心点保持不变\n - `溶解 (Dissolve)`: 画面叠化过渡\n - `匹配剪辑 (Match Cut)`: 利用画面中的相似元素衔接\n - `甩 (Whip Pan)`: 快速横向甩镜转场\n - `遮挡转场 (Wipe)`: 物体遮挡画面完成转场\n - `AI自动 (Auto)`: 仅设时长，AI 自动生成转场\n- **提示词格式**:\n```\n图片1 → [转场描述: 镜头推进穿过门框, 2.5s] → 图片2 → [转场描述: 螺旋旋转至水晶中心, 3s] → 图片3\n```\n- **限制**: 2 ≤ 图片数 ≤ 10，总时长建议 15-60s\n\n## 爆款复刻语法 (Viral Replicate Syntax)\n- **创意拍摄复刻格式**:\n```\n参考[@视频1]的快速运镜方式以及创作手法，将[@视频1]的主体更换为[@图片1]，创作成一个类似的[品类]创意拍摄视频\n```\n- **经典影视还原格式**:\n```\n复刻[@视频1]的参考视频内容，还原一切细节，但把人物替换成[替换角色描述]\n```\n- **爆款拆解再生格式**:\n```\n解析[@视频1]这个视频的爆点原因，并借鉴其文案、主题、画面风格等，重新做一个新视频，[差异化要求]\n```\n\n## Agent 模式创作链路\n- **模糊意图 → 成片**: 输入自然语言 → 引擎解析主体/风格/时长/情绪 → 自动规划 → 分镜编排 → 提示词输出\n- **有脚本 → 成片**: 输入脚本 → 解析台词/场景/角色 → 分镜表生成 → 逐镜提示词\n- **有素材 → 成片**: 输入图片/视频/文案 → 素材角色分配 → 组合拳编排 → 输出\n\n## 短剧剧本格式 (Short Drama Script Format)\n```\n第X集\n场景: [场景描述] [时间]\n人物: [人物列表]\n\n△ [动作/环境描述]\n[人物] (OS): [内心独白]\n[人物]: [对白]\n```\n\n## 一致性管控 (Consistency Protocol)\n\n### 不变性清单 (Invariants)\n进入分镜推导前，锁定以下不可变要素（根据 Mode 选择）:\n- 人脸身份 (UGC)\n- 产品几何 (Ecommerce)\n- 手部姿态 (UGC / Ecommerce 手持)\n- 服装造型 (UGC / Cinematic 角色)\n- 场景光位 (Cinematic / Multi-shot)\n- 色彩调性 (所有 Mode，跨镜头一致)\n\n### 模式选择决策树\n```\n需要概念探索 → Text-to-Video\n需要首帧锁定 → Image-to-Video\n需要身份/产品锁定 → Reference-to-Video\n```\n\n### 一致性调试规约\n当输出出现漂移时，按以下顺序排查:\n1. 是否定义了不变要素？\n2. 当前 Mode 是否过于开放？\n3. 镜头运动是否过于激进？\n4. 主体在画面中是否过小？\n5. 多个 Reference 是否存在冲突？\n\n> **Seedream 4.x/5.x 图片模式**: 当检测到用户使用 Seedream 平台或需要图片生成时，加载 `references/seedream_4x_rules.md` 获取图片模式提示词结构、文字渲染、图像编辑、参考图生图、多图输入/输出语法。图片模式不适用本文件的 5 层结构和 Negative Prompt。\n\nFile v3.4.1:references/seedance_v2_rules.md\n\n# 即梦 Seedance 2.0 广告场景提示词工程规范\n\n## 1. 提示词 5 层结构 (Prompt Hierarchy)\n\n广告场景下，提示词必须按以下优先级排列:\n\n```\n[Subject] → [Single Action] → [Camera Move] → [Style & Lighting] → [Constraints]\n```\n\n| 层级 | 回答的问题 | 电商示例 | UGC 示例 | 电影感示例 |\n|------|-----------|---------|---------|-----------|\n| Subject | 什么必须保持可识别？ | @Image1 护肤品瓶身 | @Image1 创作者面部 | 红色跑车在午夜 |\n| Action | 正在发生什么？ | 缓慢旋转 | 手持产品面对镜头 | 穿过雨夜街道 |\n| Camera | 镜头如何运动？ | 缓慢推近 | 轻微手持感 | 侧面跟拍 |\n| Style | 应该是什么感觉？ | 洁净商业光感 | 自然室内日光 | 霓虹暗调电影感 |\n| Constraints | 什么绝对不能发生？ | 标签不模糊 | 人脸不漂移 | 镜头不抖动 |\n\n## 2. 三种模式的提示词策略 (Mode-Specific Strategies)\n\n### 2.1 Text-to-Video\n- **适用**: 概念探索阶段，不依赖特定素材\n- **策略**: 主体先行 → 动作物理化 → 镜头简单 → 光影明确\n- **典型词**: `Lone runner in a rain-soaked neon alley, side tracking shot, fast controlled pace, reflective puddles, cinematic red and teal contrast, no shaky camera no extra limbs no text watermark`\n\n### 2.2 Image-to-Video\n- **适用**: 首帧 / 产品白底图 / 构图已确定\n- **策略**: 引用图先行 → 描述 1 个运动层 → 禁止中途改变物体身份\n- **典型词**: `@Image1 sneaker center frame, slow 180 rotation, soft side rim light, clean commercial shadow floor, no sole deformation no lace chaos no duplicate shoe`\n\n### 2.3 Reference-to-Video\n- **适用**: 一致性需求高于创意自由度\n- **策略**: 稳定性声明前置 → 定义不变要素 → 仅加 1 个运动指令 → 限制姿态和场景变化\n- **典型词**: `@Image1 creator identity remains consistent, holds the product at chest level, subtle push-in, natural indoor daylight, social review style, no face drift no finger artifacts no product disappearance`\n\n## 3. Negative Prompt 规范\n\n### 3.1 按场景分类\n\n**电商产品:**\n```\nno logo distortion, no text artifacts, no packaging collapse, \nno duplicate product, no label blur, no warped glass, no cap drift\n```\n\n**UGC:**\n```\nno extra fingers, no face drift, no lip mismatch, no background warping, \nno product disappearance, no shaky framing, no eye drift\n```\n\n**电影感:**\n```\nno shaky camera, no object melting, no random text, no muddy lighting, \nno flat blacks, no text watermark\n```\n\n**多镜头:**\n```\nno character drift between cuts, no scene inconsistency, \nno transition artifacts, no text watermark\n```\n\n### 3.2 Negative Prompt 不是可选的\n- 即使生成看起来没问题，也必须注入\n- 每个场景有其特定的脆弱点，必须显式保护\n- 缺少 Negative Prompt 的输出视为不合格\n\n## 4. 镜头运动约束\n\n### 4.1 单运动原则\n每个镜头仅允许 1 个主导运动。禁止在一个镜头内混用:\n- 推 + 环绕\n- 拉 + 摇\n- 跟 + 变焦\n- 任何三种以上运动的组合\n\n### 4.2 Motion Strength 建议值\n| 模式 | 推荐值 | 说明 |\n|------|--------|------|\n| Ecommerce | 2 | 镜头几乎静止，保护产品几何 |\n| UGC | 3 | 轻微手持感，保持原生社交节奏 |\n| Cinematic | 5 | 标准电影感运动 |\n| Multi-shot | 4 | 各镜头运动差异化但不过激 |\n\n## 5. 参考图使用规范 (Reference Input Rules)\n\n### 5.1 角色分配\n| Reference | 最佳角色 |\n|-----------|---------|\n| Image 1 | 主身份锚定 / 主物体 |\n| Image 2 | 辅助角度 / 服装 / 产品细节 |\n| Image 3 | 色调 / 环境 / 次要一致性线索 |\n\n### 5.2 一致性前提\n上传的多个 Reference 必须对齐:\n- 同一人物 / 同一产品 → 兼容的年龄、脸型、比例\n- 兼容的光源逻辑\n- 兼容的造型\n- 相似的质量水平\n\n### 5.3 Reference 不能做什么\n- 不能弥补模糊的提示词\n- 不能在一个镜头内承载过多视觉信息\n- 忘记保护手部（如果手在画面中，必须在 Negative Prompt 中声明）\n\n## 6. 多镜头叙事规范 (Multi-shot Syntax)\n\n### 6.1 过渡关键词\n| 关键词 | 行为 | 最佳场景 |\n|--------|------|---------|\n| `Cut to` | 硬切 | 快节奏动作、戏剧性揭示 |\n| `Camera cut to` | 明确机位切换 | 采访风格、纪录片 |\n| `Shot Switch` | 场景转换 + 视觉桥接 | 叙事、商业广告 |\n\n### 6.2 格式\n```\n[Shot 1: Subject + Action + Camera Direction]\nCut to\n[Shot 2: Subject + Action + Camera Direction + New Scene Details]\nCut to\n[Shot 3: Subject + Action + Camera Direction]\n```\n\n### 6.3 限制\n- 单次生成 ≤ 3 个镜头\n- 总时长 ≤ 15 秒\n- 每个镜头后必须描述新场景\n\n## 7. 一致性管控规范 (Consistency Protocol)\n\n### 7.1 不变性清单 (Invariants)\n在分镜推导前锁定:\n- 人脸身份\n- 产品 / 瓶身 / 包装形状\n- 服装\n- 背景布局\n- 色彩调性\n- 手与物体的关系\n\n### 7.2 调试优先级\n当输出漂移时:\n1. 是否定义了不变要素？\n2. 当前模式是否过于开放？\n3. 镜头运动是否过于激进？\n4. 主体在画面中是否过小？\n5. 多个 prompt / reference 是否互相冲突？\n\n### 7.3 跨镜头一致性\n构建多镜头序列时，锁死以下变量:\n- 画幅比例\n- 主光源方向\n- 镜头感觉\n- 主体造型\n- Negative Prompt 护栏\n\n## 8. 迭代调试规则\n\n### 8.1 每次改 1 个变量\n- Prompt 措辞\n- Reference 选择\n- 镜头指令\n- 时长\n- 画幅比例\n\n不要同时改多个。\n\n### 8.2 从简化开始\n如果镜头不稳定:\n- 减少动作数\n- 减少道具数\n- 简化运动\n- 收紧取景\n\n短 prompt 不一定更好，但窄镜头几乎总是更稳定。\n\n## 9. 电商场景专项规范\n\n### 9.1 核心三要素\n- 产品几何不变形\n- 标签可读\n- 镜头运动克制\n\n### 9.2 标准工作流\n1. 确认产品白底图 → Image-to-Video\n2. 单镜头 + 单动作\n3. 产品占画面 ≥ 40%\n4. 光源不遮挡标签\n\n## 10. UGC 场景专项规范\n\n### 10.1 可信度因素\nUGC 广告的难点在于「看起来自然」。必须保持:\n- 一个创作者身份\n- 一个信息点\n- 一个简单手势或动作\n- 产品始终可见\n\n### 10.2 手势安全范围\n优先选择:\n- 产品持握在胸前\n- 产品面对镜头展示 1 次\n- 轻微指向某个特征\n- 手中轻转\n\n避免:\n- 快速手势\n- 复杂拆箱编排\n- 多次换手\n- 夸张面部表情\n\n## 11. 最终输出自检清单\n\n每个分镜方案输出前必须确认:\n- [ ] STANDARD_PROMPT 符合 5 层结构\n- [ ] NEGATIVE_PROMPT 已按模式注入\n- [ ] 镜头运动 ≤ 1 个主导方式\n- [ ] Motion Strength 在合理范围\n- [ ] 多镜头场景 ≤ 3 个镜头/次\n- [ ] 产品标签/人脸/手部已在护栏中声明\n- [ ] Reference 建议已按模式给出\n\n## 12. 一镜到底专项规范 (One-Shot Specification)\n\n### 12.1 输入约束\n- **图片数量**: 2 ≤ N ≤ 10\n- **图片顺序**: 按时间轴排列，第 1 张 = 起始帧，最后 1 张 = 结束帧\n- **构图连续性**: 相邻图片之间应有明确的空间关系或视觉连接点\n- **图片质量**: 建议分辨率一致，光位兼容\n\n### 12.2 转场类型与适用场景\n| 转场类型 | Seedance 提示词 | 最佳场景 | 建议时长 |\n|---------|----------------|---------|---------|\n| 推 (Push) | `camera pushes forward through` | 全景→特写，深入场景 | 2-4s |\n| 拉 (Pull) | `camera pulls back revealing` | 特写→全景，展示环境 | 2-4s |\n| 螺旋 (Spiral) | `spiral rotation centered on` | 魔幻/科幻风格转场 | 2.5-3.5s |\n| 溶解 (Dissolve) | `cross-dissolve to` | 时间流逝、回忆切换 | 1.5-3s |\n| 匹配剪辑 (Match Cut) | `match cut via` | 利用相似形状/颜色衔接 | 1-2s |\n| 甩 (Whip Pan) | `whip pan transition to` | 快速场景切换、动感 | 0.5-1.5s |\n| 遮挡 (Wipe) | `wipe transition through` | 物体遮挡自然转场 | 1-2s |\n| AI 自动 (Auto) | `smooth auto transition to` | 不指定，AI 自由发挥 | 2-3s |\n\n### 12.3 提示词格式\n```\nOne-shot long take sequence:\n[Frame 1: 起始帧描述]\n → [Xs transition: 转场描述] →\n[Frame 2: 第二帧描述]\n → [Xs transition: 转场描述] →\n[Frame 3: 结束帧描述]\nTotal duration: ~Xs. Continuous spatial flow, no cuts, smooth camera, Seedance 2.0 style.\n```\n\n### 12.4 关键约束\n- 全程无硬切 (no abrupt cuts)\n- 空间不跳跃 (no spatial discontinuity)\n- 物体不突变 (no object mutation between frames)\n- 转场不卡顿 (no stutter in transitions)\n- 画面不撕裂 (no frame-tearing)\n\n## 13. 爆款复刻专项规范 (Viral Replicate Specification)\n\n### 13.1 三种复刻策略\n| 策略 | 核心操作 | 输入要求 | 提示词模式 |\n|------|---------|---------|-----------|\n| creative_shoot | 复用运镜+创作手法，替换主体 | 参考视频 + 替换主体图 | `参考[@视频]运镜方式，主体更换为[@图片]` |\n| classic_remake | 复刻全部细节，仅替换人物 | 参考视频 + 替换角色描述 | `复刻[@视频]内容，人物替换成[角色]` |\n| viral_deconstruct | 解析爆点→借鉴风格→重新创作 | 参考视频 + 差异化要求 | `解析[@视频]爆点原因，借鉴风格重新创作` |\n\n### 13.2 关键护栏\n- 风格不偏离参考 (no style drift from reference)\n- 主体身份不丢失 (no subject identity loss)\n- 节奏不失调 (no mismatched pacing)\n- 替换主体不变形 (no warped replacement subject)\n- 原主体不残留 (no original ghosting)\n\n## 14. Agent 模式专项规范 (Agent Mode Specification)\n\n### 14.1 意图解析分层\n输入 → 解析主体/风格/时长/情绪 → 判断是否有脚本 → 判断是否有素材 → 选择最优子模式\n\n### 14.2 风格自动检测\n| 检测关键词 | 映射风格 | 默认子模式 |\n|-----------|---------|-----------|\n| 电影感/大片/film/cinematic | cinematic | Text-to-Video |\n| 二次元/动漫/anime/漫画 | anime | Text-to-Video |\n| 3D/三维/CG | 3d | Text-to-Video |\n| 国风/水墨/古风 | guofeng | Text-to-Video |\n| 写实/真实/照片级 | realistic | Text-to-Video |\n| 种草/测评/开箱/口播 | ugc | Reference-to-Video |\n\n### 14.3 路由决策\n```\n有脚本标记(集/场景:/人物:/△) → short_drama\n有素材标记(上传/@图片/@视频/参考图) → viral_replicate \n风格为 ugc → UGC\n其他 → agent_mode (通用创作)\n```\n\n## 15. 短剧专项规范 (Short Drama Specification)\n\n### 15.1 标准剧本格式\n```\n第X集\n场景: [地点描述] [时间]\n人物: [角色A], [角色B]\n\n△ [环境/动作描述]\n[角色A] (OS): [内心独白]\n[角色A]: [对白内容]\n[角色B]: [对白内容]\n```\n\n### 15.2 角色一致性机制\n- 全局角色库: 所有角色在剧本解析时注册\n- @角色引用: 分镜中通过 @角色名 锁定形象\n- 跨集一致性: 服装、发型、面部特征在各集中保持\n\n### 15.3 关键护栏\n- 角色跨集不漂移 (no character face drift across episodes)\n- 服装不混乱 (no costume inconsistency)\n- 场景不跳跃 (no scene discontinuity)\n- 配音不匹配 (no voice mismatch)\n- 字幕不同步 (no subtitle desync)\n\nFile v3.4.1:references/seedream_4x_rules.md\n\n# Seedream 4.0-5.0 提示词工程规范 (Layer 1 — 按需加载)\n\n> 本文件包含 Seedream 5.0 lite / 4.5 / 4.0 的提示词方法论，补充 Seedance 2.0 规范中未覆盖的文生图、图像编辑、参考图生图、多图输入/输出等能力。\n> **加载条件**: 用户使用 Seedream 4.x/5.x 平台，或涉及文生图、图像编辑、参考图生成、多图操作、知识可视化等场景时加载。\n\n---\n\n## 1. 通用规则 (General Rules)\n\n### 1.1 自然语言清晰描述\n用**简洁连贯**的自然语言写明 **主体 + 行为 + 环境**，对美学有要求时补充 **风格、色彩、光影、构图**。\n\n| 推荐 | 避免 |\n|------|------|\n| 一个穿着华丽服装的女孩，撑着遮阳伞走在林荫道上，莫奈油画风格 | 一个女孩，撑伞，林荫街道，油画般的细腻笔触 |\n\n### 1.2 明确应用场景\n有明确应用场景时，在提示中写明图像用途和类型。\n\n| 推荐 | 避免 |\n|------|------|\n| 设计一个游戏公司的 logo，主体是一只在用游戏手柄打游戏的狗，logo 上写有公司名 \"PITBULL\" | 一张抽象图片，狗拿着游戏手柄，狗狗上写 PITBULL |\n\n### 1.3 风格渲染\n有明确风格需求时，使用精准的**风格词**或提供**参考图像**。\n\n### 1.4 文字渲染\n将要生成的**文字内容**放在**双引号**中。\n\n| 推荐 | 避免 |\n|------|------|\n| 生成一张海报，标题为 \"Seedream 4.5\" | 生成一张海报，标题为 Seedream 4.5 |\n\n### 1.5 图像编辑目标明确\n使用**简洁明确的指令**，说明需要修改/参考的对象及具体操作，避免指代模糊的代词；希望保持不变的部分需强调。\n\n| 推荐 | 避免 |\n|------|------|\n| 让图中最高的那只熊猫穿上粉色的京剧服饰并戴上头饰，并保持动作不变 | 让它穿上粉色衣服 |\n\n---\n\n## 2. 文生图 (Text-to-Image)\n\n### 2.1 核心原则\nSeedream 5.0 lite / 4.5 / 4.0 对文本理解能力更强，**简洁精确的提示通常优于重复堆叠华丽复杂的词汇**。画面不再泛白。\n\n### 2.2 高密度细节描述\n对于细节丰富的图像，通过详细的文本描述精准控制画面细节。每个元素逐一描述其位置、状态、内容。\n\n**示例结构**:\n```\n[场景概述]。[元素1位置]: [元素1描述]；[元素2位置]: [元素2描述]；... 背景是[背景描述]。[光影描述]。\n```\n\n### 2.3 知识可视化\n可将知识与推理结果转化为高密度图像内容（公式、图表、教学插图等）。\n\n**关键要求**:\n- 使用**专业术语**确保知识点表达准确\n- 写清对生成图像的具体要求（可视化形式、版式、风格）\n\n**示例**:\n- 在黑板上画出二元一次方程组及其相应的解法步骤\n- 绘制一张信息图，展示通货膨胀的成因，每条成因独立呈现，并配有简洁图标\n\n---\n\n## 3. 图像编辑 (Image Editing)\n\n### 3.1 四种编辑操作\n\n| 操作 | 指令要点 | 示例 |\n|------|---------|------|\n| **增加** | 明确指出增加的对象和位置 | 给图中女生增加相同款式的银色耳线和项链 |\n| **删除** | 明确指出删除的对象 | 去掉女生的帽子 |\n| **替换** | 指明替换对象 + 替换为 + 保持不变的部分 | 把最大的面包人换成牛角包形象，保持动作和表情不变 |\n| **修改** | 指明修改对象 + 修改属性 + 保持不变的部分 | 让图中三个机器人变成透明水晶材质，颜色从左到右分别变成红黄绿 |\n\n### 3.2 视觉信号控制\n当画面复杂难以通过文本准确描述编辑对象时，可采用以下视觉信号：\n\n| 信号类型 | 用法 | 示例 |\n|---------|------|------|\n| **涂鸦** | 用颜色涂抹标记位置，在 prompt 中指明颜色对应的操作 | 将房间内红色涂抹位置放入电视，蓝色涂抹位置放入沙发，不改变其他布局 |\n| **线框** | 用线框标记区域和大小，在 prompt 中指明线框对应的操作 | 放大图中的标题至红框大小，并改成和萨克斯图案一样的颜色和字体风格 |\n| **箭头** | 用箭头指示方向和目标 | — |\n\n---\n\n## 4. 参考图生图 (Reference-to-Image)\n\n### 4.1 四种参考类型\n\n| 参考类型 | 提取信息 | 提示词结构 |\n|---------|---------|-----------|\n| **参考人物形象** | 角色外貌特征 | 参考图中的人物形象 + [生成画面描述] |\n| **参考风格** | 艺术风格/视觉语言 | 参考图的[风格描述] + [生成内容描述] |\n| **参考虚拟实体形象** | 3D/IP/虚拟角色 | 图中的形象变成[目标材质/形态] + [场景描述] |\n| **参考款式** | 产品设计/服装款式 | 衣服款式与图中一致 + [变化描述] |\n\n### 4.2 提示词双要素\n参考图生图的提示词必须包含两部分：\n1. **指明参考对象**: 清晰描述希望从参考图中提取并保留的元素\n2. **描述生成画面**: 具体说明希望生成的画面内容、场景等细节\n\n### 4.3 设计草图→高保真\n从设计草图生成高保真效果图时：\n1. 提供清晰的原始图片，若图中有文字说明则注明\"遵循图中文字内容进行生成\"\n2. 明确主体与要求（如高保真 UI 界面、现代简约风格客厅实景图）\n3. 明确指出需与参考图保持一致的关键要求（如家具位置与参考图一致）\n\n---\n\n## 5. 多图输入 (Multi-Image Input)\n\n### 5.1 三种复合操作\n\n| 操作 | 提示词结构 | 示例 |\n|------|-----------|------|\n| **替换** | 将图一的[元素]替换为图二的[元素] | 将图一的主体替换为图二的主体 |\n| **组合** | 让图一[元素]穿上/使用图二的[元素] | 让图一人物穿上图二的服装 |\n| **迁移** | 参考图二的风格，对图一进行风格转换 | 参考图的风格，对图一进行风格转换 |\n\n### 5.2 多图引用规范\n- 使用\"图一/图二/图三\"明确指代不同输入图像\n- 每张图的参考要素需明确（人物/服装/风格/产品）\n- 多图之间需兼容：光源逻辑、造型、质量水平\n\n---\n\n## 6. 多图输出 (Multi-Image Output)\n\n### 6.1 触发方式\n通过以下提示词触发组图生成：\n- \"一系列\"/\"一套\"/\"组图\"\n- 具体数字表明图片数量\n\n### 6.2 适用场景\n| 场景 | 说明 |\n|------|------|\n| 分镜序列 | 角色连贯、风格统一的分镜图 |\n| 漫画创作 | 多格漫画的连续画面 |\n| IP 产品 | 统一视觉风格的成套设计 |\n| 表情包 | 同一角色的多种表情/动作 |\n\n---\n\n## 7. Seedream 4.x/5.x 与 Seedance 2.0 差异速查\n\n| 维度 | Seedance 2.0 (视频) | Seedream 4.x/5.x (图片) |\n|------|---------------------|--------------------------|\n| 核心输出 | 视频分镜 | 静态图片/组图 |\n| 提示词结构 | 5层: Subject→Action→Camera→Style→Constraints | 3层: 主体+行为+环境 + 美学补充 |\n| 文字渲染 | 不涉及 | 双引号包裹文字内容 |\n| 图像编辑 | 无 | 增加/删除/替换/修改 + 视觉信号 |\n| 参考图 | Reference-to-Video | Reference-to-Image (4种类型) |\n| 多图输入 | 无 | 替换/组合/迁移 |\n| 多图输出 | 多镜头序列 | 组图 (分镜/漫画/IP/表情包) |\n| 知识可视化 | 无 | 公式/图表/教学插图 |\n| Negative Prompt | 必须 | 不适用 (图片模式) |\n| Motion Strength | 必须 | 不适用 |\n\n---\n\n## 8. 平台适配提示\n\n当 MadStory 检测到用户使用 Seedream 4.x/5.x 平台时：\n- 自动切换为图片生成模式，移除 Camera/Motion 相关参数\n- 应用双引号文字渲染规则\n- 启用图像编辑/参考图/多图操作语法\n- 知识可视化场景使用专业术语\n- 不注入 Negative Prompt（图片模式不需要）\n\n---\n\n## 9. 实战示例 (Prompt Examples)\n\n> 以下示例来自 Seedream 4.0-5.0 官方指南，展示不同\n\nArchive v3.4.0: 23 files, 84724 bytes\n\nFiles: assets/cheat_sheet.json (26728b), assets/cs_cinematic.json (8281b), assets/cs_core.json (5134b), assets/cs_drama.json (6082b), assets/cs_narrative.json (3231b), assets/cs_sound.json (2231b), assets/storyboard_template.html (13941b), README.md (8572b), references/examples/example_1_creative_film.md (4667b), references/examples/example_2_multi_shot.md (2907b), references/examples/example_3_short_drama.md (1860b), references/modes_detail.md (6468b), references/phases_detail.md (4001b), references/pre_flight_checklist.md (7145b), references/prompt_engineering.md (4909b), references/seedance_v2_rules.md (11070b), references/seedream_4x_rules.md (10888b), references/short_drama_consistency.md (18608b), references/short_drama_genres.md (7428b), references/terminology.md (12284b), skill-card.md (3276b), SKILL.md (10744b), _meta.json (127b)\n\nArchive v3.1.0: 27 files, 118806 bytes\n\nFiles: assets/cheat_sheet.json (26728b), assets/cs_cinematic.json (8281b), assets/cs_core.json (5134b), assets/cs_drama.json (6082b), assets/cs_narrative.json (3231b), assets/cs_sound.json (2231b), assets/storyboard_template.html (13976b), README.md (9821b), references/examples/example_1_creative_film.md (7068b), references/examples/example_2_multi_shot.md (4696b), references/examples/example_3_short_drama.md (7201b), references/modes_detail.md (6468b), references/phases_detail.md (4227b), references/pre_flight_checklist.md (6048b), references/prompt_engineering.md (4583b), references/seedance_v2_rules.md (11070b), references/short_drama_consistency.md (5572b), references/terminology.md (7809b), scripts/api_server.py (9987b), scripts/batch_runner.py (7769b), scripts/director_validator.py (28462b), scripts/llm_router.py (18654b), scripts/mad_story_engine.py (80931b), scripts/platform_adapter.py (8194b), skill-card.md (2950b), SKILL.md (7614b), _meta.json (127b)\n\nArchive v3.0.0: 27 files, 118911 bytes\n\nFiles: assets/cheat_sheet.json (26728b), assets/cs_cinematic.json (8281b), assets/cs_core.json (5134b), assets/cs_drama.json (6082b), assets/cs_narrative.json (3231b), assets/cs_sound.json (2231b), assets/storyboard_template.html (13976b), README.md (9821b), references/examples/example_1_creative_film.md (7068b), references/examples/example_2_multi_shot.md (4696b), references/examples/example_3_short_drama.md (7201b), references/modes_detail.md (6468b), references/phases_detail.md (4227b), references/pre_flight_checklist.md (6048b), references/prompt_engineering.md (4583b), references/seedance_v2_rules.md (11070b), references/short_drama_consistency.md (5572b), references/terminology.md (7809b), scripts/api_server.py (9987b), scripts/batch_runner.py (7769b), scripts/director_validator.py (28462b), scripts/llm_router.py (18654b), scripts/mad_story_engine.py (80931b), scripts/platform_adapter.py (8194b), skill-card.md (3310b), SKILL.md (7614b), _meta.json (127b)","readmeExcerpt":"Skill: Madstory(Seedance Storyboard Engine) Owner: qomob Summary: 电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途 Tags: latest:3.4.4 Version history: v3.4.4 | 2026-08-","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"🎬 分镜状态看板\n├── [Mode 选择] ✅ 已完成 — {模式名}\n├── [Phase 0-7] 🟡 推导中 — 当前 Phase {N}\n├── [提示词生成] 🔵 等待中\n└── [Pre-flight 预检] 🔵 等待中"},{"language":"text","snippet":"mad-story/\n├── SKILL.md # 技能定义 v3.8.0 — 分层加载/双版本(2.5默认+2.0降级)/11模式\n├── README.md # 使用说明\n├── references/\n│ ├── seedance_25_rules.md # Seedance 2.5 完整规则（默认基准） (Layer 1)\n│ ├── modes_detail.md # 11种模式详细说明 (Layer 1)\n│ ├── phases_detail.md # Phase 0-7 详细推导指引 (Layer 1)\n│ ├── prompt_engineering.md # 4段式主公式+专项公式索引+5层元素检查清单 (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范（降级备选） (Layer 1)\n│ ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)\n│ ├── terminology.md # 影视分镜专业术语库 (Layer 1)\n│ ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度） (Layer 1)\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)\n│ ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表 — 镜头语言/光影/声音/导演参考（单一数据源）\n └── storyboard_template.html # 分镜预览模板"},{"language":"text","snippet":"Phase 7 输出提示词 → 用户生成视频 → 观察结果 → 报告缺陷类型\n ↓\n DEFECT_LOG（按 Mode 累积）\n ↓\n 下次该 Mode 的 Phase 7:\n 1. 检查 DEFECT_LOG 高频缺陷\n 2. 在 NEGATIVE_PROMPT 追加针对性保护词\n 3. 在输出中增加 KNOWN_RISKS 警告"},{"language":"text","snippet":"DEFECT_LOG:\n mode: [模式名]\n defect_type: [face_drift | object_deformation | motion_glitch | texture_collapse | color_shift | other]\n severity: [high | medium | low]\n timestamp: [在视频中出现的时间点，如 \"8-10s\"]\n description: [一句话描述具体问题]\n prompt_used: [当时的 STANDARD_PROMPT 摘要]"},{"language":"text","snippet":"Phase 7 输出提示词 → 用户生成视频 → 观察结果 → 报告缺陷\n ↓\n DEFECT_LOG（按 Mode 累积）\n ↓\n 下次生成自动增强 Negative Prompt\n + 增加 KNOWN_RISKS 警告"},{"language":"text","snippet":"mad-story/\n├── SKILL.md # 技能定义 v3.8.0 — 分层加载/双版本(2.5默认+2.0降级)/11模式\n├── README.md # 本文件\n├── references/\n│ ├── seedance_25_rules.md # Seedance 2.5 完整规则（默认基准） (Layer 1)\n│ ├── modes_detail.md # 11种模式详细说明 + Tournament Rubric + 2.5能力增强\n│ ├── phases_detail.md # Phase 0-7(+3.5) 推导指引 + AI可执行性标注 + 时间戳控制\n│ ├── prompt_engineering.md # 4段式主公式+专项公式索引+5层元素检查清单 (Layer 1)\n│ ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范（降级备选）\n│ ├── seedream_4x_rules.md # Seedream 4.x-5.0 Pro 图片生成规范（含 5.0 Pro 专属能力）\n│ ├── terminology.md # 影视分镜专业术语库\n│ ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度）+ Mode 9/10 专项\n│ ├── short_drama_consistency.md # 短剧全流程一致性管控 (Stage A-H)\n│ ├── short_drama_genres.md # 短剧6大题材模板\n│ └── examples/\n│ ├── example_1_creative_film.md\n│ ├── example_2_multi_shot.md\n│ └── example_3_short_drama.md\n└── assets/\n ├── cheat_sheet.json # 参数速查表（单一数据源）\n └── storyboard_template.html # 分镜预览模板"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: mad-story\ndescription: \"电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途的通用AI绘画。\"\nversion: 3.8.0\nauthor: qomob.ai\nlicense: MIT\nmodes: 11\nphases: 8\nplatforms:\n - Trae IDE\n - OpenClaw\n - Dify\n - Coze\n - Claude Desktop / MCP\nreferences:\n - references/seedance_25_rules.md\n - references/modes_detail.md\n - references/phases_detail.md\n - references/prompt_engineering.md\n - references/seedance_v2_rules.md\n - references/seedream_4x_rules.md\n - references/terminology.md\n - references/pre_flight_checklist.md\n - references/short_drama_consistency.md\n - references/short_drama_genres.md\nassets:\n - assets/cheat_sheet.json\n - assets/storyboard_template.html\n---\n\n# MadStory — 电影级影视分镜设计引擎 v3.8.0 (分层加载架构)\n\n## 技能定位\n\nMadStory 是面向电影级内容生产的专业分镜设计引擎，同时支持 **Seedream 4.x/5.x 图片生成**（文生图、图像编辑、参考图生图、多图输入/输出）。\n\n- **触发词**: `影视分镜`, `分镜设计`, `电影分镜`, `广告分镜`, `电商视频`, `UGC广告`, `品牌短片`, `多镜头叙事`, `一镜到底`, `爆款复刻`, `短剧创作`, `从一句话出片`, `AI电影`, `AI视频生成`, `Seedance`, `Seedream`, `分镜脚本`, `视频提示词`, `文生图`, `图生图`, `图像编辑`, `参考图生图`, `短剧剧本`, `微短剧`, `竖屏剧`, `AI短剧`, `短剧分镜`, `短剧编剧`, `锁脸`, `小说改短剧`, `漫剧`, `角色人设`, `时间戳控制`, `超长视频`, `视频延长`, `局部编辑`, `智能编辑`, `白模`, `绿幕`, `BGM分离`, `多语种`, `多宫格分镜`\n- **目标用户**: 电影导演、广告导演、创意总监、影视制作人、电商运营、品牌营销、内容创作者、短剧制作人、零基础创作者、平面设计师\n- **默认时长**: 30 秒 / 镜头（Seedance 2.5 视频），15 秒（Seedance 2.0 降级时），图片模式无时长限制\n- **原生支持平台**: Seedance 2.5（默认）/ 2.0（降级）(视频), Seedream 4.x/5.x/5.0 Pro (图片) — 所有提示词规则、参数体系、质量门禁均基于此二平台校准\n- **兼容输出平台**: Runway Gen-3 / Kling / Sora — 输出的提示词可作为创作起点在这些平台使用，但参数体系（Motion Strength、Negative Prompt 格式、多镜头语法等）需用户自行适配\n\n## 规则版本锁定\n\n> **所有提示词规则、参数建议、质量门禁基于以下平台版本验证。** 平台升级后部分规则可能失效，使用前请核对版本。\n\n| 平台 | 验证版本 | 状态 |\n|------|---------|------|\n| Seedance 2.5 (视频) | **2.5（默认基准）** | 完整规则见 `references/seedance_25_rules.md`；原生30s/超长180s/延长60s/50素材/时间戳/编辑/白模/绿幕/多语种/多人 |\n| Seedance 2.0 (视频) | 2.0（降级备选） | 完整规则见 `references/seedance_v2_rules.md`；积分成本敏感场景使用，不支持2.5新增能力 |\n| Seedream (图片) | 4.0 / 4.5 / 5.0 Lite / **5.0 Pro** | 全部规则基于此版本范围；5.0 Pro 专属能力见 `references/seedream_4x_rules.md` §8.5 |\n\n### Seedance 2.5 vs 2.0 快速对照\n\n| 维度 | 2.5（默认） | 2.0（降级） |\n|------|------------|------------|\n| 单次时长 | 30s（可延长至60s，超长模式180s） | 15s |\n| 参考图 | ≤30 张 | ≤9 张 |\n| 参考视频 | ≤10 段，总≤30s | ≤3 段，总≤15s |\n| 参考音频 | ≤10 段，总≤30s | ≤3 段，总≤15s |\n| 仅传音频 | 支持 | 不支持（必须配图/视频） |\n| 时间戳控制 | 原生秒级/帧级 | 无 |\n| 局部编辑/白模/绿幕 | 支持 | 不支持 |\n| BGM 分离/多语种/多人 | 支持 | 不支持 |\n| 积分消耗（30s 720p） | ~780 | ~210（15s） |\n\n## AI 模型真实限制（必读）\n\n> 以下限制基于 Seedance 2.5 / 2.0 / Seedream 4.x-5.x 的实际生成表现。**2.5 在时长/复杂动作/一致性/Negative 响应/多人/多语种上均有显著改善**。完整对照见 `references/seedance_25_rules.md` §8。\n\n| 限制 | 2.0 表现 | 2.5 改善 | 对策 |\n|------|---------|---------|------|\n| **时长衰减** | 8-12s 后质量下降，15s 末段纹理崩坏 | 30s 保持一致性 | 2.5 可放心用 30s；2.0 降级仍优先 ≤10s，必须 15s 时标注\"8s 后质量风险区\" |\n| **复杂动作不稳定** | 开门/打斗/转身等多步骤动作易变形 | 长尾动作解锁，"},{"path":"README.md","content":"# MadStory: 电影级影视分镜设计引擎 v3.8.0\n\n[](https://opensource.org/licenses/MIT)\n[](https://qomob.ai)\n[](https://clawhub.ai/qomob/mad-story)\n\n**MadStory** 是一款电影级影视分镜设计引擎。它将模糊的创作意图，通过 8 阶段专业推导流程，逐步转化为包含构图、运镜、光影、表演调度、声音设计等全维度细节的专业分镜提示词。\n\n- **原生平台**: Seedance 2.5（默认）/ 2.0（降级）(视频) + Seedream 4.x/5.x/5.0 Pro (图片)\n- **兼容输出**: Runway / Kling / Sora（参数需用户自行适配）\n\n## 与其他 AI 分镜工具的区别\n\n| 维度 | 典型 AI 分镜工具 | MadStory v3.8 |\n|------|----------------|---------------|\n| **专业理论** | 提示词模板堆砌 | 电影导演工作流：表演调度 + 剪辑理论 + 声音分类论 |\n| **知识诚实** | 声称支持所有功能 | 区分 `[模型可执行]` vs `[导演参考]`，不假装 AI 能做它做不到的事 |\n| **学习能力** | 静态知识库 | DEFECT_LOG 反馈回路——从每次生成结果中持续优化 |\n| **平台诚实** | \"支持所有平台\" | 原生 vs 兼容分层声明 + 规则版本锁定 + **双版本策略(2.5默认/2.0降级)** |\n| **模型限制** | 隐藏缺陷 | 公开声明已知限制及对策，**2.5 vs 2.0 双版本对照** |\n\n## v3.8.0 更新内容\n\n- **新增 Seedance 2.5 全面能力内化（默认基准）**：30s 原生生成、180s 超长视频、60s 视频延长、时间戳帧级控制、50 多模态参考（30图+10视频+10音频）、智能编辑、白模预演、绿幕合成、BGM 分离、多语种（10+ 语种）、多人参考、无缝转场、多宫格分镜\n- **新增 双版本策略**：2.5 为默认基准，2.0 降级为成本敏感备选。所有规则/参数/质量门禁基于双版本对照校准\n- **新增 2 个创作模式（9→11）**：Mode 9 智能编辑（局部消除/替换/空间视角修改/BGM分离/绿幕）、Mode 10 白模预演（Maya/Blender 粗/细颗粒度渲染）\n- **新增 4 段式提示词主公式**：素材描述+一句话概述+具体情节+全局补充。原 5 层结构降级为元素完整性检查清单\n- **新增 专项公式索引**：7 维人物公式、30s 3 模块公式、超长视频公式、视频延长公式、智能编辑公式、白模公式、时间戳控制公式\n- **新增 seedance_25_rules.md**：2.5 完整规则独立文件（参数规格/16项能力/转场表/Negative禁止项/AI限制2.5改善对照）\n- **升级 Negative Prompt**：2.5 用\"禁止\"表述响应更好（2.0 仍用 `no xxx`）\n- **升级 现有 9 个模式**：均新增「2.5 能力增强」小节，标注各自可用的 2.5 新能力\n\n## v3.7.0 更新内容\n\n- **新增 Seedream 5.0 Pro 全部专属能力**: 交互式精准编辑（坐标/框选/标注框）、高密度信息呈现、原生多语种文字渲染、影视感自动增强、人像质感（毛孔级）、Visual CoT 空间推理、多轮对话式编辑、PNG 透明背景输出\n- **新增 版本能力对照速查表**: 4.0/4.5/5.0 Lite/5.0 Pro 四版本 14 项能力对比矩阵\n- **优化 seedream_4x_rules.md**: 从覆盖 4.0-5.0 Lite 扩展为 4.0-5.0 Pro，新增 §8.5（8 个 Pro 专属子章节）+ §9（版本对照表）+ §10.8（Pro 专属示例）\n\n## v3.6.0 更新内容\n\n- **新增 生成结果反馈回路 (DEFECT_LOG)**: 用户返回生成缺陷 → 按 Mode 累积 → 下次生成自动增强 Negative Prompt 和 KNOWN_RISKS。从静态知识库变成动态经验库\n- **新增 AI 模型真实限制声明**: 公开声明时长衰减(8-12s)、复杂动作不稳定、跨镜头一致性靠运气等 5 类已知限制及对策\n- **新增 规则版本锁定**: 所有规则标注验证平台版本，平台升级后用户可判断哪些规则仍有效\n- **新增 AI 可执行性标注**: Phase 3.5/2/6 每项内容标注 `[模型可执行]` 或 `[导演参考]`，区分\"AI 能做到\"和\"仅供创作决策\"\n- **新增 Phase 3.5 表演与调度**: 走位(Blocking)、视线匹配(Eyeline)、反应镜头策略、潜台词表演(Subtext)\n- **新增 剪辑理论集成**: Phase 2 接入 L-Cut/J-Cut/Jump Cut/Match Cut/Smash Cut/Montage + 景别递进 + 180 度线规则\n- **新增 Tournament 评分 Rubric**: 3 维加权（独特性 40% + 一致性 30% + 情感 30%）+ 安全方案惩罚 + 防同质化规则\n- **新增 Phase 0 时长充分性检查**: 主动评估 15s 是否够用，不够则建议拆分\n- **新增 声音来源分类**: Diegetic / Non-Diegetic / Trans-diegetic 三层决策\n- **优化 数据架构**: 删除 5 个冗余 JSON 文件，cheat_sheet.json 成为唯一数据源\n- **优化 平台声明**: 区分原生支持（Seedance/Seedream）与兼容输出（Runway/Kling/Sora）\n- **优化 短剧工作流**: 明确 Stage A-H 为主线、Phase 0-7 为子流程的映射关系\n- **优化 提示词工程文件**: 消除 prompt_engineering.md 与 seedance_v2_rules.md 40% 内容重复\n- **优化 清理 5 处 no-op**: 将空泛指导替换为可执行规则\n\n## 11 种创作模式\n\n| 模式 | 适用场景 | 输入方式 | 核心约束 |\n|------|---------|----------|------------------|\n| **电影创意探索** | 概念开发、风格实验 |"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn72r3ww47r1qyfaf233sf7q1982rh5f\",\n \"slug\": \"madstory\",\n \"version\": \"3.4.4\",\n \"publishedAt\": 1786107131713\n}"},{"path":"references/examples/example_1_creative_film.md","content":"# 案例 1: 电影创意探索 — 《城市孤岛》概念短片\n> **Mode**: `creative_film` (Mode 0) | **平台**: Seedance 3.0 | **时长**: 30s | **风格**: 塔可夫斯基式诗意现实主义\n\n## 用户输入 (Raw Input)\n\n```\n我想做一个关于\"城市里孤独的人\"的短视频，要有电影感，不要太俗套的那种。\n```\n\n## 分镜推导过程\n\n### 创意方向筛选\n\n引擎并行生成 3 个创意方向，通过评分矩阵筛选：\n\n| 方向 | 导演参照 | 视觉核心 | 情绪弧线 | 评分 |\n|------|---------|---------|---------|------|\n| A: 雨夜窗景 | 王家卫 | 湿玻璃反射 + 霓虹虚化 | 孤独→温暖(?) | 6.5 |\n| B: 地铁长镜头 | 贾樟柯 | 手持跟拍 + 人群流动 | 疏离→融入→疏离 | 8.2 |\n| C: 废墟花园 | 塔可夫斯基 | 固定机位 + 光影流转 | 寂静→顿悟 | **8.8** |\n\n**选定方向**: C（独特性 + 情感深度最优）\n\n### Shot 1: 开场 — 废墟中的光 (0-8s)\n- **STANDARD_PROMPT**: `A solitary figure stands motionless in an abandoned rooftop garden overgrown with wild grass, shafts of golden hour sunlight pierce through broken concrete pillars, dust particles float in slow motion, the figure's silhouette barely visible against the intense backlight, cinematic wide shot, static camera, anamorphic lens flare, muted earth tones with selective color on a single red flower`\n- **CAMERA**: Static wide shot (固定广角)\n- **MOTION_STRENGTH**: 2\n- **LIGHTING**: Natural golden hour backlighting through architectural gaps, high contrast between shadow and light pools\n\n### Shot 2: 中段 — 凝视 (8-18s)\n- **STANDARD_PROMPT**: `Close-up of weathered hands holding a small cracked mirror, reflecting fragments of the city skyline beyond the garden fence, shallow depth of field, the reflection shifts subtly as wind moves the mirror angle, warm skin tones against cool blue city background, gentle handheld micro-movements`\n- **CAMERA**: Extreme close-up with subtle handheld drift\n- **MOTION_STRENGTH**: 3\n- **LIGHTING**: Mixed warm (skin/mirror) and cool (city reflection)\n\n### Shot 3: 结尾 — 回归 (18-30s)\n- **STANDARD_PROMPT**: `The figure now sits on the edge of the rooftop, legs dangling over the cityscape below, camera slowly pulls back (dolly out) revealing the vast urban landscape at dusk, thousands of windows beginning to glow like stars, the figure becomes smaller but no longer alone in frame — the city itself becomes a companion, final frame holds on this composition`\n- **CAMERA**: Slow dolly out (缓慢后拉)\n- **MOTION_STRENGTH**: 4\n- **LIGHTING**: Magic hour transition to blue hour, city lights gradually illuminating\n\n## 完整输出 JSON\n\n```json\n{\n \"STANDARD_PROMPT\": \"A cinematic three-shot sequence exploring urban solitude through poetic visual metaphor: [Shot 1] Abandoned rooftop garden, golden hour light through broken concrete, solitary silhouette, static wide shot, anamorphic lens. [Shot 2] Weathered hands holding cracked mirror reflecting city skyline, extreme close-up, shallow DOF, handheld drift. [Shot 3] Figure sitting on rooftop edge, slow dolly out revealing vast dusk cityscape, transition from isolation to cosmic connection.\",\n \"NEGATIVE_PROMPT\": \"no generic composition, no cliché visual language, no random style mixing, no emotional disconnect, no flat narrative, no derivative imagery, no shaky camera without motivation, no oversaturated colors, no text overlay, no watermark\",\n \"TIMELINE\": \"0-8s: Establ"},{"path":"references/examples/example_2_multi_shot.md","content":"# 案例 2: 多镜头叙事 — 咖啡品牌故事\n> **Mode**: `multi_shot` (Mode 4) | **平台**: Runway Gen-3 | **时长**: 3 shots × 5s = 15s\n\n## 用户输入\n\n```\n为一个精品咖啡品牌做一支15秒品牌广告，要有温度感，重点展示咖啡豆到杯子的过程。\n```\n\n## 分镜方案\n\n### Shot 1 (0-5s)\n- **画面**: 咖啡农的手采摘成熟的红樱桃咖啡果，晨光穿过树叶洒在手上，清晰可见的露珠和果实色泽\n- **景别**: 特写\n- **运镜**: 缓推\n- **光影**: 暖金色晨光 (Golden Hour)\n\n### Shot 2 (5-10s)\n- **画面**: 新鲜烘焙的咖啡豆从烘焙机中倾泻而出，热气腾腾，近距离展示豆子的油亮表面和色泽\n- **景别**: 极近特写\n- **运镜**: 微距跟踪\n- **光影**: 暖黄工业光\n\n### Shot 3 (10-15s)\n- **画面**: 手冲咖啡水流穿过咖啡粉，琥珀色液体滴入杯中，背景虚化中隐约可见咖啡农的微笑\n- **景别**: 俯拍特写转中景\n- **运镜**: 垂直俯拍到缓拉\n- **光影**: 侧逆光突出液体通透感\n\n## 完整输出 JSON\n\n```json\n{\n \"STANDARD_PROMPT\": \"[Shot 1] Hands of a coffee farmer picking ripe red cherries, golden morning light filtering through leaves, dewdrops and fruit texture clearly visible, macro extreme close-up, slow push-in, cinematic warm tones. [Shot 2] Freshly roasted coffee beans cascading from roaster, steam rising, oily surfaces glistening, extreme close-up, macro tracking shot, warm industrial lighting. [Shot 3] Pour-over coffee stream through grounds, amber liquid dripping into glass carafe, farmer's smile softly visible in bokeh background, top-down macro to mid-length slow pull-out, side-backlight highlighting liquid translucency.\",\n \"NEGATIVE_PROMPT\": \"no inconsistent lighting between shots, no drift in color grading, no mismatch in product appearance, no jumpy transitions, no flat blacks\",\n \"TIMELINE\": \"0-5s: Farm harvest; 5-10s: Roasting process; 10-15s: Final brewing\",\n \"CAMERA\": \"Slow push-in → Macro tracking → Top-down pull-out\",\n \"MOTION_STRENGTH\": 4,\n \"DURATION\": \"5+5+5=15s\",\n \"MODE\": \"多镜头叙事\",\n \"MODE_KEY\": \"multi_shot\",\n \"MULTI_MODAL_ADVICE\": \"统一色温: 暖色调贯穿三镜头; 建议上传参考图确保咖啡豆/杯具的品牌一致性\",\n \"SOUND_DESIGN\": \"Acoustic guitar + ambient farm nature sounds → roasting crackle → pour-over drip\",\n \"SHOT_LIST\": [\n {\"shot_id\": 1, \"duration\": \"5s\", \"scene\": \"coffee_farm_harvest\", \"focus\": \"hands_and_cherries\"},\n {\"shot_id\": 2, \"duration\": \"5s\", \"scene\": \"roasting_facility\", \"focus\": \"beans_cascading\"},\n {\"shot_id\": 3, \"duration\": \"5s\", \"scene\": \"brew_bar\", \"focus\": \"pour_over_drip\"}\n ]\n}\n```\n\n## Quality Checklist\n\n| 检查项 | 状态 |\n|--------|------|\n| 镜头数量 ≤ 3 | PASS (3 shots) |\n| 跨镜头风格一致 | PASS (统一暖色调) |\n| Negative Prompt 完整 | PASS |\n| 单镜头单运动原则 | PASS |"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途 Skill: Madstory(Seedance Storyboard Engine) Owner: qomob Summary: 电影级影视分镜设计引擎，支持视频生成(Seedance 2.5默认/2.0降级/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。11种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设/时间戳控制/超长视频/视频延长/局部编辑/智能编辑/白模/绿幕/BGM分离/多语种/多宫格分镜。不适用于纯静态视觉设计或非分镜用途 Tags: latest:3.4.4 Version history: v3.4.4 | 2026-08-","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1383,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T05:31:42.752Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:45:09.822Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}