@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-scan/templates.js

@@ -0,0 +1,295 @@
+/**
+ * scan 模板 — 仅 fancy-scan 使用
+ */
+
+import { SCAN_MODE_API, SCAN_MODE_OCR } from '#scraper-utils';
+
+// ---------------------------------------------------------------------------
+// 共享常量
+// ---------------------------------------------------------------------------
+
+export const PLATFORM_TABLE = [
+  ['1', 'qidian',  '起点'],
+  ['2', 'fanqie',  '番茄'],
+  ['3', 'jinjiang','晋江'],
+  ['4', 'qimao',   '七猫'],
+];
+
+// 各平台的榜单配置（与 /home/cloud/dsh-fancy-webnovel/commands/scan/platforms/ 保持一致）
+export const RANK_LISTS = {
+  qidian: [
+    { id: 'hotsales',   label: '畅销榜' },
+    { id: 'yuepiao',   label: '月票榜' },
+    { id: 'readindex', label: '阅读榜' },
+    { id: 'newfans',   label: '书友榜' },
+    { id: 'rec',       label: '推荐榜' },
+    { id: 'update',    label: '更新榜' },
+    { id: 'sign',      label: '签约榜' },
+    { id: 'newbook',   label: '新书榜' },
+    { id: 'newauthor', label: '新人作者榜' },
+  ],
+  fanqie: [
+    { id: '1_2', label: '男频阅读榜' },
+    { id: '1_1', label: '男频新书榜' },
+    { id: '0_2', label: '女频阅读榜' },
+    { id: '0_1', label: '女频新书榜' },
+  ],
+  jinjiang: [
+    { id: '5',  label: '月榜' },
+    { id: '7',  label: '总分榜' },
+    { id: '4',  label: '季度榜' },
+    { id: '3',  label: '新晋作者榜' },
+  ],
+  qimao: [
+    { id: 'boy/hot/month',  label: '男生大热月榜' },
+    { id: 'boy/new/month',  label: '男生新书月榜' },
+    { id: 'girl/hot/month', label: '女生大热月榜' },
+    { id: 'girl/new/month', label: '女生新书月榜' },
+  ],
+};
+
+export function platformLabel(platform) {
+  const row = PLATFORM_TABLE.find(r => r[1] === platform);
+  return row ? row[2] : platform;
+}
+
+/**
+ * 各平台的扫描方式选项（UI 层）。
+ *
+ * 目前只有番茄有两条取数路径：
+ *   api —— 走番茄自家明文接口 /api/book/info 拿书名/作者/简介；
+ *   ocr —— 渲染后截图 + tesseract 识别。
+ *
+ * 两条路径的利弊直接写进 description：用户在提问面板上就能看到
+ * "精度/耗时" 与 "是否依赖番茄内部接口" 的取舍，不必先跑一次才知道。
+ */
+export const SCAN_MODE_OPTIONS = {
+  fanqie: [
+    {
+      id: SCAN_MODE_API,
+      label: 'API扫描（默认）',
+      description:
+        '优势：书名/作者/简介取自番茄明文接口，零识别误差、精度 100%，整榜耗时约为 OCR 扫描的 1/5；' +
+        '劣势：依赖番茄 /api/book/info 接口，该接口若变更或临时不可用时，简介会缺失',
+    },
+    {
+      id: SCAN_MODE_OCR,
+      label: 'OCR扫描',
+      description:
+        '优势：渲染后截图识别，不依赖番茄内部接口，接口失效也能采到；' +
+        '劣势：每本约 0.5 秒且存在认字误差（实测简介字符错误率 8%~17%），整榜耗时约为 API 扫描的 5 倍',
+    },
+  ],
+};
+
+/**
+ * 扫描方式 id → 展示用名称（去掉"（默认）"后缀，只在结果回执里展示）。
+ */
+export function scanModeLabel(mode) {
+  const hit = (SCAN_MODE_OPTIONS.fanqie || []).find(m => m.id === mode);
+  return hit ? hit.label.replace(/（默认）$/, '') : String(mode || '');
+}
+
+/**
+ * 把 DSH 回传的 label 解析成扫描方式 id。
+ *
+ * DSH 的 selected 回传的是 label 字符串（options.value 会被运行时静默忽略），
+ * 所以只能按 label 的字母前缀判断 —— 不能依赖 label 里带 id。
+ * 解析不出合法 id 时返回 null，由调用方按"无效选择"处理。
+ */
+export function parseScanMode(selected) {
+  const s = String(selected == null ? '' : selected).trim();
+  if (!s) return null;
+  const upper = s.toUpperCase();
+  if (upper.startsWith('API')) return SCAN_MODE_API;
+  if (upper.startsWith('OCR')) return SCAN_MODE_OCR;
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// 模板
+// ---------------------------------------------------------------------------
+
+export const scan = {
+  platformList() {
+    return (
+      '📋 支持的平台：\n' +
+      PLATFORM_TABLE.map(r => `  ${r[0]}. ${r[2]}`).join('\n')
+    );
+  },
+
+  askPlatform() {
+    return {
+      id: 'platform',
+      question: '📋 请选择要扫的平台：',
+      // DSH 的 AskUserQuestionOption 只有 label / description 两个合法字段，
+      // selected 回传的是 label；value 传了会被运行时静默忽略。
+      options: PLATFORM_TABLE.map(r => ({ label: r[2], description: '' })),
+    };
+  },
+
+  askRankLists(platform) {
+    const lists = RANK_LISTS[platform] || [];
+    const pLabel = platformLabel(platform);
+    const isFanqie = platform === 'fanqie';
+    const hint = isFanqie ? '绕过番茄平台反爬机制较耗时，最好每次选择一个榜单' : '';
+    const question = hint
+      ? `📋 ${pLabel} 榜单（可多选，但是${hint}）：`
+      : `📋 ${pLabel} 榜单（可多选）：`;
+    return {
+      id: 'ranklists',
+      question,
+      multiSelect: true,
+      options: [
+        ...lists.map(r => ({ label: r.label, description: '' })),
+        { label: '全选', description: '采集所有榜单' },
+      ],
+    };
+  },
+
+  /**
+   * 扫描方式选择（榜单选定之后问）。
+   *
+   * 只有番茄有两条取数路径；其他平台返回 null —— 调用方据此跳过这一步，
+   * 不会给用户抛一个只有一项的假选择。
+   */
+  askScanMode(platform) {
+    const modes = SCAN_MODE_OPTIONS[platform];
+    if (!modes || !modes.length) return null;
+    return {
+      id: 'scanmode',
+      question:
+        `📋 ${platformLabel(platform)}扫描方式：\n` +
+        '推荐使用API扫描，如果扫描结果不理想，请再次执行fancy-scan并使用OCR扫描',
+      options: modes.map(m => ({ label: m.label, description: m.description })),
+    };
+  },
+
+  notify({ type, files, topicFile, projectRoot, err, failedRanks, scanMode, detail }) {
+    switch (type) {
+      case 'not_initialized':
+        return '⚠️ 当前目录尚未初始化，请先运行 /fancy-bootstrap 进行初始化。';
+
+      case 'invalid_choice':
+        return '❌ 无效选择，请输入 1-4 的编号。';
+
+      case 'invalid_scan_mode':
+        return '❌ 无效的扫描方式选择，请重新运行 /fancy-scan。';
+
+      case 'cancelled':
+        return '🚫 已取消';
+
+      case 'no_provider':
+        return '⚠️ 当前环境不支持交互式提问。请在 dsh-tui 中运行此命令，或确保 web UI 已正确加载交互组件。';
+
+      case 'no_project_root':
+        return '❌ 无法确定项目目录：' + (err || '会话未提供 cwd') + '。请在项目目录下运行该命令。';
+
+      case 'ask_failed':
+        return '❌ 提问失败：' + (err || '未知错误');
+
+      case 'cancelled_with_hint':
+        return '⚠️ 已取消。请再次调用 /fancy-scan 继续。';
+
+      case 'failed':
+        return '❌ 采集失败：' + err;
+
+      case 'scraper_failed':
+        return '❌ ' + err;
+
+      case 'no_rank_selected':
+        return '❌ 未选中任何榜单，无法开始采集。';
+
+      case 'llm_delivery_failed':
+        return '❌ 采集已完成，但提示词投递给 LLM 失败：' + (err || '未知错误') +
+          '\n已采集的数据保留在 扫榜结果/ 下，请重新运行 /fancy-scan 以触发分析。';
+
+      case 'phase_advance_failed':
+        // 采集成功但 phase 推不动 = 整个流程卡住：
+        // 下游 /fancy-topic 要求 phase === 'scanned'，推不动就永远过不了。
+        // 之前这个失败只写进 run-scan.js 的 stderr，用户只看到"采集完成"，
+        // 接着跑 /fancy-topic 报"状态文件读不了"，完全不知道问题出在这儿。
+        return '❌ 采集已完成，但 .fancy-deployed 的 phase 没能推进到 scanned，流程走不下去。\n' +
+          `原因：${err || '未知原因'}\n\n` +
+          '📁 已采集的数据保留在 扫榜结果/ 下，修好状态文件后重跑 /fancy-scan 即可。\n\n' +
+          (detail || '');
+
+      case 'handover': {
+        // 部分榜单失败时必须显式列出：此前直接中断整个命令，
+        // 已采集成功的榜单产物被丢弃，用户既不知道采到了什么，也拿不到文件。
+        const failed = (failedRanks || []).length
+          ? '\n⚠️ 以下榜单存在采集问题：' +
+            failedRanks.map(f => f.label + '（' + f.error + '）').join('；')
+          : '';
+        const modeLine = scanMode
+          ? `\n🔍 扫描方式：${scanModeLabel(scanMode)}`
+          : '';
+        return (
+          `📊 采集完成，正在将数据交给 LLM 进行分析...` +
+          modeLine +
+          `\n📁 生成文件：\n${(files || []).map(f => '- ' + f.replace(projectRoot + '/', '')).join('\n')}\n` +
+          `💡 分析报告将写入：${(topicFile || '').replace(projectRoot + '/', '')}\n` +
+          `⏳ LLM 完成后会写入上述 topic_decision 文件，届时可执行 /fancy-topic` +
+          failed
+        );
+      }
+
+      default:
+        return String(type);
+    }
+  },
+
+  llmAnalysisPrompt({ platform, rankLists, date, files, topicFile, projectRoot }) {
+    const pLabel = platformLabel(platform);
+    const listsStr = rankLists ? rankLists.join('、') : '全选';
+    const fileList = (files || [])
+      .map(f => '- `' + f.replace(projectRoot + '/', '') + '`')
+      .join('\n');
+
+    return [
+      `## 扫榜数据分析任务`,
+      ``,
+      `平台：${pLabel}`,
+      `榜单：${listsStr}`,
+      `时间：${date || ''}`,
+      ``,
+      `已生成的文件：`,
+      fileList,
+      ``,
+      `请执行以下步骤：`,
+      `1. 读取上述生成的**最新**数据文件，**必须**忽略旧文件和对话历史上下文`,
+      `2. 分析爆款书籍的题材、卖点、节奏、人设等特征`,
+      `3. 生成扫榜报告（包含：市场趋势、热门题材分析、用户画像、竞争度评估）`,
+      `4. 给出 3-5 个可行的选题方向建议。为每个方向设计金手指、核心设定、爽点模式、情绪价值曲线、开篇切入点、故事节奏规划、人物设定框架、差异化竞争策略等一系列要素`,
+      `5. 首先检查 \`${topicFile}\` 是否存在。如果该文件不存在则**必须**新建此文件（只新建空文件，不要写内容，也不要写标题）；文件存在后就直接进入第 6 条的四步，把本次分析报告**追加**写入`,
+      ``,
+      `6. 追加写入的四步，严格按顺序做：`,
+
+      `- **第一步**：确认 \`${topicFile}\` 这个文件在不在。不在就**先新建一个空文件**（只创建，不要写内容，也不要写标题）`,
+      `- **第二步**：把本次分析报告**追加**到该文件的**末尾**。是追加（append），**不是覆盖**（覆盖会把之前其它平台的分析抹掉）`,
+      `- **第三步**：追加的内容按下面 start/end 标记的格式写`,
+      `- **第四步**：写完后**把文件读回来**确认 start 和 end 标记都写进去了（两个都要有，只写一个会导致平台数据串台）`,
+      ``,
+      `追加写入时，**必须**用下面这样的 start/end 标记把本次内容与之前的内容隔开（**两个标记都要写**，只写一个会导致平台数据串台）。下面是**格式模板**，请严格照抄标记行的写法：`,
+      ``,
+      `\`\`\``,
+      `# ${pLabel}-${listsStr}-${date || ''}-start`,
+      `（本次分析报告正文，从"一、市场趋势"重新编号）`,
+      `# ${pLabel}-${listsStr}-${date || ''}-end`,
+      `\`\`\``,
+      ``,
+      `标记要求：`,
+      `- 上面代码块只是**格式展示**：写入文件时**只写标记行本身**，不要把代码块的 \`\`\` 围栏一起写进文件`,
+      `- start 与 end 必须**成对出现**，两个标记行都要**独占一行**，行首不要加任何其它文字`,
+      `- 两个标记之间**只放本次平台**的分析内容，不要混入其它平台的内容`,
+      `- 标记里的平台名、榜单名、日期必须与上面写的完全一致（本次是：${pLabel}-${listsStr}-${date || ''}）`,
+      `- 本次追加写入的分析报告内容要**重新开始编号**（从"一、"重新数）`,
+      `- 标记行**不要**加粗、**不要**缩进、**不要**带任何 markdown 装饰符号`,
+      ``,
+      `报告要求：`,
+      `- 客观分析数据，不臆测`,
+      `- 选题建议要有差异化竞争力`,
+      `- 报告语言：中文`,
+    ].join('\n');
+  },
+};

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 };
+}