@biunow/agent-biuvibe 0.0.0-stage → 1.0.0

package/bin/server.js

@@ -0,0 +1,325 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  createAgentServer,
+  ensureDir,
+  writeJson,
+  reportProgress,
+  requestKickoff,
+  requestRunPermit,
+  seedSkillIntoProject,
+  watchForFilm,
+  locateJobFilm,
+  isIntermediateMp4,
+  readJson,
+} from '../lib/host.mjs';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const COLUMNS = readJson(path.join(root, 'data', 'columns.json'), []);
+
+function normalizeDuration(value) {
+  if (value == null || value === '' || value === 'auto') return null;
+  const n = Number(value);
+  if (!Number.isFinite(n)) return null;
+  return Math.min(180, Math.max(30, Math.round(n)));
+}
+
+function slugify(title) {
+  return String(title || 'film')
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fff]+/gi, '-')
+    .replace(/^-|-$/g, '')
+    .slice(0, 48) || 'film';
+}
+
+function isAudioFile(file) {
+  const name = String(file?.name || '');
+  const kind = String(file?.kind || '');
+  return kind.startsWith('audio') || /\.(mp3|wav|m4a|flac|ogg|aac)$/i.test(name);
+}
+
+function columnNeeds(column) {
+  return {
+    label: column?.label || (column?.voice ? '口播录音' : '有授权的配乐'),
+    accept: column?.accept || 'audio/*',
+    hint: column?.hint || (column?.voice ? '上传口播录音。' : '上传一首你有权使用的配乐。'),
+  };
+}
+
+async function saveUploads(workspace, jobId, files) {
+  const dir = ensureDir(path.join(workspace, 'films', jobId, 'assets'));
+  const saved = [];
+  for (const f of files || []) {
+    if (!f?.name || !f?.dataBase64) continue;
+    const safe = f.name.replace(/[^\w.\-()\u4e00-\u9fff]+/g, '_').slice(0, 120);
+    const dest = path.join(dir, safe);
+    fs.writeFileSync(dest, Buffer.from(f.dataBase64, 'base64'));
+    saved.push({ name: safe, path: dest, kind: f.kind || 'file' });
+  }
+  return saved;
+}
+
+createAgentServer({
+  root,
+  api: async ({ req, res, pathname, cfg, jobs, sendJson, readJsonBody }) => {
+    if (pathname === '/api/meta' && req.method === 'GET') {
+      const manifest = JSON.parse(fs.readFileSync(path.join(root, 'manifest.json'), 'utf8'));
+      const engineRoot = cfg.engineRoot || '';
+      sendJson(res, 200, {
+        agent: 'biuvibe',
+        name: manifest.name || 'BiuVibe',
+        description: manifest.description || '',
+        styles: COLUMNS,
+        canExport: cfg.canExport,
+        enginePresent: !!(engineRoot && fs.existsSync(path.join(engineRoot, 'AGENTS.md'))),
+        engineRoot: engineRoot || null,
+      });
+      return true;
+    }
+
+    if (pathname === '/api/create' && req.method === 'POST') {
+      if (!cfg.canExport) {
+        sendJson(res, 403, { error: '当前产品未授权导出/新建，请先激活 biuvibe 许可证' });
+        return true;
+      }
+      const body = await readJsonBody(req);
+      const column = COLUMNS.find((item) => item.slug === body.style);
+      if (!column) {
+        sendJson(res, 400, { error: '请选择一个栏目' });
+        return true;
+      }
+      const prompt = String(body.prompt || '').trim();
+      if (!prompt) {
+        sendJson(res, 400, { error: '请填写选题' });
+        return true;
+      }
+      const files = Array.isArray(body.files) ? body.files : [];
+      if (column.music && !files.some(isAudioFile)) {
+        sendJson(res, 400, { error: '请上传一首有授权的配乐' });
+        return true;
+      }
+      if (column.voice && !files.some(isAudioFile)) {
+        sendJson(res, 400, { error: '请上传口播录音' });
+        return true;
+      }
+      const title = String(body.title || prompt.slice(0, 40) || column.cn).slice(0, 120);
+      const storyboard = body.storyboard == null ? column.confirm !== false : !!body.storyboard;
+      const durationSec = normalizeDuration(body.durationSec);
+      const durationLine = durationSec == null
+        ? 'Duration: decide from the content, usually 45–90s, never over 180s.'
+        : `Duration target: ~${durationSec}s, never over 180s.`;
+      const durationKick = durationSec == null
+        ? '时长按内容决定，一般 45–90 秒，不得超过 180 秒。'
+        : `目标约 ${durationSec} 秒，不得超过 180 秒。`;
+      const filmSlug = `${slugify(title)}-${Date.now().toString(36)}`;
+
+      const job = jobs.create({
+        kind: 'create',
+        title,
+        style: column.slug,
+        styleName: column.cn,
+        prompt,
+        storyboard,
+        durationSec,
+        status: 'running',
+        progress: 5,
+        message: '写入选题',
+      });
+
+      const filmDir = ensureDir(path.join(cfg.workspace, 'films', job.id));
+      const filmRoots = [{ dir: filmDir, sinceMs: 0 }];
+      if (cfg.engineRoot) {
+        filmRoots.push({
+          dir: path.join(cfg.engineRoot, 'out'),
+          sinceMs: Date.parse(job.createdAt) || Date.now(),
+        });
+      }
+      jobs.update(job.id, { projectPath: filmDir, filmRoots });
+      const uploads = await saveUploads(cfg.workspace, job.id, files);
+      const brief = {
+        agent: 'biuvibe',
+        title,
+        style: column.slug,
+        styleName: column.cn,
+        skill: column.skill,
+        sample: column.sample,
+        card: column.card,
+        library: column.library,
+        screen: column.screen,
+        voice: !!column.voice,
+        music: !!column.music,
+        prompt,
+        storyboard,
+        durationMode: durationSec == null ? 'auto' : 'fixed',
+        durationSec,
+        filmSlug,
+        uploads: uploads.map((item) => ({ name: item.name, kind: item.kind })),
+        createdAt: new Date().toISOString(),
+      };
+      writeJson(path.join(filmDir, 'brief.json'), brief);
+      fs.writeFileSync(
+        path.join(filmDir, 'TREATMENT.md'),
+        [
+          `# ${title}`,
+          '',
+          `Column: **${column.cn}** (\`${column.slug}\`)`,
+          `Screen: ${column.screen}`,
+          durationLine,
+          `Preview first: ${storyboard ? 'yes' : 'no'}`,
+          `Voice: ${column.voice ? 'required recording' : 'none'}`,
+          `Music: ${column.music ? 'user upload, beat-locked' : 'optional'}`,
+          '',
+          '## Prompt',
+          '',
+          prompt,
+          '',
+          '## Look',
+          '',
+          column.line || '',
+          '',
+          '## Assets',
+          '',
+          ...(uploads.length ? uploads.map((item) => `- ${item.name}`) : ['- (none)']),
+          '',
+        ].join('\n'),
+      );
+      fs.writeFileSync(
+        path.join(filmDir, 'READY_FOR_AGENT.md'),
+        [
+          '# Ready for BiuVibe',
+          '',
+          cfg.engineRoot
+            ? `Library: ${cfg.engineRoot}`
+            : 'ENGINE_ROOT not set — point panel settings.engineRoots["biuvibe"] at weilanx-claude-videos.',
+          '',
+          column.skill
+            ? `Follow AGENTS.md and .claude/skills/${column.skill}/SKILL.md`
+            : `Follow AGENTS.md and ${column.card}`,
+          column.card ? `Style card: ${column.card}` : '',
+          `Copy the structure of ${column.sample}. Do not edit that sample.`,
+          `Component library: ${column.library}`,
+          `Project folder: ${filmDir}`,
+          storyboard ? 'Stop once with the beat sheet before the full film.' : 'Continue through to the delivered mp4.',
+          'The mastered mp4 must sit in the project folder beside brief.json.',
+          '',
+        ].join('\n'),
+      );
+
+      const kickoffPrompt = [
+        '按 biuvibe skill 做一条知识短片直到成片。',
+        `项目目录：${filmDir}`,
+        `阅读 brief.json 与 TREATMENT.md。栏目 ${column.cn}（${column.slug}）。${column.skill ? `技能 ${column.skill}。` : `配方 ${column.card}。`}样片 ${column.sample}。`,
+        storyboard ? '先给出卡点稿再出片。' : '不用中途停顿。',
+        durationKick,
+        column.music ? '配乐只用 assets 里上传的文件，测重拍后再切镜。' : '这是口播栏目，只用上传的录音。',
+        `选题：${prompt}`,
+        '成片必须复制到项目目录，和 brief.json 放在一起。引擎 out 目录里的文件不是交付。',
+        '完成后告诉我 MP4 路径。',
+      ].join('\n');
+      const kickoff = path.join(filmDir, 'START_IN_DSH.md');
+      fs.writeFileSync(
+        kickoff,
+        [
+          '# 在 DSH 中继续',
+          '',
+          '面板会自动在 DSH 对话中启用 **biuvibe** skill 并发送下列需求；若未自动开拍，请手动粘贴：',
+          '',
+          '```',
+          kickoffPrompt,
+          '```',
+          '',
+        ].join('\n'),
+      );
+      seedSkillIntoProject(filmDir, root, 'biuvibe');
+
+      const permitRes = await requestRunPermit(cfg, { projectPath: filmDir, jobId: job.id });
+      if (!permitRes?.ok) {
+        sendJson(res, 403, {
+          error: permitRes?.error || '无法签发 Run Permit（请确认产品已授权且面板回调可用）',
+          code: permitRes?.code || 'PERMIT_DENIED',
+        });
+        jobs.update(job.id, { status: 'failed', message: 'Run Permit 签发失败', error: permitRes?.error });
+        return true;
+      }
+
+      const panelTask = await reportProgress(cfg, {
+        title: `BiuVibe · ${column.cn} · ${title}`,
+        progress: 80,
+        message: '选题已就绪，正在提交开拍…',
+        artifact: filmDir,
+      });
+      if (panelTask?.taskId) jobs.update(job.id, { panelTaskId: panelTask.taskId });
+
+      const kick = await requestKickoff(cfg, {
+        taskId: panelTask?.taskId,
+        skill: 'biuvibe',
+        projectPath: filmDir,
+        kickoffPath: kickoff,
+        promptText: kickoffPrompt,
+        title: `BiuVibe · ${column.cn} · ${title}`,
+      });
+      const kicked = !!(kick?.ok || kick?.kickoff?.ok);
+      const sessionId = kick?.kickoff?.sessionId || kick?.sessionId || null;
+      const existingFilm = locateJobFilm(jobs.get(job.id));
+      if (existingFilm && !isIntermediateMp4(existingFilm.path)) {
+        const message = `成片已就绪 · ${path.basename(existingFilm.path)}`;
+        jobs.update(job.id, {
+          status: 'done',
+          progress: 100,
+          phase: 'film',
+          message,
+          artifact: existingFilm.path,
+          outputMp4: existingFilm.path,
+          projectPath: filmDir,
+          kickoff,
+          dshSessionId: sessionId,
+          kickoffOk: kicked,
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(job.id)?.panelTaskId,
+          progress: 100,
+          message,
+          done: true,
+          artifact: existingFilm.path,
+        });
+      } else {
+        const message = kicked
+          ? '已接通，正在创作，成片会显示在这里'
+          : '选题已就绪，自动开拍未成功';
+        jobs.update(job.id, {
+          status: 'running',
+          progress: kicked ? 55 : 40,
+          phase: kicked ? 'dsh' : 'brief',
+          message,
+          artifact: filmDir,
+          projectPath: filmDir,
+          kickoff,
+          dshSessionId: sessionId,
+          kickoffOk: kicked,
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(job.id)?.panelTaskId,
+          progress: kicked ? 55 : 40,
+          message,
+          artifact: filmDir,
+        });
+        watchForFilm(cfg, jobs, job.id, {
+          projectPath: filmDir,
+          title: `BiuVibe · ${column.cn} · ${title}`,
+        });
+      }
+
+      sendJson(res, 202, {
+        job: jobs.get(job.id),
+        brief,
+        kickoff,
+        kickoffOk: kicked,
+        dshSessionId: sessionId,
+      });
+      return true;
+    }
+
+    return false;
+  },
+});

package/data/columns.json

@@ -0,0 +1,230 @@
+[
+  {
+    "slug": "blackgold",
+    "cn": "黑金光影",
+    "en": "Black gold",
+    "cat": "卡点",
+    "line": "近黑底、暖色烟雾、金粒子标题。讲一个反直觉的道理，中英字幕，没有口播。",
+    "skill": "weilanx-creator-blackgold-video",
+    "sample": "ep36-boxed-pigs",
+    "card": "styles/我的风格/黑金光影风/README.md",
+    "library": "src/library/blackgold",
+    "voice": false,
+    "music": true,
+    "confirm": false,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*",
+    "hint": "上传一首你有权使用的配乐，片子会卡在它的重拍上。",
+    "thumb": "/thumbs/blackgold.jpg"
+  },
+  {
+    "slug": "gilded",
+    "cn": "暗金文献",
+    "en": "Gilded",
+    "cat": "卡点",
+    "line": "近黑底、金线图表、衬线字。锚词砸在配乐重拍上，没有口播。",
+    "skill": "weilanx-creator-gilded-video",
+    "sample": "ep23-wheat-chessboard",
+    "card": "styles/我的风格/暗金文献风/README.md",
+    "library": "src/library/gilded",
+    "voice": false,
+    "music": true,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*",
+    "hint": "上传一首你有权使用的配乐，高潮会落在重拍上。",
+    "thumb": "/thumbs/gilded.jpg"
+  },
+  {
+    "slug": "lamplight",
+    "cn": "灯火史话",
+    "en": "Lamplight",
+    "cat": "卡点",
+    "line": "暖黑夜色和火光。讲一条古代制度或冷知识，没有口播。",
+    "skill": "weilanx-creator-lamplight-video",
+    "sample": "ep28-express-relay",
+    "card": "styles/我的风格/灯火史话风/README.md",
+    "library": "src/library/lamplight",
+    "voice": false,
+    "music": true,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*",
+    "hint": "上传一首你有权使用的配乐。",
+    "thumb": "/thumbs/lamplight.jpg"
+  },
+  {
+    "slug": "fps",
+    "cn": "战术屏",
+    "en": "Tactical",
+    "cat": "卡点",
+    "line": "游戏 HUD 和发光图表。讲一个挫败瞬间背后的道理，不画真实游戏的角色和枪械。",
+    "skill": "weilanx-creator-fps-video",
+    "sample": "ep25-behind-cover",
+    "card": "styles/我的风格/战术屏科普风/README.md",
+    "library": "src/library/tactical",
+    "voice": false,
+    "music": true,
+    "confirm": false,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*",
+    "hint": "上传一首你有权使用的配乐。",
+    "thumb": "/thumbs/fps.jpg"
+  },
+  {
+    "slug": "halftone",
+    "cn": "网点档案",
+    "en": "Halftone",
+    "cat": "卡点",
+    "line": "旧纸或藏青夜色，粗宋大字，印章砸下来。没有口播。",
+    "skill": "",
+    "sample": "library-halftone",
+    "card": "styles/我的风格/网点档案风/README.md",
+    "library": "src/library/halftone",
+    "voice": false,
+    "music": true,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*",
+    "hint": "上传一首你有权使用的配乐。",
+    "thumb": "/thumbs/halftone.jpg"
+  },
+  {
+    "slug": "desk",
+    "cn": "暖纸工作台",
+    "en": "Warm desk",
+    "cat": "口播",
+    "line": "暖米色纸面、步骤条和窗口卡片。讲一件事分几步做成。",
+    "skill": "weilanx-creator-desk-video",
+    "sample": "ep26-opus-video",
+    "card": "styles/我的风格/暖纸工作台风/README.md",
+    "library": "src/library/warm-desk",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "口播录音",
+    "accept": "audio/*",
+    "hint": "上传口播录音。配乐可以不传。",
+    "thumb": "/thumbs/desk.jpg"
+  },
+  {
+    "slug": "editor",
+    "cn": "剪辑台",
+    "en": "Editor room",
+    "cat": "口播",
+    "line": "软件界面一镜到底：群聊、画布和时间轴。适合讲一个产品怎么做成。",
+    "skill": "",
+    "sample": "library-editor-room",
+    "card": "styles/我的风格/协作剪辑台风/README.md",
+    "library": "src/library/editor-room",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "口播录音",
+    "accept": "audio/*,image/*,video/*",
+    "hint": "上传口播录音。产品截图可以一起传。",
+    "thumb": "/thumbs/editor.jpg"
+  },
+  {
+    "slug": "pixel-sticker",
+    "cn": "像素贴纸",
+    "en": "Pixel sticker",
+    "cat": "口播",
+    "line": "像素小人和贴纸大字。竖屏，一个词讲清楚一件事。",
+    "skill": "weilanx-creator-pixel-video",
+    "sample": "ep06-context",
+    "card": "styles/我的风格/像素贴纸风/README.md",
+    "library": "src/library",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "3:4",
+    "label": "口播录音",
+    "accept": "audio/*",
+    "hint": "上传口播录音。",
+    "thumb": "/thumbs/pixel-sticker.jpg"
+  },
+  {
+    "slug": "pixel-hand",
+    "cn": "像素手绘",
+    "en": "Pixel hand-drawn",
+    "cat": "口播",
+    "line": "像素主持人加细线手绘卡片。横屏，演播室和旁切交替。",
+    "skill": "",
+    "sample": "ep03-cc",
+    "card": "styles/我的风格/像素手绘风/README.md",
+    "library": "src/library",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "口播录音",
+    "accept": "audio/*",
+    "hint": "上传口播录音。",
+    "thumb": "/thumbs/pixel-hand.jpg"
+  },
+  {
+    "slug": "vector",
+    "cn": "矢量手绘",
+    "en": "Vector",
+    "cat": "口播",
+    "line": "带表情的矢量小人。竖屏口播。",
+    "skill": "",
+    "sample": "ep00-demo",
+    "card": "styles/我的风格/矢量手绘风/README.md",
+    "library": "src/library",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "9:16",
+    "label": "口播录音",
+    "accept": "audio/*",
+    "hint": "上传口播录音。",
+    "thumb": "/thumbs/vector.jpg"
+  },
+  {
+    "slug": "vox-timeline",
+    "cn": "时间轴长卷",
+    "en": "Vox timeline",
+    "cat": "拼贴",
+    "line": "旧纸桌面上的时间尺。适合讲一段历史怎么走到今天。",
+    "skill": "",
+    "sample": "ep18-ai-history",
+    "card": "styles/解说语法/02_新闻与数据/y2_vox_Vox/语法卡.md",
+    "library": "src/library/vox",
+    "voice": false,
+    "music": true,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "有授权的配乐",
+    "accept": "audio/*,image/*",
+    "hint": "上传配乐。年份图片可以一起传。",
+    "thumb": "/thumbs/vox-timeline.jpg"
+  },
+  {
+    "slug": "vox-cut",
+    "cn": "硬切拼贴",
+    "en": "Vox cut",
+    "cat": "拼贴",
+    "line": "黑卡大字和钉在桌面上的真实素材来回切。需要口播，也需要你有权使用的图片或视频。",
+    "skill": "weilanx-creator-vox-video",
+    "sample": "ep21-nobel-physics",
+    "card": "styles/解说语法/02_新闻与数据/y2_vox_Vox/语法卡.md",
+    "library": "src/library/vox",
+    "voice": true,
+    "music": false,
+    "confirm": true,
+    "screen": "16:9",
+    "label": "口播和素材",
+    "accept": "audio/*,image/*,video/*",
+    "hint": "上传口播录音，再带上你有权使用的图片或视频。",
+    "thumb": "/thumbs/vox-cut.jpg"
+  }
+]

package/engine/.claude/skills/weilanx-creator-blackgold-video/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: weilanx-creator-blackgold-video
+description: 「黑金光影风」知识短片一键成片工作流：用户只给一个选题（或者只说「做一期」），就一条龙做完：查一手资料 → 定锚词、写选题与分镜脚本 → 卡 we-never 的拍子写时间表 → 合成音效 → 为选题设计专属画面 → 测试 → 自动抽帧和测响度、自己修 → 直接导出成片 → 代码渲染的 3:4 封面 + 发布文案 + 双语字幕稿，全程不停下来问用户确认。成片是横屏 16:9、约 2 分 18 秒、无口播：近黑底暖色烟雾、一切发光，金粒子聚成标题，霓虹收益矩阵 / 天平 / 对账卡把推理画出来，发光角色在聚光灯下演出模型，底部中英双语字幕，两个爆点踩配乐重拍，片尾停在评论区问题。用户说「黑金风做一期」「黑金光影风」「这期做 XX 博弈 / 悖论 / 效应」「用博弈论讲讲 XX」「做个智猪博弈那样的视频」「一条龙做一期知识视频」时都用这个 skill；只要是用一个模型解释一个反直觉现象（博弈论、经济学、决策、认知偏差、概率、AI 原理）的无口播短片，就用它。
+---
+
+# 一个反直觉模型 → 一期黑金光影风成片（一键到底）
+
+> **目录约定**：`materials/` 和 `out/` 按风格分类、风格内从 00 编号。本 skill 的风格目录是 `09-黑金光影风`。下文 `<期>` = 作品 ID（如 `ep36-boxed-pigs`），`<素材目录>` / `<成片目录>` 用 `bash scripts/ep-dir.sh <期> materials|out` 查。
+
+**用户调用这个 skill = 授权你从头做到交付**：成片 mp4、3:4 封面、发布文案、双语字幕稿（md + srt），全部放进 `<成片目录>/`。中途**不问用户确认、不停在 Studio 等预览**，每做完一步用一句话同步进度；要拿主意的地方按本文默认值自己定，最后在交付报告里说明替他定了什么。**不提交 git**，除非用户另外要求（要提交走 `git-commit-cc`）。
+
+只有两种情况才停下来问：① 选题查不到任何一手资料、也没有可替换的相近角度；② 工具连续失败两次（渲染崩溃、导出报错）。
+
+**样片：`ep36-boxed-pigs`（智猪博弈：躺平的小猪吃得更多）。新一期先照它的代码改，不要从空白写**：
+`src/episodes/ep36-boxed-pigs/`（`timeline.ts` `Ep36Pigs.tsx` `scenes.tsx` `CoverTall.tsx`）、`tests/episodes/ep36-boxed-pigs.test.ts`、`audio/episodes/ep36-boxed-pigs.mjs`。
+
+动手前读：工程根目录 `CLAUDE.md`、`src/library/README.md`「黑金光影风 blackgold/」一节、`styles/我的风格/黑金光影风/README.md`（配方卡，尤其「出彩的手法」）、本 skill 的四份 `references/`。所有 npm / npx / node 命令前先 `export NODE_OPTIONS=--max-old-space-size=4096`。
+
+## 依赖（开源版说明）
+
+这个一锅出工作流不依赖作者的私人工具：画面、封面、字幕稿、发布文案、QA 脚本都在仓库里。唯一要自己准备的是配乐：
+
+- **配乐**：示例统一用音乐库的 we-never，这是作者已获授权的自用曲目，mp3 不随仓库分发。换成你自己有授权的曲子放进 `public/music/`，在 `audio/music.mjs` 的 `TRACKS` 登记，再用 `weilanx-creator-gilded-video/scripts/beats.py` 重测起音、小节长和重拍，改 `timeline.ts` 的网格，画面会跟着对齐。
+
+## 规格（默认值）
+
+| 项 | 默认 |
+|---|---|
+| 画面 | 横屏 1920×1080、30fps，黑金光影风（`src/library/blackgold/`），独立组件，不走 `Show` |
+| 时长 | 256 拍 + 1 秒 ≈ 2 分 17.5 秒 |
+| 口播 | 无。底部双语字幕就是旁白：中文宋体 Black 一行（≤ 18 字，`【】`青 = 术语、`〖〗`红 = 亏 / 零 / 陷阱、`〔〕`金 = 数字 / 锚词），下面一行英文斜体意译 |
+| 配乐 | **统一用音乐库 we-never**（已授权），从第 0 秒放，−16 LUFS；整片约 −15.5 LUFS、真峰值 ≤ −1 dBFS |
+| 爆点 | 17.45 秒（第 32 拍）金粒子聚成标题；102.52 秒（第 192 拍）锚词砸出 + 术语小字 |
+| 结尾 | 重新定义锚词 → 评论区问题放到片尾（大号居中）；**不做下期预告** |
+| 交付 | `<成片目录>/<期>.mp4`、`封面-3x4.png`、`发布文案.md`、`字幕稿.md`、`字幕.srt`；素材目录里另有 `文案与卡点.md`（选题与分镜脚本） |
+
+## 0. 选题和期号
+
+- **用户给了选题**：直接用。标题写成「现象 + 反常识」的一句话（≤ 12 字，可带冒号副题），副题用观众的处境说（「躺平的小猪吃得更多」）。
+- **用户没给**：从 `materials/09-黑金光影风/选题.md` 挑，⭐ 优先；做完把那一行移进「做过的」，写上目录编号和作品 ID。
+- **期号**：别的会话也在加期数，**写第一个文件前**再 `ls src/episodes | tail -3`，取最大号 + 1，作品 ID `epNN-英文短名`；撞号就顺延，不动别人的目录。
+- **建目录**：`bash scripts/ep-dir.sh <期> materials --new 09-黑金光影风 <中文短题>`（自动编号，materials 和 out 一起建）。
+
+## 1. 查一手资料（不能跳过）
+
+详见 `references/选题与脚本.md`「事实」一节。论文读到摘要、书读到原文段落（网络副本也行），搜索摘要不算数。每个上画面的数字写进 `timeline.ts` 常量并在测试里断言；**能由规则算出来的数（收益矩阵、概率、均衡）写成函数在测试里复算**（ep36 的 `payoff()` 和纳什均衡检验）。
+
+**标题和事实打架时，片里说准确的话**（ep36：课本数字里小猪和大猪净得一样，片里说「躺着拿 4，自己去按只拿 1」，不说「比大猪多」），并在发布文案内部核对里写明口径。
+
+## 2. 选题与分镜脚本（写进 `<素材目录>/文案与卡点.md`）
+
+结构、句子规则、锚词怎么找，照 `references/选题与脚本.md`：锚词（2～4 字，处境不是术语）、钩子 5 条、章节骨架（固定拍号）、逐句双语字幕、卡点表、事实清单、有意不说的、**本期专属的 3～5 个出彩设计**。ep36 那份就是模板。
+
+## 3. 写 timeline.ts（全片唯一时间表）
+
+照 `src/episodes/ep36-boxed-pigs/timeline.ts` 改：网格（`beatSec` / `fbt` / `fb`）、`HIT` / `HIT2` / `DARK_FROM`（`fr(16.7)`）/ `DARK_FROM2`（`fr(101.75)`）/ `FREEZE = 3` / `DURATION`、实测重音数组、`ANCHOR` / `TERM` / `TITLE` / `TITLE_EN` / `TITLE_SUB`、`CUES: [拍号, 中文 | null, 英文][]`（null 行同一行写 `// 说明`）、`HALF_BEATS`、`SHOTS`（首尾相接、每行 `// 说明`）、事实常量和计算函数、舞台布局常量、`SFX`。
+
+硬规则：**timeline.ts 不能 import 别的 .ts / .tsx**（`qa.mjs` 和 `subtitles.mjs` 用 Node 直接加载它）；画面里每个元素的出场帧必须落在所在镜头的时间范围内。卡点和音效表见 `references/卡点与音效.md`。
+
+## 4. 音频
+
+```sh
+sed 's/ep36-boxed-pigs/<期>/g' audio/episodes/ep36-boxed-pigs.mjs > audio/episodes/<期>.mjs   # 再改注释和本期专属音效
+node audio/episodes/<期>.mjs
+```
+
+本期的动作音（ep36 的拉杆咔哒、食粒落槽、小碎步）按选题换成自己的（ffmpeg `aevalsrc` 合成，峰值压到约 −6 dBFS），通用的 chime / impact / room / riser 保留。
+
+## 5. 画面
+
+详见 `references/画面与镜头.md`。先复用 `src/library/blackgold/`（`stage` 舞台和字幕、`props` 道具、`charts` 模型图、`pen` 动物实验场），再**为这个选题设计 3～5 个只属于它的出彩元素**（用户 2026-10-13 明确要求：不要局限于素材包，要发挥想象力；好用的全部沉淀进素材库）。本期新写的组件下次还能用的，挪进 `src/library/blackgold/` 并补 README 和配方卡。
+
+硬规则：动画是帧号的纯函数，随机只用 `rand(seed)`；素材库不 import `src/episodes/`；不画真实人物肖像和第三方 logo；示意画面标「示意」。
+
+## 6. 注册和测试
+
+- `src/Root.tsx` 在 `<Folder name="09-黑金光影风">` 里、最近一期后面注册 `<Composition id="<期>" …>` 和封面 `<Still id="<期>-cover-tall" … width={1080} height={1440} />`（import 变量名带期号）。
+- 测试照 `tests/episodes/ep36-boxed-pigs.test.ts` 改：卡点 ±2 帧、片长、字幕规则（≤ 18 字、都有英文、话说一半以「——」结尾、锚词开头结尾都出现、最后一句是问题）、镜头首尾相接、事实和计算、音效在片长内且文件存在。
+- `npm run typecheck && npm test`，全绿才往下走。
+
+## 7. 自动自查（自己修，最多三轮）
+
+```sh
+node .claude/skills/weilanx-creator-blackgold-video/scripts/qa.mjs <期>
+```
+
+每个镜头切走前一帧 + 两个爆点 −16 / −3 / +2 帧拼成网格，测整片响度和被配乐盖住的音效，产物在 `/tmp/<期>/qa/`。Read 逐张看 `sheet-*.jpg` 和 `hits.jpg`，按 `references/画面与镜头.md` 末尾清单查；改完只重渲改过的镜头：`qa.mjs <期> --frames-only=镜头A,镜头B`，改了音量再跑 `--audio`。另外抽几帧镜头**中段**看动画过程（天平在晃、角色在跑、对账卡在跳）。三轮后的小瑕疵写进交付报告。
+
+## 8. 导出 → 9. 封面、文案、字幕（导出在后台跑的同时做）
+
+```sh
+npm run export -- <期>     # 后台跑，约 5 分钟 → <成片目录>/<期>.mp4
+```
+
+- 导完 `ffprobe` 看分辨率和时长、`ebur128=peak=true` 看响度，从成片抽 4 帧（17.6、中段、102.7、结尾）拼起来 Read 一眼。
+- **封面**：代码渲染（`CoverTall.tsx`，1080×1440），不用 AI 生图；`npx remotion still src/index.ts <期>-cover-tall <素材目录>/封面-3x4.png`，Read 检查。
+- **字幕**：`node .claude/skills/weilanx-creator-blackgold-video/scripts/subtitles.mjs <期> <素材目录>` → `字幕稿.md` + `字幕.srt`。
+- **发布文案**：`<素材目录>/发布文案.md`。
+- 详见 `references/封面与发布.md`。封面、文案、字幕稿、srt 都复制到 `<成片目录>/`。
+
+## 10. 收尾登记
+
+- `styles/我的风格/黑金光影风/README.md` 期数表补一行（用到的组件 + 本期新手法补进「出彩的手法」）；`styles/README.md` 黑金那一行期数补上。
+- `materials/09-黑金光影风/README.md`、`out/09-黑金光影风/README.md` 的目录表补一行；`选题.md` 把这题移进「做过的」。
+- `public/music/README.md` we-never 那一行补上期号。
+- 新组件进 `src/library/blackgold/` 并补 `src/library/README.md`。
+- 最后再跑一次 `npm run typecheck && npm test`。
+
+## 11. 交付报告（回复用户）
+
+1. `<成片目录>/` 里的五样东西；成片分辨率、时长、响度、峰值；Studio 地址 `http://localhost:3000/<期>`。
+2. 锚词和它出现的位置；分镜表（时间 | 配乐 | 画面 | 讲什么）。
+3. 事实来源（全名 + 年份），哪些读到原文、哪些只读到摘要、哪些是自己算的、哪些是示意；标题和事实之间的口径。
+4. 本期新设计的出彩元素，以及沉淀进素材库的组件。
+5. 替他定了什么（标题改写、期号顺延、锚词）；自查修了什么、剩什么小瑕疵。
+6. 听感要他自己确认（你听不到声音，只报数字）。