@cloud411716/fancy-webnovel 3.0.4 → 4.0.0

package/plugins/fancy-topic/prompts/02-setup-prompt.md

@@ -0,0 +1,112 @@
+# 素材驱动选题 · ${GENRE}
+
+你正在把扫榜候选方向收敛成一个可执行的选题方案。
+
+## 一、当前候选
+
+```json
+${SUGGESTION_JSON}
+```
+
+## 二、素材库查询
+
+工作区：`${WORKSPACE}`
+
+查询脚本：`${QUERY_SCRIPT}`
+
+先按题材 `${GENRE}` 查询以下 kind。命令模板：
+
+```bash
+node '${QUERY_SCRIPT}' --workspace '${WORKSPACE}' --genre '${GENRE}' --kind <kind> --limit 50 --json
+```
+
+需要查询的 kind：
+
+- 能力组：${ABILITY_KINDS}
+- 剧情与脑洞组：${PLOT_KINDS}
+
+规则：
+
+1. 每个 kind 至少查询一次；用 `--json` 读取结果。
+2. 只使用素材库里真实存在的素材；不要编造素材名或能力名。
+3. 如果某个 kind 在该题材下没有结果，可以去掉 `--genre` 再查一次，优先选通用素材，并在方案里说明。
+4. 组合素材时保持因果自洽：能力机制、发动条件、代价、限制、反制、力量来源要能互相对上；剧情与脑洞要能落成具体冲突、反转或爽点。
+5. 不要修改、删除 `.fancy-tools/fancy-material/` 下的脚本。
+
+## 三、生成 5 个差异化方案
+
+基于查询结果，给出 5 个**有明确差异**的方案。差异必须落在至少两个维度上，例如：
+
+- 能力机制不同
+- 能力代价/限制不同
+- 核心冲突不同
+- 反转或爽点不同
+- 目标读者/情绪价值不同
+
+每个方案包含：
+
+```json
+{
+  "title": "方案标题",
+  "summary": "一句话说明这个方案最核心的差异",
+  "genre": "${GENRE}",
+  "ability": {
+    "ability_mechanism": "……",
+    "ability_activation": "……",
+    "ability_cost": "……",
+    "ability_limit": "……",
+    "ability_counter": "……",
+    "power_source": "……"
+  },
+  "plot": {
+    "brainstorm": "……",
+    "conflict_seed": "……",
+    "conflict_escalation": "……",
+    "plot_twist": "……",
+    "mystery_seed": "……",
+    "payoff_scene": "……",
+    "trope": "……"
+  }
+}
+```
+
+要求：
+
+- 每个 kind 一条最终文案；如果组合了多条素材，用 `；` 连接。
+- 每条文案要具体、可写，不要写“很强”“很神秘”这类空话。
+- 5 个方案必须能明显区分，不能只换名字。
+- `title` 要能概括方案差异，不要带“方案 N：”前缀。
+
+## 四、展示与讨论
+
+1. 先用一张表展示 5 个方案：序号、标题、一句话差异、能力机制关键词、核心冲突关键词。
+2. 再逐个方案展开 `ability` 和 `plot` 的关键内容，方便用户比较。
+3. 明确告诉用户：可以就任意方案继续讨论，例如改能力代价、换核心冲突、调整反转或爽点。
+4. 用户提出修改时，只修改对应方案，保持其它方案不变；修改后重新展示受影响的部分。
+
+## 五、确认与写入
+
+只有用户**明确确认**某个方案后，才调用工具：
+
+```text
+fancy_topic_finalize
+```
+
+参数：
+
+- `title`：选中方案的标题
+- `genre`：题材
+- `ability`：6 个 kind 的最终文案
+- `plot`：7 个 kind 的最终文案
+
+调用成功后告诉用户：
+
+- 已写入 `_novel_topic.json`
+- 已创建/更新项目
+- 下一步可以运行 `/fancy-material` 生成素材，或等待后续 `fancy-build` 适配
+
+在用户确认之前：
+
+- 不要写入 `_novel_topic.json`
+- 不要调用 `fancy_topic_finalize`
+- 不要声称已经保存

package/plugins/fancy-topic/scripts/save-minimal-topic.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * save-minimal-topic.js —— 写入最小 `_novel_topic.json`
+ *
+ * LLM 在用户确认 5 个候选方案之一后，通过 `fancy_topic_finalize` 工具调用本脚本。
+ * 本脚本只做三件事：校验、原子写盘、推进 phase。项目库同步由宿主插件完成。
+ *
+ * 用法：
+ *   node save-minimal-topic.js --project-root <abs> --input <json-file>
+ */
+import { existsSync, readFileSync, unlinkSync } from 'fs';
+import { join, resolve } from 'path';
+import { atomicWriteJSON } from '#atomic-write';
+import { validateMinimalTopic, NOVEL_TOPIC_FILE } from '#material-topic';
+
+const PHASE_ORDER = ['initialized', 'scanned', 'topic_done', 'bible_done', 'outline_done'];
+
+function fail(message, code = 2) {
+  console.log(JSON.stringify({ ok: false, error: { code, message } }));
+  process.exit(code);
+}
+
+function parseArgs(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (!arg.startsWith('--')) continue;
+    const key = arg.slice(2).replace(/-/g, '_');
+    const value = argv[i + 1];
+    if (value === undefined) fail(`参数 ${arg} 缺少值`);
+    out[key] = value;
+    i += 1;
+  }
+  return out;
+}
+
+function advancePhase(root, nextPhase) {
+  const deployedPath = join(root, '.fancy-deployed');
+  if (!existsSync(deployedPath)) return { updated: false, reason: 'project_not_initialized' };
+  try {
+    const data = JSON.parse(readFileSync(deployedPath, 'utf-8'));
+    const currentRank = PHASE_ORDER.indexOf(data.phase);
+    const nextRank = PHASE_ORDER.indexOf(nextPhase);
+    if (currentRank === -1 || nextRank === -1) {
+      return { updated: false, reason: 'unknown_phase', currentPhase: data.phase };
+    }
+    if (currentRank >= nextRank) {
+      return {
+        updated: false,
+        reason: currentRank === nextRank ? 'already_at_phase' : 'already_advanced',
+        currentPhase: data.phase,
+      };
+    }
+    const previousPhase = data.phase;
+    data.phase = nextPhase;
+    atomicWriteJSON(deployedPath, data, { mode: 0o600 });
+    return { updated: true, previousPhase, currentPhase: nextPhase };
+  } catch (e) {
+    return { updated: false, reason: 'error: ' + e.message };
+  }
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const root = resolve(String(args.project_root || ''));
+  if (!args.project_root || !existsSync(root)) fail('project-root 不存在：' + root);
+  if (!args.input) fail('缺少 --input');
+  const inputPath = resolve(String(args.input));
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(inputPath, 'utf-8'));
+  } catch (e) {
+    fail('读取 input JSON 失败：' + e.message);
+  }
+  const title = typeof parsed.title === 'string' ? parsed.title.trim() : '';
+  if (!title) fail('title 必须是非空字符串');
+  const validated = validateMinimalTopic(parsed);
+  if (!validated.ok) fail('选题字段校验失败：\n' + validated.errors.map(e => '  - ' + e).join('\n'));
+
+  const topicPath = join(root, NOVEL_TOPIC_FILE);
+  try {
+    atomicWriteJSON(topicPath, validated.normalized);
+  } catch (e) {
+    fail('写入 _novel_topic.json 失败：' + e.message, 4);
+  }
+  const phase = advancePhase(root, 'topic_done');
+  try { unlinkSync(inputPath); } catch { /* ignore */ }
+  console.log(JSON.stringify({
+    ok: true,
+    title,
+    topic: validated.normalized,
+    path: topicPath,
+    phase,
+  }));
+}
+
+main();

package/plugins/fancy-topic/templates.js

@@ -17,6 +17,7 @@ import { dirname, join } from 'path';
 import { createHash } from 'crypto';
 import { fileURLToPath } from 'url';
 import { shellSingleQuote } from '#path-guard';
+import { ABILITY_KINDS, PLOT_KINDS } from '#material-topic';
 import {
   TOPIC_FIELDS,
   TOPIC_FIELD_CN,
@@ -30,6 +31,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 export const SAVE_SUGGESTION_SCRIPT = join(__dirname, 'scripts', 'save-suggestion.js');
 /** 静态提示词契约（**提示词层**；动态字段由本文件注入） */
 export const EXPLORATION_PROMPT_FILE = join(__dirname, 'prompts', '01-exploration-prompt.md');
+export const SETUP_PROMPT_FILE = join(__dirname, 'prompts', '02-setup-prompt.md');
 
 /**
  * 渲染探索提示词：静态契约在 prompts/01-exploration-prompt.md，
@@ -53,6 +55,20 @@ export function renderExplorationPrompt(vars) {
   return text.replace(/\n$/, '');
 }
 
+/**
+ * 渲染 setup 提示词：把 suggestion、kind 清单和查询脚本注入静态契约。
+ * @param {Record<string, string|number>} vars
+ * @returns {string}
+ */
+export function renderSetupPrompt(vars) {
+  let text = readFileSync(SETUP_PROMPT_FILE, 'utf-8');
+  for (const [key, value] of Object.entries(vars)) {
+    text = text.split('${' + key + '}').join(value === undefined || value === null ? '' : String(value));
+  }
+  text = text.replace(/\$\{[a-z_]+\}/g, '');
+  return text.replace(/\n$/, '');
+}
+
 const PLATFORM_OPTIONS = [
   { label: '番茄',  value: 'fanqie'  },
   { label: '起点',  value: 'qidian'  },
@@ -151,6 +167,40 @@ export const topic = {
     };
   },
 
+  /**
+   * 路径 A：只列出 decision 文件里实际存在的平台。
+   * @param {Array<{value:string,label:string,directions:Array}>} platforms
+   */
+  askPlatformOptions(platforms) {
+    return {
+      id: 'topic-platform',
+      question: '📚 请选择要查看候选方向的平台（只列出该文件中已有的平台）：',
+      options: platforms.map((p) => ({
+        label: p.label,
+        description: `${p.directions.length} 个候选方向`,
+      })),
+    };
+  },
+
+  /**
+   * 路径 A：选择一个候选方向。
+   * @param {Array<{title:string,genre:string,positioning:string,market_score:number|string|null}>} directions
+   */
+  askDirection(directions) {
+    return {
+      id: 'topic-direction',
+      question: '🎯 请选择本次素材生成使用的选题方向：',
+      options: directions.map((d) => ({
+        label: d.title,
+        description: [
+          d.genre ? `题材：${d.genre}` : '',
+          d.market_score !== null && d.market_score !== undefined ? `评分：${d.market_score}` : '',
+          d.positioning ? `定位：${d.positioning}` : '',
+        ].filter(Boolean).join('；'),
+      })),
+    };
+  },
+
   /**
    * 路径 A：选 topic_decision 文件
    * @param {string[]} decisionFiles - 所有可用的 topic_decision_<date>.md 文件名（不含路径）
@@ -333,25 +383,44 @@ export const topic = {
     });
   },
 
+  /**
+   * 路径 B 的 LLM 提示词。
+   * @param {object} args
+   * @param {object} args.suggestion - `_novel_topic_suggestion.json`
+   * @param {string} args.queryScript - 已部署的素材查询脚本绝对路径
+   * @param {string} args.workspace - 工作区绝对路径
+   */
+  setupPrompt({ suggestion, queryScript, workspace }) {
+    const genre = suggestion?.genre || '';
+    return renderSetupPrompt({
+      GENRE: genre,
+      SUGGESTION_JSON: JSON.stringify(suggestion || {}, null, 2),
+      ABILITY_KINDS: ABILITY_KINDS.map(k => `\`${k}\``).join('、'),
+      PLOT_KINDS: PLOT_KINDS.map(k => `\`${k}\``).join('、'),
+      QUERY_SCRIPT: queryScript || '',
+      WORKSPACE: workspace || '',
+    });
+  },
+
   /**
    * 通知模板（左侧消息栏）
    */
-  notify({ type, platform, phase, decisionFile, blockCount, fieldCount, missing, err, projectRoot, extra, available, notes, file, reasons, arg }) {
+  notify({ type, platform, phase, decisionFile, blockCount, fieldCount, missing, err, projectRoot, extra, available, notes, file, reasons, arg, direction, genre, suggestionPath }) {
     switch (type) {
       case 'help':
         return `📝 选题 用法
 
-/fancy-topic         探索选题：读取扫榜结果，生成字段建议和 6 维评分
-/fancy-topic setup   敲定选题：逐项确认字段并写入 _novel_topic.json
+/fancy-topic         选择 decision 文件、平台和候选方向，写入 _novel_topic_suggestion.json
+/fancy-topic setup   基于素材库生成 5 个候选方案，讨论确认后写入 _novel_topic.json
 /fancy-topic help    显示本帮助
 
-作用：生成/确认选题与创意约束，供 fancy-build 使用。`;
+作用：把扫榜候选方向收敛为素材驱动的选题。`;
 
       case 'invalid_argument':
         return `❌ 参数无效：${arg || '（空）'}\n`
           + '/fancy-topic 支持以下用法：\n'
-          + `- /fancy-topic：不带参数，进入探索模式 —— 读取扫榜结果，生成 ${TOPIC_FIELDS.length} 个字段建议和 6 维评分；\n`
-          + '- /fancy-topic setup：带 setup 参数，进入敲定模式 —— 逐项确认选题字段并写入 _novel_topic.json；\n'
+          + '- /fancy-topic：选择 decision 文件、平台和候选方向，写入 _novel_topic_suggestion.json；\n'
+          + '- /fancy-topic setup：基于素材库生成 5 个候选方案，讨论确认后写入 _novel_topic.json；\n'
           + '- /fancy-topic help：查看本命令帮助。';
 
       case 'cancelled':
@@ -423,6 +492,21 @@ export const topic = {
           '请重新运行 /fancy-scan，让 LLM 重新写入报告正文。'
         );
 
+      case 'no_directions':
+        return `⚠️ 在 ${decisionFile || '所选文件'} 中没有解析到候选方向。\n` +
+          '请确认选题方向小节包含：题材、一句话定位、市场评分、推荐理由。';
+
+      case 'suggestion_write_failed':
+        return '❌ 写入 _novel_topic_suggestion.json 失败：' + (err || '未知错误');
+
+      case 'path_a_suggestion_done':
+        return `✅ 已写入候选选题建议\n` +
+          `📚 平台：${platform || ''}\n` +
+          `🎯 方向：${direction || ''}\n` +
+          `🏷️ 题材：${genre || ''}\n` +
+          `📁 文件：${suggestionPath || '_novel_topic_suggestion.json'}\n` +
+          '下一步：运行 /fancy-topic setup，让 LLM 从素材库生成 5 个候选方案。';
+
       case 'path_a_done': {
         const noteText = (notes && notes.length)
           ? '\n' + notes.map(n => 'ℹ️ ' + n).join('\n')
@@ -436,6 +520,20 @@ export const topic = {
         );
       }
 
+      case 'no_suggestion':
+        return '⚠️ 未找到 _novel_topic_suggestion.json。\n请先运行 /fancy-topic，选择 decision 文件、平台和候选方向。';
+
+      case 'material_not_initialized':
+        return '⚠️ 当前工作区还没有初始化素材库。\n请先运行 /fancy-bootstrap 初始化工作区，或运行 /fancy-material init 补齐素材库 schema。';
+
+      case 'setup_started':
+        return `✅ 已把素材驱动选题任务交给 LLM\n` +
+          `🏷️ 题材：${genre || ''}\n` +
+          'LLM 会查询素材库并给出 5 个候选方案。你可以直接和它讨论；确认后它会调用 fancy_topic_finalize 写入 `_novel_topic.json`。';
+
+      case 'setup_prompt_failed':
+        return '❌ 向 LLM 发送 setup 提示词失败：' + (err || '未知错误');
+
       case 'path_b_done':
         return `✅ 选题已确认。
 下一步：运行 /fancy-build scale 构建故事（在此之前可选择运行 /fancy-analyze 拆解同题材爆款小说）。` +