@cloud411716/fancy-webnovel 0.1.31 → 0.1.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloud411716/fancy-webnovel",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "type": "module",
   "main": "plugins/fancy-bootstrap/index.js",
   "exports": {

package/plugins/fancy-bootstrap/registry.js

@@ -1,56 +1,30 @@
 /**
  * registry.js — 合并注册所有命令
  * fancy-bootstrap + fancy-scan
+ *
+ * 所有消息模板 → scripts/templates.js
+ * 所有基础设施 → scripts/infra.js
  */
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { existsSync } from 'fs';
+import { notify, llmFollowup, spawnScript } from './scripts/infra.js';
+import { scan, bootstrap, PLATFORM_TABLE, platformLabel } from './scripts/templates.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
+const SCRIPTS_DIR = join(__dirname, 'scripts');
 
 // ---------------------------------------------------------------------------
-// fancy-bootstrap
+// 路径工具
 // ---------------------------------------------------------------------------
-const BOOTSTRAP_DIR = __dirname; // registry.js is inside plugins/fancy-bootstrap/
-const BOOTSTRAP_SCRIPTS_DIR = join(BOOTSTRAP_DIR, 'scripts');
-
-function notifyBootstrap(session, text) {
-  queueMicrotask(() => {
-    session.append(
-      'user/message',
-      { content: [{ type: 'text', text }], source: { kind: 'user' } },
-      { surfaceOp: 'append' }
-    );
-  });
-}
 
 function isValidPath(p) {
-  return !p.includes('..') && !/[<>:"|?*[\x00-\x1f]/.test(p) && !/\s/.test(p);
+  return !p.includes('..') && !/[<>:"'|?*[\x00-\x1f]/.test(p) && !/\s/.test(p);
 }
 
-function runBootstrapScript(projectRoot) {
-  return new Promise(async (resolve) => {
-    const initScript = join(BOOTSTRAP_SCRIPTS_DIR, 'init.js');
-    const { spawn } = await import('child_process');
-    const proc = spawn(
-      'node', [initScript, projectRoot],
-      { timeout: 30000, stdio: ['ignore', 'pipe', 'pipe'] }
-    );
-    const outParts = [], errParts = [];
-    proc.stdout.on('data', (d) => { outParts.push(d.toString()); });
-    proc.stderr.on('data', (d) => { errParts.push(d.toString()); });
-    proc.on('close', (code) => {
-      const stdout = outParts.join(''), stderr = errParts.join('');
-      try {
-        const parsed = JSON.parse(stdout);
-        resolve({ ok: parsed.ok === true, output: stdout, error: parsed.error || stderr || undefined });
-      } catch (_) {
-        resolve({ ok: false, output: stdout, error: stderr || ('exit ' + code) });
-      }
-    });
-    proc.on('error', (err) => resolve({ ok: false, output: '', error: err.message }));
-  });
-}
+// ---------------------------------------------------------------------------
+// fancy-bootstrap
+// ---------------------------------------------------------------------------
 
 async function applyBootstrap(ctx) {
   ctx.commands.register({
@@ -61,65 +35,61 @@ async function applyBootstrap(ctx) {
       const rawInput = invocation.rawInput ? invocation.rawInput.trim() : '';
 
       let projectRoot = rawInput;
+
+      // 无参数 → 弹窗
       if (!projectRoot) {
         const result = await ctx.userQuestions.ask({
-          questions: [{
-            id: 'path',
-            question: '📂 请输入项目根路径 ( 或者输入 . 代表当前路径 )',
-          }],
+          questions: [bootstrap.askPath()],
         });
-        projectRoot = result.answers[0]?.custom ? result.answers[0].custom.trim() : '';
+        projectRoot = result.answers[0]?.custom?.trim() || '';
       }
 
       if (!projectRoot) {
-        notifyBootstrap(session, '⚠️ 未提供路径，已取消');
+        notify(session, bootstrap.notify({ type: 'no_path' }));
         return { kind: 'success', text: '' };
       }
 
       if (projectRoot === '.') {
         projectRoot = process.cwd();
-        notifyBootstrap(session, `📂 使用当前目录：${projectRoot}`);
+        notify(session, bootstrap.notify({ type: 'using_cwd', projectRoot }));
       }
 
-      if (projectRoot.includes('..') || /[<>:"'|?*[\x00-\x1f]/.test(projectRoot) || /\s/.test(projectRoot)) {
-        notifyBootstrap(session, '❌ 路径不合法（不能含空格、.. 或特殊字符）');
+      if (!isValidPath(projectRoot)) {
+        notify(session, bootstrap.notify({ type: 'invalid_path' }));
         return { kind: 'success', text: '' };
       }
 
       if (existsSync(join(projectRoot, '.fancy-deployed'))) {
-        notifyBootstrap(session, '⚠️ 该目录已初始化（.fancy-deployed 已存在）');
+        notify(session, bootstrap.notify({ type: 'already_initialized' }));
         return { kind: 'success', text: '' };
       }
 
       const confirm = await ctx.userQuestions.ask({
         questions: [{
           id: 'confirm',
-          question: '❓ 确认将以下路径作为项目根？',
+          question: bootstrap.notify({ type: 'confirm', projectRoot }),
           detail: projectRoot,
           hideCustomInput: true,
-          options: [
-            { label: '确认创建', description: '开始在此目录初始化项目' },
-            { label: '取消', description: '取消本次操作' },
-          ],
+          options: bootstrap.confirmOptions(),
         }],
       });
       const ans = confirm.answers[0];
       const chosen = ans?.selected?.[0] ?? ans?.custom;
       if (chosen !== '确认创建') {
-        notifyBootstrap(session, '🚫 已取消');
+        notify(session, bootstrap.notify({ type: 'cancelled' }));
         return { kind: 'success', text: '' };
       }
 
-      notifyBootstrap(session, `⏳ 正在初始化 ${projectRoot}...`);
-      const result = await runBootstrapScript(projectRoot);
+      notify(session, bootstrap.notify({ type: 'initializing', projectRoot }));
+      const result = await spawnScript('node', [join(SCRIPTS_DIR, 'init.js'), projectRoot], { timeout: 30000 });
 
       if (result.ok) {
-        notifyBootstrap(session, '✅ 项目初始化完成！\n下一步：运行 /fancy-scan 扫榜');
+        notify(session, bootstrap.notify({ type: 'success' }));
       } else {
-        const errMsg = (typeof result.error === 'object' && result.error !== null)
+        const err = (typeof result.error === 'object' && result.error !== null)
           ? (result.error.message || JSON.stringify(result.error))
           : String(result.error || '未知错误');
-        notifyBootstrap(session, '❌ 初始化失败：' + errMsg);
+        notify(session, bootstrap.notify({ type: 'error', err }));
       }
 
       return { kind: 'success', text: '' };
@@ -130,56 +100,6 @@ async function applyBootstrap(ctx) {
 // ---------------------------------------------------------------------------
 // fancy-scan
 // ---------------------------------------------------------------------------
-const SCAN_DIR = join(dirname(__dirname), 'fancy-scan'); // from plugins/fancy-bootstrap/ up to plugins/, then fancy-scan
-const SCAN_SCRIPTS_DIR = join(SCAN_DIR, 'scripts');
-
-const PLATFORM_TABLE = [
-  ['1', 'qidian',   '长篇', '起点'],
-  ['2', 'fanqie',   '长篇', '番茄'],
-  ['3', 'jinjiang', '长篇', '晋江'],
-  ['4', 'zhihu',    '长/短','知乎'],
-  ['5', 'dianzhong','短篇','点众'],
-  ['6', 'qimao',    '长/短','七猫'],
-];
-
-function platformLabel(platform) {
-  const row = PLATFORM_TABLE.find(r => r[1] === platform);
-  return row ? row[3] : platform;
-}
-
-function notifyScan(session, text) {
-  queueMicrotask(() => {
-    session.append(
-      'user/message',
-      { content: [{ type: 'text', text }], source: { kind: 'user' } },
-      { surfaceOp: 'append' }
-    );
-  });
-}
-
-function runScanScript(projectRoot, platform, length) {
-  return new Promise(async (resolve) => {
-    const scriptPath = join(SCAN_SCRIPTS_DIR, 'run-scan.js');
-    const { spawn } = await import('child_process');
-    const proc = spawn(
-      'node', [scriptPath, '--project-root', projectRoot, '--platform', platform, '--length', length],
-      { timeout: 120000, stdio: ['ignore', 'pipe', 'pipe'] }
-    );
-    const outParts = [], errParts = [];
-    proc.stdout.on('data', (d) => { outParts.push(d.toString()); });
-    proc.stderr.on('data', (d) => { errParts.push(d.toString()); });
-    proc.on('close', (code) => {
-      const stdout = outParts.join(''), stderr = errParts.join('');
-      try {
-        const parsed = JSON.parse(stdout);
-        resolve({ ok: parsed.ok === true, output: stdout, error: parsed.error ? (parsed.error.message || JSON.stringify(parsed.error)) : stderr || undefined });
-      } catch (_) {
-        resolve({ ok: false, output: stdout, error: stderr || ('exit ' + code) });
-      }
-    });
-    proc.on('error', (err) => resolve({ ok: false, output: '', error: err.message }));
-  });
-}
 
 async function applyScan(ctx) {
   ctx.commands.register({
@@ -194,7 +114,7 @@ async function applyScan(ctx) {
       if (!projectRoot) projectRoot = process.cwd();
 
       if (!existsSync(join(projectRoot, '.fancy-deployed'))) {
-        notifyScan(session, '⚠️ 当前目录尚未初始化。请先运行 /fancy-bootstrap 进行初始化。');
+        notify(session, scan.notify({ type: 'not_initialized' }));
         return { kind: 'success', text: '' };
       }
 
@@ -218,46 +138,39 @@ async function applyScan(ctx) {
         }
       }
 
+      // 参数不全 → 弹窗选择
       if (!platform || !length || !PLATFORM_TABLE.find(r => r[1] === platform)) {
-        notifyScan(session, '📋 支持的平台：\n' +
-          PLATFORM_TABLE.map(r => `  ${r[0]}. ${r[3]}（${r[2]}）`).join('\n') +
-          '\n\n- 长篇：关注 追读、月票、订阅 等指标\n- 短篇：关注 传播、完读率 等指标\n- 知乎和七猫同时支持长篇和短篇');
+        notify(session, scan.platformList());
 
         const choice = await ctx.userQuestions.ask({
-          questions: [{ id: 'platform', question: '📊 请选择要扫的平台（输入编号 1-6）：' }],
+          questions: [scan.askPlatform()],
         });
         const answer = choice.answers[0]?.custom?.trim();
         if (!answer) {
-          notifyScan(session, '⚠️ 已取消。请再次调用 /fancy-scan 继续。');
+          notify(session, scan.notify({ type: 'cancelled_with_hint' }));
           return { kind: 'success', text: '' };
         }
         const numMatch = answer.match(/^(\d+)$/);
         const row = numMatch ? PLATFORM_TABLE.find(r => r[0] === numMatch[1]) : null;
         if (!row) {
-          notifyScan(session, '❌ 无效选择，请输入 1-6 的编号。');
+          notify(session, scan.notify({ type: 'invalid_choice' }));
           return { kind: 'success', text: '' };
         }
         platform = row[1];
-        length = (platform === 'zhihu' || platform === 'qimao') ? null : (row[2] === '长篇' ? 'long' : 'short');
+        length = (platform === 'zhihu' || platform === 'qimao')
+          ? null
+          : (row[2] === '长篇' ? 'long' : 'short');
       }
 
       // 知乎/七猫二次选择篇幅
       if (platform === 'zhihu' || platform === 'qimao') {
         if (!length || !['long', 'short'].includes(length)) {
           const lenResult = await ctx.userQuestions.ask({
-            questions: [{
-              id: 'length',
-              question: `${platformLabel(platform)} 同时支持长篇和短篇，请选择：`,
-              hideCustomInput: true,
-              options: [
-                { label: '长篇', description: '' },
-                { label: '短篇', description: '' },
-              ],
-            }],
+            questions: [scan.askLength(platform)],
           });
           const lenAnswer = lenResult.answers[0]?.selected?.[0] ?? lenResult.answers[0]?.custom;
           if (!lenAnswer || lenAnswer === '取消') {
-            notifyScan(session, '🚫 已取消');
+            notify(session, scan.notify({ type: 'cancelled' }));
             return { kind: 'success', text: '' };
           }
           length = (lenAnswer === '长篇') ? 'long' : 'short';
@@ -266,56 +179,44 @@ async function applyScan(ctx) {
         length = 'long';
       }
 
-      notifyScan(session, `⏳ 正在采集 ${platformLabel(platform)}（${length === 'long' ? '长篇' : '短篇'}）...`);
+      notify(session, scan.notify({ type: 'collecting', platform, length }));
 
-      const result = await runScanScript(projectRoot, platform, length);
+      const scriptResult = await spawnScript(
+        'node',
+        [join(SCRIPTS_DIR, '..', 'fancy-scan', 'scripts', 'run-scan.js'),
+         '--project-root', projectRoot, '--platform', platform, '--length', length],
+        { timeout: 120000 }
+      );
 
-      if (!result.ok) {
-        const errMsg = (typeof result.error === 'object' && result.error !== null)
-          ? (result.error.message || JSON.stringify(result.error))
-          : String(result.error || '未知错误');
-        notifyScan(session, '❌ 采集失败：' + errMsg);
+      if (!scriptResult.ok) {
+        const err = (typeof scriptResult.error === 'object' && scriptResult.error !== null)
+          ? (scriptResult.error.message || JSON.stringify(scriptResult.error))
+          : String(scriptResult.error || '未知错误');
+        notify(session, scan.notify({ type: 'failed', err }));
         return { kind: 'success', text: '' };
       }
 
-      // Step 7: 解析 receipt，发送分析任务给 LLM
+      // 解析 receipt
       let receipt;
-      try { receipt = JSON.parse(result.output); } catch (_) {
-        notifyScan(session, '❌ 采集结果解析失败');
+      try { receipt = JSON.parse(scriptResult.output); } catch (_) {
+        notify(session, scan.notify({ type: 'parse_error' }));
         return { kind: 'success', text: '' };
       }
 
       const files = receipt.scan_files || [];
-      const reportFile = receipt.report_file || '';
       const topicFile = receipt.topic_decision || '';
-      const fileList = files.map(f => '- ' + f.replace(projectRoot + '/', '')).join('\n');
-
-      // Step 8-9: 通知 LLM 执行分析
-      notifyScan(session,
-        `📊 采集完成，正在将数据交给 LLM 进行分析...\n` +
-        `📁 生成文件：\n${fileList}\n` +
-        `📄 报告：${reportFile.replace(projectRoot + '/', '')}\n` +
-        `💡 分析报告将写入：${topicFile.replace(projectRoot + '/', '')}`
-      );
 
-      // 发消息给 LLM，让它读取原始文件并生成分析
-      const analysisPrompt =
-        `## 扫榜数据分析任务\n\n` +
-        `平台：${platformLabel(platform)}（${length === 'long' ? '长篇' : '短篇'}）\n` +
-        `时间：${receipt.date || ''}\n\n` +
-        `已生成的文件：\n${fileList}\n\n` +
-        `请执行以下步骤：\n` +
-        `1. 读取上述生成的原始数据文件（扫榜结果目录下的 .md 文件）\n` +
-        `2. 分析爆款书籍的题材、卖点、节奏、人设等特征\n` +
-        `3. 生成扫榜报告（包含：市场趋势、热门题材分析、用户画像、竞争度评估）\n` +
-        `4. 给出 3-5 个可行的选题方向建议\n` +
-        `5. 将完整分析报告追加写入：${topicFile}\n\n` +
-        `报告要求：\n- 客观分析数据，不臆测\n- 选题建议要有差异化竞争力\n- 报告语言：中文`;
-
-      invocation.agent.followup({
-        content: [{ type: 'text', text: analysisPrompt }],
-        source: { kind: 'user' }
+      // 通知用户 + 触发 LLM 分析
+      notify(session, scan.notify({ type: 'handover', platform, length, files, topicFile, projectRoot }));
+
+      const prompt = scan.llmAnalysisPrompt({
+        platform, length,
+        date: receipt.date || '',
+        files,
+        topicFile,
+        projectRoot,
       });
+      llmFollowup(invocation, prompt);
 
       return { kind: 'success', text: '' };
     }
@@ -323,8 +224,9 @@ async function applyScan(ctx) {
 }
 
 // ---------------------------------------------------------------------------
-// 导出合并的 apply
+// 导出
 // ---------------------------------------------------------------------------
+
 export const inject = ['commands', 'userQuestions'];
 
 export async function apply(ctx) {

package/plugins/fancy-bootstrap/scripts/infra.js

@@ -0,0 +1,65 @@
+/**
+ * infra.js — DSH 插件核心基础设施
+ *
+ * 提供：
+ *   notify(session, text)       — 打印消息给用户（不触发 LLM）
+ *   llmFollowup(invocation, prompt) — 发送消息给 LLM，让 LLM 继续处理
+ *   spawnScript(cmd, args, opts)    — spawn 子进程，解析 stdout JSON
+ *
+ * 所有 fancy-* 插件均直接 import 此文件。
+ */
+
+// ---------------------------------------------------------------------------
+// notify — 打印消息给用户（queueMicrotask 避免打断 LLM 输出顺序）
+// ---------------------------------------------------------------------------
+
+export function notify(session, text) {
+  queueMicrotask(() => {
+    session.append(
+      'user/message',
+      { content: [{ type: 'text', text }], source: { kind: 'user' } },
+      { surfaceOp: 'append' }
+    );
+  });
+}
+
+// ---------------------------------------------------------------------------
+// llmFollowup — 发送消息给 LLM，让 LLM 在同一 session 继续处理
+// ---------------------------------------------------------------------------
+
+export function llmFollowup(invocation, content) {
+  const message = typeof content === 'string'
+    ? { content: [{ type: 'text', text: content }], source: { kind: 'user' } }
+    : content; // 允许传入完整消息对象
+  invocation.agent.followup(message);
+}
+
+// ---------------------------------------------------------------------------
+// spawnScript — spawn 子进程，stdout 只收集 JSON，stderr 单独收集
+// ---------------------------------------------------------------------------
+
+export function spawnScript(cmd, args, { timeout = 30000, cwd } = {}) {
+  return new Promise(async (resolve) => {
+    const { spawn } = await import('child_process');
+    const proc = spawn(cmd, args, { timeout, cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+    const outParts = [], errParts = [];
+    proc.stdout.on('data', (d) => { outParts.push(d.toString()); });
+    proc.stderr.on('data', (d) => { errParts.push(d.toString()); });
+    proc.on('close', (code) => {
+      const stdout = outParts.join(''), stderr = errParts.join('');
+      try {
+        const parsed = JSON.parse(stdout);
+        resolve({
+          ok: parsed.ok === true,
+          output: stdout,
+          error: parsed.error
+            ? (parsed.error.message || JSON.stringify(parsed.error))
+            : stderr || undefined,
+        });
+      } catch (_) {
+        resolve({ ok: false, output: stdout, error: stderr || ('exit ' + code) });
+      }
+    });
+    proc.on('error', (err) => resolve({ ok: false, output: '', error: err.message }));
+  });
+}

package/plugins/fancy-bootstrap/scripts/templates.js

@@ -0,0 +1,185 @@
+/**
+ * templates.js — 所有插件模板字符串
+ *
+ * 包括：
+ *   bootstrap 提示消息
+ *   scan 提示消息
+ *   LLM 分析 prompt 模板
+ *
+ * 原则：所有展示给用户的文字、发送给 LLM 的 prompt
+ * 均从此文件导出，插件主代码只做逻辑和拼装。
+ */
+
+// ---------------------------------------------------------------------------
+// 共享常量
+// ---------------------------------------------------------------------------
+
+export const PLATFORM_TABLE = [
+  ['1', 'qidian',   '长篇', '起点'],
+  ['2', 'fanqie',   '长篇', '番茄'],
+  ['3', 'jinjiang', '长篇', '晋江'],
+  ['4', 'zhihu',    '长/短','知乎'],
+  ['5', 'dianzhong','短篇', '点众'],
+  ['6', 'qimao',    '长/短','七猫'],
+];
+
+export function platformLabel(platform) {
+  const row = PLATFORM_TABLE.find(r => r[1] === platform);
+  return row ? row[3] : platform;
+}
+
+// ---------------------------------------------------------------------------
+// fancy-bootstrap 模板
+// ---------------------------------------------------------------------------
+
+export const bootstrap = {
+  askPath(question = '📂 请输入项目根路径 ( 或者输入 . 代表当前路径 )') {
+    return { question };
+  },
+
+  notify({ type, projectRoot }) {
+    switch (type) {
+      case 'no_path':
+        return '⚠️ 未提供路径，已取消';
+      case 'using_cwd':
+        return `📂 使用当前目录：${projectRoot}`;
+      case 'invalid_path':
+        return '❌ 路径不合法（不能含空格、.. 或特殊字符）';
+      case 'already_initialized':
+        return '⚠️ 该目录已初始化（.fancy-deployed 已存在）';
+      case 'confirm':
+        return `❓ 确认将以下路径作为项目根？\n${projectRoot}`;
+      case 'cancelled':
+        return '🚫 已取消';
+      case 'initializing':
+        return `⏳ 正在初始化 ${projectRoot}...`;
+      case 'success':
+        return '✅ 项目初始化完成！\n下一步：运行 /fancy-scan 扫榜';
+      case 'error':
+        return (err) => '❌ 初始化失败：' + err;
+      default:
+        return String(type);
+    }
+  },
+
+  confirmOptions() {
+    return [
+      { label: '确认创建', description: '开始在此目录初始化项目' },
+      { label: '取消',     description: '取消本次操作' },
+    ];
+  },
+};
+
+// ---------------------------------------------------------------------------
+// fancy-scan 模板
+// ---------------------------------------------------------------------------
+
+export const scan = {
+  platformList() {
+    return (
+      '📋 支持的平台：\n' +
+      PLATFORM_TABLE.map(r => `  ${r[0]}. ${r[3]}（${r[2]}）`).join('\n') +
+      '\n\n- 长篇：关注 追读、月票、订阅 等指标\n' +
+      '- 短篇：关注 传播、完读率 等指标\n' +
+      '- 知乎和七猫同时支持长篇和短篇'
+    );
+  },
+
+  askPlatform() {
+    return { question: '📊 请选择要扫的平台（输入编号 1-6）：' };
+  },
+
+  askLength(platform) {
+    return {
+      question: `${platformLabel(platform)} 同时支持长篇和短篇，请选择：` ,
+      hideCustomInput: true,
+      options: [
+        { label: '长篇', description: '' },
+        { label: '短篇', description: '' },
+      ],
+    };
+  },
+
+  notify({ type, platform, length, files, receipt, topicFile, projectRoot, err }) {
+    const lenStr = length === 'long' ? '长篇' : '短篇';
+    const pLabel = platformLabel(platform);
+
+    switch (type) {
+      case 'not_initialized':
+        return '⚠️ 当前目录尚未初始化。请先运行 /fancy-bootstrap 进行初始化。';
+
+      case 'invalid_choice':
+        return '❌ 无效选择，请输入 1-6 的编号。';
+
+      case 'cancelled':
+        return '🚫 已取消';
+
+      case 'cancelled_with_hint':
+        return '⚠️ 已取消。请再次调用 /fancy-scan 继续。';
+
+      case 'collecting':
+        return `⏳ 正在采集 ${pLabel}（${lenStr}）...`;
+
+      case 'scan_complete':
+        if (!files || files.length === 0) return `✅ ${pLabel}（${lenStr}）采集完成`;
+        const fileList = files.map(f => '  - ' + f.replace(projectRoot + '/', '')).join('\n');
+        return `✅ ${pLabel}（${lenStr}）采集完成\n\n📁 生成文件：\n${fileList}`;
+
+      case 'failed':
+        return '❌ 采集失败：' + err;
+
+      case 'parse_error':
+        return '❌ 采集结果解析失败';
+
+      case 'handover':
+        return (
+          `📊 采集完成，正在将数据交给 LLM 进行分析...\n` +
+          `📁 生成文件：\n${(files || []).map(f => '- ' + f.replace(projectRoot + '/', '')).join('\n')}\n` +
+          `💡 分析报告将写入：${(topicFile || '').replace(projectRoot + '/', '')}`
+        );
+
+      default:
+        return String(type);
+    }
+  },
+
+  /**
+   * 发送给 LLM 的分析 prompt 模板
+   * @param {object} params
+   * @param params.platform
+   * @param params.length
+   * @param params.date
+   * @param params.files  string[] — 完整绝对路径列表
+   * @param params.topicFile  string — topic_decision 文件完整路径
+   * @param params.projectRoot string
+   */
+  llmAnalysisPrompt({ platform, length, date, files, topicFile, projectRoot }) {
+    const pLabel = platformLabel(platform);
+    const lenStr = length === 'long' ? '长篇' : '短篇';
+    const fileList = (files || [])
+      .map(f => '- ' + f.replace(projectRoot + '/', ''))
+      .join('\n');
+
+    return [
+      `## 扫榜数据分析任务`,
+      ``,
+      `平台：${pLabel}（${lenStr}）`,
+      `时间：${date || ''}`,
+      ``,
+      `已生成的文件：`,
+      fileList,
+      ``,
+      `请执行以下步骤：`,
+      `1. 读取上述生成的原始数据文件（扫榜结果目录下的 .md 文件）`,
+      `2. 分析爆款书籍的题材、卖点、节奏、人设等特征`,
+      `3. 生成扫榜报告（包含：市场趋势、热门题材分析、用户画像、竞争度评估）`,
+      `4. 给出 3-5 个可行的选题方向建议`,
+      `5. 将完整分析报告追加写入：${topicFile}`,
+      ``,
+      `报告要求：`,
+      `- 客观分析数据，不臆测`,
+      `- 选题建议要有差异化竞争力`,
+      `- 报告语言：中文`,
+    ].join('\n');
+  },
+};

package/plugins/fancy-scan/scripts/run-scan.js

@@ -426,11 +426,6 @@ async function main() {
     console.error('=== 浏览器采集指令 END ===\n');
   }
 
-  // 生成扫榜报告
-  const mdFiles = scanFiles.filter(f => f.endsWith('.md') && !f.includes('扫榜报告') && !f.includes('topic_decision'));
-  const reportFile = generateReport(platform, length, mdFiles, scanDir);
-  appendTopicDecision(platform, length, reportFile, scanDir);
-
   // Step 6: 收集原始数据
   const rawData = {};
   for (const f of scanFiles) {
@@ -449,10 +444,9 @@ async function main() {
     length,
     date: today,
     scan_files: scanFiles,
-    report_file: reportFile,
     topic_decision: join(scanDir, `topic_decision_${today}.md`),
     raw_data: rawData,
-    summary: `${PLATFORM_CN[platform]}（${length}）采集完成，共 ${scanFiles.length} 个文件`,
+    summary: `${PLATFORM_CN[platform]}（${length === 'long' ? '长篇' : '短篇'}）采集完成，共 ${scanFiles.length} 个文件`,
   };
 
   console.log(JSON.stringify(receipt));

package/plugins/fancy-bootstrap/cordis.patch.yml

@@ -1,3 +0,0 @@
-- insert:
-    - id: fancy-bootstrap
-      name: "@cloud411716/fancy-webnovel-bootstrap"

package/plugins/fancy-bootstrap/scripts/path-utils.js

@@ -1,17 +0,0 @@
-/**
- * 路径工具
- */
-export function expandHome(pathStr) {
-  if (pathStr.startsWith('~/') || pathStr === '~') {
-    return pathStr === '~' ? (process.env.HOME ?? '/root') : pathStr.replace('~', process.env.HOME ?? '/root');
-  }
-  return pathStr;
-}
-
-export function resolvePath(pathStr) {
-  return expandHome(pathStr).replace(/\\+$/, '');
-}
-
-export function joinPath(...parts) {
-  return parts.join('/').replace(/\/+/g, '/');
-}

package/plugins/fancy-scan/index.js

@@ -1,197 +0,0 @@
-/**
- * fancy-scan DSH plugin
- * 扫榜：平台数据采集 + 报告生成
- */
-import { writeFileSync, existsSync, mkdirSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export const name = 'fancy-scan';
-export const inject = ['commands', 'userQuestions'];
-
-const PLATFORM_TABLE = [
-  ['1', 'qidian',  '长篇',  '起点'],
-  ['2', 'fanqie',  '长篇',  '番茄'],
-  ['3', 'jinjiang','长篇',  '晋江'],
-  ['4', 'zhihu',   '长/短', '知乎'],
-  ['5', 'dianzhong','短篇','点众'],
-  ['6', 'qimao',   '长/短', '七猫'],
-];
-
-function platformLabel(platform) {
-  const row = PLATFORM_TABLE.find(r => r[1] === platform);
-  return row ? row[3] : platform;
-}
-
-function notify(session, text) {
-  queueMicrotask(() => {
-    session.append(
-      'user/message',
-      { content: [{ type: 'text', text }], source: { kind: 'user' } },
-      { surfaceOp: 'append' }
-    );
-  });
-}
-
-function getProjectRoot(invocation) {
-  // 从 rawInput 提取项目根（fancy-bootstrap 初始化后的 .fancy-deployed 所在目录）
-  // 优先取命令后的路径参数，否则用当前目录
-  const raw = invocation.rawInput ? invocation.rawInput.trim() : '';
-  return raw || process.cwd();
-}
-
-function checkInitialized(projectRoot) {
-  return existsSync(join(projectRoot, '.fancy-deployed'));
-}
-
-function buildPlatformChoices() {
-  return PLATFORM_TABLE.map(r => ({
-    label: `${r[0]}. ${r[3]}（${r[2]}）`,
-    description: '',
-  }));
-}
-
-function buildLengthChoices(platform) {
-  if (platform === 'zhihu' || platform === 'qimao') {
-    return [
-      { label: '长篇', description: '' },
-      { label: '短篇', description: '' },
-    ];
-  }
-  return null; // 无需二次选择
-}
-
-export async function apply(ctx) {
-  ctx.commands.register({
-    name: 'fancy-scan',
-    description: '📊 扫榜分析 ( usage: /fancy-scan [平台] [篇幅] )',
-    handler: async (invocation) => {
-      const session = invocation.agent.session;
-      const rawInput = invocation.rawInput ? invocation.rawInput.trim() : '';
-
-      // Step 1: 检查 .fancy-deployed
-      const projectRoot = getProjectRoot(invocation);
-      if (!checkInitialized(projectRoot)) {
-        notify(session, '⚠️ 当前目录尚未初始化。请先运行 /fancy-bootstrap 进行初始化。');
-        return { kind: 'success', text: '' };
-      }
-
-      // Step 2: 解析参数
-      let platform = '', length = '';
-
-      if (rawInput) {
-        // 从 rawInput 解析平台+篇幅
-        const parts = rawInput.split(/\s+/);
-        platform = parts[0] || '';
-        length = parts[1] || '';
-        // 尝试数字映射
-        const numMatch = platform.match(/^(\d+)$/);
-        if (numMatch) {
-          const row = PLATFORM_TABLE.find(r => r[0] === numMatch[1]);
-          if (row) {
-            platform = row[1];
-            if (!length && (platform === 'zhihu' || platform === 'qimao')) {
-              // 需要二次选择，默认长篇
-              length = 'long';
-            } else {
-              length = row[2] === '长篇' ? 'long' : (row[2] === '短篇' ? 'short' : 'long');
-            }
-          }
-        }
-      }
-
-      // 无参数或参数不全 → 弹窗
-      if (!platform || !length || !PLATFORM_TABLE.find(r => r[1] === platform)) {
-        // 打印调用方式
-        notify(session, '[/fancy-scan] 调用方式：带参数（平台 篇幅）\n' +
-          '[/fancy-scan] 调用方式：无参数（弹窗选择）');
-        notify(session, '📋 支持的平台：\n' +
-          PLATFORM_TABLE.map(r => `  ${r[0]}. ${r[3]}（${r[2]}）`).join('\n') +
-          '\n\n- 长篇：关注 追读、月票、订阅 等指标\n- 短篇：关注 传播、完读率 等指标\n- 知乎和七猫同时支持长篇和短篇');
-
-        const choice = await ctx.userQuestions.ask({
-          questions: [{
-            id: 'platform',
-            question: '📊 请选择要扫的平台（输入编号 1-6）：',
-          }],
-        });
-        const answer = choice.answers[0]?.custom?.trim();
-        if (!answer) {
-          notify(session, '⚠️ 已取消。请再次调用 /fancy-scan 继续。');
-          return { kind: 'success', text: '' };
-        }
-        const numMatch = answer.match(/^(\d+)$/);
-        const row = numMatch ? PLATFORM_TABLE.find(r => r[0] === numMatch[1]) : null;
-        if (!row) {
-          notify(session, '❌ 无效选择，请输入 1-6 的编号。');
-          return { kind: 'success', text: '' };
-        }
-        platform = row[1];
-        length = row[2] === '长/短' ? null : (row[2] === '长篇' ? 'long' : 'short');
-      }
-
-      // 知乎/七猫需要二次选择篇幅
-      if (!length || length === 'long/short') {
-        const lengthChoices = buildLengthChoices(platform);
-        if (lengthChoices) {
-          const lenResult = await ctx.userQuestions.ask({
-            questions: [{
-              id: 'length',
-              question: `${platformLabel(platform)} 同时支持长篇和短篇，请选择：`,
-              hideCustomInput: true,
-              options: lengthChoices,
-            }],
-          });
-          const lenAnswer = lenResult.answers[0]?.selected?.[0] ?? lenResult.answers[0]?.custom;
-          if (!lenAnswer || lenAnswer === '取消') {
-            notify(session, '🚫 已取消');
-            return { kind: 'success', text: '' };
-          }
-          length = (lenAnswer === '长篇') ? 'long' : 'short';
-        } else {
-          length = 'long';
-        }
-      }
-
-      notify(session, `⏳ 正在采集 ${platformLabel(platform)}（${length === 'long' ? '长篇' : '短篇'}）...`);
-
-      // Step 3: 调用采集脚本
-      const scriptPath = join(__dirname, 'scripts', 'run-scan.js');
-      const { ok, output, error } = await runScript('node', [scriptPath, '--project-root', projectRoot, '--platform', platform, '--length', length]);
-
-      if (!ok) {
-        notify(session, '❌ 采集失败：' + (error || '未知错误'));
-      } else {
-        // 解析输出中的文件列表
-        let files = [];
-        try { files = JSON.parse(output).files || []; } catch (_) {}
-        const fileList = files.length > 0 ? '\n\n📁 生成文件：\n' + files.map(f => '  - ' + f).join('\n') : '';
-        notify(session, `✅ ${platformLabel(platform)}（${length === 'long' ? '长篇' : '短篇'}）采集完成${fileList}\n\n如需扫其他平台，请再次调用 /fancy-scan`);
-      }
-
-      return { kind: 'success', text: '' };
-    }
-  });
-}
-
-function runScript(cmd, args) {
-  return new Promise((resolve) => {
-    const proc = require('child_process').spawn(cmd, args, { timeout: 120000, stdio: ['ignore', 'pipe', 'pipe'] });
-    const outParts = [], errParts = [];
-    proc.stdout.on('data', (d) => { outParts.push(d.toString()); });
-    proc.stderr.on('data', (d) => { errParts.push(d.toString()); });
-    proc.on('close', (code) => {
-      const stdout = outParts.join(''), stderr = errParts.join('');
-      try {
-        const parsed = JSON.parse(stdout);
-        resolve({ ok: parsed.ok === true, output: stdout, error: parsed.error ? (parsed.error.message || JSON.stringify(parsed.error)) : stderr || undefined });
-      } catch (_) {
-        resolve({ ok: false, output: stdout, error: stderr || ('exit ' + code) });
-      }
-    });
-    proc.on('error', (err) => resolve({ ok: false, output: '', error: err.message }));
-  });
-}