@gthanks/moviespec 0.1.0 → 0.1.2

package/README.md

@@ -38,6 +38,8 @@ CLI 将按 `schema/moviespec.schema.yaml` 的默认路径读取与写入上述
 
 - `moviespec init`
 - `moviespec list types`
+- `moviespec list-aesthetics` (查看有哪些内置的经典电影美学)
+- `moviespec apply <name>` (将内置美学套用到当前项目的视觉风格中)
 - `moviespec new <type> <name>`
 - `moviespec compile-prompts --shots <file>`
 - `moviespec validate` / `moviespec check`

package/bin/moviespec.js

@@ -138,7 +138,7 @@ async function cmdInit(projectRoot) {
     if (selectedAgents.length > 0) {
       const here = path.dirname(fileURLToPath(import.meta.url));
       const templatesDir = path.resolve(here, '..', 'templates', 'agents');
-      
+
       const agentFiles = {
         cursor: '.cursorrules',
         windsurf: '.windsurfrules',
@@ -148,7 +148,7 @@ async function cmdInit(projectRoot) {
       for (const agent of selectedAgents) {
         const sourceFile = path.join(templatesDir, `${agent}.md`);
         const targetFile = path.join(root, agentFiles[agent]);
-        
+
         if (await pathExists(sourceFile)) {
           const content = await fs.readFile(sourceFile, 'utf8');
           await fs.writeFile(targetFile, content, 'utf8');
@@ -175,6 +175,81 @@ async function cmdListTypes() {
   }
 }
 
+async function cmdListAesthetics() {
+  const schema = await loadMovieSpecSchema();
+  const aestheticsDirRel = schema.project?.aestheticsDir ?? 'templates/aesthetics';
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const aestheticsDirAbs = path.resolve(here, '..', aestheticsDirRel);
+
+  if (!(await pathExists(aestheticsDirAbs))) {
+    console.log(chalk.yellow('No aesthetics library found.'));
+    return;
+  }
+
+  const files = await fg(['**/*.md', '**/*.yaml'], { cwd: aestheticsDirAbs, onlyFiles: true });
+  if (files.length === 0) {
+    console.log(chalk.yellow('Aesthetics library is empty.'));
+    return;
+  }
+
+  console.log(chalk.cyan('Available Cinematic Aesthetics:'));
+
+  const categories = {};
+  for (const f of files) {
+    const parts = f.split('/');
+    const category = parts.length > 1 ? parts[0] : 'uncategorized';
+    const name = path.parse(f).name;
+
+    if (!categories[category]) categories[category] = [];
+    categories[category].push(name);
+  }
+
+  for (const [category, names] of Object.entries(categories)) {
+    console.log(`\n  [${chalk.yellow(category)}]`);
+    for (const name of names) {
+      console.log(`    - ${chalk.green(name)}`);
+    }
+  }
+}
+
+async function cmdApplyAesthetic(aestheticName, { projectRoot }) {
+  const schema = await loadMovieSpecSchema();
+  const root = resolveProjectRoot(projectRoot);
+
+  const aestheticsDirRel = schema.project?.aestheticsDir ?? 'templates/aesthetics';
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const aestheticsDirAbs = path.resolve(here, '..', aestheticsDirRel);
+
+  // Search recursively for the aesthetic name
+  const files = await fg([`**/${aestheticName}.md`, `**/${aestheticName}.yaml`], { cwd: aestheticsDirAbs, onlyFiles: true });
+
+  if (files.length === 0) {
+    throw new Error(`Aesthetic template '${aestheticName}' not found in library.`);
+  }
+
+  if (files.length > 1) {
+    console.log(chalk.yellow(`Warning: Multiple aesthetic templates found named '${aestheticName}'. Using the first one: ${files[0]}`));
+  }
+
+  const sourceTemplate = path.join(aestheticsDirAbs, files[0]);
+
+  const targetRel = defaultTypePath(schema, 'visual_style');
+  const targetDir = path.join(root, targetRel);
+  await ensureDir(targetDir);
+
+  const ext = path.extname(sourceTemplate);
+  const targetPath = path.join(targetDir, `${aestheticName}${ext}`);
+
+  if (await pathExists(targetPath)) {
+    throw new Error(`File already exists: ${targetPath}`);
+  }
+
+  const content = await fs.readFile(sourceTemplate, 'utf8');
+  await fs.writeFile(targetPath, content, 'utf8');
+
+  console.log(chalk.green(`Applied cinematic aesthetic '${aestheticName}' to: ${toPosix(path.relative(root, targetPath))}`));
+}
+
 async function cmdNew(typeId, name, { projectRoot }) {
   const schema = await loadMovieSpecSchema();
   const root = resolveProjectRoot(projectRoot);
@@ -468,6 +543,22 @@ program
     await cmdListTypes();
   });
 
+program
+  .command('list-aesthetics')
+  .description('List available cinematic aesthetics templates')
+  .action(async () => {
+    await cmdListAesthetics();
+  });
+
+program
+  .command('apply')
+  .description('Apply a cinematic aesthetic template to your project')
+  .argument('<aesthetic_name>', 'Name of the aesthetic template')
+  .option('-C, --project-root <path>', 'Project root (default: cwd)')
+  .action(async (name, opts) => {
+    await cmdApplyAesthetic(name, { projectRoot: opts.projectRoot });
+  });
+
 program
   .command('new')
   .argument('<type>', 'Type id')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gthanks/moviespec",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Specification-driven consistency framework for AI image and video generation",
   "author": "gthanks",
   "license": "MIT",

package/schema/moviespec.schema.yaml

@@ -7,6 +7,7 @@ project:
   outputDir: output
   manifestsDir: manifests
   shotsDir: shots
+  aestheticsDir: templates/aesthetics
 types:
   world_bible:
     description: 世界观

package/templates/aesthetics/directors//346/200/252/350/257/236/345/257/271/347/247/260/351/243/216.md

@@ -0,0 +1,26 @@
+---
+type: visual_style
+name: "怪诞对称风"
+style: "怪诞对称风 (Quirky Symmetrical)"
+---
+
+# 视觉风格：韦斯·安德森美学 (Wes Anderson Aesthetic)
+
+## 色彩方案 (Color Grading)
+- **Tint (色调)**: 马卡龙粉色，芥末黄，婴儿蓝。
+- **Shadows (阴影)**: 提亮阴影，极低的对比度。
+- **Saturation (饱和度)**: 均匀饱和的马卡龙粉彩质感。
+
+## 灯光设计 (Lighting)
+- **Style (风格)**: 平光源打光 (Flat lighting)，几乎没有方向性的阴影。
+- **Atmosphere (氛围)**: 怪诞，戏剧舞台感，极其静止。
+- **Modifiers (修饰)**: 柔和、漫反射的顶光源。
+
+## 镜头语言与材质 (Cinematography & Texture)
+- **Lens (镜头)**: 超广角镜头（如18mm或24mm），极小的景深模糊（要求背景和前景全部清晰在焦内）。
+- **Composition (构图)**: 严格的屏幕中心对称构图，扁平化的舞台场面调度 (Planimetric staging)。
+- **Texture (材质)**: 复古胶片摄影质感，所有道具必须看起来是精心摆放过的。
+
+## AI 专属 Prompt 增强
+- **Positive Suffix (正面词缀)**: `Wes Anderson style, perfect symmetry, pastel colors, flat lighting, whimsical, meticulously arranged, wide angle, center focus, cinematic still, highly detailed`
+- **Negative Prefix (负面词缀)**: `asymmetrical, high contrast, dark shadows, moody, messy, chaotic, shallow depth of field, dutch angle`

package/templates/aesthetics/directors//350/203/241/351/207/221/351/223/250/351/243/216.md

@@ -0,0 +1,26 @@
+---
+type: visual_style
+name: "胡金铨风"
+style: "King Hu Zen Wuxia"
+---
+
+# 视觉风格：胡金铨导演美学 (King Hu Aesthetic)
+
+## 色彩方案 (Color Grading)
+- **Tint (色调)**: 褪色的自然复古色调，冷峻的石青与暗红。
+- **Shadows (阴影)**: 强烈的明暗对比，人物常常从极暗的背景中显现。
+- **Saturation (饱和度)**: 整体偏低，局部色彩（如鲜血或特定服饰）克制性点缀。
+
+## 灯光设计 (Lighting)
+- **Style (风格)**: 戏剧化的自然高光，轮廓边缘光。
+- **Atmosphere (氛围)**: 肃杀，禅宗意境，充满神秘与张力。
+- **Modifiers (修饰)**: 浓重的迷雾 (Thick mist)，斜射的日光，大量利用自然环境（如芦苇荡、竹林）带来的斑驳光影。
+
+## 镜头语言与材质 (Cinematography & Texture)
+- **Lens (镜头)**: 中长焦镜头压缩空间，制造群雄压境的局促感。
+- **Composition (构图)**: 极具京剧舞台感的调度，人物在画面边缘突然跃入。强调“气”与“动势”。
+- **Editing Hint (剪辑提示)**: （此风格特有）如果生成序列，多使用极短的碎剪 (Rapid montage) 表现战斗。
+
+## AI 专属 Prompt 增强
+- **Positive Suffix (正面词缀)**: `King Hu film style, A Touch of Zen, vintage 1970s Hong Kong cinema aesthetics, thick mist, bamboo forest combat, dramatic natural lighting, somber mood, Beijing opera staging, cinematic still, masterpiece`
+- **Negative Prefix (负面词缀)**: `wuxia fantasy magic, glowing auras, saturated colors, modern digital look, 3D render, cartoon, bright sunlight`

package/templates/aesthetics/genres//351/273/221/347/231/275/344/276/246/346/216/242/351/243/216.md

@@ -0,0 +1,26 @@
+---
+type: visual_style
+name: "黑白侦探风"
+style: "黑白侦探风 (Black & White Detective)"
+---
+
+# 视觉风格：黑色电影美学 (Film Noir Aesthetic)
+
+## 色彩方案 (Color Grading)
+- **Tint (色调)**: 纯正的黑白单色 (Monochrome)。
+- **Shadows (阴影)**: 极致压暗的死黑，极高的画面对比度。
+- **Saturation (饱和度)**: 0% (完全剥离色彩)。
+
+## 灯光设计 (Lighting)
+- **Style (风格)**: 低调打光 (Low-key lighting)，强烈的明暗对照法 (Chiaroscuro)。
+- **Atmosphere (氛围)**: 情绪化，充满悬疑，充满危险感。
+- **Modifiers (修饰)**: 极其生硬刺眼的阴影，百叶窗的条纹阴影切过人物面部，剪影打光法。
+
+## 镜头语言与材质 (Cinematography & Texture)
+- **Lens (镜头)**: 35mm 镜头。采用大景深 (Deep focus)。经常使用荷兰角 (倾斜构图) 来表现人物内心的不安感。
+- **Atmosphere (环境)**: 雨水打湿反光的街道，缭绕的香烟烟雾，浓雾。
+- **Texture (材质)**: 极重的1940年代赛璐珞胶卷颗粒感，高边缘对比度。
+
+## AI 专属 Prompt 增强
+- **Positive Suffix (正面词缀)**: `film noir style, 1940s black and white cinema, extreme high contrast, harsh shadows, chiaroscuro lighting, moody, mystery, rain-slicked streets, cigarette smoke, heavy film grain, cinematic masterpiece`
+- **Negative Prefix (负面词缀)**: `color, vibrant, cheerful, flat lighting, sunny, modern, daytime, low contrast, washed out`

package/templates/aesthetics/movies//351/273/221/345/256/242/345/270/235/345/233/275/351/243/216.md

@@ -0,0 +1,26 @@
+---
+type: visual_style
+name: "黑客帝国风"
+style: "赛博朋克动作风 (Cyberpunk Action)"
+---
+
+# 视觉风格：黑客帝国美学 (The Matrix Aesthetic)
+
+## 色彩方案 (Color Grading)
+- **Tint (色调)**: `#00FF41` (经典的矩阵绿)。
+- **Shadows (阴影)**: 极深的黑色，极高对比度。
+- **Saturation (饱和度)**: 肤色饱和度极低，绿色/青色的中间调饱和度极高。
+
+## 灯光设计 (Lighting)
+- **Style (风格)**: 类似办公室荧光灯的顶光 (Top-down fluorescent)，明暗对照 (Chiaroscuro)。
+- **Atmosphere (氛围)**: 冰冷，不自然，机械感。
+- **Modifiers (修饰)**: 画面带有雾霾感 (Haze)，使用边缘光 (Rim lighting) 将人物从黑暗背景中分离出来。
+
+## 镜头语言与材质 (Cinematography & Texture)
+- **Lens (镜头)**: 35mm 到 50mm，带有些微的广角畸变以体现不真实感。
+- **Shutter Speed (快门)**: 极快的快门速度，确保动作戏极其锐利清晰。
+- **Texture (材质)**: 90年代胶片颗粒感，锐利的边缘，光滑反光的乳胶和皮革材质。
+
+## AI 专属 Prompt 增强
+- **Positive Suffix (正面词缀)**: `cinematic style, Matrix green color grading, cyberpunk atmosphere, high contrast, 90s action movie texture, masterpiece, 8k resolution, photorealistic`
+- **Negative Prefix (负面词缀)**: `warm colors, sunny, vibrant, cheerful, soft lighting, pastel, cartoon, low quality`