@lemoncat7/dsh-partner 2.8.0 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-long-scan/scripts/qimao-rank-scraper.js

@@ -0,0 +1,435 @@
+#!/usr/bin/env node
+/**
+ * 七猫小说排行榜采集脚本
+ *
+ * 配合 browser-cdp skill 使用。先启动 Chrome CDP 环境，再运行本脚本。
+ * 采集策略：tab 切换男生榜/女生榜和榜单类型，滚动加载后从页面文本解析结构化数据。
+ * 输出 Markdown 格式见 references/platform-qimao.md；aggregate-rank.js 按此格式聚合。
+ *
+ * 用法：
+ *   node qimao-rank-scraper.js --channel male --type hot --period day    # 男生大热榜日榜
+ *   node qimao-rank-scraper.js --channel male --type hot --period month  # 男生大热榜月榜
+ *   node qimao-rank-scraper.js --channel male --type hot --period all    # 日榜+月榜
+ *   node qimao-rank-scraper.js --channel female --type new      # 女生新书榜
+ *   node qimao-rank-scraper.js --channel all --type all         # 全部采集
+ *
+ * 前置：
+ *   node {SKILL_DIR}/browser-cdp/scripts/setup-cdp-chrome.js 9222
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { ab, sleep, evalJSONBase64, scrollLoad, getArg, localDateStamp, runCli } = require("./cdp-utils");
+
+const RANK_URL = "https://www.qimao.com/paihang";
+
+/** 连通性 + 页面就绪自检 */
+function probePage(port) {
+  return evalJSONBase64(
+    port,
+    "JSON.stringify({host:location.host,path:location.pathname,len:(document.body&&document.body.innerText||'').length})"
+  );
+}
+
+const CHANNELS = [
+  { id: "male", label: "男频", tab: "男生榜", path: "boy" },
+  { id: "female", label: "女频", tab: "女生榜", path: "girl" },
+];
+
+const RANK_TYPES = [
+  { id: "hot", label: "大热榜", path: "hot" },
+  { id: "new", label: "新书榜", path: "new" },
+  { id: "finish", label: "完结榜", path: "over" },
+  { id: "collect", label: "收藏榜", path: "collect" },
+  { id: "update", label: "更新榜", path: "update" },
+];
+
+const PERIODS = [
+  { id: "day", label: "日榜", path: "date" },
+  { id: "month", label: "月榜", path: "month" },
+];
+
+// ---------------------------------------------------------------------------
+// 页面操作
+// ---------------------------------------------------------------------------
+
+function rankUrl(channelId, rankTypeId, periodId) {
+  const channel = CHANNELS.find((item) => item.id === channelId);
+  const rankType = RANK_TYPES.find((item) => item.id === rankTypeId);
+  const period = PERIODS.find((item) => item.id === (periodId || "day"));
+  if (!channel || !rankType || !period) return "";
+  return `${RANK_URL}/${channel.path}/${rankType.path}/${period.path}/`;
+}
+
+/** 读取页面实际 active 状态；输出文件标签必须由该状态校验后才能使用。 */
+function extractObservedSelection(port) {
+  const js = `JSON.stringify((function(){
+    function text(selector){var e=document.querySelector(selector);return e?(e.textContent||'').replace(/\\s+/g,'').trim():'';}
+    return {path:location.pathname,channel:text('.qm-switch-tab .item.active'),rankType:text('.child-tabs-item.menu-tab.active'),period:text('.date-type-tabs .tab.active')};
+  })())`;
+  return evalJSONBase64(port, js) || {};
+}
+
+function selectionMatches(observed, channelId, rankTypeId, periodId) {
+  const channel = CHANNELS.find((item) => item.id === channelId);
+  const rankType = RANK_TYPES.find((item) => item.id === rankTypeId);
+  const period = periodId ? PERIODS.find((item) => item.id === periodId) : null;
+  if (!channel || !rankType) return false;
+  const expectedUrl = rankUrl(channelId, rankTypeId, periodId);
+  if (!expectedUrl) return false;
+  const expectedPath = new URL(expectedUrl).pathname;
+  const actualPath = String(observed && observed.path || "").replace(/\/+$/, "/");
+  return !!(
+    actualPath === expectedPath &&
+    String(observed.channel || "").includes(channel.tab) &&
+    observed.rankType === rankType.label &&
+    (!period || observed.period === period.label)
+  );
+}
+
+/**
+ * 从 DOM 获取书籍链接。每本书有多个 anchor（排名数字/书名/最近更新），
+ * 按 bookId 聚合后取最像书名的文本（非纯数字、非"最近更新"前缀、最长），
+ * 否则书名会被排名数字 anchor 覆盖，导致后续按书名回填链接全失败。
+ */
+function extractBookUrls(port) {
+  const js = `JSON.stringify((function(){
+    var byId={};var order=[];
+    Array.from(document.querySelectorAll('a')).forEach(function(a){
+      var h=a.getAttribute('href')||a.href||'';
+      var m=h.match(/\\/(?:shuku|book)\\/([0-9]+)/);
+      if(!m)return; var id=m[1];
+      var t=(a.innerText||a.textContent||'').replace(/\\s+/g,' ').trim();
+      if(!byId[id]){byId[id]='';order.push(id);}
+      if(t&&!/^[0-9]+$/.test(t)&&!/^(最近更新|最新章节|最新)/.test(t)){
+        if(t.length>byId[id].length)byId[id]=t;
+      }
+    });
+    return order.map(function(id){return {bookId:id,title:byId[id],url:'https://www.qimao.com/shuku/'+id+'/'};});
+  })())`;
+  return evalJSONBase64(port, js) || [];
+}
+
+/**
+ * 从页面 innerText 解析结构化书籍数据。
+ * 七猫页面文本结构固定：排名→书名→作者→题材→子分类→状态→字数→简介→更新→热度
+ */
+function extractBooksFromText(port) {
+  const js =
+    "JSON.stringify((()=>{" +
+    "var text=document.body.innerText||'';" +
+    // 找到榜单数据起始位置
+    "var start=-1;" +
+    "['日榜','月榜'].forEach(function(m){if(start<0)start=text.indexOf(m)});" +
+    "if(start<0)return[];" +
+    "var lines=text.substring(start).split(/\\n/);" +
+    "var books=[];var cur=null;var fieldIdx=0;" +
+    "for(var i=0;i<lines.length;i++){" +
+    "  var line=lines[i].trim();" +
+    "  if(!line)continue;" +
+    // 排行数据结束后的分页器/页脚必须立刻截断；否则“5 / 下一页 / 跳转 / 友情链接”
+    // 会被串成一条字段齐全的假书目。
+    "  if(/^(上一页|下一页|跳转|友情链接[:：]?)$/.test(line)){if(cur&&cur.title)books.push(cur);cur=null;break}" +
+    // 排名标记：独立数字 1-99
+    "  if(/^\\d{1,2}$/.test(line)&&parseInt(line)<100){" +
+    "    if(cur&&cur.title)books.push(cur);" +
+    "    cur={rank:parseInt(line),title:'',author:'',genre:'',subGenre:'',status:'',words:'',heat:'',update:'',desc:''};" +
+    "    fieldIdx=0;continue" +
+    "  }" +
+    "  if(!cur)continue;" +
+    // 跳过 UI 文字
+    "  if(/^(加入书架|立即阅读|蝉联|榜首)/.test(line))continue;" +
+    // 热度
+    "  var hm=line.match(/([\\d.]+)\\s*万\\s*热度/);" +
+    "  if(hm){cur.heat=hm[1]+'万';continue}" +
+    // 最新更新
+    "  if(line.indexOf('最近更新')===0){cur.update=line.replace(/^最近更新\\s*/,'');continue}" +
+    // 状态
+    "  if(/^(连载中|已完结)$/.test(line)){cur.status=line;continue}" +
+    // 字数
+    "  if(/^[\\d.]+万字$/.test(line)){cur.words=line;continue}" +
+    // 按序填充：书名→作者→题材→子分类
+    "  if(fieldIdx===0){cur.title=line;fieldIdx=1;continue}" +
+    "  if(fieldIdx===1){cur.author=line;fieldIdx=2;continue}" +
+    "  if(fieldIdx===2){cur.genre=line;fieldIdx=3;continue}" +
+    "  if(fieldIdx===3){cur.subGenre=line;fieldIdx=4;continue}" +
+    // 其余为简介
+    "  cur.desc+=(cur.desc?' ':'')+line" +
+    "}" +
+    "if(cur&&cur.title)books.push(cur);" +
+    "return books" +
+    "})())";
+  return evalJSONBase64(port, js) || [];
+}
+
+/**
+ * 排除分页器等被正文文本解析器误认成的伪书目。
+ * 七猫榜单尾部会出现“5 / 下一页”这类纯 UI 文本；有效条目必须同时有正排名、书名和作者。
+ */
+function isUsableBook(book) {
+  return !!(
+    book &&
+    Number.isInteger(book.rank) &&
+    book.rank > 0 &&
+    book.title &&
+    book.author &&
+    !/^(上一页|下一页|跳转)$/.test(book.title) &&
+    !/^(上一页|下一页|跳转|友情链接[:：]?)$/.test(book.author)
+  );
+}
+
+function cleanDesc(value) {
+  const text = String(value || "")
+    .replace(/\s*(?:飙升|上升|下降)\s*\d+\s*名\s*$/g, "")
+    .replace(/\s*(?:上一页|下一页)\s*$/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+  if (text.length <= 100) return text;
+  const cut = text.slice(0, 100);
+  const sentence = cut.match(/^[\s\S]*[。！？]/);
+  return (sentence ? sentence[0] : cut) + "...";
+}
+
+function summarizeQuality(books, rawCount) {
+  const linked = books.filter((book) => book.url).length;
+  const heated = books.filter((book) => book.heat).length;
+  const fieldCounts = [
+    ["题材", "genre"],
+    ["子分类", "subGenre"],
+    ["状态", "status"],
+    ["字数", "words"],
+    ["热度", "heat"],
+  ].map(([label, field]) => ({
+    label,
+    missing: books.filter((book) => !book[field]).length,
+  }));
+  const problems = [];
+  if (rawCount > books.length) problems.push(`移除无效/UI条目 ${rawCount - books.length} 条`);
+  if (linked < books.length) problems.push(`作品页链接缺失 ${books.length - linked} 条`);
+  for (const field of fieldCounts) {
+    if (field.missing) problems.push(`${field.label}缺失 ${field.missing} 条`);
+  }
+  if (books.length < 15) problems.push(`[数据稀疏] 实际采集 ${books.length} 条`);
+  return {
+    linked,
+    heated,
+    problems,
+    quality: problems.length ? "[存在问题]" : "[OK]",
+  };
+}
+
+function renderMarkdown(ch, rt, period, url, books, rawCount, now = new Date().toISOString()) {
+  const periodLabel = period ? period.label : "";
+  const summary = summarizeQuality(books, rawCount);
+  const lines = [
+    `# 七猫 · ${ch.label} · ${rt.label}${periodLabel}`,
+    "",
+    `- 数据质量：${summary.quality}`,
+    `- 有效条目：${books.length} / ${rawCount}`,
+    `- 问题摘要：${summary.problems.length ? summary.problems.join("；") : "无"}`,
+    `- 作品页链接：${summary.linked} / ${books.length}`,
+    `- 热度命中：${summary.heated} / ${books.length}`,
+    `- 来源：${url}`,
+    `- 抓取时间：${now}`,
+    `- 条目数：${books.length}`,
+    "",
+    "---",
+    "",
+  ];
+
+  for (const b of books) {
+    try {
+      lines.push(`### #${b.rank} ${b.title}`);
+      const meta = [
+        b.author || "[待补]",
+        b.genre || "[待补]",
+        b.subGenre || "[待补]",
+        b.status || "[待补]",
+        b.words || "[待补]",
+        b.heat ? b.heat + "热度" : "[待补]",
+      ].join(" · ");
+      lines.push(`*${meta}*`);
+      if (b.update) lines.push(`**最新更新：** ${b.update}`);
+      if (b.url) lines.push(`[作品页](${b.url})`);
+      const desc = cleanDesc(b.desc);
+      if (desc) {
+        lines.push("");
+        lines.push("**简介**");
+        lines.push("");
+        lines.push(desc);
+      }
+      lines.push("", "---", "");
+    } catch (bookErr) {
+      console.error(`[qimao] ${ch.label}${rt.label} 第${b.rank}条处理出错: ${bookErr.message}`);
+      lines.push("", "---", "");
+    }
+  }
+
+  return lines.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// 主流程
+// ---------------------------------------------------------------------------
+
+const args = process.argv.slice(2);
+const PORT = parseInt(getArg(args, "--port") || "9222", 10);
+const OUTDIR = getArg(args, "--outdir") || ".";
+const CHANNEL = getArg(args, "--channel") || "male";
+const RANKTYPE = getArg(args, "--type") || "hot";
+const PERIOD = getArg(args, "--period") || "day";
+
+function scrapeRank(port, channelId, rankTypeId, periodId) {
+  const ch = CHANNELS.find((c) => c.id === channelId);
+  const rt = RANK_TYPES.find((r) => r.id === rankTypeId);
+  const period = periodId ? PERIODS.find((p) => p.id === periodId) : null;
+  if (!ch || !rt) {
+    console.log("  ⚠ 未知频道或榜单类型");
+    return null;
+  }
+
+  const periodLabel = period ? period.label : "";
+  const url = rankUrl(channelId, rankTypeId, periodId);
+  console.log(`\n→ 采集 七猫${ch.label}${rt.label}${periodLabel}...`);
+
+  let books, urls, rawCount;
+  try {
+    ab(port, "open", url);
+    sleep(3000);
+
+    // 连通性自检：CDP 未起/被重定向时给可操作报错，而非静默产空
+    const probe = probePage(port);
+    if (!probe) {
+      console.error(
+        `  ✗ CDP 无响应。请确认已用 browser-cdp 启动 Chrome（端口 ${port}），且 agent-browser 可用。`
+      );
+      return null;
+    }
+    if (probe.host && probe.host.indexOf("qimao") === -1) {
+      console.error(`  ✗ 当前页面非七猫（host=${probe.host}），可能被重定向，已跳过。`);
+      return null;
+    }
+    const observed = extractObservedSelection(port);
+    if (!selectionMatches(observed, channelId, rankTypeId, periodId)) {
+      console.error(
+        `  ✗ 页面实际榜单与请求不一致（请求 ${ch.tab}/${rt.label}/${periodLabel || "日榜"}，` +
+        `实际 ${observed.channel || "?"}/${observed.rankType || "?"}/${observed.period || "?"}，path=${observed.path || probe.path || "?"}），已跳过。`
+      );
+      return null;
+    }
+    console.log(`  ✓ 已验证页面实际榜单：${observed.channel}/${observed.rankType}${observed.period ? "/" + observed.period : ""}`);
+
+    // 滚动加载更多
+    scrollLoad(port, 5);
+    sleep(1000);
+
+    // 文本解析获取书籍数据 + DOM 获取链接
+    const rawBooks = extractBooksFromText(port);
+    rawCount = rawBooks.length;
+    books = rawBooks.filter(isUsableBook);
+    urls = extractBookUrls(port);
+  } catch (err) {
+    console.error(`[qimao] ${ch.label}${rt.label}${periodLabel} 页面加载或提取出错: ${err.message}`);
+    return null;
+  }
+
+  if (!books.length) {
+    console.error(`[qimao] 采集失败：页面结构可能已变（选择器没匹配到数据），请检查榜单URL或更新选择器 (${RANK_URL} ${ch.label}${rt.label}${periodLabel})`);
+    return null;
+  }
+
+  // 按标题匹配 URL（书名归一后比对，吸收空白差异）
+  const norm = (s) => (s || "").replace(/\s+/g, "");
+  for (const b of books) {
+    try {
+      const matched = urls.find((u) => norm(u.title) === norm(b.title));
+      if (matched) b.url = matched.url;
+    } catch (matchErr) {
+      console.error(`[qimao] URL匹配出错（#${b.rank} ${b.title}）: ${matchErr.message}`);
+    }
+  }
+
+  const summary = summarizeQuality(books, rawCount);
+  console.log(
+    `  ✓ 提取 ${books.length} 本（链接 ${summary.linked}/${books.length}，热度 ${summary.heated}/${books.length}）`
+  );
+  return renderMarkdown(ch, rt, period, url, books, rawCount);
+}
+
+function buildTargets(channel, rankType, period) {
+  const channels = channel === "all" ? CHANNELS.map((item) => item.id) : [channel];
+  const rankTypes = rankType === "all" ? RANK_TYPES.map((item) => item.id) : [rankType];
+  const targets = [];
+  for (const channelId of channels) {
+    for (const rankTypeId of rankTypes) {
+      if (rankTypeId === "hot") {
+        const periods = period === "all" ? PERIODS.map((item) => item.id) : [period];
+        for (const periodId of periods) {
+          targets.push({ channel: channelId, rankType: rankTypeId, period: periodId });
+        }
+      } else {
+        targets.push({ channel: channelId, rankType: rankTypeId, period: null });
+      }
+    }
+  }
+  return targets;
+}
+
+function outputFilename(channelId, rankTypeId, periodId, date) {
+  const channel = CHANNELS.find((item) => item.id === channelId);
+  const rankType = RANK_TYPES.find((item) => item.id === rankTypeId);
+  const period = periodId ? PERIODS.find((item) => item.id === periodId) : null;
+  return `七猫${channel.label}${rankType.label}${period ? period.label : ""}_${date}.md`;
+}
+
+function main() {
+  if (CHANNEL !== "all" && !CHANNELS.some((channel) => channel.id === CHANNEL)) {
+    throw new Error(`未知 --channel: ${CHANNEL}`);
+  }
+  if (RANKTYPE !== "all" && !RANK_TYPES.some((rank) => rank.id === RANKTYPE)) {
+    throw new Error(`未知 --type: ${RANKTYPE}`);
+  }
+  if (PERIOD !== "all" && !PERIODS.some((period) => period.id === PERIOD)) {
+    throw new Error(`未知 --period: ${PERIOD}`);
+  }
+  const targets = buildTargets(CHANNEL, RANKTYPE, PERIOD);
+  let written = 0;
+  let failed = 0;
+
+  for (const target of targets) {
+    const content = scrapeRank(PORT, target.channel, target.rankType, target.period);
+    if (!content) {
+      failed++;
+      continue;
+    }
+
+    const filename = outputFilename(target.channel, target.rankType, target.period, localDateStamp());
+    fs.mkdirSync(OUTDIR, { recursive: true });
+    const filepath = path.join(OUTDIR, filename);
+    fs.writeFileSync(filepath, content, "utf-8");
+    written++;
+    console.log(`  ✓ 已保存: ${filepath}`);
+  }
+  return {
+    planned: targets.length,
+    written,
+    failed,
+    partial: failed > 0,
+    partialReasons: [],
+  };
+}
+
+if (require.main === module) {
+  runCli(main, "七猫采集");
+}
+
+module.exports = {
+  extractBooksFromText,
+  isUsableBook,
+  cleanDesc,
+  renderMarkdown,
+  rankUrl,
+  selectionMatches,
+  buildTargets,
+  outputFilename,
+};

package/resources/skills/story-creation/upstream/skills/story-long-write/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: story-long-write
+version: 1.0.0
+description: "长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲，明确要求正文后再写章节。触发方式：/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。"
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
+---
+# story-long-write：长篇网文写作
+
+你是网络小说创作教练，帮用户从选题、大纲到正文写完一本长篇网络小说。
+
+## 写前必读（强制，先读后写）
+
+任何创建或修改长篇故事文件的动作前，先判断场景并读完下列文件。**只读本 SKILL.md 不算完成；`rg` 检索或局部摘读也不算完整读取。**
+
+必须分块读到 EOF：
+
+1. 规划按时刻读：定方向、定设定读 `references/workflow-setup.md`，出卷纲读 `references/workflow-volume.md`，出细纲或补纲读 `references/workflow-outline.md`，只读当前时刻的；写指定章读取 `references/workflow-chapter.md`；日更先读取 `references/workflow-daily.md`，进入正文前再完整读取 `workflow-chapter.md`；大修先读 `references/workflow-revision.md`，改稿时还要读什么由它写明。
+2. 主会话直接写正文时，首次落笔前完整读取 `references/long-format.md` 与 `references/writing-craft.md`（和写手同一套技法）；`references/long-chapter-quality.md`、`references/long-chapter-hooks.md` 只在排查具体问题时读，去味走检测器，不预读。交给 narrative-writer 时，由该 agent 按自己的 reference 表完成写前读取，主会话不得用未读 reference 的临时 prompt 替代。
+3. 本章技法按下方「本章技法」一段选，至多一份；主会话自己写时按那段只读指定小节，这是本条唯一允许的按节读。
+4. 正文写前，references 读完后立即重读当前用户请求、本章细纲和卷纲，先在上下文里**记下本轮约束**：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法，不得覆盖这些项目事实；作者给的字数范围写在细纲「字数范围」行（命令参数只作临时覆盖），有它就不用默认 ±15%。交付前逐项复核：字数带外按 `workflow-chapter.md` 的收口流程交用户处置，不自动补字；其余项越界不算完成。
+
+任一必需路径不存在、不可读或未读完时立即停止，报告准确路径，**不得先写正文再补读**。写前必读按当前任务、当前会话重新执行；旧会话的“读过”不能沿用。
+
+---
+
+> 内置适配 Claude Code / OpenCode / Codex / Antigravity / ZCode / OpenClaw。专业 agent 只查当前端 canonical 目录（`.claude/agents`、`.opencode/agents`、`.codex/agents` TOML、`.agents/agents`）；Antigravity 用 `invoke_subagent` + 同名 `TypeName`。文件或运行时能力缺失、返回 unknown agent，或当前为不执行 custom agents 的 ZCode 3.3.4 时，报告 fallback 并 solo/direct 执行。
+>
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时用一句白话提示作者「写作助手是旧版，运行 /story-setup 后新开对话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 原文写进技术备注行；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，`Fallback: ... -> solo` 同样只进技术备注行。
+
+**文风裁决**：正文写作、改写或审稿前先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风并形成 `style_resolution`；无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
+
+## 核心方法
+
+先抓情绪，再用验证过的模式可靠交付，灵感只做素材：每个场景服务一个说得清的目标情绪；从对标里找验证过的剧情模式，把对标角色当功能位，用本书的角色和素材填；写每章只读「不知道就会写错」的状态、伏笔与设定。契约与推进决策先过 `references/reader-contract-and-progression.md`「契约四问」。作者记忆：写正文时组装脚本已代查注入；其他任务直接跑 `{PYTHON} {skill 根}/scripts/author_memory_commit.py query --workspace {放 .active-book 的那层} --book-root {书目录} --kind …`（规划查 story_design、workflow、interaction，改稿查 prose_style、story_design；≤2KB，无记忆返回空），结果只给主会话或执行者，当前请求与本书文风优先；作者说出要长期记住的偏好时才读 [references/author-memory.md](references/author-memory.md) 按它 `record` 写入、回传回执。
+
+**本章技法（每章至多读一份）**：按细纲主功能选——打脸/逆袭（爽感释放）`style-combat-face.md`；身份/认知/立场反转（震撼+痛快）`long-reversal.md`；感情拉扯（意难平）`emotional-methods.md`，自己写时加 `emotion-on-page.md`；悬疑/惊悚/异常线索（紧张+好奇）`long-suspense.md`；日常装逼（期待感）`long-chapter-hooks.md`。都不对应就不读，按 writing-craft 写。交给写手时只在 prompt「本章技法」填类别，由写手整份读；主会话自己写正文时只读该文件的「决策路由」和它指向的那一节（先看标题定位，不整读），日更一批只读一份，按本批最需要的那章选，其余章按 writing-craft 写。作者先说情绪没说题材时按括号反查，再从 `long-genre-catalog.md` 找细分方向。
+
+---
+
+## 写作流程
+
+先确定操作对象、交付范围和停点，再看项目状态；空项目不等于授权完整开书。范围与转正文的权威规则如下。
+
+| 场景 | 触发条件 | 执行流程 |
+|------|----------|----------|
+| **结构讨论** | "只讨论/推敲故事结构" | 只交付结构方案，不建工程、不自动落盘；不要求先填完设定或细纲 |
+| **大纲规划** | "写大纲/规划剧情/规划全书/规划第X卷/开新卷" | 按需取 Phase 1→3，交付所请求大纲/卷纲及必要设定；不自动展开细纲或初始化追踪 |
+| **细纲规划** | "出细纲/补纲/扩纲/补细纲/写或修改第N章细纲" | Phase 3：既有单元内只补/改点名章；需要新单元才走「中途补纲/扩纲小流程」。指定范围不扩到整单元；未指定时按剧情批建纲 |
+| **开书** | "帮我开书"，未限定规划层级 | 按确认点逐个走：定方向→定设定→卷纲→首批 10 章细纲，每个确认点作者说继续才往下；**最远停在细纲交付，不自动写正文** |
+| **定设定** | "定设定"，或已有题材定位、还没有角色与关系 | 定设定时刻：`references/workflow-setup.md` Phase 2，交付设定后停 |
+| **写指定章** | "写第 N 章" / "写第1章" / "开书并写首章"，对象是正文 | Phase 4→5，只写点名章后停止；缺前置时先补必要设定、卷纲和点名章细纲，不套用完整开书的 10 章默认 |
+| **日更续写** | 关键词（"日更"/"续写"/"继续写"）**且**项目已有正文+追踪 | 加载 `references/workflow-daily.md` |
+| **大修** | "修改第X章" / "回炉" / "重写第X章"，对象是已写正文 | 加载 `references/workflow-revision.md`；只改细纲不进此流程 |
+
+**对象优先**："写/修改第N章细纲"是规划，不因命中"写/修改第N章"而写正文；"以后再写正文"不是本轮授权。仅规划要求优先于旧日更任务，停止旧批量。对象不明或同一请求范围冲突时，只确认冲突项。
+
+**规划续接**："继续/按这个来/确认方案"不扩大范围，完成即停，不自动转细纲或正文；"继续写/接着写"指正文——下一章有细纲就写，上一轮在规划就只问一句「要接着写第N章正文吗？」（默认是），缺细纲则问是否先补。规划模式不写入追踪或作者记忆，不调用 narrative-writer。开新卷时新角色/势力/设定回 Phase 2 增量补，Phase 3 只做到请求层级。
+
+**转入正文**：明确的正文请求只授权进入写作流程。落正文前重新完成本轮「写前必读」，按 workflow-chapter 处理缺 state、使 `tracking_commit.py check` 通过，任一未完成就停止；之后按原流程写作、质检、提交，不再问是否继续。
+
+### 裸调用与停靠点（防失控）
+
+`/story-long-write` 或 `$story-long-write` **裸调用**（无明确意图）时，只诊断项目并列选项，**不得自动进入正文写作，也不得把已有项目默认为日更 3 章**：
+
+- 空项目 → 「讨论结构」「写大纲」「帮我开书」；
+- 有纲无正文 → 「补细纲」「写第1章」；
+- 有正文+追踪 → 展示进度与下一章细纲状态，列「规划下一卷」「日更2章」「修改第X章」。
+
+**正文批量上限**：写正文须用户显式给出章节范围或日更意图；单章默认 1 章，日更默认 2-3 章，单轮最多 3 章，超出的在汇报里提示下轮继续。**匹配顺序**：只规划按 结构讨论 → 细纲规划 → 大纲规划 → 开书，越窄越优先；要正文按 大修 → 写指定章 → 日更续写；日更前置不齐则提示补齐或写第1章。同批"继续/续写/日更"仍走 workflow-daily 的完整串行流程；切到规划后不恢复旧日更批量。
+
+无法判断场景时，给 2-4 个白话选项（如「只聊结构」「写大纲」「写第N章正文」）让用户选，不贴场景表，也不开放式提问。
+
+### 面向作者的汇报
+
+所有给作者看的汇报、提问和停下说明只讲三件事：写了/改了什么（章名、发生了什么）；要作者定的事（一句白话问题＋白话选项＋推荐默认）；下一步。不写脚本、字段、参数名、状态码和内部清单名（如 排纲自查、供给自查、S1-S4、字数带）；编号必带故事标签，如「伏笔 F057（那封信的去处）」。检查结果一句白话带过，如「自查过设定和前文，没发现冲突」。回执、Notice、Fallback 等机器行只放最末一行「技术备注：」，其前可有一句下一步建议（如新开对话）。汇报照各 workflow 的模板写，不带代码块围栏；子 agent 返回的术语由主会话翻译后再说。
+
+### 路径与术语约定
+
+> `{PYTHON}` 依次试 `python3`、`python`、`py -3`，用第一个能跑的；`{skill 根}` 是本 skill 所在目录。
+>
+> **对标书路径查找**：优先 `{项目}/对标/{书名}/`，不存在则回退 `拆文库/{书名}/`（`拆文库/` 是拆文原始产出，`对标/` 是本项目引用视图，首次引用的复制规则见 workflow-setup.md「对标发现」第 3 条）。
+>
+> **卷纲不整读**：一律走 `{PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}`（只要契约用 `--contract`，看目录用 `--toc`）；找不到单元就核对单元ID或先补卷纲，不改用整读。排纲底稿放 `大纲/排纲底稿_{单元ID}.md`，只在排纲/补纲时读；取段器的作用域、历史与校验选项见 artifact-protocols.md 卷纲模板。
+>
+> **新增物三级**（排纲、写正文、处置共用；只看下一章需不需要知道它存在过）：
+> - **直接写**：微连接、路人、器物、地名细部、一次性对话、现场细节；不申报。
+> - **写了要报**：具名配角、势力、复用地点属性、能力形态、规矩、刻度、新伏笔、新关系或承诺、给主角留下的东西；照写并逐条进申报表（类型／名目／落在哪／后续义务；无写 `0`；末行「本章没写成的」），主会话核对后才算续写事实。
+> - **先问作者**：新主线事件或反转、金手指规则与力量档位、真相或伏笔结算、经济锚点、读者契约、提前写后续章、改变细纲已定结果或人物决定、卷纲新增编号、碰主推线或终局底牌、与既有裁定或承诺冲突；写正文时不写，排纲时挂起列候选，由主会话问作者。
+> 拿不准：写时按写了要报，处置时按先问作者。
+
+---
+
+### Phase 1–3：开书与规划
+
+按作者确认点分时刻读（见首屏写前必读第 1 条）；每个时刻文件开头写了本时刻的交接规则，出卷纲、出细纲时不必再读 workflow-setup.md。
+
+---
+
+### Phase 4：正文写作辅助
+
+#### 项目文件与产物
+
+要找某类产物放哪、或修复缺失文件时，完整读取 [references/project-files.md](references/project-files.md) 照做；开书建文件按各时刻文件写明的路径直接落盘，写正文时缺文件按 workflow-chapter 开头停下修，都不必先读它。
+
+#### 单章写作流程
+
+**执行前先读 [references/workflow-chapter.md](references/workflow-chapter.md)**，按其步骤 1-13 执行。日更批量另加载 `references/workflow-daily.md`。
+
+#### 追踪
+
+所有追踪写入都走 `scripts/tracking_commit.py`：`追踪/_tracking-state.json` 是唯一权威，`上下文.md`、角色快照、`伏笔.md`、时间线都由它派生，禁止手改。体积上限由脚本检查、超限一次报全；字段与上限见 [tracking-transaction.md](references/tracking-transaction.md)，出错时才读。
+
+---
+
+## 流程衔接
+
+**流水线：** 长篇
+**位置：** 写作（第 3/3 步）
+
+| 时机 | 跳转到 | 命令 |
+|---|---|---|
+| 写完，去 AI 味 | story-deslop | `/story-deslop` |
+| 想对比参考书 | story-long-analyze | `/story-long-analyze` |
+| 需要市场方向 | story-long-scan | `/story-long-scan` |
+| 太长，适合短篇 | story-short-write | `/story-short-write` |
+
+---
+
+## 参考资料索引
+
+阶段必读项按首屏「写前必读」执行；写正文不按索引加读；规划或作者点名问技法时按 [参考索引](references/reference-index.md) 的加载条件选用。
+
+## 语言
+
+- 跟随用户的语言回复，用户用什么语言就用什么语言回复
+- 中文回复遵循《中文文案排版指北》

package/resources/skills/story-creation/upstream/skills/story-long-write/references/agent-calls.md

@@ -0,0 +1,47 @@
+# agent-calls.md：spawn 子代理的调用方式
+
+只在要 spawn 对应 agent 时读；主会话自己写正文、自己排纲时不读。何时调用由各流程文件决定，这里只放 prompt 与必须附带的内容。Antigravity 用 `invoke_subagent` + 同名 `TypeName`。
+
+## narrative-writer：写一章
+
+全章细纲交给写手统筹编排，默认同一 session 按前后两组交付：按实际叙述顺序在自然转场或因果停顿处分组，不在一句对话或同一动作中间截断，可交错情节点但不增删批准内容、不拆逐点字数配额；写手先把前组写到工作目录 `前组.md`，主会话只调用一次 `storyctl.py wordcount checkpoint --file {segment} --project {项目根} --chapter {N}`，把 `actual / remaining_user_range` 连同后组交回同一写手，两组按原文拼接，不回改前组追字数。作者明确要求一次成文时执行安排填「全章」，直接落盘，不跑 checkpoint。
+
+组装脚本的输出（`====` 以上）就是 prompt 骨架。**主会话填九槽**（搜 `［主会话填］`）：执行安排 ／ 本章意图 ／ 作者本轮要求 ／ 本章技法（只填类别，写手自己读）／ 本节速记 ／ 涉及角色（列名字，角色卡写手自己读）／ `genre_prose_card` ／ 必读设定 ／ `style_resolution`；外加脚本标出的条件槽（降档不成立时的情绪与节奏召回；作者偏好限定范围记忆，适用时带 `--genre`／`--workflow` 跑 SKILL.md「核心方法」的 query 命令补查）。`author_preferences` 由脚本注入，只作低优先级倾向。空槽以外一字不改，整份照抄进 Agent prompt。脚本**跑不起来**时读 [writer-prompt-fallback.md](writer-prompt-fallback.md) 手动组装并报 `Fallback: build_writer_prompt -> 手动组装`。
+
+## story-architect：定设定、出卷纲、出一批细纲（换新上下文）
+
+先跑 `{PYTHON} {skill 根}/scripts/build_architect_brief.py --project {书目录} --task world`（卷纲 `--task volume --volume {N}`，细纲 `--task outline --chapters {A-B}`，一批最多 10 章），只取输出里的任务包路径，不读包的内容。交接前确认作者在对话里定下的方向、偏好和否掉的方案都已写进 `设定/`。
+
+Prompt：`项目目录：{dir}\n任务包：{任务包路径}\n先完整读取任务包，按包里的流程与模板完成；作者已定的方向、设定和要求都在 设定/，对话内容不会传给你\n交付后只回任务包开头要求的几项`
+
+收回后主会话：设定提案拿给作者逐项确认，按作者意见改文件；新卷纲跑 `outline_view.py --check --strict {卷纲路径}`（往旧卷纲追加单元去掉 `--strict`），细纲每章跑 `check-outline-contract.js`；失败把报错原样交回同一 agent 修一次。按 workflow-volume.md / workflow-outline.md 的汇报模板用故事话告诉作者，不转述任务包。
+
+## story-architect、character-designer：题材定位与角色细化（可选）
+
+定方向以和作者来回讨论为主，默认主会话自己做；复杂世界观、多线结构、强反转工程或作者明确要求时才派：
+- `Agent(subagent_type: "story-architect", prompt: "项目目录：{dir}\n任务类型：题材定位\n查询参数：{作者选定的方向与对标信息}")`
+- `Agent(subagent_type: "character-designer", prompt: "项目目录：{dir}\n任务类型：角色设定\n查询参数：{主角设定信息}")` — 辅助角色设定和语言风格档案
+
+## consistency-checker：写正文后的事实核对
+
+Prompt：`项目目录：{dir}\n检查范围：{本次写作的章节}\n检查类型：事实冲突+伏笔断线+角色属性不一致\n本章新增申报：{申报表原样粘贴，无则写 0}；同时核对正文有无未申报的跨章事实，逐处列原文和细纲出处。只读与新增项和本章出场角色相关的设定、角色卡与追踪条目。冲突按 S1-S4 报出，申报项逐条给出登记/修复/先问作者的建议\n状态：last_committed_chapter={N}，state_revision={R}（取自 tracking_commit.py check）`
+
+## narrative-writer：审查+去AI味
+
+Prompt：`项目目录：{dir}\n任务描述：审查+去AI味\n检查分工：你负责语义去味及原定自检；最终文件扫描由主会话执行\n检查范围：{本次写作的章节}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{本章 query 命中的 prose_style/story_design 项}\n触发本次审查的检测结果：{chapter check 里 blocking 与语义类 advisory 的行号和类别，原样粘贴}\n所选 Gate：{按检测类别选，如 B 句式、G 解释腔；类别不明写 A-G}\n删除优先：每条 AI 味项先判能否删除，删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色\n按你的 7 Gate 与对话自检执行，台词里的工整否定不因脚本豁免而跳过\n删除测试：按 deslop-gates.md「写法抽查」执行，报告列候选数/删改数/保留理由`
+
+## narrative-writer：超字一次净删（compress-once）
+
+Prompt：`项目目录：{dir}\n任务描述：净删压缩\n正文：{正文路径}\n删除区间：{chapter check 给的 remove_to_internal_band}\n只删不增：优先删重复解释、装饰排比、无功能微动作；全部情节点、事实、因果、情绪兑现、钩子都保留，不改写成新句\n文风路径：{设定/文风.md 全文路径}`
+
+## narrative-writer：改写一章（大修）
+
+Prompt：`项目目录：{dir}\n任务描述：改写已写章节\n正文：{正文路径}（原稿已备份）\n细纲：{细纲路径}\n改动范围：{局部：哪几段或哪个场面，要改成什么／整章：按细纲重写}\n作者本轮要求：{作者原话要点}\n不动的部分：{局部修改时其余段落一字不改}\n衔接：{前一章结尾与后一章开头各一两句}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{prose_style 查询结果，无写「无」}\n不借改稿新增细纲外的剧情；交付后回：改了哪些段、新增申报（无写 0）`
+
+## story-explorer：写前对标召回
+
+召回降档不成立、项目已部署 story-explorer 时，可一次召回文风/模块材料（不可用就按 benchmark-recall.md 自己召回）：
+- 查询类型：`benchmark_style_load`；传入项目目录、章节号、目标基调/字数和爽点类型。
+- 需要返回：`style_profile_path`、`style_profile_summary`、`selected_emotion_module`、`rhythm_reference`、来源路径、匹配章节、锚点片段、`gaps`。
+- `gaps` 分流：`no_benchmark` → `custom_style` 为真则用 `设定/文风.md` 写、情绪/节奏取本书内部材料，否则标「无对标参考」；`missing_primary_contract` → 按 `repair_action` 修复（重跑拆文或导入）并停止生成，自定义文风不豁免；`benchmark_book_missing` → 停止核对登记名，不换书；`conflict` / `module_rhythm_conflict` → 意图里说明冲突并按情绪模块/节奏的权威执行；profile_missing → custom_style 为真则用本书文风继续，否则停止；`profile_degenerate` → 有本书文风就用，没有回默认；`tone_match_failed` → 只用整书文风。其余字段原样进 writer prompt，`gaps` 原值保留在写前准备记录里。
+- 主会话另行直接读 `设定/文风.md`：含实质内容时作为本书风格基准；但不豁免情绪/节奏缺失。