@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

package/plugins/fancy-topic/scripts/select-topic.js

@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+/**
+ * fancy-topic select-topic.js — 写盘与 phase 推进
+ *
+ * 由 fancy-topic/index.js 通过 spawnScript 调用。
+ *
+ * 子命令：
+ *   skeleton --project-root <abs>     创建骨架 _novel_topic.json（不推进 phase）
+ *   write    --project-root <abs> --platform <p> --book-name <...> --genre <...> ...
+ *                                       原子写入 + phase 推进到 topic_done
+ *
+ * 所有写盘都是原子写（tempfile + rename）。
+ */
+
+import { writeFileSync, existsSync, readFileSync, renameSync } from 'fs';
+import { join, dirname } from 'path';
+import { EC, errorResponse } from '#error-codes';
+
+// ---------------------------------------------------------------------------
+// 工具函数
+// ---------------------------------------------------------------------------
+
+function nowIso() {
+  return new Date().toISOString().replace('.000Z', 'Z');
+}
+
+// _novel_topic.json 的字段定义（与 templates.js 保持一致）
+const NOVEL_TOPIC_FIELDS = [
+  'book_name',
+  'genre',
+  'target_words',
+  'target_chapters',
+  'core_summary',
+  'core_conflict',
+  'hard_constraints',
+  'anti_tropes',
+  'platform',
+];
+
+/**
+ * 目标章数上限。
+ *
+ * 骨架按"每卷 40~120 章"排卷，5000 章已经是 42 卷 —— 再往上卷数会大到
+ * 骨架、节奏、写作三个阶段都排不开。与其让它一路算到某个阶段崩掉，
+ * 不如在入口就说清楚"请拆成多部书"。
+ */
+export const MAX_TARGET_CHAPTERS = 5000;
+
+function buildSkeleton() {
+  const obj = {};
+  for (const f of NOVEL_TOPIC_FIELDS) obj[f] = Array.isArray(obj[f]) ? [] : '';
+  obj.target_words = 0;
+  obj.target_chapters = 0;
+  obj.hard_constraints = [];
+  obj.anti_tropes = [];
+  return obj;
+}
+
+// 原子写 JSON
+function atomicWriteJSON(filepath, data) {
+  const tmpPath = join(dirname(filepath), `.${Date.now()}-${process.pid}.tmp`);
+  writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+  renameSync(tmpPath, filepath);
+}
+
+// 把 .fancy-deployed 的 phase 推进到指定值（只进不退）
+const PHASE_ORDER = ['initialized', 'scanned', 'topic_done', 'bible_done', 'outline_done'];
+function advancePhase(projectRoot, nextPhase) {
+  const deployedPath = join(projectRoot, '.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);
+    return { updated: true, previousPhase, currentPhase: nextPhase };
+  } catch (e) {
+    return { updated: false, reason: `error: ${e.message}` };
+  }
+}
+
+function fail(ec, extra = {}) {
+  const exitCode = extra.exitCode ?? ec.code;
+  console.log(JSON.stringify(errorResponse(ec, extra)));
+  process.exit(exitCode);
+}
+
+// ---------------------------------------------------------------------------
+// 子命令：skeleton
+// ---------------------------------------------------------------------------
+
+function cmdSkeleton(args) {
+  const projectRoot = args.project_root;
+  if (!projectRoot) fail(EC.EC042_MISSING_REQUIRED, { message: '缺少 --project-root' });
+
+  const deployed = join(projectRoot, '.fancy-deployed');
+  if (!existsSync(deployed)) fail(EC.EC124_PROJECT_NOT_INITIALIZED, { message: '项目未初始化：.fancy-deployed 不存在' });
+
+  const novelTopicPath = join(projectRoot, '_novel_topic.json');
+  if (existsSync(novelTopicPath)) {
+    // 骨架已存在，不重复创建
+    console.log(JSON.stringify({
+      ok: true, operation: 'skeleton', project_root: projectRoot, novel_topic: novelTopicPath,
+      created: false, reason: 'already_exists',
+    }));
+    return;
+  }
+
+  const now = nowIso();
+  const skeleton = {
+    ...buildSkeleton(),
+    created_at: now,
+    updated_at: now,
+  };
+  try {
+    atomicWriteJSON(novelTopicPath, skeleton);
+  } catch (e) {
+    fail(EC.EC045_TOPIC_WRITE_FAILED, { message: `创建骨架失败: ${e.message}` });
+  }
+
+  console.log(JSON.stringify({
+    ok: true, operation: 'skeleton', project_root: projectRoot, novel_topic: novelTopicPath,
+    created: true,
+  }));
+}
+
+// ---------------------------------------------------------------------------
+// 子命令：write
+// ---------------------------------------------------------------------------
+
+function cmdWrite(args) {
+  const projectRoot = args.project_root;
+  if (!projectRoot) fail(EC.EC042_MISSING_REQUIRED, { message: '缺少 --project-root' });
+
+  const deployed = join(projectRoot, '.fancy-deployed');
+  if (!existsSync(deployed)) fail(EC.EC124_PROJECT_NOT_INITIALIZED, { message: '项目未初始化：.fancy-deployed 不存在' });
+
+  // 验证 phase（路径 B 只允许 scanned 或 topic_done）
+  let phase;
+  try {
+    phase = JSON.parse(readFileSync(deployed, 'utf-8')).phase;
+  } catch (e) {
+    fail(EC.EC123_JSON_PARSE_FAIL, { message: `解析 .fancy-deployed 失败: ${e.message}` });
+  }
+  if (phase !== 'scanned' && phase !== 'topic_done') {
+    fail(EC.EC043_PHASE_NOT_TOPIC, { message: `当前 phase=${phase}，fancy-topic 需要 scanned 或 topic_done` });
+  }
+
+  // 校验所有必填字段
+  for (const f of NOVEL_TOPIC_FIELDS) {
+    const v = args[f];
+    if (v === undefined || v === null || v === '') {
+      fail(EC.EC042_MISSING_REQUIRED, { message: `缺少必填字段: ${f}` });
+    }
+  }
+
+  // 字数 / 章数必须是正整数
+  //
+  // 用 Number() 而不是 parseInt()：parseInt('600abc') 会**截断成 600**，
+  // 用户（或上游脚本）传进来的脏值就这样被当成合法值吞掉了。
+  // 2026-10-27 核实：旧实现 parseInt('600abc', 10) → 600，parseInt('600.9') → 600。
+  const targetWords = Number(args.target_words);
+  const targetChapters = Number(args.target_chapters);
+  if (!Number.isInteger(targetWords) || targetWords <= 0) {
+    fail(EC.EC046_INVALID_WORDS, { message: `target_words 必须为正整数: ${args.target_words}` });
+  }
+  if (!Number.isInteger(targetChapters) || targetChapters <= 0) {
+    fail(EC.EC047_INVALID_CHAPTERS, { message: `target_chapters 必须为正整数: ${args.target_chapters}` });
+  }
+  // 章数上限：超过这个量级，一本书的卷数会大到没法写（骨架按每卷 40~120 章排卷，
+  // 5000 章已经是 42 卷）。超了就说清楚要拆书，而不是让下游一路算到崩。
+  if (targetChapters > MAX_TARGET_CHAPTERS) {
+    fail(EC.EC047_INVALID_CHAPTERS, {
+      message: `target_chapters 超过上限 ${MAX_TARGET_CHAPTERS} 章（当前 ${targetChapters}）：` +
+        `一本书记不下这么多章，请拆成多部书，每部不超过 ${MAX_TARGET_CHAPTERS} 章`
+    });
+  }
+
+  // 解析 hard_constraints / anti_tropes（可能是 JSON 数组字符串）
+  let hardConstraints, antiTropes;
+  try {
+    hardConstraints = Array.isArray(args.hard_constraints)
+      ? args.hard_constraints
+      : (typeof args.hard_constraints === 'string' ? JSON.parse(args.hard_constraints) : []);
+    antiTropes = Array.isArray(args.anti_tropes)
+      ? args.anti_tropes
+      : (typeof args.anti_tropes === 'string' ? JSON.parse(args.anti_tropes) : []);
+  } catch (e) {
+    fail(EC.EC123_JSON_PARSE_FAIL, { message: `解析 hard_constraints/anti_tropes 失败: ${e.message}` });
+  }
+
+  // 读已有 _novel_topic.json（保留 created_at）
+  const novelTopicPath = join(projectRoot, '_novel_topic.json');
+  let existing = {};
+  if (existsSync(novelTopicPath)) {
+    try { existing = JSON.parse(readFileSync(novelTopicPath, 'utf-8')); } catch (_) { existing = {}; }
+  }
+
+  const now = nowIso();
+  const data = {
+    book_name:        String(args.book_name),
+    genre:            String(args.genre),
+    target_words:     targetWords,
+    target_chapters:  targetChapters,
+    core_summary:     String(args.core_summary),
+    core_conflict:    String(args.core_conflict),
+    hard_constraints: hardConstraints,
+    anti_tropes:      antiTropes,
+    platform:         String(args.platform),
+    created_at:       existing.created_at || now,
+    updated_at:       now,
+  };
+
+  try {
+    atomicWriteJSON(novelTopicPath, data);
+  } catch (e) {
+    fail(EC.EC045_TOPIC_WRITE_FAILED, { message: `原子写失败: ${e.message}` });
+  }
+
+  // 推进 phase → topic_done
+  const phaseResult = advancePhase(projectRoot, 'topic_done');
+
+  console.log(JSON.stringify({
+    ok: true, operation: 'write', project_root: projectRoot, novel_topic: novelTopicPath,
+    fields_written: Object.keys(data).length,
+    data,
+    phase_advance: phaseResult,
+  }));
+}
+
+// ---------------------------------------------------------------------------
+// 入口
+// ---------------------------------------------------------------------------
+
+function main() {
+  const args = process.argv.slice(2);
+
+  // 解析所有 --key value / --key=value 对
+  // 约定：所有 key 把连字符 '-' 标准化为下划线 '_'（便于 JS 访问）
+  const parsed = {};
+  let subcommand = null;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.startsWith('--')) {
+      const eq = a.indexOf('=');
+      const rawKey = eq !== -1 ? a.slice(2, eq) : a.slice(2);
+      const key = rawKey.replace(/-/g, '_');
+      const value = eq !== -1 ? a.slice(eq + 1) : (args[i + 1] || '');
+      parsed[key] = value;
+      if (eq === -1) i++;
+    } else if (subcommand === null) {
+      subcommand = a;
+    }
+  }
+
+  switch (subcommand) {
+    case 'skeleton':
+      return cmdSkeleton(parsed);
+    case 'write':
+      return cmdWrite(parsed);
+    default:
+      fail(EC.EC042_MISSING_REQUIRED, { message: `缺少子命令：第一个非 -- 参数应为 'skeleton' 或 'write'，收到 '${subcommand}'` });
+  }
+}
+
+main();

package/plugins/fancy-topic/templates.js

@@ -0,0 +1,373 @@
+/**
+ * fancy-topic templates — 通知 + 弹框 + 字段定义
+ */
+
+const PLATFORM_OPTIONS = [
+  { label: '番茄',  value: 'fanqie'  },
+  { label: '起点',  value: 'qidian'  },
+  { label: '晋江',  value: 'jinjiang' },
+  { label: '七猫',  value: 'qimao'   },
+];
+
+const GENRE_OPTIONS = [
+  { label: '玄幻', value: 'xianxia' },
+  { label: '都市', value: 'urban' },
+  { label: '言情', value: 'romance' },
+  { label: '悬疑', value: 'mystery' },
+  { label: '历史', value: 'history' },
+  { label: '科幻', value: 'scifi' },
+  { label: '仙侠', value: 'xianxia-cultivation' },
+  { label: '其他', value: 'other' },
+];
+
+// 「取消（重新扫榜）」选项的 label。
+// DSH 的 AskUserQuestionOption 只有 label/description 两个合法字段，
+// selected 回传的是 label —— 此前这里用 value:'__rescan__' 判断，
+// 而 value 根本不会被 DSH 回传，导致"重新扫榜"分支永远不可达。
+const RESCAN_LABEL = '取消（重新扫榜）';
+
+/**
+ * 剥离 value，转换成 DSH 合法的 AskUserQuestionOption。
+ *
+ * DSH 的 AskUserQuestionOption 只有 label / description；
+ * value 属于契约外字段，传了会被运行时静默忽略。
+ * 上面的 value 仅供插件内部做 label↔value 映射（platformCn/platformToValue）。
+ *
+ * description 是可选字段：**没有就整个键省掉**，不能写成 undefined ——
+ * DSH 的 api gateway 在远程模式下要求提问请求是"lossless JSON"，
+ * 属性值不允许是 undefined（JSON.stringify 会悄悄丢掉它，但网关按属性
+ * 存在性判定），带上就会让整个请求被拒：
+ *   "api gateway: Remote event request is not lossless JSON data"
+ */
+function toAskOptions(options) {
+  return options.map(o => {
+    const opt = { label: o.label };
+    if (o.description !== undefined) opt.description = o.description;
+    return opt;
+  });
+}
+
+/**
+ * 8 个字段定义（路径 B 弹框用）
+ * 每个字段：id、prompt 提示、kind（text/number/multiselect）、options、defaultGetter
+ */
+const TOPIC_FIELDS = [
+  { id: 'book_name',        label: '书名',         kind: 'text',        required: true,
+    placeholder: '例如：诡秘之主' },
+  { id: 'genre',            label: '题材',         kind: 'select',      options: GENRE_OPTIONS, required: true },
+  { id: 'target_words',     label: '目标字数',     kind: 'number',      required: true,
+    placeholder: '例如：2000000' },
+  { id: 'target_chapters',  label: '目标章数',     kind: 'number',      required: true,
+    placeholder: '例如：600' },
+  { id: 'core_summary',     label: '一句话故事',   kind: 'text',        required: true,
+    placeholder: '用一句话概括故事核心' },
+  { id: 'core_conflict',    label: '核心冲突',     kind: 'text',        required: true,
+    placeholder: '故事的主要矛盾是什么' },
+  { id: 'hard_constraints', label: '硬门禁',       kind: 'multiselect', required: true,
+    description: '绝对不能违反的约束；可多选；如无约束，输入 "无"' },
+  { id: 'anti_tropes',      label: '反套路',       kind: 'multiselect', required: true,
+    description: '必须避免的俗套；可多选；如无，输入 "无"' },
+];
+
+export const topic = {
+  PLATFORM_OPTIONS,
+  GENRE_OPTIONS,
+  TOPIC_FIELDS,
+  RESCAN_LABEL,
+
+  /**
+   * 路径 A：选平台弹框
+   */
+  askPlatform() {
+    return {
+      id: 'topic-platform',
+      question: '📚 请选择小说计划发布到哪个平台：',
+      options: toAskOptions(PLATFORM_OPTIONS),
+    };
+  },
+
+  /**
+   * 路径 A：选 topic_decision 文件
+   * @param {string[]} decisionFiles - 所有可用的 topic_decision_<date>.md 文件名（不含路径）
+   */
+  askDecisionFile(decisionFiles) {
+    return {
+      id: 'topic-decision',
+      question: '📊 请选择参考的扫榜分析文件：',
+      options: [
+        ...decisionFiles.map(f => ({ label: f })),
+        { label: RESCAN_LABEL },
+      ],
+    };
+  },
+
+  /**
+   * 路径 B：8 字段弹框
+   *
+   * 问题对象只允许 DSH 的合法字段：id / question / detail / header /
+   * options / multiSelect / intent。
+   *
+   * placeholder / default / question 上的 description 都**不是** DSH 的字段，
+   * 传了会被运行时静默忽略（与 options.value 同类问题）—— 所以：
+   *   - placeholder 里的示例、description 里的字段说明，都写进**标题行**
+   *     （question 的第一行），归到标题的括号里；
+   *   - "📌 当前值"和"💡 推荐值"写进 **detail**（不是 question）：
+   *     question 在 web 端被渲染成 <h2>，那条 CSS 没有 white-space: pre-wrap，
+   *     换行会被折成空格，标题和两个值会挤在同一行；detail 才是两端
+   *     都独立成块、都能换行的字段（web 走 markdown 硬换行，TUI 逐行渲染）；
+   *   - default 字段直接删掉：DSH 没有"预填输入框"的能力，
+   *     上次的值通过 detail 里的 "📌 当前值" 展示，能力不丢。
+   *
+   * @param {object} [opts]
+   * @param {object} [opts.currentValues] - _novel_topic.json 中的值（已按平台过滤）
+   * @param {object} [opts.suggestionValues] - _novel_topic_suggestion.json 中的值（已按平台过滤）
+   */
+  askFields(opts = {}) {
+    const { currentValues = {}, suggestionValues = null } = opts;
+    return TOPIC_FIELDS.map(f => {
+      const curVal = currentValues[f.id];
+      const sugVal = suggestionValues ? suggestionValues[f.id] : undefined;
+
+      // null / undefined / '' / 空数组 / 数字 0 → 视为无值
+      // （target_words / target_chapters = 0 是骨架模板的默认值，无意义）
+      const hasValue = (v) =>
+        v !== undefined && v !== null && v !== '' &&
+        !(Array.isArray(v) && v.length === 0) &&
+        !(typeof v === 'number' && v === 0);
+
+      const fmt = (v) => (Array.isArray(v) ? v.join('、') : String(v));
+      const curStr = hasValue(curVal) ? fmt(curVal) : '';
+      const sugStr = hasValue(sugVal) ? fmt(sugVal) : '';
+
+      // 标题 = 字段名 + （必填，示例 / 说明）
+      // 示例（placeholder）与说明（description）都归到括号里。
+      const titleBits = [];
+      if (f.required) titleBits.push('必填');
+      if (f.placeholder) titleBits.push(f.placeholder);
+      if (f.description) titleBits.push(f.description);
+      const title = titleBits.length ? `（${titleBits.join('，')}）` : '';
+      const titleLine = `📝 ${f.label}${title}：`;
+
+      // 当前值 / 推荐值放 **detail**，不放 question。
+      //
+      // 为什么不能放 question：两端渲染方式不一样。
+      //   web 端把 question 渲染成 <h2 class="title">，那条 CSS 没有
+      //     white-space: pre-wrap —— HTML 默认会把 \n 折成空格，于是
+      //     "标题 + 当前值 + 推荐值"挤在同一行（用户实测过）。
+      //   TUI 端是 <Text>{question.question}</Text>，\n 会换行。
+      // 同一份内容两端表现不一致，必须改用两端都支持的 detail。
+      //
+      // detail 是独立的块，两端都是：
+      //   web 端 → 标题下方的 <div class="detail">（走 MarkdownText）
+      //   TUI 端 → detail.split('\n') 逐行渲染（dim 文本）
+      //
+      // 但 web 端的 detail 走 markdown：**单个 \n 是"软换行"**，mdast 会把它
+      // 留在 text 节点里，HTML 照样折成空格 —— 还是一行。
+      // 必须用**硬换行**（行尾两个空格）：mdast 产出 break 节点，
+      // DSH 的 MarkdownText 把 break 渲染成 <br>，这才是真换行。
+      // （依据：dsh-web-frontend 的 markdown 渲染器里有
+      //   case "break": <><br/>{"\n"}</>
+      // 而 .markdown 容器没有 white-space: pre-wrap，软换行必被折叠。）
+      //
+      // 两个空格写在字符串字面量里（'  \n'），源码中没有行尾空白，
+      // 不会被格式化工具或编辑器悄悄吃掉。
+      const hints = [];
+      if (curStr) hints.push(`📌 当前值：${curStr}`);
+      if (sugStr) hints.push(`💡 推荐值：${sugStr}`);
+
+      const def = {
+        id: f.id,
+        question: titleLine,
+      };
+      // 没有当前值/推荐值时**不要**给 detail 赋值：DSH 端按
+      // `detail !== undefined` 判断要不要渲染这个块，给空串会渲染出一个
+      // 空 div（web 端还带 8px 下边距），TUI 端会渲染一行空的 dim 文本。
+      if (hints.length) def.detail = hints.join('  \n');
+      if (f.options) def.options = toAskOptions(f.options);
+      // multiSelect 必须在问题对象上声明：DSH 的 UI 靠它决定渲染 checkbox
+      // 还是 radio（dsh-client-ui-user-questions/lib/client.js：
+      // question.multiSelect === true ? "checkbox" : "radio"）。
+      // 不设就是单选，会与标题里"可多选"的说明自相矛盾。
+      if (f.kind === 'multiselect') def.multiSelect = true;
+      return def;
+    });
+  },
+
+  /**
+   * 路径 A 的 LLM 提示词
+   * @param {object} args
+   * @param {string} args.platform - 中文平台名（番茄/起点/晋江/七猫）
+   * @param {string} args.decisionFile - topic_decision_<date>.md 文件名
+   * @param {string} args.blocks - 拼接好的内容块（多个 # start/end 块用 --- 分隔）
+   * @param {number} args.blockCount - 本次平台用到的块数
+   * @param {Array} args.sectionSummary - 按平台分组的全文件块清单
+   *        [{ platform: '起点', blocks: [{ headers: [...] }, ...] }, ...]
+   * @param {string[]} args.notes - 解析备注（写进提示词，让用户看见解析情况）
+   */
+  explorePrompt({ platform, decisionFile, blocks, blockCount, sectionSummary = [], notes = [] }) {
+    const sourceLines = [];
+    if (sectionSummary.length) {
+      // 总数是**块数**（不是平台数）：同一平台可能有多个 -start 块
+      const totalBlocks = sectionSummary.reduce((n, s) => n + s.blocks.length, 0);
+      sourceLines.push(`该文件按平台切分出 ${totalBlocks} 块：`);
+      for (const s of sectionSummary) {
+        sourceLines.push(`  · ${s.platform}（${s.blocks.length} 块）：`);
+        s.blocks.forEach((b, i) => {
+          sourceLines.push(`      ${i + 1}. ${b.headers.join(' / ')}`);
+        });
+      }
+      sourceLines.push(`本次只使用「${platform}」的 ${blockCount} 块。`);
+    }
+    if (notes.length) {
+      sourceLines.push('');
+      sourceLines.push('解析说明：');
+      for (const n of notes) sourceLines.push(`  · ${n}`);
+    }
+    return [
+      `## 选题探索任务`,
+      ``,
+      `平台：${platform}`,
+      `参考文件：${decisionFile}（含 ${blockCount} 个内容块）`,
+      ...(sourceLines.length ? ['', ...sourceLines] : []),
+      ``,
+      `以下是用户选中的 topic_decision 文件中与"${platform}"相关的所有内容块（每块用 ## 块 N 标记）：`,
+      ``,
+      blocks,
+      ``,
+      `请执行以下分析：`,
+      ``,
+      `### 第一部分：8 个字段建议`,
+      `基于扫榜内容，给出以下字段的推荐值（**必须**忽略历史上下文和之前的选择，且**禁止**使用单引号或者双引号）：`,
+      `1. **书名**（book_name）— 根据榜单上同题材书籍的命名方式给出契合本平台风格的建议`,
+      `2. **题材**（genre）— 根据榜单中的热门题材给出契合的建议`,
+      `3. **目标字数**（target_words）— 整数，例如 2000000`,
+      `4. **目标章数**（target_chapters）— 整数，例如 600`,
+      `5. **一句话故事**（core_summary）— 50 字以内概括核心`,
+      `6. **核心冲突**（core_conflict）— 主要矛盾是什么`,
+      `7. **硬门禁**（hard_constraints）— 绝对不能违反的约束（可多值）`,
+      `8. **反套路**（anti_tropes）— 必须避免的俗套（可多值）`,
+      ``,
+      `每个字段请给出一个推荐值 + 一句话解释为什么这样推荐。`,
+      ``,
+      `### 第二部分：6 维评分`,
+      `基于上面给出的建议，对"在 ${platform} 平台写一本新书"这件事，从以下 6 个维度评分（1-10）：`,
+      `1. **市场热度** — 该平台当前题材热度如何，在读人数越多、增长趋势越快、月票积分等指标越高则评分越高`,
+      `2. **竞争格局** — 同类作品的多少。同类作品多+市场热度高->竞争一般，同类作品少+市场热度高->竞争少,竞争越少评分越高`,
+      `3. **受众规模** — 题材潜在读者群大小，读者越多、积分越多则评分越高`,
+      `4. **创作难度** — 作者需要投入的精力，投入精力越少评分越高`,
+      `5. **变现潜力** — 商业化前景，变现能力越强评分越高`,
+      `6. **合规风险** — 低/中/高，风险越低评分越高、风险越高评分越低`,
+      `最后给出综合分（1-10）和是否值得进入的结论。`,
+      ``,
+      `### 第三部分：保存建议`,
+      `在你给出 8 个字段推荐值后，把推荐值保存到 \`_novel_topic_suggestion.json\`：`,
+      `注意：platform 字段必须写平台中文名（"${platform}"），不要写英文 value（如 "qidian"）。` +
+        `所有字段值必须是合法 JSON（双引号、逗号、换行都要转义或避开）。` +
+        `core_summary / core_conflict 中如需引用书名 / 概念，用全角引号"…"或『…』，避免与 JSON 双引号冲突。`,
+      ``,
+      `\`\`\`json`,
+      `{`,
+      `  "book_name": "...",`,
+      `  "genre": "...",`,
+      `  "target_words": 2000000,`,
+      `  "target_chapters": 600,`,
+      `  "core_summary": "...",`,
+      `  "core_conflict": "...",`,
+      `  "hard_constraints": ["..."],`,
+      `  "anti_tropes": ["..."],`,
+      `  "platform": "${platform}",`,
+      `  "source_decision_file": "${decisionFile}"`,
+      `}`,
+      `\`\`\``,
+      ``,
+      `### 第四部分：与用户对话`,
+      `1. **必须**以用户可见的方式**完整**展示出 8 个字段推荐值和 6 维评分`,
+      `2. 提醒用户可继续根据当前给出的 8 个字段推荐值和 6 维评分展开讨论,根据用户的需求进行多次修正,并将用户最终的意见更新至 _novel_topic_suggestion.json 中`,
+      `3. 提醒用户运行 /fancy-topic setup 提交最终决定`,
+    ].join('\n');
+  },
+
+  /**
+   * 通知模板（左侧消息栏）
+   */
+  notify({ type, platform, phase, decisionFile, blockCount, fieldCount, missing, err, projectRoot, extra, available, notes }) {
+    switch (type) {
+      case 'cancelled':
+        return '🚫 已取消';
+
+      case 'no_provider':
+        return '⚠️ 当前环境不支持交互式提问。请在 dsh-tui 中运行此命令，或确保 web UI 已正确加载交互组件。';
+
+      case 'no_project_root':
+        return '❌ 无法确定项目目录：' + (err || '会话未提供 cwd') + '。请在项目目录下运行该命令。';
+
+      case 'ask_failed':
+        return '❌ 提问失败：' + (err || '未知错误');
+
+      case 'not_initialized':
+        return '⚠️ 当前目录尚未初始化，请先运行 /fancy-bootstrap 进行初始化。';
+
+      case 'phase_wrong':
+        return `⚠️ 当前 phase（${phase || '未知'}）不允许运行 /fancy-topic，请先运行 /fancy-scan 扫榜。`;
+
+      case 'phase_unreadable':
+        return (
+          `❌ 状态文件 .fancy-deployed 无法读取（${err || '内容异常'}），无法确定项目状态。\n` +
+          '请检查该文件是否被手工改坏，或重新运行 /fancy-bootstrap 初始化。'
+        );
+
+      case 'no_decision_file':
+        return '⚠️ 未找到 topic_decision_<date>.md 文件。请先运行 /fancy-scan 采集榜单并等待 LLM 分析完成';
+
+      case 'no_decision_block':
+        return (
+          `⚠️ 在 ${decisionFile || '所选文件'} 里没有找到任何 "# 平台-榜单-日期-start/end" 内容块。\n` +
+          '多半是 LLM 没有按约定格式写入，建议重新运行 /fancy-scan 触发分析。'
+        );
+
+      case 'platform_not_in_decision':
+        return (
+          `⚠️ 在 ${decisionFile || '所选文件'} 里没有找到「${platform || ''}」的内容块。\n` +
+          `该文件里已有的块：${(available && available.length) ? available.join('、') : '（无）'}\n` +
+          '请确认是否扫过该平台。'
+        );
+
+      case 'invalid_platform':
+        return `❌ 无效的平台：${platform}`;
+
+      case 'path_a_done': {
+        const noteText = (notes && notes.length)
+          ? '\n' + notes.map(n => 'ℹ️ ' + n).join('\n')
+          : '';
+        return (
+          `📊 已根据扫榜结果请 LLM 分析 ${blockCount || '?'} 个数据块\n` +
+          `📚 平台：${platform || ''}\n` +
+          `📁 参考：${decisionFile || ''}` +
+          noteText + '\n' +
+          `💡 LLM 即将在对话中给出 6 维评分 + 8 字段建议；敲定后请运行 /fancy-topic setup 写入最终决定`
+        );
+      }
+
+      case 'path_b_done':
+        return `✅ 选题已确认！
+下一步：
+运行 /fancy-story-builder 构建故事 (在此之前可选择运行 /fancy-analyze 拆解同题材爆款小说)` +
+          (extra ? '\n\n' + extra : '');
+
+      case 'write_failed':
+        return '❌ 写入 _novel_topic.json 失败：' + (err || '未知错误');
+
+      case 'fields_missing':
+        return `⚠️ 以下必填字段未填写，请补全：${(missing || []).join('、')}`;
+
+      case 'path_a_rescan':
+        return '🔄 已选择重新扫榜。请运行 /fancy-scan';
+
+      case 'create_skeleton':
+        return '📝 未找到 _novel_topic.json，已创建骨架文件';
+
+      default:
+        return String(type);
+    }
+  },
+};