@biunow/agent-biuvibe 1.0.0 → 1.0.2

package/bin/server.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import {
   createAgentServer,
   ensureDir,
@@ -14,9 +14,28 @@ import {
   isIntermediateMp4,
   readJson,
 } from '../lib/host.mjs';
-
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const recipeFile = [
+  path.join(root, 'studio', 'recipes.mjs'),
+  path.resolve(root, '..', '_shared', 'studio', 'recipes.mjs'),
+].find((file) => fs.existsSync(file));
+if (!recipeFile) throw new Error('找不到风格提示词模块 studio/recipes.mjs');
+const { findRecipe, loadRecipes, recipeView } = await import(pathToFileURL(recipeFile).href);
 const COLUMNS = readJson(path.join(root, 'data', 'columns.json'), []);
+const RECIPES = loadRecipes(path.join(root, '风格提示词.md'));
+
+function presentColumn(column) {
+  const found = findRecipe(RECIPES, [column.cn, column.en, column.slug]);
+  return {
+    ...column,
+    recipe: recipeView(found, {
+      prompt: found?.prompt || `用${column.cn}讲「把引号里换成你要讲的事」。${column.line || ''}`,
+      narration: column.voice ? 'required' : 'off',
+      attachment: column.voice || column.music ? 'required' : 'optional',
+      hint: column.hint || '',
+    }),
+  };
+}
 
 function normalizeDuration(value) {
   if (value == null || value === '' || value === 'auto') return null;
@@ -70,7 +89,7 @@ createAgentServer({
         agent: 'biuvibe',
         name: manifest.name || 'BiuVibe',
         description: manifest.description || '',
-        styles: COLUMNS,
+        styles: COLUMNS.map(presentColumn),
         canExport: cfg.canExport,
         enginePresent: !!(engineRoot && fs.existsSync(path.join(engineRoot, 'AGENTS.md'))),
         engineRoot: engineRoot || null,

package/lib/host.mjs

@@ -300,11 +300,39 @@ export function seedSkillIntoProject(projectDir, packageRoot, skillId) {
   return dest;
 }
 
-/** Lemo 的 out/video.mp4、分段文件是无声中间片，不能当成交付成片。 */
+/** 分段和无声中间片不能当成片。成片改名后（ep55.mp4 → ep55-master.mp4）要能从同目录找回。 */
 export function isIntermediateMp4(filePath) {
-  const base = path.basename(filePath).toLowerCase();
-  if (base === 'merged.mp4' || /^seg_\d+\.mp4$/.test(base)) return true;
-  return base === 'video.mp4' && path.basename(path.dirname(filePath)).toLowerCase() === 'out';
+  const base = path.basename(String(filePath || '')).toLowerCase();
+  if (base === 'merged.mp4' || /^seg[-_]\d+\.mp4$/.test(base)) return true;
+  if (/^draft([-.]|$)/.test(base)) return true;
+  const parts = String(filePath || '').split(/[/\\]/).map((part) => part.toLowerCase());
+  if (parts.includes('build') || parts.includes('segments')) return true;
+  return base === 'video.mp4' && parts.at(-2) === 'out';
+}
+
+/** 记录里的文件被删掉或改名时，在同一目录找「原名开头」的现片。 */
+export function rescueMissingFilm(filePath) {
+  const file = String(filePath || '');
+  if (!file) return '';
+  if (fs.existsSync(file) && !isIntermediateMp4(file)) return file;
+  const dir = path.dirname(file);
+  if (!fs.existsSync(dir)) return '';
+  const stem = path.basename(file, path.extname(file)).toLowerCase();
+  if (!stem) return '';
+  let best = null;
+  let names = [];
+  try { names = fs.readdirSync(dir); } catch { return ''; }
+  for (const name of names) {
+    if (!name.toLowerCase().endsWith('.mp4')) continue;
+    if (!name.toLowerCase().startsWith(stem)) continue;
+    const full = path.join(dir, name);
+    if (isIntermediateMp4(full)) continue;
+    let st;
+    try { st = fs.statSync(full); } catch { continue; }
+    if (!st.isFile()) continue;
+    if (!best || st.mtimeMs > best.mtimeMs) best = { path: full, mtimeMs: st.mtimeMs, size: st.size };
+  }
+  return best ? best.path : '';
 }
 
 function collectMp4(rootDir, maxDepth) {
@@ -344,7 +372,9 @@ function pickFilm(found) {
     if (ai !== bi) return ai - bi;
     return b.mtime - a.mtime;
   });
-  return found[0];
+  const best = found[0];
+  if (!best || isIntermediateMp4(best.path)) return null;
+  return best;
 }
 
 /** Newest deliverable MP4. Root-level `<name>.mp4` wins over `out/video.mp4`. */
@@ -396,7 +426,34 @@ export function watchForFilm(cfg, jobs, jobId, {
   const tick = async () => {
     const job = jobs.get(jobId);
     if (!job || job.status === 'failed' || job.status === 'cancelled') return;
-    if (job.outputMp4 && fs.existsSync(job.outputMp4) && !isIntermediateMp4(job.outputMp4)) return;
+    const current = String(job.outputMp4 || '');
+    if (current && fs.existsSync(current) && !isIntermediateMp4(current)) return;
+    if (current && !fs.existsSync(current)) {
+      const rescued = rescueMissingFilm(current);
+      if (rescued) {
+        const message = `成片已就绪 · ${path.basename(rescued)}`;
+        const size = fs.statSync(rescued).size;
+        jobs.update(jobId, {
+          status: 'done',
+          progress: 100,
+          phase: 'film',
+          message,
+          outputMp4: rescued,
+          artifact: rescued,
+          filmBytes: size,
+          filmAt: new Date().toISOString(),
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(jobId)?.panelTaskId,
+          title: title || jobs.get(jobId)?.title,
+          progress: 100,
+          message,
+          done: true,
+          artifact: rescued,
+        });
+        return;
+      }
+    }
     const hit = locateJobFilm({ ...job, projectPath: projectPath || job.projectPath, artifact: job.artifact }, cfg);
     if (hit && !isIntermediateMp4(hit.path)) {
       const message = `成片已就绪 · ${path.basename(hit.path)}`;
@@ -520,9 +577,14 @@ export function createAgentServer({ root, studioDir, api }) {
 
   // 进程重启后：已有成片则收口；否则恢复 watch，避免面板/Studio 任务永远「处理中」
   for (const j of jobs.list()) {
-    if (j.status === 'done' && !j.outputMp4) {
-      const late = locateJobFilm(j, cfg);
-      if (late && !isIntermediateMp4(late.path)) {
+    const filmMissing = j.outputMp4 && !fs.existsSync(j.outputMp4);
+    const filmBad = j.outputMp4 && isIntermediateMp4(j.outputMp4);
+    if (filmMissing || filmBad || (j.status === 'done' && !j.outputMp4)) {
+      const rescued = filmMissing ? rescueMissingFilm(j.outputMp4) : '';
+      const late = rescued
+        ? { path: rescued, size: fs.statSync(rescued).size }
+        : locateJobFilm(j, cfg);
+      if (late && late.path && fs.existsSync(late.path) && !isIntermediateMp4(late.path)) {
         jobs.update(j.id, {
           status: 'done',
           progress: 100,
@@ -533,8 +595,9 @@ export function createAgentServer({ root, studioDir, api }) {
           filmBytes: late.size,
           filmAt: new Date().toISOString(),
         });
+        continue;
       }
-      continue;
+      if (j.status === 'done') continue;
     }
     const waiting = j.status === 'running' || (j.outputMp4 && isIntermediateMp4(j.outputMp4));
     if (!waiting) continue;
@@ -615,8 +678,27 @@ export function createAgentServer({ root, studioDir, api }) {
       if (req.method === 'GET' && /^\/api\/jobs\/[^/]+\/film$/.test(pathname)) {
         const id = decodeURIComponent(pathname.slice('/api/jobs/'.length, -'/film'.length));
         const job = jobs.get(id);
-        const file = job ? String(job.outputMp4 || '') : '';
-        if (!file || !file.toLowerCase().endsWith('.mp4')) return sendJson(res, 404, { error: '成片还没有' });
+        let file = job ? String(job.outputMp4 || '') : '';
+        if (job && (!file || !fs.existsSync(file) || isIntermediateMp4(file))) {
+          const rescued = file && !fs.existsSync(file) ? rescueMissingFilm(file) : '';
+          const late = rescued
+            ? { path: rescued, size: fs.statSync(rescued).size }
+            : locateJobFilm(job, cfg);
+          if (late && late.path && fs.existsSync(late.path) && !isIntermediateMp4(late.path)) {
+            jobs.update(job.id, {
+              status: 'done',
+              progress: 100,
+              phase: 'film',
+              message: `成片已就绪 · ${path.basename(late.path)}`,
+              outputMp4: late.path,
+              artifact: late.path,
+              filmBytes: late.size,
+              filmAt: new Date().toISOString(),
+            });
+            file = late.path;
+          }
+        }
+        if (!file || !file.toLowerCase().endsWith('.mp4') || !fs.existsSync(file)) return sendJson(res, 404, { error: '成片还没有' });
         return serveLocalFile(req, res, file);
       }
       if (pathname.startsWith('/api/jobs/') && req.method === 'GET') {

package/manifest.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "id": "biuvibe",
   "name": "BiuVibe",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "publisher": "Biunow",
   "description": "BiuVibe 知识短片：选一种画风，写下要讲的事，配上你有权使用的音乐或口播。",
   "entry": {
@@ -44,8 +44,8 @@
     "requiresEntitlement": "export"
   },
   "integrity": {
-    "sha256": "32c9e8e00152c4c4c9312dd3e4396d38bd36e57c3f6ef2737c4d78549f2559a7",
-    "signature": "UN9pXtqK6L6QdQASL8ecc8hOtZxGBgQpQ87scMxn+/0YLmP+Ljiy7JZitSPVn0wqPZ4wczJ9B6yOL75GLez7Bg==",
+    "sha256": "7595dd13770062c115893b723e9cffa2c871a58543d5bd1877983ec7e5e9b7d3",
+    "signature": "O0sfbytJhfMSBWJSPaeqON8nQ4VcGP8ZCMeS6d/CTSGxM42hmyR12ZEesBdP4y5S9qSG4JpZ+koWR+ab8uqqAg==",
     "signedBy": "publisher-key"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biunow/agent-biuvibe",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "BiuVibe",
   "license": "UNLICENSED",
   "publishConfig": {

package/studio/app.js

@@ -44,17 +44,18 @@
     };
   }
 
-  function applyStyle(slug) {
+  function applyStyle(slug, opts) {
     const style = state.styles.find((item) => item.slug === slug) || null;
     state.style = style;
     const needs = style ? columnNeeds(style) : null;
     if (needs) {
-      $('needBar').hidden = false;
-      $('needHint').textContent = needs.hint;
       $('uploadHint').textContent = needs.label;
       $('files').setAttribute('accept', needs.accept);
-    } else {
-      $('needBar').hidden = true;
+    }
+    if (style && style.recipe) {
+      Composer.paintRecipe(state, style.recipe, needs?.hint || style.recipe.hint, opts && opts.keep);
+    } else if ($('needBar')) {
+      $('needBar').hidden = !style;
     }
     if (style) state.storyboard = style.confirm !== false;
     syncSb();
@@ -93,7 +94,7 @@
     }
     if (job.style && styleMenu) {
       styleMenu.setValue(job.style, true);
-      applyStyle(job.style);
+      applyStyle(job.style, { keep: true });
     }
     if (typeof job.storyboard === 'boolean') {
       state.storyboard = job.storyboard;
@@ -173,6 +174,9 @@
       if (!state.style) throw new Error('请选择栏目');
       const prompt = $('prompt').value.trim();
       if (!prompt) throw new Error('请填写选题');
+      if (state.style.recipe && state.style.recipe.attachment === 'required' && !state.files.length) {
+        throw new Error(state.style.hint || '这个栏目必须上传附件');
+      }
       if (state.style.music && !state.files.some((file) => String(file.kind || '').startsWith('audio') || /\.(mp3|wav|m4a|flac|ogg|aac)$/i.test(file.name || ''))) {
         throw new Error('请上传一首有授权的配乐');
       }
@@ -233,9 +237,11 @@
       });
 
       const first = state.styles[0];
-      if (first) state.style = first;
+      const want = new URLSearchParams(location.search).get('style');
+      const picked = state.styles.find((item) => item.slug === want) || first;
+      if (picked) state.style = picked;
       styleMenu = SelectMenu.mount($('stylePick'), {
-        value: first?.slug || '',
+        value: picked?.slug || '',
         options: state.styles.map((item) => ({
           value: item.slug,
           label: item.cn,
@@ -247,7 +253,7 @@
         size: 'sm',
         onChange: (value) => applyStyle(value),
       });
-      if (first) applyStyle(first.slug);
+      if (picked) applyStyle(picked.slug);
       await refreshJobs();
       setInterval(refreshJobs, 2000);
       void health;

package/studio/composer.css

@@ -91,6 +91,13 @@ button:disabled { cursor: not-allowed; opacity: .5; }
   display: flex; flex-wrap: wrap; align-items: center; gap: 8px;
   padding: 12px 16px 8px;
 }
+.need-flags { display: flex; flex-wrap: wrap; gap: 6px; margin-left: auto; }
+.need-flag {
+  font-size: 11px; font-weight: 650; border-radius: 99px; padding: 2px 8px;
+  background: #f4f4ef; color: var(--ink);
+}
+.need-flag.required { background: var(--ink); color: var(--accent); }
+.need-flag.off { color: var(--muted); }
 .link-input {
   flex: 1; min-width: 200px; border: 1px solid var(--line); border-radius: 10px;
   padding: 8px 12px; font-size: 12px; background: #fafaf7; color: var(--ink); outline: 0;

package/studio/composer.js

@@ -282,6 +282,47 @@
     container.appendChild(c);
   }
 
+  const RECIPE_LEVEL = { off: '无', optional: '可选', required: '必须' };
+
+  function paintRecipe(state, recipe, hint, keepText) {
+    const prompt = document.getElementById('prompt');
+    let bar = document.getElementById('needBar');
+    if (!bar && prompt) {
+      bar = document.createElement('div');
+      bar.id = 'needBar';
+      bar.className = 'link-bar';
+      prompt.parentNode.insertBefore(bar, prompt);
+    }
+    if (!bar) return;
+    bar.hidden = false;
+    let hintEl = document.getElementById('needHint');
+    if (!hintEl) {
+      hintEl = document.createElement('span');
+      hintEl.id = 'needHint';
+      hintEl.className = 'muted';
+      bar.appendChild(hintEl);
+    }
+    hintEl.textContent = hint || (recipe && recipe.hint) || '';
+    let flags = document.getElementById('needFlags');
+    if (!flags) {
+      flags = document.createElement('div');
+      flags.id = 'needFlags';
+      flags.className = 'need-flags';
+      bar.appendChild(flags);
+    }
+    const narr = (recipe && recipe.narration) || 'optional';
+    const att = (recipe && recipe.attachment) || 'optional';
+    flags.innerHTML =
+      `<span class="need-flag ${narr}">旁白 · ${RECIPE_LEVEL[narr] || narr}</span>` +
+      `<span class="need-flag ${att}">附件 · ${RECIPE_LEVEL[att] || att}</span>`;
+    const text = String((recipe && recipe.prompt) || '').trim();
+    if (prompt && text && !keepText) {
+      prompt.value = text;
+      prompt.dispatchEvent(new Event('input'));
+      state.seed = text;
+    }
+  }
+
   function titleFromPrompt(prompt, fallback) {
     const line = String(prompt || '')
       .trim()
@@ -303,5 +344,6 @@
     renderJobs,
     addChip,
     titleFromPrompt,
+    paintRecipe,
   };
 })(window);

package/studio/recipes.mjs

@@ -0,0 +1,86 @@
+import fs from 'node:fs';
+
+/** 从《风格提示词.md》读出每条模板的起步提示词。标题用 ## 或 ###。 */
+export function loadRecipes(file) {
+  if (!file || !fs.existsSync(file)) return [];
+  const lines = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+  const recipes = [];
+  let section = '';
+  let title = '';
+  let blurb = [];
+  let buf = [];
+  let inCode = false;
+
+  const flush = () => {
+    const prompt = buf.join('\n').trim();
+    if (title && prompt) {
+      recipes.push({
+        section,
+        title: title.trim(),
+        blurb: blurb.join(' ').replace(/\s+/g, ' ').trim(),
+        prompt,
+      });
+    }
+    buf = [];
+    blurb = [];
+  };
+
+  for (const line of lines) {
+    if (line.startsWith('```')) {
+      if (inCode) {
+        inCode = false;
+        flush();
+        title = '';
+      } else {
+        inCode = true;
+      }
+      continue;
+    }
+    if (inCode) {
+      buf.push(line);
+      continue;
+    }
+    if (line.startsWith('### ')) {
+      title = line.slice(4).trim();
+      blurb = [];
+      continue;
+    }
+    if (line.startsWith('## ')) {
+      section = line.slice(3).trim();
+      title = section;
+      blurb = [];
+      continue;
+    }
+    if (line.startsWith('# ')) continue;
+    if (title && line.trim()) blurb.push(line.trim());
+  }
+  return recipes;
+}
+
+function norm(value) {
+  return String(value || '').trim().toLowerCase().replace(/\s+/g, '');
+}
+
+export function findRecipe(recipes, keys) {
+  const wants = [...new Set((keys || []).map(norm).filter(Boolean))];
+  for (const want of wants) {
+    const hit = (recipes || []).find((recipe) => {
+      const title = norm(recipe.title);
+      const head = norm(String(recipe.title).split('·')[0]);
+      return title === want || head === want;
+    });
+    if (hit) return hit;
+  }
+  return null;
+}
+
+export function recipeView(recipe, extras = {}) {
+  const prompt = String(recipe?.prompt || extras.prompt || '').trim();
+  return {
+    prompt,
+    blurb: recipe?.blurb || '',
+    narration: extras.narration || 'optional',
+    attachment: extras.attachment || 'optional',
+    hint: extras.hint || recipe?.blurb || '',
+  };
+}

package/studio/select-menu.js

@@ -138,16 +138,33 @@
     const minWidth = grid ? 404 : 210;
     const width = Math.min(Math.max(r.width, minWidth), vw - 24);
     const left = Math.min(Math.max(12, r.left), Math.max(12, vw - width - 12));
-    const catBlock = this.hasGroups() ? 86 : 0;
-    const entryBlock = this.entryOpen ? 54 : 0;
-    const estHeight = grid
-      ? catBlock + Math.min(430, Math.ceil(visible.length / 3) * 96 + 14)
-      : Math.min(340, visible.length * 38 + 12) + entryBlock;
-    this.dropUp = vh - r.bottom < estHeight + 14 && r.top > estHeight + 14;
-    this.pos = { left, width, top: r.bottom + 6, bottom: vh - r.top + 6 };
+    const gap = 6;
+    const margin = 12;
+    const below = Math.max(0, vh - r.bottom - gap - margin);
+    const above = Math.max(0, r.top - gap - margin);
+    let chrome = 0;
     if (this.panel) {
       this.panel.style.left = `${left}px`;
       this.panel.style.width = `${width}px`;
+      const cats = this.panel.querySelector('.sm-cats');
+      const entry = this.panel.querySelector('.sm-entry');
+      chrome = (cats ? cats.offsetHeight : 0) + (entry ? entry.offsetHeight : 0);
+    }
+    const scrollCap = grid ? 430 : 292;
+    const naturalScroll = grid
+      ? Math.min(scrollCap, Math.ceil(Math.max(visible.length, 1) / 3) * 96 + 14)
+      : Math.min(scrollCap, visible.length * 38 + 12);
+    const want = Math.min(chrome + naturalScroll, 240);
+    this.dropUp = below < want && above > below;
+    const available = Math.max(0, this.dropUp ? above : below);
+    const room = Math.min(available, chrome + naturalScroll);
+    const scrollMax = Math.max(0, Math.min(scrollCap, room - chrome));
+    this.pos = { left, width, top: r.bottom + gap, bottom: vh - r.top + gap };
+    if (this.panel) {
+      this.panel.style.maxHeight = `${room}px`;
+      this.panel.style.overflow = scrollMax > 0 ? 'hidden' : 'auto';
+      const scroll = this.panel.querySelector('.sm-scroll');
+      if (scroll) scroll.style.maxHeight = `${scrollMax}px`;
       if (this.dropUp) {
         this.panel.style.bottom = `${this.pos.bottom}px`;
         this.panel.style.top = 'auto';

package//351/243/216/346/240/274/346/217/220/347/244/272/350/257/215.md

@@ -0,0 +1,105 @@
+# BiuVibe 风格提示词
+
+选中栏目后，下面这句话会填进选题。引号里换成你要讲的事，其余不用改。旁白和附件的要求跟栏目走。
+
+## 卡点
+
+### 黑金光影
+
+近黑底、暖色烟雾、金粒子标题。没有口播，配乐必须上传。
+
+```
+用黑金光影讲「为什么把选择留到最后，反而更难决定」。一句反常识先砸在画面上，金粒子标题跟着配乐的重拍走，全程没有口播。
+```
+
+### 暗金文献
+
+近黑底、金线图表、衬线字。没有口播，配乐必须上传。
+
+```
+用暗金文献讲「一个看起来很小的利息，翻过很多年之后为什么会压过人」。金线图表按配乐重拍出现，没有口播。
+```
+
+### 灯火史话
+
+暖黑夜色和火光。没有口播，配乐必须上传。
+
+```
+用灯火史话讲「古代驿站为什么能把一封信送到这么远」。火光里先给结论，再给一个能记住的细节，没有口播。
+```
+
+### 战术屏
+
+游戏 HUD 和发光图表。没有口播，不画真实游戏的角色和枪械。配乐必须上传。
+
+```
+用战术屏讲「连续失败三次之后，人为什么会开始怪自己的手」。只讲那个瞬间背后的道理，不出现真实游戏的角色和枪械，没有口播。
+```
+
+### 网点档案
+
+旧纸或藏青夜色，粗宋大字。没有口播，配乐必须上传。
+
+```
+用网点档案讲「一份被盖过章的旧规定，今天还在影响谁」。大字先出，印章落在配乐重拍上，没有口播。
+```
+
+## 口播
+
+### 暖纸工作台
+
+暖米色纸面、步骤条。必须上传口播录音。
+
+```
+用暖纸工作台讲「一件事可以分成哪三步做完」。每一步只留一个动作，口播用你上传的录音。
+```
+
+### 剪辑台
+
+软件界面一镜到底。必须上传口播录音，截图可以一起附上。
+
+```
+用剪辑台讲「一个功能从想法到能点下去，中间经过哪几个画面」。按你上传的口播走，产品截图有就放进对应的一步。
+```
+
+### 像素贴纸
+
+像素小人和贴纸大字。竖屏。必须上传口播录音。
+
+```
+用像素贴纸讲「一个词就能说清的那件事」。竖屏，贴纸上只留这一个词，口播用你上传的录音。
+```
+
+### 像素手绘
+
+像素主持人和细线卡片。横屏。必须上传口播录音。
+
+```
+用像素手绘讲「一个概念要先看见，再记住」。横屏，演播室和旁切交替，口播用你上传的录音。
+```
+
+### 矢量手绘
+
+带表情的矢量小人。竖屏。必须上传口播录音。
+
+```
+用矢量手绘讲「一个人听到这句话时，表情是怎么变的」。竖屏，一句一个表情，口播用你上传的录音。
+```
+
+## 拼贴
+
+### 时间轴长卷
+
+旧纸桌面上的时间尺。没有口播，配乐必须上传。年份图片可以附上。
+
+```
+用时间轴长卷讲「这件事是从哪一年开始，一步步走到今天的」。时间尺按配乐往前走，没有口播。年份图片有就钉在对应的那一格。
+```
+
+### 硬切拼贴
+
+黑卡大字和真实素材来回切。必须上传口播，图片或视频也要带上。
+
+```
+用硬切拼贴讲「两件看起来无关的事，最后为什么是同一件事」。黑卡大字和你上传的图片或视频来回切，口播用你的录音。
+```