cerevox 4.69.2 → 4.70.0

package/dist/utils/storyboard-sketch-tpl.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storyboardSketchTemplate = storyboardSketchTemplate;
+const sketchIntensityMap = {
+    balanced: `【镜头强度】以清晰叙事为先，镜头变化克制，适合稳定可读的草图预演。`,
+    strong: `【镜头强度】镜头反差更明显，强调视觉重音和叙事节奏，但仍保持草图简洁。`,
+    aggressive: `【镜头强度】镜头冲击力更强，节奏起伏更大，适合短视频感的草图分镜。`,
+};
+/**
+ * 生成适合 gpt-image-2 的黑白手绘宫格草图提示词。
+ *
+ * @param params 模板参数，包括用户剧情、页宽高比、格数限制、参考视频时长和镜头强度。
+ * @returns 适合用于生成单页黑白手绘分镜草图的英文主提示词。
+ *
+ * @example
+ * ```ts
+ * const prompt = storyboardSketchTemplate({
+ *   userPrompt: '少女在雨夜追逐一辆失控的列车，最后纵身跃上车尾。',
+ *   page_aspect_ratio: '1:1',
+ *   maxPanels: 6,
+ *   forVideoDuration: 18,
+ * });
+ * ```
+ */
+function storyboardSketchTemplate(params) {
+    const { userPrompt, page_aspect_ratio = '1:1', maxPanels, forVideoDuration, cinematicIntensity = 'strong', } = params;
+    const safeMaxPanels = typeof maxPanels === 'number' && Number.isFinite(maxPanels)
+        ? Math.max(3, Math.min(12, Math.floor(maxPanels)))
+        : undefined;
+    const intensityBlock = sketchIntensityMap[cinematicIntensity] ?? sketchIntensityMap.strong;
+    const panelCountRule = safeMaxPanels
+        ? `
+【画格数量基本规则】
+- 实际可识别的叙事画格数量不多于 ${safeMaxPanels}
+- 可以少于 ${safeMaxPanels}，但不要多于 ${safeMaxPanels}
+- 根据剧情节奏自然分格，不要为了凑数而平均切分
+`.trim()
+        : `
+【画格数量基本规则】
+- 根据剧情信息量、动作复杂度和阅读清晰度自动决定画格数量
+- 最终画格数量通常控制在 3~12 格
+- 优先保证单页可读性和镜头节奏，不要使用过碎分格
+`.trim();
+    const videoDurationRule = forVideoDuration !== undefined && forVideoDuration !== null
+        ? `
+【参考目标视频时长】
+- 目标视频时长：${forVideoDuration} 秒
+- 结合该时长决定镜头密度与格数
+- 单镜头通常对应 2~5 秒，特殊情况下可更短或更长
+- 时长越短，越应压缩无效过渡；时长越长，可适度增加信息镜头
+`.trim()
+        : `
+【节奏控制】
+- 根据剧情内容自动判断镜头密度，避免镜头过碎或叙事松散
+`.trim();
+    const finalOutputRule = safeMaxPanels
+        ? `
+【最终输出】
+- 一张比例为 ${page_aspect_ratio} 的黑白手绘分镜草图页
+- 画格数量不多于 ${safeMaxPanels}
+- 明确阅读顺序，适合作为导演草图和后续视频分镜参考
+`.trim()
+        : `
+【最终输出】
+- 一张比例为 ${page_aspect_ratio} 的黑白手绘分镜草图页
+- 画格数量由你根据剧情和节奏自动决定，通常控制在 3~12 格
+- 明确阅读顺序，适合作为导演草图和后续视频分镜参考
+`.trim();
+    return `You are a professional film storyboard sketch artist creating a single page of black-and-white hand-drawn storyboard thumbnails for GPT Image 2.
+
+【Core Goal】
+- Create one single composed storyboard page, not multiple separate images
+- The page must read like a director's planning sketch, with clear sequential storytelling
+- Keep it simple, rough, readable, cinematic, and production-friendly
+
+【Visual Style Requirements】
+- monochrome black and white storyboard sketch
+- hand-drawn pencil and ink line art
+- white paper background
+- rough but confident construction lines
+- simple shading only when necessary for depth
+- no color
+- no painterly rendering
+- no photorealism
+- no polished illustration finish
+- no complex textures
+- use clear silhouettes, readable gestures, and simple environment blocking
+- preserve the feeling of fast previsualization sketches made by a film storyboard artist
+
+【Layout Requirements】
+- Output one complete storyboard sheet
+- Overall page aspect ratio: ${page_aspect_ratio}
+- Use a clear comic-grid or storyboard-grid layout
+- Reading order must be obvious at a glance
+- Panels may vary in size, but the page must stay organized and readable
+- Reserve a clean horizontal area at the bottom of the page for director notes
+- The bottom note area must be visually separated from the storyboard panels and remain easy to read
+
+${panelCountRule}
+
+${videoDurationRule}
+
+【Panel Content Rules】
+- Every panel must feel like a real camera shot from a film
+- Each panel should clearly show:
+  - shot size
+  - camera angle
+  - subject action
+  - staging and spatial relationship
+  - emotional beat
+  - story purpose
+- Use strong silhouette design so the action reads immediately even in rough sketch form
+- Reduce costume, texture, and prop detail to only what is necessary for recognition
+- Faces can be simplified, but expression and head direction should remain readable
+- Beside every panel, add a small Chinese annotation block
+- The annotation block should feel like professional storyboard notes written by a Chinese-speaking director or storyboard artist
+- Each annotation block should preferably follow this structure in Chinese:
+  - panel number
+  - interior or exterior
+  - scene/location
+  - time of day
+  - shot size
+  - brief action description
+  - emotional tone
+- Example structure in Chinese only:
+  - 1. 外景·废墟街道·夜
+  - 远景建立镜头
+  - 女孩直面远处逼近的异形轮廓
+  - 气氛紧张
+- Keep the annotation concise, readable, and placed beside or just outside the panel without blocking important drawing content
+
+【Cinematic Rules】
+- Use meaningful variation in wide, medium, close-up, and extreme close-up shots
+- Build a clear progression: establish, develop, turn, react, resolve
+- Use reaction shots, inserts, and impact beats when helpful
+- Keep continuity of character position, screen direction, props, and action flow
+
+${intensityBlock}
+
+【Director Notes Area】
+- In the reserved bottom area, include concise professional director notes
+- The bottom area must include 2 to 3 highlighted key-shot mini sketches
+- These highlighted key-shot mini sketches can be simplified stick-figure or mannequin-style thumbnail sketches
+- Each highlighted mini sketch should correspond to one important cinematic beat from the main storyboard
+- The note area should describe:
+  - highlight shots
+  - key performance beats
+  - camera movement design
+  - lens language or staging emphasis when necessary
+- Camera movement descriptions should be professional and practical, and must be written in concise professional Chinese, such as 推近, 拉远, 跟拍, 手持跟随, 甩镜, 焦点转移, 俯拍揭示, 低机位推进, 横向移动
+- Each highlighted mini sketch should be paired with a short Chinese note describing the shot purpose and camera movement
+- Director notes must support the storyboard rather than replace it
+- Keep the notes compact, readable, and production-oriented
+
+【Text Rules】
+- No dialogue balloons
+- No captions
+- No large text blocks
+- Only the bottom director notes area may contain brief professional instruction text
+- If panel labels are needed, keep them tiny and unobtrusive in the lower-right corner of each panel
+- Any visible text generated inside the image must be in Chinese only
+- Panel labels, shot annotations, and director notes must all use professional Chinese wording
+- Do not generate any English words, roman letters, or mixed-language labels inside the image
+
+【Model Guidance For GPT Image 2】
+- Favor simple composition over excessive detail
+- Favor readable storyboard sketch language over beautiful final art
+- Favor black line clarity over rendering
+- Keep the image clean, flat, and easy to parse as a storyboard page
+- Do not turn this into a finished comic page or a realistic movie still
+
+【User Input】
+${userPrompt}
+
+${finalOutputRule}`.trim();
+}
+//# sourceMappingURL=storyboard-sketch-tpl.js.map

package/dist/utils/storyboard-sketch-tpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-sketch-tpl.js","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":";;AAgCA,4DAwKC;AA9LD,MAAM,kBAAkB,GAAuC;IAC7D,QAAQ,EAAE,mCAAmC;IAC7C,MAAM,EAAE,qCAAqC;IAC7C,UAAU,EAAE,mCAAmC;CAChD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,wBAAwB,CACtC,MAAsC;IAEtC,MAAM,EACJ,UAAU,EACV,iBAAiB,GAAG,KAAK,EACzB,SAAS,EACT,gBAAgB,EAChB,kBAAkB,GAAG,QAAQ,GAC9B,GAAG,MAAM,CAAC;IAEX,MAAM,aAAa,GACjB,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,cAAc,GAClB,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC;IAEtE,MAAM,cAAc,GAAG,aAAa;QAClC,CAAC,CAAC;;oBAEc,aAAa;SACxB,aAAa,UAAU,aAAa;;CAE5C,CAAC,IAAI,EAAE;QACJ,CAAC,CAAC;;;;;CAKL,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,iBAAiB,GACrB,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,KAAK,IAAI;QACzD,CAAC,CAAC;;WAEG,gBAAgB;;;;CAI1B,CAAC,IAAI,EAAE;QACF,CAAC,CAAC;;;CAGP,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,aAAa;QACnC,CAAC,CAAC;;UAEI,iBAAiB;YACf,aAAa;;CAExB,CAAC,IAAI,EAAE;QACJ,CAAC,CAAC;;UAEI,iBAAiB;;;CAG1B,CAAC,IAAI,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;+BAuBsB,iBAAiB;;;;;;;EAO9C,cAAc;;EAEd,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCjB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCd,UAAU;;EAEV,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cerevox",
-  "version": "4.69.2",
+  "version": "4.70.0",
   "description": "TypeScript SDK for browser automation and secure command execution in highly available and scalable micro computer environments",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",