cerevox 4.72.1 → 4.74.0

package/dist/utils/director-note-tpl.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.directorNoteTemplate = directorNoteTemplate;
+const directorNoteIntensityMap = {
+    balanced: `【导演倾向】表达克制，重点清楚，适合稳定叙事和清晰执行。`,
+    strong: `【导演倾向】重点更鲜明，强调情绪重音、机位设计和氛围控制。`,
+    aggressive: `【导演倾向】风格更强，允许更明显的视觉压迫、镜头攻击性和情绪张力。`,
+};
+/**
+ * 生成适合 gpt-image-2 的导演手记提示词。
+ *
+ * @param params 模板参数，包括用户剧情、页宽高比、参考视频时长和镜头强度。
+ * @returns 适合用于生成单页导演手记的英文主提示词。
+ *
+ * @example
+ * ```ts
+ * const prompt = directorNoteTemplate({
+ *   userPrompt: '两名杀手在废弃工厂短暂对峙后突然交火，最后一人中枪倒地。',
+ *   page_aspect_ratio: '16:9',
+ *   forVideoDuration: 12,
+ * });
+ * ```
+ */
+function directorNoteTemplate(params) {
+    const { userPrompt, page_aspect_ratio = '16:9', forVideoDuration, maxVideoDuration = 15, cinematicIntensity = 'strong', } = params;
+    const normalizePositiveDuration = (value) => {
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+        return undefined;
+    };
+    const safeMaxVideoDuration = normalizePositiveDuration(maxVideoDuration) ?? 15;
+    const normalizedTargetDuration = normalizePositiveDuration(forVideoDuration);
+    const effectiveTargetDuration = normalizedTargetDuration !== undefined
+        ? Math.min(normalizedTargetDuration, safeMaxVideoDuration)
+        : undefined;
+    const videoDurationRule = effectiveTargetDuration !== undefined
+        ? `
+【目标时长】
+- 目标视频时长：${effectiveTargetDuration} 秒
+- 最大允许时长：${safeMaxVideoDuration} 秒
+- 若用户要求超过 ${safeMaxVideoDuration} 秒，也只按 ${safeMaxVideoDuration} 秒的短片段来写导演手记
+- 这是一个短片段导演手记，不是完整长片分镜
+`.trim()
+        : `
+【目标时长】
+- 默认按不超过 ${safeMaxVideoDuration} 秒的视频片段来写导演手记
+- 这是一个短片段导演手记，不是完整长片分镜
+`.trim();
+    const intensityBlock = directorNoteIntensityMap[cinematicIntensity] ??
+        directorNoteIntensityMap.strong;
+    return `You are an experienced but slightly lazy film director writing a concise handwritten director note page for GPT Image 2.
+
+【Core Goal】
+- Create one single composed director note page, not a detailed storyboard sheet
+- This page is for a short video segment, usually no more than ${safeMaxVideoDuration} seconds
+- The director does not care about every single shot
+- The director only cares about the 1 to 2 key shots and the overall execution priorities
+- Focus on what must be emphasized on set, not on exhaustive shot-by-shot breakdown
+
+${videoDurationRule}
+
+【What This Page Is】
+- A director's handwritten memo page
+- Written by an experienced director who knows what matters and ignores unnecessary detail
+- Concise, selective, practical, and visually readable
+- More like a shooting note, reminder sheet, or bedside memo than a full storyboard table
+
+【What This Page Is Not】
+- Not a detailed storyboard
+- Not a frame-by-frame shot list
+- Not a production bible
+- Not a dense technical worksheet
+
+【Layout Requirements】
+- Output one complete page
+- Overall page aspect ratio: ${page_aspect_ratio}
+- The page should feel like a handwritten director memo pinned to preproduction materials
+- Use a clean layout with a title area, a whole-sequence rhythm overview area, 1 to 2 key-shot blocks, a blocking sketch area, and several concise handwritten note areas
+- The page must remain simple and selective, not crowded
+
+【Top Area】
+- Include a simple Chinese title
+- Include a short Chinese line for style or atmosphere
+- Include a short Chinese line for target duration
+- The title area should feel natural and handwritten, not like a corporate form
+
+【Whole-Sequence Rhythm Overview】
+- Include one overall rhythm overview diagram showing the full flow from beginning to end
+- This overview should summarize the whole short clip rather than break it into detailed shot rows
+- Use only very rough stick-figure actions, radish-man gestures, arrows, simple beats, and spatial placeholders
+- Do not render any recognizable face, costume, hairstyle, anatomy detail, or identity trait in this overview
+- The rhythm overview should show a concise progression such as:
+  - 起
+  - 承
+  - 转
+  - 合
+- Or equivalent beginning-to-ending beat steps if the scene needs another rhythm pattern
+- Add very short handwritten Chinese notes for each beat explaining what changes emotionally or visually
+- Keep the rhythm overview schematic, fast, and director-like, not polished or literal
+- The purpose is to explain the overall flow, escalation, turning point, and ending impression of the clip
+
+【Key Shot Requirements】
+- Include only 1 or 2 truly important key shots
+- Each key shot should be treated as a priority image block
+- Key-shot drawings must be extremely rough director-note sketches, closer to stick figures, radish-man mannequins, gesture lines, and body mass placeholders than finished character art
+- Do not render identifiable faces, hairstyles, costumes, body details, or character design features
+- Do not include any recognizable appearance traits that could contaminate downstream video creation
+- For each key shot, indicate:
+  - what the shot is trying to achieve emotionally
+  - the main camera position
+  - the main lens feeling or camera language
+  - what the audience must notice
+- Key shots should feel decisive and memorable
+- Do not break the whole sequence into many small rows
+
+【Blocking Sketch Requirements】
+- If there are multiple actors, include a top-down blocking sketch
+- The blocking sketch should show rough actor positions, camera position, movement direction if needed, and key spatial relation
+- Use only extremely simplified human markers, like stick figures, oval heads, radish-man bodies, arrows, and spatial placeholders
+- Keep the top-down sketch simple, functional, and readable
+- Never render top-view costumes, face details, or identifiable silhouettes
+- If there is only one actor or no actor, the blocking sketch can simplify into a camera-to-space relation note
+
+【Director Priority Notes】
+- The page should include concise handwritten Chinese notes about:
+  - 摄影师机位
+  - 演员站位
+  - 关键布景
+  - 布光重点
+  - 氛围控制
+  - 演员微表情与情绪调动
+  - 色彩搭配
+  - 音乐音效
+  - 关键台词
+- These notes should only highlight what matters most
+- Do not try to explain everything
+
+【Camera Guidance】
+- Mention only the main camera idea for the important shots
+- Use concise professional Chinese phrases such as:
+  - 中近景慢推
+  - 低机位压迫
+  - 手持逼近
+  - 高机位俯压
+  - 弧线环绕
+  - 希区柯克变焦
+  - 长焦压缩
+- Camera notes must feel like an experienced director giving shorthand instructions to the cinematographer
+
+【Performance Guidance】
+- If actors are present, include very concise performance direction
+- Emphasize subtle facial control, eye focus, breath rhythm, hesitation, anger suppression, fear buildup, coldness, or emotional release when relevant
+- These notes should feel like emotional triggers for actors, not long acting theory
+- Express performance primarily through posture, head direction, gesture tendency, body tension, and short handwritten actor notes rather than detailed face drawing
+
+【Set, Lighting, and Atmosphere Guidance】
+- Highlight only the most important set pieces or environmental anchors
+- Highlight the lighting logic using concise Chinese notes such as:
+  - 主光冷
+  - 背后轮廓光
+  - 面部留暗
+  - 实景灯偏暖
+  - 雾气压空间
+- Highlight atmosphere using short Chinese phrases such as:
+  - 压抑
+  - 冷峻
+  - 潮湿
+  - 热烈
+  - 末日感
+  - 静压
+- Let the visual page communicate mood more than the text does
+
+【Color and Sound Guidance】
+- Include a small color note area
+- Include a small music and sound note area
+- Color notes should focus on palette pairing and emotional function
+- Sound notes should focus on music entry, silence, key impact sound, ambient texture, or one important line
+- Keep all sound and color notes concise
+
+【Text Style Rules】
+- All visible text inside the generated image must be Chinese only
+- The text should look like Chinese handwritten director notes
+- Keep the text brief, fragmented, practical, and selective
+- Prefer short labels, short reminders, and concise note fragments
+- Do not generate long paragraphs
+- Do not generate neat spreadsheet tables
+- Do not generate too many headings
+
+【Visual Style Rules】
+- The page should look more like a handwritten creative memo than a formal storyboard
+- It should feel cinematic, selective, and experienced
+- The visual focus should still be on key-shot sketches, blocking sketch, and a few handwritten annotations
+- All figure drawings must stay at the level of rough symbolic placeholders, mannequin blocks, stick figures, or radish-man sketches
+- The drawings should communicate staging and emphasis, not character appearance
+- Avoid polished anatomy, facial features, hair detail, costume rendering, or any distinctive look
+- Leave breathing room
+- Avoid clutter
+
+【Selection Logic】
+- Prioritize what will most affect the final shot quality
+- Ignore trivial execution details
+- Show only the details a tired but sharp director would bother to write down
+- If something is obvious, do not over-explain it
+- If something is crucial, make it visually prominent
+
+${intensityBlock}
+
+【User Input】
+${userPrompt}
+
+【Final Output】
+- One single-page director note
+- One whole-sequence rhythm overview diagram from beginning to end
+- 1 to 2 key-shot sketches only
+- One blocking top-view sketch if multiple actors are involved
+- Several concise handwritten Chinese note areas
+- Clear emphasis on camera, blocking, lighting, atmosphere, performance, color, sound, and key line
+- Human figures, if present, must be extremely rough and non-identifiable
+- Keep it selective, useful, and director-like`.trim();
+}
+//# sourceMappingURL=director-note-tpl.js.map

package/dist/utils/director-note-tpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"director-note-tpl.js","sourceRoot":"","sources":["../../src/utils/director-note-tpl.ts"],"names":[],"mappings":";;AA+BA,oDA8NC;AAnPD,MAAM,wBAAwB,GAAuC;IACnE,QAAQ,EAAE,8BAA8B;IACxC,MAAM,EAAE,+BAA+B;IACvC,UAAU,EAAE,mCAAmC;CAChD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,oBAAoB,CAClC,MAAkC;IAElC,MAAM,EACJ,UAAU,EACV,iBAAiB,GAAG,MAAM,EAC1B,gBAAgB,EAChB,gBAAgB,GAAG,EAAE,EACrB,kBAAkB,GAAG,QAAQ,GAC9B,GAAG,MAAM,CAAC;IAEX,MAAM,yBAAyB,GAAG,CAChC,KAAuB,EACH,EAAE;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,oBAAoB,GACxB,yBAAyB,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,wBAAwB,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IAC7E,MAAM,uBAAuB,GAC3B,wBAAwB,KAAK,SAAS;QACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,oBAAoB,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GACrB,uBAAuB,KAAK,SAAS;QACnC,CAAC,CAAC;;WAEG,uBAAuB;WACvB,oBAAoB;YACnB,oBAAoB,UAAU,oBAAoB;;CAE7D,CAAC,IAAI,EAAE;QACF,CAAC,CAAC;;WAEG,oBAAoB;;CAE9B,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,cAAc,GAClB,wBAAwB,CAAC,kBAAkB,CAAC;QAC5C,wBAAwB,CAAC,MAAM,CAAC;IAElC,OAAO;;;;iEAIwD,oBAAoB;;;;;EAKnF,iBAAiB;;;;;;;;;;;;;;;;+BAgBY,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkI9C,cAAc;;;EAGd,UAAU;;;;;;;;;;+CAUmC,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/utils/{environment-board-tpl.d.ts → environment-card-tpl.d.ts}

@@ -1,25 +1,23 @@
 import type { CinematicIntensity, PageAspectRatio } from './storyboard-tpl';
-export interface EnvironmentBoardTemplateParams {
+export interface EnvironmentCardTemplateParams {
     userPrompt: string;
     page_aspect_ratio?: PageAspectRatio;
-    maxPanels?: number;
     cinematicIntensity?: CinematicIntensity;
 }
 /**
- * 生成导演级 Environment Board 提示词，用于锁定同一拍摄场景的空间一致性，
- * 并输出带导演手册说明的环境设定板。
+ * 生成导演级 Environment Card 提示词，用于锁定同一拍摄场景的空间一致性，
+ * 并输出场景设定卡风格的环境设定图。
  *
- * @param params 模板参数，包括用户场景描述、画面比例、面板数量和镜头强度。
+ * @param params 模板参数，包括用户场景描述、画面比例和镜头强度。
  * @returns 适合生成单页环境设定板加导演手册的完整提示词。
  *
  * @example
  * ```ts
- * const prompt = environmentBoardTemplate({
+ * const prompt = environmentCardTemplate({
  *   userPrompt: '废弃地铁站月台，漏水、闪烁灯管、旧广告牌、冷蓝色夜景氛围',
  *   page_aspect_ratio: '16:9',
- *   maxPanels: 6,
  * });
  * ```
  */
-export declare function environmentBoardTemplate(params: EnvironmentBoardTemplateParams): string;
-//# sourceMappingURL=environment-board-tpl.d.ts.map
+export declare function environmentCardTemplate(params: EnvironmentCardTemplateParams): string;
+//# sourceMappingURL=environment-card-tpl.d.ts.map

package/dist/utils/environment-card-tpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-card-tpl.d.ts","sourceRoot":"","sources":["../../src/utils/environment-card-tpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,MAAM,CAmKR"}

package/dist/utils/environment-card-tpl.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.environmentCardTemplate = environmentCardTemplate;
+const environmentIntensityMap = {
+    balanced: `【镜头变化强度】空间展示清晰克制，优先让场景结构、出入口和动线一目了然。`,
+    strong: `【镜头变化强度】在保持空间可读性的前提下，增加景别对比和导演感。`,
+    aggressive: `【镜头变化强度】镜头角度更戏剧化，允许更强的构图张力，但不能破坏空间连续性。`,
+};
+/**
+ * 生成导演级 Environment Card 提示词，用于锁定同一拍摄场景的空间一致性，
+ * 并输出场景设定卡风格的环境设定图。
+ *
+ * @param params 模板参数，包括用户场景描述、画面比例和镜头强度。
+ * @returns 适合生成单页环境设定板加导演手册的完整提示词。
+ *
+ * @example
+ * ```ts
+ * const prompt = environmentCardTemplate({
+ *   userPrompt: '废弃地铁站月台，漏水、闪烁灯管、旧广告牌、冷蓝色夜景氛围',
+ *   page_aspect_ratio: '16:9',
+ * });
+ * ```
+ */
+function environmentCardTemplate(params) {
+    const { userPrompt, page_aspect_ratio = '16:9', cinematicIntensity = 'strong', } = params;
+    const intensityBlock = environmentIntensityMap[cinematicIntensity] ??
+        environmentIntensityMap.strong;
+    const topologyRule = `
+【空间拓扑复杂度规则】
+- 不要根据固定格数切分画面
+- 画面模块数量只由场景本身的空间拓扑复杂度决定
+- 如果场景结构简单，可只保留中央总览和少量关键辅助视图
+- 如果场景结构复杂，可自然增加必要的局部空间视图与细节图
+- 始终优先保证空间关系表达清楚，而不是追求固定数量的画格
+`.trim();
+    const finalOutputRule = `
+【最终输出】
+- 一张比例为 ${page_aspect_ratio} 的场景设定卡 / environment card
+- 以一个中央大总览图为核心，辅以按空间复杂度自然决定数量的局部视图与细节图
+- 所有视图共同描述同一个拍摄场景，不得变成多个不同地点
+- 适合作为导演、美术、置景、摄影统一理解空间与氛围的参考板
+`.trim();
+    return `You are creating a single scene setting card style environment card for one continuous filming location.
+
+【Core Goal】
+- Create one single composed environment card, not multiple separate images
+- The board must lock the spatial continuity of one location across one master overview and several supporting views
+- This is a scene setting card, not a storyboard page, not a character sheet, and not a dense handbook
+- Show only the environment and static set dressing, with no actors, no people, and no living subjects
+- The page must primarily emphasize architecture, room layout, atmosphere, lighting, materials, and spatial continuity
+- The final result should resemble a well-designed production art setting card similar to the reference style: central overview, side views, detail views, and small labels
+
+【Environment Locking Rules】
+- All panels must depict the exact same location
+- Keep architecture, terrain, entrances, exits, windows, pathways, stairs, props, furniture, signage, and light sources spatially consistent
+- Time of day, weather, lighting direction, color temperature, atmosphere, and material language must remain consistent across all panels
+- If the user mentions multiple beats or actions, extract only the environment and spatial information, not human performance
+- If the user mentions people, treat them only as context for scale or usage of the space, but do not render any person, silhouette, reflection, shadow figure, hand, or body part
+
+【Reference Layout Requirements】
+- Use a setting-card layout strongly inspired by the reference image format
+- Place one large central master view as the visual anchor
+- This central master view should preferably be an axonometric, isometric, cutaway, dollhouse, or sectional overview of the space
+- The central overview must clearly explain how the major rooms or functional zones connect
+- Put smaller supporting views on the left and right sides
+- Put detail views or material close-ups along the bottom band
+- Add a title bar at the top and a small material/legend area near the central overview
+- The page should feel like a production design board for one scene location
+
+【Central Master Overview】
+- The central image must be the largest and most informative view on the page
+- Prefer an isometric or cutaway overview when architecture or room connection matters
+- Label important room names or functional zones directly on the central overview in concise Chinese
+- The central overview should show room structure, circulation, entries, openings, roof shape, and core furnishing anchors
+- Make this master overview clean, readable, and diagram-like while still visually beautiful
+
+【Supporting View Rules】
+- The left and right side panels should show supporting views of the same place
+- Use these supporting views for:
+  - room front view
+  - room side view
+  - entrance view
+  - corner view
+  - depth view
+  - interior atmosphere view
+  - key functional area view
+- These supporting views should feel like stills or concept frames of the same location
+- Each supporting view should highlight a different useful angle or sub-space without changing the underlying set
+
+【Bottom Detail Rules】
+- The bottom row should contain 2 to 4 detail panels
+- Use them for important set details such as:
+  - door or window detail
+  - roof or ceiling detail
+  - wall texture detail
+  - material or construction detail
+  - table, stove, shelf, shrine, storage, tools, or other signature objects
+- These detail images should strengthen authenticity and set-building clarity
+
+【Material and Construction Notes】
+- Include a small legend or material note area if the setting benefits from it
+- This area can identify 2 to 4 important materials, textures, or construction methods
+- Keep this legend visually compact and secondary
+- It should feel like a real set-design annotation, not an academic blueprint
+
+【Composition Rules】
+- Output one complete board with a clean, readable, production-friendly layout
+- Overall page aspect ratio: ${page_aspect_ratio}
+- The board should read like a production designer's setting card for one location
+- The composition must be dominated by the central overview, with smaller satellite views around it
+- The page must feel like one unified professional scene-setting board, not a random collage
+- Vary viewpoints, but do not break spatial logic
+- Make the viewer immediately understand the whole set and its important sub-areas
+
+${topologyRule}
+
+【Visual Rules】
+- No actors
+- No people
+- No crowd
+- No silhouette figures
+- No mannequins
+- No portraits
+- No floating character references
+- Static environmental objects are allowed only if they belong to the set and stay spatially grounded
+- Prioritize readable architecture, staging zones, object placement, atmosphere, lighting, and material continuity
+- The environment should feel cinematic, professional, and directly useful for production planning
+- Use professional photography aesthetics that match the user-specified style
+- Push color palette, exposure control, shadow layering, practical light glow, atmospheric perspective, and cinematic contrast to a more advanced level
+- Make the board feel visually premium, with stronger cinematography and production-design sensibility
+- The central overview may be more diagrammatic, while side and bottom views may feel more atmospheric and cinematic
+- Use warm paper-board presentation aesthetics if compatible with the user style
+- The whole page should feel like a handcrafted but polished art department reference sheet
+
+【Style Rules】
+- If the user specifies a style, medium, era, architecture type, or visual mood, follow it strictly
+- If the user does not specify a style, default to: cinematic scene setting card, realistic environment concept art, central cutaway overview, supporting atmosphere stills, refined shadow design, professional film set presentation
+- Maintain one unified visual language across the full board
+- The final image should feel closer to a high-end scene setting card than a technical manual
+- The overall impression should resemble an art department environment sheet rather than a storyboard
+
+【Text Rules】
+- Any visible text inside the generated image must be Chinese only
+- Use concise Chinese printed labels, not large handwritten paragraphs
+- The title may be larger, but panel labels must remain compact
+- Suitable text includes:
+  - scene title
+  - room names
+  - supporting view names
+  - detail names
+  - material legend labels
+- Labels can include numbering like 1), 2), 3) when useful
+- Keep labels neat, production-card-like, and easy to scan
+- Do not generate dialogue balloons or subtitles
+- Avoid large paragraphs and dense handbook notes
+- Prefer short title labels and brief descriptors only
+
+【Spatial Continuity Requirements】
+- Camera angles may change, but the environment cannot drift
+- Preserve the same world orientation, same structural anchors, and same core prop positions
+- The central overview must explain how the other side and bottom views belong to the same place
+- Side and detail views must clearly feel extracted from the central master environment, not from a new location
+
+${intensityBlock}
+
+【Document Realism Rules】
+- Use a clean presentation-card layout
+- The page should look useful to directing, production design, set decoration, lighting, props, and continuity teams
+- Do not make it look like a poster
+- Do not make it look like a text-dense manual sheet
+- Do not make it look like random environment thumbnails without explanation
+- It should look like a premium preproduction scene setting card similar to the reference
+
+【User Input】
+${userPrompt}
+
+${finalOutputRule}`.trim();
+}
+//# sourceMappingURL=environment-card-tpl.js.map

package/dist/utils/environment-card-tpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-card-tpl.js","sourceRoot":"","sources":["../../src/utils/environment-card-tpl.ts"],"names":[],"mappings":";;AA6BA,0DAqKC;AA1LD,MAAM,uBAAuB,GAAuC;IAClE,QAAQ,EAAE,sCAAsC;IAChD,MAAM,EAAE,kCAAkC;IAC1C,UAAU,EAAE,wCAAwC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,uBAAuB,CACrC,MAAqC;IAErC,MAAM,EACJ,UAAU,EACV,iBAAiB,GAAG,MAAM,EAC1B,kBAAkB,GAAG,QAAQ,GAC9B,GAAG,MAAM,CAAC;IAEX,MAAM,cAAc,GAClB,uBAAuB,CAAC,kBAAkB,CAAC;QAC3C,uBAAuB,CAAC,MAAM,CAAC;IAEjC,MAAM,YAAY,GAAG;;;;;;;CAOtB,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG;;UAEhB,iBAAiB;;;;CAI1B,CAAC,IAAI,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAiEsB,iBAAiB;;;;;;;EAO9C,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDZ,cAAc;;;;;;;;;;;EAWd,UAAU;;EAEV,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/utils/npc-card-tpl.d.ts

@@ -0,0 +1,18 @@
+export interface NpcCardTemplateParams {
+    userPrompt: string;
+}
+/**
+ * 构建 NPC 群像设定卡提示词。
+ *
+ * @param params 模板参数，包含用户原始 NPC 群像描述。
+ * @returns 适合生成 NPC 卡片拼图的完整提示词。
+ *
+ * @example
+ * ```ts
+ * const prompt = buildNpcCardPrompt({
+ *   userPrompt: '古代市井中的杂货商、小贩、脚夫、说书人、巡街更夫等一群路人 NPC',
+ * });
+ * ```
+ */
+export declare function buildNpcCardPrompt(params: NpcCardTemplateParams): string;
+//# sourceMappingURL=npc-card-tpl.d.ts.map

package/dist/utils/npc-card-tpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npc-card-tpl.d.ts","sourceRoot":"","sources":["../../src/utils/npc-card-tpl.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAqIxE"}

package/dist/utils/npc-card-tpl.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNpcCardPrompt = buildNpcCardPrompt;
+/**
+ * 构建 NPC 群像设定卡提示词。
+ *
+ * @param params 模板参数，包含用户原始 NPC 群像描述。
+ * @returns 适合生成 NPC 卡片拼图的完整提示词。
+ *
+ * @example
+ * ```ts
+ * const prompt = buildNpcCardPrompt({
+ *   userPrompt: '古代市井中的杂货商、小贩、脚夫、说书人、巡街更夫等一群路人 NPC',
+ * });
+ * ```
+ */
+function buildNpcCardPrompt(params) {
+    const { userPrompt } = params;
+    return `基于用户指令，生成一张专业的 NPC 群像设定卡 / npc card。
+
+用户指令：
+${userPrompt}
+
+---
+
+这不是单个主角角色卡，而是一整组可供影视、动画、游戏或漫画场景反复调用的 NPC 群像设定板。
+整张图需要像 casting board、crowd character sheet、群演角色库 一样，把一批可复用 NPC 以卡片形式平铺在同一张图上。
+
+【核心目标】
+- 根据用户指令生成一群 NPC，而不是 1 个人
+- 在用户许可的范围内尽量提高多样性
+- 如果场景天然要求统一性，则统一中保留少量合理差异
+- 每个职业或角色类型至少有 1 个清晰的全身像
+- 每个角色类型旁边再配若干可替换的脸谱 / 头像小组，形成同类角色的变体池
+- 每张小卡片都要有简短中文说明和中文名字
+- 名字风格以普通 NPC 命名为主，例如：张三、李四、王五、赵六、路人甲、路人乙、店小二甲、巡街兵乙、伙夫丙 等
+
+【场景多样性规则】
+- 如果用户描述的是市井、街市、村落、码头、酒馆、客栈、集市、帮派外围、平民社区、难民营、工业工坊、校园、办公楼、医院走廊等开放人群环境，则尽量提高以下维度的差异：
+  - 年龄
+  - 性别
+  - 职业/分工
+  - 身高
+  - 胖瘦
+  - 发型
+  - 肤色与气质
+  - 着装层级与磨损状态
+  - 姿态习惯
+- 如果用户描述的是军队、警队、门派弟子、修会成员、公司制服员工、工厂班组、护士站、仪仗队、学校校服群体、服务行业标准制服群体等强调纪律和统一性的组织，则应：
+  - 保持整体制服、身份和气质相对统一
+  - 轮廓、配色、装备、站姿更整齐
+  - 年龄与体型差异收敛
+  - 但仍保留少量合理的人脸差异、身形差异、细节穿着差异，避免完全复制粘贴
+
+【人物辨识度规则】
+- 所有 NPC 都要有一定辨识度，但不要像主角或明星角色那样过分突出
+- 面部应当可区分，但整体趋于“平庸化、群像化、配角化”
+- 不要做夸张偶像脸、过强主角光环、过高时尚感或过于戏剧性的个人设计
+- 若用户没有明确指定人物风格，默认按真人写实风格生成
+- 默认人物样貌不能太帅、不能太美，不要有网红感、明星感或主角脸
+- 默认应呈现普通路人、普通群众、普通配角的自然外貌基础，但仍保留一定可区分的五官与气质差异
+- 识别度主要来自年龄层、职业气质、五官组合、体态和穿搭差异，而不是超级吸睛设定
+
+【版式要求】
+- 整体为一张大画面，浅色或中性干净背景
+- 所有 NPC 以卡片形式平铺在同一页中，排版整齐、清晰、可读
+- 卡片之间要有明确分组，方便一眼看出哪些属于同一职业、同一阵营或同一类群众
+- 每个职业分组至少包含：
+  - 1 个全身角色卡，展示服装、体态、职业特征和完整比例
+  - 2 到 6 个同组脸谱 / 头像 / 半身脸部小卡，作为替换脸模板
+- 如果用户描述的职业类型很多，可按空间合理压缩，但仍要优先保证“每类至少一个全身像”
+- 如果用户描述的是单一职业的大群体，也应在同职业下展示多个脸谱替换版本
+
+【全身像规则】
+- 每个职业角色至少有 1 个完整全身像
+- 全身像要明确展示这个 NPC 的站姿、服装轮廓、职业工具或身份特征
+- 全身像是该分组的主卡，不要被脸谱小图淹没
+- 不要求每个 NPC 都有全身像，但每种职业原型必须至少有 1 个
+
+【脸谱变体规则】
+- 每组全身像附近要搭配若干可替换脸谱
+- 脸谱变体应明显属于同一类职业/阵营，但不是完全一样的复制品
+- 变体可以调整：
+  - 脸型
+  - 五官组合
+  - 年龄层
+  - 发际线/发量
+  - 胡须
+  - 皱纹
+  - 神情细节
+  - 轻微伤痕、痣、雀斑、晒痕等普通特征
+- 变体不应改变该类 NPC 的核心世界观和职业身份
+
+【文字与标注规则】
+- 所有可见文字必须为中文
+- 每张角色卡都要有一个简短名字
+- 每张角色卡都要有一句极简中文说明
+- 说明不得默认写成一味正向、脸谱化的赞美标签
+- 说明应允许出现中性、负面、不完美、普通、笨拙、疲惫、胆怯、迟疑、圆滑、散漫、老练、麻木、敷衍、紧张、新兵气、混日子等真实群像特征
+- 尤其是军队、帮派、差役、学徒、店伙计、杂工等群体，不要默认所有人都英勇果敢、忠诚坚定、精神饱满
+- 不同 NPC 的说明应体现真实的人群差异，有人可靠，也可以有人胆小、偷懒、慌张、嘴碎、木讷、油滑、怕事或经验不足
+- 说明只写必要信息，例如：
+  - 卖鱼摊贩，凌晨出摊
+  - 巡街兵，夜班值守
+  - 酒馆伙计，跑堂熟练
+  - 门派外门弟子，新入行
+- 也可以是：
+  - 巡街兵，新兵蛋子
+  - 哨兵乙，眼神发虚
+  - 店伙计甲，嘴碎怕事
+  - 兵卒丙，混日子
+  - 学徒丁，手忙脚乱
+- 文字必须简洁、准确、无乱码、无错别字
+- 标注应像设定板上的手写批注或小标题，简短即可，不要长段说明文
+
+【命名规则】
+- 优先使用中国语境下的普通 NPC 命名方式
+- 如果是日常平民，可使用：张三、李四、王五、赵六、周七 等
+- 如果是匿名路人或批量群演，可使用：路人甲、路人乙、路人丙、杂工甲、伙计乙、兵卒丙、学徒丁 等
+- 如果有职业属性，可在名字中轻度体现身份，例如：更夫赵三、店小二甲、哨兵乙
+- 名字不要像主角，不要过度华丽，不要中二化
+
+【视觉风格规则】
+- 整体像专业的 NPC 角色库设定板
+- 适合游戏前期开发、影视美术、动画群演设计、漫画背景人物库
+- 各角色共享同一个世界观和美术风格
+- 若用户没有指定特定画风，默认使用真人写实风格，并保持同一批 NPC 的摄影语言、服装语言、材质语言和时代语境统一
+- 可以精致，但不要把任何一个 NPC 做成唯一主角
+- 画面重点是“群体可用性”和“替换扩展性”
+
+【一致性与差异平衡】
+- 同一阵营、同一职业组内部要有共性
+- 不同职业组之间要有足够差异
+- 若用户明确指定朝代、地域、世界观、时代、材质、风格、职业结构、阶层关系，必须严格遵守
+- 若用户未指定，可根据场景自动补足合理职业层次，但不要脱离用户原始需求
+- 即使追求多样性，也必须保证所有 NPC 像是生活在同一个世界观、同一地区、同一时代、同一制作体系中的人，不能出现画风、时代、审美和身份系统彼此割裂的混搭
+
+【禁止事项】
+- 不要把画面做成主角海报
+- 不要只给头像，不给职业原型全身像
+- 不要所有 NPC 都长得一模一样
+- 也不要为了多样性而完全破坏阵营统一性
+- 不要加入与用户场景无关的职业
+- 不要生成大段文本说明
+- 不要生成英文文字
+
+最终效果应是一张信息清晰、职业分组明确、可直接用于批量场景角色调用的 NPC 设定卡。
+它应该让人一眼看出：这是一组同世界观下、可替换组合使用的群众角色卡片，而不是若干随机肖像拼贴。`;
+}
+//# sourceMappingURL=npc-card-tpl.js.map

package/dist/utils/npc-card-tpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npc-card-tpl.js","sourceRoot":"","sources":["../../src/utils/npc-card-tpl.ts"],"names":[],"mappings":";;AAiBA,gDAqIC;AAlJD;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAAC,MAA6B;IAC9D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9B,OAAO;;;EAGP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA8HoC,CAAC;AACjD,CAAC"}

package/dist/utils/storyboard-sketch-tpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storyboard-sketch-tpl.d.ts","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,MAAM,CAiSR"}
+{"version":3,"file":"storyboard-sketch-tpl.d.ts","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,MAAM,CA8SR"}