novel-writer-cli 0.2.1 → 0.5.0

package/skills/continue/references/context-contracts.md

@@ -31,13 +31,31 @@ chapter_writer_manifest = {
   },
   concurrent_state: {str: str},         # 其他活跃线一句话状态
   transition_hint: obj | null,          # 切线过渡
-  hard_rules_list: [str],              # L1 禁止项列表（已格式化）
+  hard_rules_list: [str],              # L1 禁止项列表（仅 established / 缺失 canon_status 的 hard 规则；即使为空也显式提供）
+  world_rules_context_degraded?: bool, # 可选：world/rules.json 存在但 CLI 读取/解析降级；此时 hard_rules_list 可能不完整，应直接读取 paths.world_rules 复核
+  planned_rules_info?: [obj],          # 可选：planned L1 规则（hard/soft 都保留原 constraint_type，仅供伏笔/铺垫参考，不绑定）
   foreshadowing_tasks: [obj],          # 本章伏笔任务子集
   foreshadow_light_touch_tasks?: [     # 可选：伏笔沉默超阈值时的“轻触提醒”（非剧透、不兑现）；为空则省略该字段
     {id: str, scope: str, status: str, chapters_since_last_update: int, instruction: str}
   ],
   foreshadow_light_touch_degraded?: bool, # 可选：若为 true 表示“轻触提醒”注入降级（如伏笔数据不可读），不等同于“没有需要提醒的条目”
   ai_blacklist_top10: [str],           # 有效黑名单前 10 词
+  statistical_targets?: {              # 可选：6 维统计目标（style-profile → CW 的软约束）
+    sentence_length_std_dev: {target: number | null, fallback_range: [number, number], fallback_applied: bool},
+    paragraph_length_cv: {target: number | null, fallback_range: [number, number], fallback_applied: bool},
+    vocabulary_diversity: {target: "high|medium|low", source_field: "vocabulary_richness", fallback_applied: bool},
+    narration_connectors: {target: 0, source_field: "ai-blacklist.category_metadata.narration_connector", fallback_applied: false, note: str},
+    register_mixing: {target: "high|medium|low", fallback_applied: bool},
+    emotional_arc: {target: "high|medium|low", source_field: "emotional_volatility", fallback_applied: bool},
+  },
+  genre_overrides?: {                  # 可选：按 brief 显式覆写说明 / 题材字段派生的结构阈值
+    genre: str,
+    source: {brief: "brief.md", mode: "brief_override_notes" | "brief_genre_fallback"},
+    explicit_notes: str | null,
+    paragraph_structure: {single_sentence_ratio: {min: number, max: number}, max_paragraph_chars: number},
+    punctuation_rhythm: {ellipsis_max_per_chapter: number, exclamation_max_per_chapter: number, em_dash_max_per_chapter: 0},
+    notes: [str],
+  },
   style_drift_directives: [str] | null, # 漂移纠偏指令（active 时注入）
   engagement_report_summary?: obj,     # 可选：爽点/信息密度窗口报告摘要（logs/engagement/latest.json 裁剪）
   promise_ledger_report_summary?: obj, # 可选：承诺台账窗口报告摘要（logs/promises/latest.json 裁剪）
@@ -48,6 +66,7 @@ chapter_writer_manifest = {
   paths: {
     style_profile: "style-profile.json",                              # 必读（含 style_exemplars + writing_directives）
     platform_profile: "platform-profile.json",                        # 可选（平台字数/钩子策略/信息负载等）
+    platform_writing_guide: "platform-writing-guide.md",              # 可选（平台节奏/对话比例/钩子/情绪回报/文风要求）
     style_drift: "style-drift.json",                                  # 可选
     chapter_contract: "volumes/vol-{V:02d}/chapter-contracts/chapter-{C:03d}.json",
     volume_outline: "volumes/vol-{V:02d}/outline.md",
@@ -56,15 +75,31 @@ chapter_writer_manifest = {
     recent_summaries: ["summaries/chapter-{C-1:03d}-summary.md", ...], # 近 3 章
     storyline_memory: "storylines/{storyline_id}/memory.md",           # 可选
     adjacent_memories: ["storylines/{adj_id}/memory.md", ...],         # 可选
-    character_contracts: ["characters/active/{slug}.json", ...],       # 裁剪后选取
+    character_profiles?: ["characters/active/{slug}.md", ...],         # 可选：裁剪后选取（仅 established / 缺失 canon_status）
+    character_contracts?: ["characters/active/{slug}.json", ...],      # 可选：裁剪后选取（仅 established / 缺失 canon_status；当前章需遵守的 L2 约束）
+    planned_character_profiles?: ["characters/active/{slug}.md", ...],  # 可选：planned 角色档案（仅供铺垫/预告参考）
+    planned_character_contracts?: ["characters/active/{slug}.json", ...], # 可选：planned 角色契约（仅供铺垫/预告参考，不绑定）
+    # 若 chapter_contract 显式命中角色，则走 preferred 路径，不受 fallback 的 15 角色上限约束；
+    # 15 角色上限仅适用于未命中时的回退裁剪（draft 共享 active/planned 配额）。
     project_brief: "brief.md",
-    writing_methodology: "skills/novel-writing/references/style-guide.md",  # 可选
+    style_guide: "skills/novel-writing/references/style-guide.md",           # 可选
     engagement_report_latest: "logs/engagement/latest.json",                # 可选（如存在；用于读取完整报告）
     promise_ledger_report_latest: "logs/promises/latest.json",              # 可选（如存在；用于读取完整报告）
   }
 }
 ```
 
+**`statistical_targets` 默认值约定：**
+- `sentence_length_std_dev` 缺失 / `null` → `[8, 18]`
+- `paragraph_length_cv` 缺失 / `null` → `[0.4, 1.2]`
+- `vocabulary_diversity` / `register_mixing` / `emotional_arc` 缺失 / `null` → `"medium"`
+- `narration_connectors` 始终为 `0`（叙述连接词目标值）
+
+**`genre_overrides` 来源优先级：**
+1. `brief.md` 中显式写出的类型覆写
+2. `brief.md` 的题材字段（命中 style-guide §2.11 的默认覆写）
+3. 未命中时省略该字段，ChapterWriter 回退到通用阈值
+
 ### 修订模式追加字段
 
 ```
@@ -141,10 +176,30 @@ quality_judge_manifest = {
   chapter: int,
   volume: int,
   chapter_outline_block: str,
-  hard_rules_list: [str],
+  hard_rules_list: [str],              # 仅 established / 缺失 canon_status 的 hard 规则（即使为空也显式提供）
+  world_rules_context_degraded?: bool, # 可选：world/rules.json 存在但 CLI 读取/解析降级；此时需直接读取 paths.world_rules 复核
   blacklist_lint: obj | null,                    # scripts/lint-blacklist.sh 输出
   ner_entities: obj | null,                      # scripts/run-ner.sh 输出
   continuity_report_summary: obj | null,         # logs/continuity/latest.json 裁剪
+  statistical_profile?: {                 # 可选：deterministic lint + heuristic 聚合的 7 指标 profile
+    source: "deterministic_lint+heuristic",
+    chapter_path: str,
+    blacklist_hit_rate: number | null,
+    sentence_repetition_rate: number,
+    sentence_length_std_dev: number,
+    paragraph_length_cv: number,
+    vocabulary_diversity_score: number,
+    vocabulary_richness_estimate: "high" | "medium" | "low",
+    narration_connector_count: number | null,
+    humanize_technique_variety: number,
+  },
+  structural_rule_violations?: [          # 可选：lint-structural 输出的结构违规
+    {rule_id: str, severity: "warning" | "error", location?: obj, description: str, suggestion?: str}
+  ],
+  blacklist_lint_degraded?: bool,         # 可选：ai-blacklist 存在但 deterministic lint 运行失败
+  structural_rule_violations_degraded?: bool, # 可选：structural lint 脚本存在但运行失败
+  golden_chapter_gates?: obj,                    # 可选：chapter <= 3 时注入的当前平台黄金三章硬门控
+  genre_golden_standards?: obj,                  # 可选：chapter <= 3 且 brief.genre 命中时注入的题材特定 minimum_thresholds/focus_dimensions/criteria
 
   # ── paths ──
   paths: {
@@ -154,8 +209,10 @@ quality_judge_manifest = {
     chapter_contract: "volumes/vol-{V:02d}/chapter-contracts/chapter-{C:03d}.json",
     world_rules: "world/rules.json",                                  # 可选
     prev_summary: "summaries/chapter-{C-1:03d}-summary.md",           # 可选（首章无）
-    character_profiles: ["characters/active/{slug}.md", ...],          # 裁剪后选取（叙述档案）
-    character_contracts: ["characters/active/{slug}.json", ...],       # 裁剪后选取（L2 结构化契约）
+    character_profiles?: ["characters/active/{slug}.md", ...],         # 可选：裁剪后选取（叙述档案；仅 established / 缺失 canon_status）
+    character_contracts?: ["characters/active/{slug}.json", ...],      # 可选：裁剪后选取（L2 结构化契约；仅 established / 缺失 canon_status；planned / deprecated 不进入 judge packet）
+    # 若 chapter_contract 显式命中角色，则走 preferred 路径，不受 fallback 的 15 角色上限约束；
+    # judge 只有在未命中时才回退到最多 15 个 established 角色。
     storyline_spec: "storylines/storyline-spec.json",                  # 可选
     storyline_schedule: "volumes/vol-{V:02d}/storyline-schedule.json", # 可选
     cross_references: "staging/state/chapter-{C:03d}-crossref.json",
@@ -164,6 +221,14 @@ quality_judge_manifest = {
 }
 ```
 
+### fallback 约定
+
+- `style-profile.json.sentence_length_std_dev == null` → 使用 fallback range `8-18`
+- `style-profile.json.paragraph_length_cv == null` → 使用 fallback range `0.4-1.2`
+- `style-profile.json.vocabulary_richness / register_mixing / emotional_volatility == null` → 统一回退到 `"medium"`
+- `narration_connectors` 当前没有独立 style-profile 字段，固定按 `0` 命中约束，并由 `ai-blacklist.category_metadata.narration_connector` + `writing_directives` 辅助解释
+- `genre_overrides` 优先读取 `brief.md` 的“覆写说明”；未填写时回退到 `brief.md` 的题材字段默认预设
+
 ---
 
 另见：`continuity-checks.md`（NER schema + 一致性报告 schema + LS-001 结构化输入约定）。

package/skills/continue/references/periodic-maintenance.md

@@ -3,7 +3,7 @@
 ## AI 黑名单动态维护（不阻断）
 
 - 从 eval_used.anti_ai.blacklist_update_suggestions[] 读取新增候选（必须包含：phrase + count_in_chapter + examples）
-- 增长上限检查：若 `words[]` 长度 >= 80，跳过自动追加，仅记录到 `update_log[]`（source="auto_skipped_cap"），并在 `/novel:start` 质量回顾中提示用户审核黑名单规模
+- 增长上限检查：若 `words[]` 长度 >= `max_words=250`，跳过自动追加，仅记录到 `update_log[]`（source="auto_skipped_cap"），并在 `/novel:start` 质量回顾中提示用户审核黑名单规模
 - 自动追加门槛（保守，避免误伤）：
   - `confidence in {medium, high}` 且 `count_in_chapter >= 3` -> 才允许自动追加
   - 其余仅记录为"候选建议"，不自动写入（可在 `/novel:start` 质量回顾中提示用户手动处理）
@@ -21,6 +21,17 @@
   - 用户可手动编辑 `ai-blacklist.json` 的 `words[]/whitelist[]`
   - 若用户删除某词但不希望未来被自动再加回，请将其加入 `whitelist[]`（系统不得自动加入 whitelist 内词条）
 
+
+## 人性化技法跨章追踪（不阻断）
+
+- 追踪存储：`logs/anti-ai/technique-history.json`
+- 首次运行时若目录或文件不存在，应自动创建目录并以空数组/空记录初始化
+- 单条记录格式：`{"chapter_id": "vol-01/chapter-001", "techniques_used": ["thought_interrupt", "mundane_detail"]}`
+- 写入时机：章节完成后，将本章实际使用的 `humanize_technique` 记录 append 到历史文件
+- 告警规则：若同一技法连续 3 章及以上出现，记为“重复使用告警”，提示 ChapterWriter / StyleRefiner 在后续章节错开该技法
+- 告警级别：仅 warning，不阻断写作；目标是防止“固定技法套餐”被连续刷章
+- 建议保留最近 50 章记录即可，超出可按时间裁剪旧数据
+
 ## 风格漂移检测与纠偏（每 5 章触发）
 
 - 触发条件：last_completed_chapter % 5 == 0

package/skills/novel-writing/references/quality-rubric.md

@@ -42,51 +42,104 @@
 
 ## 4. 沉浸感（immersion）— 权重 0.15
 
-评估画面感、氛围营造、详略得当。
+评估画面感、氛围营造、文笔与用词是否顺滑、详略是否得当，以及高压段之间是否给读者保留了必要的消化空间。
 
 | 分数 | 标准 |
 |------|------|
-| 5 | 文笔流畅优美，用词精准传神，修辞恰到好处 |
-| 4 | 文笔流畅，用词准确，偶有平淡之处 |
-| 3 | 文笔通顺，但有重复用词或表达不够精准 |
-| 2 | 文笔平庸，用词单一，有明显语病 |
-| 1 | 语句不通，病句频出，严重影响阅读 |
+| 5 | 画面感强，文笔流畅，用词精准，详略拿捏准确；高压段之间有自然过渡，读者能顺畅沉进去 |
+| 4 | 沉浸感良好，文笔顺畅，偶有平淡；大多数高压节点后都有缓冲或呼吸段 |
+| 3 | 画面可读，文笔基本通顺，但部分高压场景切换过急，读者消化空间不足 |
+| 2 | 文笔发涩或表达重复，沉浸感反复被打断；高压场景频繁硬切，明显缺乏过渡 |
+| 1 | 语句不通或场景组织严重影响阅读，沉浸感持续断裂 |
+
+补充口径：
+- 若战斗 / 决策 / 冲突场景后立刻切入下一个高压场景，无过渡或消化空间，可视情况扣 **0.5 分**
+- `reason` 中应明确标注“高压场景间缺乏过渡，沉浸感断裂”并指出具体段落
+- 上述问题默认也视作 yellow / suggestion，不单独触发修订
 
 ## 5. 节奏（pacing）— 权重 0.08
 
-评估冲突强度、情节张弛、阅读节奏。
+评估冲突强度、情节张弛、阅读节奏，以及是否具备必要的结构呼吸感。
 
 | 分数 | 标准 |
 |------|------|
-| 5 | 节奏精准，张弛有度，推进与留白恰到好处 |
-| 4 | 节奏流畅，冲突有吸引力，偶有拖沓 |
-| 3 | 节奏尚可，但部分段落拖沓或过于急促 |
-| 2 | 节奏失衡，明显拖沓或跳跃 |
-| 1 | 节奏混乱，无法正常推进 |
+| 5 | 节奏精准，张弛有度，推进与留白恰到好处；功能性停留分布自然 |
+| 4 | 节奏流畅，冲突有吸引力，偶有偏紧、偏松或轻微拖沓，但整体有呼吸空间 |
+| 3 | 节奏尚可，但部分段落过于急促，或功能性停留过多导致拖沓；留白落点略生硬 |
+| 2 | 节奏失衡，明显过密、拖沓或跳跃；整章几乎只剩推进，或停留堆积成灌水 |
+| 1 | 节奏混乱，无法正常推进；要么缺少基本留白，要么留白失控到拖垮推进 |
+
+补充口径：
+- 若全章每个段落都直接推进情节、没有任何功能性停留，可在 `reason` 中标注“结构过密，缺乏呼吸感”，建议性扣 **0.5 分**
+- 上述问题默认视作 yellow / suggestion，不单独触发修订
 
 ## 6. 风格自然度（style_naturalness）— 权重 0.15
 
-评估去 AI 化效果，基于可量化指标。
+评估去 AI 化效果。**主评分表使用 7 个稳定指标的三区判定（green / yellow / red）**；当上下文额外提供 `em_dash_count` / `sentence_pattern_score` / `simile_density` / `dialogue_distinguishability` / `ellipsis_density` / `exclamation_density` 等扩展信号时，可在 `reason` 中加重说明，但 `score` 仍先按下表与 `structural_rule_violations` 罚分规则落地。若连这 7 项都拿不齐，则回退到 legacy 4 指标兼容表。
+
+### 6.1 七指标三区
+
+| # | 指标 | green（人类范围） | yellow（边界） | red（AI 特征） |
+|---|------|------------------|----------------|----------------|
+| 1 | `blacklist_hit_rate` | 0-1 次/千字 | 1-3 次/千字 | >3 次/千字 |
+| 2 | `sentence_repetition_rate` | 相邻 5 句中 0-1 个重复句式 | 相邻 5 句中 2 个重复句式 | 相邻 5 句中 ≥3 个重复句式 |
+| 3 | `sentence_length_std_dev` | 8-18，或落在 style-profile 目标附近 | 6-8 或 18-24 | <6（过匀） |
+| 4 | `paragraph_length_cv` | 0.4-1.2，或落在 style-profile 目标附近 | 0.3-0.4 或 1.2-1.5 | <0.3（过匀） |
+| 5 | `vocabulary_diversity_score` | 当前仅有枚举时 `vocabulary_richness=high`；若提供数值则 ≥0.45 | 当前仅有枚举时 `medium`；若提供数值则 0.35-0.45 | 当前仅有枚举时 `low`；若提供数值则 <0.35 |
+| 6 | `narration_connector_count` | 0 | 1 个孤立命中（仍建议改写） | ≥2 个，或连续多段靠连接词推进 |
+| 7 | `humanize_technique_variety` | 单章自然出现 ≥1 种不同技法，且无刷项感 | 0，且其余指标未出现 red | 0，且同时伴随至少 1 项句式 / 连接词等其它 red |
+
+### 6.2 zone → score 映射
+
+| 区域分布 | 分数 |
+|----------|------|
+| 全部 green | 5 |
+| 1-2 个 yellow，且无 red | 4 |
+| ≥3 个 yellow，或恰有 1 个 red | 3 |
+| 2-3 个 red | 2 |
+| ≥4 个 red | 1 |
+
+### 6.3 `structural_rule_violations` 子分数
+
+`structural_rule_violations` 来自确定性 lint（L2/L3/L5/L6）。它**不是独立维度**，而是对 `style_naturalness` 的附加罚分锚点：
+
+| 违规数 | 区域 | 使用方式 |
+|--------|------|----------|
+| 0 | green | 不额外扣分 |
+| 1-2 | yellow | 按“额外 +1 个 yellow”处理，再回到 zone → score 主映射表 |
+| ≥3 | red | 按“额外 +1 个 red”处理；若违规集中在 `error` 级规则，可进一步降到 2 分 |
+
+### 6.4 Legacy Fallback（向后兼容）
+
+当正文破损、style-profile 缺失，或当前上下文只能稳定拿到旧 4 指标时，允许退回旧表：
+
+| 分数 | AI 黑名单命中率 | 句式重复率（相邻 5 句） | 破折号频率 | style-profile 匹配度 |
+|------|----------------|----------------------|------------|---------------------|
+| 5 | 0 次/千字 | 0 个重复句式 | 0 处 | 句长、对话比、修辞完全匹配 |
+| 4 | 1-2 次/千字 | ≤1 个重复句式 | 0 处 | 大部分匹配，轻微偏差 |
+| 3 | 3-4 次/千字 | 2 个重复句式 | 0 处 | 部分匹配，有偏移 |
+| 2 | 5-7 次/千字 | ≥3 个重复句式 | ≥1 处 | 明显不匹配 |
+| 1 | >7 次/千字 | 频繁重复 | 多处出现 | 完全不匹配 |
 
-| 分数 | AI 黑名单命中率 | 句式重复率（相邻 5 句） | style-profile 匹配度 |
-|------|----------------|----------------------|---------------------|
-| 5 | 0 次/千字 | 0 个重复句式 | 句长、对话比、修辞完全匹配 |
-| 4 | 1-2 次/千字 | ≤ 1 个重复句式 | 大部分匹配，轻微偏差 |
-| 3 | 3-4 次/千字 | 2 个重复句式 | 部分匹配，有偏移 |
-| 2 | 5-7 次/千字 | ≥ 3 个重复句式 | 明显不匹配 |
-| 1 | > 7 次/千字 | 频繁重复 | 完全不匹配 |
+> 说明：legacy 4 指标只用于兼容旧项目；新项目优先使用七指标三区 + `structural_rule_violations`。
 
 ## 7. 情感冲击（emotional_impact）— 权重 0.08
 
-评估情感起伏、读者代入感、情绪共鸣。
+评估情感起伏、读者代入感、情绪共鸣，以及关键节点是否提供了足够的**内心活动锚点**。注意：这里要同时防两种极端——一端是 `SP-07` 式情绪标签句，另一端是完全没有内心活动、只剩纯动作记录流。
 
 | 分数 | 标准 |
 |------|------|
-| 5 | 情感冲击强烈，读者强代入感，情绪共鸣持久 |
-| 4 | 情感有起伏，读者能投入，共鸣感良好 |
-| 3 | 情感起伏不明显，代入感一般 |
-| 2 | 情感平板，难以产生代入感 |
-| 1 | 情感缺失，读者无法投入 |
+| 5 | 情感冲击强烈，读者强代入感，情绪共鸣持久；关键决策/重大信息节点前后都能看到自然的感官侵入、碎片思绪或生理反应，不靠情绪标签硬说 |
+| 4 | 情感有起伏，读者能投入，共鸣感良好；大部分关键节点有内心活动锚点，偶有轻微稀薄但不影响整体 |
+| 3 | 情感起伏不明显，代入感一般；存在关键节点前后 3 句缺少内心活动，或偶发连续 5 句纯动作流，但尚未大面积拖垮体验 |
+| 2 | 情感平板，难以产生代入感；多处关键节点缺少内心活动锚点，或全章出现 ≥3 处连续 5 句纯动作流 |
+| 1 | 情感缺失，读者无法投入；高压节点几乎都只有外显动作记录，既无有效内心活动，也常退回情绪标签或解释型旁白 |
+
+补充扣分口径：
+- 这里“处”按“每个应触发却缺失锚点的关键节点”计算。关键决策 / 重大信息 / 高压节点前后 3 句无内心活动 → `emotional_impact` 至少扣 **0.5 分/处**
+- 全章出现 **≥3 处** 连续 5 句纯动作流 → 额外扣 **1 分**
+- 上述扣分可以叠加，但 `emotional_impact` 最低只降到 **1 分**
+- `reason` 中必须标出缺失位置；生理反应、感官侵入、碎片思绪、思维中断、自我纠正都属于合法内心活动，不应按 SP-07 误判为情绪标签
 
 ## 8. 故事线连贯（storyline_coherence）— 权重 0.08