feat(backend): AI 反问澄清预检端点——refine 侧结构化 clarify（WFW-9 M1，路线A 两阶段）

润色「再沟通」意见含糊时先反问给选项（路线A：问题走独立非流式 JSON 预检端点，正文仍走
既有 refine 一字不改）。新增：
- ClarifyDecision/ClarifyQuestion/ClarifyOption 结构化 schema（既有 output-schema 处，供
  producer 与端点共用）；clarify_refine.md 教条（含糊→need_clarification+≤1问+2–4锚定选项+
  自由输入；明确→verification 放行；防循环）；注册 clarify_refine_spec(analyst 档,#24)+
  SCHEMA_CATALOG + 重生成金标准。
- clarify_node：build_clarify_request 纯函数(缓存前缀不含易变) + run_clarify（gateway.run
  结构化，判别/校验失败确定性回退 need_clarification=false，只读不写库）。
- POST /projects/{id}/chapters/{no}/refine/clarify → ClarifyDecision（analyst 网关，404/503，
  末尾 commit 记账）。**既有 refine 端点/RefineRequest/Response 完全未改**。
门禁绿：ruff/mypy 227/pytest 900(+test_clarify_spec/_node/style clarify)/alembic 无漂移。

packages/agents/ww_agents/schemas.py

@@ -674,3 +674,58 @@ class ProjectPlanResult(BaseModel):
     )
     ending_design: str = Field(default="", description="结局设计（收束方向与情绪落点）；缺则空串")
     tone: str = Field(default="", description="基调（全书情绪底色与阅读质感）；缺则空串")
+
+
+# ---- M1 refine · 预检澄清（clarify-refine；analyst；纯只读 writes=()）----
+
+
+class ClarifyOption(BaseModel):
+    """单个澄清选项：展示文案 + 选中回填值（锚定本段/本章的一种具体走法）。
+
+    `value` = 作者选中后折进 refine instruction 字符串的内容（零迁移，不落库）。
+    凑不出具体可区分选项时退化为空 options（`ClarifyQuestion.options=[]`），突出自由输入。
+    """
+
+    label: str = Field(description="展示文案（作者看到的选项标签）")
+    value: str = Field(description="选中后回填/折进 instruction 的具体走法内容")
+
+
+class ClarifyQuestion(BaseModel):
+    """单条澄清反问：问题 + 2–4 个锚定选项 + 自由输入兜底。
+
+    `options` 常规 2–4 个（锚定本段/本章的具体走法）；凑不出具体可区分选项时留空列表，
+    退化为纯自由输入。`allow_free_text` 常驻 True——自由输入永远兜底（作者可不选任一项）。
+    """
+
+    question: str = Field(description="反问的澄清问题（一句话，指向本段的分歧点）")
+    options: list[ClarifyOption] = Field(
+        default_factory=list,
+        description="2–4 个锚定本段/本章的具体走法选项；凑不出具体选项时为空列表",
+    )
+    allow_free_text: bool = Field(default=True, description="是否允许自由输入（常驻兜底）")
+
+
+class ClarifyDecision(BaseModel):
+    """润色预检澄清决策（结构化 LLM 输出 + API 响应）。
+
+    路线A 两阶段之「问题」阶段：仅判定「要不要反问」并给选项，**不改正文**（正文仍走
+    既有 refine 端点）。纯只读（`clarify_refine_spec.writes=()`，不变量 #3）。
+
+    **全字段给默认值守解析韧性**（仿 `StyleDriftReview` 降级范式）：LLM 漏产/畸形时
+    降级为 `need_clarification=false`（不问、直接放行 refine），绝不阻塞润色主链路。
+
+    - `need_clarification=false` → `questions` 为空、可给一句 `verification` 确认语；
+    - `need_clarification=true` → `questions` 恰 1 问（v1 硬上限）、`verification` 可空。
+    """
+
+    need_clarification: bool = Field(
+        default=False, description="是否需要向作者反问澄清（含糊/多走法→true；明确→false）"
+    )
+    questions: list[ClarifyQuestion] = Field(
+        default_factory=list,
+        description="反问清单（need_clarification=false 时为空；v1 硬上限 1 问）",
+    )
+    verification: str | None = Field(
+        default=None,
+        description="明确时的一句『我这样理解对吗』确认语（need_clarification=false 时给，可空）",
+    )