@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-long-scan/references/scan-output-format.md

@@ -1,207 +0,0 @@
-# 扫榜数据采集格式规范
-定义起点/番茄/七猫/晋江的采集字段、输出模板和清洗规则。
-
----
-
-## 起点
-
-### 起点采集说明
-
-榜单清单与 URL 见 SKILL.md「起点采集目标」表。
-
-优先使用 `scripts/qidian-rank-scraper.js` 的默认 `--mode auto`。脚本先读取 `https://m.qidian.com` 移动端 SSR pageContext JSON，规避 PC 站风控页；移动端不可用时才回退到 CDP/PC 页面。输出头部会标注 `抓取方式：mobile-ssr` 或 `cdp-pc`。
-
-
-### 字段
-
-排名 | 书名 | 作者 | 题材 | 状态 | 签约 | 收费模式 | 字数(万字) | 总推荐 | 标签(详情页) | 最新更新(详情页) | 作品页链接 | 简介(详情页，截断100字)
-
-### 输出模板
-
-```markdown
-# qidian · {榜单名称}
-- 来源：{榜单URL}
-- 抓取时间：{ISO 8601}
-- 条目数：{N}
-
----
-
-## #{排名} {书名}
-*{作者} · {题材} · {状态} · {签约} · {免费/VIP} · {字数}万字 · {推荐数}总推荐*
-**标签：** {标签}
-**最新更新：** {YYYY-MM-DD HH:MM:SS} · {章节标题}
-
-[作品页]({URL})
-
-**简介**
-{简介原文}
-```
-
-### 采集要点
-
-榜单页含：排名/书名/作者/题材/字数/推荐/签约/免费VIP。详情页需：标签/最新更新/简介。三江按周分组。
-
----
-
-## 番茄小说
-
-榜单 URL 格式与参数说明见 SKILL.md「番茄采集目标」表。
-
-### 题材cat_id
-
-男频19个：西方奇幻(1141) / 东方仙侠(1140) / 科幻末世(8) / 都市日常(261) / 都市修真(124) / 都市高武(1014) / 历史古代(273) / 战神赘婿(27) / 都市种田(263) / 传统玄幻(258) / 历史脑洞(272) / 悬疑脑洞(539) / 都市脑洞(262) / 玄幻脑洞(257) / 悬疑灵异(751) / 抗战谍战(504) / 游戏体育(746) / 动漫衍生(718) / 男频衍生(1016)
-
-女频18个：古风世情(1139) / 科幻末世(8) / 游戏体育(746) / 女频衍生(1015) / 玄幻言情(248) / 种田(23) / 年代(79) / 现言脑洞(267) / 宫斗宅斗(246) / 悬疑脑洞(539) / 古言脑洞(253) / 快穿(24) / 青春甜宠(749) / 星光璀璨(745) / 女频悬疑(747) / 职场婚恋(750) / 豪门总裁(748) / 民国言情(1017)
-
-### 字段
-
-排名 | 书名(需详情页解码) | 作者(需详情页解码) | 题材(详情页 categoryV2) | 状态 | 在读(核心指标) | 字数 | 标签(简介内【】) | 最新更新 | bookId | 作品页链接 | 简介(截断100字)
-
-> 番茄 SSR 详情页**没有数字评分**，故不输出评分。题材取详情页 `categoryV2`（转义 JSON 的首个 `Name`，如「西方奇幻」）；标签取简介开头的 `【tag+tag+...】`（如「种田、慢热、西幻」），是题材细分的真实信号。
-
-### 输出模板
-
-```markdown
-# 番茄 · {频道}{榜单名} · 全 {N} 题材
-- 频道参数：channel={0女频/1男频}，type={1新书榜/2阅读榜}
-- 抓取时间：{ISO 8601}
-- 标题解析：成功 {X} / 共 {Y}
-- 数据质量：[OK / 标题解析异常 / 无数据]
-- 每题材上限 ≈ {N}（cap≈20）
-
----
-
-## {题材名称} — {N} 本
-
-### #{排名} {书名}
-*{作者} · {题材} · {状态} · {在读数} 在读 · {字数}字*
-**标签：** {标签1、标签2}
-**最新更新：** {章节}
-**bookId：** {bookId}
-
-[作品页]({URL})
-
-**简介**
-{简介原文}
-```
-
-> 标题/作者/题材/标签/简介均为可选字段：详情页拿到才输出。书名解码失败时书名显示 `（标题待解析）`，但 bookId 与作品页链接始终保留，便于人工回查。
-
-### 采集要点
-
-字体反爬：列表页 innerText 被自定义字体混淆，`scripts/fanqie-rank-scraper.js` 改从详情页 HTML（内嵌 JSON `bookName`/`author`/`abstract`/`categoryV2` + `<title>` + og:meta）多策略解码明文，规避字体反爬。流程：访问品类页 → 提取品类链接 → 逐品类取 `__INITIAL_STATE__` 列表 → 分批（每 5 本）请求详情页解码。单页上限约 20 本需滚动加载；`--top N` 可调每题材上限。
-
-**故障排查（书名全是 `bookId:xxx` / `（标题待解析）`）**：
-- 看文件头 `数据质量`：标 `[标题解析异常]` 说明详情页解码失败率高。
-- 多为详情页结构变动或被登录/验证页拦截。在已登录的 Chrome 里手动打开任一 `https://fanqienovel.com/page/{bookId}` 确认页面正常、非验证页。
-- 控制台若报 `CDP 无响应`，说明 Chrome/CDP 没起来或端口不对，按 browser-cdp skill 重新启动。确认正常后重采。
-
----
-
-## 七猫
-
-### 榜单
-
-入口：qimao.com/paihang，男生榜/女生榜tab切换。类型：大热榜(日/月) / 新书榜 / 完结榜 / 收藏榜 / 更新榜
-
-### 字段
-
-排名 | 书名 | 作者 | 题材 | 分类标签 | 状态 | 字数(万字) | 热度(核心指标) | 最新更新 | 作品页链接 | 简介(截断100字)
-
-### 输出模板
-
-```markdown
-# 七猫 · {男/女}频 · {榜单名称}
-- 来源：qimao.com/paihang
-- 抓取时间：{ISO 8601}
-- 条目数：{N}
-
----
-
-### #{排名} {书名}
-*{作者} · {题材} · {分类标签} · {状态} · {字数}万字 · {热度}万热度*
-**最新更新：** {时间} · {章节}
-
-[作品页]({URL})
-
-**简介**
-{简介原文}
-```
-
-### 采集要点
-
-无明显反爬需滚动加载。男生榜/女生榜tab切换，大热榜有日/月切换。
-
----
-
-## 晋江
-
-### 榜单URL
-
-`jjwxc.net/topten.php?orderstr={榜单ID}&t={频道ID}`（t=0全站，各频道ID从页面获取）
-
-| 榜单 | orderstr |
-|------|----------|
-| 收入金榜 | 12 |
-| 月榜 | 7 |
-| 季度榜 | 8 |
-| 完结金榜 | 14 |
-| 新手金榜 | 15 |
-| 千字金榜 | 17 |
-
-### 字段
-
-频道 | 排名 | 书名 | 作者 | novelid | 收藏数(核心) | 营养液 | 积分 | 字数 | 状态 | 作品页链接
-
-### 输出模板
-
-```markdown
-# 晋江 · {榜单名}
-- 来源：{topten URL}
-- 抓取时间：{ISO 8601}
-- 频道数：{N} / 总条目数：{M}
-- 详情采集：{命中收藏数} / {计划数}（每频道前 {top}，上限 {limit}）
-- 数据质量：[OK / 详情解析异常·登录态缺失 / 仅列表-无核心指标]
-
----
-
-## {频道名} — {N} 本
-
-### #{排名} {书名}
-*{作者} · 收藏 {X} · 营养液 {Y} · 积分 {Z} · 字数 {W}字 · {状态}*
-[作品页](https://www.jjwxc.net/onebook.php?novelid={id})
-```
-
-### 采集要点
-
-两步：① 列表页 `topten.php` 取频道分组 + 书名/作者，从书名 anchor 取 `novelid`（排除"X向《书名》投了Y"霸王票记录）；② 进 `onebook.php?novelid=` 详情页补采核心指标。
-- **编码**：晋江是 gb18030，详情页必须 `fetch+arrayBuffer+TextDecoder('gb18030')` 解码（同步 XHR 的 responseText 按 UTF-8 解码会乱码）。
-- **字段来源**：详情页 `itemprop` 微数据——`collectedCount`(收藏)/`nutritionCount`(营养液)/`scoreCount`(积分)/`wordCount`(字数)/`updataStatus`(状态)。这些是公开指标，**无需登录**。
-- **控量**：列表全量保留，仅每频道前 `--top` 本（受 `--detail-limit` 总量约束）补详情，避免对全站数百本逐一请求。
-
----
-
-## 数据清洗
-
-通用：移除平台模板文本→简介超100字在句号处截断加`...`→空值标`[待补]`
-
-| 平台 | 额外必填 |
-|------|----------|
-| 起点 | 题材、字数、总推荐 |
-| 番茄 | 在读数 |
-| 七猫 | 热度 |
-| 晋江 | 收藏数、营养液(或积分)、字数 |
-
-最低采集量：主流平台15条，小平台10条。低于底线标`[数据稀疏]`。
-
----
-
-## 批量采集
-
-| 平台 | 默认组合 |
-|------|----------|
-| 起点 | 新人签约新书榜+签约作者新书榜前20+月票榜前20+畅销榜前20 |
-| 番茄 | 男频阅读榜全题材+女频阅读榜全题材 |
-| 七猫 | 男频大热榜日榜+女频大热榜日榜 |
-| 晋江 | 收入金榜+月榜 |
-| 全平台 | 起点+番茄+七猫默认组合 |

package/lib/oh-story/skills/story-long-write/references/state-tracking.md

@@ -1,108 +0,0 @@
-# 状态追踪协议
-
-> 本文件定义"本节速记"的提取逻辑和"角色状态记录"的格式。写作 skill 在写前准备的状态筛选步骤中加载此文件。
-
----
-
-## 本节速记
-
-写作每一章/每一节前，从所有已加载的上下文中筛选出只与本节相关的信息。目的是避免全量加载导致 LLM 上下文被无关信息稀释。
-
-### 筛选逻辑
-
-从上下文中提取三类信息：
-
-1. **当前状态**：本章涉及角色的最新能力、关系变化、公众形象
-2. **历史因果**：与本章事件直接相关的伏笔成因、前史事件
-3. **世界约束**：本章涉及的世界观规则（力量体系、社会规则、地理限制）
-
-### 筛选标准
-
-**只保留"如果不知道这个，本章会写错"的信息。**
-
-具体判断方法：
-- 本章细纲中提到了某个角色 → 保留该角色的当前状态
-- 本章有伏笔回收 → 保留伏笔的埋设细节和前文铺垫
-- 本章涉及特定地点/能力/规则 → 保留相关世界观约束
-- 纯背景知识（与本章事件无因果关联） → 丢弃
-
-### 输出格式
-
-筛选后输出一个简洁的"本节速记"：
-
-```
-## 本节速记（第{N}章）
-
-### 角色状态
-{角色A}：{一句话当前状态，含最近变化}
-{角色B}：{一句话当前状态}
-
-### 相关伏笔/前史
-{伏笔1}：{埋设细节，{埋设章节}}，本章需要{回收/推进}
-
-### 世界约束
-{约束1}：{与本章相关的规则/设定}
-```
-
-**示例（demo《让你管账号，你高燃混剪炸全网》第 10 章）：**
-```
-## 本节速记（第10章）
-
-### 角色状态
-江晨：火箭军文工团宣传兵，《诸君，且听龙吟》已爆红，正从军宣新人升为军内认可的创作者
-钟嘉嘉：军报记者，采访稿已经过审，与江晨从采访关系转为稳定合作
-周薄森：文工团副团长，已从担心江晨惹事转为认可其创作能力
-
-### 相关伏笔/前史
-五天百万粉任务：第1章发布，第10章仍未结算；本章只推进声量，留到第11章结算
-专业团队重拍：本章用高清专业版“缺了灵魂”反衬江晨手机原版不可替代
-
-### 世界约束
-军宣作品采用要经过组织决策；江晨可以靠作品效果赢得认可，不能跳过军内流程直接拍板
-```
-
----
-
-## 角色状态记录格式
-
-> ⚠️ **本节仅适用于长篇写作。** 短篇通常不需要独立角色状态追踪。
-
-动态状态按核心角色拆成 `追踪/角色状态/{角色名}.md`，由 `tracking_commit.py` 根据事务 JSON 整份覆盖；静态原始人设仍在 `设定/角色/{角色名}.md`。只为后续会复用的主角、反派、核心配角建快照，不为路人、一次性功能角色建文件。
-
-### 格式
-
-```markdown
-# 江晨｜当前状态
-
-- 截至章节：第10章
-- 身份：火箭军文工团宣传兵；军宣爆款创作者
-- 位置：火箭军文工团高层看片会
-- 当前目标：完成五天百万粉任务，持续做出真正能打的军宣内容
-- 身心状态：专业团队反向验证原版价值，军内认可继续抬升
-
-## 能力与资源
-- 前世 MCN 爆款运营经验
-- 《中国军魂》伴奏
-- 大师级导演能力
-
-## 关键关系
-- 钟嘉嘉持续提供军报资源
-- 周薄森和张耀祖已明确认可其创作能力
-
-## 已知信息
-- 《军报》采访稿已经过审
-- 原版视频将继续作为正式军宣内容
-
-## 未结事项
-- 五天百万粉任务尚未结算
-- 钟嘉嘉所谓“只猜对一半”仍未解释
-```
-
-### 更新规则
-
-1. 每章只记录身份、位置、目标、身心状态、能力资源、关系、已知信息、未结事项中真正发生变化的内容。
-2. 核心复用角色发生变化时，在同一事务的 `character_changes` 写变化，并在 `character_snapshots` 提交其**截至当前已写最后一章**的完整快照；工具以快照是否存在判断核心/临时角色，整份覆盖核心角色小文件，不追加历史。
-3. 修订旧章时，从修订章检查到最后已写章，按各维度和各关系对象重算当前状态，再提交完整快照；不得把最后一条单维度变化当成角色全状态。
-4. 无变化可不提交快照；核心角色重新进入当前场景时直接读取其已有小文件，并由事务工具把必要信息带入续写状态卡。
-5. 角色变化历史属于 `逐章记录/第NNN章.md`，当前快照不重复保存逐章履历。
-6. 完整 JSON 字段、4096 字节目标与 8192 字节硬上限见 [tracking-transaction.md](tracking-transaction.md)。