@oh-story/dsh 0.1.16 → 0.1.17

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

@@ -14,11 +14,11 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### 原则 1：短篇市场是情绪市场
 
-扫榜从题材和简介中提取目标情绪、触发场景与情绪爆发点，说明这些内容如何吸引读者。仅凭题材名无法判断具体情绪体验。
+扫榜从题材和简介中判断读者读完的感受、触发场景与情绪爆发点，说明这些内容如何吸引读者。仅凭题材名无法判断具体情绪体验。
 
-### 原则 2：短篇的生命力在传播
+### 原则 2：热度只按各平台自己的口径比
 
-榜单提供完读、分享、收藏或点赞数据时，按各自口径比较。排名和互动量只说明样本受到的关注，不能据此断定故事质量或情绪拉扯效果。
+榜单给的收藏、赞同、在读、评分各有口径，只在同一口径内比较。排名和互动量只说明样本受到的关注，不能据此断定故事质量或情绪拉扯效果。
 
 ### 原则 3：短篇风口来得快去得快
 
@@ -30,7 +30,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 1：确认平台和方向
 
-用户已给出平台或方向时直接采用，只问缺项：**「想看哪个平台、哪类短篇？点众可直接采集，黑岩需要先登录作者后台；知乎盐言、番茄和七猫短篇请提供榜单截图、文字或链接。」**
+用户已给出平台或方向时直接采用，只问缺项：**「想看哪个平台、男频还是女频、哪类短篇？点众可直接采集；黑岩要有黑岩后台账号、先登录；知乎盐言、番茄和七猫短篇请发榜单截图、文字或链接。手里有编辑的征稿要求也可以一起发来。」**
 
 关键判断：
 - 用户已有方向 → 针对该方向做深度扫榜
@@ -41,39 +41,49 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 2：确定数据来源
 
-**扫榜需要真实数据支撑。** 根据当前环境选择数据来源：
-
 | 优先级 | 模式 | 说明 | 何时用 |
 |--------|------|------|--------|
-| 1 | **脚本采集** | 点众、黑岩：直接抓取平台页面，产出结构化文件 | 有 Chrome 环境时（优先） |
+| 1 | **脚本采集** | 点众、黑岩：抓取平台页面，产出结构化文件 | 有 Chrome 环境时（优先） |
 | 2 | **作者提供** | 没有脚本的平台，或作者已有榜单 | 知乎盐言/番茄短篇/七猫短篇等 |
 | 3 | **内置知识** | 用历史资料提出待验证的选题 | 无法联网、作者也没有数据时 |
 
-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`。仅用内置知识时跳过聚合。
+命令中的 `scripts/` 相对本 skill 根目录。
+
+1. 只读所选平台那一份：[点众](references/platform-dianzhong.md) / [黑岩](references/platform-heiyan.md) / [没有脚本的平台](references/manual-rank-input.md)。其中有网址、命令、字段、故障排查、平台分析维度和作者榜单的整理格式。
+2. 每次扫榜新建输出目录 `扫榜/{YYYYMMDD}/`（同日再扫加 `-2`）存本次榜单，不往旧目录追加（聚合会混进旧榜）。脚本自动命名文件，作者榜单按平台参考命名；某平台失败就跳过。对比时读上个日期目录的 `扫榜聚合.md`。
+3. 聚合：`node scripts/aggregate-rank.js {输出目录} --out {输出目录}/扫榜聚合.md --sparse 10 --scale short`。**主会话只读这份聚合**，需要原始简介与人设信息时再抽样：`node scripts/aggregate-rank.js {输出目录} --sample {题材/标签/书名词} --n 5`。
+4. 看聚合的「采集情况」：标了问题（书名没解出来、没采到、详情没取到）的榜单按平台参考排查重采；重采不了就在报告里说明结论不含它。
+5. 作者发来征稿要求：原文存进输出目录的 `征稿要求.md`，题材、字数、截止日期当硬条件。
 
-**内置知识：** 加载 `references/real-market-data.md`（跨平台写作差异对照），明确标注「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的平台页面。
+**内置知识：** 跳过聚合，加载 [references/real-market-data.md](references/real-market-data.md)，明确标注「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的平台页面。
 
 ---
 
 ### Phase 3：数据分析
 
-有真实样本时，以聚合结果和平台参考的「分析维度」为准，提取下列信息。趋势需对比同口径的多期样本；仅用内置知识时只给待验证候选，不填写当前数量、占比或涨跌。
+有真实样本时，以聚合结果和平台参考的「分析维度」为准。趋势需对比同口径的多期样本；仅用内置知识时只给待验证候选，不填写当前数量、占比或涨跌。
+
+1. **情绪排行**：按本节末的情绪表把题材、标签归入六种写作情绪，按样本数量比较。每本书根据简介判断读者读完的感受，只归一类；标签只是线索，无法判断的计「待定」。悬疑题材按简介落点分：最后揭开真相的归反转震撼，留下寒意的归细思极恐
+2. **题材热点**：聚合的题材表和标签热词里反复出现的设定、场景
+3. **篇幅分布**：聚合的字数分布与各题材字数中位
+4. **简介与书名写法**：抽样简介怎么前置冲突、留悬念，书名常见词与代表作标题；可对照 [real-market-data](references/real-market-data.md) 的历史写法
+5. **结尾类型**：HE（好结局）/BE（坏结局）/开放式，只在作者提供的内容看得出结局时统计
+6. **人设模型**：抽样简介里反复出现的主角类型
 
-1. **情绪类型分布**：从题材和标签归并虐恋、反转、悬疑、治愈、打脸等类型，按样本数量比较
-2. **题材热点**：具体什么设定/场景反复出现
-3. **篇幅分布**：字数分布与各题材字数中位
-4. **开头模式**：抽样内容含正文开头时分析首句；只有简介时只判断简介的写法
-5. **结尾类型**：HE（好结局）/BE（坏结局）/开放式 的比例（抽样可见时）
-6. **标题模式**：书名常见词 + 代表作标题
-7. **人设模型**：反复出现的主角类型
+| 情绪 | 归入的题材与标签 | 难度 |
+|------|------------------|------|
+| 意难平 | 虐恋、遗憾、错过、追妻、白月光 | 中 |
+| 反转震撼 | 悬疑、身份错位、反转 | 高 |
+| 爽感释放 | 打脸、逆袭、复仇、重生改命、宅斗 | 低 |
+| 治愈温暖 | 成长、亲情、友情、甜宠 | 中 |
+| 细思极恐 | 悬疑、心理、民俗怪谈 | 高 |
+| 共鸣感动 | 现实、职场、婚姻、家庭 | 中 |
 
 ---
 
 ### Phase 4：输出扫榜报告
 
-报告讲市场结论和能写的方向。脚本名、命令和 SKIP 等采集状态不进报告；未采到的平台用一句话说明原因。模板中缺数据的项直接省略；单期样本不填涨跌，历史资料不填当前热度排行。
+报告讲市场结论和能写的方向。脚本名、命令和采集状态不进报告；未采到的平台用一句话说明原因。模板中缺数据的项直接省略；单期样本不写「变化」一节，历史资料不填当前数量和热度。点众、黑岩采的是在架书目，并非热度榜：只有它们的数据时，「榜上数量」写「在架数量」，热度中位一列点众写「评分中位」、黑岩省略，不说哪篇火。
 
 报告展示给作者，同时写进输出目录的 `短篇扫榜结论.md`：文件不存在就先按 [references/topic-match.md](references/topic-match.md) 的模板写文件头，再把报告作为「扫榜结论」一节写入（已存在就整节替换）。
 
@@ -86,32 +96,31 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 - 核心发现：{一句话总结}
 - 可信度：{样本多少篇、来自哪几个榜}；建议 {日期} 前后再扫一次
 
-### 情绪热度排行
-| 排名 | 情绪类型 | 榜上数量 | 趋势 | 代表作 |
-|------|----------|----------|------|--------|
-| 1 | {类型} | {N篇} | ↑/→/↓ | {标题} |
+### 情绪排行
+| 排名 | 情绪 | 榜上数量 | 代表作 |
+|------|------|----------|--------|
+| 1 | {情绪} | {N篇} | {标题} |
 
 ### 题材热点
-| 题材 | 热度 | 竞争程度 | 门槛 | 代表作 |
-|------|------|----------|------|--------|
-| {题材} | 高/中/低 | 激烈/一般/蓝海 | 高/中/低 | {标题} |
+| 题材 | 榜上数量 | 热度中位（{口径}） | 代表作 |
+|------|----------|--------------------|--------|
+| {题材} | {N篇} | {数值} | {标题} |
 
 ### 关键数据洞察
-- 篇幅区间：热门短篇集中在 {X}-{Y} 字
-- 开头模式：{高频开头模式}
+- 篇幅区间：样本集中在 {X}-{Y} 字
+- 简介写法：{高频写法}
 - 结尾偏好：{HE/BE/开放式的比例}
 - 标题特征：{命名规律}
 - 人设热词：{高频主角类型}
 
-### 风口预警
-- 🔥 正在爆发：{题材} — {依据}
-- ⚡ 即将起风：{题材} — {依据}
-- ⚠️ 即将饱和：{题材} — {依据}
+### 变化（和 {上期日期} 比）
+- 升温：{题材或情绪} — {本数或热度怎么变}
+- 降温：{题材或情绪} — {本数或热度怎么变}
 
 ### 值得写的方向
-1. {方向 + 情绪拉扯方式 + 可行性}
-2. {方向 + 情绪拉扯方式 + 可行性}
-3. {方向 + 情绪拉扯方式 + 可行性}
+1. {方向 + 情绪拉扯方式 + 同方向几篇}
+2. {方向 + 情绪拉扯方式 + 同方向几篇}
+3. {方向 + 情绪拉扯方式 + 同方向几篇}
 
 ### 一句话
 {犀利总结}
@@ -121,11 +130,11 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 5：选题匹配
 
-先读 `短篇扫榜结论.md` 的「扫榜结论」及同目录 `扫榜聚合.md`；内置知识模式没有聚合表，只读历史候选。结合项目素材与作者能力，按 [references/topic-match.md](references/topic-match.md) 写进同一文件的「选题匹配」一节：
+先读 `短篇扫榜结论.md` 的「扫榜结论」及同目录 `扫榜聚合.md` 和 `征稿要求.md`（有的话）；内置知识模式没有聚合表，只读历史候选。
 
-- 低复杂度候选：反转类、打脸类（结构清晰、验证成本低）
-- 高复杂度候选：悬疑类、虐恋类（技术壁垒高，需要伏笔、反转和情绪控制证据）
-- 优先候选：样本信号明确，且项目素材与作者能力能够支撑的方向
+作者未提供的信息集中问一句：**「打算投哪个平台（还是自己发）？手里有什么素材、擅长写什么？计划写多少字？」** 作者不想答就按样本给方向，可行性最高写「中」。
+
+按 [references/topic-match.md](references/topic-match.md) 写进同一文件的「选题匹配」一节。优先选样本信号明确、作者素材和条件撑得住的方向，写作难度按 Phase 3 情绪表定。
 
 **关键判断**：
 - 先说明选题提供的情绪体验，再说明题材创新如何支持它
@@ -134,19 +143,6 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ---
 
-## 平台特性速查
-
-下表用于定位历史写法，当前题材分布与篇幅以本次样本为准；收费规则查平台说明。
-
-| 平台 | 历史样本特点 | 可比较的类型与写法 |
-|------|--------------|--------------------|
-| 知乎盐言故事 | 情感与认知变化，表达较克制 | 虐恋、反转、悬疑、现实 |
-| 七猫短篇 | 重生纠错、关系冲突，短章推进 | 总裁、现实、宅斗、年代、悬疑 |
-| 黑岩短篇 | 强刺激、虐恋与快节奏对抗 | 虐恋、复仇、身份反转 |
-| 点众短篇 | 事件集中，情绪兑现直接 | 家庭复仇、假千金、弹幕流 |
-
----
-
 ## 流程衔接
 
 **流水线：** 短篇
@@ -162,14 +158,8 @@ 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) | 点众短篇采集（男频/女频），用法见点众参考 |
-| [scripts/heiyan-booklist-scraper.js](scripts/heiyan-booklist-scraper.js) | 黑岩书库列表采集（需登录），用法见黑岩参考 |
+| 三份平台参考（链接见 Phase 2 第 1 步） | 确定数据来源：只读所选平台那份 |
+| [references/topic-match.md](references/topic-match.md) | 出报告和选题：`短篇扫榜结论.md` 模板、平台对照、可行性上限与交付 |
+| [references/real-market-data.md](references/real-market-data.md) | 内置知识模式；有榜单时对照简介和书名的历史写法 |

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

@@ -1,36 +1,40 @@
 # 没有采集脚本的平台：作者提供榜单
 
-知乎盐言、番茄短篇、七猫短篇等平台目前没有采集脚本，需要作者提供榜单。作者选了这些平台才读本文。
+知乎盐言、番茄短篇、七猫短篇等平台没有采集脚本，需要作者提供榜单。作者选了这些平台才读本文。
 
 ## 向作者要什么
 
-「请发榜单截图、文字或链接，尽量带上书名、作者、题材、字数和热度，并注明是赞同、收藏还是在读。能提供简介也一起发来。」
+「请发榜单截图、文字或链接，尽量带上书名、作者、题材、字数和热度，并注明是赞同、收藏还是在读。能提供简介也一起发来。手里有编辑的征稿或约稿要求，也一起发来。」
 
-- 链接 → 用 WebFetch 抓取；抓不到就请作者改发截图或文字
+- 链接 → 能打开就读；打不开就请作者改发截图或文字
 - 只有故事名列表 → 可以直接分析，但报告的可信度写低一档
 
 ## 整理成文件再聚合
 
-把作者给的内容整理成下面的格式，存进本次输出目录（文件名 `{平台}{榜单}_{YYYYMMDD}.md`），再和脚本采集的榜单一起聚合：
+把作者给的榜单整理成下面的格式，存进本次输出目录（文件名 `{平台}{榜单}_{YYYYMMDD}.md`），再和脚本采集的榜单一起聚合：
 
 ```markdown
 # 知乎盐言 · 热门榜
 
+- 抓取时间：{榜单截图或页面的日期，YYYY-MM-DD}
+- 数据质量：作者提供
+
 ### #1 {书名}
-*{作者} · {题材} · {状态} · {字数}字 · {热度数字}收藏*
+*{作者} · {题材} · {状态} · {字数}字 · {热度数字}{口径}*
 **标签：** {标签1}、{标签2}
 
 > {简介}
 ```
 
-热度写成「数字 + 口径」（如 `2.3万收藏`、`1.2万热度`），聚合才认得。缺的字段直接省略，不要编。
+- 聚合脚本按位置识别字段：第一格是作者，第二格是题材。截图没有作者就用 `佚名` 占位，作者和题材的顺序不能变；不能写「未知」，聚合会按空值跳过，导致题材被错认成作者。
+- 热度写成「数字 + 口径」（如 `2.3万收藏`、`8000赞同`），聚合才认得。一份文件只用一种口径，口径不同的榜分文件存。
+- 状态、字数、标签、简介缺了直接省略，不要编。
 
-## 知乎盐言分析维度
+## 能看什么
 
 | 维度 | 看什么 |
 |---|---|
-| 热门榜单 | 当前最受关注的故事 |
-| 高赞故事 | 互动较多的作品采用了哪些结构 |
-| 新作者上榜 | 非头部账号的题材选择与开篇模式 |
-| 付费转化 | 有转化数据时比较题材；仅凭排名或点赞不推算转化 |
-| 标签分布 | 热门标签的变化趋势 |
+| 题材与标签 | 榜上集中在哪些题材，哪些标签反复出现 |
+| 字数 | 字数中位和分布 |
+| 简介写法 | 简介怎么前置冲突、留悬念（作者给了简介时） |
+| 作者分布 | 头部账号与新作者各写什么（作者给了作者名时） |

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

@@ -1,6 +1,6 @@
 # 点众短篇：采集与分析
 
-作者选择点众时读取。先用 `/browser-cdp` 启动 Chrome，无需登录。脚本按 bookId 归并页面链接，解析书名、评分、简介和作品页，并检查连通性与书名解析率。
+作者选择点众时读取。先用 `/browser-cdp` 启动 Chrome，无需登录。
 
 ## 页面与命令
 
@@ -13,12 +13,18 @@
 
 ## 字段
 
-包含书名、作者、标签、状态、字数、评分、最新章节、作品页和简介。聚合时标签归为题材，评分作为该平台的热度口径，不与收藏或在读数直接比较。文件头出现 `[书名解析异常]` 时，打开对应页面确认已加载且结构正常，再重新采集。
+书名、作者、标签、状态、字数、评分、最新章节、作品页和简介。聚合时标签归为题材。评分反映口碑，不是关注度，只在点众内部比较，不与收藏或在读数换算。
+
+## 采集出问题
+
+- 报 CDP 无响应：先用 `/browser-cdp` 启动 Chrome 再重跑。
+- 报页面不是点众：页面被重定向了，在 Chrome 里手动打开上表网址确认能看到书单再重跑。
+- 文件头写着书名解析异常，或聚合「采集情况」说书名大多没解出来：打开对应页面确认已加载完、结构正常，再重新采集；仍不行就在报告里说明点众这次不可用。
 
 ## 分析维度
 
 | 维度 | 看什么 |
 |---|---|
-| 标签分布 | 家庭复仇、假千金、弹幕流等题材的集中度 |
+| 标签分布 | 哪些题材标签最集中 |
 | 评分 | 同题材里口碑拉开差距的作品 |
-| 字数 | 主力篇幅（通常 1-2 万字、5-10 章） |
+| 字数 | 字数中位和分布，以本次样本为准 |

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

@@ -1,21 +1,30 @@
 # 黑岩短篇：采集与分析
 
-作者选择黑岩时读取。先用 `/browser-cdp` 启动 Chrome，请作者手动登录 `manage.zhangwenpindu.cn`；脚本使用登录会话调用接口，未登录会提示报错。采集失败时继续其他平台，并在报告中说明未包含黑岩。
+作者选择黑岩时读取。采的是黑岩管理后台的书库列表，反映近期上架作品的题材分布，不是热度榜：没有阅读、收藏等热度数字，不能据此说哪本火。
+
+作者需有能登录 `manage.zhangwenpindu.cn` 的黑岩后台账号。先用 `/browser-cdp` 启动 Chrome，请作者在里面手动登录。没有账号或采集失败时继续其他平台，并在报告里说明未包含黑岩。
 
 ## 页面与命令
 
 书库列表：manage.zhangwenpindu.cn/books/booklist
 
-`node scripts/heiyan-booklist-scraper.js --channel male|female|all --pages N --outdir {输出目录}`（每页 20 条；`--detail` 逐本取标签和简介，较慢），文件名 `黑岩书库列表_{频道}_{YYYYMMDD}.md`。脚本区分 CDP 未连、未登录、超时、接口错误，并带书名命中率质量门。
+`node scripts/heiyan-booklist-scraper.js --channel male|female|all --pages 3 --detail --outdir {输出目录}`，文件名 `黑岩书库列表_{male/female/all}_{YYYYMMDD}.md`。每页 20 本；`--detail` 逐本取标签和简介，每本约半秒，判断情绪要靠这些信息，默认带上。
 
 ## 字段
 
-包含书名、作者、分类/类型、字数、价格和创建/更新时间；`--detail` 另取标签与简介。聚合时类型归为题材，按列表顺序选代表作。书库没有热度字段，不能从标签或更新时间推断作品热度；这两项只用于分析题材分布与近期创作情况。
+书名、作者、频道/类型、字数、价格、创建和更新时间；加 `--detail` 可取标签和简介。聚合时类型归为题材；代表作按标签贴合方向挑，列表顺序不代表热度。
+
+## 采集出问题
+
+- 报 CDP 无响应：先用 `/browser-cdp` 启动 Chrome 再重跑。
+- 报未检测到登录、认证失败：请作者在 Chrome 里重新登录后重跑。
+- 报接口无响应、字段疑似变动：多为登录过期或后台改版，重新登录后仍失败就跳过黑岩。
+- 聚合「采集情况」说详情大多没取到：登录过期，重新登录后重跑。
 
 ## 分析维度
 
 | 维度 | 看什么 |
 |---|---|
-| 类型分布 | 虐恋、复仇、身份反转的占比 |
-| 创建/更新时间 | 近期新开的集中在哪些类型 |
-| 标签组合 | 极端情绪的具体包装方式 |
+| 类型分布 | 近期上架集中在哪些类型 |
+| 创建/更新时间 | 新开的书集中在哪些类型 |
+| 标签组合 | 同类型下情绪的具体包装方式 |

package/lib/oh-story/skills/story-short-scan/references/real-market-data.md

@@ -1,89 +1,51 @@
-# 短篇网文跨平台写作参考
+# 短篇平台历史样本
 
-> 比较平台风格、简介与题材组合，或选择平台时查阅。
+无实时榜单时用于提出待验证候选；有榜单时，可对照书名和简介写法。
 
-## 决策路由
+以下是七猫、黑岩、知乎、点众的历史样本笔记。这些笔记没有采样时间、样本清单和统计口径，只保留定性模式。平台偏好、篇幅和收费规则以本次扫榜结果或平台说明为准，不能由本文推定。
 
-| 你需要什么 | 查看哪个部分 | 核心操作 |
-|------------|-------------|---------|
-| 对比各平台差异 | 跨平台差异对照表 | 比较历史模式与当前样本，辅助选平台 |
-| 分析简介/导语 | 各平台简介写作公式 | 识别简介中的冲突与悬念 |
-| 找题材组合 | 题材爆款公式 | 对照组合、情绪与平台 |
-| 了解平台独特规则 | 平台独特特征 | 七猫/知乎/点众各有要点 |
-
----
-
-以下为七猫、黑岩、知乎、点众的历史样本笔记，未附采样时间、样本清单或统计口径，只保留定性模式。平台偏好、篇幅与收费规则须用当前 scan 结果或平台说明核实，不能由本表推定。
-
----
-
-## 跨平台短篇写作差异对照表
+## 平台差异
 
 | 维度 | 七猫 | 黑岩 | 点众 | 知乎 |
 |------|------|------|------|------|
-| 主力字数 | 万字体量样本 | 篇幅跨度较大 | 万字体量样本 | 数千至万字体量样本 |
-| 章节数 | 多节展开 | 分段或长章 | 短章推进 | 多节展开 |
-| 人称 | 第一人称样本较多 | 第一、第三人称均有 | 第一人称样本较多 | 第一、第三人称均有 |
-| 章节字数 | 短章 | 可有较长章节 | 短章 | 短章 |
-| 对话占比 | 对话参与关系冲突 | 对话强化对抗 | 偏重功能性对白 | 对话兼顾人物表达 |
-| 段落结构 | 短段较多 | 短段较多 | 短句短段较多 | 长短句结合 |
-| 导语/简介 | 前置核心冲突 | 前置伤害或悬念 | 浓缩事件与反击 | 可形成独立微型故事 |
+| 核心定位 | 重生与纠错幻想 | 强刺激与虐恋 | 快速情绪兑现 | 情感与认知变化 |
+| 简介 | 前置核心冲突 | 前置伤害或悬念 | 浓缩事件与反击 | 可形成独立微型故事 |
 | 开头模式 | 重生回溯/冲突前置 | 极端冲击/道德踩踏 | 标题即剧情/极端事件 | 一句话炸弹/金句开场 |
 | 结尾模式 | 和解或新生活 | 圆满与悲剧均有 | 追悔或反击兑现 | 开放、反转等多种收束 |
 | 独特元素 | 重生、穿书、心声流 | 灵魂视角、虐恋极致 | 弹幕流、读心、系统流 | 专业细节、脑洞、BL |
-| 反转手法 | 态度反转(重生后180度转变) | 道德反转+恐怖反转 | 身份反转+死亡反转 | 信息差+情感深层揭露 |
+| 反转手法 | 态度反转（重生后 180 度转变） | 道德反转、恐怖反转 | 身份反转、死亡反转 | 信息差、情感深层揭露 |
 | 爽点节奏 | 受压、觉醒、反击与治愈 | 反转与情绪爆发交替 | 局部转折汇入终局 | 逐步揭示旧信息的新含义 |
-| 情绪密度 | 连续情绪变化 | 强烈情绪对抗 | 情绪表达直接 | 克制表达与延后释放 |
-| 对话引号 | 「」或"" | 「」或"" | ""为主 | 「」为主 |
-| 核心定位 | 重生与纠错幻想 | 强刺激与虐恋 | 快速情绪兑现 | 情感与认知变化 |
+| 情绪表达 | 连续情绪变化 | 强烈情绪对抗 | 情绪表达直接 | 克制表达与延后释放 |
 
----
+## 简介写法
 
-## 各平台简介写作公式
+| 平台 | 简介结构 | 核心特征 |
+|------|---------|---------|
+| 七猫总裁 | 正常生活 → 伤害事件 → 最残忍对话 → 女主反转 → 悬念钩子 | 以冲突对白展示关系伤害 |
+| 黑岩女频 | 递进式控诉/心声揭穿/绝症倒计时/重生对比/公开羞辱加底牌 | 核心是「这一次我……」 |
+| 黑岩男频 | 极简对白加信息炸弹/前世被害加重生/职场压榨加超自然 | 第一段前置冲突场景或对白 |
+| 点众 | 场景设定 + 信任陷阱 + 致命真相 + 反击暗示 | 简介浓缩前段冲突 |
+| 知乎 | 人物关系 + 核心冲突 + 转折 + 金句或留白 | 简介可形成独立微小说 |
 
-| 平台 | 简介公式 | 字数 | 核心特征 |
-|------|---------|------|---------|
-| 七猫总裁 | 正常生活->伤害事件->最残忍对话->女主反转->悬念钩子 | 以目标平台要求为准 | 以冲突对白展示关系伤害 |
-| 黑岩女频 | 递进式控诉/心声揭穿/绝症倒计时/重生对比/公开羞辱+底牌 | 同上 | 核心是"这一次我..." |
-| 黑岩男频 | 极简对白+信息炸弹/前世被害+重生/职场压榨+超自然 | 同上 | 第一段前置冲突场景或对白 |
-| 点众 | 场景设定+信任陷阱+致命真相+反击暗示 | 同上 | 简介浓缩前段冲突 |
-| 知乎 | 人物关系+核心冲突+转折+金句/留白 | 同上 | 简介可形成独立微小说 |
+知乎简介常以关键台词或留白收尾；故事偏社会议题（婆媳、重男轻女、医疗纠纷），专业细节多（医疗写医学知识，法律写法律细节）。
 
----
+## 点众书名
 
-## 题材爆款公式
-
-| 题材 | 爆款公式 | 核心情绪 | 目标平台 |
-|------|----------|----------|----------|
-| 总裁豪门 | 契约婚姻+白月光+觉醒离开 | 虐->爽 | 七猫/黑岩 |
-| 现实生活 | 家庭不公+重生/觉醒+反杀 | 愤怒->解气 | 七猫 |
-| 宫闱宅斗 | 被害+隐忍布局+反攻称帝 | 压抑->极致释放 | 七猫 |
-| 年代重生 | 替罪冤屈+重生+选不同路 | 憋屈->痛快 | 七猫 |
-| 现代悬疑 | 超自然设定+犯罪+反转 | 紧张->震撼 | 七猫/知乎 |
-| 玄幻仙侠 | 重生+反常行为+对手自乱 | 爽->更爽 | 七猫 |
-| 灵魂虐文 | 极致虐待+灵魂旁观+悔恨 | 愤怒->意难平 | 点众/黑岩 |
-| 职场逆袭 | 重生/穿越+投资+前夫后悔 | 憋屈->极爽 | 点众 |
-| 架空历史 | 性别反转/身份错位+离开+后悔 | 憋屈->释然 | 七猫 |
-| 家庭复仇 | 出轨/背叛+收集证据+当众打脸 | 愤怒->痛快 | 七猫/黑岩 |
+- `白眼狼妹妹把家产送人，我让她净身出户` = 人物 + 行为 + 反杀
+- `愚人节死在棺材里后，三个哥哥都悔疯了` = 事件 + 后果 + 情绪
+- `春节返程，老公一家把我女儿挂车外狗笼子里` = 场景 + 冲突 + 愤怒
 
----
+## 题材组合
 
-## 平台独特特征
-
-### 七猫
-
-- 第一人称与女性主角的历史样本较多
-- 常用短章推进，导语前置全文核心冲突
-
-### 知乎
-
-- 专业细节丰富（医疗有医学知识，法律有法律细节）
-- 社会议题导向（婆媳、重男轻女、医疗纠纷）
-- 情绪更克制但后劲更大，对话更真实
-- 部分简介采用微小说形式，以关键台词或留白收尾
-
-### 点众标题公式
-
-- `白眼狼妹妹把家产送人，我让她净身出户` = 人物+行为+反杀
-- `愚人节死在棺材里后，三个哥哥都悔疯了` = 事件+后果+情绪
-- `春节返程，老公一家把我女儿挂车外狗笼子里` = 场景+冲突+愤怒
+| 题材 | 常见组合 | 情绪走向 | 常见平台 |
+|------|----------|----------|----------|
+| 总裁豪门 | 契约婚姻 + 白月光 + 觉醒离开 | 虐 → 爽 | 七猫/黑岩 |
+| 现实生活 | 家庭不公 + 重生/觉醒 + 反杀 | 愤怒 → 解气 | 七猫 |
+| 宫闱宅斗 | 被害 + 隐忍布局 + 反攻称帝 | 压抑 → 极致释放 | 七猫 |
+| 年代重生 | 替罪冤屈 + 重生 + 选不同路 | 憋屈 → 痛快 | 七猫 |
+| 现代悬疑 | 超自然设定 + 犯罪 + 反转 | 紧张 → 震撼 | 七猫/知乎 |
+| 玄幻仙侠 | 重生 + 反常行为 + 对手自乱 | 爽 → 更爽 | 七猫 |
+| 灵魂虐文 | 极致虐待 + 灵魂旁观 + 悔恨 | 愤怒 → 意难平 | 点众/黑岩 |
+| 职场逆袭 | 重生/穿越 + 投资 + 前夫后悔 | 憋屈 → 极爽 | 点众 |
+| 架空历史 | 性别反转/身份错位 + 离开 + 后悔 | 憋屈 → 释然 | 七猫 |
+| 家庭复仇 | 出轨/背叛 + 收集证据 + 当众打脸 | 愤怒 → 痛快 | 七猫/黑岩 |

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

@@ -1,38 +1,58 @@
 # 短篇扫榜结论：落盘与交接
 
-结论写进本次输出目录的 `短篇扫榜结论.md`：Phase 4 写文件头和「扫榜结论」，Phase 5 写「选题匹配」。`/story-short-write` 定目标情绪时读取这份文件，接上选题结果。
+结论写进本次输出目录的 `短篇扫榜结论.md`：出报告时写文件头和「扫榜结论」，选题时写「选题匹配」。`/story-short-write` 定目标情绪时读这份文件的「选题匹配」和「复扫日期」，接上选题结果。
 
 ## 短篇扫榜结论.md 模板
 
-```
+```md
 # 短篇扫榜结论：{平台/方向}
 - 扫榜日期：{YYYYMMDD}
-- 复扫日期：{YYYYMMDD}     # 短篇风口有效期短，通常扫榜后 2-4 周；过了这天结论只当参考
+- 复扫日期：{YYYYMMDD}
 - 数据来源：{榜单文件名 / 作者提供 / 内置知识}
-- 聚合表：扫榜聚合.md     # 同目录；内置知识模式写「无」
+- 聚合表：{扫榜聚合.md，内置知识模式写「无」}
 
-## 扫榜结论：{平台名称}
-{Phase 4 报告正文}
+{扫榜报告全文，从「## 扫榜结论：{平台名称}」那一行起}
 
 ## 选题匹配
 
 ### 方向 1：{一句话方向}
-- 目标情绪：{读者读完的感觉，如意难平/爽感释放/反转震撼}
-- 题材与设定：{题材包 + 核心设定}
+- 目标情绪：{意难平 / 反转震撼 / 爽感释放 / 治愈温暖 / 细思极恐 / 共鸣感动，选一}
+- 题材与设定：{题材 + 核心设定}
+- 差异化：{同方向样本都在写什么，这个方向换了哪一处}
 - 开头钩子：{前 3 句建立的冲突、身份差或情绪钩子}
 - 传播引擎：{反转 / 强共鸣 / 强话题 / 强余韵}
-- 复杂度：低/高 — {低：反转、打脸；高：悬疑、虐恋}
-- 可行性：高/中/低 — {同方向样本几篇 + 趋势 + 作者素材能否撑住}
-- 篇幅/平台：{建议字数 + 目标平台}
-- 验证动作：{开写前怎么低成本验证}
+- 写作难度：{低/中/高，照扫榜情绪表的难度}
+- 可行性：{高/中/低} — {同方向样本几篇 + 趋势 + 作者素材能否撑住}
+- 失败风险：{最可能写砸或撞车的地方}
+- 篇幅/平台：{建议字数 + 目标平台，平台名按下方对照表写}
+- 验证动作：{开写前怎么低成本验证，见下}
 
 ### 方向 2 ...
 ```
 
 给出 2-3 个方向，按可行性从高到低排列。
 
+## 目标平台怎么写
+
+写作流程只接受下表右列平台名，目标平台照右列写：
+
+| 扫榜平台 | 写作目标平台 |
+|---|---|
+| 知乎盐言 | 知乎盐言 |
+| 番茄短篇 | 番茄 |
+| 七猫短篇 | 七猫 |
+| 黑岩 | 黑岩 |
+| 点众 | 小程序 |
+
+## 低成本验证
+
+- 导语试写：按目标平台写 150-300 字导语，自测或请两三个读者试读，看是否想点开正文。
+- 同一脑洞两版开头：换一种情绪或平台基调各写前 500 字，比较哪版更抓人。
+- 投编辑试稿：有征稿渠道时先发导语和大纲问编辑，再写全文。
+
 ## 规则
 
-- 可行性上限：聚合表标「少」、样本不到 10 篇或来自作者只给的故事名列表 ⇒ 不许给「高」；内置知识模式一律给「中」。
+- 复扫日期：短篇风口有效期短，一般定在扫榜后 2-4 周；过了这天结论只当参考。
+- 可行性上限：聚合表标「少」、样本不到 10 篇或只有作者给的故事名列表时，不许给「高」；内置知识模式最高给「中」；作者素材或条件撑不住，或不符合征稿要求时给「低」。
 - 重跑时分别替换「扫榜结论」和「选题匹配」，保留文件头，不追加重复小节。
 - 交付时告诉作者路径：「开写时把小说项目建在扫榜时的文件夹里或和它同级，`/story-short-write` 会自动找到；隔得远就把 `短篇扫榜结论.md` 复制到项目根。」

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

@@ -17,7 +17,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | 时刻 | 作者确认什么 | 读什么 | 落盘 |
 |---|---|---|---|
 | 定情绪（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 2） | 故事核、人物、反转、付费点 | ① `references/workflow-design.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”的回执。进入每个时刻都按当前任务完整回读。
@@ -29,7 +29,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 > 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: 35` 不一致时（标记缺失、字段缺失/非整数、小于或大于 35）**照常按文件存在性检查并 spawn**，同时用一句白话提示作者「写作助手是旧版，运行 /story-setup 后新开对话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 35）` 原文写进技术备注行；大于 35 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，`Fallback: ... -> solo` 同样只进技术备注行。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 36` 不一致时（标记缺失、字段缺失/非整数、小于或大于 36）**照常按文件存在性检查并 spawn**，同时用一句白话提示作者「写作助手是旧版，运行 /story-setup 后新开会话」，`Notice: agents bundle 版本不匹配（项目 {N}，本版 36）` 原文写进技术备注行；大于 36 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，`Fallback: ... -> solo` 同样只进技术备注行。
 
 **文风裁决**：正文写作、改写或审稿前先读 [references/style-resolution.md](references/style-resolution.md)，加载本书文风并形成 `style_resolution`；无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references；同一裁决交给后续执行者。
 
@@ -50,7 +50,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 ## 核心方法
 
 - **按题材选写法**：确定题材后，按文风裁决选用题材包的腔调、开篇、钩子、情绪烈度、金句、招式与收尾；追妻按时代变体及小三/死人文学分支选择。冷门题材用公式安排结构，腔调按 `short-craft.md`
-- **复用作者习惯**：有作者记忆时，正文前用 `scripts/author_memory_commit.py query --workspace {工作区} --book-root {项目目录} --kind prose_style --kind story_design [--genre {题材}] [--workflow 短篇]` 把输出的 `lines` 原样交正文/改写 agent 作自然倾向，不逐条追求命中，不牺牲连贯、节奏和字数；硬门禁、当前请求和本篇设定优先；没装下的交稿时用原话告诉作者。长期声明在收尾按上方管理入口处理。
+- **复用作者习惯**：有作者记忆时，正文前用 `scripts/author_memory_commit.py query --workspace {工作区} --book-root {项目目录} --kind prose_style --kind story_design [--genre {题材}] [--workflow 短篇]`（改写、去味只带 `--kind prose_style`），把输出的 `lines` 原样交正文/改写 agent 作自然倾向，不逐条追求命中，不牺牲连贯、节奏和字数；硬门禁、当前请求和本篇设定优先；没装下的交稿时用原话告诉作者。长期声明在收尾按上方管理入口处理。
 
 ---
 
@@ -101,7 +101,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 3 完成门槛（进入 Phase 4 前必须通过）
 
-- [ ] 总字数进入锁定的用户范围；未指定时进入 8000-20000 默认范围
+- [ ] 总字数进入锁定的用户范围；作者没给时进入 `设定.md` 的目标字数（构思时按所选平台的投稿区间定，未定平台用 8000-12000，见 submission-craft.md）
 - [ ] 每节完成其批准情节点或状态变化；没有为拉齐长度补冲突、对话、回忆或旁人反应
 - [ ] 节数 = 小节大纲规划节数（不得合并/省略）
 - [ ] 身体细节按叙事功能判断，不设次数上限；不对“手、眼、心”等单字计数改稿
@@ -124,7 +124,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 **流水线：** 短篇
 **位置：** 写作（第 3/3 步）
 
-有参考小说想对标 → `/story-short-analyze`（存入 `拆文库/{书名}/`）；写完去 AI 味 → `/story-deslop`；想自检 → Phase 4 流程 + `references/short-prose-quality.md`；要市场方向 → `/story-short-scan`；设定太大适合长篇 → `/story-long-write`。
+有参考小说想对标 → `/story-short-analyze`（存入 `拆文库/{书名}/`）；写完去 AI 味 → `/story-deslop`；想自检 → Phase 4 流程；要市场方向 → `/story-short-scan`；设定太大适合长篇 → `/story-long-write`。
 
 ---
 

package/lib/oh-story/skills/story-short-write/references/agent-calls.md

@@ -4,10 +4,10 @@
 
 ## 写正文
 
-spawn `Agent(subagent_type: "narrative-writer", prompt: ...)`，只传项目目录、输出文件、目标情绪、题材风格包、小节大纲、角色、主/副对标召回摘要、本书文风全文路径与 style_resolution、作者偏好 query 输出的 lines、格式硬约束和写作硬约束，并传入检查分工：本批只做内容覆盖与格式自检，完整语义去味由 Phase 4 负责，最终文件扫描由主会话负责。
+spawn `Agent(subagent_type: "narrative-writer", prompt: ...)`，只传项目目录、输出文件、目标情绪、题材包要点、小节大纲、角色、主/副对标召回摘要、本书文风全文路径与 style_resolution、作者偏好 query 输出的 lines、格式硬约束和写作硬约束，并传入检查分工：本批只做内容覆盖与格式自检，完整语义去味由 Phase 4 负责，最终文件扫描由主会话负责。
 
-写手按 `short-format.md`、题材包、`short-craft.md` 与 `scene-craft.md` 执行，无需将 skill 全文复制进 prompt。主会话收到结果后，按 workflow-draft.md 的格式规范重排，再写入 `正文.md`。
+写手读不到本 skill 的 references，主会话把要点摘进 prompt。题材包要点取 `设定.md`「题材招式」及题材包的腔调、开篇收尾招式、情绪烈度；写作硬约束取 `short-craft.md` 第 2、8 节与 `scene-craft.md` 要点，人称腔调与叙述姿态按题材包；格式硬约束取 `设定.md`「平台基调」与 `short-format.md`。主会话收到结果后，按 workflow-draft.md 的格式规范重排，再写入 `正文.md`。
 
 ## 精修去味
 
-spawn `Agent(subagent_type: "narrative-writer", prompt: "项目目录：{dir}\n任务描述：去AI味+格式检查\n检查分工：你负责本次精修清单与检测命中的定点语义修复；最终文件扫描由主会话执行\n检查范围：{正文文件与待修位置、问题类别}\n所选 Gate：{按命中类别选，类别不明写 A-G；仍只处理本次精修问题}\nstyle_resolution：{与写作一致的文风裁决，含全文路径}\n作者偏好：{query 输出的 lines}\n篇幅：短篇\n卖点保留：第一人称审判、火葬场预告、心死余韵按具体功能保留；压掉空泛与重复，不强制补反应\n执行边界：按读取表与 deslop-gates 的范围协议修复；不扩大为完整故事重写；需新增动机、证据、事件或改变选择、结果、揭露时机的给出具体设计建议，已授权的执行\n验收：复读完整场景及小节承接，说明原文问题、修改动作与保留理由；不用固定删减率，字数不足如实交回")`
+spawn `Agent(subagent_type: "narrative-writer", prompt: "项目目录：{dir}\n任务描述：审查+去AI味\n检查分工：你负责本次精修清单与检测命中的定点语义修复及格式检查；最终文件扫描由主会话执行\n检查范围：{正文文件与待修位置、问题类别}\n检测类别：{照录命中类别，对应关系见 deslop-gates.md「按检测类别或问题限定范围」；类别不明写全部表达与用笔项，仍只处理本次精修问题}\nstyle_resolution：{与写作一致的文风裁决，含全文路径}\n作者偏好：{query 输出的 lines}\n篇幅：短篇\n卖点保留：第一人称审判、火葬场预告、心死余韵按具体功能保留；压掉空泛与重复，不强制补反应\n执行边界：按 deslop-gates.md 的范围与权限修复；不扩大为完整故事重写；需新增动机、证据、事件或改变选择、结果、揭露时机的给出具体设计建议，已授权的执行\n验收：复读完整场景及小节承接，说明原文问题、修改动作与保留理由；不用固定删减率，字数不足如实交回")`