@oh-story/dsh 0.1.15 → 0.1.16

package/lib/oh-story/skills/story-setup/references/agent-references/genre-prose-cards//351/235/222/346/230/245/347/224/234/345/256/240.md

@@ -32,7 +32,7 @@ source: local_longform_sample_derived
 开场落到班级、宿舍、考试、社团、校门口或一条消息；冲突落到误会、竞争和青春期面子；结尾落到约定、公开围观、成绩/比赛变化或暧昧证据。
 
 ## 前中后期打法
-- 前期：用班级、宿舍、考试、社团、校门口或一条消息制造误会和青春期面子。
+- 前期：用班级、宿舍、考试、社团、校门口或一条消息制造误会，逼出青春期爱面子的反应。
 - 中期：围绕成绩/比赛、同学围观、约定落地和小吃醋推进，甜点要和具体事件绑定。
 - 后期：把公开围观、成绩变化和暧昧证据合并，结尾留下一次约定或关系被同学看见。
 
@@ -40,7 +40,7 @@ source: local_longform_sample_derived
 每章一个小压力、一个小靠近、一个未说破的余波。甜点短而准，关系变化要能被下一章继承。
 
 ## 本章取舍
-校园规则和同龄人围观不能消失。若本章重撒糖，就留一个考试、家长或同学误会压力；若重冲突，就给读者一个关系安全感回扣。
+校园规则和同龄人围观不能消失。若本章重撒糖，就留一个考试、家长或同学误会压力；若重冲突，就用一次维护或靠近，回扣关系的安全感。
 
 ## 禁止漂移
 不要只写脸红心跳；不要连续撒糖没有外部压力；不要成人化油腻；不要让校园规则消失。
@@ -48,4 +48,4 @@ source: local_longform_sample_derived
 ## 证据摘要
 样本说明：本地同题材长篇样本，可用 143 本；抽样 24 本，前/中/后章节段 24/24/24，共 72 个。
 正文参考：段落中位约 26.8 字，对话约占 24%，系统/面板提示约 8%。
-使用提醒：只作题材参考，帮你抓常见场面和前中后写法；本书设定与同题材对标仍优先。
+使用提醒：常见场面和阶段写法只作题材参考；本书设定与同题材对标优先。

package/lib/oh-story/skills/story-setup/references/agent-references/genre-prose-cards.md

@@ -1,6 +1,6 @@
 # 题材正文提示词卡索引
 
-> 本文只做**索引与召回规范**，每个题材的正文提示词已拆到同目录的 `genre-prose-cards/` 下。
+> 按题材查阅 `genre-prose-cards/` 中的单卡；正文的自动匹配入口见下方召回规则。
 
 ---
 
@@ -10,21 +10,21 @@
 
 - 通用正文要求只维护一份：严格消费细纲，按情节点义务写，缓慢推进，严禁提前写后续剧情，写完做确定性字数、钩子、禁用词、退化校验。
 - 题材卡只管题材层稳定核心：世界观/生活逻辑、读者期待、核心爽点/情绪、常见场面、常见钩子和禁止漂移。
-- 本书文风只管句长、标点、潜台词、锚点片段和笔调；它不覆盖题材卡，也不覆盖 `剧情/情绪模块.md` / `剧情/节奏.md`。
-- 三者冲突时：章节细纲与连续性 > 情绪/节奏权威召回 > 题材卡 > 本书文风 > 通用技巧。
+- 本书文风规定句长、标点、潜台词、锚点片段和笔调；题材卡补充常见场面与题材期待，`剧情/情绪模块.md` / `剧情/节奏.md` 提供情绪和节奏依据。
+- 事件、连续性与信息边界服从章节细纲和权威召回；表达维度的冲突按 `style-resolution.md` 裁决，本书明确文风优先于题材卡默认值。
 
 ## 召回规则
 
-1. 先读 `设定/题材定位.md`，确认主题材、目标平台、性向频道、主对标书和核心梗。
-2. 先查本索引匹配题材，再只读取同目录的 `genre-prose-cards/{题材}.md` 这一张卡；不要把整套题材卡全部加载进 prompt。
+1. 正文先按 单章正文工作流 取得组装报告，脚本已按「题材类型」匹配卡头的 `genre` / `aliases`。手动选题或查卡时，再读 `设定/题材定位.md`，确认主题材、目标平台、性向频道、主对标书和核心梗。
+2. 组装报告给出主辅卡路径时，只读取所列卡；无匹配时按报告指定范围读 `style-genre-modules.md`。人工查卡用本索引，不把整套题材卡全部加载进 prompt。
 3. 跨题材时，主题材读取 1 张完整卡，辅题材读取 1 张并只摘 1-2 条“常见场面/禁止漂移”；不要把两套节奏并行堆满。
 4. 高置信卡可直接用于写第 1 章前生成的 `设定/题材正文提示卡.md`；中置信卡需结合本书对标/细纲对照；低置信卡只能兜底，必须标注低置信并优先补同题材对标。
 5. 每章传给 narrative-writer 的 `genre_prose_card` 只保留本章相关条目，推荐 120-300 字；包含：题材限制、核心逻辑、读者期待、核心爽点/情绪、正文落点、前中后期打法、场景颗粒、禁止漂移、本章取舍、卡片置信度。
-6. **题材卡只在写手内部校准题材味，绝不出现在正文里**：正文不得写卡名、题材标签、置信度、条目编号或“证据摘要”数据，也不得写“已按题材卡/满足字数/零违规”一类合规自评或写作过程说明——只输出故事本身。
+6. **题材卡只在写手内部校准题材味，正文只输出故事**：不写卡名、题材标签、置信度、条目编号、“证据摘要”数据，或“已按题材卡/满足字数/零违规”等过程自评。
 
 ## 题材卡写法原则
 
-每张题材卡必须回答九件事：题材核心、主线目标、冲突发动机、爽点定位、常见情绪转化、场景颗粒、正文落点、前中后期打法和禁止漂移。可参考“都市日常”式写法：先给清晰生活目标，再说明低烈度冲突如何产生真实结果，然后把开场/冲突/结尾分别落到具体物件和场面，最后写哪些爽点是微小但可见的改变。不要把通用方法论硬套进所有题材。
+每张题材卡必须回答九件事：题材核心、主线目标、冲突发动机、爽点定位、常见情绪转化、场景颗粒、正文落点、前中后期打法和禁止漂移。以“都市日常”为例：先给生活目标，再说明低烈度冲突如何改变关系或处境，把开场、冲突和结尾落到具体物件与场面，写出微小但可见的爽点。各题材保留自己的冲突和释放方式。
 
 ## 不要把这些写成硬规则
 

package/lib/oh-story/skills/story-setup/references/agent-references/genre-readers.md

@@ -1,14 +1,10 @@
 # 读者心理与题材适配
 
-> **用途**：读者心理需求、题材生命力规律、跨网站适配、平台差异、书名/简介技法、代入感管理。选题和定位时对照使用。
-> **语气**：指令式——每个规律都要转化为选题、定位、书名、文案或开篇的可执行约束。
-> **配合**：长篇结构与声线见 `long-genre-catalog.md`、`long-genre-mechanics.md` 与 `genre-prose-cards.md`；短篇结构见 `short-genre-formulas.md`。
+> **配合**：长篇结构、核心梗与声线见 `long-genre-catalog.md`、`long-genre-mechanics.md`、`genre-prose-cards.md`；短篇结构见 `short-genre-formulas.md`。
 
 ---
 
-## 决策路由：按决策类型选章节
-
-> 做选题和定位决策时，先确认你在做什么决定，然后翻到对应章节。
+## 决策路由
 
 | 你要做的决定 | 先看哪个章节 | 核心问题 |
 |-------------|-------------|---------|
@@ -26,14 +22,15 @@
 
 ### 从爆款反推读者心理
 
-- 从爆款提炼核心剧情元素→框定读者画像→推测心理需求→双管验证
-- 爆款情绪一以贯之(斗破="莫欺少年穷"从头到尾)；非爆款散乱多头并行
-- 小情绪(升级/复仇/寻宝)应统一到主情绪之下
-- 验证法：提炼出的情绪需求对照目标读者真实生活状态
+- 从爆款提炼核心剧情元素，框定候选读者画像并推测心理需求，再对照剧情与读者反馈验证。
+- 检查主情绪是否贯穿全书，如斗破的"莫欺少年穷"；升级、复仇、寻宝等小情绪应服务于主情绪，避免各自展开却互不支撑。
+- 验证时把推测的需求与目标读者的评论、生活状态对照，不把剧情反推的画像直接当作事实。
 - 特别关注"别人觉得剧毒但核心读者痴迷"的元素
 
 ### 题材→读者画像→深层需求
 
+下表是从题材机制反推的候选画像，须用目标样本和读者反馈验证。
+
 | 题材 | 读者画像 | 三层心理需求 |
 |------|----------|-------------|
 | 末日重生 | 对阶级跃升绝望的人 | 颠倒秩序(权力渴望)+不安全感(生存焦虑)+捡漏(最小努力最大回报) |
@@ -42,23 +39,18 @@
 
 ### 深层需求挖掘法
 
-- 潜入读者集体潜意识→爱什么恨什么渴望什么逃避什么
-- 不同题材读者画像不同→必须先定位读者再设计情绪
-- 写作前先问：目标读者现实生活中最缺什么？最想要什么？
-- 情绪需求深度决定作品天花板——越触及深层需求共鸣越强
+先定位读者，问清他们爱什么、恨什么、渴望什么、逃避什么，再检查核心情绪能否回应他们现实中最缺、最想要的东西。
 
 ### 情绪根源
 
-情绪来自"不公平"和"为什么"。区别对待→读者理所当然觉得不公平→这就是情绪根源。
+"不公平"是常见情绪来源：让读者看见区别对待的具体行为，并追问主角为什么承受这些后果。
 都市情绪例：事业小有成就→爸要创业→妈要给弟弟买婚房→不公平感自然产生。
 
 ---
 
 ## 题材生命力规律
 
-- 题材生命力按“样本验证”判断，不把历史经验当作当前事实。
-- 先用当前 scan/analyze 或用户指定样本确认目标平台仍有读者反馈。
-- 判断题材所处阶段：新鲜期 / 成熟期 / 审美疲劳期。
+- 用当前 scan/analyze 或用户指定样本的读者反馈判断题材阶段：新鲜期 / 成熟期 / 审美疲劳期，不把历史热度当作当前事实。
 - 新鲜期优先提炼创意方向；成熟期优先稳定交付边界期待；疲劳期必须给出新切入点。
 - 跟风只能复用结构功能位，不能复刻剧情内容。
 - 无法确认阶段时，按成熟期处理：保守满足边界期待，微创新不超过 3 个。
@@ -75,13 +67,13 @@
 
 ## 跨网站题材适配
 
-同一个题材在不同网站写法完全不同，由目标读者群体决定。不能用A网站的样本直接套到B网站；必须用目标平台样本校准读者期待、节奏和雷点。
+跨平台写作须用目标平台当前样本校准读者期待、节奏和雷点。下列差异作为定位假设。
 
 ### 平台核心差异
 
 | 平台 | 核心驱动力 | 不适配题材 |
 |------|-----------|-----------|
-| 刺猬猫 | 整活与人设，动漫同人/二游基础 | 全民流、高武流基本行不通 |
+| 刺猬猫 | 整活与人设，动漫同人/二游基础 | 全民流、高武流需先验证圈层接受度 |
 | 起点(非轻小说) | 正常剧情推进的节奏与代入感 | 纯整活难以长期维持 |
 | 起点轻小说 | 整活+人设+节奏并重 | 需持续整活能力 |
 | 番茄 | 强情绪、噱头、爽感直给 | 需慢热铺垫的题材 |
@@ -93,11 +85,9 @@
 | 起点 | 筛选成本高，读者更耐心，慢节奏也能接受 |
 | 新媒体(30岁+) | 偏爱接近真实的故事，被打击的生活才是常态 |
 
-**关键**：同一套写法不同平台效果截然不同，必须针对平台调整。
-
 ### 刺猬猫要点
 
-同人优先验证目标圈层样本 | 脑洞要加成在次元文化里 | 逻辑以圈层接受度为准 | 少写打斗多写日常 | 对"梗"要求很高，需用最新榜单/评论校准
+同人先验证目标圈层样本，脑洞要与次元文化结合，逻辑接受度也由圈层样本校准。以整活和人设为卖点时，多用日常互动发挥角色魅力，少用连续打斗挤占篇幅；梗的选用对照最新榜单和评论。
 
 ### 番茄书测改名策略
 
@@ -116,24 +106,26 @@
 
 ### 玄幻三大核心
 
-- **代入感**：玄幻王朝比赛博朋克代入感强百倍；肉身成圣拳拳到肉比斗法对波好代入
-- **期待感**：期待感不崩贯穿全文，读者流失很慢
-- **认同感**：读者代入主角对主角认同=死忠粉极难流失。"小德可缺大义不能失"
+- **代入感**：面向熟悉玄幻的读者，王朝身份关系通常比赛博朋克设定更易理解；肉身成圣的拳拳到肉，比斗法对波更便于用痛感和力量差距写代入。
+- **期待感**：让眼前目标与后续升级相接，持续兑现并更新期待。
+- **认同感**：通过主角的选择建立认同，尤其要守住大义上的一致性。"小德可缺大义不能失"
 
 ### 都市文暧昧四要素
 
-1. **女人**：没有女人的都市文不是都市文(男频)
-2. **轻松**：读者图轻松愉悦不写苦大仇深
+四要素用于男频都市文的暧昧支线。
+
+1. **女人**：让女性角色参与主角生活，与主角形成暧昧关系和互动。
+2. **轻松**：暧昧互动以轻松愉悦为主，避免全靠苦大仇深维持关系。
 3. **互动**：角色间互动+读者与主角的"秘密"互动
 4. **私密**：隐藏主角能力，读者和主角之间的小秘密
 
 ### 金手指设定原则
 
-必须与主角生活/职业息息相关。医生配医术秘籍=合理；医生配隐身=牵强。金手指跟主线有关，技能能升级，一个技能衍生不同效果，不要频繁开新金手指。
+金手指须关联主角生活、职业与主线。医生配医术秘籍=合理；医生配隐身=牵强。让同一技能升级、衍生不同效果，不频繁另开金手指。
 
 ### 历史文红线
 
-- 核心立场："基于民族主义的圣主平等"，前后立场摇摆=严重割裂
+- 采用仁义换忠诚的历史爽文路线时，写主角悲天悯人、施惠于人，受惠者因此效忠或受感化；人物立场前后一致。
 - 历史网文≠历史，以读者为第一要素不是以真实为第一要素
 - 历史人物评判跟随当代权威共识，尤其是教员的评判，不要逾越
 - 爽感阈值管理：前期家族/势力升级过快→后续难以为继
@@ -144,15 +136,15 @@
 
 ### 代入感
 
-代入感高度重叠于爽感。代入感低时主角做什么读者都不觉得爽。越代入越爽越爽越想看。
+代入感会放大爽感：读者认同主角的目标与处境，才更容易因主角的突破、获利或被认可而满足。
 
 ### 塑料感来源
 
-仙侠不仙、武侠不侠、画风撕裂(仙侠世界搞科研)。去塑料感：让世界像真实存在的世界不是纸糊的。
+塑料感常来自仙侠不仙、武侠不侠，或新元素与原有世界脱节，如仙侠世界搞科研却不交代知识和制度如何衔接。补足世界内部的因果，让人物的生活与选择受其规则影响。
 
 ### 同人为什么开头高追读
 
-世界观够硬，初始代入感够高。例外：搞笑文/梗文核心偏有趣，爽感居次，需旁观者视角，不需要强代入感。
+熟悉原作的读者已有世界观和人物认知，开篇较容易建立代入感。搞笑文/梗文则可侧重旁观者看热闹的趣味，爽感居次，不必强求读者与主角高度同一。
 
 ### 有效扫榜
 
@@ -160,7 +152,7 @@
 
 ### 商业化认知
 
-私人表达占比规则：非核心情绪的个人表达不超过全篇5%，且不得打断叙事节奏。商业化不是故意恶心读者。商业化原则：所有私人表达必须服务于核心卖点，不得独立于主线剧情存在。
+私人表达须服务于核心卖点和主线剧情。非核心情绪的个人表达不超过全篇5%，且不得打断叙事节奏。
 
 ---
 
@@ -168,6 +160,8 @@
 
 ### 身份法(覆盖约1/3书名)
 
+按目标榜单核对这类书名的占比，再选以下公式。
+
 | 类别 | 公式 | 示例 |
 |------|------|------|
 | 高逼格身份 | [仙帝/魔神/财阀]爹妈+[反差行为/目标] | "武神爹，财阀妈，我当躺赢狗怎么了？" |
@@ -187,7 +181,7 @@
 
 | 平台 | 风格 | 关键原则 |
 |------|------|----------|
-| 番茄 | 噱头优先吸量第一 | 书名决定80%流量上限 |
+| 番茄 | 噱头优先吸量第一 | 书名承担吸量入口，须准确承诺正文卖点 |
 | 起点 | 轻度反差+金手指+主线+爽点 | 内容必须贴合书名 |
 
 ---
@@ -212,24 +206,22 @@
 
 ### 文案要点
 
-- 必须体现女主主体性——主体性差会提高吸引力和留存风险
-- 读者需要安全感——至少暗示主角会成功
+- 体现主角主体性，让读者看见主角会作什么选择；女频感情线尤其要交代女主如何回应处境。
+- 简介按类型兑现承诺：成功型暗示会赢，行动型留下结果悬念，失败型交付虐感并留悬念，悬疑型交代核心问题。
 - 文案和书名货不对板会劝退
-- 悬疑型不宜叠过多——太"谜语人"理解不了且安全感不足
+- 悬疑型文案不宜叠加过多未解问题；读者至少要看懂主角处境与核心悬念，避免只剩"谜语人"式表达。
 
 ---
 
 ## 质量检查清单
 
-> 选题定位完成后逐项核对。全部通过才算合格。
-
 - [ ] **读者画像明确**：能用一句话说出目标读者是谁、现实生活中最缺什么
 - [ ] **深层需求对位**：题材提供的核心情绪与读者深层需求匹配，不是自嗨
 - [ ] **题材生命力判断**：已用当前样本确认题材阶段，不把历史热度当作当前事实
 - [ ] **平台适配**：写法已针对目标平台调整，不是用A平台的经验硬套B平台
 - [ ] **边界感确认**：当前素材、知识储备和篇幅能支撑所选题材
 - [ ] **书名3秒抓人**：书名在目标平台的命名规则内，3秒内能传递核心卖点或钩子
-- [ ] **简介有安全感+钩子**：简介类型选择正确，给了安全感同时留了悬念
+- [ ] **简介有安全感+钩子**：承诺的情绪与简介类型一致，读者知道看什么，并有继续看的悬念
 - [ ] **代入感无塑料感**：世界观自洽，画风统一，没有"仙侠搞科研"式撕裂
 - [ ] **书名简介内容三位一体**：书名暗示的卖点=简介承诺的内容=正文实际交付的东西
 - [ ] **金手指与生活关联**：金手指设定与主角职业/生活紧密相关，不是硬贴的

package/lib/oh-story/skills/story-setup/references/agent-references/long-chapter-hooks.md

@@ -195,7 +195,7 @@
 | 对手 | 嚣张到让读者恨 → 被打脸时才爽 |
 | 主角 | 铺垫时低调 → 释放时干脆 |
 
-看点 = 吊起读者期待；爽点 = 满足期待。一一对应：前面铺垫多少，后面爽点就有多少。
+看点吊起期待，爽点兑现期待；核对前面承诺了什么、后面兑现了什么，避免铺垫落空。
 
 ### 装逼打脸节奏
 

package/lib/oh-story/skills/story-setup/references/agent-references/long-emotional-methods.md

@@ -6,16 +6,16 @@
 
 ## 长篇单元情绪引擎（通用正向框架）
 
-每个剧情单元先设计能制造情绪与兑现的**正向发动机**，再按契约四问检查：
+每个剧情单元先设计能制造情绪与兑现的**情绪引擎**，再按契约四问检查：
 
 > **核心情绪命题 → 承载对象/情绪缺口 → 受阻或缺口维持原因 → 本轮触发 → 主角不可替代的点火/转化动作 → 意义变化或可见兑现 → 题材/契约兑现**
 
-这条因果链适用于爽、燃、甜、虐、恐、治愈等不同核心情绪。承载对象可以是人物、关系、目标、规则或场景；不适用的环节可写“无/即时”，但必须保持因果闭合。它不要求每个题材都有长期受阻、最终画面或克制反应，也不规定单一机制：误解、物件、反转、死亡等都不是必备项。下文“情感虐心三板斧”是适合部分情感题材的**可选技法**，不是通用引擎的硬模板。
+这条因果链适用于爽、燃、甜、虐、恐、治愈等不同核心情绪。承载对象可以是人物、关系、目标、规则或场景；不适用的环节可写“无/即时”，但必须保持因果闭合。下文“情感虐心三板斧”供需要羁绊、撕裂与余韵的桥段选用。
 
-### 正向发动机与负向护栏的顺序
+### 先设计情绪，再检查契约
 
-1. **先设计正向发动机**：明确读者会为什么投入，本轮如何让这份投入改变意义并得到可见兑现。
-2. **后用项目读者契约做负向护栏诊断**：按契约四问排查契约/推进失败——主角是否靠自己的选择挣到结果，收益有没有被无交换地拿走，有没有提前动用终局底牌或把升级线顶到天花板，旧期待付了利息没。“安全”只代表没踩红线，不代表好看；护栏不能代替情绪发动机。
+1. **先设计情绪引擎**：明确读者会为什么投入，本轮如何让这份投入改变意义并得到可见兑现。
+2. **再检查主角代理权与成长**：按契约四问核查：主角是否凭选择挣到结果，收益是否被无交换地拿走，是否提前用尽终局底牌或升级空间，旧期待是否付了利息。“安全”只代表没踩红线，不代表好看；契约检查不能代替情绪设计。
 
 ### 合理性五问
 
@@ -29,7 +29,7 @@
 
 ### 强度原则
 
-强情绪来自**具体投入、受阻/延迟、意义变化、可信反应等机制按题材组合**，不要求全部出现，也不来自堆叠死亡、疾病和哭喊。克制反应只是部分情绪的可选放大器。物件、对话、动作、身份、规则、关系都可作为可选锚点；锚点频率随篇幅和读者记忆需求调整，从不强制重复三次。集体或价值抬升也是可选的；只在题材需要时，才由个体兑现扩展到题材核心情绪。
+强情绪来自**具体投入、受阻/延迟、意义变化、可信反应等机制按题材组合**，不要求全部出现，也不来自堆叠死亡、疾病和哭喊。克制反应只是部分情绪的可选放大器。物件、对话、动作、身份、规则和关系均可作锚点，重复频率随篇幅与记忆需求调整，不固定三次。集体或价值抬升也是可选的；只在题材需要时，才由个体兑现扩展到题材核心情绪。
 
 ---
 
@@ -49,7 +49,7 @@
 
 ## 情感虐心三板斧
 
-### 第一斧：羁绊铺设（前 1/3）
+### 第一斧：羁绊铺设
 
 **目标**：用具体物件/数字/细节建立关系质感，让读者相信这段关系是真实的。
 
@@ -67,7 +67,7 @@
 
 ---
 
-### 第二斧：情感撕裂（中后段）
+### 第二斧：情感撕裂
 
 **目标**：制造反差，让读者以为恨对了 → 发现恨错了（或反过来）。
 
@@ -85,7 +85,7 @@
 
 ---
 
-### 第三斧：余韵钝痛（结尾）
+### 第三斧：余韵钝痛
 
 **目标**：不用大哭大闹，用安静细节击穿读者防线。
 
@@ -123,7 +123,7 @@
 
 ### 拉扯原则
 
-1. **情绪转向频率是题材与篇幅经验法则**：结合题材、篇幅和既有兑现节奏调整，不固定要求每 3-5 个小节转向
+1. **安排情绪转向**：结合题材、篇幅和既有兑现节奏，决定何时加压、反弹或收束
 2. **每次转向都要有触发事件**（不能无理由地改变情绪）
 3. **最后一次转向决定结尾余韵的基调**
 4. **爽文允许快速反弹，虐文需要更长铺垫**
@@ -132,17 +132,18 @@
 
 ## 按题材的情感策略差异
 
+下列短篇案例示范情绪机制，长篇按当前剧情单元的因果与关系变化安排时机。
+
 ### 世情/爽文
 
-- 情绪反弹速度：快（受辱后 2-3 节内打脸）
-- 打脸密度：每 3-5 节一次
+- 受辱→蓄势→反击：让蓄势增加可用筹码，反击后改变关系或局势
 - 反派嚣张度：递增（第一次小嚣张，最后一次大嚣张）
 - 结尾基调：痛快、解气
 - 案例：《准儿媳打分》— 打分制反制、铁盒零分、断绝关系
 
 ### 情感/虐心
 
-- 羁绊细节密度：高（前 1/3 必须建立深厚羁绊）
+- 羁绊铺垫：撕裂前用具体经历、习惯或物件让关系成立
 - 反差设计：先暖后冷，先甜后苦
 - 余韵技法：安静结尾 + 物件细节
 - 结尾基调：意难平、释然
@@ -152,7 +153,7 @@
 
 - 设定简洁原则：人物关系清晰，不搞复杂世界观
 - 暴力美学写法：打脸要直接，不拖泥带水
-- 底牌时机：最后 1/4 揭示最大底牌
+- 底牌时机：反击条件与铺垫成熟后揭示，留出行动与后果的篇幅
 - 结尾基调：大快人心、因果报应
 - 案例：《皇弟欺负幼子》— 一声令下打二十棍 → 查出真相 → 废后
 
@@ -178,32 +179,32 @@
 
 | 失败模式 | 识别方法 | 修正方向 |
 |----------|----------|----------|
-| **太平** | 连续 5+ 节没有情绪转折 | 插入意外事件或新信息 |
-| **太赶** | 重大转折缺少可辨认的铺垫 | 按转折重量与篇幅给予足够且可辨认的铺垫，不固定三节 |
+| **太平** | 剧情单元内期待停滞，没有新的投入、阻碍或兑现 | 插入意外事件或新信息 |
+| **太赶** | 重大转折缺少可辨认的铺垫 | 按转折重量与篇幅补足铺垫 |
 | **假虐** | 读者不心疼，只是看着难受 | 检查羁绊铺设是否具体 |
 | **割裂** | 前半部分和后半部分像两篇不同的故事 | 用伏笔/物件/主题贯穿 |
-| **烂尾** | 反转后仍长时间重复交代 | 按题材与篇幅适配的速度收束或冷却，不固定五百字 |
+| **烂尾** | 反转后仍长时间重复交代 | 交代行动、关系或代价的后果，再按题材收束或冷却 |
 | **人设崩** | 角色在关键时刻的行为不符合前面的人设 | 回顾人设，确保行为逻辑一致 |
 
 ---
 
 ## 快速自查
 
-设计情感时，用这个清单：
+使用三板斧时，按所选技法核对：
 
-- [ ] 前 1/3 有具体羁绊细节（不是抽象描述）？
-- [ ] 中段有反差/撕裂（读者以为 A → 实际是 B）？
-- [ ] 结尾有安静细节（不是大段抒情）？
-- [ ] 情绪转向频率是否按题材、篇幅和既有兑现节奏调整，而非固定密度？
+- [ ] 羁绊铺设：撕裂发生前，具体细节是否已让读者相信关系？
+- [ ] 情感撕裂：真相、反差或错位是否改变了对关系的理解？
+- [ ] 余韵钝痛：桥段收束时，安静细节是否承接了变化的后果？
+- [ ] 情绪转向是否有事件触发，并符合题材、篇幅和既有兑现节奏？
 - [ ] 反派行为符合其人设逻辑？
 - [ ] 不存在上述 6 种失败模式？
 
 ---
 
-## 三板斧与 SKILL.md 五段结构映射
+## 三板斧在情感桥段中的位置
 
-| 三板斧 | 对应 SKILL.md 五段 | 说明 |
+| 三板斧 | 桥段位置 | 说明 |
 |--------|-------------------|------|
-| 第一斧：羁绊铺设（前 1/3） | 铺垫段（第二段，占 30-40%） | 用物件/数字/习惯建立关系质感 |
-| 第二斧：情感撕裂（中后段） | 升级段（第三段）+ 反转段（第四段） | 反差/错位/延迟真相制造撕裂 |
-| 第三斧：余韵钝痛（结尾） | 结尾段（第五段，占 5-10%） | 安静细节收尾，不写大段抒情 |
+| 第一斧：羁绊铺设 | 情感撕裂前 | 用物件/数字/习惯建立关系质感 |
+| 第二斧：情感撕裂 | 羁绊成立后 | 反差/错位/延迟真相制造撕裂 |
+| 第三斧：余韵钝痛 | 桥段收束时 | 用安静细节承接关系变化的后果 |

package/lib/oh-story/skills/story-setup/references/agent-references/long-genre-catalog.md

@@ -6,15 +6,15 @@
 
 ## 题材选择路由
 
-根据以下条件快速定位对应框架。先判断大类，再看具体变体。
+先按故事核心判断大类，再查具体变体。
 
 | 如果故事核心是... | 走这个框架 | 备注 |
 |---|---|---|
-| 男人伤害女人，离开后悔但追不回 | **追妻火葬场** | 女主离开后不回头是核心 |
+| 男人伤害女人，女主离开后男人追悔 | **追妻火葬场** | 冷拒主线不回头，复合型另作变体 |
 | 前世惨死，重生利用信息差复仇 | **重生复仇** | 反派需分层嵌套 |
 | 伴侣出轨/算计，觉醒独立 | **小三/婚恋** | 发现过程要有悬念 |
 | 奇葩/恶霸欺压老实人，恶有恶报 | **世情** | 靠细节不靠大事件 |
-| 女主被虐至死，男主死后追悔 | **死人文学** | 核心是"来不及" |
+| 女主被虐至死，男主在她死后追悔 | **死人文学** | 核心是"来不及" |
 | 特殊相遇，男主追求宠溺 | **霸总/甜宠** | 甜的密度决定粘性 |
 | 底层崛起，升级打怪（都市+武道） | **都市高武** | 金钱驱动+分层地图 |
 | 废材/落魄天才，修仙世界登顶 | **仙侠/玄幻** | 力量体系必须清晰 |
@@ -41,7 +41,7 @@
 
 ### 长篇（8节点）
 
-**设定**：女主被伤害 → 离开 → 男主后悔追回但女主不回头。场景：豪门/职场/娱乐圈/古代贵族，需权力差。
+**设定**：冷拒主线为女主被伤害 → 离开 → 男主后悔追回但女主不回头；复合型在结局另作变体。场景：豪门/职场/娱乐圈/古代贵族，需权力差。
 
 **人物**
 | 角色 | 弧线 |
@@ -60,7 +60,7 @@
 | 5.男主追悔 | 意识女主重要性 | 10% | 痛快 |
 | 6.事业/成长 | 新领域取得成绩 | 15% | 爽(逆袭) |
 | 7.反复拉扯 | 多次求复合被拒 | 20% | 爽(打脸) |
-| 8.结局 | 开放/回头/悲剧 | 15% | 释放 |
+| 8.结局 | 冷拒主线开放/悲剧；复合变体可回头 | 15% | 释放 |
 
 ---
 
@@ -227,13 +227,13 @@
 ## 同人流派
 
 ### 核心机制
-借用已有IP世界观和角色写新故事。核心卖="如果在这个世界里有主角会怎样"。
+借用已有 IP 的世界观和角色写新故事，核心卖点是"如果在这个世界里有主角会怎样"。
 
 ### 使用边界
-不保留具体 IP 题材清单。只有用户明确目标 IP、平台允许且近期样本有效时，才抽取“已知世界 + 新主角变量 + 名场面改写”的结构功能。
+用户明确目标 IP、平台允许且近期样本有效时，抽取“已知世界 + 新主角变量 + 名场面改写”的结构；具体题材随本次目标确定。
 
 ### 写法要点
-- 读者大多"云爱好者"：没看过原著的比看过的多，硬核非必要
+- 面向"云爱好者"时，补足读懂当前剧情所需的原著背景，不预设读者熟悉全部原作
 - 爽第一：不为还原原著牺牲爽感
 - 时代设定可简化，适度改编不影响阅读；但人物命名不脱离原著的地域和文化——原著角色用官方本名/译名，新角色顺对应地域的命名风格，别混语系或塞与设定不符的现代化/政治化名字
 - 优势：自带世界观省铺设定 | 风险：原著粉考据挑刺
@@ -260,7 +260,7 @@
 | 逆向型 | 失去X→获得更强Y | 越惨越强、负债越有钱 |
 
 ### 写长方法
-核心卖点确定后多套路交织循环；单元故事围绕一个套路展开，主线串联；剧情单元循环(模式重复但对象/场景/规模升级)
+核心卖点确定后，用主线串联多个套路：每个单元围绕一个套路展开，重复模式时升级对象、场景或规模。
 
 ### 脑洞四类
 1. 金手指类(聊天群/系统/戒指老爷爷)
@@ -308,7 +308,7 @@
 | 经营/种田 | 古代搞经济建设 | 技术引进、商业帝国、改善民生 |
 | 国潮/非遗 | 传统文化魅力 | 盘点式装逼、民族自豪感 |
 
-**关键**：大部分读者是"云爱好者"爽感优先于还原度 | 现代认知信息差=最大金手指 | 架空可降低门槛 | 盘点+历史共鸣感强
+**关键**：面向"云爱好者"时，先交代读懂剧情所需的历史处境，爽感优先于细节还原 | 现代认知信息差=最大金手指 | 架空可降低门槛 | 盘点+历史共鸣感强
 
 ---
 
@@ -335,13 +335,13 @@
 ## 其他题材速查
 
 ### 规则怪谈
-类无限流，玩家被抽入规则副本冒险求生。绑定国运+直播性价比最高。副本构建：背景故事→规则包装→通关线+dead end→节奏(别人死→主角装→揭露→升华)。番茄主流走爽文路线，智斗和金手指负责包合理外衣。
+类无限流，玩家被抽入规则副本冒险求生。主打国运压力和围观反馈时，可用绑定国运+直播组合。副本构建：背景故事→规则包装→通关线+dead end（死路）→节奏(别人死→主角装→揭露→升华)。爽文路线用智斗和金手指解释通关结果，规则和限制要能支撑翻盘。
 
 ### 长生流
 核心卖=时移世易沧海桑田，主角长生看别人浴血搏杀。凡俗时期最好看。天然缺陷：开始修仙后实力增长→身边同级别出现→"熬时间"失去意义→变成寻常修仙文。延续方向：保持时间碾压感/代际传承/分层世界/凡俗时期充分展开。
 
 ### 西幻/骑士文
-西幻=东方玄幻内核换皮。骑士自带晋升属性是天然力量体系骨架。推荐DND式/巫师式/种田领主文，不写日式奇幻。开篇从低位开始(马奴/铁匠学徒)，凿壁偷光式努力。
+西幻要让魔法、种族、神权和契约影响人物选择，不能只替换东方玄幻名词。骑士晋升可作力量体系骨架；这里侧重DND式/巫师式/种田领主文，日式奇幻另按目标对标确定写法。开篇从低位开始(马奴/铁匠学徒)，凿壁偷光式努力。
 
 ### 新媒体文
 一切为情绪服务。第一情绪对：不爽→装逼/愤怒→解气。双向结构=强+虐(反差/矛盾)。矛盾必须源于现实逻辑。核心三重点：用梗+节奏+情绪。极致信息差=强烈期待感。
@@ -356,7 +356,7 @@
 核心靠铺垫+氛围描写营造悬疑感，非靠血腥暴力。信息释放节奏要控好。
 
 ### 高武
-爽点相对单一(升级打怪)但套路成熟不易翻车。可高仿成功作品世界观架构降低门槛。
+爽点集中于升级打怪，成熟套路便于建立期待。可借鉴成功作品的战力层级、地图递进和资源循环，按本书设定重建世界观。
 
 ### 后悔流
 避免退婚等老套外衣，需创新包装（后悔对象可从爱情转为事业选择/人生抉择）。

package/lib/oh-story/skills/story-setup/references/agent-references/long-genre-mechanics.md

@@ -24,7 +24,7 @@
 
 ## 核心梗三层递进设计（主题→题材→情绪）
 
-三代指**迭代层次**，一本小说通常由2-4条核心梗融合。
+下文一代、二代、三代指从主题到题材再到情绪的**三个设计层次**，不指写作的历史阶段；一本小说通常融合2-4条核心梗。
 
 ### 一代：主题/中心思想
 
@@ -242,7 +242,7 @@
 
 ### 爽点阈值递升原则
 
-后一个剧情的情绪满足必须高过前一个。
+同类关键爽点要在下列维度中递升；两次高潮间可安排呼吸与关系回收。
 
 **递升维度**：影响力范围扩大 | 人物层级升高 | 收获价值增大 | 认知颠覆加深
 

package/lib/oh-story/skills/story-setup/references/agent-references/long-quality.md

@@ -1,6 +1,6 @@
 # 长篇质量覆盖
 
-> 与 `agent-quality.md` 配套，仅在 `long` profile 加载。长篇按章、单元、卷和全书分层审查；短篇全文百分比、每节字数和对话密度不适用。
+> 与 `agent-quality.md` 配套，仅在 `long` profile 加载，按章、单元、卷和全书审查；不套短篇全文百分比、每节字数或对话密度。
 
 ## 黄金三章
 
@@ -14,8 +14,8 @@
 
 ## 连载节奏
 
-- [ ] 最近一个章节窗口有可见进展；窗口长度按当前卷和章节定位判断，不固定为短篇节数。
-- [ ] 高压、推进、低压、关系和信息整理章形成张弛，连续章节没有同一情绪母题和同一种钩子高位运行。
+- [ ] 最近一段章节有可见进展；范围按当前卷和章节定位判断，不套短篇节数。
+- [ ] 高压、推进、低压、关系和信息整理章形成张弛，不让同一情绪母题和同一种钩子连续占据高位。
 - [ ] 短期、中期、远期期待都有人维护；回收旧期待前已建立下一层期待。
 - [ ] 单章反转改变下一步行动，卷级反转改变对阶段机制的理解，全书真相没有被提前透支。
 

package/lib/oh-story/skills/story-setup/references/agent-references/long-reversal.md

@@ -1,6 +1,6 @@
 # 长篇反转设计
 > 操作手册：反转类型、嵌套反转、误导技巧、打脸节奏。按决策路由选用，按设置/揭示步骤执行，用自检清单验收。
-> 反转类型枚举与拆文 `_meta.json.reversal_type` 字段一致：视角/身份/动机/时间线/信息/认知/无反转。
+> 以下分类也用于短篇拆文的 `_meta.json.reversal_type` 字段：视角/身份/动机/时间线/信息/认知/无反转。
 
 ## 决策路由
 
@@ -177,7 +177,7 @@
 2. 报应型：每个报应要让读者等过、铺过，兑现时才解气
 3. 甜宠型：在关系阶段节点给甜点/反差点，不为每章硬塞反转
 
-> 拆文时遇到此类，`reversal_type` 填「无反转」，`setup_clues`（反转铺垫）一项跳过阈值（见 analyze output-contract 的「structure_counts 数值校验」）。
+> 使用短篇拆文资料时，「无反转」对应 `reversal_type`，「反转铺垫」对应 `setup_clues`；该类型跳过铺垫数量阈值。它们是短篇拆文字段，不是长篇卷纲新增字段。
 
 ---
 
@@ -303,7 +303,7 @@
 
 1. 展示物品/能力强大，读者期待+1
 2. 配角因信息差认为鸡肋，读者期待打脸+1
-3. 展示反派特性恰好克制，读者期待+1
+3. 展示反派特性，前述物品/能力恰好克制反派，读者期待+1
 4. 配角拿更强装备打反派失败，期待+1
 5. 众人看衰主角，期待继续+1
 6. 主角秒杀，期待满足

package/lib/oh-story/skills/story-setup/references/agent-references/long-suspense.md

@@ -13,8 +13,6 @@
 | 跨卷悬念 | 期待接力法 + 震惊分层 |
 | 判断悬念强度 | 强度5级分级表 |
 
-使用方法：先看左列定位你的当前任务，再用右列指定的方法。
-
 ---
 
 ## 悬念构建核心法则
@@ -32,7 +30,7 @@
 | 揭示时机 | 短期内揭晓 | 长期后才揭示 |
 | 情绪效果 | 紧张/好奇/期待 | 震惊/恍然大悟 |
 
-判断依据：短期揭晓+紧张感 = 悬念；长期埋线+揭示时震惊 = 伏笔。两者经常配合使用，但不要混淆。
+判断先看作用：未决问题引起悬念，预埋线索支撑后续揭示。上表是常见安排；悬念也能跨卷，伏笔也能短期回收。
 
 ### 四种悬念信息顺序模板
 
@@ -216,8 +214,8 @@
 
 ### 永留悬念大结构设计
 
-- 大结构是"欺骗式的主线"：贯穿全文的噱头，并不实际推进
-- 每次看似砍了99%，但总剩1%变成新的100%，一直吊着读者
+- 马甲曝光等长悬念可阶段延迟：每次解决一个局部疑问，再暴露更深问题。
+- 局部必须真有推进，不能反复撤销成果，让主线永远原地打转。
 
 ### 信息差运用