@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/scripts/formula-engine.js

@@ -0,0 +1,112 @@
+/**
+ * formula-engine.js —— 骨架数量公式的求值与区间查询（唯一真源）
+ *
+ * 为什么抽出来：
+ *   骨架校验器要按 formulas-skeleton.json 核对 quota 的取值区间；
+ *   导入阶段要从旧稿的实际规模**反推** quota，缺失项也要按同一套公式补齐。
+ *   两边各抄一份求值器的话，公式改了其中一边不会跟着改 ——
+ *   导入出来的 quota 会掉出校验器的合法区间，表现为"导入完立刻校验失败"，
+ *   而错误信息指向 quota，看不出是口径不一致。
+ *
+ * 公式里的变量（见 formulas-skeleton.json 的 variables）：
+ *   T  = capacity.target_chapters
+ *   V  = quota.volume_count
+ *   P  = quota.character_counts.protagonist
+ *   CS = quota.character_counts.core_supporting
+ *   CA = quota.character_counts.core_antagonist
+ *   BC = quota.branch_count
+ *   CC = quota.conflict_counts.core
+ *   n  = quota.faction_count（仅出现在 faction_relation_count 的公式文本里，
+ *        求值用的是 expr_low/expr_high，走的是 quota.faction_count）
+ */
+
+/**
+ * 求值一个公式表达式。
+ *
+ * 表达式里的字符先过一道白名单再交给 new Function ——
+ * 公式文件是仓库里的数据，但白名单能挡住"表达式里塞代码"这类事故。
+ *
+ * @param {string} expr 表达式（如 "Math.max(1, Math.ceil(T / 120))"）
+ * @param {Object} ctx 变量表
+ * @returns {number|boolean|string} 求值结果
+ */
+export function evalExpr(expr, ctx) {
+  if (typeof expr !== 'string' || expr.length === 0) throw new Error('表达式为空');
+  // P0-2：字符类加入 = < > ! & | ? :，以支持 === 和三元运算符
+  if (!/^[0-9a-zA-Z_.\[\]()+\-*/%,\s=<>!&|?:]+$/.test(expr)) throw new Error('表达式含非法字符: ' + expr);
+  const keys = Object.keys(ctx);
+  const fn = new Function(...keys, '"use strict"; return (' + expr + ');');
+  return fn(...keys.map(k => ctx[k]));
+}
+
+/**
+ * 造公式求值的变量表。
+ * @param {Object} frameworkData 框架.json 的内容
+ * @returns {Object} 变量表
+ */
+export function buildFormulaContext(frameworkData) {
+  const quota = (frameworkData && frameworkData.quota) || {};
+  const T = frameworkData && frameworkData.capacity ? frameworkData.capacity.target_chapters : undefined;
+  const V = quota.volume_count;
+  const P = quota.character_counts && quota.character_counts.protagonist;
+  const CS = quota.character_counts && quota.character_counts.core_supporting;
+  const CA = quota.character_counts && quota.character_counts.core_antagonist;
+  const BC = quota.branch_count;
+  const CC = quota.conflict_counts && quota.conflict_counts.core;
+  return { T, V, P, CS, CA, BC, CC, quota, Math };
+}
+
+/**
+ * 查某个 quota 字段的合法区间。
+ *
+ * @param {Object} formulas formulas-skeleton.json 的 formulas 段
+ * @param {string} quotaPath quota 字段路径（如 'quota.branch_count'）
+ * @param {Object} ctx 变量表
+ * @returns {{low:number, high:number}|null} 拿不到就返回 null
+ */
+export function formulaRange(formulas, quotaPath, ctx) {
+  if (!formulas) return null;
+  let spec = null;
+  for (const key of Object.keys(formulas)) {
+    const s = formulas[key];
+    if (s && s.applies_to_field === quotaPath) {
+      spec = s;
+      break;
+    }
+  }
+  if (!spec) return null;
+  try {
+    const low = evalExpr(spec.expr_low, ctx);
+    const high = evalExpr(spec.expr_high, ctx);
+    if (typeof low !== 'number' || typeof high !== 'number') return null;
+    if (!isFinite(low) || !isFinite(high)) return null;
+    return { low, high };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 取一个公式区间内的默认值。
+ *
+ * 取**下界**：导入的目标是"复现旧稿"，不是"造一本新书"。
+ * 旧稿推不出来的字段按下界填，配额就是"至少要这么多"，
+ * 后面由模型补齐；取上界会让导入后的待补清单大到没法用。
+ *
+ * **区间为空（下界 > 上界）时返回 null**：旧实现照样返回 low，
+ * 于是调用方拿着一个"根本不在合法区间里"的值继续算 ——
+ * 写进 derivations 就是 range_low > range_high，骨架报 DERIVATION_RANGE_MISMATCH
+ * （error），模型无论怎么改都没用，只能把重投次数耗尽。
+ * 空区间必须如实暴露，由调用方决定怎么办（2026-10-27 修）。
+ *
+ * @param {{low:number, high:number}|null} range
+ * @returns {number|null}
+ */
+export function defaultInRange(range) {
+  if (!range) return null;
+  const low = Math.round(range.low);
+  const high = Math.round(range.high);
+  if (low > high) return null;
+  if (low === high) return low;
+  return low;
+}