@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-short-scan/scripts/heiyan-booklist-scraper.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+/**
+ * 黑岩短篇书库列表采集脚本
+ *
+ * ⚠️ 前置条件（必须）：
+ *   1. 启动 Chrome CDP 环境
+ *   2. 在 Chrome 中手动登录 https://manage.zhangwenpindu.cn
+ *      登录后会生成 Admin-Token cookie，脚本需要它调用后端 API
+ *      未登录 → 脚本报错「未检测到 Admin-Token」
+ *
+ * 采集策略：从 Cookie 提取 Bearer token，调用 ms.zhangwenpindu.cn 后端 API
+ * 获取结构化 JSON 数据（书名、作者、字数、分类、标签等）。
+ *
+ * 用法：
+ *   node heiyan-booklist-scraper.js --pages 5              # 采集前5页（每页20条）
+ *   node heiyan-booklist-scraper.js --pages 3 --channel male   # 仅男频
+ *   node heiyan-booklist-scraper.js --pages 2 --detail         # 含逐本详情（标签等）
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { ab, sleep, evalJSON, safeStr, getArg, localDateStamp, runCli } = require("./cdp-utils");
+
+const BOOKLIST_URL = "https://manage.zhangwenpindu.cn/books/booklist";
+const API_BASE = "https://ms.zhangwenpindu.cn";
+const PAGE_SIZE = 20;
+
+// ---------------------------------------------------------------------------
+// API 调用
+// ---------------------------------------------------------------------------
+
+/** 连通性自检：区分 CDP 未连 vs 已连但未登录 */
+function probePage(port) {
+  return evalJSON(port, "JSON.stringify({host:location.host})");
+}
+
+/** 从 Cookie 中提取 Admin-Token */
+function getToken(port) {
+  const js =
+    "JSON.stringify((()=>{" +
+    "var m=document.cookie.match(/Admin-Token=([^;]+)/);" +
+    "return m?m[1]:''" +
+    "})())";
+  return evalJSON(port, js) || "";
+}
+
+/** 调用后端 API 获取书籍列表 */
+function fetchBookList(port, token, pageNum) {
+  const t = safeStr(token);
+  const js =
+    "fetch(" + safeStr(API_BASE + "/manage/book/list") + "," +
+    "{method:'POST'," +
+    "headers:{" +
+    "'Content-Type':'application/x-www-form-urlencoded'," +
+    "'Authorization':'Bearer '+" + t +
+    "}," +
+    "body:new URLSearchParams({pageNum:" + safeStr(pageNum) + ",pageSize:" + safeStr(PAGE_SIZE) + ",language:'zh_TW'})" +
+    "}).then(function(r){return r.json()})";
+  return evalJSON(port, js);
+}
+
+/** 调用后端 API 获取书籍详情（标签等） */
+function fetchBookDetail(port, token, bookId) {
+  const t = safeStr(token);
+  const js =
+    "fetch(" + safeStr(API_BASE + "/manage/book/" + encodeURIComponent(bookId)) + "," +
+    "{headers:{'Authorization':'Bearer '+" + t + "}}" +
+    ").then(function(r){return r.json()})";
+  return evalJSON(port, js);
+}
+
+// ---------------------------------------------------------------------------
+// 主流程
+// ---------------------------------------------------------------------------
+
+const args = process.argv.slice(2);
+const PORT = parseInt(getArg(args, "--port") || "9222", 10);
+const OUTDIR = getArg(args, "--outdir") || ".";
+const PAGES = parseInt(getArg(args, "--pages") || "5", 10);
+const CHANNEL = getArg(args, "--channel") || "all";
+const DETAIL = args.includes("--detail");
+
+/**
+ * 字数格式化：手写千分位，不能用 toLocaleString()。
+ * 后者按宿主 ICU locale 取分隔符，de_* 会写成「123.456字」（读起来像 123 字），
+ * fr_* 用 U+202F、en-IN 会分成「1,23,456」——同一份报告在不同机器上数字不一样。
+ * 兼容接口把 words 返回成字符串的情况。
+ */
+function fmtWords(words) {
+  const n =
+    typeof words === "number"
+      ? Math.trunc(words)
+      : parseInt(String(words == null ? "" : words).replace(/[^0-9]/g, ""), 10);
+  if (!Number.isFinite(n) || n <= 0) return "";
+  return String(n).replace(/\B(?=(\d{3})+(?!\d))/g, ",") + "字";
+}
+
+function outputFilename(channel, date) {
+  if (!["all", "male", "female"].includes(channel)) {
+    throw new Error(`未知 --channel: ${channel}（支持 male/female/all）`);
+  }
+  return `黑岩书库列表_${channel}_${date}.md`;
+}
+
+function buildAndSave(allBooks, total, filtered, filepath) {
+  const now = new Date().toISOString();
+  const maleBooks = filtered.filter((b) => b.classifyStr === "男频");
+  const femaleBooks = filtered.filter((b) => b.classifyStr === "女频");
+  const otherBooks = filtered.filter(
+    (b) => b.classifyStr !== "男频" && b.classifyStr !== "女频"
+  );
+
+  const groups = [
+    { label: "男频", books: maleBooks },
+    { label: "女频", books: femaleBooks },
+  ];
+  if (otherBooks.length) {
+    groups.push({ label: "其他", books: otherBooks });
+  }
+
+  const lines = [
+    `# 黑岩 · 书库列表`,
+    "",
+    `- 来源：${BOOKLIST_URL}`,
+    `- 抓取时间：${now}`,
+    `- 总条目：${total}`,
+    `- 已采集：${filtered.length} 条（${PAGES} 页）`,
+    DETAIL ? "- 含详情（标签、简介）" : "- 列表模式（加 --detail 获取标签和简介）",
+    "",
+    "---",
+    "",
+  ];
+
+  for (const g of groups) {
+    if (!g.books.length) continue;
+    lines.push(`## ${g.label}短篇 — ${g.books.length} 本`, "");
+
+    for (let i = 0; i < g.books.length; i++) {
+      try {
+        const b = g.books[i];
+        lines.push(`### #${i + 1} ${b.name}`);
+        const meta = [
+          b.userName,
+          // 分别入数组再拼：预先 classifyStr + "/" + typeDesc 会把缺字段拼成
+          // 「undefined/undefined」这种真值字符串，filter(Boolean) 拦不住，直接写进报告
+          [b.classifyStr, b.typeDesc].filter(Boolean).join("/"),
+          fmtWords(b.words),
+          b.price ? b.price + "钻" : "",
+          b.open ? "公开" : "未公开",
+        ].filter(Boolean).join(" · ");
+        if (meta) lines.push(`*${meta}*`);
+
+        if (b.createTime) lines.push(`**创建：** ${b.createTime}`);
+        if (b.updateTime) lines.push(`**更新：** ${b.updateTime}`);
+
+        if (b.tags && b.tags.length) {
+          lines.push(`**标签：** ${b.tags.join("、")}`);
+        }
+
+        if (b.description) {
+          lines.push("");
+          lines.push(`> ${b.description.substring(0, 200)}${b.description.length > 200 ? "..." : ""}`);
+        }
+
+        lines.push("");
+      } catch (bookErr) {
+        console.error(`[heiyan] ${g.label} 第${i + 1}条处理出错: ${bookErr.message}`);
+        lines.push("");
+      }
+    }
+
+    lines.push("---", "");
+  }
+
+  fs.mkdirSync(OUTDIR, { recursive: true });
+  fs.writeFileSync(filepath, lines.join("\n"), "utf-8");
+  console.log(`  ✓ 已保存: ${filepath}`);
+}
+
+function main() {
+  console.log("\n→ 采集 黑岩书库列表（API 模式）...");
+  console.log(`  计划采集: ${PAGES} 页（每页 ${PAGE_SIZE} 条）`);
+
+  const filename = outputFilename(CHANNEL, localDateStamp());
+  const filepath = path.join(OUTDIR, filename);
+
+  // 先导航到管理后台获取 token
+  let token;
+  try {
+    ab(PORT, "open", BOOKLIST_URL);
+    sleep(3000);
+
+    // 连通性自检：把"CDP 没起来"和"没登录"分开，避免误导用户去登录
+    const probe = probePage(PORT);
+    if (!probe) {
+      console.error(
+        `  ✗ CDP 无响应。请确认已用 browser-cdp 启动 Chrome（端口 ${PORT}），且 agent-browser 可用。`
+      );
+      return 0;
+    }
+
+    token = getToken(PORT);
+  } catch (err) {
+    console.error(`[heiyan] 页面加载或 token 提取出错: ${err.message}`);
+    return 0;
+  }
+
+  if (!token) {
+    console.log("  ✗ 未检测到 Admin-Token（CDP 已连，但当前未登录）");
+    console.log("  → 请先在 Chrome 中打开 https://manage.zhangwenpindu.cn 并登录");
+    console.log("  → 登录后重新运行本脚本");
+    return 0;
+  }
+  console.log("  ✓ 获取到认证 token");
+
+  // 分页采集
+  const allBooks = [];
+  let total = 0;
+
+  for (let p = 1; p <= PAGES; p++) {
+    try {
+      sleep(800);
+      const resp = fetchBookList(PORT, token, p);
+
+      // 区分失败：接口无响应(超时/CDP) / 401 未授权
+      if (!resp) {
+        console.error(`  ✗ 第${p}页接口无响应（请求超时或 CDP 中断），已停止。`);
+        break;
+      }
+      if (resp.code === 401) {
+        console.log(`  ⚠ 第${p}页认证失败（401），请重新登录后重试。`);
+        break;
+      }
+
+      const rows = resp?.data?.rows;
+      if (!rows || !rows.length) {
+        // 仅在无数据时才用 code 区分"服务端错误"与"正常到底"，避免把
+        // 携带非常规成功 code 的有效响应误判为错误（成功带 rows 一律放行）
+        if (resp.code != null && resp.code !== 0 && resp.code !== 200) {
+          console.error(`  ✗ 第${p}页接口返回错误 code=${resp.code} ${resp.msg || ""}，已停止。`);
+        } else {
+          console.log(`  第${p}页无数据，停止`);
+        }
+        break;
+      }
+
+      if (p === 1) {
+        total = parseInt(resp.data.total) || 0;
+        console.log(`  总条目: ${total}`);
+      }
+
+      allBooks.push(...rows);
+      console.log(`  第${p}页: ${rows.length} 条 (累计 ${allBooks.length})`);
+    } catch (pageErr) {
+      console.error(`[heiyan] 第${p}页采集出错，跳过: ${pageErr.message}`);
+      if (allBooks.length > 0) {
+        console.log(`  已采集 ${allBooks.length} 条，继续处理已有数据`);
+      }
+      break;
+    }
+  }
+
+  if (!allBooks.length) {
+    console.error("[heiyan] 采集失败：未取到任何书目。多为登录态过期或接口变动，请重新登录后重试。");
+    return 0;
+  }
+
+  // 质量门：核心字段命中率。API 改字段名时会整片 undefined，必须拦截而非静默写盘。
+  // classifyStr 同样要查：它决定男频/女频分组和 --channel 筛选，字段一改全部书都掉进
+  // 「其他」、--channel male 直接筛成 0 条，写出一份「已采集：0 条」的假成功报告。
+  const CORE_FIELDS = [
+    { key: "name", label: "书名" },
+    { key: "classifyStr", label: "频道(classifyStr)" },
+  ];
+  for (const f of CORE_FIELDS) {
+    const hit = allBooks.filter((b) => b && b[f.key]).length;
+    if (hit / allBooks.length < 0.5) {
+      console.error(
+        `[heiyan] 采集失败：${allBooks.length} 条里仅 ${hit} 条有${f.label}，疑似接口字段变动，已放弃写盘。`
+      );
+      return 0;
+    }
+  }
+
+  // 频道筛选
+  let filtered = allBooks;
+  if (CHANNEL === "male" || CHANNEL === "female") {
+    const want = CHANNEL === "male" ? "男频" : "女频";
+    filtered = allBooks.filter((b) => b.classifyStr === want);
+    if (!filtered.length) {
+      // 筛成 0 条不能算成功：把实际 classifyStr 分布打出来，区分「接口字段变了」
+      // 和「这个频道确实没作品」，而不是写一份看不出差别的空报告
+      const seen = {};
+      for (const b of allBooks) {
+        const k = b && b.classifyStr ? b.classifyStr : "(空)";
+        seen[k] = (seen[k] || 0) + 1;
+      }
+      const dist = Object.keys(seen).map((k) => `${k}×${seen[k]}`).join("、");
+      console.error(
+        `[heiyan] 采集失败：--channel ${CHANNEL} 筛选后 0 条（${allBooks.length} 条的 classifyStr 取值：${dist}），已放弃写盘。`
+      );
+      console.error(`  → 若确实没有${want}作品，去掉 --channel 重跑即可拿到全部书目。`);
+      return 0;
+    }
+  }
+
+  // 可选：逐本获取详情（标签等）
+  if (DETAIL && filtered.length) {
+    console.log(`  获取 ${filtered.length} 本详情...`);
+    for (let i = 0; i < filtered.length; i++) {
+      try {
+        sleep(500);
+        const detail = fetchBookDetail(PORT, token, filtered[i].id);
+        if (detail?.data) {
+          filtered[i].tags = detail.data.tags || [];
+          filtered[i].description = detail.data.description || "";
+          filtered[i].chapterCount = detail.data.chapterCount || 0;
+        }
+        if ((i + 1) % 10 === 0) {
+          console.log(`    已获取 ${i + 1}/${filtered.length}`);
+        }
+      } catch (detailErr) {
+        console.error(`[heiyan] 第${i + 1}本详情获取出错，跳过: ${detailErr.message}`);
+      }
+    }
+    console.log("  ✓ 详情获取完成");
+  }
+
+  buildAndSave(allBooks, total, filtered, filepath);
+  return 1;
+}
+
+if (require.main === module) {
+  runCli(main, "黑岩采集");
+}
+
+module.exports = {
+  probePage,
+  getToken,
+  fetchBookList,
+  fetchBookDetail,
+  fmtWords,
+  outputFilename,
+  buildAndSave,
+};

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

@@ -0,0 +1,136 @@
+---
+name: story-short-write
+version: 1.0.0
+description: "短篇网文写作。辅助短篇小说创作，从构思到成稿，聚焦情绪拉扯与节奏把控。触发方式：/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。"
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
+---
+# story-short-write：短篇网文写作
+
+你是短篇网文写作执行器。从构思到成稿，完成一篇完整的短篇小说。
+
+**执行规则：短篇以情绪为目标，所有内容为情绪服务。**
+
+## 写前必读（强制，先读后写）
+
+短篇按作者时刻加载：每个时刻只读自己的文件，后一时刻只靠落盘文件接上前一时刻。创建或修改故事文件前，先判断当前时刻并完整读取它的必读项（分块直到 EOF；`rg` 检索或局部摘读不算读完）。**只读本 SKILL.md 不算完成门禁。**
+
+| 时刻 | 作者确认什么 | 读什么 | 落盘 |
+|---|---|---|---|
+| 定情绪（Phase 1） | 读者读完的感觉、题材方向 | 本文件 | 进构思时写入 `设定.md` |
+| 构思（Phase 2） | 故事核、人物、反转、付费点 | ① `references/workflow-design.md` + `references/writing-workflow.md`、`references/submission-craft.md`、`references/short-craft.md`、`references/short-reversal.md` ② 核心 10 题材读一个精确的 `references/genre-styles/{题材}.md`，冷门题材读 `references/genre-writing-formulas.md` ③ 有反派或真相揭露设计时读 `references/villain-and-reveal.md`，不适用时在设计校验区写明原因 | `设定.md`、`小节大纲.md` |
+| 写正文（Phase 3–4） | 成稿 | Phase 3 写正文前完整读取 `references/workflow-draft.md`，按其「写前加载」读写作手法；Phase 4 精修前完整读取 `references/workflow-revision.md` | `正文.md` |
+
+构思必读项在第一次写入 `设定.md` / `小节大纲.md` 前读完。任一必需路径不存在、不可读或题材尚未解析到唯一 reference 时，立即停止，报告准确路径/待定项，**不得创建或修改故事产物**。不要把“已读 references”的回执写进故事文件；选出的题材招式、反转计算等应用证据写进正常设计字段。每个时刻按当前任务完整回读，不得用早先读过代替。
+
+**交接只靠落盘**：作者在对话里定下的字数、平台、人称、偏好、红线和否掉的方案，构思交付前写进 `设定.md`；写正文只读两份设计文件与本时刻的写作手法，不重读构思方法论，也不回翻对话。
+**换上下文**：构思读得最多。构思汇报末尾建议作者新开一个对话说「写正文」；作者要在本对话接着写也照做。新对话里两份设计文件已通过构思完成门禁时，直接进入写正文。
+
+---
+
+> Agent 只查当前端 canonical 目录（Claude `.claude/agents`、OpenCode `.opencode/agents`、Codex `.codex/agents` TOML、Antigravity `.agents/agents`），不跨端误判。Claude 用 `subagent_type`，OpenCode 用 `subagent` 的 `agent`，Codex 用 `agent_type`，Antigravity 用 `invoke_subagent` + `TypeName`。主会话自己写正文、去味是常态，不报；作者明确要交给写作助手而能力/文件缺失、unknown agent 或 ZCode 3.3.4 时，由主会话接手并一句白话告诉作者（如「写作助手用不了，由我直接写」），`Fallback: project custom agents unavailable -> solo` 原文只写进汇报最后一行「技术备注：」。
+>
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，同时用一句白话提示作者「写作助手是旧版，运行 /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；同一裁决交给后续执行者。
+
+## 执行规则
+
+1. **先定情绪，再定故事**。动笔前必须确定目标情绪（意难平/反转震撼/爽感释放/治愈温暖/细思极恐/共鸣感动），所有内容为这个情绪服务。
+2. **一个核心支点撑一篇**。反转型围绕一次主揭示蓄力；无反转型围绕报应兑现或甜度递进积累期待。不多线、不铺世界观。
+3. **每句话必须有用**。不推动剧情、不铺垫反转、不推高情绪的句子 → 删。
+4. **开头 3 句定生死，结尾定传播**。开头必须包含钩子，结尾必须有余韵。
+5. **默认第一人称**。短篇网文（盐言/七猫短篇等）绝大多数用第一人称，代入感最强。当前请求、本篇文风或题材需要第三人称时按其执行，不因默认值改回「我」。
+
+---
+
+## 核心方法
+
+除了上面的执行规则，构思和写作时遵循：
+
+- **定方向就换风格**：题材一旦确定，腔调、开篇、钩子、情绪烈度、金句、招式、收尾全部切到该题材包（追妻含时代变体与小三/死人文学分支）；冷门题材用公式结构骨架兜底，腔调按 `short-craft.md`
+- **复用作者习惯**：有作者记忆时，正文前用 `scripts/author_memory_commit.py query --workspace {工作区} --book-root {项目目录} --kind prose_style --kind story_design [--genre {题材}] [--workflow 短篇]` 获取 active 条目（≤2KB），传给正文/改写 agent 作为自然倾向，不逐条展示或最大化命中，不牺牲连贯、节奏和字数；硬门禁、当前请求和本篇设定优先。长期声明在收尾用 `record` 写入并回传回执，细则见 [references/author-memory.md](references/author-memory.md)。
+
+---
+
+## 写作流程
+
+### Phase 1：确定目标情绪
+
+从项目根及上一级往下 3 层找到 `短篇扫榜结论.md`（多份取最新）时先读其「选题匹配」，排第一的方向带着目标情绪当候选问作者；过了复扫日期就提醒可能过期。
+
+问用户：**「你想让读者读完什么感觉？有没有想写的题材方向或灵感？」**
+
+用户已说清读者读完的感觉 → 直接进入 Phase 2；只给了题材或梗、没说情绪 → 从下表带一个推荐情绪问一句，作者点头再进。
+
+如果用户只有模糊想法 → 帮用户做情绪选择：
+
+| 情绪类型 | 适合场景 | 难度 | 市场热度 | 常配题材包 |
+|----------|----------|------|----------|------------|
+| 意难平 | 虐恋、遗憾、错过 | 中 | 🔥🔥🔥 | 追妻火葬场 / 甜宠（先虐后甜） |
+| 反转震撼 | 悬疑、身份错位 | 高 | 🔥🔥🔥 | 悬疑 / 沙雕脑洞（反套路） |
+| 爽感释放 | 打脸、逆袭 | 低 | 🔥🔥 | 世情打脸 / 复仇打脸 / 总裁豪门 / 宅斗宫斗（古代上位） |
+| 治愈温暖 | 成长、亲情、友情 | 中 | 🔥🔥 | 甜宠 / 双男主（救赎线） |
+| 细思极恐 | 悬疑、心理 | 高 | 🔥 | 悬疑 / 民俗怪谈 |
+| 共鸣感动 | 现实、职场、婚姻 | 中 | 🔥🔥🔥 | 世情打脸（共鸣模式） / 追妻火葬场（小三文学） |
+
+---
+
+### Phase 2：构思核心框架
+
+#### 对标上下文加载
+
+存在本篇 `对标/`、项目根 `拆文库/` 或用户提供参考小说时，先完整读取 [references/benchmark-recall.md](references/benchmark-recall.md)，执行对标发现、排除本书续写基线、题材匹配与召回。无外部对标时仍按原题材包执行。
+
+#### 构思、设计与验收
+
+完整步骤见 [references/workflow-design.md](references/workflow-design.md)。按首屏「写前必读」读完后执行；两份设计文件通过其中的 Phase 2 完成门禁，才可进入 Phase 3。
+
+---
+
+### Phase 3：逐场景写作
+
+进入正文写作前，完整读取 [references/workflow-draft.md](references/workflow-draft.md)，执行交付参数锁定、写前验收与逐场景写作；只做构思或精修时不加载。
+
+**小节完整性流程**：
+1. **写作时**：每节围绕一个主问题推进；让风险、信息、关系、资源、决定、行动或读者理解至少发生一项可见变化。相关情节点可以由同一动作链或对话同时兑现，不为拆成多个“子事件”重复铺陈。
+2. **写完后**：对照 `小节大纲.md` 检查批准内容是否落地、因果与下一步是否读得懂、感知/反应是否提供新信息、伏笔/物件是否按计划出现。
+3. **发现缺口时**：只补回原计划中漏掉的动作、证据、选择或后果；若本节已经完成职责，即使很短也不加任务卡点、对话、回忆或环境来凑长度。
+4. **发现冗余时**：删除不改变风险、信息、关系、资源、决定、行动或可信度的阻碍、复述与旁人反应；不把“有冲突”本身当成保留理由。
+
+### Phase 3 完成门槛（进入 Phase 4 前必须通过）
+
+- [ ] 总字数进入锁定的用户范围；未指定时进入 8000-20000 默认范围
+- [ ] 每节完成其批准情节点或状态变化；没有为拉齐长度补冲突、对话、回忆或旁人反应
+- [ ] 节数 = 小节大纲规划节数（不得合并/省略）
+- [ ] 身体细节按叙事功能判断，不设次数上限；不对“手、眼、心”等单字计数改稿
+- [ ] 「像/好像/仿佛/如同」不成片堆叠；超过 10 处需逐处复核功能，不机械全删
+- [ ] `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文.md` 无 blocking 命中；其余提示先通读，确属问题再改
+- [ ] `node scripts/check-degeneration.js --check 正文.md` 无 blocking 退化命中（复读/截断/工程词泄漏）
+
+**不通过 → 回退补足，不得进入精修。**
+
+---
+
+### Phase 4：精修打磨
+
+精修或质量自检前，完整读取 [references/workflow-revision.md](references/workflow-revision.md)，按其职责分工去味、查一致性、做最终扫描与交付验收；只做构思时不加载。
+
+---
+
+## 流程衔接
+
+**流水线：** 短篇
+**位置：** 写作（第 3/3 步）
+
+有参考小说想对标 → `/story-short-analyze`（存入 `拆文库/{书名}/`）；写完去 AI 味 → `/story-deslop`；想自检 → Phase 4 流程 + `references/short-prose-quality.md`；要市场方向 → `/story-short-scan`；设定太大适合长篇 → `/story-long-write`。
+
+---
+
+## 参考资料
+
+阶段必读项按首屏「写前必读」执行；其他资料按 [参考索引](references/reference-index.md) 的加载条件选用。
+
+## 语言
+
+- 跟随用户的语言回复，用户用什么语言就用什么语言回复
+- 中文回复遵循《中文文案排版指北》

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

@@ -0,0 +1,13 @@
+# agent-calls.md：短篇派写手的调用方式
+
+只在要 spawn narrative-writer 时读；主会话自己写正文、自己去味时不读。何时派由 workflow-draft.md / workflow-revision.md 决定，这里只放 prompt 与必须附带的内容。Antigravity 用 `invoke_subagent` + 同名 `TypeName`。
+
+## 写正文
+
+spawn `Agent(subagent_type: "narrative-writer", prompt: ...)`，只传项目目录、输出文件、目标情绪、题材风格包、小节大纲、角色、主/副对标召回摘要、本书文风全文路径与 style_resolution、作者偏好 query 中的文风/故事设计项、格式硬约束和写作硬约束，并传入检查分工：本批只做内容覆盖与格式自检，完整语义去味由 Phase 4 负责，最终文件扫描由主会话负责。
+
+不把本 skill 整段规则塞进 prompt；细节以 `short-format.md`、题材包、`short-craft.md` 与 `scene-craft.md` 为准。收回后按 workflow-draft.md 的格式规范重排再写入 `正文.md`。
+
+## 精修去味
+
+spawn `Agent(subagent_type: "narrative-writer", prompt: "项目目录：{dir}\n任务描述：去AI味+格式检查\n检查分工：你负责本次语义去味及原定自检；最终文件扫描由主会话执行，不在子代理内重复\n检查范围：{正文文件}\nstyle_resolution：{与写作一致的本次文风裁决，含全文路径}\n作者偏好：{query 命中的 prose_style/story_design 项}\n篇幅：短篇\n卖点保留：第一人称审判句、火葬场预告、心死式章尾留，只删中立作者讲解与空洞升华\nAI味等级：{轻度/中度/重度；未分级按轻度}\n删除优先：每条 AI 味项先判能否删除——删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色（删除受比例上限与本次字数范围下沿约束，跌破改降AI重写）\n必须检查：检查是否连续使用头皮发紧/眼皮一跳/心口一沉/胃里翻涌等精致戏剧反应，能写普通动作/普通感觉就写普通动作/普通感觉；已有手机/聊天记录/公告/账单/病历/证据截图等信息，保留为角色看到或处理的场内载体，不改成叙述者解释；任务卡点只在角色本来有要办的事且能加重情绪/证据/关系/反转时使用，不为自然感补流程")`

package/resources/skills/story-creation/upstream/skills/story-short-write/references/author-memory-maintenance.md

@@ -0,0 +1,75 @@
+# 作者记忆维护
+
+[author-memory.md](author-memory.md) 的少见时刻补充：记一条、确认、替换、忘掉和优先级仍按那份协议，本文件只在下列情况读——作者说「整理作者记忆」，或回执 `warnings`／查询 `omitted_ids` 提示超编；写入因 `作者画像.md` 写满失败；书根就是工作区，或工具报 `state.book`、单书布局错误；要做存量迁移 `migrate`、多事件原子 `commit`、派生视图 `check`；冲突候选要落定；碰到升级前留下的旧条目。
+
+作者记忆借鉴“原始证据 → 候选 → 已确认画像 → 变更记录”的记忆管道，但把决定权留给作者。
+
+## 文件
+
+```text
+{工作区}/.story/作者记忆/          # 项目级 store：global / genre / workflow 条目，编号 AP
+├── _author-memory-state.json  # 唯一结构化权威
+├── 作者画像.md               # 仅 active，供作者查看与管理
+├── 待确认.md                 # pending / conflict，不参与约束
+└── 变更记录.md               # 最近 100 次、最新在前的事务记录
+{书}/.story/作者记忆/            # 书级 store：只存这本书的 book 条目，编号 BP，同样四个文件
+```
+
+三个 Markdown 文件都从 state 确定性生成，禁止手改；完整历史保留在 state，变更记录只展示最近 100 次。`作者画像.md` 是人类管理视图，普通写作 agent 不整份注入，而是调用 `query` 取得本次相关的紧凑上下文。
+
+## 任务映射表
+
+各 skill 入口的 `query` 命令按此表选 kind；写入时的预算提醒也按这四类任务组合估算。
+
+| 任务 | query kinds | 注入位置 |
+|---|---|---|
+| 正文初稿 / 续写 | `prose_style` + `story_design` | 主会话与实际正文 agent |
+| 去 AI 味 / 改写 | `prose_style` | 主会话与实际改写 agent |
+| 设定 / 大纲 | `story_design` + `workflow` + `interaction` | 主会话，不传正文 agent |
+| 审稿 | `delivery` + `interaction` + 必要的 `prose_style` | 主会话，不降低 rubric |
+
+审稿匹配项只用于交付格式、协作方式和“作者有意采用的表达选择”说明；问题严重度和 PASS/FAIL 仍由 rubric 决定。
+
+## 注入预算与容量
+
+- **写入不因注入预算失败**：`record` / `commit` 照常成功、给回执；工具按上表四类任务组合估算最坏查询情形（全局条目＋各 scope 维度最重的单一切片，切片按大小写无关归并、轻重按写作时真正读到的字段算，与真实查询同一把尺），装不进 2048 字节的组合在返回的 `warnings` 里点名将被略过的条目及其断言首句。
+- 写入落盘后另一级 store 读不出来（书目录不存在、`--book` 与书级记录不符等）也照常给回执，`warnings` 注明本次提醒没算上它。写书级条目时「本书＋全局」按实际条目精确计算；写项目级条目时只看得到项目级 store，顺手传 `--book-root` 就把当前这本书也算进提醒。
+- 查询按 **重要度 → 本书例外 → 最近更新** 排序装填（同一范围的条目必在同一 store，「最近」按该 store 的修订号比，不跨 store 比较），先丢的恒是重要度较低的条目——`importance` 决定超编时谁留在 prompt 里。装不下的条目跳过而不中断（一条长的不挡后面的短条），漏下的 ID 按同一优先级报进 `omitted_ids`（最多列 20 条，`omitted` 是真实总数）。
+- 注入预算之外还有一道硬上限：`作者画像.md` 超过 12288 字节时写入会直接失败并要求先整理。active 条目攒到几十上百条才会碰到（远在注入预算之后），碰到就走「整理作者记忆」；`forget` 这类减量操作在满编时照常可用。
+
+## 整理作者记忆
+
+作者说「整理作者记忆」，或回执 `warnings`／查询 `omitted_ids` 提示超编、写入因画像写满失败时：读项目级与当前书的 `作者画像.md`（每条都标了范围、重要度、把握和确认次数，重要度就是超编时的去留依据），提出合并同义条（`replace` 多合一）、退役过时条（`forget`）、给错标成 `high` 的条目下调重要度、把超长断言压缩成一句话的提案；项目级画像里还有「本书：」条目时，「对该书运行 `migrate --book-root`」列为默认提案项。清单用原话逐条列给作者确认（编号只放括号里），确认后按 store 各汇成一份 `commit` 事务提交（一份事务只写一个 store）。合并时保住每条的否定词、限定词和适用范围——合不动就退役其中一条，不要靠删限定词把两条凑成一条。整理只由作者发起或确认，不自动执行。
+
+## 冲突候选
+
+冲突候选（`conflict`）不能绕过旧规则直接 `decide=activate`。作者选新说法：用 `replace`，`old_ids` 同时列旧 active 条目和这条冲突候选，新条目直接 active、两条旧的标 `superseded`；作者留旧规则：对候选 `decide=reject`。旧条目被 `replace` / `forget` 撤下后，它不再是任何候选的冲突对象，冲突对象清空的候选退回 `pending`。
+
+## 单书布局
+
+书根就是工作区（`--book-root` 与 `--workspace` 同一目录）时，书级 store 改住 `{工作区}/.story/作者记忆/书级/`，与项目级各自一份 state；首次建立的书名优先取项目级存量本书条目里唯一的书名，再取目录名。旧版曾把书级 state 写在项目级位置，此后项目级读写都报 `state.book`；带 `--book-root {工作区}` 运行任一命令（含 `query`）会先把它原样移进 `书级/`，不改内容。这个目录其实是某个工作区里的一本书时（上一层叫 `长篇/` 或 `短篇/`，或某个祖先有 `.active-book` 或项目级 state），工具直接报错、不动任何文件，按报错改传 `--workspace`。
+
+## 存量迁移
+
+不做双读：升级前写进项目级 store 的 book 条目不再参与查询与预算估算，也不再接受新的 book 写入；它们仍在 `作者画像.md` 里可见、可 `decide` / `forget`。对每本书运行一次 `migrate --book-root {书目录}` 即可整批搬回来：断言、证据、确认次数、重要度原样保留，换成 `BP` 编号，原 `AP` 条目标 `superseded` 并注明去向；与全局条目的冲突关系在迁移后不再成立，这类候选退回 `pending`。书级每个源条目一笔事务，重跑只补没做完的一半。「整理作者记忆」看到项目级画像里还有「本书：」条目时，把迁移列为默认提案项。
+
+## 旧条目
+
+- 升级前写下的长断言不受 120 字节新建上限约束：原样重申它会**强化**原条目（确认次数 +1），不会因超长被拒；只有真正新建条目才校验 120 字节。
+- 存量 state 里推断类旧来源的条目照常可读、可确认、可退役；新写入仍只接受 `explicit_user`、`accepted_suggestion`、`manual`。
+
+## 其他命令
+
+先依次尝试 `python3`、`python`、`py -3` 找到 Python 3，再从当前 skill 根运行本地副本（`record` / `query` 见 author-memory.md）：
+
+```text
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py init    --workspace {工作区} [--book-root {书目录}]
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py commit  --workspace {工作区} [--book-root {书目录}] --input {工作区}/.story/work/作者记忆-事务.json
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py migrate --workspace {工作区} --book-root {书目录}
+{PYTHON} {当前 skill 根}/scripts/author_memory_commit.py check   --workspace {工作区} [--book-root {书目录}]
+```
+
+- `commit`：高级批量入口，只在需要把多个动作绑定成一次原子提交时用（如整理作者记忆）。顶层传 `schema_version`、唯一 `transaction_id`、当前 `expected_state_revision` 和含 1–32 项的 `operations`（每项与单事件的 `operation` 同形）。一份事务只写一个 store；先在内存完成 schema、引用、容量和所有视图校验，操作按数组顺序应用，任一步失败则整份事务零写入，最后原子替换 state。过期修订会在任何写入前失败。事务文件在成功前必须保留，成功后删除；显式记忆请求按 author-memory.md「回执怎么告诉作者」转告。
+- `migrate`：把项目级 store 里某本书的存量 book 条目整批搬进 `--book-root` 的书级 store，幂等，中途失败直接重跑；返回 `migrated`（源→新编号），没有存量时为空。
+- `check`：从 state 重建并逐字核验所有派生视图；传 `--book-root` 时两级一起核验。
+- `init`：显式初始化 store；平常不需要，首次 `record` 会随事务创建。