@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/deploy-manifest.js

@@ -0,0 +1,239 @@
+/**
+ * deploy-manifest.js —— 校验脚本的部署清单（自动推导）
+ *
+ * 为什么不能手写清单：
+ *   校验脚本之间会互相 import（graph-utils / content-quality / skeleton-quota …）。
+ *   手写清单只保证"入口文件被拷了"，不保证"它的依赖也被拷了"——
+ *   少拷一个文件，插件跑起来时校验脚本直接 ERR_MODULE_NOT_FOUND，
+ *   而且**部署阶段还看不出来**（清单里的文件都拷成功了）。
+ *
+ *   真实踩过的坑：把配额映射表抽成 skeleton-quota.js 之后，
+ *   skeleton-validate.js import 它，但清单没跟着加，
+ *   执行 skeleton 时报 "references/skeleton-quota.js is missing"。
+ *
+ * 所以这里的清单是**从 import 图推出来的**：入口校验脚本 → 递归收集所有
+ * 同目录的相对 import。新增共享模块不用改清单，少拷文件在部署时就会暴露。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 每个阶段的入口校验脚本。
+ *
+ * 阶段 → 入口文件（它的 import 闭包就是这一阶段要部署的全部脚本）
+ */
+export const PHASE_VALIDATOR_ENTRY = {
+  skeleton: 'skeleton-validate.js',
+  flesh: 'flesh-validate.js',
+  rhythm: 'rhythm-validate.js',
+  writing: 'writing-validate.js',
+  deslop: 'deslop-validate.js'
+};
+
+/**
+ * 每个阶段对应的提示词文件。
+ *
+ * 提示词里会直接让模型跑 `node references/xxx.js`，
+ * 那些脚本也必须部署 —— 这类依赖从 import 图里看不出来。
+ */
+export const PHASE_PROMPT_FILE = {
+  skeleton: '01-skeleton-prompt.md',
+  flesh: '02-flesh-prompt.md',
+  rhythm: '03-rhythm-prompt.md',
+  writing: '04-writing-prompt.md',
+  deslop: '05-deslop-prompt.md'
+};
+
+/**
+ * 从一段源码里抽出它引用的**同目录相对模块**。
+ *
+ * 覆盖四种写法：
+ *   import { A } from './x.js';
+ *   import X from './x.js';
+ *   import * as X from './x.js';
+ *   export { A } from './x.js';
+ * 以及无扩展名的 './x'（按 './x.js' 找，找不到再按 './x/index.js' 找）。
+ */
+export function localImportsOf(source) {
+  const out = new Set();
+  if (typeof source !== 'string') return out;
+  // import ... from '...' 与 export ... from '...'
+  const re = /\b(?:from|import)\s*['"](\.[^'"]+)['"]/g;
+  let m;
+  while ((m = re.exec(source)) !== null) {
+    out.add(m[1]);
+  }
+  return Array.from(out);
+}
+
+/**
+ * 解析一个相对引用在 scripts 目录下的实际文件名。
+ * @returns {string|null} 文件名（相对 scriptsDir）；解析不到返回 null
+ */
+function resolveLocalFile(spec, scriptsDir) {
+  const clean = spec.replace(/^\.\//, '');
+  const candidates = [];
+  if (path.extname(clean)) {
+    candidates.push(clean);
+  } else {
+    candidates.push(clean + '.js', path.join(clean, 'index.js'));
+  }
+  for (const c of candidates) {
+    const abs = path.join(scriptsDir, c);
+    if (fs.existsSync(abs) && fs.statSync(abs).isFile()) return c;
+  }
+  return null;
+}
+
+/**
+ * 求入口脚本的 import 闭包（要一起部署的文件名集合）。
+ *
+ * @param {string} entryFile 入口文件名（如 'skeleton-validate.js'）
+ * @param {string} scriptsDir 脚本目录（插件的 scripts/）
+ * @returns {{files:string[], missing:string[]}}
+ *   files —— 必须一起部署的文件名（含入口）
+ *   missing —— import 了但磁盘上找不到的文件（空数组才健康）
+ */
+export function resolveScriptDeps(entryFile, scriptsDir) {
+  const files = [];
+  const missing = [];
+  const seen = new Set();
+  const queue = [entryFile];
+
+  while (queue.length) {
+    const name = queue.shift();
+    if (!name || seen.has(name)) continue;
+    seen.add(name);
+
+    const abs = path.join(scriptsDir, name);
+    let source;
+    try {
+      source = fs.readFileSync(abs, 'utf-8');
+    } catch {
+      missing.push(name);
+      continue;
+    }
+    files.push(name);
+
+    for (const spec of localImportsOf(source)) {
+      const resolved = resolveLocalFile(spec, scriptsDir);
+      if (!resolved) {
+        // 引用了但找不到：记下来，别当成"不需要部署"
+        missing.push(spec);
+        continue;
+      }
+      if (!seen.has(resolved)) queue.push(resolved);
+    }
+  }
+
+  return { files, missing };
+}
+
+/**
+ * 扫出提示词里让模型直接跑的脚本（`node references/xxx.js`）。
+ *
+ * 这类依赖从 import 图里看不出来，但缺了模型就调不到工具。
+ * 例如血肉 / 节奏提示词让模型用 upstream-query.js 查上游实体。
+ *
+ * @param {string} promptText 提示词正文
+ * @returns {string[]} 脚本文件名
+ */
+export function promptToolScripts(promptText) {
+  const out = new Set();
+  if (typeof promptText !== 'string') return [];
+  const re = /node\s+references\/([A-Za-z0-9._-]+\.js)/g;
+  let m;
+  while ((m = re.exec(promptText)) !== null) {
+    out.add(m[1]);
+  }
+  return Array.from(out);
+}
+
+/**
+ * 全局工具脚本：references/index.md 里教用户怎么跑、但不是任何校验脚本依赖的脚本。
+ *
+ * 例如 check-guide-compliance.js —— 它审计指导文件，不参与校验，
+ * 但 index.md 随 references/ 一起部署，里面教着
+ * `node references/check-guide-compliance.js --dir=references/骨架指导`，
+ * 脚本不在就等于教了一条跑不通的命令。
+ *
+ * @param {string} refsDir 插件的 references/ 目录
+ * @returns {string[]} 脚本文件名
+ */
+export function globalToolScripts(refsDir) {
+  let text = '';
+  try {
+    text = fs.readFileSync(path.join(refsDir, 'index.md'), 'utf-8');
+  } catch {
+    return [];
+  }
+  const entries = Object.keys(PHASE_VALIDATOR_ENTRY).map((k) => PHASE_VALIDATOR_ENTRY[k]);
+  const out = new Set();
+  for (const name of promptToolScripts(text)) {
+    // 各阶段的入口校验脚本由阶段自己部署，不算全局工具
+    if (entries.indexOf(name) >= 0) continue;
+    out.add(name);
+  }
+  return Array.from(out);
+}
+
+/**
+ * 某阶段要部署的全部脚本文件。
+ *
+ * 三类依赖合并：
+ *   1. 入口校验脚本的 import 闭包
+ *   2. 该阶段提示词里让模型直接跑的脚本
+ *   3. references/index.md 里教的全局工具脚本
+ *
+ * @param {string} phase 阶段名（skeleton / flesh / rhythm / writing）
+ * @param {string} scriptsDir 脚本目录
+ * @param {string} [promptsDir] 提示词目录（给了才算第二类依赖）
+ * @param {string} [refsDir] references 目录（给了才算第三类依赖）
+ * @returns {{files:string[], missing:string[]}|null}
+ *   null = 该阶段不需要部署校验脚本（wiki / analyze）
+ */
+export function phaseScriptFiles(phase, scriptsDir, promptsDir, refsDir) {
+  const entry = PHASE_VALIDATOR_ENTRY[phase];
+  if (!entry) return null;
+
+  const files = new Set();
+  const missing = [];
+
+  // 1. import 闭包
+  const deps = resolveScriptDeps(entry, scriptsDir);
+  for (const f of deps.files) files.add(f);
+  for (const m of deps.missing) missing.push(m);
+
+  // 2. 提示词里让模型直接跑的工具脚本
+  const promptFile = PHASE_PROMPT_FILE[phase];
+  if (promptsDir && promptFile) {
+    let text = '';
+    try {
+      text = fs.readFileSync(path.join(promptsDir, promptFile), 'utf-8');
+    } catch {
+      text = '';
+    }
+    for (const name of promptToolScripts(text)) {
+      const src = path.join(scriptsDir, name);
+      if (!fs.existsSync(src)) {
+        missing.push(name + '（提示词 ' + promptFile + ' 里引用，但 scripts/ 下没有）');
+        continue;
+      }
+      files.add(name);
+    }
+  }
+
+  // 3. 全局工具脚本
+  if (refsDir) {
+    for (const name of globalToolScripts(refsDir)) {
+      const src = path.join(scriptsDir, name);
+      if (!fs.existsSync(src)) {
+        missing.push(name + '（references/index.md 里引用，但 scripts/ 下没有）');
+        continue;
+      }
+      files.add(name);
+    }
+  }
+
+  return { files: Array.from(files).sort(), missing };
+}