@oh-story/dsh 0.1.15 → 0.1.17

package/lib/oh-story/skills/story-long-scan/references/platform-jjwxc.md

@@ -1,28 +1,40 @@
 # 晋江：采集与分析
 
-作者选了晋江才读本文。需先用 `/browser-cdp` 启动 Chrome。脚本两步走：① 列表页 `topten.php` 取频道分组与书名/作者，从书名链接取 `novelid`（排除「X 向《书名》投了 Y」霸王票记录）；② 进 `onebook.php?novelid=` 详情页补采核心指标。晋江是 gb18030 编码，脚本已按此解码；详情指标公开，无需登录。
+先用 `/browser-cdp` 启动 Chrome。脚本只采全站榜；榜单按频道分组（言情、纯爱、衍生等），聚合时频道视为题材。
 
-## 榜单与命令
-
-URL `jjwxc.net/topten.php?orderstr={榜单ID}&t={频道ID}`（t=0 全站）。orderstr：收入金榜 12 / 月榜 7 / 季度榜 8 / 完结金榜 14 / 新手金榜 15 / 千字金榜 17。
+## 默认命令
 
 ```bash
-node scripts/jjwxc-rank-scraper.js --type 12 --outdir {输出目录}        # 列表+详情（默认每频道前 10，详情上限 100）
-node scripts/jjwxc-rank-scraper.js --type 12 --top 15 --detail-limit 60  # 调整每频道本数/详情总量
-node scripts/jjwxc-rank-scraper.js --type 12 --list-only                 # 只采列表（快，无核心指标）
+node scripts/jjwxc-rank-scraper.js --type 12 --outdir {outdir}   # 收入金榜
+node scripts/jjwxc-rank-scraper.js --type 7 --outdir {outdir}    # 月榜
 ```
 
-默认组合：收入金榜 + 月榜。
+作者要看新书里在冒头的，再加新手金榜：`--type 15`。
+
+## 可选参数
+
+- `--type`：收入金榜 12 / 月榜 7 / 季度榜 8 / 完结金榜 14 / 新手金榜 15 / 千字金榜 17 / all 全部。
+- 列表全保留，每频道前 10 本补详情、总共最多 100 本：`--top N` 改每频道补详情的本数，`--detail-limit N` 改总量。
+- `--list-only` 只采书目，快，但没有收藏等核心指标，只能看书目、不能做指标分析。
+
+## 字段与热度口径
 
-## 字段与硬性要求
+频道、排名、书名、作者、收藏数（核心指标，聚合的热度口径）、营养液、积分、字数、状态、作品页链接。本数含全列表，热度只含补了详情的书；覆盖量见文件头「详情采集」。
 
-频道（聚合时当题材）、排名、书名、作者、novelid、收藏数（核心，聚合的热度口径）、营养液、积分、字数、状态、作品页链接。必须有详情页核心指标（收藏、营养液或积分、字数）：用了 `--list-only` 或文件头标 `[仅列表-无核心指标]` 的数据撑不起下面的分析，视为不合格，要重采。
+## 采不到时
+
+- 聚合「采集情况」说详情大多没取到、可能没登录：在 Chrome 里登录晋江，再重采。
+- 说部分详情没取到：结论只用有收藏数的书，报告里说明覆盖了多少本。
 
 ## 分析维度
 
 | 维度 | 看什么 |
 |---|---|
-| 金榜 | 综合热度最高 |
+| 收入金榜、月榜 | 上榜作品构成，不把名次还原为收入 |
 | 季度榜 | 中期趋势 |
-| 红字/黑字 | 积分与负面评价 |
-| 收藏/营养液 | 女频市场的核心指标 |
+| 新手金榜 | 新人新书的题材信号 |
+| 收藏、营养液 | 女频市场的核心指标 |
+
+## 本平台读者
+
+女频、言情、纯爱、衍生为主。读者要情感细腻、人设立得住，开头可以慢，但人设必须先立住；爽点偏虐后的甜、反转打脸、身份翻盘；雷区是女主傻白甜、男主渣且不追妻、三观不正。文案要给读者安全感。

package/lib/oh-story/skills/story-long-scan/references/platform-qidian.md

@@ -1,45 +1,59 @@
 # 起点：采集与分析
 
-作者选了起点才读本文。默认不需要 Chrome：脚本先读 `https://m.qidian.com` 移动端 SSR pageContext，移动端不可用时才回退 CDP/PC 页面，文件头 `抓取方式` 标 `mobile-ssr` 或 `cdp-pc`。书库新书除外：只能走 Chrome，先 `/browser-cdp`，开之前告诉作者。
+排行榜默认读手机版页面，不需要 Chrome；读不到才用 Chrome 打开电脑版。书库新书只能用 Chrome，先说明并用 `/browser-cdp` 启动。脚本采的是起点主站，以男频为主；若要看起点女频，说明脚本采不到，请作者贴起点女频的榜单（见 SKILL「作者提供」）。
 
-## 榜单与命令
+## 默认命令
 
-`node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录}`（`--type all` 全采；`--mode mobile|cdp` 强制一种方式；`--detail yes` 进详情页补标签、简介、最新更新）
+```bash
+node scripts/qidian-rank-scraper.js --type newsign --outdir {outdir}    # 新人签约新书榜
+node scripts/qidian-rank-scraper.js --type yuepiao --outdir {outdir}    # 月票榜
+node scripts/qidian-rank-scraper.js --type hotsales --outdir {outdir}   # 畅销榜
+```
 
-| 榜单 | --type | URL | 看什么 |
-|------|--------|-----|--------|
-| 新人签约新书榜 | newsign | qidian.com/rank/newsign/ | 新人签约作品，新风向 |
-| 签约作者新书榜 | signnewbook | qidian.com/rank/signnewbook/ | 已签约作者新作风向 |
-| 公众作者新书榜 | pubnewbook | qidian.com/rank/pubnewbook/ | 发现潜力作者 |
-| 新人作者新书榜 | newauthor | qidian.com/rank/newauthor/ | 新人赛道 |
-| 三江推荐 | sanjiang | qidian.com/sanjiang/ | 编辑精选，按周分组（非 /rank/ 路径） |
-| 月票榜 | yuepiao | qidian.com/rank/yuepiao/ | 付费认可度最高 |
-| 畅销榜 | hotsales | qidian.com/rank/hotsales/ | 真金白银投票 |
-| 阅读指数榜 | readindex | qidian.com/rank/readindex/ | 阅读量综合 |
-| 收藏榜 | collect | qidian.com/rank/collect/ | 读者关注热度 |
-| 原创推荐榜 | recom | qidian.com/rank/recom/ | 平台推荐 |
+作者要看新书里在冒头的，再加书库新书：
 
-默认组合：新人签约新书榜 + 签约作者新书榜 + 月票榜 + 畅销榜。文件名 `起点{榜单}_{YYYYMMDD}.md`。
+```bash
+node scripts/qidian-rank-scraper.js --type library --pages 3 --outdir {outdir}   # 默认 3 页，最多 10
+```
 
-### 书库新书
+书库新书是「男生、连载、30 万字以下、三日内更新」按人气排的前几页，名次即人气排名，会拉低字数中位。跟作者说「起点最近三天还在更新的 30 万字以内新书，按人气取前 3 页，要开浏览器」。
 
-作者说「新书」「最近冒头」「什么在起量」时再加，不进默认组合（要开 Chrome）。全部作品筛选页 qidian.com/all/action0-size1-update1/：男生、连载、30 万字以下、三日内更新，按人气排，每页 20 本。能补上已下新书榜、还在更新的新书。
+## 可选榜单
 
-```bash
-node scripts/qidian-rank-scraper.js --type library --pages 3 --outdir {输出目录}   # 默认 3 页，最多 10，不进 --type all
-```
+`--type` 换成下表的值；`all` 采全部排行榜（不含书库新书）。`--mode mobile|cdp` 强制读手机版或电脑版。
 
-所有页写进一份 `起点男频书库人气新书_{YYYYMMDD}.md`，名次接着排，就是人气排名；只收 30 万字以下，会拉低字数中位。字数从加密字体解出；签约、收费从移动端作品页补，补不到写 `[待补]`；总推荐单列为「新书总推荐」，不进热度口径。跟作者说「起点最近三天还在更新的 30 万字以内新书，按人气取前 3 页，要开浏览器」。
+| 榜单 | --type | 看什么 |
+|------|--------|--------|
+| 新人签约新书榜 | newsign | 新人签约作品，新风向 |
+| 签约作者新书榜 | signnewbook | 已签约作者的新作 |
+| 公众作者新书榜 | pubnewbook | 潜力作者 |
+| 新人作者新书榜 | newauthor | 新人赛道 |
+| 三江推荐 | sanjiang | 编辑精选，平台力推方向 |
+| 月票榜 | yuepiao | 付费认可度 |
+| 畅销榜 | hotsales | 订阅表现 |
+| 阅读指数榜 | readindex | 阅读量综合 |
+| 收藏榜 | collect | 手机版没有，取书友榜代替 |
+| 原创推荐榜 | recom | 推荐票表现 |
 
-## 字段
+手机版的两个签约榜是同一页，`newsign` 和 `signnewbook` 只采一个；都采了，聚合会按一份计。以文件头「移动端实际榜单」为准。
 
-排名、书名、作者、题材（主类·子类；聚合时主类作题材、子类进标签）、状态、签约、收费模式、字数、总推荐（聚合的热度口径）、标签/最新更新/简介（详情页）、作品页链接。额外必填：题材、字数、总推荐，缺的写 `[待补]`。
+## 字段与热度口径
+
+排名、书名、作者、题材（主类·子类）、状态、签约、收费模式、字数、总推荐、标签、简介、作品页链接；缺项写 `[待补]`。聚合按主类分题材、子类进标签，热度口径是总推荐。书库新书的总推荐另列为「新书总推荐」，不和老书混算。
+
+## 采不到时
+
+- 手机版读取失败后改用 Chrome，若遇到验证码：脚本会停下等你在 Chrome 窗口里手动完成验证，最长 120 秒。告诉作者去 Chrome 里点验证。
+- 文件头「数据质量」标了问题：看「问题摘要」。题材、字数大面积缺失多半是手机版页面改版，先 `/browser-cdp` 启动 Chrome，再加 `--mode cdp` 重采一次。
 
 ## 分析维度
 
 | 维度 | 看什么 |
 |---|---|
-| 月票榜/畅销榜 | 付费认可与持续追读，最硬的指标 |
-| 各新书榜 | 新作者、新题材的早期信号；和月票/畅销榜的题材占比对照 |
+| 月票榜/畅销榜 | 付费榜表现，不等于订阅或追读原数；头部多是连载多年的大神老书 |
+| 新书榜、书库新书 | 新作者、新题材的早期信号；和月票、畅销榜的题材占比对照 |
 | 三江推荐 | 平台力推方向 |
-| 追读率 | 决定推荐位分配（榜单上看不到，只能从月票/畅销间接推断） |
+
+## 本平台读者
+
+付费订阅、男频为主，读者要升级、成长和长线追读，爽点偏实力碾压、智谋取胜、机缘兑现；雷区是长期憋屈、主角被动又不反击。

package/lib/oh-story/skills/story-long-scan/references/platform-qimao.md

@@ -1,37 +1,47 @@
 # 七猫：采集与分析
 
-作者选了七猫才读本文。排行榜需先用 `/browser-cdp` 启动 Chrome；页面无明显反爬，脚本滚动加载，男生榜/女生榜 tab 切换（失败重试）。下面的书库新书不用 Chrome。
+排行榜先用 `/browser-cdp` 启动 Chrome；书库新书直接请求网页，不用 Chrome。
 
-## 榜单与命令
+## 默认命令
 
-入口 qimao.com/paihang：大热榜（日榜/月榜）、新书榜、完结榜、收藏榜、更新榜。
+`--channel` 按 Phase 1 的频道取：male=男频、female=女频、all=男女都采。
 
 ```bash
-node scripts/qimao-rank-scraper.js --channel male --type hot --period day --outdir {输出目录}   # 男生大热榜日榜
-node scripts/qimao-rank-scraper.js --channel all --type all --outdir {输出目录}                 # 全部
+node scripts/qimao-rank-scraper.js --channel all --type hot --period day --outdir {outdir}   # 男女频大热榜日榜
 ```
 
-大热榜用 `--period day|month|all` 选日榜、月榜或两者（默认 day），周期进文件头与文件名；其他榜不分周期。默认组合：男频大热榜日榜 + 女频大热榜日榜。
-
-### 书库新书
-
-作者说「新书」「最近冒头」「什么在起量」时再加，不进默认组合。书库筛选页 qimao.com/shuku/a-a-a-1-1-a-0-click-{页码}/：全部频道、30 万字以下、3 天内更新、连载中，按点击量排，每页 15 本。
+作者要看新书里在冒头的，再加新书榜和书库新书：
 
 ```bash
-node scripts/qimao-rank-scraper.js --source library --pages 3 --outdir {输出目录}   # 前 3 页（默认 3，最多 10）
+node scripts/qimao-rank-scraper.js --channel all --type new --outdir {outdir}    # 男女频新书榜
+node scripts/qimao-rank-scraper.js --source library --pages 3 --outdir {outdir}  # 书库新书，前 3 页（最多 10）
 ```
 
-直接读网页，不用 Chrome。所有页写进一份 `七猫全站书库点击新书_{YYYYMMDD}.md`，名次接着排，就是点击排名，只收 30 万字以下，会拉低字数中位，篇幅看排行榜；书库页只给子分类，脚本按分类页补出主类，和排行榜的题材对得上。页面没有热度数字，七猫的热度只来自排行榜，这份没有热度属正常，不用重采。Chrome 起不来时可以只采这份，结论只看题材分布、字数和标签，没有热度和多榜重合。跟作者说「七猫最近三天还在更新的 30 万字以内新书，按点击取前 3 页」。
+书库新书是全部频道「30 万字以下、3 天内更新、连载中」按点击量排的前几页，每页 15 本，名次即点击排名，没有热度数字，会拉低字数中位；只看题材、字数和标签。跟作者说「七猫最近三天还在更新的 30 万字以内新书，按点击取前 3 页」。
+
+## 可选参数
+
+- `--type`：hot 大热榜 / new 新书榜 / finish 完结榜 / collect 收藏榜 / update 更新榜 / all 全部。
+- 大热榜用 `--period day|month|all` 选日榜、月榜或两者，默认日榜；其他榜不分周期。
 
-## 字段
+## 字段与热度口径
 
-排名、书名、作者、题材、分类标签（聚合时进标签）、状态、字数（万字）、热度（核心指标，聚合的热度口径；书库新书没有）、最新更新、作品页链接、简介。文件头带 `数据质量`、`有效条目`、`问题摘要`、链接与热度命中数；热度缺失写 `[待补]`。
+排名、书名、作者、题材、分类标签（聚合时进标签）、状态、字数、热度（核心指标，聚合的热度口径；书库新书没有）、最新更新、作品页链接、简介。书库从分类页补主类，补不到时改用子类；聚合出现很细的题材名时先核对来源。
+
+## 采不到时
+
+- 终端提示「页面实际榜单与请求不一致，已跳过」：页面没切到要的频道或榜单。在 Chrome 里手动点一次对应的男生榜/女生榜和榜单标签，再重采这一条。
+- 文件头「数据质量」标了问题：看「问题摘要」，缺热度或链接的条目多时，结论只用有热度的书。
 
 ## 分析维度
 
 | 维度 | 看什么 |
 |---|---|
 | 大热榜 | 热度排名，流量集中度 |
-| 新书榜 | 新流量风口 |
+| 新书榜、书库新书 | 流量风口候选，与大热榜及可比上期对照 |
 | 完结榜 | 长尾价值作品 |
-| 热度 | 七猫核心指标，读者活跃度 |
+| 热度 | 平台公开指标，按同周期比较，不换算为读者人数 |
+
+## 本平台读者
+
+免费阅读，读者面广，要快节奏、强剧情、不拖沓；雷区是文艺腔、节奏慢、不爽。男频偏逆袭、打脸；女频偏强情绪、甜虐推拉。编辑收稿偏好（旧资料，以本次榜单为准）：追妻火葬场、年代甜宠、多男主修罗场。

package/lib/oh-story/skills/story-long-scan/references/topic-decision.md

@@ -1,18 +1,6 @@
 # 选题决策：从扫榜数据到"写什么能爆"
 
-把扫榜结果变成能直接用的选题建议：**推荐写什么、为什么能爆、行不行、怎么验证**。
-Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿："能爆的原因"先当假设，拆文（story-long-analyze）后回填验证，写作（story-long-write）开书时直接用。
-
----
-
-## 决策路由
-
-| 你在做什么 | 看这节 |
-|-----------|--------|
-| 把扫榜结果变成选题建议 | 选题四步 |
-| 判断一个方向行不行 | 可行性判断 |
-| 没联网/没榜单数据 | 内置知识模式 |
-| 落盘交付 | 选题决策.md 模板 + 交付 |
+Phase 5 补上「推荐选题」，产出 `选题决策.md`：**推荐写什么、为什么可能爆、作者能否驾驭、如何验证**。文件头和「扫榜结论」在 Phase 4 已写好。"能爆的原因"先记为假设，交给 story-long-analyze 拆文验证，再供 story-long-write 开书使用。
 
 ---
 
@@ -20,63 +8,72 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 
 每个推荐选题都走完这四步，缺一不可：
 
-1. **能爆的原因（先当假设）**：从榜上**重复出现的样本**（排除单本个例）+ 新元素提取，推出"这个方向能爆，依靠 X 结构/梗/人设吃这波读者"。单本上榜只是个例（扫榜原则 1：多本重复才算信号）。这里只写假设，标 `待拆文验证`；要坐实得靠拆文回填。
-2. **市场验证**：榜上同方向有几本 + 趋势（↑/→/↓）+ 反例（同方向有没有扑街/烂尾的）。样本越多、趋势越稳，越可信。
+1. **能爆的原因（先当假设）**：从榜上重复样本与新元素推测，哪种结构、梗或人设吸引了目标读者；标 `待拆文验证`，由拆文回填依据。同时挑 1-2 本对标书让作者拆：优先选新书榜、书库新书中字数不多的同方向书，头部老书只作参照。
+2. **市场验证**：记录同方向本数、热度和可比上期的趋势。榜单没有扑街样本，反例只认作者或编辑给的、有来源的；没有就写未核实，无可比上期就写现状。
 3. **差异化定位**：作者优势 × 市场缺口 = "你的版本和榜上现有的不同在哪"。没有差异化 = 同质化挤不进去。
-4. **可行性 + 风险 + 验证动作**：给出可行性高/中/低（下节规则）、最可能的失败点、开写前怎么低成本验证（通常："先写黄金三章测追读，不行就换"）。
+4. **可行性 + 风险 + 验证动作**：按下节给出高/中/低、最可能的失败点、开写前怎么低成本验证（通常是先写黄金三章，发出去看追读，不行就换）。
 
 ---
 
 ## 可行性判断
 
-分三档；样本不够时不许给"高"，别让几条数据撑出假信心：
+同方向样本按本平台去重作品计；细分梗只数带这个梗的书，不继承主类本数，也不把抽样命中条数当本数。
 
-| 可行性 | 含义 | 条件 |
-|--------|------|------|
-| 高 | 可放心写 | 同方向榜上样本够（≥15，小平台≥10）+ 趋势↑或→ + 作者素材能撑 + 有差异化空间 |
-| 中 | 可写但先验证 | 样本够但趋势↓ / 或差异化不清 / 或作者素材半撑 |
-| 低 | 不建议 | 同方向已饱和（扑街反例多）/ 或作者素材撑不住 / 或平台调性不符 |
+| 可行性 | 条件 |
+|--------|------|
+| 高 | 同方向样本够（≥15 本，刺猬猫≥10）+ 和上期比在涨或持平 + 作者素材能撑 + 有差异化空间 |
+| 中 | 可写但先验证：样本不足、在跌、没有上期可比、差异化不清，或素材只能撑部分情节 |
+| 低 | 不建议：作者素材撑不住、平台调性不符，或有来源的反例显示同方向已挤满 |
 
-**硬规则**：某方向背靠的榜单若标了 `[数据稀疏]`（有效条目 < 15，小平台 < 10，即扫榜采集质量检查标的稀疏阈值），该方向**不许给"高"**，强制降到"中" + 写明"样本不足，先扫够样本或试水再定"。
+**最高给"中"**：榜单标 `[数据稀疏]`、聚合标「少」、同方向不足 15 本（刺猬猫不足 10 本）、首次扫榜无上期可比、或内置知识模式，都最高给"中"，写明先补样本或小成本试水。素材撑不住、平台不符仍给"低"。
 
-**内置知识模式**：无榜单、纯凭知识库趋势时，**所有方向一律给"中"**，理由写"基于通用认知，无榜单验证，开写前必须先扫榜或小成本试水"。不许给"高"。
+**番茄**：每个题材按上限等额采样，题材本数总是接近上限，不能当"样本够"。番茄的同方向样本要按细分梗或标签统计本数；题材冷热看热度中位和平台 P75，并看它在新书榜、书库新书里有没有书。
+
+---
+
+## 平台适配与目标读者
+
+- 先匹配题材与平台读者，再比较流量；平台大不等于项目更容易成。平台的读者与调性见所选平台参考的「本平台读者」。
+- 合同、保底、分成、全勤等收益问题，以平台最新官方规则或编辑说法为准，这里不判断。
+- 「目标读者」只写榜单能推断的内容：频道（男频/女频）；读者对这类套路的熟悉程度，新梗多解释，老梗直接上爽点；年龄段偏向须有标签、简介证据。
 
 ---
 
 ## 选题决策.md 模板
 
-```
+```md
 # 选题决策：{平台/方向}
-- 扫榜日期：{YYYYMMDD}     # 数据新鲜度；写作读取时若过期会提示复扫
+- 扫榜日期：{YYYYMMDD}
 - 数据来源：{榜单文件名 / 内置知识}
-- 聚合表：扫榜聚合.md     # 同目录；内置知识模式写「无」
+- 聚合表：{扫榜聚合.md，内置知识模式写「无」}
 
 ## 扫榜结论：{平台名称}
-{Phase 4 报告正文，Phase 4 写入；Phase 5 只读不改}
+{Phase 4 写入的报告正文；Phase 5 只读不改}
 
 ## 推荐选题
 
 ### 选题 1：{一句话方向}
 - 题材组合：{主类型 + 副类型/梗}
-- 目标读者：{画像}
+- 目标读者：{频道 + 熟不熟这类套路}
 - 核心卖点：{读者为什么追}
 - 能爆的原因：{X 结构/梗为什么吃这波}（假设，`待拆文验证`）
 - 差异化定位：{和榜上现有的不同在哪}
-- 可行性：高/中/低 — {理由，写清同方向几本 + 趋势}
+- 可行性：高/中/低 — {理由，写清同方向几本 + 趋势；被上限压到「中」的写明原因，如「中（没有上期可比）」}
 - 失败风险：{最可能崩在哪}
 - 验证动作：{开写前怎么低成本验证}
+- 建议拆的对标书：{《书名》（平台，选它的理由）}
 - 篇幅/平台：{建议字数区间 + 目标平台}
 
 ### 选题 2 ...
 ### 选题 3 ...
 ```
 
-2-3 个选题为宜，按可行性排序（高的在前）。
+2-3 个选题为宜，按可行性排序（高的在前）；同级时同方向新书样本多的在前，再比作者素材贴不贴，并在选题 1 的可行性理由里说一句它为什么排第一。
 
 ---
 
 ## 交付
 
-1. 写到本次扫榜的输出目录 `扫榜/{YYYYMMDD}/`（和榜单、`扫榜聚合.md` 同目录）：`{outdir}/选题决策.md`。Phase 4 先写文件头和「扫榜结论」，Phase 5 再写「推荐选题」；重跑时整节替换，不追加第二份。扫榜常在还没有小说项目的目录下跑，所以产物落在这里，不直接写进项目。
-2. 告知用户路径，并说明下一步：「开书时如果小说项目就建在扫榜时所在的文件夹里、或和它同级，`/story-long-write` 会自动找到并让你确认；隔得更远就把 `选题决策.md` 复制到小说项目根目录，或开书时把路径粘给它。想确认"能爆的原因"就先 `/story-long-analyze` 拆对标书，拆完会回填。」
-3. 后续衔接（本文件不执行，仅说明）：拆文在汇总报告产出后回填对应选题的"能爆的原因"；写作 Phase 1 读取 `选题决策.md` 作为开书起点。
+1. 写入本次扫榜目录 `扫榜/{YYYYMMDD}/` 的 `选题决策.md`，与榜单、`扫榜聚合.md` 同目录。重跑只替换对应整节。
+2. 告诉作者路径和下一步：「开书时如果小说项目就建在扫榜时所在的文件夹里、或和它同级，`/story-long-write` 会自动找到并让你确认；隔得更远就把 `选题决策.md` 复制到小说项目根目录，或开书时把路径粘给它。想先确认"能爆的原因"，就准备好对标书的原文（txt），用 `/story-long-analyze` 拆，拆完会回填。」
+3. 拆文报告落盘后，拆文时只回填题材匹配且仍标 `待拆文验证` 的选题；写作时在作者没给方向时读 `选题决策.md` 作为开书候选。

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

@@ -15,7 +15,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 必须分块读到 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 替代。
+2. 主会话直接写正文时，首次落笔前完整读取 `references/long-format.md` 与 `references/writing-craft.md`，与写手用同一套技法；`references/long-chapter-quality.md` 只在排查具体问题时读，去味走检测器，不预读。交给 narrative-writer 时，由该 agent 按自己的 reference 表完成写前读取，主会话不得用未读 reference 的临时 prompt 替代。
 3. 本章技法按下方「本章技法」一段选，至多一份；主会话自己写时按那段只读指定小节，这是本条唯一允许的按节读。
 4. 正文写前，references 读完后立即重读当前用户请求、本章细纲和卷纲，先在上下文里**记下本轮约束**：原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法，不得覆盖这些项目事实；作者给的字数范围写在细纲「字数范围」行（命令参数只作临时覆盖），有它就不用默认 ±15%。交付前逐项复核：字数带外按 `workflow-chapter.md` 的收口流程交用户处置，不自动补字；其余项越界不算完成。
 
@@ -23,23 +23,27 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ---
 
-> 内置适配 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 执行。
+> 内置适配 Claude Code / OpenCode / Codex / Antigravity / ZCode / OpenClaw / Reasonix。专业 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` 同样只进技术备注行。
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 36` 不一致时（标记缺失、字段缺失/非整数、小于或大于 36）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时用一句白话提示作者「写作助手是旧版，运行 /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；同一裁决交给后续执行者。
 
+## 作者记忆管理
+
+管理习惯读 `references/author-memory.md`（整理、超编、迁移按其中指路）。仅管理习惯时完成即停，不建书、不写正文。
+
 ## 核心方法
 
-先抓情绪，再用验证过的模式可靠交付，灵感只做素材：每个场景服务一个说得清的目标情绪；从对标里找验证过的剧情模式，把对标角色当功能位，用本书的角色和素材填；写每章只读「不知道就会写错」的状态、伏笔与设定。契约与推进决策先过 `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；无记忆返回空），执行者只拿输出的 `lines`，当前请求与本书文风优先；作者说出要长期记住的偏好时才读 [references/author-memory.md](references/author-memory.md) 按它 `record` 写入、回传回执。
+先明确每个场景的主导情绪，从对标中找有依据的剧情模式，把角色当功能位，用本书的角色和素材实现；写每章只读「不知道就会写错」的状态、伏笔与设定。契约与推进决策先过 `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；无记忆返回空），执行者只拿输出的 `lines`，当前请求与本书文风优先。
 
-**本章技法（每章至多读一份）**：按细纲主功能选——打脸/逆袭（爽感释放）`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` 找细分方向。
+**本章技法（每章至多读一份）**：按细纲主功能选——打脸/逆袭（爽感释放）`style-combat-face.md`；身份/认知/立场反转（震撼+痛快）`long-reversal.md`；感情拉扯（意难平）`emotional-methods.md`，自己写时加 `emotion-on-page.md`；悬疑/惊悚/异常线索（紧张+好奇）`long-suspense.md`；日常装逼（期待感）`long-chapter-hooks.md`。都不对应就不读，按 writing-craft 写。第 1-3 章另读 `opening-design.md`「开篇落笔」。交给写手时只在 prompt「本章技法」填类别，由写手整份读；主会话自己写正文时只读该文件的「决策路由」和它指向的那一节（先看标题定位，不整读），日更一批只读一份，按本批最需要的那章选，其余章按 writing-craft 写。作者先说情绪没说题材时按括号反查，再从 `long-genre-catalog.md` 找细分方向。
 
 ---
 
 ## 写作流程
 
-先确定操作对象、交付范围和停点，再看项目状态；空项目不等于授权完整开书。范围与转正文的权威规则如下。
+先确定操作对象、交付范围和停点，再看项目状态；空项目不等于授权完整开书。范围与转正文规则如下。
 
 | 场景 | 触发条件 | 执行流程 |
 |------|----------|----------|
@@ -54,7 +58,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 **对象优先**："写/修改第N章细纲"是规划，不因命中"写/修改第N章"而写正文；"以后再写正文"不是本轮授权。仅规划要求优先于旧日更任务，停止旧批量。对象不明或同一请求范围冲突时，只确认冲突项。
 
-**规划续接**："继续/按这个来/确认方案"不扩大范围，完成即停，不自动转细纲或正文；"继续写/接着写"指正文——下一章有细纲就写，上一轮在规划就只问一句「要接着写第N章正文吗？」（默认是），缺细纲则问是否先补。规划模式不写入追踪或作者记忆，不调用 narrative-writer。开新卷时新角色/势力/设定回 Phase 2 增量补，Phase 3 只做到请求层级。
+**规划续接**："继续/按这个来/确认方案"不扩大范围，完成即停，不自动转细纲或正文；"继续写/接着写"指正文——下一章有细纲就写，上一轮在规划就只问一句「要接着写第N章正文吗？」（默认是），缺细纲则问是否先补。规划模式不写追踪、不自动记录作者记忆，不调用 narrative-writer；作者明确要求长期记住时按记忆协议处理。开新卷时新角色/势力/设定回 Phase 2 增量补，Phase 3 只做到请求层级。
 
 **转入正文**：明确的正文请求只授权进入写作流程。落正文前重新完成本轮「写前必读」，按 workflow-chapter 处理缺 state、使 `tracking_commit.py check` 通过，任一未完成就停止；之后按原流程写作、质检、提交，不再问是否继续。
 
@@ -122,15 +126,10 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | 写完，去 AI 味 | story-deslop | `/story-deslop` |
 | 想对比参考书 | story-long-analyze | `/story-long-analyze` |
 | 需要市场方向 | story-long-scan | `/story-long-scan` |
-| 太长，适合短篇 | story-short-write | `/story-short-write` |
+| 想改写成短篇 | story-short-write | `/story-short-write` |
 
 ---
 
 ## 参考资料索引
 
 阶段必读项按首屏「写前必读」执行；写正文不按索引加读；规划或作者点名问技法时按 [参考索引](references/reference-index.md) 的加载条件选用。
-
-## 语言
-
-- 跟随用户的语言回复，用户用什么语言就用什么语言回复
-- 中文回复遵循《中文文案排版指北》

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

@@ -1,6 +1,6 @@
 # agent-calls.md：spawn 子代理的调用方式
 
-只在要 spawn 对应 agent 时读；主会话自己写正文、自己排纲时不读。何时调用由各流程文件决定，这里只放 prompt 与必须附带的内容。Antigravity 用 `invoke_subagent` + 同名 `TypeName`。
+只在要 spawn 对应 agent 时读；主会话自己写正文、自己排纲时不读。调用时机见各流程；下列 prompt 列明必传内容。Antigravity 用 `invoke_subagent` + 同名 `TypeName`。
 
 ## narrative-writer：写一章
 
@@ -28,7 +28,7 @@ Prompt：`项目目录：{dir}\n检查范围：{本次写作的章节}\n检查
 
 ## narrative-writer：审查+去AI味
 
-Prompt：`项目目录：{dir}\n任务描述：审查+去AI味\n检查分工：你负责语义去味及原定自检；最终文件扫描由主会话执行\n检查范围：{本次写作的章节}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{本章 query 输出的 lines，无写「无」}\n触发本次审查的检测结果：{chapter check 里 blocking 与语义类 advisory 的行号和类别，原样粘贴}\n所选 Gate：{按检测类别选，如 B 句式、G 解释腔；类别不明写 A-G}\n删除优先：每条 AI 味项先判能否删除，删后不丢伏笔/钩子/角色/情节/必要信息的直接删，会丢才润色\n按你的 7 Gate 与对话自检执行，台词里的工整否定不因脚本豁免而跳过\n删除测试：按 deslop-gates.md「写法抽查」执行，报告列候选数/删改数/保留理由`
+Prompt：`项目目录：{dir}\n任务描述：审查+去AI味\n检查分工：你负责本次检测触发的定点语义修复及原定自检；最终文件扫描由主会话执行\n检查范围：{本次写作的章节}\n文风路径：{设定/文风.md 全文路径}\nstyle_resolution：{与写作一致的裁决}\n作者偏好：{本章 query 输出的 lines，无写「无」}\n触发本次审查的检测结果：{chapter check 里 blocking 与语义类 advisory 的行号和类别，照录}\n执行边界：按写手资料 deslop-gates「按检测类别或问题限定范围」与三层方法修复；不扩大为完整故事诊断或新增剧情设计；原文有依据的承接与详略可改，无依据的设计缺口只报告\n验收：在完整场景中复读改动，说明原文问题、具体修法和有功能写法的保留理由，不用固定删减率`
 
 ## narrative-writer：超字一次净删（compress-once）