cerevox 4.73.0 → 4.75.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.
- package/dist/core/ai.d.ts +3 -1
- package/dist/core/ai.d.ts.map +1 -1
- package/dist/core/ai.js +14 -5
- package/dist/core/ai.js.map +1 -1
- package/dist/mcp/servers/prompts/skills/core-rules.md +2 -1
- package/dist/mcp/servers/zerocut.d.ts.map +1 -1
- package/dist/mcp/servers/zerocut.js +14 -9
- package/dist/mcp/servers/zerocut.js.map +1 -1
- package/dist/utils/director-note-tpl.d.ts.map +1 -1
- package/dist/utils/director-note-tpl.js +37 -14
- package/dist/utils/director-note-tpl.js.map +1 -1
- package/dist/utils/{environment-board-tpl.d.ts → environment-card-tpl.d.ts} +7 -9
- package/dist/utils/environment-card-tpl.d.ts.map +1 -0
- package/dist/utils/environment-card-tpl.js +179 -0
- package/dist/utils/environment-card-tpl.js.map +1 -0
- package/dist/utils/npc-card-tpl.d.ts +18 -0
- package/dist/utils/npc-card-tpl.d.ts.map +1 -0
- package/dist/utils/npc-card-tpl.js +150 -0
- package/dist/utils/npc-card-tpl.js.map +1 -0
- package/dist/utils/storyboard-sketch-tpl.d.ts.map +1 -1
- package/dist/utils/storyboard-sketch-tpl.js +12 -8
- package/dist/utils/storyboard-sketch-tpl.js.map +1 -1
- package/package.json +1 -1
- package/dist/utils/environment-board-tpl.d.ts.map +0 -1
- package/dist/utils/environment-board-tpl.js +0 -225
- package/dist/utils/environment-board-tpl.js.map +0 -1
|
@@ -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"}
|