@fps-games/vfx 0.3.2 → 0.3.4

package/packages/resource.particle.viscous_oil_suction/provenance/asset-map.json

@@ -1,111 +0,0 @@
-{
-  "schemaVersion": "vfx-asset-map/1.0",
-  "generatedAt": "2026-05-21T13:04:29.644Z",
-  "sourcePackage": "vfx-intermediate/cocos-babylon-packages/gas_town_oil_suction",
-  "policy": {
-    "runtimeAssetsRoot": "assets/",
-    "sourceAssetsRoot": "source/",
-    "note": "assets/ contains files loaded by Babylon runtime. source/cocos/assets/ preserves the original Cocos asset tree for traceability and reconversion."
-  },
-  "entries": [
-    {
-      "id": "glow_ad",
-      "kind": "texture",
-      "group": "textures",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/textures/Glow ad.png",
-      "sourcePackagePath": "assets/textures/Glow ad.png",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/Glow ad.png",
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/Glow ad.png",
-      "sourceId": "dd44b0a9-0998-4c24-ba2e-d6ac9d1bebb7@6c48a",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/GasTown_OilSuction/Glow ad.png"
-    },
-    {
-      "id": "asset",
-      "kind": "material",
-      "group": "materials",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
-      "sourcePackagePath": "assets/materials/石油.mtl",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
-      "sourceId": "4aabf2b0-1d20-4e13-9384-ae47eb8522aa",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl"
-    },
-    {
-      "id": "particle_emitter_oil_suction_v1",
-      "kind": "script",
-      "group": "scripts",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/runtime/gas_town_oil_suction/particleEmitter.v1.js",
-      "sourcePackagePath": "assets/runtime/gas_town_oil_suction/particleEmitter.v1.js",
-      "sourceArchivePath": null,
-      "sourcePath": null,
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "02-normalized-vfx",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/02-normalized-vfx.json",
-      "sourcePackagePath": "source/02-normalized-vfx.json",
-      "sourceArchivePath": null,
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/02-normalized-vfx.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "01-source-dump",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/01-source-dump.json",
-      "sourcePackagePath": "source/01-source-dump.json",
-      "sourceArchivePath": null,
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/01-source-dump.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "asset",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/吸石油.prefab",
-      "sourcePackagePath": "source/raw/吸石油.prefab",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab",
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab",
-      "sourceId": "29954e7e-d137-4c8b-a730-4f0320cbece8",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab"
-    },
-    {
-      "id": "asset.meta",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/吸石油.prefab.meta",
-      "sourcePackagePath": "source/raw/吸石油.prefab.meta",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab.meta",
-      "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab.meta",
-      "sourceId": "29954e7e-d137-4c8b-a730-4f0320cbece8",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab.meta"
-    }
-  ],
-  "gcsPrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source",
-  "fullProvenancePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/provenance",
-  "canonicalSource": "gcs"
-}

package/packages/resource.particle.viscous_oil_suction/provenance/lineage.json

@@ -1,45 +0,0 @@
-{
-  "schemaVersion": "vfx-library-lineage/1.0",
-  "savedAt": "2026-05-21T13:04:29.665Z",
-  "sourcePackage": "vfx-intermediate/cocos-babylon-packages/gas_town_oil_suction",
-  "sourceEffect": "03-effect.json",
-  "libraryPackage": "packages/resource.particle.viscous_oil_suction",
-  "effectId": "resource.particle.viscous_oil_suction",
-  "media": {
-    "previewVideo": "media/preview.webm",
-    "previewWebm": "media/preview.webm",
-    "previewMp4": "media/preview.mp4",
-    "previewGif": "media/preview.gif",
-    "thumbnail": "media/thumbnail.png",
-    "gcsUri": null
-  },
-  "recording": {
-    "provider": "browser-mediarecorder",
-    "recordedAt": "2026-05-21T13:04:30.575Z",
-    "mimeType": "video/webm;codecs=vp9",
-    "durationSec": 10,
-    "fps": 30,
-    "media": {
-      "previewVideo": "media/preview.webm",
-      "previewWebm": "media/preview.webm",
-      "previewMp4": "media/preview.mp4",
-      "previewGif": "media/preview.gif",
-      "thumbnail": "media/thumbnail.png",
-      "gcsUri": null
-    }
-  },
-  "description": {
-    "provider": "litellm",
-    "status": "described",
-    "model": "gemini-3.1-pro-preview",
-    "generatedAt": "2026-05-21T13:30:34.263Z"
-  },
-  "gcsPrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source",
-  "fullProvenancePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/provenance",
-  "previousIds": [
-    "world.particle.gas_town_oil_suction",
-    "world.particle.viscous_oil_suction"
-  ],
-  "renamedAt": "2026-05-21T13:39:08.485Z"
-}

package/packages/types.ts

@@ -1,195 +0,0 @@
-import type { Scene } from '@babylonjs/core/scene';
-import type { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
-
-export type VfxDebugAnchor = 'playerRight' | 'player';
-
-// ── 运行时外部信息(inputs)──────────────────────────────────────────────
-// 与 params(设计期可调、保存)区分:inputs 是运行时由游戏逻辑提供的外部上下文,常动态。
-// 值可为静态值或 provider(() => 值);动态目标(移动)用 provider 每帧取。见 docs/vfx-placement-design.md。
-export type VfxInput<T> = T | (() => T);
-export type VfxInputKey = 'aim' | 'normal' | 'endpoints' | 'target';
-
-/** 调用方提供的 inputs(放在 VfxSpawnTransform.inputs)。 */
-export interface VfxEffectInputs {
-  aim?: VfxInput<Vector3>;            // 瞄准点(激光/定向武器)
-  normal?: VfxInput<Vector3>;         // 表面法线(贴花/冲击)
-  endpoints?: Array<VfxInput<Vector3>>; // link/链式(≥2 端点)
-  target?: AbstractMesh;              // target-material 类(改目标自身材质)
-  /** 运行时标量(throttle/intensity 等),值可静态或 provider;特效每帧读取做活改(G5)。 */
-  scalars?: Record<string, VfxInput<number>>;
-}
-
-/** create() 收到的、已归一化为访问器的 inputs(provider 与静态值都变成可调用的函数)。 */
-export interface VfxResolvedInputs {
-  aim?: () => Vector3;
-  normal?: () => Vector3;
-  endpoints?: Array<() => Vector3>;
-  target?: AbstractMesh;
-  scalars?: Record<string, () => number>;
-}
-
-export type VfxParamValue = number | string | VfxColorValue;
-export type VfxParamValues = Record<string, VfxParamValue>;
-
-export interface VfxColorValue {
-  r: number;
-  g: number;
-  b: number;
-}
-
-export type VfxParamKind =
-  | 'number'
-  | 'color'
-  | 'enum'
-  | 'opacity'
-  | 'lifetime'
-  | 'scale';
-
-export interface VfxParamDefinitionBase {
-  key: string;
-  label: string;
-  kind: VfxParamKind;
-  description?: string;
-}
-
-export interface VfxNumberParamDefinition extends VfxParamDefinitionBase {
-  kind: 'number' | 'opacity' | 'lifetime' | 'scale';
-  min?: number;
-  max?: number;
-  step?: number;
-}
-
-export interface VfxColorParamDefinition extends VfxParamDefinitionBase {
-  kind: 'color';
-}
-
-export interface VfxEnumParamOption {
-  value: string;
-  label: string;
-}
-
-export interface VfxEnumParamDefinition extends VfxParamDefinitionBase {
-  kind: 'enum';
-  options: VfxEnumParamOption[];
-}
-
-export type VfxParamDefinition = VfxNumberParamDefinition | VfxColorParamDefinition | VfxEnumParamDefinition;
-
-export interface VfxEffectPackageContext<PParams extends VfxParamValues = VfxParamValues> {
-  scene: Scene;
-  root: TransformNode;
-  position: Vector3;
-  rotationY: number;
-  renderingGroupId?: number;
-  params: PParams;
-  /**
-   * 解析后的三轴缩放(来自 spawnTransform.scale,默认 (1,1,1))。
-   * root 的缩放由 service 写好;但**几何不挂 root 的 world/detached 特效**(粒子/抛物池/世界坐标 emitter)
-   * root.scaling 作用不到,须自行把 ctx.scale 乘进几何尺寸/初速(G3)。
-   */
-  scale: Vector3;
-  /** 运行时外部信息(已归一化为访问器)。link/target/定向武器/活改标量等按 required/optionalInputs 读取。 */
-  inputs?: VfxResolvedInputs;
-}
-
-export interface VfxEffectHandle {
-  root: TransformNode;
-  ready?: Promise<void>;
-  dispose(): void;
-  /** 可选:运行时活改 params(无须 dispose+replay,避免重置缓动/可见闪)。声明即纳入契约(G5)。 */
-  update?(params: Partial<VfxParamValues>): void;
-}
-
-export interface VfxEffectManifest {
-  id: string;
-  nameZh: string;
-  assets?: string[];
-  source?: string;
-}
-
-export interface VfxSpawnParamKeys {
-  offsetX?: string;
-  offsetY?: string;
-  offsetZ?: string;
-}
-
-/** 欧拉角(弧度)/ 三轴缩放的纯数据三元组。 */
-export interface VfxVector3Like {
-  x: number;
-  y: number;
-  z: number;
-}
-
-export interface VfxSpawnTransform {
-  position?: Vector3;
-  /**
-   * 兼容别名:绕 Y 轴旋转(弧度)。
-   * 若同时给了 `rotation`,以 `rotation` 为准;否则回退到 `rotationY`。
-   */
-  rotationY?: number;
-  /** 完整欧拉角旋转(弧度);给了就覆盖 `rotationY`。 */
-  rotation?: VfxVector3Like;
-  /** 等比缩放(number)或三轴缩放;默认 1。 */
-  scale?: number | VfxVector3Like;
-  /** 挂载点节点;给了就把特效 root parent 到它(特效随之跟随)。 */
-  parent?: TransformNode;
-  /**
-   * position/rotation/scale 的坐标系解释:
-   * - 给了 `parent` 时默认 `true`:按相对 parent 的 **local** transform 解释;
-   * - 没给 `parent` 时默认 `false`:按 **世界坐标** 解释(保持现状行为)。
-   */
-  offsetIsLocal?: boolean;
-  renderingGroupId?: number;
-  /** 运行时外部信息(瞄准点/法线/端点/目标 mesh);值可为静态或 provider(动态每帧取)。 */
-  inputs?: VfxEffectInputs;
-}
-
-export interface VfxParamsFile {
-  schemaVersion: string;
-  effectId?: string;
-  updatedAt?: string | null;
-  params?: Partial<VfxParamValues>;
-}
-
-/**
- * 特效的放置本质(内禀标记)。决定系统/binding/面板怎么放它,不靠猜。见 docs/vfx-placement-design.md。
- * - 'socket' local:挂对象命名挂点、随它走(parent + follow)。
- * - 'world'  global:放世界某点、不跟随(fire-and-forget,可按法线定向)。
- * - 'screen' global:屏幕/相机层(后处理/相机扰动/DOM 全屏),无 3D transform。
- * - 'target' 改目标自身材质/渲染态,没有可 spawn 的 root。
- * - 'link'   连 ≥2 个端点(每帧重建几何),单 parent 表达不了。
- */
-export type VfxPlacement = 'socket' | 'world' | 'screen' | 'target' | 'link';
-
-export interface VfxEffectPackage<PParams extends VfxParamValues = VfxParamValues> {
-  id: string;
-  nameZh: string;
-  manifest?: VfxEffectManifest;
-  defaultParams: PParams;
-  debugAnchor?: VfxDebugAnchor;
-  spawnParams?: VfxSpawnParamKeys;
-  savedParams?: Partial<VfxParamValues>;
-  debugParams: VfxParamDefinition[];
-  /** 放置本质标记(默认 'world')。 */
-  placement?: VfxPlacement;
-  /** 声明**必需**的运行时 inputs(link 必须给 endpoints/aim、target 类必须给 target mesh);service 缺失时 warn。 */
-  requiredInputs?: VfxInputKey[];
-  /** 声明**可选**的运行时 inputs(给了就用、不给走默认,如定向武器的 aim:给了朝目标、不给走挂点朝向);不触发缺失 warn(G2)。 */
-  optionalInputs?: VfxInputKey[];
-  /**
-   * 几何空间:'local'=几何挂 root 子节点随它刚性变换;'world'=几何用世界坐标、root 仅作每帧采样源(拖尾)。
-   * 默认随 placement 推断('socket'→local,其余→world)。
-   */
-  geometrySpace?: 'local' | 'world';
-  /**
-   * 构建特效。**约定(G6):root 的 transform(position/rotation/scaling/parent)归 service 独占** ——
-   * service 在 create() 后会二次 `applySpawnToRoot` 覆盖,create 内写 `root.position/rotation/scaling` 会被静默清掉。
-   * 需要内部局部偏移(如抬升)请用 root 下的**子 TransformNode** 承载,或声明 `spawnParams.offsetY` 走 service 存活通道。
-   * 几何挂 root 子树即随挂载跟随;world/拖尾类几何走世界坐标、读 ctx.scale 缩放。
-   */
-  create(context: VfxEffectPackageContext<PParams>): VfxEffectHandle;
-}
-
-export type VfxDebugOverrides = Record<string, Partial<VfxParamValues>>;

package/tooling/check-dist-runtime.mjs

@@ -1,166 +0,0 @@
-#!/usr/bin/env node
-// 新增特效 guardrail · Layer 2(构建产物禁运行时扫描,见 issue #3,最强一层)。
-// `pnpm build` 之后扫 dist/,镜像消费方 Playable bundle 策略(lumber-order
-// scripts/check-playable-asset-bundle.mjs 的 forbiddenTokens),把"会坑消费方"的重运行时
-// 提前到库侧拦住 —— 即便它是被某个特效"间接"拉进来的(顺着 dist 的 chunk import 图归因到特效)。
-//
-// 用法:
-//   node tooling/check-dist-runtime.mjs              # 扫 dist/
-//   node tooling/check-dist-runtime.mjs --dist <dir> # 换扫描目录(回归 fixture 用)
-// 退出码:命中 → 1;干净 → 0。
-import { readdirSync, statSync, readFileSync, existsSync } from 'node:fs';
-import { resolve, dirname, join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const LIB_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const argv = process.argv.slice(2);
-const distArg = argv.indexOf('--dist') >= 0 ? argv[argv.indexOf('--dist') + 1] : undefined;
-const DIST = resolve(distArg ?? join(LIB_ROOT, 'dist'));
-
-// 精确 token —— 类名/扩展名/MIME,绝不用宽松子串(如 `basis` 会误报 RingBasis 变量)。
-// 与 lumber-order check-playable-asset-bundle.mjs 的 forbiddenTokens 对齐 + 补 draco/ktx2。
-const SUBSTRING_TOKENS = [
-  'EXT_meshopt_compression', 'MeshoptDecoder', 'meshopt_decoder',
-  'KHR_draco_mesh_compression', 'DracoCompression', 'DracoDecoder', 'draco_decoder', 'draco_wasm_wrapper',
-  'KHR_texture_basisu', 'KhronosTextureContainer2', '_KTX2Decoder', 'MSCTranscoder', 'basis_transcoder',
-  'application/x-glb-brotli', 'brotli-dec-wasm',
-  'application/wasm', 'data:application/wasm',
-  'WebAssembly.Module', 'WebAssembly.instantiate',
-];
-// `.wasm` 资源 URL:要求路径分隔符(/),只拦真资源路径如 "./decoder.wasm"/"chunks/x.wasm",
-// 不误报纯文件名字符串(错误消息 "physics.wasm" / debug 标签 "ringBurst.wasm" 无 /)。
-const WASM_URL_RE = /['"][^'"]*\/[^'"/]*\.wasm(\?[^'"]*)?['"]/;
-
-// 与 Layer 1 一致:扫描前剥注释(避免 dist 里残留的解释性注释/banner 误报)。
-function stripComments(src) {
-  return src.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(?<!:)\/\/[^\n]*/g, '');
-}
-
-function tokensIn(rawContent) {
-  const content = stripComments(rawContent);
-  const hits = [];
-  for (const t of SUBSTRING_TOKENS) if (content.includes(t)) hits.push(t);
-  const m = content.match(WASM_URL_RE);
-  if (m) hits.push(m[0]);
-  return hits;
-}
-
-// dist 模块文件:.js + .mjs/.cjs(防止重运行时藏在非 .js chunk 里绕过)。
-const DIST_MODULE_EXT = /\.(js|mjs|cjs)$/;
-function jsFilesIn(dir, out = []) {
-  if (!existsSync(dir)) return out;
-  for (const e of readdirSync(dir)) {
-    const p = join(dir, e);
-    const s = statSync(p);
-    if (s.isDirectory()) jsFilesIn(p, out);
-    else if (DIST_MODULE_EXT.test(e)) out.push(p);
-  }
-  return out;
-}
-
-// 解析一个 dist 模块的相对 import(构 chunk 依赖图;裸包如 @babylonjs/* 不进图)。
-function relImports(file) {
-  const src = readFileSync(file, 'utf8');
-  const specs = new Set();
-  let m;
-  const re = /\bfrom\s*['"]([^'"]+)['"]/g;
-  while ((m = re.exec(src))) specs.add(m[1]);
-  const side = /\bimport\s*['"]([^'"]+)['"]/g;
-  while ((m = side.exec(src))) specs.add(m[1]);
-  const dyn = /\bimport\(\s*['"]([^'"]+)['"]\s*\)/g;
-  while ((m = dyn.exec(src))) specs.add(m[1]);
-  const resolved = [];
-  for (const spec of specs) {
-    if (!spec.startsWith('.')) continue;
-    const target = resolve(dirname(file), spec);
-    const cands = [target, target + '.js', target + '.mjs', target + '.cjs',
-      join(target, 'index.js'), join(target, 'index.mjs'), join(target, 'index.cjs')];
-    for (const cand of cands) {
-      if (existsSync(cand) && statSync(cand).isFile()) { resolved.push(cand); break; }
-    }
-  }
-  return resolved;
-}
-
-// dist/<dir>/index.{js,mjs,cjs} 取第一个存在的入口。
-function indexEntry(dir) {
-  for (const ext of ['js', 'mjs', 'cjs']) {
-    const p = join(dir, `index.${ext}`);
-    if (existsSync(p)) return p;
-  }
-  return null;
-}
-
-function reachableFrom(entry, importGraph) {
-  const seen = new Set();
-  const stack = [entry];
-  while (stack.length) {
-    const f = stack.pop();
-    if (seen.has(f)) continue;
-    seen.add(f);
-    for (const dep of importGraph.get(f) ?? []) if (!seen.has(dep)) stack.push(dep);
-  }
-  return seen;
-}
-
-// ── 主流程 ────────────────────────────────────────────────────────────────────
-if (!existsSync(DIST)) {
-  console.error(`✗ dist 不存在:${DIST}(先 \`pnpm build\`)。`);
-  process.exit(1);
-}
-
-const allJs = jsFilesIn(DIST);
-const importGraph = new Map(allJs.map((f) => [f, relImports(f)]));
-const tokenByFile = new Map();
-for (const f of allJs) {
-  const hits = tokensIn(readFileSync(f, 'utf8'));
-  if (hits.length) tokenByFile.set(f, [...new Set(hits)]);
-}
-
-// 入口 = dist/index.{js,mjs,cjs}(runtime 核心)+ 每个 dist/effects/<id>/index.{js,mjs,cjs}。
-const entries = [];
-const rootIndex = indexEntry(DIST);
-if (rootIndex) entries.push({ label: 'runtime (index)', entry: rootIndex });
-const effectsDist = join(DIST, 'effects');
-if (existsSync(effectsDist)) {
-  for (const id of readdirSync(effectsDist)) {
-    const idx = indexEntry(join(effectsDist, id));
-    if (idx) entries.push({ label: id, entry: idx });
-  }
-}
-
-// 归因:每个入口 → 它可达的、命中 token 的文件。
-const findings = []; // {label, file, tokens}
-const attributedFiles = new Set();
-for (const { label, entry } of entries) {
-  const reach = reachableFrom(entry, importGraph);
-  for (const f of reach) {
-    if (tokenByFile.has(f)) {
-      attributedFiles.add(f);
-      findings.push({ label, file: f, tokens: tokenByFile.get(f) });
-    }
-  }
-}
-// 没被任何入口可达但仍命中的文件(孤儿,理论上不该有)。
-for (const [f, tokens] of tokenByFile) {
-  if (!attributedFiles.has(f)) findings.push({ label: '(未归因/孤儿 chunk)', file: f, tokens });
-}
-
-if (findings.length === 0) {
-  console.log(`✅ Layer 2 dist 禁运行时扫描通过:${allJs.length} 个 js,0 命中(无 meshopt/draco/ktx2/brotli/wasm 运行时)。`);
-  process.exit(0);
-}
-
-console.log(`❌ Layer 2 dist 禁运行时扫描:发现 ${findings.length} 处命中。\n`);
-// 按特效聚合展示
-const byLabel = {};
-for (const f of findings) (byLabel[f.label] ??= []).push(f);
-for (const [label, items] of Object.entries(byLabel)) {
-  console.log(`  特效/入口:${label}`);
-  for (const it of items) {
-    console.log(`    ✗ ${relative(DIST, it.file)}  ←  ${it.tokens.join(', ')}`);
-  }
-}
-console.log('\n修复:定位拉入该运行时的特效(多半是全量 glTF loader / 含 meshopt|draco|ktx2 的 GLB)。');
-console.log('  改用核心 loader、把 GLB 预解压成 plain、或用 ?url 内联的轻量资源。详见 Layer 1 提示与 #2 v0.1.1。');
-process.exit(1);

package/tooling/generate-index.mjs

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-// 生成顶层 index.json:扫 packages/effects/<id>/,汇总 id/nameZh/kind/category/tags/media。
-// 富检索字段(category/tags/media)优先取 description.json,避免与 manifest 双源。
-import { readdirSync, statSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
-import { resolve, dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const LIB_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const EFFECTS_DIR = join(LIB_ROOT, 'packages', 'effects');
-
-function readJsonSafe(p) {
-  try { return JSON.parse(readFileSync(p, 'utf8')); } catch { return null; }
-}
-
-const effects = [];
-for (const entry of readdirSync(EFFECTS_DIR)) {
-  const dir = join(EFFECTS_DIR, entry);
-  if (!statSync(dir).isDirectory()) continue;
-  const indexPath = join(dir, 'index.ts');
-  if (!existsSync(indexPath)) continue;
-
-  const effectJson = readJsonSafe(join(dir, 'effect.json')) ?? {};
-  const desc = readJsonSafe(join(dir, 'description.json')) ?? {};
-  const indexSrc = readFileSync(indexPath, 'utf8');
-  const kind = /createManifestRuntimeEffectPackage|createDataDrivenEffectPackage/.test(indexSrc) ? 'data' : 'code';
-
-  const mediaDir = join(dir, 'media');
-  const media = {};
-  if (existsSync(mediaDir)) {
-    for (const f of readdirSync(mediaDir)) {
-      if (/thumbnail/.test(f)) media.thumbnail = `packages/effects/${entry}/media/${f}`;
-      else if (/preview\.(mp4|webm|gif)$/.test(f)) media.preview = `packages/effects/${entry}/media/${f}`;
-    }
-  }
-
-  effects.push({
-    id: effectJson.id || entry,
-    dir: entry,
-    nameZh: effectJson.nameZh || desc.searchTitleZh || entry,
-    kind,
-    category: desc.semanticTags?.[0] || (effectJson.id?.split('.')[0]) || null,
-    tags: desc.searchKeywordsEn || desc.visualTags || effectJson.search?.tags || [],
-    media,
-    path: `packages/effects/${entry}`,
-  });
-}
-effects.sort((a, b) => a.id.localeCompare(b.id));
-
-const out = {
-  schemaVersion: 'vfx-index/1.0',
-  count: effects.length,
-  effects,
-};
-writeFileSync(join(LIB_ROOT, 'index.json'), JSON.stringify(out, null, 2) + '\n');
-console.log(`✅ index.json 生成:${effects.length} 个特效。`);