cerevox 4.71.2 → 4.72.1

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

@@ -7,10 +7,10 @@ const sketchIntensityMap = {
     aggressive: `【镜头强度】镜头冲击力更强，节奏起伏更大，适合短视频感的草图分镜。`,
 };
 /**
- * 生成适合 gpt-image-2 的黑白手绘宫格草图提示词。
+ * 生成适合 gpt-image-2 的简洁表格式黑白手绘分镜草稿提示词。
  *
  * @param params 模板参数，包括用户剧情、页宽高比、格数限制、参考视频时长和镜头强度。
- * @returns 适合用于生成单页黑白手绘分镜草图的英文主提示词。
+ * @returns 适合用于生成单页表格式分镜草稿的英文主提示词。
  *
  * @example
  * ```ts
@@ -23,55 +23,77 @@ const sketchIntensityMap = {
  * ```
  */
 function storyboardSketchTemplate(params) {
-    const { userPrompt, page_aspect_ratio = '1:1', maxPanels, forVideoDuration, cinematicIntensity = 'strong', } = params;
+    const { userPrompt, page_aspect_ratio = '1:1', maxPanels, 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 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
+    const videoDurationRule = effectiveTargetDuration !== undefined
         ? `
 【参考目标视频时长】
-- 目标视频时长：${forVideoDuration} 秒
+- 目标视频时长：${effectiveTargetDuration} 秒
+- 允许的最大视频时长：${safeMaxVideoDuration} 秒
+- 如果用户要求超过 ${safeMaxVideoDuration} 秒，必须按 ${safeMaxVideoDuration} 秒处理，不得继续扩展更长版本
 - 结合该时长决定镜头密度与格数
 - 单镜头通常对应 2~5 秒，特殊情况下可更短或更长
 - 时长越短，越应压缩无效过渡；时长越长，可适度增加信息镜头
 `.trim()
         : `
 【节奏控制】
+- 该分镜草稿服务的视频最大时长不能超过 ${safeMaxVideoDuration} 秒
+- 如用户没有明确给出时长，请按不超过 ${safeMaxVideoDuration} 秒的预告片或短片节奏规划镜头
 - 根据剧情内容自动判断镜头密度，避免镜头过碎或叙事松散
 `.trim();
     const finalOutputRule = safeMaxPanels
         ? `
 【最终输出】
-- 一张比例为 ${page_aspect_ratio} 的黑白手绘分镜草图页
-- 画格数量不多于 ${safeMaxPanels}
-- 明确阅读顺序，适合作为导演草图和后续视频分镜参考
+- 一张比例为 ${page_aspect_ratio} 的黑白手绘表格式分镜草稿页
+- 镜头数量不多于 ${safeMaxPanels}
+- 明确阅读顺序，像简洁的分镜表，不要做复杂导演手册
 `.trim()
         : `
 【最终输出】
-- 一张比例为 ${page_aspect_ratio} 的黑白手绘分镜草图页
-- 画格数量由你根据剧情和节奏自动决定，通常控制在 3~12 格
-- 明确阅读顺序，适合作为导演草图和后续视频分镜参考
+- 一张比例为 ${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.
+    return `You are a professional film storyboard sketch artist creating a single page of clean black-and-white tabular storyboard draft 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
+- The page must read like a simple storyboard draft sheet with table columns
+- The result should feel close to a clear production storyboard table, not a dense manual page
+- Keep it readable, cinematic, structured, and easy to scan at a glance
 
 【Visual Style Requirements】
 - monochrome black and white storyboard sketch
@@ -87,14 +109,49 @@ function storyboardSketchTemplate(params) {
 - 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
+【Master Layout Requirements】
+- Output one complete storyboard draft sheet
 - Overall page aspect ratio: ${page_aspect_ratio}
-- Use a clear comic-grid or storyboard-grid layout
+- The page should resemble a clean printed storyboard worksheet
+- Use a simple structured table layout with clear boxes, dividers, rows, and column headers
 - 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
+- The page must feel like one integrated document, not a collage of unrelated sketches
+- The upper area should contain only a simple title block
+- The middle area should contain the main storyboard rows
+- The bottom area should contain only a brief director guidance box
+
+【Top Title Block Requirements】
+- Create a simple title area at the top of the page
+- The top area should include:
+  - project or trailer title in Chinese
+  - short style note in Chinese
+  - target duration in Chinese
+- Keep the top area clean and compact
+- Do not add dense metadata fields or complicated production header bars
+
+【Main Table Structure】
+- The main body should be one simple table
+- Each storyboard row should correspond to one shot
+- The table should feel similar to a storyboard worksheet, not a magazine spread
+- Use clear column headers in Chinese
+- Recommended columns are:
+  - 镜头
+  - 时间
+  - 画面内容（草图）
+  - 机位与运动
+  - 动作与表现
+  - 声音与氛围
+- Keep the table compact, neat, and easy to read
+- Each row should have one sketch image cell and several short text cells
+
+【Row Rules】
+- The sketch cell should be the widest column in each row
+- Each sketch should be a black-and-white storyboard thumbnail
+- Text cells should use short Chinese phrases, not long explanations
+- Keep every row visually consistent
+- Do not create complex section headers, sidebars, reference strips, or multi-module handbook layouts
+- The overall result should look simple, clean, and practical
+- In the 机位与运动 column, use concrete professional camera language instead of vague wording
 
 ${panelCountRule}
 
@@ -112,22 +169,73 @@ ${videoDurationRule}
 - 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
+- Each row should include:
+  - shot number
+  - time range
+  - one storyboard sketch
+  - camera position and movement
+  - action and performance
+  - sound and mood
+- Keep all notes concise and table-like
+- Do not add floating notes outside the table
+
+【Camera Movement Guidance】
+- The 机位与运动 column must provide practical professional shot design that can directly guide image generation
+- Every shot should choose one main camera strategy and, if needed, one supporting movement only
+- Do not stack too many camera tricks in the same shot
+- Camera choice must match story purpose, emotional beat, and shot duration
+- Use short Chinese phrases such as 中近景推进, 手持跟拍, 低机位环绕, 俯拍下压, 慢速拉远, 甩镜转场, 希区柯克变焦
+
+【Common Camera Moves】
+- 固定机位: use for clear exposition, stable dialogue, or dramatic pause
+- 推近: use to strengthen focus, emotional pressure, realization, or threat
+- 拉远: use to release emotion, reveal environment, or create aftermath feeling
+- 平移: use to reveal information sideways, connect subjects, or guide attention
+- 摇镜: use to follow gaze, reveal targets, or shift dramatic focus
+- 俯仰: use to reveal vertical scale, danger, or psychological pressure
+- 跟拍: use for pursuit, urgency, movement continuity, and embodied presence
+- 手持跟随: use for instability, panic, realism, combat, or impact
+- 环绕: use for heroic emphasis, emotional climax, transformation, or standoff
+- 升降: use to reveal status change, spatial hierarchy, or epic feeling
+- 甩镜: use for violent transition, sudden reaction, or rhythm accent
+- 变焦: use sparingly for attention shift, comic punch, or stylized emphasis
+- 焦点转移: use when dramatic attention moves between foreground and background
+
+【Advanced Camera Techniques】
+- 希区柯克变焦: combine push-in with zoom-out, or pull-out with zoom-in, for vertigo, shock, realization, fear, or spatial distortion
+- 压迫式低机位推进: use low angle push-in for domination, threat, heroic rise, or power surge
+- 高机位俯压: use high angle compression to show vulnerability, isolation, or tactical disadvantage
+- 前景遮挡过镜: use moving foreground objects to add realism, voyeur feeling, layering, and transition energy
+- 弧形包围运动: use curved move around subject to intensify confrontation, intimacy, or unstable emotion
+- 长焦压缩跟移: use for battlefield chaos, crowd pressure, and compressed spatial tension
+- 广角贴近推进: use when impact, speed, distortion, and proximity must feel aggressive
+- 主观镜头推进: use when the audience should temporarily enter a character's perception or attack line
+
+【Camera Selection Logic】
+- Use stable moves for exposition, orientation, and calm beats
+- Use dynamic moves for conflict, chase, transformation, and impact moments
+- Use stylized advanced techniques only when the story beat truly needs them
+- If the shot duration is short, prefer one clear movement over complex combined movement
+- If the beat is the emotional highlight of the sequence, choose the most expressive but still readable camera move
+- The camera move must remain drawable in storyboard form and visually obvious in the sketch
+
+【Camera Language Quality Bar】
+- Avoid generic wording like 运动镜头, 有动感, 镜头变化
+- Prefer specific phrases like 低机位推进, 手持跟拍, 中景横移揭示, 特写慢推, 高机位拉远, 希区柯克变焦
+- The movement note should feel like a real director or cinematographer instruction
+- Keep the wording short, precise, and production-usable
+
+【Document Realism Rules】
+- The page should feel like a real simple storyboard worksheet
+- Use table boxes, clean row separators, and practical column headers
+- The three most important things are:
+  - clear shot progression
+  - clean table formatting
+  - immediately readable shot information
+- The result should not look like a comic page poster
+- The result should not look like a mood board
+- The result should not look like a dense director manual
+- It must look like a simple storyboard draft sheet
 
 【Cinematic Rules】
 - Use meaningful variation in wide, medium, close-up, and extreme close-up shots
@@ -137,37 +245,45 @@ ${videoDurationRule}
 
 ${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
+【Bottom Guidance Area】
+- Reserve one simple bottom box for brief director guidance
+- This bottom box may include 3 to 5 short Chinese bullet-style notes
+- Notes can briefly mention:
+  - visual tone
+  - pacing
+  - camera language
+  - sound design
+- Keep it concise and simple
+- Do not add mini sketches, rhythm bars, or extra handbook modules
+
+【Reference Image Similarity Goal】
+- The overall layout should strongly resemble a simple storyboard draft table like the reference image
+- Emphasize:
+  - simple title block
+  - tabular rows
+  - numbered shots
+  - one sketch column
+  - short text columns
+  - one brief bottom guidance box
+- The page should feel clean, professional, and printable
+- It should look like a simple planning sheet a director can use quickly
 
 【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
+- No prose paragraphs
+- Visible text should be primarily Chinese
+- Use short table-cell text only
+- Panel labels, timing notes, and director notes must feel like practical preproduction notation
+- Avoid decorative typography, poster-style headers, and excessive abbreviations
 
 【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
+- Favor document structure over painterly beauty
+- Favor readable shot design over excessive rendering
+- Favor black line clarity, white-page organization, and believable table layout
+- Keep the image easy to parse as a storyboard draft sheet
 - Do not turn this into a finished comic page or a realistic movie still
+- Do not let text complexity overwhelm shot readability
 
 【User Input】
 ${userPrompt}

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

@@ -1 +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"}
+{"version":3,"file":"storyboard-sketch-tpl.js","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cerevox",
-  "version": "4.71.2",
+  "version": "4.72.1",
   "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",