30x-web-to-video 1.0.2 → 1.0.3

package/cli.mjs

@@ -26,8 +26,10 @@ const HELP = `
 
 Usage:
   npx 30x-web-to-video <brand-url> [--out <dir>] [--agent] [--no-harvest]
+  npx 30x-web-to-video --global              # install skill for ALL projects (~/.claude/skills)
 
 Options:
+  --global       Install the skill user-wide (~/.claude/skills) instead of per-project
   --out <dir>    Output project directory (default: ./<brand>-launch-video)
   --agent        After harvest, launch Claude Code on the build prompt
                  (requires the \`claude\` CLI; agent time/tokens are yours)
@@ -47,9 +49,9 @@ Optional: ELEVENLABS_API_KEY in the project .env for premium narration
 (falls back to Kokoro local TTS — zero keys needed).
 `;
 
-if (!url || flags.has("--help") || flags.has("-h")) {
+if (flags.has("--help") || flags.has("-h") || (!url && !flags.has("--global"))) {
   console.log(HELP.trim());
-  process.exit(url ? 0 : 1);
+  process.exit(url || flags.has("--global") ? 0 : 1);
 }
 
 const slug = (() => {
@@ -66,11 +68,18 @@ const outDir = resolve(outIdx > -1 && args[outIdx + 1] ? args[outIdx + 1] : `./$
 
 // ── 1) install the skill into the project-local .claude/skills ──────────
 const skillSrc = join(__dirname, "skill");
-const skillDst = join(process.cwd(), ".claude", "skills", "30x-web-to-video");
+const skillDst = flags.has("--global")
+  ? join(process.env.HOME || process.cwd(), ".claude", "skills", "30x-web-to-video")
+  : join(process.cwd(), ".claude", "skills", "30x-web-to-video");
 mkdirSync(dirname(skillDst), { recursive: true });
 cpSync(skillSrc, skillDst, { recursive: true });
 console.log(`✔ skill installed → ${skillDst}`);
 
+if (flags.has("--global") && !url) {
+  console.log("✔ skill installed user-wide. Open Claude Code anywhere and say: 给 <brand-url> 做个 launch video");
+  process.exit(0);
+}
+
 // ── 2) deterministic harvest + scaffold ─────────────────────────────────
 if (!flags.has("--no-harvest")) {
   const tsxCli = require.resolve("tsx/cli");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "30x-web-to-video",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "One URL in, an agency-grade brand launch video out. Harvests the site, scaffolds a Remotion project, and hands Claude Code a battle-tested taste codex (10-brand validated) to design the five acts.",
   "type": "module",
   "license": "MIT",

package/skill/rules/composition.md

@@ -105,6 +105,7 @@ Worked example（happy-model, 2026-07-04 — **这是推导方法的示范，不
 - 颜色、字体、光的性格全部来自该品牌的 brand-report（designTruth），不继承任何往期项目。
 - failover 一行是关键教训：卖点的领域要按**这个产品的真实语义**判断，别被词面带偏（"failover"听着像地理，实际是 provider 层）。
 - 相邻 beat 必须换世界（status page 世界 → 请求流世界 → 地理世界），两个 beat 共用一套视觉公式（如连续两张"地图+弧线"）已被用户点名毙掉。
+- **换构图不换世界观（Laper 事故 2026-07-05）**：换世界指的是构图系统与 artifact 换，不是色系与字系换。一部片只有一套底色谱系、一套字体声部、一套光的语言；某一幕突然跳成芥末金或深绿海报 = 世界观断裂，用户判词"不统一、不高级、没有品牌味"。多样性活在构图与 artifact 层，统一性锁死在 theme 层——beat 再怎么换，观众要能从任何一帧认出这是同一部片。
 
 **跨视频测试：** 拿本 skill 产的两个不同品牌的视频各抽一帧并排——如果互换品牌 logo 后毫无违和，自适应失败。
 

package/skill/rules/taste.md

@@ -35,6 +35,7 @@ These patterns instantly signal "AI-generated." Never use:
 - **Heartbeat motion — any rhythmic scale/brightness oscillation** (downbeat scale pulse on the whole frame, `1 + Math.sin(frame/N) * k` breathing on glows/blobs/backgrounds, BGM-synced throb). User verdict 2026-07-04: "心跳的那种动效 以后别用". The throb reads as anxious, not alive. Slow positional drift (`translateX/Y` sine float) is still fine — atmosphere moves, it never *pumps*. Beat-sync stays for CUT TIMING only (transitions/act boundaries on downbeats), never as a continuous visual pulse
 - **Decorative horizontal bars / rules / divider lines** — animated accent bars under headlines, metric progress-bar tracks, `borderBottom` hairlines between rows, vertical divider strokes between logo/stat groups. User verdict 2026-07-04: "我不喜欢那些横杠杠". Group with spacing and weight hierarchy instead; a real number (9/10) says more than a filled track
 - **Symbol/dingbat decoration rows** — star-rating glyphs, sparkles, diamonds, any repeated icon strip used as ornament. User verdict 2026-07-04: "symbols之类的 (不要)". Ratings become numeric text; grouping becomes whitespace
+- **Brand-native exception for the two bans above**: these ban *decorative defaults*, not brand truth. If the brand's own site verifiably uses hairlines or symbol marks as its design language (screenshot evidence, not vibes), reproducing that language is Law-4 real-asset fidelity, not a violation — cite the evidence in the act header comment. A star baked inside a product screenshot is always fine; a star you *drew* needs the brand to have drawn it first
 - **Text overlaid on a full-bleed motion asset** — when a real motion graphic (product film, app showcase video) plays full-screen, it IS the statement; no headline on top. User verdict 2026-07-04: "动效图上面就不要字了 因为那个是全屏". Either full-bleed textless, or contained in a panel with type outside — never both at once
 - Two adjacent beats sharing the same visual formula (e.g. "map + arcs" twice in a row) — each beat gets its own world; see composition diversity in composition.md
 

package/skill/rules/workflow.md

@@ -240,6 +240,8 @@ sed 's|//.*||' src/MainVideo.tsx | grep -qE 'staticFile\("brand/homepage|findAss
 
 ### Visual Classification — demo / cover (MANDATORY — BLOCKING)
 
+**Spoken-watermark check (BLOCKING, Laper incident 2026-07-05).** Free-library tracks routinely carry spoken tags ("royalty free music", channel names) baked into the audio. Before accepting any downloaded BGM: extract three 8-10s windows (head / peak / tail) with ffmpeg and inspect for speech — e.g. `ffmpeg -ss <t> -t 8 -i bgm.mp3 -af silencedetect=n=-30dB -f null -` plus an actual listen-equivalent (whisper-tiny transcription of the windows works: any transcribed words = reject the track). A track that fails goes back to the pool; never ship a watermark to the user's ears.
+
 **Dedup is necessary but not sufficient.** Even with unique images, pairing the wrong *kind* of image with the wrong *kind* of copy destroys trust. A Raycast og-image with "Your shortcut to everything" baked into the pixels must not have another scraped headline overlaid on it — that is the content-mismatch bug the user called out as *"素材非常的不 make sense"*.
 
 **Before composing any scene, classify every harvested visual into exactly one bucket:**