@oh-story/dsh 0.1.10 → 0.1.12

package/lib/oh-story/skills/story-short-scan/SKILL.md

@@ -32,7 +32,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 1：确认平台和方向
 
-问用户：**「你想看哪个平台？（知乎盐言/番茄短篇/七猫短篇/其他）有没有想写的类型方向？」**
+问用户：**「你想看哪个平台？点众短篇、黑岩短篇我能直接抓（黑岩要你先在浏览器里登录作者后台）；知乎盐言、番茄短篇、七猫短篇等暂时抓不了，需要你把榜单截图或文字发我。有没有想写的类型方向？」**
 
 关键判断：
 - 用户已有方向 → 针对该方向做深度扫榜
@@ -47,67 +47,28 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 | 优先级 | 模式 | 说明 | 何时用 |
 |--------|------|------|--------|
-| 1 | **browser-cdp 采集** | 直接抓取平台页面，产出结构化文件 | 有 Chrome 环境时（优先） |
-| 2 | **用户提供** | 用户粘贴榜单截图/文字/链接 | 用户已有数据时 |
-| 3 | **内置知识** | 基于知识库中的趋势数据和方法论做分析 | 无法联网、用户无数据时 |
+| 1 | **脚本采集** | 点众、黑岩：直接抓取平台页面，产出结构化文件 | 有 Chrome 环境时（优先） |
+| 2 | **作者提供** | 没有脚本的平台，或作者已有榜单 | 知乎盐言/番茄短篇/七猫短篇等 |
+| 3 | **内置知识** | 基于知识库中的趋势数据和方法论做分析 | 无法联网、作者也没有数据时 |
 
-#### browser-cdp 采集模式
+1. 只读所选平台那一份：[点众](references/platform-dianzhong.md) / [黑岩](references/platform-heiyan.md) / [没有脚本的平台](references/manual-rank-input.md)。里面有网址、命令、字段、故障排查、平台分析维度，以及作者提供的榜单怎么整理成文件。
+2. 每次扫榜新建输出目录 `扫榜/{YYYYMMDD}/`（同日再扫加 `-2`）存本次榜单，不往旧目录追加；文件名 `{平台}{类型}_{YYYYMMDD}.md`，某平台失败就跳过。对比读上个日期目录的 `扫榜聚合.md`。
+3. 聚合：`node scripts/aggregate-rank.js {输出目录} --out {输出目录}/扫榜聚合.md --sparse 10 --scale short`。**主会话只读这份聚合**，要看开头与人设原文再抽样：`node scripts/aggregate-rank.js {输出目录} --sample {题材/标签/书名词} --n 5`。
 
-使用 `/browser-cdp` 启动 Chrome，直接抓取平台页面的结构化数据。适用于需要登录才能看到的数据（知乎个人中心、番茄书架等）。
-
-**点众采集目标**：
-
-| 页面 | URL | 核心字段 |
-|------|-----|----------|
-| 男频短篇 | ishugui.com/browse | 书名·作者·标签·状态·字数·评分·最新章节 |
-| 女频短篇 | ishugui.com/browse/on3 | 书名·作者·标签·状态·字数·评分·最新章节 |
-
-**黑岩采集目标**：
-
-| 页面 | URL | 核心字段 |
-|------|-----|----------|
-| 书库列表 | manage.zhangwenpindu.cn/books/booklist | 书名·作者·字数·分类·类型·价格·创建/更新时间·标签（详情模式） |
-
-> **黑岩需要登录！** 必须先在 Chrome 中手动登录 `manage.zhangwenpindu.cn`，脚本才能从 Cookie 中提取 Bearer token 调用后端 API。未登录会报错提示。**黑岩采集失败时标记为 SKIP，继续其他平台采集，不中断本轮数据采集。**
-
-- 黑岩专用：`--pages N`（每页 20 条）、`--detail`（逐本详情，含标签/简介，速度较慢）、`--channel male/female`
-- 点众专用：`--channel male/female/all`
-
-**文件命名**：`{平台}{类型}_{YYYYMMDD}.md`，例：`点众男频短篇_20260501.md`
-
-**用户提供操作指引：**
-- 请用户截图或复制粘贴榜单内容
-- 如果用户提供链接，用 WebFetch 抓取页面内容
-- 如果用户只提供故事名列表，直接进入分析
-
-**内置知识操作指引：**
-- 加载 `references/real-market-data.md`（跨平台写作差异对照）
-- 明确标注：「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的平台页面。
+**内置知识：** 加载 `references/real-market-data.md`（跨平台写作差异对照），明确标注「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的平台页面。
 
 ---
 
 ### Phase 3：数据分析
 
-#### 知乎盐言故事分析维度
-
-| 维度 | 看什么 |
-|---|---|
-| 热门榜单 | 当前最受关注的故事 |
-| 高赞故事 | 口碑最好的作品结构 |
-| 新作者上榜 | 非头部账号的题材选择与开篇模式 |
-| 付费转化率 | 哪些题材读者愿意付费 |
-| 标签分布 | 热门标签的变化趋势 |
+以聚合结果为主，按所选平台参考里的「分析维度」看，再对每个平台提取：
 
-#### 通用分析维度
-
-对每个平台提取：
-
-1. **情绪类型分布**：当前哪种情绪拉扯最火（虐恋/反转/悬疑/治愈/打脸）
+1. **情绪类型分布**：当前哪种情绪拉扯最火（虐恋/反转/悬疑/治愈/打脸），从题材表与标签热词归并
 2. **题材热点**：具体什么设定/场景反复出现
-3. **篇幅分布**：热门短篇集中在多少字
-4. **开头模式**：热门短篇的第一段/第一句怎么写
-5. **结尾类型**：HE（好结局）/BE（坏结局）/开放式 的比例
-6. **标题模式**：热门短篇的命名规律
+3. **篇幅分布**：字数分布与各题材字数中位
+4. **开头模式**：对候选方向抽样，看第一段/第一句怎么写
+5. **结尾类型**：HE（好结局）/BE（坏结局）/开放式 的比例（抽样可见时）
+6. **标题模式**：书名常见词 + 代表作标题
 7. **人设模型**：反复出现的主角类型
 
 ---
@@ -116,43 +77,45 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 报告写给作者：讲市场结论和能写的方向。脚本名、命令和 SKIP 这类采集状态不进报告；某个平台没采到，就说一句「XX 这次没拿到（原因），结论不含它」。
 
+报告展示给作者，同时写进输出目录的 `短篇扫榜结论.md`：文件不存在就先按 [references/topic-match.md](references/topic-match.md) 的模板写文件头，再把报告作为「扫榜结论」一节写入（已存在就整节替换）。
+
 <!-- author-report -->
 ```md
-# 短篇网文扫榜报告：{平台名称}
+## 扫榜结论：{平台名称}
 
-## 市场概况
+### 市场概况
 - 扫榜时间：{日期}
 - 核心发现：{一句话总结}
 - 可信度：{样本多少篇、来自哪几个榜}；建议 {日期} 前后再扫一次
 
-## 情绪热度排行
+### 情绪热度排行
 | 排名 | 情绪类型 | 榜上数量 | 趋势 | 代表作 |
 |------|----------|----------|------|--------|
 | 1 | {类型} | {N篇} | ↑/→/↓ | {标题} |
 
-## 题材热点
+### 题材热点
 | 题材 | 热度 | 竞争程度 | 门槛 | 代表作 |
 |------|------|----------|------|--------|
 | {题材} | 高/中/低 | 激烈/一般/蓝海 | 高/中/低 | {标题} |
 
-## 关键数据洞察
+### 关键数据洞察
 - 篇幅区间：热门短篇集中在 {X}-{Y} 字
 - 开头模式：{高频开头模式}
 - 结尾偏好：{HE/BE/开放式的比例}
 - 标题特征：{命名规律}
 - 人设热词：{高频主角类型}
 
-## 风口预警
+### 风口预警
 - 🔥 正在爆发：{题材} — {依据}
 - ⚡ 即将起风：{题材} — {依据}
 - ⚠️ 即将饱和：{题材} — {依据}
 
-## 值得写的方向
+### 值得写的方向
 1. {方向 + 情绪拉扯方式 + 可行性}
 2. {方向 + 情绪拉扯方式 + 可行性}
 3. {方向 + 情绪拉扯方式 + 可行性}
 
-## 一句话
+### 一句话
 {犀利总结}
 ```
 
@@ -160,7 +123,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 5：选题匹配
 
-根据扫榜结果，结合项目条件输出选题匹配：
+先读 `短篇扫榜结论.md` 的「扫榜结论」和 `扫榜聚合.md`，不靠对话记忆；再结合项目条件输出选题匹配，按 [references/topic-match.md](references/topic-match.md) 写进同一文件的「选题匹配」一节：
 
 - 低复杂度候选：反转类、打脸类（结构清晰、验证成本低）
 - 高复杂度候选：悬疑类、虐恋类（技术壁垒高，需要伏笔、反转和情绪控制证据）
@@ -203,10 +166,13 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 | 文件 | 何时加载 |
 |------|----------|
+| 三份平台参考（链接见 Phase 2 第 1 步） | 「确定数据来源」：只读所选平台那份 |
+| [references/topic-match.md](references/topic-match.md) | Phase 4/5：`短篇扫榜结论.md` 模板、可行性上限与交付 |
+| [scripts/aggregate-rank.js](scripts/aggregate-rank.js) | 把输出目录里的原始榜单聚合成短表（`--out` 落盘，`--sample` 抽原始条目），主会话只读它 |
 | [references/real-market-data.md](references/real-market-data.md) | **核心参考**：跨平台写作差异对照表、各平台简介公式速查、题材爆款公式速查表、各平台写作特征 |
 | [scripts/cdp-utils.js](scripts/cdp-utils.js) | CDP 公共工具函数（ab/sleep/evalJSON/safeStr/scrollLoad/getArg），各采集脚本共用 |
-| [scripts/dz-browse-scraper.js](scripts/dz-browse-scraper.js) | 点众短篇采集（男频/女频），按 bookId 聚合 anchor 解出书名/评分/简介/作品页（避免把 UI 文字或简介误当书名），带连通性自检+书名解析率质量门，配合 browser-cdp 使用 |
-| [scripts/heiyan-booklist-scraper.js](scripts/heiyan-booklist-scraper.js) | 黑岩书库列表采集，后端 API 模式（Bearer token），含字数/标签/价格/时间，支持 --detail 获取标签简介；区分 CDP 未连/未登录/超时/接口错误并带书名命中率质量门 |
+| [scripts/dz-browse-scraper.js](scripts/dz-browse-scraper.js) | 点众短篇采集（男频/女频），用法见点众参考 |
+| [scripts/heiyan-booklist-scraper.js](scripts/heiyan-booklist-scraper.js) | 黑岩书库列表采集（需登录），用法见黑岩参考 |
 
 ---
 

package/lib/oh-story/skills/story-short-scan/references/manual-rank-input.md

@@ -0,0 +1,36 @@
+# 没有采集脚本的平台：作者提供榜单
+
+知乎盐言、番茄短篇、七猫短篇等平台目前没有采集脚本，需要作者提供榜单。作者选了这些平台才读本文。
+
+## 向作者要什么
+
+「这个平台我没法自动抓，麻烦把榜单截图或复制的文字发给我，最好带上书名、作者、题材/标签、字数、热度（赞同、收藏、在读都行），有简介更好。给个链接也行，我试着打开。」
+
+- 链接 → 用 WebFetch 抓取；抓不到就请作者改发截图或文字
+- 只有故事名列表 → 可以直接分析，但报告的可信度写低一档
+
+## 整理成文件再聚合
+
+把作者给的内容整理成下面的格式，存进本次输出目录（文件名 `{平台}{榜单}_{YYYYMMDD}.md`），再和脚本采集的榜单一起聚合：
+
+```markdown
+# 知乎盐言 · 热门榜
+
+### #1 {书名}
+*{作者} · {题材} · {状态} · {字数}字 · {热度数字}收藏*
+**标签：** {标签1}、{标签2}
+
+> {简介}
+```
+
+热度写成「数字 + 口径」（如 `2.3万收藏`、`1.2万热度`），聚合才认得。缺的字段直接省略，不要编。
+
+## 知乎盐言分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 热门榜单 | 当前最受关注的故事 |
+| 高赞故事 | 口碑最好的作品结构 |
+| 新作者上榜 | 非头部账号的题材选择与开篇模式 |
+| 付费转化 | 哪些题材读者愿意付费 |
+| 标签分布 | 热门标签的变化趋势 |

package/lib/oh-story/skills/story-short-scan/references/platform-dianzhong.md

@@ -0,0 +1,24 @@
+# 点众短篇：采集与分析
+
+作者选了点众才读本文。需先用 `/browser-cdp` 启动 Chrome；不需要登录。脚本按 bookId 聚合页面链接解出书名、评分、简介、作品页（避免把 UI 文字或简介误当书名），带连通性自检和书名解析率质量门。
+
+## 页面与命令
+
+| 页面 | URL |
+|------|-----|
+| 男频短篇 | ishugui.com/browse |
+| 女频短篇 | ishugui.com/browse/on3 |
+
+`node scripts/dz-browse-scraper.js --channel male|female|all --outdir {输出目录}`，文件名 `点众{男频/女频}短篇_{YYYYMMDD}.md`。
+
+## 字段
+
+书名、作者、标签（聚合时当题材）、状态、字数、评分（聚合的热度口径）、最新章节、作品页、简介。文件头 `数据质量` 标 `[书名解析异常]` 时，多为页面结构变动或未加载完：人工打开对应 URL 确认页面正常后重采。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 标签分布 | 家庭复仇、假千金、弹幕流等题材的集中度 |
+| 评分 | 同题材里口碑拉开差距的作品 |
+| 字数 | 主力篇幅（通常 1-2 万字、5-10 章） |

package/lib/oh-story/skills/story-short-scan/references/platform-heiyan.md

@@ -0,0 +1,21 @@
+# 黑岩短篇：采集与分析
+
+作者选了黑岩才读本文。**黑岩需要登录**：先用 `/browser-cdp` 启动 Chrome，请作者在 Chrome 里手动登录 `manage.zhangwenpindu.cn`，脚本再从 Cookie 取 Bearer token 调后端接口；未登录会报错提示。采集失败就跳过黑岩继续其他平台，报告里说明结论不含它。
+
+## 页面与命令
+
+书库列表：manage.zhangwenpindu.cn/books/booklist
+
+`node scripts/heiyan-booklist-scraper.js --channel male|female|all --pages N --outdir {输出目录}`（每页 20 条；`--detail` 逐本取标签和简介，较慢），文件名 `黑岩书库列表_{频道}_{YYYYMMDD}.md`。脚本区分 CDP 未连、未登录、超时、接口错误，并带书名命中率质量门。
+
+## 字段
+
+书名、作者、分类/类型（聚合时类型当题材）、字数、价格、创建/更新时间、标签与简介（`--detail`）。书库列表没有热度字段，聚合按列表顺序取代表作，热度结论要靠标签和更新时间旁证，可信度写低一档。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 类型分布 | 虐恋、复仇、身份反转的占比 |
+| 创建/更新时间 | 近期新开的集中在哪些类型 |
+| 标签组合 | 极端情绪的具体包装方式 |

package/lib/oh-story/skills/story-short-scan/references/topic-match.md

@@ -0,0 +1,38 @@
+# 短篇扫榜结论：落盘与交接
+
+短篇扫榜的结论写进输出目录的 `短篇扫榜结论.md`：Phase 4 写文件头和「扫榜结论」，Phase 5 写「选题匹配」。`/story-short-write` 定目标情绪时会读它，所以作者不必记住上次聊了什么。
+
+## 短篇扫榜结论.md 模板
+
+```
+# 短篇扫榜结论：{平台/方向}
+- 扫榜日期：{YYYYMMDD}
+- 复扫日期：{YYYYMMDD}     # 短篇风口有效期短，通常扫榜后 2-4 周；过了这天结论只当参考
+- 数据来源：{榜单文件名 / 作者提供 / 内置知识}
+- 聚合表：扫榜聚合.md     # 同目录；内置知识模式写「无」
+
+## 扫榜结论：{平台名称}
+{Phase 4 报告正文}
+
+## 选题匹配
+
+### 方向 1：{一句话方向}
+- 目标情绪：{读者读完的感觉，如意难平/爽感释放/反转震撼}
+- 题材与设定：{题材包 + 核心设定}
+- 开头钩子：{前 3 句建立的冲突、身份差或情绪钩子}
+- 传播引擎：{反转 / 强共鸣 / 强话题 / 强余韵}
+- 复杂度：低/高 — {低：反转、打脸；高：悬疑、虐恋}
+- 可行性：高/中/低 — {同方向样本几篇 + 趋势 + 作者素材能否撑住}
+- 篇幅/平台：{建议字数 + 目标平台}
+- 验证动作：{开写前怎么低成本验证}
+
+### 方向 2 ...
+```
+
+2-3 个方向为宜，按可行性排序（高的在前）。
+
+## 规则
+
+- 可行性上限：聚合表标「少」、样本不到 10 篇或来自作者只给的故事名列表 ⇒ 不许给「高」；内置知识模式一律给「中」。
+- 重跑时整节替换，不追加第二份；「扫榜结论」和「选题匹配」都保留在同一个文件里。
+- 交付时告诉作者路径：「开写时把小说项目建在扫榜时的文件夹里或和它同级，`/story-short-write` 会自动找到；隔得远就把 `短篇扫榜结论.md` 复制到项目根。」

package/lib/oh-story/skills/story-short-write/SKILL.md

@@ -10,23 +10,26 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 **执行规则：短篇以情绪为目标，所有内容为情绪服务。**
 
-## 阶段 Reference Gate（强制，先读后写）
+## 写前必读（强制，先读后写）
 
-任何创建或修改故事文件的动作之前，先判断当前 Phase，并完成该阶段的 reference gate。**只读本 SKILL.md 不算完成门禁。**
+短篇按作者时刻加载：每个时刻只读自己的文件，后一时刻只靠落盘文件接上前一时刻。创建或修改故事文件前，先判断当前时刻并完整读取它的必读项（分块直到 EOF；`rg` 检索或局部摘读不算读完）。**只读本 SKILL.md 不算完成门禁。**
 
-Phase 2 必须在第一次写入 `设定.md` / `小节大纲.md` 前按顺序完整读取（分块直到 EOF；`rg` 检索或局部摘读不算读完）：
+| 时刻 | 作者确认什么 | 读什么 | 落盘 |
+|---|---|---|---|
+| 定情绪（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` |
 
-1. `references/workflow-design.md` + `references/writing-workflow.md`、`references/submission-craft.md`、`references/short-craft.md`、`references/short-reversal.md`
-2. 核心 10 题材再读取一个精确的 `references/genre-styles/{题材}.md`；冷门题材改读 `references/genre-writing-formulas.md`
-3. 有反派或真相揭露设计时再读 `references/villain-and-reveal.md`；不适用时在设计校验区写明原因
+构思必读项在第一次写入 `设定.md` / `小节大纲.md` 前读完。任一必需路径不存在、不可读或题材尚未解析到唯一 reference 时，立即停止，报告准确路径/待定项，**不得创建或修改故事产物**。不要把“已读 references”的回执写进故事文件；选出的题材招式、反转计算等应用证据写进正常设计字段。每个时刻按当前任务完整回读，不得用早先读过代替。
 
-任一必需路径不存在、不可读或题材尚未解析到唯一 reference 时，立即停止，报告准确路径/待定项，**不得创建或修改故事产物**。不要把“已读 references”的回执写进故事文件；要把选出的题材招式、反转计算等应用证据写进正常设计字段。Phase 3 写正文前完整读取 `references/workflow-draft.md`，Phase 4 精修前完整读取 `references/workflow-revision.md`，再按各阶段的写前准备和精修检查加载所需资料，不得用早先读过代替当前任务完整回读。
+**交接只靠落盘**：作者在对话里定下的字数、平台、人称、偏好、红线和否掉的方案，构思交付前写进 `设定.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`。
+> 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: 32` 不一致时（标记缺失、字段缺失/非整数、小于或大于 32）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 32）` 并提示重新运行 `/story-setup` 后新开会话；大于 32 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> 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；同一裁决交给后续执行者。
 
@@ -40,30 +43,24 @@ Phase 2 必须在第一次写入 `设定.md` / `小节大纲.md` 前按顺序完
 
 ---
 
-## 格式规范（最高优先级）
-
-详细规则见 `references/short-format.md`，写作前必须加载。**主会话与 narrative-writer 子代理使用同一套正文格式**：正文只允许保存在 `正文.md`，正文相邻段落之间只允许一个换行符 `\n`（不得出现空行/`\n\n`），对话引号风格按项目/平台约定统一（默认半角双引号，盐言可用「」），短篇小节标记全文统一（默认 `###1.`/`###2.`）。如果子代理输出与主会话格式不一致，按本格式规范重排后再写入文件。
-
----
-
 ## 核心方法
 
 除了上面的执行规则，构思和写作时遵循：
 
-- **从验证过的模式出发**：有对标书就先拆解，没有就从 `genre-styles/{题材}.md`（核心 10 题材）或 `genre-writing-formulas.md`（冷门题材）找对应的短篇剧情模式
-- **定方向就换风格**：题材方向一旦确定（如追妻火葬场），立刻加载 `references/genre-styles/{题材}.md`——正文的腔调、开篇、钩子、情绪烈度、对话金句、招式、收尾全部切到该题材。核心 10 题材（追妻火葬场 / 世情打脸 / 复仇打脸 / 总裁豪门 / 宅斗宫斗 / 民俗怪谈 / 悬疑 / 甜宠 / 双男主 / 沙雕脑洞）有专属风格包，其中追妻含 现代/古代/民国 时代变体与 小三文学/死人文学 流派分支；冷门题材用 `genre-writing-formulas.md` 的结构骨架兜底，腔调仍按 `short-craft.md` 通用底座
-- **只加载必需信息**：写每节前明确目标情绪和要用的技法，答不出就先回读参考
-- **复用作者习惯**：若作者记忆已存在，正文前用 `scripts/author_memory_commit.py query --kind prose_style --kind story_design --book-root {项目目录}` 获取 active 条目（≤2KB），传给正文/改写 agent 作为自然倾向，不逐条展示或最大化命中，不牺牲连贯、节奏和字数；硬门禁、当前请求和本篇设定优先。长期声明在收尾用 `record` 写入并回传回执，细则见 [references/author-memory.md](references/author-memory.md)。
+- **定方向就换风格**：题材一旦确定，腔调、开篇、钩子、情绪烈度、金句、招式、收尾全部切到该题材包（追妻含时代变体与小三/死人文学分支）；冷门题材用公式结构骨架兜底，腔调按 `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：确定情绪目标
+### Phase 1：确定目标情绪
+
+从项目根及上一级往下 3 层找到 `短篇扫榜结论.md`（多份取最新）时先读其「选题匹配」，排第一的方向带着目标情绪当候选问作者；过了复扫日期就提醒可能过期。
 
 问用户：**「你想让读者读完什么感觉？有没有想写的题材方向或灵感？」**
 
-如果用户有明确想法 → 直接进入 Phase 2。
+用户已说清读者读完的感觉 → 直接进入 Phase 2；只给了题材或梗、没说情绪 → 从下表带一个推荐情绪问一句，作者点头再进。
 
 如果用户只有模糊想法 → 帮用户做情绪选择：
 
@@ -80,21 +77,19 @@ Phase 2 必须在第一次写入 `设定.md` / `小节大纲.md` 前按顺序完
 
 ### Phase 2：构思核心框架
 
-> 如果用户有参考小说，先用 `/story-short-analyze` 拆解。默认输出存入项目根目录 `拆文库/{书名}/`；如用户指定当前短篇引用目录，则可输出/同步到 `{短篇标题}/对标/{书名}/`。写作时会自动查找并读取这些拆文结果，不需要用户手动复制到 prompt。
-
 #### 对标上下文加载
 
 存在本篇 `对标/`、项目根 `拆文库/` 或用户提供参考小说时，先完整读取 [references/benchmark-recall.md](references/benchmark-recall.md)，执行对标发现、排除本书续写基线、题材匹配与召回。无外部对标时仍按原题材包执行。
 
 #### 构思、设计与验收
 
-完整步骤见 [references/workflow-design.md](references/workflow-design.md)。按首屏 Reference Gate 读完后执行；两份设计文件通过其中的 Phase 2 完成门禁，才可进入 Phase 3。
+完整步骤见 [references/workflow-design.md](references/workflow-design.md)。按首屏「写前必读」读完后执行；两份设计文件通过其中的 Phase 2 完成门禁，才可进入 Phase 3。
 
 ---
 
 ### Phase 3：逐场景写作
 
-进入正文写作前，完整读取 [references/workflow-draft.md](references/workflow-draft.md)，执行交付参数锁定、写前验收、逐场景写作与 Phase 3 完成门槛。只做构思或精修时不加载本阶段细则。
+进入正文写作前，完整读取 [references/workflow-draft.md](references/workflow-draft.md)，执行交付参数锁定、写前验收与逐场景写作；只做构思或精修时不加载。
 
 **小节完整性流程**：
 1. **写作时**：每节围绕一个主问题推进；让风险、信息、关系、资源、决定、行动或读者理解至少发生一项可见变化。相关情节点可以由同一动作链或对话同时兑现，不为拆成多个“子事件”重复铺陈。
@@ -118,7 +113,7 @@ Phase 2 必须在第一次写入 `设定.md` / `小节大纲.md` 前按顺序完
 
 ### Phase 4：精修打磨
 
-精修或质量自检前，完整读取 [references/workflow-revision.md](references/workflow-revision.md)，执行语义去味、一致性检查、最终文件扫描与交付验收；修改后按其中职责分工复核。只做构思时不加载本阶段细则。
+精修或质量自检前，完整读取 [references/workflow-revision.md](references/workflow-revision.md)，按其职责分工去味、查一致性、做最终扫描与交付验收；只做构思时不加载。
 
 ---
 
@@ -127,19 +122,13 @@ Phase 2 必须在第一次写入 `设定.md` / `小节大纲.md` 前按顺序完
 **流水线：** 短篇
 **位置：** 写作（第 3/3 步）
 
-| 时机 | 跳转到 | 命令 |
-|---|---|---|
-| 有参考小说想对标 | story-short-analyze | `/story-short-analyze` → 输出存入 `拆文库/{书名}/` |
-| 写完，去 AI 味 | story-deslop | `/story-deslop` |
-| 想自检 | 本 skill 质量自检 | 用 Phase 4 自检流程 + `references/short-prose-quality.md` 逐项核对 |
-| 需要市场方向 | story-short-scan | `/story-short-scan` |
-| 设定太大，适合长篇 | story-long-write | `/story-long-write` |
+有参考小说想对标 → `/story-short-analyze`（存入 `拆文库/{书名}/`）；写完去 AI 味 → `/story-deslop`；想自检 → Phase 4 流程 + `references/short-prose-quality.md`；要市场方向 → `/story-short-scan`；设定太大适合长篇 → `/story-long-write`。
 
 ---
 
 ## 参考资料
 
-阶段必读项按首屏 Reference Gate 执行；其他资料按 [参考索引](references/reference-index.md) 的加载条件选用。
+阶段必读项按首屏「写前必读」执行；其他资料按 [参考索引](references/reference-index.md) 的加载条件选用。
 
 ## 语言
 

package/lib/oh-story/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/lib/oh-story/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` 会随事务创建。