@ninkch/dsh-infinite-canvas 0.19.2 → 0.19.4

package/skill-pack-loader.js

@@ -0,0 +1,147 @@
+/**
+ * canvas-director 技能包的 Host 侧加载器。
+ *
+ * 职责：
+ *  - 读 manifest.json 并缓存（文件未变不重复解析）；
+ *  - 按层读卡文件（带缓存）；
+ *  - 用 pack.js 的纯函数按生成能力切片并拼装；
+ *  - 提供层清单供 canvas_list_skills 展示。
+ *
+ * 一切路径限制在 assets/canvas-director/ 之内；缺文件不抛错（该层跳过，由调用方决定是否提示）。
+ */
+import path from 'node:path';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+
+export const PACK_DIR_REL = 'assets/canvas-director';
+export const LAYER_DIRS = {
+  lenses: 'lenses',
+  genres: 'genres',
+  industries: 'industries',
+  forms: 'forms',
+  looks: 'looks',
+};
+/** 单数层名 → manifest 里的复数数组名（cards 用 lens/genre/... ，索引用 lenses/genres/...）。 */
+export const LAYER_OF = {
+  lens: 'lenses',
+  genre: 'genres',
+  industry: 'industries',
+  form: 'forms',
+  look: 'looks',
+};
+/** 复数数组名 → 读文件用的子目录名。 */
+export const DIR_OF = LAYER_DIRS;
+
+/** manifest 与各卡文件的缓存：key = 绝对路径，value = { mtimeMs, size, data }。 */
+const fileCache = new Map();
+/** pack.js 模块缓存。 */
+let PACK_MOD = null;
+
+/** 读文件并缓存（按 mtime+size 失效）。文件不存在返回 null。 */
+function readCached(abs) {
+  let st;
+  try { st = statSync(abs); } catch { return null; }
+  const hit = fileCache.get(abs);
+  if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) return hit.data;
+  const data = readFileSync(abs, 'utf8');
+  fileCache.set(abs, { mtimeMs: st.mtimeMs, size: st.size, data });
+  return data;
+}
+
+/** 清空缓存（测试用）。 */
+export function clearPackCache() { fileCache.clear(); PACK_MOD = null; }
+
+/** 懒加载 pack.js（纯函数模块，与 Client 同源）。 */
+export async function getPackModule() {
+  if (PACK_MOD) return PACK_MOD;
+  const abs = path.join(HERE_DIR, PACK_DIR_REL, 'pack.js');
+  if (!existsSync(abs)) throw new Error('缺少 pack.js：' + abs);
+  PACK_MOD = await import(pathToFileURL(abs).href);
+  return PACK_MOD;
+}
+
+/** 由 index.js 在模块初始化时注入（避免本文件反向依赖 index）。 */
+let HERE_DIR = '';
+export function initPackBase(hereDir) { HERE_DIR = String(hereDir || ''); }
+
+/** 读 manifest（未解析的原始对象）。缺失返回 null。 */
+export function readManifestRaw(hereDir) {
+  const base = hereDir || HERE_DIR;
+  const abs = path.join(base, PACK_DIR_REL, 'manifest.json');
+  const raw = readCached(abs);
+  if (!raw) return null;
+  try { return JSON.parse(raw); } catch { return null; }
+}
+
+/** 读一层里的一张卡（按 manifest 的 file 字段）。layers 用 manifest 的复数名（lenses/genres/...）。缺失返回 null。 */
+export function readCard(hereDir, layer, file) {
+  const base = hereDir || HERE_DIR;
+  const plural = LAYER_OF[layer] || layer;         // 允许传单数
+  const dir = DIR_OF[plural];
+  if (!dir) return null;
+  const rel = String(file || '').replace(/\\/g, '/').replace(/^\/+/, '');
+  if (!rel || rel.includes('..')) return null;
+  const abs = path.join(base, PACK_DIR_REL, dir, rel);
+  const baseDir = path.join(base, PACK_DIR_REL);
+  const resolved = path.resolve(abs);
+  if (!resolved.startsWith(path.resolve(baseDir) + path.sep)) return null;
+  return readCached(resolved);
+}
+
+/** 读 moves 下的文件（不属五层索引，按文件名直取）。 */
+export function readMove(hereDir, file) {
+  const base = hereDir || HERE_DIR;
+  const rel = String(file || '').replace(/\\/g, '/').replace(/^\/+/, '');
+  if (!rel || rel.includes('..')) return null;
+  const abs = path.resolve(path.join(base, PACK_DIR_REL, 'moves', rel));
+  const baseDir = path.resolve(path.join(base, PACK_DIR_REL, 'moves'));
+  if (!abs.startsWith(baseDir + path.sep)) return null;
+  return readCached(abs);
+}
+
+/** 层清单（给 canvas_list_skills 用）：每层数组，元素含 id/name/group/oneliner/tier/available。 */
+export function packInventory(hereDir) {
+  const base = hereDir || HERE_DIR;
+  const raw = readManifestRaw(base);
+  const out = { lenses: [], genres: [], industries: [], forms: [], looks: [], moves: [] };
+  if (!raw) return out;
+  for (const layer of Object.keys(LAYER_DIRS)) {
+    const list = Array.isArray(raw[layer]) ? raw[layer] : [];
+    out[layer] = list.map((it) => ({
+      id: String(it.id || ''),
+      name: String(it.name || ''),
+      group: String(it.group || ''),
+      oneliner: String(it.oneliner || ''),
+      tier: String(it.tier || ''),
+      glyph: String(it.glyph || it.id || ''),
+      file: String(it.file || ''),
+      available: !!readCard(base, layer, it.file),
+    }));
+  }
+  const moves = Array.isArray(raw.moves) ? raw.moves : [];
+  out.moves = moves.map((it) => ({
+    id: String(it.id || ''),
+    name: String(it.name || ''),
+    file: String(it.file || ''),
+    oneliner: String(it.oneliner || ''),
+    available: !!readMove(base, it.file),
+  }));
+  return out;
+}
+
+/** 从 inventory 取某层某 id 的条目（layer 可传单数或复数）。 */
+export function findEntry(inv, layer, id) {
+  const plural = LAYER_OF[layer] || layer;
+  const list = (inv && inv[plural]) || [];
+  return list.find((x) => x.id === id) || null;
+}
+
+/** 全部合法 id（给 normalizeSkillProfile 的枚举用）。 */
+export function allowedIds(inv) {
+  return {
+    lenses: ((inv && inv.lenses) || []).filter((x) => x.available).map((x) => x.id),
+    genres: [...((inv && inv.genres) || []), ...((inv && inv.industries) || [])].filter((x) => x.available).map((x) => x.id),
+    forms: ((inv && inv.forms) || []).filter((x) => x.available).map((x) => x.id),
+    looks: ((inv && inv.looks) || []).filter((x) => x.available).map((x) => x.id),
+  };
+}

package/skill-pack.js

@@ -0,0 +1,179 @@
+/**
+ * Host 侧「技能包切片」构建：把四层配置 + manifest 变成可注入的文本。
+ *
+ * 与 Client 侧同源（都用 assets/canvas-director/pack.js 的纯函数），保证
+ * 画布自生成与对话侧写出的提示词口径一致。这是「技能要对所有提示词生成起作用」的落点。
+ */
+import {
+  getPackModule, packInventory, readCard, readMove, findEntry, allowedIds, readManifestRaw,
+} from './skill-pack-loader.js';
+import { normalizeSkillProfile } from './index-core-skill-profile.js';
+
+/** moves 永远随 storyboard/prompt 走（运镜是这两类生成的必需品）。 */
+const MOVES_FOR_KIND = {
+  script: [],
+  storyboard: ['camera-moves'],
+  prompt: ['camera-moves'],
+  assets: [],
+};
+
+/**
+ * 构建某生成能力下的注入文本。
+ * @param {object} opts
+ * @param {string} opts.kind       script | storyboard | prompt | assets
+ * @param {object} opts.profile    技能配置（已归一或原始，函数内部会再归一）
+ * @param {string} opts.hereDir    插件根目录
+ * @param {boolean} opts.zh        中文
+ * @returns {Promise<{text:string,bytes:number,used:Array,profile:object,inventory:object}>}
+ */
+export async function buildSkillPack(opts) {
+  const o = opts || {};
+  const kind = String(o.kind || 'script');
+  const zh = o.zh !== false;
+  const hereDir = String(o.hereDir || '');
+
+  const inv = packInventory(hereDir);
+  const allow = allowedIds(inv);
+  const profile = normalizeSkillProfile(o.profile, allow);
+
+  // 内层：genres 里既可能是叙事题材 id，也可能是行业题材 id —— 两者都从各自层读
+  const items = [];
+  const lensEntry = profile.lens ? findEntry(inv, 'lenses', profile.lens) : null;
+  if (lensEntry) {
+    const md = readCard(hereDir, 'lenses', lensEntry.file);
+    if (md) items.push({ layer: 'lens', md, meta: lensEntry });
+  }
+  for (const gid of profile.genres) {
+    const ge = findEntry(inv, 'genres', gid);
+    if (ge) {
+      const md = readCard(hereDir, 'genres', ge.file);
+      if (md) { items.push({ layer: 'genre', md, meta: ge }); continue; }
+    }
+    const ie = findEntry(inv, 'industries', gid);
+    if (ie) {
+      const md = readCard(hereDir, 'industries', ie.file);
+      if (md) items.push({ layer: 'industry', md, meta: ie });
+    }
+  }
+  const formEntry = profile.form ? findEntry(inv, 'forms', profile.form) : null;
+  if (formEntry) {
+    const md = readCard(hereDir, 'forms', formEntry.file);
+    if (md) items.push({ layer: 'form', md, meta: formEntry });
+  }
+  const lookEntry = profile.look ? findEntry(inv, 'looks', profile.look) : null;
+  if (lookEntry) {
+    const md = readCard(hereDir, 'looks', lookEntry.file);
+    if (md) items.push({ layer: 'look', md, meta: lookEntry });
+  }
+  for (const mid of (MOVES_FOR_KIND[kind] || [])) {
+    const mv = (inv.moves || []).find((x) => x.id === mid);
+    if (!mv) continue;
+    const md = readMove(hereDir, mv.file);
+    if (md) items.push({ layer: 'moves', md, meta: mv });
+  }
+
+  const P = await getPackModule();
+  // 一条卡都没取到 → 不注入（连 head 都不给：否则「未配置」也会往 system 里塞一段空壳）
+  if (!items.length) {
+    return { text: '', bytes: 0, used: [], profile, inventory: inv };
+  }
+  const head = headLine(kind, profile, inv, zh);
+  const built = P.buildPackText(kind, items, { zh, head });
+  return { text: built.text, bytes: built.bytes, used: built.used, profile, inventory: inv };
+}
+
+/** 注入块的头部一行：把生效配置写清，并声明优先级（模型据此裁决冲突）。 */
+function headLine(kind, profile, inv, zh) {
+  const nameOf = (layer, id) => {
+    if (!id) return '—';
+    const e = findEntry(inv, layer, id);
+    return e ? e.name : id;
+  };
+  const genreNames = (profile.genres || []).map((g) => {
+    const e = findEntry(inv, 'genres', g) || findEntry(inv, 'industries', g);
+    return e ? e.name : g;
+  });
+  if (zh) {
+    return [
+      '【画布技能包 · ' + kindLabel(kind) + '】',
+      '导演透镜：' + nameOf('lenses', profile.lens) + '　题材：' + (genreNames.join('、') || '—')
+        + '　类型规格：' + nameOf('forms', profile.form) + '　影调：' + (profile.look ? nameOf('looks', profile.look) : '跟随导演'),
+      '优先级：用户显式指令 > 导演透镜 > 类型规格（仅画幅与单镜时长上压过透镜）> 题材 > 影调 > 技能默认。以下为对应切片，写提示词时必须遵守；与本块冲突的通则让位于本块。',
+    ].join('\n');
+  }
+  return [
+    '[Canvas skill pack · ' + kindLabel(kind, false) + ']',
+    'Director lens: ' + nameOf('lenses', profile.lens) + '  Genre: ' + (genreNames.join(', ') || '-')
+      + '  Delivery form: ' + nameOf('forms', profile.form) + '  Look: ' + (profile.look ? nameOf('looks', profile.look) : 'follow the lens'),
+    'Precedence: explicit user instruction > director lens > delivery form (only aspect and clip length) > genre > look > skill defaults. The slices below are binding; where a generic rule disagrees, this block wins.',
+  ].join('\n');
+}
+
+function kindLabel(kind, zh) {
+  const ZH = { script: '剧本', storyboard: '分镜', prompt: '提示词', assets: '资产设定图' };
+  const EN = { script: 'script', storyboard: 'storyboard', prompt: 'prompt', assets: 'asset sheet' };
+  const m = zh === false ? EN : ZH;
+  return m[kind] || kind;
+}
+
+/** 给 canvas_list_skills 用的技能清单（4 份内置技能 + 何时用）。 */
+export const SKILL_CATALOG = [
+  { name: 'canvas-studio', when: '任何时候先读：建项目 / 写节点 / 触发生成 / 查状态' },
+  { name: 'canvas-craft', when: '写剧本或拆分镜前：剧本四要素、分镜六要素、提示词规范' },
+  { name: 'canvas-layout', when: '批量建节点前：一类型一列、绝不重叠' },
+  { name: 'canvas-director', when: '写任何提示词前：导演透镜 / 题材 / 类型规格 / 影调 / 运镜，先用 canvas_skill_pack 取切片' },
+];
+
+/** 层清单的可读渲染（canvas_list_skills 的正文）。 */
+export function renderInventory(inv, profile, zh) {
+  const lines = [];
+  const ZH_LABEL = { lenses: '导演透镜', genres: '叙事题材', industries: '行业题材', forms: '类型规格', looks: '影调质感' };
+  const EN_LABEL = { lenses: 'Director lenses', genres: 'Genres', industries: 'Industries', forms: 'Delivery forms', looks: 'Looks' };
+  const L = zh === false ? EN_LABEL : ZH_LABEL;
+  for (const layer of ['lenses', 'genres', 'industries', 'forms', 'looks']) {
+    const list = (inv && inv[layer]) || [];
+    if (!list.length) continue;
+    lines.push('');
+    lines.push('### ' + L[layer] + '（' + list.length + '）');
+    // 按 group 分组展示
+    const byGroup = new Map();
+    for (const it of list) {
+      const g = it.group || '';
+      if (!byGroup.has(g)) byGroup.set(g, []);
+      byGroup.get(g).push(it);
+    }
+    for (const [g, arr] of byGroup) {
+      lines.push((g ? g + '：' : '') + arr.map((x) => x.id + '=' + x.name + (x.available ? '' : '（缺文件）')).join('　'));
+    }
+  }
+  const mv = (inv && inv.moves) || [];
+  if (mv.length) {
+    lines.push('');
+    lines.push('### ' + (zh === false ? 'Camera & rhythm' : '运镜与节奏') + '（' + mv.length + '）');
+    lines.push(mv.map((x) => x.id + '=' + x.name).join('　'));
+  }
+  return lines.join('\n');
+}
+
+/** 当前项目配置的可读渲染。 */
+export function renderProfile(profile, inv, zh) {
+  const nameOf = (layer, id) => {
+    if (!id) return '';
+    const e = findEntry(inv, layer, id);
+    return e ? e.name : id;
+  };
+  const g = (profile.genres || []).map((x) => {
+    const e = findEntry(inv, 'genres', x) || findEntry(inv, 'industries', x);
+    return e ? e.name : x;
+  });
+  if (zh === false) {
+    return 'lens=' + (profile.lens || '(none)') + ' genres=' + (g.join(',') || '(none)')
+      + ' form=' + (profile.form || '(none)') + ' look=' + (profile.look || '(follow the lens)');
+  }
+  return '导演=' + (nameOf('lenses', profile.lens) || '（未选）')
+    + '　题材=' + (g.join('、') || '（未选）')
+    + '　类型规格=' + (nameOf('forms', profile.form) || '（未选）')
+    + '　影调=' + (profile.look ? nameOf('looks', profile.look) : '跟随导演');
+}
+
+export { readManifestRaw, normalizeSkillProfile };