cerevox 4.73.0 → 4.74.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,150 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.buildNpcCardPrompt = buildNpcCardPrompt;
4
+ /**
5
+ * 构建 NPC 群像设定卡提示词。
6
+ *
7
+ * @param params 模板参数,包含用户原始 NPC 群像描述。
8
+ * @returns 适合生成 NPC 卡片拼图的完整提示词。
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * const prompt = buildNpcCardPrompt({
13
+ * userPrompt: '古代市井中的杂货商、小贩、脚夫、说书人、巡街更夫等一群路人 NPC',
14
+ * });
15
+ * ```
16
+ */
17
+ function buildNpcCardPrompt(params) {
18
+ const { userPrompt } = params;
19
+ return `基于用户指令,生成一张专业的 NPC 群像设定卡 / npc card。
20
+
21
+ 用户指令:
22
+ ${userPrompt}
23
+
24
+ ---
25
+
26
+ 这不是单个主角角色卡,而是一整组可供影视、动画、游戏或漫画场景反复调用的 NPC 群像设定板。
27
+ 整张图需要像 casting board、crowd character sheet、群演角色库 一样,把一批可复用 NPC 以卡片形式平铺在同一张图上。
28
+
29
+ 【核心目标】
30
+ - 根据用户指令生成一群 NPC,而不是 1 个人
31
+ - 在用户许可的范围内尽量提高多样性
32
+ - 如果场景天然要求统一性,则统一中保留少量合理差异
33
+ - 每个职业或角色类型至少有 1 个清晰的全身像
34
+ - 每个角色类型旁边再配若干可替换的脸谱 / 头像小组,形成同类角色的变体池
35
+ - 每张小卡片都要有简短中文说明和中文名字
36
+ - 名字风格以普通 NPC 命名为主,例如:张三、李四、王五、赵六、路人甲、路人乙、店小二甲、巡街兵乙、伙夫丙 等
37
+
38
+ 【场景多样性规则】
39
+ - 如果用户描述的是市井、街市、村落、码头、酒馆、客栈、集市、帮派外围、平民社区、难民营、工业工坊、校园、办公楼、医院走廊等开放人群环境,则尽量提高以下维度的差异:
40
+ - 年龄
41
+ - 性别
42
+ - 职业/分工
43
+ - 身高
44
+ - 胖瘦
45
+ - 发型
46
+ - 肤色与气质
47
+ - 着装层级与磨损状态
48
+ - 姿态习惯
49
+ - 如果用户描述的是军队、警队、门派弟子、修会成员、公司制服员工、工厂班组、护士站、仪仗队、学校校服群体、服务行业标准制服群体等强调纪律和统一性的组织,则应:
50
+ - 保持整体制服、身份和气质相对统一
51
+ - 轮廓、配色、装备、站姿更整齐
52
+ - 年龄与体型差异收敛
53
+ - 但仍保留少量合理的人脸差异、身形差异、细节穿着差异,避免完全复制粘贴
54
+
55
+ 【人物辨识度规则】
56
+ - 所有 NPC 都要有一定辨识度,但不要像主角或明星角色那样过分突出
57
+ - 面部应当可区分,但整体趋于“平庸化、群像化、配角化”
58
+ - 不要做夸张偶像脸、过强主角光环、过高时尚感或过于戏剧性的个人设计
59
+ - 若用户没有明确指定人物风格,默认按真人写实风格生成
60
+ - 默认人物样貌不能太帅、不能太美,不要有网红感、明星感或主角脸
61
+ - 默认应呈现普通路人、普通群众、普通配角的自然外貌基础,但仍保留一定可区分的五官与气质差异
62
+ - 识别度主要来自年龄层、职业气质、五官组合、体态和穿搭差异,而不是超级吸睛设定
63
+
64
+ 【版式要求】
65
+ - 整体为一张大画面,浅色或中性干净背景
66
+ - 所有 NPC 以卡片形式平铺在同一页中,排版整齐、清晰、可读
67
+ - 卡片之间要有明确分组,方便一眼看出哪些属于同一职业、同一阵营或同一类群众
68
+ - 每个职业分组至少包含:
69
+ - 1 个全身角色卡,展示服装、体态、职业特征和完整比例
70
+ - 2 到 6 个同组脸谱 / 头像 / 半身脸部小卡,作为替换脸模板
71
+ - 如果用户描述的职业类型很多,可按空间合理压缩,但仍要优先保证“每类至少一个全身像”
72
+ - 如果用户描述的是单一职业的大群体,也应在同职业下展示多个脸谱替换版本
73
+
74
+ 【全身像规则】
75
+ - 每个职业角色至少有 1 个完整全身像
76
+ - 全身像要明确展示这个 NPC 的站姿、服装轮廓、职业工具或身份特征
77
+ - 全身像是该分组的主卡,不要被脸谱小图淹没
78
+ - 不要求每个 NPC 都有全身像,但每种职业原型必须至少有 1 个
79
+
80
+ 【脸谱变体规则】
81
+ - 每组全身像附近要搭配若干可替换脸谱
82
+ - 脸谱变体应明显属于同一类职业/阵营,但不是完全一样的复制品
83
+ - 变体可以调整:
84
+ - 脸型
85
+ - 五官组合
86
+ - 年龄层
87
+ - 发际线/发量
88
+ - 胡须
89
+ - 皱纹
90
+ - 神情细节
91
+ - 轻微伤痕、痣、雀斑、晒痕等普通特征
92
+ - 变体不应改变该类 NPC 的核心世界观和职业身份
93
+
94
+ 【文字与标注规则】
95
+ - 所有可见文字必须为中文
96
+ - 每张角色卡都要有一个简短名字
97
+ - 每张角色卡都要有一句极简中文说明
98
+ - 说明不得默认写成一味正向、脸谱化的赞美标签
99
+ - 说明应允许出现中性、负面、不完美、普通、笨拙、疲惫、胆怯、迟疑、圆滑、散漫、老练、麻木、敷衍、紧张、新兵气、混日子等真实群像特征
100
+ - 尤其是军队、帮派、差役、学徒、店伙计、杂工等群体,不要默认所有人都英勇果敢、忠诚坚定、精神饱满
101
+ - 不同 NPC 的说明应体现真实的人群差异,有人可靠,也可以有人胆小、偷懒、慌张、嘴碎、木讷、油滑、怕事或经验不足
102
+ - 说明只写必要信息,例如:
103
+ - 卖鱼摊贩,凌晨出摊
104
+ - 巡街兵,夜班值守
105
+ - 酒馆伙计,跑堂熟练
106
+ - 门派外门弟子,新入行
107
+ - 也可以是:
108
+ - 巡街兵,新兵蛋子
109
+ - 哨兵乙,眼神发虚
110
+ - 店伙计甲,嘴碎怕事
111
+ - 兵卒丙,混日子
112
+ - 学徒丁,手忙脚乱
113
+ - 文字必须简洁、准确、无乱码、无错别字
114
+ - 标注应像设定板上的手写批注或小标题,简短即可,不要长段说明文
115
+
116
+ 【命名规则】
117
+ - 优先使用中国语境下的普通 NPC 命名方式
118
+ - 如果是日常平民,可使用:张三、李四、王五、赵六、周七 等
119
+ - 如果是匿名路人或批量群演,可使用:路人甲、路人乙、路人丙、杂工甲、伙计乙、兵卒丙、学徒丁 等
120
+ - 如果有职业属性,可在名字中轻度体现身份,例如:更夫赵三、店小二甲、哨兵乙
121
+ - 名字不要像主角,不要过度华丽,不要中二化
122
+
123
+ 【视觉风格规则】
124
+ - 整体像专业的 NPC 角色库设定板
125
+ - 适合游戏前期开发、影视美术、动画群演设计、漫画背景人物库
126
+ - 各角色共享同一个世界观和美术风格
127
+ - 若用户没有指定特定画风,默认使用真人写实风格,并保持同一批 NPC 的摄影语言、服装语言、材质语言和时代语境统一
128
+ - 可以精致,但不要把任何一个 NPC 做成唯一主角
129
+ - 画面重点是“群体可用性”和“替换扩展性”
130
+
131
+ 【一致性与差异平衡】
132
+ - 同一阵营、同一职业组内部要有共性
133
+ - 不同职业组之间要有足够差异
134
+ - 若用户明确指定朝代、地域、世界观、时代、材质、风格、职业结构、阶层关系,必须严格遵守
135
+ - 若用户未指定,可根据场景自动补足合理职业层次,但不要脱离用户原始需求
136
+ - 即使追求多样性,也必须保证所有 NPC 像是生活在同一个世界观、同一地区、同一时代、同一制作体系中的人,不能出现画风、时代、审美和身份系统彼此割裂的混搭
137
+
138
+ 【禁止事项】
139
+ - 不要把画面做成主角海报
140
+ - 不要只给头像,不给职业原型全身像
141
+ - 不要所有 NPC 都长得一模一样
142
+ - 也不要为了多样性而完全破坏阵营统一性
143
+ - 不要加入与用户场景无关的职业
144
+ - 不要生成大段文本说明
145
+ - 不要生成英文文字
146
+
147
+ 最终效果应是一张信息清晰、职业分组明确、可直接用于批量场景角色调用的 NPC 设定卡。
148
+ 它应该让人一眼看出:这是一组同世界观下、可替换组合使用的群众角色卡片,而不是若干随机肖像拼贴。`;
149
+ }
150
+ //# sourceMappingURL=npc-card-tpl.js.map
@@ -0,0 +1 @@
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"}
@@ -1 +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,CA0SR"}
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,CA8SR"}
@@ -108,9 +108,11 @@ function storyboardSketchTemplate(params) {
108
108
  - no complex textures
109
109
  - use clear silhouettes, readable gestures, and simple environment blocking
110
110
  - preserve the feeling of fast previsualization sketches made by a film storyboard artist
111
- - human figures should stay rough, schematic, and non-specific
112
- - prefer stick-figure logic, mannequin blocks, radish-man bodies, silhouette masses, and gesture lines over detailed character drawing
113
- - avoid distinctive faces, hairstyles, costume rendering, anatomy detail, and any recognizable appearance traits unless absolutely necessary for basic role differentiation
111
+ - human figures should stay rough and sketch-like, but still preserve enough character identity for shot continuity
112
+ - prefer simplified storyboard character drawing rather than stick figures
113
+ - keep recognizable character cues such as hairstyle silhouette, face shape, body proportion, costume outline, and signature props when they matter to the scene
114
+ - faces may stay loosely drawn, but main characters should still be distinguishable from one another at a glance
115
+ - avoid polished portrait rendering, beauty-detail drawing, or character-sheet level finish, but do not erase character identity into anonymous mannequins
114
116
 
115
117
  【Master Layout Requirements】
116
118
  - Output one complete storyboard draft sheet
@@ -172,10 +174,11 @@ ${videoDurationRule}
172
174
  - Use strong silhouette design so the action reads immediately even in rough sketch form
173
175
  - Reduce costume, texture, and prop detail to only what is necessary for recognition
174
176
  - Faces can be simplified, but expression and head direction should remain readable
175
- - Character depiction must remain one level rougher than a typical storyboard illustration
176
- - Use body direction, pose, negative space, limb gesture, and head angle to communicate action instead of detailed facial or costume information
177
- - Do not let character drawings become attractive concept art, character sheets, or identifiable portrait sketches
178
- - If a role must be distinguished, do it with very minimal shape coding or staging position, not with detailed appearance design
177
+ - Character depiction must remain one level rougher than a polished concept illustration, while still functioning as a usable storyboard performance sketch
178
+ - Use body direction, pose, negative space, limb gesture, head angle, and a small amount of key appearance information to communicate action
179
+ - Main roles should preserve continuity traits across panels, including rough face proportion, hair mass, costume silhouette, and distinctive carried items when relevant
180
+ - Do not let character drawings become finished concept art, character sheets, or glamour portraits
181
+ - If a role must be distinguished, do it first through staging and silhouette, but retain enough recurring appearance cues so the same character is still recognizable across shots
179
182
  - Each row should include:
180
183
  - shot number
181
184
  - time range
@@ -292,7 +295,8 @@ ${intensityBlock}
292
295
  - Keep the image easy to parse as a storyboard draft sheet
293
296
  - Do not turn this into a finished comic page or a realistic movie still
294
297
  - Do not let text complexity overwhelm shot readability
295
- - Keep people rough and generic so they guide staging without polluting later visual creation
298
+ - Keep people rough and sketchy, but not generic to the point of losing character identity
299
+ - Preserve rough character continuity so the storyboard can still guide later image and video creation
296
300
 
297
301
  【User Input】
298
302
  ${userPrompt}
@@ -1 +1 @@
1
- {"version":3,"file":"storyboard-sketch-tpl.js","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"storyboard-sketch-tpl.js","sourceRoot":"","sources":["../../src/utils/storyboard-sketch-tpl.ts"],"names":[],"mappings":";;AAiCA,4DAgTC;AAtUD,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,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,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,uBAAuB,KAAK,SAAS;QACnC,CAAC,CAAC;;WAEG,uBAAuB;cACpB,oBAAoB;aACrB,oBAAoB,UAAU,oBAAoB;;;;CAI9D,CAAC,IAAI,EAAE;QACF,CAAC,CAAC;;uBAEe,oBAAoB;sBACrB,oBAAoB;;CAEzC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA6BsB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C9C,cAAc;;EAEd,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8FjB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6Cd,UAAU;;EAEV,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cerevox",
3
- "version": "4.73.0",
3
+ "version": "4.74.0",
4
4
  "description": "TypeScript SDK for browser automation and secure command execution in highly available and scalable micro computer environments",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -1 +0,0 @@
1
- {"version":3,"file":"environment-board-tpl.d.ts","sourceRoot":"","sources":["../../src/utils/environment-board-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,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,MAAM,CAmNR"}
@@ -1,225 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.environmentBoardTemplate = environmentBoardTemplate;
4
- const environmentIntensityMap = {
5
- balanced: `【镜头变化强度】空间展示清晰克制,优先让场景结构、出入口和动线一目了然。`,
6
- strong: `【镜头变化强度】在保持空间可读性的前提下,增加景别对比和导演感。`,
7
- aggressive: `【镜头变化强度】镜头角度更戏剧化,允许更强的构图张力,但不能破坏空间连续性。`,
8
- };
9
- /**
10
- * 生成导演级 Environment Board 提示词,用于锁定同一拍摄场景的空间一致性,
11
- * 并输出带导演手册说明的环境设定板。
12
- *
13
- * @param params 模板参数,包括用户场景描述、画面比例、面板数量和镜头强度。
14
- * @returns 适合生成单页环境设定板加导演手册的完整提示词。
15
- *
16
- * @example
17
- * ```ts
18
- * const prompt = environmentBoardTemplate({
19
- * userPrompt: '废弃地铁站月台,漏水、闪烁灯管、旧广告牌、冷蓝色夜景氛围',
20
- * page_aspect_ratio: '16:9',
21
- * maxPanels: 6,
22
- * });
23
- * ```
24
- */
25
- function environmentBoardTemplate(params) {
26
- const { userPrompt, page_aspect_ratio = '16:9', maxPanels, cinematicIntensity = 'strong', } = params;
27
- const safeMaxPanels = typeof maxPanels === 'number' && Number.isFinite(maxPanels)
28
- ? Math.max(5, Math.min(8, Math.floor(maxPanels)))
29
- : undefined;
30
- const intensityBlock = environmentIntensityMap[cinematicIntensity] ??
31
- environmentIntensityMap.strong;
32
- const panelCountRule = safeMaxPanels
33
- ? `
34
- 【主环境画格数量规则】
35
- - 主环境空间图的画格数量不多于 ${safeMaxPanels}
36
- - 主环境空间图至少包含 5 个核心视角:全景、俯视全景、核心中景、近景、特写
37
- - 若有额外主画格,只能用于补充同一空间的反打、入口、光源、功能区或关键陈设视角
38
- - 时序全景图、四季图和导演手册说明区不计入主环境画格数量,可作为独立条带或附加模块
39
- `.trim()
40
- : `
41
- 【主环境画格数量规则】
42
- - 自动决定为 5~8 个主环境画格
43
- - 必须包含 5 个核心视角:全景、俯视全景、核心中景、近景、特写
44
- - 额外主画格只用于补充同一空间的反打、入口、光源、功能区或关键陈设视角
45
- - 时序全景图、四季图和导演手册说明区不计入主环境画格数量,可作为独立条带或附加模块
46
- `.trim();
47
- const finalOutputRule = safeMaxPanels
48
- ? `
49
- 【最终输出】
50
- - 一张比例为 ${page_aspect_ratio} 的导演级环境设定板 + 导演手册页
51
- - 主环境空间图画格数量不多于 ${safeMaxPanels}
52
- - 所有空间图共同描述同一个拍摄场景,不得变成多个不同地点
53
- - 适合作为导演、美术、置景、摄影统一空间关系、光线逻辑与氛围节奏的参考板
54
- `.trim()
55
- : `
56
- 【最终输出】
57
- - 一张比例为 ${page_aspect_ratio} 的导演级环境设定板 + 导演手册页
58
- - 主环境空间图画格数量自动控制在 5~8 个
59
- - 所有空间图共同描述同一个拍摄场景,不得变成多个不同地点
60
- - 适合作为导演、美术、置景、摄影统一空间关系、光线逻辑与氛围节奏的参考板
61
- `.trim();
62
- return `You are creating a single director-level Environment Board plus light handwritten shooting notes for one continuous filming location.
63
-
64
- 【Core Goal】
65
- - Create one single composed environment board, not multiple separate images
66
- - The board must lock the spatial continuity of one location across multiple shot sizes
67
- - This is an environment board with a minimal director handbook feel, not a character sheet and not a story sequence
68
- - Show only the environment and static set dressing, with no actors, no people, and no living subjects
69
- - The page must primarily emphasize environment, atmosphere, color, lighting, and spatial continuity
70
- - Text must be minimal and secondary, only serving as small handwritten Chinese annotations
71
-
72
- 【Environment Locking Rules】
73
- - All panels must depict the exact same location
74
- - Keep architecture, terrain, entrances, exits, windows, pathways, stairs, props, furniture, signage, and light sources spatially consistent
75
- - Time of day, weather, lighting direction, color temperature, atmosphere, and material language must remain consistent across all panels
76
- - If the user mentions multiple beats or actions, extract only the environment and spatial information, not human performance
77
- - 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
78
-
79
- 【Mandatory Spatial Shot Language】
80
- - The board must contain these core views of the same environment:
81
- - 全景: the master establishing view of the whole location
82
- - 俯视全景: a top-down or high-angle spatial overview clarifying layout and movement paths
83
- - 核心中景: the most important functional camera-facing area of the set
84
- - 近景: a nearer view focusing on a key zone within the environment
85
- - 特写: a close-up of a critical environmental detail, texture, prop cluster, signage, mechanism, or atmospheric cue anchored in the same space
86
- - If extra panels are available, use them for reverse angle, entrance axis, light-source direction, depth layering, or another supporting view of the same environment
87
-
88
- 【Time Sequence Panorama Rules】
89
- - In addition to the main spatial shot panels, include a dedicated time-sequence panorama strip
90
- - If the location is clearly exterior, the time-sequence strip must contain 4 labeled panoramic views of the same location:
91
- - 清晨
92
- - 昼间
93
- - 黄昏
94
- - 夜间
95
- - These 4 exterior time panels must show the same viewpoint or a closely matched panoramic framing so the time-of-day change is easy to compare
96
- - If there are obvious seasonal differences, add a dedicated four-season strip showing the same exterior location in:
97
- - 春
98
- - 夏
99
- - 秋
100
- - 冬
101
- - The seasonal strip should only appear when seasonal variation is visually meaningful and clearly changes vegetation, weather, ground state, costume requirements of the set, or atmosphere
102
- - If the location is clearly interior, instead of the 4 exterior time panels, include 3 labeled interior lighting-state views of the same location:
103
- - 昼间
104
- - 夜晚灯下
105
- - 夜晚无灯
106
- - These interior lighting-state panels must clearly demonstrate how practical lights, spill, darkness, and atmosphere change while the space itself stays identical
107
- - All time-sequence and seasonal panels must have visible Chinese labels
108
-
109
- 【Director Handbook Requirements】
110
- - The page must include a light director-handbook layer in addition to the environment images
111
- - This handbook layer must be minimal, concise, and visually quiet
112
- - It should explain in Chinese what kind of condition should use which shot size
113
- - It should also briefly indicate professional lighting setup and intended environmental mood
114
- - The handbook layer should feel like handwritten director or cinematography notes, not dense printed documentation
115
-
116
- 【Shot Size Usage Notes】
117
- - Include a concise Chinese handwritten note block explaining when to use:
118
- - 全景: used when the audience must understand overall geography, scale, isolation, crowding, or full environmental relationship
119
- - 俯视全景: used when the audience must understand layout, routes, spatial hierarchy, entrances, exits, or tactical overview
120
- - 核心中景: used when the audience must focus on the main performance zone, key blocking area, or functional center of the set
121
- - 近景: used when the audience must notice a specific area, object cluster, lighting pocket, or emotional environmental detail
122
- - 特写: used when the audience must read a decisive prop, material, mechanism, weather trace, or atmosphere cue
123
- - These usage notes must be written in very short professional Chinese phrases
124
- - Use only brief labels or short note fragments, not paragraph explanations
125
- - These notes must be visually separated as light annotations and must never overpower the environment imagery
126
-
127
- 【Professional Lighting Handbook】
128
- - Include a small professional lighting note block
129
- - The lighting note block should briefly indicate likely key light logic, fill strategy, rim light or backlight logic, practical light sources, ambient bounce, haze or volumetric conditions, and contrast tendencies
130
- - Use professional but concise Chinese terminology such as:
131
- - 主光
132
- - 辅光
133
- - 轮廓光
134
- - 逆光
135
- - 实景灯源
136
- - 环境反射
137
- - 冷暖对比
138
- - 氛围雾
139
- - 体积光
140
- - The lighting plan must stay consistent with whether the scene is interior or exterior, and with each time-of-day panel
141
- - The board should visually demonstrate professional lighting more through color, value, shadow shape, and atmosphere than through text explanation
142
-
143
- 【Environmental Atmosphere Handbook】
144
- - Include a small environmental mood block
145
- - Describe atmosphere in terms of weather, humidity, dust, haze, smoke, air density, temperature impression, material aging, soundless tension, liveliness, loneliness, sacredness, danger, decay, comfort, or grandeur
146
- - These atmosphere notes must feel cinematic and production-relevant, not literary or vague
147
- - Atmosphere notes must support both the static environment design and how it should be photographed
148
- - The environment itself must carry the mood visually through cinematic color design, tonal control, contrast structure, and light behavior
149
-
150
- 【Composition Rules】
151
- - Output one complete board with a clean, readable, production-friendly layout
152
- - Overall page aspect ratio: ${page_aspect_ratio}
153
- - The board should read like a director + production designer + cinematographer environment continuity sheet
154
- - The upper or central main area should contain the main spatial shot panels
155
- - The lower or side handbook area should be lighter and smaller than before, containing only concise shot-size notes, lighting notes, atmosphere notes, and time-sequence strips
156
- - Each spatial panel must feel like a real camera angle from the same set
157
- - Vary shot size and angle, but do not break spatial logic
158
- - Make the viewer immediately understand where the camera is placed in relation to the space
159
- - The page must feel like one unified professional environment board, not a collage of unrelated concept sketches
160
- - The visual focus must remain on environment images, not on text blocks
161
-
162
- ${panelCountRule}
163
-
164
- 【Visual Rules】
165
- - No actors
166
- - No people
167
- - No crowd
168
- - No silhouette figures
169
- - No mannequins
170
- - No portraits
171
- - No floating character references
172
- - Static environmental objects are allowed only if they belong to the set and stay spatially grounded
173
- - Prioritize readable architecture, staging zones, object placement, atmosphere, lighting, and material continuity
174
- - The environment should feel cinematic, professional, and directly useful for production planning
175
- - The time-sequence and seasonal strips should still look like part of the same production document, not separate postcards
176
- - Use professional photography aesthetics that match the user-specified style
177
- - Push color palette, exposure control, shadow layering, practical light glow, atmospheric perspective, and cinematic contrast to a more advanced level
178
- - Make the board feel visually premium, with stronger cinematography and production-design sensibility
179
- - The handwritten notes should stay small, light, and unobtrusive
180
-
181
- 【Style Rules】
182
- - If the user specifies a style, medium, era, architecture type, or visual mood, follow it strictly
183
- - If the user does not specify a style, default to: cinematic production design board, realistic environment concept art, strong photography aesthetics, controlled color script, refined shadow design, professional film set presentation
184
- - Maintain one unified visual language across the full board
185
- - The final image should feel closer to a high-end cinematography environment pitch board than a technical annotation sheet
186
-
187
- 【Text Rules】
188
- - Any visible text inside the generated image must be Chinese only
189
- - Each main spatial panel should have only one small Chinese handwritten shot-size label, such as 全景, 俯视全景, 核心中景, 近景, 特写
190
- - Main spatial panels must not contain any other symbols, arrows, numbers, annotations, labels, notes, callouts, or extra text beyond the shot-size label itself
191
- - Do not place any handwritten notes inside the main spatial panels except the shot-size label
192
- - Time-sequence panels must have visible Chinese labels such as 清晨、昼间、黄昏、夜间
193
- - Four-season panels must have visible Chinese labels such as 春、夏、秋、冬
194
- - Interior lighting-state panels must have visible Chinese labels such as 昼间、夜晚灯下、夜晚无灯
195
- - All labels and notes should look like concise Chinese handwritten annotations
196
- - Simulate natural handwritten Chinese note style, clean and readable, not printed paragraph text
197
- - Labels must be concise, professional, and unobtrusive
198
- - Handbook note blocks must also be in Chinese and must stay very brief
199
- - Do not generate dialogue balloons or subtitles
200
- - Avoid large text blocks, long sentences, tables, and document-heavy layouts
201
- - Prefer tiny handwritten labels, short callouts, and brief note fragments
202
-
203
- 【Spatial Continuity Requirements】
204
- - Camera angles may change, but the environment cannot drift
205
- - Preserve the same world orientation, same structural anchors, and same core prop positions
206
- - The top-down or high-angle overview must help explain how the other views belong to the same place
207
- - Near and close-up views must clearly feel extracted from the previously established environment, not from a new location
208
- - Time-sequence and seasonal panels must also preserve the same spatial anchors, even as light, weather, season, or practical lighting changes
209
-
210
- ${intensityBlock}
211
-
212
- 【Document Realism Rules】
213
- - Use a clean presentation layout, but keep it visually elegant and image-led rather than document-heavy
214
- - The page should look useful to directing, cinematography, lighting, art department, and VFX continuity teams
215
- - Do not make it look like a poster
216
- - Do not make it look like a text-dense manual sheet
217
- - Do not make it look like random environment thumbnails without explanation
218
- - It should look like a premium preproduction environment board with a few handwritten Chinese notes
219
-
220
- 【User Input】
221
- ${userPrompt}
222
-
223
- ${finalOutputRule}`.trim();
224
- }
225
- //# sourceMappingURL=environment-board-tpl.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"environment-board-tpl.js","sourceRoot":"","sources":["../../src/utils/environment-board-tpl.ts"],"names":[],"mappings":";;AA+BA,4DAqNC;AA3OD,MAAM,uBAAuB,GAAuC;IAClE,QAAQ,EAAE,sCAAsC;IAChD,MAAM,EAAE,kCAAkC;IAC1C,UAAU,EAAE,wCAAwC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,wBAAwB,CACtC,MAAsC;IAEtC,MAAM,EACJ,UAAU,EACV,iBAAiB,GAAG,MAAM,EAC1B,SAAS,EACT,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,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,cAAc,GAClB,uBAAuB,CAAC,kBAAkB,CAAC;QAC3C,uBAAuB,CAAC,MAAM,CAAC;IAEjC,MAAM,cAAc,GAAG,aAAa;QAClC,CAAC,CAAC;;mBAEa,aAAa;;;;CAI/B,CAAC,IAAI,EAAE;QACJ,CAAC,CAAC;;;;;;CAML,CAAC,IAAI,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,aAAa;QACnC,CAAC,CAAC;;UAEI,iBAAiB;kBACT,aAAa;;;CAG9B,CAAC,IAAI,EAAE;QACJ,CAAC,CAAC;;UAEI,iBAAiB;;;;CAI1B,CAAC,IAAI,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA0FsB,iBAAiB;;;;;;;;;;EAU9C,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDd,cAAc;;;;;;;;;;;EAWd,UAAU;;EAEV,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}