@ninkch/dsh-artcraft 0.3.2 → 0.3.3

package/skills/artcraft-director-lens/references/director-styles/12_fincher.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-fincher
+description: >-
+  导演透镜（ArtCraft 适配版）：大卫·芬奇导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 大卫·芬奇导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: fincher
+lens_kit_mm: [35, 85, 135]   # 85/135 为主力，长焦压缩把人物从背景抠出；35 只用于一次性交代几何
+camera:
+  prefer: [locked precise frame, imperceptible 3-6 percent push-in, slow pull-back on a mechanical dolly, surveillance framing from behind glass, invisible complex oner]
+  avoid: [handheld, camera shake, orbit, whip pan, wide-angle distortion]
+  motion_budget: low          # 有移动但幅度以百分比计量，观众不应察觉
+  height: "exact eye level or 10cm above, repeatable to the centimetre"
+shot_size_bias: [medium close-up, close-up, medium from a surveillance position, insert on hands and documents, wide only to establish geometry once]
+composition: [subject isolated by shallow depth at f/2-f/2.8, background compressed into unreadable color blocks, framing through glass or a door gap, exact horizontal and vertical alignment, subject placed on a third with dead space where the threat would be]
+lighting:
+  key_quality: mixed
+  key_ratio: "4:1 to 6:1"
+  motivation: practical
+  signature: "青绿阴影对琥珀实用光；黑位抬起，阴影里始终有可读纹理"
+palette:
+  dominant: "teal-green shadow, desaturated charcoal, cold grey"
+  accent: "amber practical, sodium yellow, a single skin tone"
+  saturation: low
+  contrast: low
+editing:
+  avg_shot_length_s: "4-9"     # 场景内的信息蒙太奇可降到 0.5-1.5 秒
+  transition_bias: [hard cut, cut to black]
+  coverage_style: "机位可精确复现；切点必须能说出理由；场景末尾用近乎静止的长挂收尾"
+sound:
+  music: "电子与合成器持续音，制造生理不适；可在场景中途无交代地消失"
+  ambience: "键盘、复印机、荧光镇流器、硬盘、电流嗡鸣，可推到主导地位"
+  dialogue: "清晰干燥、混响少、语速偏快、信息密度高、情绪幅度小"
+  silence_use: "说谎者说完后停 2-3 秒不切，用静默暴露破绽"
+performance:
+  register: "收敛精算，魅力来自能力；加害者造型平庸不加设计"
+  blocking: "走位由工作流程决定；人物很少正对镜头，常被摄影机从其不知情的位置观察"
+aspect_bias: "2.39:1"
+ai_video:
+  clip_duration_s: "4-8"
+  prompt_bias: "点名唯一实用光源实体，把推进写成百分比，把景深写成光圈值；主体动作限定为一个职业性小动作（对齐、擦拭、翻页、点击）。"
+  risk: "模型给出手持漂移、镜头光晕和压死的纯黑，或把'干净'渲染成塑料感 CG。缓解：负面词写 handheld drift / lens flare / crushed black；正面写 fine film grain、dust-free air、locked frame with zero breathing。"
+negative_prompt_adds: [handheld drift, camera shake, lens flare, crushed pure black, warm romantic glow, atmospheric haze, visible bokeh balls, wide-angle distortion]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"4-9"s**（conventional（5–12s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**[hard cut, cut to black]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："机位可精确复现；切点必须能说出理由；场景末尾用近乎静止的长挂收尾"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"4:1 to 6:1"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："teal-green shadow, desaturated charcoal, cold grey" → `mixer.{green,orange,aqua,yellow}.*` 定点 + `grading.*` 方向
+- 点缀："amber practical, sodium yellow, a single skin tone"
+- 饱和/对比：low / low
+- 光线签名："青绿阴影对琥珀实用光；黑位抬起，阴影里始终有可读纹理"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："电子与合成器持续音，制造生理不适；可在场景中途无交代地消失"
+- 环境："键盘、复印机、荧光镇流器、硬盘、电流嗡鸣，可推到主导地位"
+- 对白："清晰干燥、混响少、语速偏快、信息密度高、情绪幅度小"
+- 静默："说谎者说完后停 2-3 秒不切，用静默暴露破绽"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：[locked precise frame, imperceptible 3-6 percent push-in, slow pull-back on a mechanical dolly, surveillance framing from behind glass, invisible complex oner]
+- 避免：[handheld, camera shake, orbit, whip pan, wide-angle distortion]
+- 运动预算：low
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/13_refn.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-refn
+description: >-
+  导演透镜（ArtCraft 适配版）：尼古拉斯·温丁·雷弗恩导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 尼古拉斯·温丁·雷弗恩导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: refn
+lens_kit_mm: [25, 40, 75]   # 25 把房间拍成舞台，40 拍仪式中景，75 拍锁死的脸；避免长焦压缩与广角变形
+camera:
+  prefer: [locked frontal symmetric frame, single constant push under 5cm per second, locked face portrait held 12-25s, overhead centred on the ritual, hard cut between identical setups]
+  avoid: [handheld, orbit, pan, tilt, any move that breaks symmetry]
+  motion_budget: none
+  height: "chest height, perpendicular to the wall, subject's centre line exactly on frame centre"
+shot_size_bias: [medium frontal, close-up frontal portrait, wide frontal of the room as a stage, overhead, extreme close-up on hands]
+composition: [absolute bilateral symmetry, flat frontal plane with no depth cues, subject dead centre, colour split into two hard-edged halves, large areas of pure black as material]
+lighting:
+  key_quality: hard
+  key_ratio: "8:1 to 12:1"
+  motivation: stylized
+  signature: "舞台灯式硬边色块；画面里能直接看见两种颜色的分界线"
+palette:
+  dominant: "magenta, electric blue"
+  accent: "blood red, moonlight violet, pure black"
+  saturation: high
+  contrast: high
+editing:
+  avg_shot_length_s: "10-25"
+  transition_bias: [hard cut]
+  coverage_style: "同机位同姿势重复 2-3 次；一场 2-5 个镜头；暴力单镜完成，前后各挂静止镜头"
+sound:
+  music: "合成器音墙决定段落长度，低频持续音加琶音循环，几乎不变化"
+  ambience: "要么压到近乎消失，要么夸张到不自然（呼吸、织物、灯的嗡鸣），不共存"
+  dialogue: "短、宣告式、无信息量，一场不超过两句"
+  silence_use: "暴力前 1-2 秒完全静音，让声效独自炸开"
+performance:
+  register: "雕塑式克制，姿态优先于表情；直视镜头每段只用一次"
+  blocking: "人物走到画面正中并停住；走位是直线，方向只有前后"
+aspect_bias: "2.39:1"
+ai_video:
+  clip_duration_s: "8-15"
+  prompt_bias: "先写颜色分界线在画面的哪个位置，再写人物姿势，最后只给一个微动作；运动预算给光，不给摄影机也不给人。"
+  risk: "锁死构图加静止人物容易被模型渲染成一张死图；'霓虹'又常被理解成拥挤的赛博街景加招牌文字。缓解：明确写 the camera does not move and the subject does not walk，把唯一的运动交给光（例如 the magenta wash slowly shifts to cyan over six seconds），并在负面词里点名 signage 与 text。"
+negative_prompt_adds: [street signage, on-screen text, cyberpunk crowd, rain-slick busy street, handheld shake, soft diffused fill, pastel desaturation, foreground obstruction]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"10-25"s**（observational / 长镜（8–15s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**[hard cut]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："同机位同姿势重复 2-3 次；一场 2-5 个镜头；暴力单镜完成，前后各挂静止镜头"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"8:1 to 12:1"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："magenta, electric blue" → `mixer.{magenta,red,blue}.*` 定点 + `grading.*` 方向
+- 点缀："blood red, moonlight violet, pure black"
+- 饱和/对比：high / high
+- 光线签名："舞台灯式硬边色块；画面里能直接看见两种颜色的分界线"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："合成器音墙决定段落长度，低频持续音加琶音循环，几乎不变化"
+- 环境："要么压到近乎消失，要么夸张到不自然（呼吸、织物、灯的嗡鸣），不共存"
+- 对白："短、宣告式、无信息量，一场不超过两句"
+- 静默："暴力前 1-2 秒完全静音，让声效独自炸开"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：[locked frontal symmetric frame, single constant push under 5cm per second, locked face portrait held 12-25s, overhead centred on the ritual, hard cut between identical setups]
+- 避免：[handheld, orbit, pan, tilt, any move that breaks symmetry]
+- 运动预算：none
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/14_bi_gan.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-bi_gan
+description: >-
+  导演透镜（ArtCraft 适配版）：毕赣导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 毕赣导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: bi_gan
+lens_kit_mm: [18, 25, 35]   # 广角为主：狭窄空间可通行，自然景深，湿反光铺满画面
+camera:
+  prefer: [continuous gimbal drift at walking pace, follow from one to two seconds behind, pass-through a door or bridge or tunnel as a transition, drift away from the subject at the end, slow rise up a stairwell]
+  avoid: [cut, locked tripod, absolute drone smoothness, whip pan, crash zoom]
+  motion_budget: medium       # 一直在动，但速度恒定在 0.8-1.2m/s，是走路不是飞行
+  height: "shoulder to chest, with a slight breathing rise and fall, never perfectly level"
+shot_size_bias: [medium following shot, wide traversal, over-shoulder from behind, medium close-up in passing, empty frame after the subject leaves]
+composition: [wet reflective foreground, doorway and tunnel framing as transition gates, mixed light sources within one frame, subject leaving and re-entering frame, recurring object placed at a passing point]
+lighting:
+  key_quality: soft
+  key_ratio: "2.5:1 to 3.5:1"
+  motivation: practical
+  signature: "潮湿表面的反射当主光；霓虹、荧光管、白炽灯泡、电视青光同框且不校正色温"
+palette:
+  dominant: "humid teal-green, dim purple, tungsten amber"
+  accent: "karaoke neon pink, television cyan, rust red"
+  saturation: low
+  contrast: low
+editing:
+  avg_shot_length_s: "45-600"
+  transition_bias: [pass-through as transition, fade, dissolve]
+  coverage_style: "一场一镜，无覆盖率；镜头在人物离开后继续漂移 10 秒以上"
+sound:
+  music: "老歌、卡拉 OK 伴唱、磁带走带声；音源必须在场景里有物理出处"
+  ambience: "雨、滴水、电风扇、火、远处摩托、犬吠、球杆撞击"
+  dialogue: "方言、低音量，可被雨声盖过一半"
+  silence_use: "不用完全消音；静默由自然声填满，孤独感来自声音的空旷而非无声"
+performance:
+  register: "内敛，情绪靠沉默、抽烟、走路速度传达；同一张脸可以是两个人"
+  blocking: "沿一条可绘制的路径行走，途经 3-5 个点；允许走出画面再走回"
+aspect_bias: "2.39:1"
+ai_video:
+  clip_duration_s: "10-20"    # 取所用工具允许的最长单条时长；长镜头靠首尾帧串联，不指望单条 clip 完成
+  prompt_bias: "先写路径（起点、途经点、终点）和每个点的光源类型，再写摄影机的漂移速度与滞后量，人物动作只写走路与一次停顿。"
+  risk: "单条 clip 的时长上限远短于一个数分钟的长镜头（以当前主流工具而言，用前请查其当前文档），逐条生成又会在中途丢失人物身份和光源逻辑。缓解：在提供首帧输入的工具上把长镜头切成链条，用上一段的末帧做下一段的首帧，并把每个接缝安排在一次穿越（过门／钻桥洞／穿雨帘）上，这样接缝读起来像设计过的通过而不是剪辑；链条的具体做法由 ai-video-tool-adapters.md 负责。"
+negative_prompt_adds: [hard cut, dry clean surfaces, hard-edged shadows, drone-smooth flight, saturated stage color, symmetric composition, corrected white balance, empty sterile space]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"45-600"s**（observational / 长镜（8–15s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**[pass-through as transition, fade, dissolve]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："一场一镜，无覆盖率；镜头在人物离开后继续漂移 10 秒以上"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"2.5:1 to 3.5:1"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："humid teal-green, dim purple, tungsten amber" → `mixer.{green,red,orange,aqua,purple}.*` 定点 + `grading.*` 方向
+- 点缀："karaoke neon pink, television cyan, rust red"
+- 饱和/对比：low / low
+- 光线签名："潮湿表面的反射当主光；霓虹、荧光管、白炽灯泡、电视青光同框且不校正色温"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："老歌、卡拉 OK 伴唱、磁带走带声；音源必须在场景里有物理出处"
+- 环境："雨、滴水、电风扇、火、远处摩托、犬吠、球杆撞击"
+- 对白："方言、低音量，可被雨声盖过一半"
+- 静默："不用完全消音；静默由自然声填满，孤独感来自声音的空旷而非无声"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：[continuous gimbal drift at walking pace, follow from one to two seconds behind, pass-through a door or bridge or tunnel as a transition, drift away from the subject at the end, slow rise up a stairwell]
+- 避免：[cut, locked tripod, absolute drone smoothness, whip pan, crash zoom]
+- 运动预算：medium
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/15_zhang_yimou.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-zhang_yimou
+description: >-
+  导演透镜（ArtCraft 适配版）：张艺谋导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 张艺谋导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: zhang_yimou
+lens_kit_mm: [35, 50, 85, 135]   # 35 做院落单点对称；85-135 把重复单元压成平面图案；24mm 以下会破坏等距
+camera:
+  prefer: ["locked symmetrical wide", "constant-speed lateral track parallel to a rank", "slow push-in on the one figure breaking the pattern", "rise from eye level to 90-degree overhead", "locked overhead top-down of the grid"]
+  avoid: ["handheld shake", "orbit", "whip pan", "dutch angle", "unmotivated reframe"]
+  motion_budget: medium        # 恒速无加减速；横移 0.3-0.5 m/s，缓推 8 秒 1.5 米
+  height: "eye level 1.6m locked, or 90-degree overhead; 中间高度不用"
+shot_size_bias: ["extreme wide with the color field", "wide symmetrical", "overhead pattern shot", "medium close-up of the single break", "insert on the colored material"]
+composition: ["single-hue field filling 60-80% of frame", "grid of repeating units with one break", "one-point perspective through a courtyard or gallery", "overhead figures as graphic points", "one saturated accent against skin and black hair"]
+lighting:
+  key_quality: hard
+  key_ratio: "3:1 外景日光；6:1-8:1 灯笼阵夜内景"
+  motivation: stylized
+  signature: "颜色来自材料而非滤色片；硬光让织纹与颗粒可见，阴影里保留色相"
+palette:
+  dominant: "one hue per movement — red, ochre yellow, jade green, or ink blue"
+  accent: "skin tone, black hair, one patch of pure white or pure black"
+  saturation: high
+  contrast: mid
+editing:
+  avg_shot_length_s: "4-10 仪式段；3-6 冲突段"
+  transition_bias: ["hard cut", "match cut on pattern", "dissolve"]
+  coverage_style: "一场 4-8 个镜头；全景与顶俯为主，特写只给破格的人或物"
+sound:
+  music: "打击乐定拍，单件民乐器只在破格时进入"
+  ambience: "材料的声音——布抖、谷落、木轴、整齐落地的脚步"
+  dialogue: "少而宣告式；群体人声当音效用，音量高于对白"
+  silence_use: "换色前 1-2 秒近乎全静音，只留一个环境元素"
+performance:
+  register: "外化、可在全景中读出；姿态与屏息大于表情"
+  blocking: "全员同拍同角度的网格队形；主角全段只破格 1-2 次"
+aspect_bias: "2.39:1 / 1.85:1"   # 横向排布队列；顶俯图形镜头允许切到更方的比例；9:16 交付时的构图改写见「镜头语言」末条
+ai_video:
+  clip_duration_s: "3-6"
+  prompt_bias: "先写颜色和承载它的材料，再写队列的行列数与统一动作，最后写那唯一一个不同步的人；每条 clip 只做一个恒速运动。"
+  risk: "远景人群会糊成多肢体、脸部融化的一团。缓解：让人群背对或戴统一头饰、把人群放在中景以外并只保留 2-3 排、把破格者单独生成一条再剪在一起。"
+negative_prompt_adds: ["desaturated palette", "mixed color temperatures in one frame", "neon signage", "handheld shake", "lens flare", "zippers or printed logos", "asymmetric crop", "shallow depth of field"]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"4-10 仪式段；3-6 冲突段"s**（conventional（5–12s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**["hard cut", "match cut on pattern", "dissolve"]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："一场 4-8 个镜头；全景与顶俯为主，特写只给破格的人或物"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"3:1 外景日光；6:1-8:1 灯笼阵夜内景"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："one hue per movement — red, ochre yellow, jade green, or ink blue" → `mixer.{green,red,aqua,blue,yellow}.*` 定点 + `grading.*` 方向
+- 点缀："skin tone, black hair, one patch of pure white or pure black"
+- 饱和/对比：high / mid
+- 光线签名："颜色来自材料而非滤色片；硬光让织纹与颗粒可见，阴影里保留色相"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："打击乐定拍，单件民乐器只在破格时进入"
+- 环境："材料的声音——布抖、谷落、木轴、整齐落地的脚步"
+- 对白："少而宣告式；群体人声当音效用，音量高于对白"
+- 静默："换色前 1-2 秒近乎全静音，只留一个环境元素"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：["locked symmetrical wide", "constant-speed lateral track parallel to a rank", "slow push-in on the one figure breaking the pattern", "rise from eye level to 90-degree overhead", "locked overhead top-down of the grid"]
+- 避免：["handheld shake", "orbit", "whip pan", "dutch angle", "unmotivated reframe"]
+- 运动预算：medium
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/16_hou_hsiao_hsien.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-hou_hsiao_hsien
+description: >-
+  导演透镜（ArtCraft 适配版）：侯孝贤导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 侯孝贤导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: hou_hsiao_hsien
+lens_kit_mm: [50, 85, 100]   # 从 6-12 米外用中长焦拍全景：远，但清楚；不用广角贴近
+camera:
+  prefer: ["locked long hold on sticks", "minimal reframe pan under 20 degrees", "hold on the empty room after everyone leaves", "shoot one room from inside another through a doorway", "deep-focus three-plane static frame"]
+  avoid: ["push-in", "handheld", "crane", "orbit", "cut to close-up"]
+  motion_budget: none          # 唯一允许的运动是慢到观众察觉不到的补构图摇
+  height: "seated eye height 1.0-1.2m, locked, unchanged for the whole scene"
+shot_size_bias: ["wide", "medium wide", "doorway-framed wide", "medium two-shot at distance", "empty room after exit"]
+composition: ["doorway or window frame eating the outer quarter of the frame", "three simultaneous planes of activity", "figures small and off-centre", "flat frontal wall behind the action", "camera positioned outside the room being filmed"]
+lighting:
+  key_quality: soft
+  key_ratio: "2:1 to 4:1"
+  motivation: naturalistic
+  signature: "门口或窗口的白天户外光是唯一主光，室内低 1-2 档，脸允许在暗部，没有任何补光"
+palette:
+  dominant: "aged wood brown, whitewash grey, foliage green outside the door, washed indigo cloth"
+  accent: "one saturated note only — a red garment, a plastic bucket, a green fluorescent tube"
+  saturation: mid
+  contrast: mid
+editing:
+  avg_shot_length_s: "40-120"
+  transition_bias: ["hard cut", "fade to black"]
+  coverage_style: "一场 1-3 个镜头，无反打无特写；每次切点同时跳过一段时间"
+sound:
+  music: "近乎为零，且只用源音乐（隔壁收音机、街上驶过的车、别的房间的歌）"
+  ambience: "完整现场声床：蝉、车流、厨房、电扇、隔壁电视；本底噪声全片不断"
+  dialogue: "重叠、含混、带方言，边做事边说，一半听不清；音量随距离衰减"
+  silence_use: "没有真正的静音；最重的转折可以完全没有声音标记"
+performance:
+  register: "非表演；先做手上的事，情绪从做事的节奏里漏出来"
+  blocking: "人物自由进出画面，摄影机不追；离开后房间里剩下的人才是内容"
+aspect_bias: "1.85:1 / 16:9"   # 9:16 交付时的构图改写见「镜头语言」末条
+ai_video:
+  clip_duration_s: "8-12"      # 取所用工具的单条上限（各家不同，以其当前文档为准）；宁可一条完整长镜，不要三个短镜头
+  prompt_bias: "把整个房间写成一张同时进行的小动作清单（前中后各一件），然后明确要求摄影机什么都不做。"
+  risk: "模型把'固定机位'理解成静止照片，或者自作主张加一个缓推。缓解：点名三处持续的小运动（蒸汽、风扇、窗帘、电视闪烁、远处门口有人经过），并显式写 camera does not move, no zoom, no push-in。"
+negative_prompt_adds: ["camera push-in or zoom", "handheld shake", "close-up", "shallow depth of field", "dramatic lighting", "orchestral score", "empty stylized set", "slow motion"]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"40-120"s**（observational / 长镜（8–15s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**["hard cut", "fade to black"]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："一场 1-3 个镜头，无反打无特写；每次切点同时跳过一段时间"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"2:1 to 4:1"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："aged wood brown, whitewash grey, foliage green outside the door, washed indigo cloth" → `mixer.{green,red}.*` 定点 + `grading.*` 方向
+- 点缀："one saturated note only — a red garment, a plastic bucket, a green fluorescent tube"
+- 饱和/对比：mid / mid
+- 光线签名："门口或窗口的白天户外光是唯一主光，室内低 1-2 档，脸允许在暗部，没有任何补光"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："近乎为零，且只用源音乐（隔壁收音机、街上驶过的车、别的房间的歌）"
+- 环境："完整现场声床：蝉、车流、厨房、电扇、隔壁电视；本底噪声全片不断"
+- 对白："重叠、含混、带方言，边做事边说，一半听不清；音量随距离衰减"
+- 静默："没有真正的静音；最重的转折可以完全没有声音标记"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：["locked long hold on sticks", "minimal reframe pan under 20 degrees", "hold on the empty room after everyone leaves", "shoot one room from inside another through a doorway", "deep-focus three-plane static frame"]
+- 避免：["push-in", "handheld", "crane", "orbit", "cut to close-up"]
+- 运动预算：none
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/17_park_chan_wook.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-park_chan_wook
+description: >-
+  导演透镜（ArtCraft 适配版）：朴赞郁导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 朴赞郁导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: park_chan_wook
+lens_kit_mm: [28, 40, 50, 85]   # 28 只给那一次不可能运动；40-50 做正面对称；85 给装饰性插入
+camera:
+  prefer: ["one impossible continuous move per scene (through a wall, floor, or 90-degree rotation)", "locked frontal symmetrical hold", "constant-speed lateral track along a patterned wall", "90-degree overhead of the act", "ornamental insert on hands and objects"]
+  avoid: ["handheld verite", "documentary reframe", "unmotivated dutch angle", "random shake", "drone establishing shot"]
+  motion_budget: high          # 高但被编排：每场恰好一次夸张运动，其余全锁定
+  height: "chest height 1.4m frontal and locked; the flourish changes height mid-move"
+shot_size_bias: ["frontal symmetrical medium", "wide showing the whole decorated room", "ornamental insert", "90-degree overhead", "medium close-up held one beat too long"]
+composition: ["at least three distinct patterns visible per interior frame", "frontal symmetry with one deliberate off-axis element", "frame within frame through a decorated doorway", "foreground lace or foliage as a scrim", "the guilty object placed at exact frame centre"]
+lighting:
+  key_quality: mixed
+  key_ratio: "3:1 常规；8:1 暴力发生的那一颗（靠关补光而非加硬光）"
+  motivation: practical
+  signature: "暖实用光以掠射角打在纹样表面，让图案浮起；冷色只从窗外进来，不超过 20% 画幅"
+palette:
+  dominant: "burgundy, olive green, mustard gold, walnut brown"
+  accent: "blood red, jade green, ivory"
+  saturation: high
+  contrast: mid
+editing:
+  avg_shot_length_s: "3-8，含一次 40-90 秒的形式长镜"
+  transition_bias: ["hard cut", "match cut on pattern or shape", "sudden 0.5s ornamental insert"]
+  coverage_style: "对称正面单人 + 装饰性插入 + 每场一次炫技长镜；反打保持完全相同构图"
+sound:
+  music: "室内乐或圆舞曲端正演奏，与内容落差即反讽；无 stinger，无低频轰击"
+  ambience: "被放大的精确拟音：织物、瓷器、剪刀、钥匙、指甲刮木头"
+  dialogue: "过度礼貌、书面、称谓完整；威胁用敬语说出"
+  silence_use: "暴力前 1-2 秒把音乐与环境声一起切掉，再一次性推回"
+performance:
+  register: "得体的表情比情境允许的多维持 1-2 秒才变；'晚一拍'是表演签名"
+  blocking: "端坐对称、手有明确位置；站起来是重大事件，一场最多一次"
+aspect_bias: "2.39:1 / 1.85:1"
+ai_video:
+  clip_duration_s: "4-8"
+  prompt_bias: "点名画面里三种具体图案，然后把摄影机运动写成起点—路径—终点三段式的确定路径（下降、后退、旋转各写出量）；人物只做一个礼节性动作。"
+  risk: "高密度花纹会让模型产生摩尔纹、墙纸蠕动和图案漂移。缓解：把花纹烘进关键帧、选用大尺度母题（最小重复单元 ≥ 1/40 画幅高）；除那一次编排好的运动外，其余镜头的运动限制在单轴且慢。"
+negative_prompt_adds: ["handheld shake", "flat grey walls", "empty minimalist set", "moire", "tiny repeating micro-pattern", "gore splatter", "lens flare", "modern office lighting"]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"3-8，含一次 40-90 秒的形式长镜"s**（conventional（5–12s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**["hard cut", "match cut on pattern or shape", "sudden 0.5s ornamental insert"]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："对称正面单人 + 装饰性插入 + 每场一次炫技长镜；反打保持完全相同构图"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"3:1 常规；8:1 暴力发生的那一颗（靠关补光而非加硬光）"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："burgundy, olive green, mustard gold, walnut brown" → `mixer.{green,red,orange,aqua}.*` 定点 + `grading.*` 方向
+- 点缀："blood red, jade green, ivory"
+- 饱和/对比：high / mid
+- 光线签名："暖实用光以掠射角打在纹样表面，让图案浮起；冷色只从窗外进来，不超过 20% 画幅"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："室内乐或圆舞曲端正演奏，与内容落差即反讽；无 stinger，无低频轰击"
+- 环境："被放大的精确拟音：织物、瓷器、剪刀、钥匙、指甲刮木头"
+- 对白："过度礼貌、书面、称谓完整；威胁用敬语说出"
+- 静默："暴力前 1-2 秒把音乐与环境声一起切掉，再一次性推回"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：["one impossible continuous move per scene (through a wall, floor, or 90-degree rotation)", "locked frontal symmetrical hold", "constant-speed lateral track along a patterned wall", "90-degree overhead of the act", "ornamental insert on hands and objects"]
+- 避免：["handheld verite", "documentary reframe", "unmotivated dutch angle", "random shake", "drone establishing shot"]
+- 运动预算：high
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位

package/skills/artcraft-director-lens/references/director-styles/18_malick.md

@@ -0,0 +1,81 @@
+---
+name: artcraft-lens-malick
+description: >-
+  导演透镜（ArtCraft 适配版）：泰伦斯·马力克导演风格 Skill。把该导演的工作方式翻译成 ArtCraft 可执行参数——FilmCraft 时间线与转场、LightCraft 影调分区、SoundCraft 声音规则、EffectCraft 机位。当用户点名该导演、要求该风格，或项目美学圣经引用该透镜时加载。
+---
+
+# 泰伦斯·马力克导演风格 Skill（ArtCraft 适配版）
+
+## 风格参数 / Style parameters
+
+```yaml
+style_id: malick
+lens_kit_mm: [14, 21, 28, 35]   # 广角必须配贴近：拍手 30-50cm，拍脸 60-90cm；前景巨大而地平线在后
+camera:
+  prefer: ["drifting handheld just behind a shoulder at walking pace", "low sweep up past a body toward sky or canopy", "slow arc while walking around a figure", "sudden tilt away from a face to a hand, grass, or water", "floating rise at gait rhythm"]
+  avoid: ["locked tripod hold", "symmetrical frontal composition", "zoom", "whip pan", "drone hero shot"]
+  motion_budget: high          # 持续但慢：0.8-1.2 m/s，低频，无急停急起
+  height: "continuously variable 0.3-1.8m, never settles"
+shot_size_bias: ["close insert on hands and objects", "medium close following just off a shoulder", "wide with a figure small against sky", "low angle through grass or foliage", "back-of-head follow"]
+composition: ["huge foreground element with the horizon behind it", "sun in frame behind the subject", "figure entering or leaving frame constantly", "no symmetry, no centred subject", "sky occupying the upper half"]
+lighting:
+  key_quality: soft
+  key_ratio: "2:1 to 3:1"
+  motivation: naturalistic
+  signature: "太阳在人物后方、高度 2-10 度，直射进广角镜头；脸只靠天光和地面反射抬起来，不打灯"
+palette:
+  dominant: "grass green, wheat gold, sky blue-white, skin"
+  accent: "low-sun amber, deep shadow blue"
+  saturation: mid
+  contrast: low
+editing:
+  avg_shot_length_s: "2-5，每 60-90 秒给一颗 6-10 秒不切的呼吸镜头"
+  transition_bias: ["hard cut", "dissolve on light", "cut away mid-gesture"]
+  coverage_style: "不做覆盖率：同一情境连拍 5-10 分钟不停机，在素材里找顺序"
+sound:
+  music: "古典 / 合唱 / 极简弦乐成段铺陈，不按情绪点入场；最重的手势处突然抽掉 2-4 秒"
+  ambience: "风穿过草、虫鸣、水、远处的鸟、衣料摩擦、土上的脚步"
+  dialogue: "重叠、轻声、常被风盖住，一半听不清；重要的话交给旁白"
+  silence_use: "极少真静音；用音乐抽掉来代替静音"
+performance:
+  register: "不给情绪指令，给情境与一个物理任务，然后长时间拍"
+  blocking: "并肩走、绕圈、一前一后；很少静止面对彼此，对峙用背影和距离表达"
+aspect_bias: "2.39:1 / 1.85:1"
+ai_video:
+  clip_duration_s: "3-5"
+  prompt_bias: "一条 clip 只装一个手势、一个持续漂移的运动、一个在动的自然元素；永远不装情节动作。"
+  risk: "模型会把 handheld 做成抖动、把 magic hour 做成橙色滤镜。缓解：把漂移写成一条路径（'像被一个走路的人抱着，缓慢向右并略微上升'），把光写成物理事实（'太阳刚在地平线上方、在她身后，直射进镜头；她的脸只被天空照亮'）。"
+negative_prompt_adds: ["locked tripod", "symmetrical composition", "orange colour-grade filter", "hard shadows", "studio lighting", "camera jitter", "slow motion", "drone shot"]
+```
+
+## ArtCraft 落点（本插件适配）
+
+### 剪辑（FilmCraft）
+- 单镜均长目标 **"2-5，每 60-90 秒给一颗 6-10 秒不切的呼吸镜头"s**（tightening / 紧凑对话（3–6s 档））→ `timeline.place` 铺轨后按分配修长：`timeline.trim {mode:"ripple"}`、`timeline.rateStretch` 微调
+- 转场偏好：**["hard cut", "dissolve on light", "cut away mid-gesture"]** → `sequence.applyVideoTransition {effect}` / `sequence.setTransition {duration, align}`
+- 覆盖方式："不做覆盖率：同一情境连拍 5-10 分钟不停机，在素材里找顺序"
+- 音画切点：对白/音乐切点参考 SoundCraft `event.beat_detective` 的节拍位置
+
+### 影调（LightCraft / FilmCraft Lumetri）
+- 光比目标 **"2:1 to 3:1"** → LightCraft `light.contrast` + `grading.shadows/highlights` 分离
+- 主色："grass green, wheat gold, sky blue-white, skin" → `mixer.{green,orange,blue}.*` 定点 + `grading.*` 方向
+- 点缀："low-sun amber, deep shadow blue"
+- 饱和/对比：mid / low
+- 光线签名："太阳在人物后方、高度 2-10 度，直射进广角镜头；脸只靠天光和地面反射抬起来，不打灯"
+- 落点命令：`develop.set control=<id> value=<v>` 逐项；定稿 `preset.create` 固化，整批 `preset.apply`；FilmCraft 侧 `lumetri.setLook` + `presets.save`
+
+### 声音（SoundCraft / FilmCraft）
+- 音乐："古典 / 合唱 / 极简弦乐成段铺陈，不按情绪点入场；最重的手势处突然抽掉 2-4 秒"
+- 环境："风穿过草、虫鸣、水、远处的鸟、衣料摩擦、土上的脚步"
+- 对白："重叠、轻声、常被风盖住，一半听不清；重要的话交给旁白"
+- 静默："极少真静音；用音乐抽掉来代替静音"
+- 落点命令：`essentialSound.setType` + `essentialSound.generateDucking`（避让对白）+ `essentialSound.autoMatch {target:-14}`；SoundCraft `mix.insert` 挂处理链
+
+### 机位与运动（EffectCraft）
+- 优先：["drifting handheld just behind a shoulder at walking pace", "low sweep up past a body toward sky or canopy", "slow arc while walking around a figure", "sudden tilt away from a face to a hand, grass, or water", "floating rise at gait rhythm"]
+- 避免：["locked tripod hold", "symmetrical frontal composition", "zoom", "whip pan", "drone hero shot"]
+- 运动预算：high
+- 落点命令：`camera.orbit/pan/dolly` + `view.3d.*` 机位；2D 素材用 `layer.*` + `keys.easyEase*` 缓动
+
+### 质检挂钩（artcraft_qc / 人工复核）
+- 逐镜抽帧复核 + `scopes.read` 示波器核对影调是否落在本透镜的光比与色相档位