dsh-motion 0.4.0 → 0.4.2

package/scripts/plan-questions.mjs

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+/**
+ * 需求卡点：从 brief 推断该问什么、该给哪些选项。
+ *
+ *   node scripts/plan-questions.mjs "做一条竖屏抖音短片，讲导数，要旁白" --json
+ *   node scripts/plan-questions.mjs "用 3b1b 讲矩阵"
+ *
+ * 原则：能推断的不问；选项按上下文生成，不写死。
+ * 输出可直接交给 ask_user_question；最多 4 题。
+ */
+import { loadRegistry, routeStyle } from './route-style.mjs'
+
+const MAX_QUESTIONS = 4
+
+const ASPECTS = {
+  '16:9': {
+    label: '16:9 横屏 · 1920×1080',
+    description: '课件、网页、B站/YouTube 最常用；现有风格验证最充分。',
+  },
+  '9:16': {
+    label: '9:16 竖屏 · 1080×1920',
+    description: '抖音 / Reels / Shorts；现有风格还没验过竖版，先出帧确认。',
+  },
+  '1:1': {
+    label: '1:1 方屏 · 1080×1080',
+    description: '信息流 / 方图；同样需要重新验帧。',
+  },
+}
+
+const ASPECT_HINTS = [
+  { key: '9:16', words: ['竖屏', '抖音', '短视频', '手机', 'reels', 'shorts', 'tiktok', '快手', '视频号'] },
+  { key: '1:1', words: ['方图', '正方形', '1:1', 'instagram', 'ig', '朋友圈'] },
+  { key: '16:9', words: ['横屏', 'b站', 'bilibili', 'youtube', '课件', '投影', '网页', '16:9'] },
+]
+
+const DELIVERY = {
+  frames: {
+    label: '先出帧（默认）',
+    description: '只出 PNG 帧，几秒看版式；不生成视频。',
+  },
+  silent: {
+    label: '静音 mp4',
+    description: '生成无音轨的成片；适合循环、背景、无解说。',
+  },
+  narrated: {
+    label: '旁白 + 字幕（HF）',
+    description: 'TTS/录音、字幕、混音；需要 HyperFrames，交付最慢。',
+  },
+}
+
+const NARRATION_WORDS = ['旁白', '配音', '讲解', '口播', '字幕', 'voiceover', 'narration', '声音']
+const SILENT_WORDS = ['静音', '无声', '不要声音', '只要画面', 'loop', '循环']
+
+const MATH_WORDS = ['数学', '公式', '导数', '几何', '概率', '微积分', '线代', '矩阵', '向量', '证明',
+  '三角', '函数', '物理', '化学', '生物', '算法', '统计', '复数', '单位圆', '欧拉']
+const AUDIENCE_WORDS = ['大众', '科普', '入门', '高中', '初中', '大学', '专业', '研究生', '论文', '工程师', '学生']
+
+const AUDIENCES = {
+  general: { label: '大众科普', description: '少符号、多比喻；先讲清"为什么"。' },
+  high: { label: '高中', description: '保留公式，控制推导密度；默认按课标。' },
+  university: { label: '大学 / 专业', description: '可以直接上定义、证明、矩阵；密度更高。' },
+}
+
+function hits(brief, words) {
+  const q = brief.toLowerCase()
+  return words.filter((word) => q.includes(word.toLowerCase())).length
+}
+
+function aspectBlock(brief) {
+  const scored = Object.keys(ASPECTS).map((key) => ({
+    key,
+    score: hits(brief, ASPECT_HINTS.find((h) => h.key === key)?.words ?? []),
+  }))
+  scored.sort((a, b) => b.score - a.score || (a.key === '16:9' ? -1 : 1))
+  const explicit = scored.filter((item) => item.score > 0)
+  const top = scored[0].key
+  if (explicit.length === 1) {
+    return { assumption: top, question: null }
+  }
+  const second = top === '16:9' ? '9:16' : '16:9'
+  return {
+    assumption: top,
+    question: {
+      id: 'aspect',
+      header: '画幅',
+      question: '这条片子要横屏、竖屏还是方屏？',
+      options: [top, second].map((key) => ({ ...ASPECTS[key] })),
+    },
+  }
+}
+
+function deliveryBlock(brief) {
+  const narration = hits(brief, NARRATION_WORDS)
+  const silent = hits(brief, SILENT_WORDS)
+  if (narration > 0 && silent === 0) return { assumption: 'narrated', question: null }
+  if (silent > 0 && narration === 0) return { assumption: 'silent', question: null }
+  const order = narration > 0 && silent > 0
+    ? ['frames', 'silent', 'narrated']
+    : ['frames', 'silent', 'narrated']
+  return {
+    assumption: order[0],
+    question: {
+      id: 'delivery',
+      header: '交付',
+      question: '做到哪一步？',
+      options: order.map((key) => ({ ...DELIVERY[key] })),
+    },
+  }
+}
+
+function durationOf(brief) {
+  const match = /(\d+(?:\.\d+)?)\s*(秒|s\b|sec|分钟|min)/i.exec(brief)
+  if (!match) return null
+  const n = Number(match[1])
+  return /分钟|min/i.test(match[2]) ? Math.round(n * 60) : Math.round(n)
+}
+
+function hasNamedStyle(brief, registry) {
+  const q = brief.toLowerCase()
+  return registry.styles.some((style) =>
+    q.includes(style.slug.toLowerCase()) || q.includes(String(style.name_cn).toLowerCase()))
+}
+
+function styleBlock(brief, registry) {
+  const routed = routeStyle(brief, registry)
+  const bySlug = new Map(registry.styles.map((style) => [style.slug, style]))
+  const picked = routed.ranked.filter((item) => item.score > 0).slice(0, 3)
+  if (hasNamedStyle(brief, registry) || picked.length === 0) {
+    const fallback = bySlug.get(registry.default)
+    const options = picked.map(({ slug, reasons }) => {
+      const style = bySlug.get(slug)
+      return {
+        label: style.slug === registry.default ? `${style.name_cn}（默认）` : style.name_cn,
+        description: `${style.uses_cn?.join('、') ?? ''}${reasons.length ? `；命中：${reasons.join('、')}` : ''}`,
+      }
+    })
+    if (picked.length === 0) {
+      options.push(
+        {
+          label: `${fallback.name_cn}（默认）`,
+          description: `题材没有明显命中；先用默认。${fallback.uses_cn?.join('、') ?? ''}`,
+        },
+        { label: '让你决定（我先按默认做）', description: '不用现在选；我先按默认风格出 3 张帧，后面再换。' },
+      )
+    }
+    return {
+      assumption: picked[0]?.slug ?? registry.default,
+      question: hasNamedStyle(brief, registry) ? null : {
+        id: 'style',
+        header: '风格',
+        question: '风格选哪个？选项是按题材推的，不是固定清单。',
+        options,
+      },
+    }
+  }
+  const options = picked.map(({ slug, reasons }) => {
+    const style = bySlug.get(slug)
+    return {
+      label: style.slug === registry.default ? `${style.name_cn}（默认）` : style.name_cn,
+      description: `${style.uses_cn?.join('、') ?? ''}${reasons.length ? `；命中：${reasons.join('、')}` : ''}`,
+    }
+  })
+  if (options.length < 2) {
+    const fallback = bySlug.get(registry.default)
+    options.push({
+      label: `${fallback.name_cn}（默认）`,
+      description: `保底选项；${fallback.uses_cn?.join('、') ?? ''}`,
+    })
+  }
+  return {
+    assumption: picked[0].slug,
+    question: {
+      id: 'style',
+      header: '风格',
+      question: '风格选哪个？选项是按题材推的，不是固定清单。',
+      options,
+    },
+  }
+}
+
+function isMathTopic(brief) {
+  return hits(brief, MATH_WORDS) > 0
+}
+
+function audienceBlock(brief, aspect) {
+  if (!isMathTopic(brief) || hits(brief, AUDIENCE_WORDS) > 0) return null
+  const order = aspect === '9:16'
+    ? ['general', 'high', 'university']
+    : ['high', 'university', 'general']
+  return {
+    assumption: order[0],
+    question: {
+      id: 'audience',
+      header: '受众',
+      question: '这条片给谁看？它决定符号密度和推导长度。',
+      options: order.map((key) => ({ ...AUDIENCES[key] })),
+    },
+  }
+}
+
+function narrationBlock(brief, delivery) {
+  if (delivery !== 'narrated') return null
+  if (/english|英文|中文|chinese|双语|bilingual/i.test(brief)) return null
+  const options = [
+    { label: '中文 · 中性', description: '默认：跟随用户语言，冷静、克制。' },
+    { label: '中文 · 温和', description: '更适合科普、课程。' },
+    { label: '中文 · 有力', description: '更适合宣传、结论型短片。' },
+    { label: '英文 · 中性', description: '需要英文旁白与英文字幕。' },
+  ]
+  return {
+    assumption: { language: 'zh', voice: 'neutral' },
+    question: {
+      id: 'narration',
+      header: '旁白',
+      question: '旁白用什么语言和声音？语言默认跟随你。',
+      options,
+    },
+  }
+}
+
+export function planQuestions(brief, registry = loadRegistry()) {
+  const aspect = aspectBlock(brief)
+  const delivery = deliveryBlock(brief)
+  const style = styleBlock(brief, registry)
+  const audience = audienceBlock(brief, aspect.assumption)
+  const narration = narrationBlock(brief, delivery.assumption)
+
+  const questions = [aspect.question, delivery.question, style.question, audience?.question, narration?.question]
+    .filter(Boolean)
+    .slice(0, MAX_QUESTIONS)
+
+  const durationSec = durationOf(brief) ?? 10
+  const gateMode = durationSec > 60 ? 'full' : (delivery.assumption === 'narrated' || durationSec > 15) ? 'standard' : 'light'
+  const language = /english|英文/i.test(brief) ? 'en' : 'zh'
+  return {
+    brief,
+    questions,
+    assumptions: {
+      aspect: aspect.assumption,
+      delivery: delivery.assumption,
+      style: style.assumption,
+      audience: audience?.assumption ?? null,
+      narration: narration?.assumption ?? (delivery.assumption === 'narrated' ? { language, voice: 'neutral' } : null),
+      durationSec,
+      gateMode,
+      language,
+      captions: delivery.assumption === 'narrated',
+      note: '未指定的项按 assumptions 执行；用户回答后覆盖。',
+    },
+    routing: routeStyle(brief, registry),
+  }
+}
+
+function isMain() {
+  return process.argv[1] && new URL(import.meta.url).pathname === new URL(`file://${process.argv[1]}`).pathname
+}
+
+if (isMain()) {
+  const args = process.argv.slice(2)
+  const json = args.includes('--json')
+  const brief = args.filter((a) => a !== '--json').join(' ').trim()
+  if (!brief) {
+    console.error('用法: node scripts/plan-questions.mjs "<需求>" [--json]')
+    process.exit(1)
+  }
+  const plan = planQuestions(brief)
+  if (json) {
+    console.log(JSON.stringify(plan, null, 2))
+  } else {
+    console.log(`需求: ${plan.brief}`)
+    for (const q of plan.questions) {
+      console.log(`\n[${q.header}] ${q.question}`)
+      for (const option of q.options) console.log(`  - ${option.label}：${option.description}`)
+    }
+    console.log(`\n默认: ${plan.assumptions.aspect} / ${plan.assumptions.delivery} / ${plan.assumptions.style} / ${plan.assumptions.audience ?? '-'} / ${plan.assumptions.durationSec}s`)
+  }
+}

package/scripts/route-style.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/**
+ * 显式风格路由：按 registry 打分，给出 top 3、推荐与置信度。
+ *
+ *   node scripts/route-style.mjs "导数 切线"
+ *   node scripts/route-style.mjs "矩阵 特征值" --json
+ *   node scripts/route-style.mjs "用 3b1b 风格讲单位圆"
+ *
+ * 规则：用户点名风格 > 关键词/uses 打分 > 默认风格；分数并列或为 0 时要求确认。
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const DEFAULT_REGISTRY = join(HERE, '..', 'styles', 'registry.json')
+
+export function loadRegistry(path = DEFAULT_REGISTRY) {
+  return JSON.parse(readFileSync(path, 'utf8'))
+}
+
+function scoreOne(style, query) {
+  const q = query.toLowerCase()
+  const reasons = []
+  let score = 0
+
+  if (q === style.slug.toLowerCase() || q === style.name_cn.toLowerCase()) {
+    score += 12
+    reasons.push('点名风格')
+  } else if (q.includes(style.slug.toLowerCase()) || q.includes(style.name_cn.toLowerCase())) {
+    score += 8
+    reasons.push('点名风格')
+  }
+
+  const keywords = (style.keywords ?? []).filter((k) => q.includes(k.toLowerCase()))
+  if (keywords.length) {
+    score += keywords.length * 3
+    reasons.push(`关键词: ${keywords.join(', ')}`)
+  }
+
+  const uses = [...(style.uses ?? []), ...(style.uses_cn ?? [])]
+    .filter((u) => q.includes(u.toLowerCase()))
+  if (uses.length) {
+    score += uses.length * 2
+    reasons.push(`用途: ${uses.join(', ')}`)
+  }
+
+  const avoided = (style.avoid ?? []).filter((a) => q.includes(a.toLowerCase()))
+  if (avoided.length) {
+    score -= avoided.length * 2
+    reasons.push(`冲突: ${avoided.join(', ')}`)
+  }
+
+  return { slug: style.slug, score: Math.max(score, 0), reasons }
+}
+
+export function routeStyle(query, registry) {
+  const q = String(query ?? '').trim()
+  const styles = registry.styles ?? []
+  const fallback = registry.default ?? styles[0]?.slug ?? null
+  if (!q) {
+    return { query: q, ranked: [], recommendation: fallback, confidence: 'low', needsConfirmation: true, reason: '空查询，使用默认风格' }
+  }
+
+  const ranked = styles
+    .map((style) => scoreOne(style, q))
+    .sort((a, b) => b.score - a.score || a.slug.localeCompare(b.slug))
+
+  const top = ranked[0]
+  if (!top || top.score === 0) {
+    return { query: q, ranked: ranked.slice(0, 3), recommendation: fallback, confidence: 'low', needsConfirmation: true, reason: '没有命中关键词，使用默认风格' }
+  }
+
+  const tie = ranked[1] && ranked[1].score === top.score
+  const lead = top.score - (ranked[1]?.score ?? 0)
+  const confidence = tie ? 'medium' : top.score >= 6 && lead >= 3 ? 'high' : top.score >= 3 ? 'medium' : 'low'
+  return {
+    query: q,
+    ranked: ranked.slice(0, 3),
+    recommendation: top.slug,
+    confidence,
+    needsConfirmation: tie || confidence !== 'high',
+    reason: tie ? '前两名同分，需要确认' : top.reasons.join('；'),
+  }
+}
+
+function isMain() {
+  return process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+}
+
+if (isMain()) {
+  const args = process.argv.slice(2)
+  const json = args.includes('--json')
+  const rest = args.filter((a) => a !== '--json')
+  const query = rest.join(' ').trim()
+  if (!query) {
+    console.error('用法: node scripts/route-style.mjs "<题材>" [--json]')
+    process.exit(1)
+  }
+  const result = routeStyle(query, loadRegistry())
+  if (json) {
+    console.log(JSON.stringify(result, null, 2))
+  } else {
+    console.log(`推荐: ${result.recommendation}  (${result.confidence})`)
+    console.log(`原因: ${result.reason}`)
+    console.log('候选:')
+    for (const [i, item] of result.ranked.entries()) {
+      console.log(`  ${i + 1}. ${item.slug}  ${item.score}  ${item.reasons.join('；')}`)
+    }
+    if (result.needsConfirmation) console.log('需要确认：分数不唯一或置信度低，先问用户再写 DESIGN.md。')
+  }
+}

package/scripts/smoke.mjs

@@ -0,0 +1,83 @@
+/**
+ * 冒烟测试：不依赖网络与 Python，验证包结构与核心模块可加载。
+ * 用法：node scripts/smoke.mjs
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const required = [
+  'package.json',
+  'cordis.patch.yml',
+  'lib/index.js',
+  'lib/ops.js',
+  'lib/env.js',
+  'lib/doctor.js',
+  'lib/fresh.js',
+  'skills/animation-router/SKILL.md',
+  'skills/animation-router/references/confirmation.md',
+  'skills/design-spec/SKILL.md',
+  'skills/qa-rubric/SKILL.md',
+  'styles/registry.json',
+  'styles/swiss-motion/STYLE.md',
+  'styles/swiss-motion/tokens.json',
+  'styles/swiss-motion/theme.py',
+  'styles/swiss-motion/preview.jpg',
+  'styles/dataviz/STYLE.md',
+  'styles/dataviz/tokens.json',
+  'styles/dataviz/theme.py',
+  'styles/dataviz/preview.jpg',
+  'styles/blueprint/STYLE.md',
+  'styles/blueprint/tokens.json',
+  'styles/blueprint/theme.py',
+  'styles/blueprint/preview.jpg',
+  'styles/whiteboard/STYLE.md',
+  'styles/whiteboard/tokens.json',
+  'styles/whiteboard/theme.py',
+  'styles/whiteboard/preview.jpg',
+  'styles/3b1b/STYLE.md',
+  'styles/3b1b/tokens.json',
+  'styles/3b1b/theme.py',
+  'styles/3b1b/preview.jpg',
+  'docs/ai-native-motion.md',
+  'docs/dev-loop.md',
+  'docs/performance-budget.md',
+  'README.md',
+  'LICENSE',
+  'NOTICE.md',
+]
+
+let failed = 0
+for (const rel of required) {
+  const ok = existsSync(join(root, rel))
+  if (!ok) failed++
+  console.log(`${ok ? 'ok  ' : 'MISS'} ${rel}`)
+}
+
+const mod = await import(join(root, 'lib/index.js'))
+console.log(`${mod.name === 'motion' ? 'ok  ' : 'FAIL'} exports name=${mod.name}`)
+
+const ops = await import(join(root, 'lib/ops.js'))
+const framesOk = typeof ops.inspectFrames === 'function' && typeof ops.parseInspectOutput === 'function'
+console.log(`${framesOk ? 'ok  ' : 'FAIL'} frames-first: motion_frames helpers exported`)
+if (!framesOk) failed++
+console.log(`${typeof mod.apply === 'function' ? 'ok  ' : 'FAIL'} exports apply()`)
+if (mod.name !== 'motion' || typeof mod.apply !== 'function') failed++
+
+for (const slug of ['swiss-motion', 'dataviz', 'blueprint', 'whiteboard', '3b1b']) {
+  const tokens = JSON.parse(readFileSync(join(root, 'styles', slug, 'tokens.json'), 'utf8'))
+  const ok = tokens.name === slug && tokens.version === '1.0.0'
+  if (!ok) failed++
+  console.log(`${ok ? 'ok  ' : 'FAIL'} style tokens: ${tokens.name}@${tokens.version}`)
+}
+
+const { doctor } = await import(join(root, 'lib/doctor.js'))
+const report = await doctor({})
+console.log(`ok   doctor: ${report.rows.length} checks, math=${report.ready.math}, delivery=${report.ready.delivery}`)
+
+if (failed > 0) {
+  console.error(`\n${failed} check(s) failed`)
+  process.exit(1)
+}
+console.log('\nsmoke passed')

package/scripts/test-approvals.mjs

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict'
+import { execFileSync } from 'node:child_process'
+import { mkdtempSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const SCRIPT = new URL('./approvals.mjs', import.meta.url).pathname
+const project = mkdtempSync(join(tmpdir(), 'dsh-approvals-'))
+let failed = 0
+
+function run(args) {
+  try {
+    const out = execFileSync(process.execPath, [SCRIPT, ...args], { encoding: 'utf8', stdio: 'pipe' })
+    return { code: 0, out }
+  } catch (error) {
+    return { code: error.status ?? 1, out: `${error.stdout ?? ''}${error.stderr ?? ''}` }
+  }
+}
+
+function test(name, fn) {
+  try {
+    fn()
+    console.log(`ok   ${name}`)
+  } catch (error) {
+    failed++
+    console.log(`FAIL ${name}`)
+    console.error(`     ${String(error.message).split('\n')[0]}`)
+  }
+}
+
+run(['init', project, '--mode', 'light'])
+
+test('刚 init 时 check 不通过', () => {
+  assert.equal(run(['check', project]).code, 1)
+})
+
+test('不能跳过前置阶段', () => {
+  assert.equal(run(['set', project, 'script_storyboard', 'approved']).code, 1)
+})
+
+test('按顺序全部确认后 check 通过', () => {
+  assert.equal(run(['set', project, 'requirements', 'approved', '--note', '需求']).code, 0)
+  assert.equal(run(['set', project, 'script_storyboard', 'approved', '--note', '脚本+分镜']).code, 0)
+  assert.equal(run(['set', project, 'look', 'approved', '--note', '3 帧']).code, 0)
+  assert.equal(run(['set', project, 'start', 'approved', '--note', '可以开始']).code, 0)
+  assert.equal(run(['check', project]).code, 0)
+})
+
+test('standard 模式包含独立脚本/分镜/交付', () => {
+  const dir = mkdtempSync(join(tmpdir(), 'dsh-approvals-std-'))
+  assert.equal(run(['init', dir, '--mode', 'standard']).code, 0)
+  assert.match(run(['show', dir]).out, /脚本/)
+  assert.match(run(['show', dir]).out, /分镜/)
+  assert.match(run(['show', dir]).out, /交付清单/)
+  rmSync(dir, { recursive: true, force: true })
+})
+
+rmSync(project, { recursive: true, force: true })
+
+if (failed > 0) {
+  console.error(`\n${failed} test(s) failed`)
+  process.exit(1)
+}
+console.log('\ntest-approvals passed')