feat: initial commit

noma/matrices/catharsis_models/README.md

@@ -0,0 +1,181 @@
+# 爽感路由矩阵 (Catharsis Matrix)
+
+> ONW 5.0 核心组件：心理学与叙事学武器库
+
+## 概述
+
+Catharsis Matrix 是 ONW 5.0 的"多维爽感路由"核心。它将各种高级心理学张力模型固化为 Prompt 模板，供 Planner Agent 动态调用，指导 Writer Agent 生成具有精准情绪释放节奏的章节。
+
+## 模型列表
+
+| 模型 | 文件 | 核心功能 |
+|------|------|----------|
+| 禁忌僭越 | `taboo-transgression.md` | 边缘拉扯、危险感、高压情绪释放 |
+| 降维打击 | `overkill-reversal.md` | 碾压、反转、绝地反击、实力差距逆转 |
+| 认知闭环 | `cognitive-closure.md` | 多线伏笔瞬间收束、解谜快感、认知满足 |
+
+## 调度机制
+
+### Planner Agent 调用流程
+
+```python
+# 伪代码
+def select_catharsis_model(current_scene_context):
+    # 1. 分析当前场景需求
+    tension_level = analyze_tension_needs(current_scene_context)
+
+    # 2. 检查 Genesis Contract
+    core_desire = genesis_contract.core_desire
+
+    # 3. 扫描 Ledger 状态
+    hooks_pool = ledger.hooks
+    unresolved_hooks = [h for h in hooks_pool if not h.resolved]
+
+    # 4. 选择合适的爽感模型
+    if tension_level > 80:
+        return "taboo-transgression"  # 需要强刺激
+    elif needs_reversal:
+        return "overkill-reversal"    # 需要反转
+    elif len(unresolved_hooks) > 3:
+        return "cognitive-closure"     # 需要收束伏笔
+    else:
+        return "default"              # 均衡模式
+```
+
+### 模型选择矩阵
+
+| 场景类型 | 推荐模型 | 权重 |
+|----------|----------|------|
+| 道德困境 | taboo-transgression | 0.8 |
+| 决战前夕 | overkill-reversal | 0.9 |
+| 揭秘时刻 | cognitive-closure | 0.85 |
+| 日常过渡 | (轻度使用) | 0.3 |
+| 多线并行 | cognitive-closure + 组合 | 0.75 |
+| 角色成长 | overkill-reversal | 0.6 |
+
+## 爽感路由规则
+
+### 优先级规则
+
+1. **Genesis Contract 优先**: `core_desire` 决定核心爽感类型
+2. **Hook 压强次之**: `hooks_pool` 中未解钩子触发 cognitive-closure
+3. **场景需求兜底**: 当前写作上下文决定最终选择
+
+### 组合使用
+
+多个模型可以组合使用：
+
+```markdown
+# 组合示例：禁忌僭越 + 降维打击
+
+[主角] 面临艰难抉择 (taboo-transgression setup)
+  ↓
+[主角] 突破道德底线
+  ↓
+[反派] 试图趁虚而入
+  ↓
+[主角] 降维碾压 (overkill-reversal)
+  ↓
+[结果] 在突破禁忌后更加强大
+```
+
+### 情绪曲线叠加
+
+```
+Taboo Transgression:    ████████░░░░░░░░ (冲击 → 释放)
+Overkill Reversal:      ░░░░████████████ (积累 → 爆发)
+Cognitive Closure:       ░░░░░░░░░██████ (悬念 → 揭晓)
+
+组合曲线:                ████████▒████████
+                        (多重爽感叠加)
+```
+
+## 调度触发条件
+
+### 自动触发
+
+| 条件 | 触发模型 | 说明 |
+|------|----------|------|
+| `tension_level > 80` | taboo-transgression | 高压场景 |
+| `reader_feedback.drop_rate > 20%` | cognitive-closure | 读者流失预警 |
+| `chapter_type == "climax"` | 所有模型最大化 | 全力输出 |
+| `new_character_introduced` | overkill-reversal | 建立角色实力 |
+
+### 手动触发
+
+Planner Agent 可以手动指定使用特定模型：
+
+```markdown
+用户指令: "/noma-write 50 --catharsis=taboo-transgression"
+```
+
+## 与其他模块的联动
+
+### Genesis Contract (openspec/)
+
+```python
+# Genesis Contract 中的 core_desire 影响模型权重
+if core_desire.primary == "revenge":
+    taboo_transgression.weight *= 1.3  # 复仇题材适合禁忌模型
+elif core_desire.primary == "power":
+    overkill_reversal.weight *= 1.3    # 力量题材适合降维模型
+```
+
+### Ledger (core_engine/)
+
+```python
+# Ledger 中的 Hook 触发 cognitive-closure
+for hook in ledger.hooks:
+    if is_buried_long_enough(hook):
+        trigger_cognitive_closure(hook)  # 长时间埋设的钩子回收
+```
+
+### Retcon Manager (core_engine/)
+
+```python
+# Retcon 触发新的爽感需求
+if retcon.is_major_change():
+    invalidate_cached_models()  # 清除缓存的模型选择
+    re_evaluate_catharsis_needs()  # 重新评估爽感需求
+```
+
+## 效果追踪
+
+### 指标收集
+
+| 指标 | 收集方式 |
+|------|----------|
+| 爽感密度 | 每千字爽点数量 |
+| 读者追读率 | Dashboard 监控 |
+| 章节完成率 | 阅读数据 |
+| 情绪峰值分布 | 章节内停顿点分析 |
+
+### 调优
+
+```python
+# 根据效果数据调优模型权重
+def adjust_model_weights(performance_data):
+    if performance_data.satisfaction < threshold:
+        # 增加爽感密度
+        current_model.weight *= 1.1
+    elif performance_data.confusion > threshold:
+        # 减少复杂模型使用
+        cognitive_closure.weight *= 0.8
+```
+
+## 最佳实践
+
+1. **不要连续使用同一模型**: 交替使用不同爽感类型保持新鲜感
+2. **始终服务核心欲望**: 爽感模型是手段，core_desire 是目的
+3. **控制单章爽感密度**: 推荐 2-4 个爽感释放点
+4. **留有余韵**: 每个爽点后适当缓冲，避免审美疲劳
+
+## 文件结构
+
+```
+matrices/catharsis_models/
+├── README.md                    # 本文件
+├── taboo-transgression.md       # 禁忌僭越模型
+├── overkill-reversal.md         # 降维打击模型
+└── cognitive-closure.md         # 认知闭环模型
+```

noma/matrices/catharsis_models/cognitive-closure.md

@@ -0,0 +1,214 @@
+# 认知闭环模型 (Cognitive Closure)
+
+> **模型类型**: 叙事技巧模型
+> **适用场景**: 多线伏笔瞬间收束、解谜快感、认知满足
+> **ONW 5.0 特性**: 不再是简单的"填坑"，而是精心设计的"认知惊喜"
+
+## 模型概述
+
+认知闭环是指在读者心中建立悬念和期待后，通过精心设计的"回收"时机和方式，带来认知上的满足感和惊喜感。这不仅仅是"填坑"，而是通过巧妙的叙事技巧，让读者产生"原来如此"的拍案叫绝感。
+
+## 核心结构
+
+### 1. 线索网络设计
+
+#### 伏笔类型
+
+| 类型 | 描述 | 回收时机 |
+|------|------|----------|
+| 人物伏笔 | 角色背景的神秘暗示 | 中后期揭秘 |
+| 物品伏笔 | 某个物品的特殊来历 | 需要时揭示 |
+| 事件伏笔 | 某个事件的前因后果 | 因果链完成时 |
+| 言语伏笔 | 某句话的特殊含义 | 语境重现时 |
+| 关系伏笔 | 人物关系的隐藏联系 | 冲突爆发时 |
+| 世界观伏笔 | 规则/设定的小细节 | 关键时刻展示 |
+
+#### 线索密度控制
+
+```
+章节线索密度 = (伏笔数量 / 总章节数) × 100%
+
+推荐密度: 5-15%
+低于5%:  线索太少，闭环时惊喜不足
+高于15%: 线索太多，可能遗忘或混乱
+```
+
+### 2. 闭环时机曲线
+
+#### 时机类型
+
+| 时机 | 描述 | 效果 |
+|------|------|------|
+| 即时闭环 | 埋下后1-3章内回收 | 节奏快但不震撼 |
+| 标准闭环 | 埋下后5-15章回收 | 平衡节奏与惊喜 |
+| 延迟闭环 | 埋下后15-30章回收 | 长期期待，满足感强 |
+| 终局闭环 | 埋下后30+章或大结局回收 | 震撼最大，风险最高 |
+
+#### 闭环节奏设计
+
+```
+阶段1: 埋设 (章节N)
+  - 暗示而非明示
+  - 细节足够但不显眼
+  - 读者"可能"注意到
+
+阶段2: 积累 (章节N+1 ~ N+X)
+  - 偶尔提及保持新鲜感
+  - 不让读者完全遗忘
+  - 在其他情节中自然存在
+
+阶段3: 触发 (章节N+X+1)
+  - 相关事件发生
+  - 触发条件满足
+  - 闭环时机成熟
+
+阶段4: 回收 (高潮场景)
+  - 揭示真相
+  - 读者"原来如此"的震撼
+  - 情绪释放
+```
+
+### 3. 惊喜度计算
+
+```
+Surprise Score = (线索隐蔽度 × 0.3) + (逻辑必然性 × 0.3) + (情感冲击度 × 0.2) + (独到程度 × 0.2)
+
+解释:
+- 线索隐蔽度: 埋的时候有多不明显 (0-100)
+- 逻辑必然性: 回收到位时有多顺理成章 (0-100)
+- 情感冲击度: 揭示时情感有多强烈 (0-100)
+- 独到程度: 是否有独创性 (0-100)
+
+推荐范围: 60-85
+```
+
+### 4. 闭环模板
+
+#### 人物闭环模板
+
+```markdown
+[早期暗示]
+[角色A] 在某个场合无意识地做出了[动作/选择]，
+当时读者可能归因为"性格"或"习惯"。
+
+[中期积累]
+[角色A] 的[背景]一直是谜。
+但每次提及都带着一丝[情绪]。
+
+[终局揭示]
+原来，[角色A] 的[行为]是因为[真实原因]。
+
+[闭环震撼描写]
+那一刻，读者终于明白——
+[角色A] 当初的[动作]，意义完全不同了。
+```
+
+#### 物品闭环模板
+
+```markdown
+[早期出现]
+[物品] 在[场景]中一闪而过，
+可能是作为[普通道具]出现。
+
+[中期发酵]
+[物品] 偶尔在对话中被提及，
+[角色] 对它有莫名的[情感]。
+
+[终局揭晓]
+[物品] 的真正来历是[真相]。
+而它的[特殊属性]源于[原因]。
+```
+
+#### 多线并发闭环模板
+
+```markdown
+[线索A] → [伏笔A1], [伏笔A2], [伏笔A3]
+[线索B] → [伏笔B1], [伏笔B2]
+[线索C] → [伏笔C1]
+
+[触发事件]
+
+[并发揭示]
+在[关键事件]发生后——
+- 线索A的三个伏笔同时引爆
+- 线索B的两个伏笔形成呼应
+- 线索C揭示了更深层的真相
+
+[震撼效果]
+三条线索交汇的瞬间，
+一个更大的真相浮出水面。
+```
+
+## 与 Ledger 的联动
+
+### Hook 类型对应
+
+| Hook 类型 | 闭环类型 | 回收优先级 |
+|-----------|----------|------------|
+| setup | 人物/物品闭环 | 高 |
+| buildup | 事件/关系闭环 | 高 |
+| cliffhanger | 紧急闭环 | 立即 |
+
+### 闭环与资产关联
+
+当闭环涉及角色资产时，需要更新 Ledger：
+
+```python
+# 闭环导致资产变化
+if closure_reveals_secret_ability:
+    ledger.add_asset(Asset(
+        id=f"revealed_{character_id}",
+        type=AssetType.SKILL,
+        name="被封印的能力",
+        value=80,
+        owner_id=character_id
+    ))
+
+# 或者负债转化为资产
+if closure_redeems_past_failure:
+    ledger.remove_liability(f"old_failure_{character_id}")
+```
+
+## 调度建议
+
+Planner Agent 在以下情况下应动态导入本模型：
+
+1. 需要建立长期悬念
+2. 多线叙事需要收束
+3. 角色背景需要揭秘
+4. 高潮决战前需要铺垫
+
+## 风险控制
+
+| 风险 | 规避方式 |
+|------|----------|
+| 伏笔太多记不住 | 使用 Ledger 追踪所有伏笔 |
+| 回收太晚读者忘了 | 中期适当"刷新"存在感 |
+| 逻辑不通显得强行 | 确保伏笔有足够暗示 |
+| 同时闭环太多太乱 | 控制单章闭环数量（≤3） |
+
+## 效果评估指标
+
+```
+Cognitive Closure Score = (Surprise Score × 0.4) + (Logic Coherence × 0.3) + (Timing × 0.2) + (Reader Recognition × 0.1)
+
+其中:
+- Surprise Score: 惊喜度 (见上文)
+- Logic Coherence: 逻辑连贯性 (回收是否顺理成章)
+- Timing: 时机把握 (在情绪高点还是低谷)
+- Reader Recognition: 读者回溯满意度 (回想起来是否合理)
+
+推荐范围: 65-85
+低于65: 闭环太明显或太生硬
+高于85: 可能过于复杂难懂
+```
+
+## 与元叙事开关的联动
+
+当 `interfaces/Meta_Narrative_Panel` 开启"第四面墙 Toggle"时：
+
+1. 允许角色"跳出"讨论伏笔设计
+2. 可以直接向读者"暗示"下一步走向
+3. 闭环可以有"反转后再反转"
+
+这种模式下，认知闭环模型会变得更"元"，但也更考验笔力。

noma/matrices/catharsis_models/overkill-reversal.md

@@ -0,0 +1,184 @@
+# 降维打击与权力倒转模型 (Overkill Reversal)
+
+> **模型类型**: 爽感生成模型
+> **适用场景**: 碾压、反转、绝地反击、实力差距逆转
+> **ONW 5.0 特性**: 不再死守"打脸升级"，动态调用降维打击等高级心理学张力模型
+
+## 模型概述
+
+降维打击与权力倒转是网文最核心的爽感来源之一。本模型通过精细控制"实力差距"和"反转时机"，最大化情绪释放效果。
+
+## 核心结构
+
+### 1. 降维打击 (Overkill)
+
+指一方对另一方形成压倒性优势，以近乎"降维"的方式碾压对手。
+
+#### 权力等级设计
+
+```
+Level 1: 凡人
+  - 普通人类能力
+  - 基础资源
+
+Level 2: 初入门
+  - 入门级能力
+  - 小圈子认可
+
+Level 3: 小有所成
+  - 专精某领域
+  - 一定话语权
+
+Level 4: 一方豪强
+  - 区域影响力
+  - 资源垄断
+
+Level 5: 绝世强者
+  - 国家级影响
+  - 传说级存在
+
+Level 6: 镇压一世
+  - 跨时代存在
+  - 规则制定者
+
+Level 7: 超越传说
+  - 超越位面
+  - 概念级存在
+```
+
+#### 降维打击触发条件
+
+| 条件 | 描述 | 爽感加成 |
+|------|------|----------|
+| 越级挑战 | 低级击败高级 | +50% |
+| 一招制敌 | 秒杀无悬念 | +30% |
+| 围观震惊 | 旁观者目瞪口呆 | +20% |
+| 对方心理崩溃 | 不战而屈人之兵 | +25% |
+
+### 2. 权力倒转 (Reversal)
+
+指原本的弱势方通过某种方式反转局势。
+
+#### 倒转模式
+
+| 模式 | 描述 | 示例 |
+|------|------|------|
+| 绝地翻盘 | 濒死时顿悟/觉醒 | 主角被打到濒死，突然突破 |
+| 蓄势待发 | 长期隐忍后的爆发 | 三年废物，一朝惊艳 |
+| 螳螂捕蝉 | 黄雀在后 | 以为主角输了，其实早已布棋 |
+| 以彼之道 | 用对方招式击败对方 | 用你的剑杀你 |
+| 逆转因果 | 改变规则本身 | 你定的规则，现在不适用了 |
+
+#### 倒转时机曲线
+
+```
+时机1 (0-20%): 过早反转
+  - 张力建立不足
+  - 爽感打折
+
+时机2 (20-40%): 最佳时机
+  - 张力峰值
+  - 反转最震撼
+
+时机3 (40-60%): 黄金时机
+  - 读者开始担心主角
+  - 反转带来最大惊喜
+
+时机4 (60-80%): 延迟满足
+  - 长期压抑后的释放
+  - 爽感最强烈但需铺垫充分
+
+时机5 (80-100%): 过晚反转
+  - 读者可能已经弃文
+  - 风险较高
+```
+
+### 3. 碾压场景模板
+
+#### 碾压前铺垫
+
+```markdown
+[反派] 看着[主角]，嘴角勾起嘲讽的弧度。
+
+"就凭你？"
+
+[反派展示碾压性实力]
+- [实力展示1]
+- [实力展示2]
+- [实力展示3]
+
+[主角]的退路被彻底封死。
+```
+
+#### 碾压进行时
+
+```markdown
+[主角]没有闪避。
+
+[反派]的攻击如期而至——
+
+然而——
+
+[反转描写，300-400字]
+
+[结果]: [反派]的全力一击，被[主角]用两根手指轻轻夹住。
+```
+
+### 4. 情绪释放曲线
+
+```
+峰值1: 绝望 (对手展示实力时)
+  读者情绪: 紧张、担忧
+
+峰值2: 屏息 (主角陷入绝境)
+  读者情绪: 焦虑、期待反转
+
+峰值3: 震撼 (反转发生瞬间)
+  读者情绪: 惊讶、兴奋、满足
+
+峰值4: 延续 (碾压持续展示)
+  读者情绪: 快感、优越感
+
+峰值5: 余韵 (结果尘埃落定)
+  读者情绪: 满足、期待续章
+```
+
+## 与 Ledger 的联动
+
+本模型中的"实力等级"与角色的 Asset 关联：
+
+| 角色 Asset | 影响 |
+|------------|------|
+| power_level | 基础实力等级 |
+| combat_skills | 战斗技能加成 |
+| special_abilities | 特殊能力 |
+| equipment | 装备加成 |
+| reputation | 声望影响心理战 |
+
+## 调度建议
+
+Planner Agent 在以下情况下应动态导入本模型：
+
+1. 需要建立反派的威胁感
+2. 主角获得新能力需要展示
+3. 章节需要一个"爆点"
+4. 高潮决战场景
+
+## 风险控制
+
+| 风险 | 规避方式 |
+|------|----------|
+| 反派太弱显得假 | 给予反派高光时刻再碾压 |
+| 主角开挂太离谱 | 提前埋设能力来源伏笔 |
+| 重复使用审美疲劳 | 每次反转用不同模式 |
+| 实力体系崩坏 | 使用 ledger 追踪战力平衡 |
+
+## 效果评估指标
+
+```
+Overkill Score = (实力差距 × 0.3) + (反转时机 × 0.25) + (碾压篇幅 × 0.2) + (围观反应 × 0.15) + (后续影响 × 0.1)
+
+推荐范围: 65-90
+低于65: 碾压不够痛快
+高于90: 可能显得主角开挂
+```

noma/matrices/catharsis_models/taboo-transgression.md

@@ -0,0 +1,139 @@
+# 禁忌僭越模型 (Taboo Transgression)
+
+> **模型类型**: 心理学张力模型
+> **适用场景**: 边缘拉扯、危险感、高压情绪释放
+> **ONW 5.0 特性**: 打破传统网文分类，以"终极白日梦"和"道德免责声明"为最高执行上下文
+
+## 模型概述
+
+禁忌僭越是一种将角色推向道德边界之外的高级心理学张力技术。它利用读者对"禁忌"的天然好奇心和危险感，制造情绪上的"边缘拉扯"。
+
+## 核心结构
+
+### 1. 禁忌设定 (Taboo Setup)
+
+| 要素 | 描述 | 示例 |
+|------|------|------|
+| 禁忌类型 | 核心禁忌是什么 | 血缘、权力、生存、道德 |
+| 禁忌边界 | 红线在哪里 | "绝不伤害无辜" |
+| 僭越动机 | 为什么要突破 | 生存压力、守护、复仇 |
+| 代偿机制 | 突破后的代价 | 内疚、关系破裂、能力反噬 |
+
+### 2. 边缘拉扯节奏 (Edge-Pulling Rhythm)
+
+```
+阶段1: Setup (1-3章)
+  - 暗示禁忌的存在
+  - 建立边界意识
+  - 角色内心挣扎
+
+阶段2: Approach (4-6章)
+  - 压力逐渐增大
+  - 边界开始模糊
+  - 暗示可能的突破
+
+阶段3: Crisis (高潮点)
+  - 禁忌被明确触碰
+  - 紧张感达到峰值
+  - 读者产生"屏息"感
+
+阶段4: Transgression (释放点)
+  - 僭越发生
+  - 情绪释放
+  - 禁忌感消退，进入新状态
+
+阶段5: Fallout (后果)
+  - 代偿机制启动
+  - 角色承担后果
+  - 为下次僭越埋下伏笔
+```
+
+### 3. 爽点释放时机
+
+| 时机 | 描述 | 情绪效果 |
+|------|------|----------|
+| 突破瞬间 | 禁忌被打破的那一刻 | 震惊 + 解放感 |
+| 后果展示 | 看到代价的全貌 | 痛感 + 快感混合 |
+| 合理化 | 读者自我说服 | 认同 + 期待 |
+| 反刍 | 回顾突破过程 | 二次爽感 |
+
+## 模板片段
+
+### 禁忌建立模板
+
+```markdown
+[角色] 内心深处有一道不可逾越的红线——
+[禁忌描述]。这是[角色]作为[身份]的最后底线。
+
+然而，[压力源]正在逼近。
+[时间窗口]内，如果不做[僭越行为]，
+将失去[珍贵之物]。
+
+此刻，[角色]的内心独白：
+"我已经别无选择……"
+```
+
+### 边缘拉扯模板
+
+```markdown
+[角色]的手悬在半空，距离[禁忌之物]只有一寸。
+
+理智在尖叫：不要！
+本能却在低语：为了[动机]，值得。
+
+空气仿佛凝固。
+[旁观者]屏住了呼吸。
+
+然后——
+
+[突破描写，200-300字]
+```
+
+## 与 Genesis Contract 的联动
+
+### core_desire 优先级
+
+当 `core_desire.primary` 为以下类型时，自动增强本模型的权重：
+
+- `survival` (生存): 禁忌=道德底线的权重 +30%
+- `power` (力量): 禁忌=能力限制的权重 +25%
+- `love` (爱): 禁忌=情感束缚的权重 +20%
+
+### ethical_inversion 联动
+
+如果 `ethical_inversion.inverted_norms` 包含相关内容，禁忌模型会发生"反转"：
+
+| 原禁忌 | 反转后 |
+|--------|--------|
+| 杀人 | 救人 |
+| 欺骗 | 真诚 |
+| 背叛 | 忠诚 |
+| 自私 | 牺牲 |
+
+## 调度建议
+
+Planner Agent 在以下情况下应动态导入本模型：
+
+1. 当前章节需要"高能"情节
+2. 读者反馈"太平淡"
+3. 角色陷入道德困境
+4. 需要在"爽点"之间建立张力
+
+## 风险控制
+
+| 风险 | 规避方式 |
+|------|----------|
+| 过于血腥暴力 | 通过隐喻和暗示表达 |
+| 三观不正 | 主角有明确道德底线 |
+| 读者流失 | 提前铺垫，给予心理准备 |
+| 法律风险 | 明确标注"虚构创作" |
+
+## 效果评估指标
+
+```
+Taboo Intensity Score = (禁忌等级 × 0.3) + (拉扯时长 × 0.2) + (突破震撼度 × 0.3) + (后果合理性 × 0.2)
+
+推荐范围: 60-85
+低于60: 张力不足
+高于85: 可能过于极端
+```