1652ad9d20
润色「再沟通」意见含糊时先反问给选项（路线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 无漂移。
76 lines
2.6 KiB
Python
76 lines
2.6 KiB
Python
"""文风学习 + 回炉端点的请求/响应 schema（C3 扩 / ARCH §7.2 / UX §6.9 / §8.3）。
|
||
|
||
snake_case（命名契约，见 memory/gotchas）。前端经 OpenAPI→TS 客户端消费——改字段
|
||
须 `pnpm gen:api` 重生成。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import uuid
|
||
from typing import Literal
|
||
|
||
from pydantic import BaseModel, Field
|
||
|
||
|
||
class StyleLearnRequest(BaseModel):
|
||
"""学文风：上传样本正文（前端可读文件转文本）+ 模式（首学 / 更新）。"""
|
||
|
||
samples: list[str] = Field(min_length=1)
|
||
mode: Literal["create", "update"] = "create"
|
||
|
||
|
||
class StyleLearnResponse(BaseModel):
|
||
"""学文风受理：返回 job_id（长任务，走 `GET /jobs/{id}` 轮询）。"""
|
||
|
||
job_id: uuid.UUID
|
||
|
||
|
||
class DimensionEntry(BaseModel):
|
||
"""单个文风维度：名称 + 判定值 + 原文证据摘录（强类型，替代裸 dict[str, Any]）。"""
|
||
|
||
name: str
|
||
value: str
|
||
evidence: list[str] = Field(default_factory=list)
|
||
|
||
|
||
class StyleFingerprintResponse(BaseModel):
|
||
"""最新文风指纹（`GET /style`）：完整 16 维（名称/值/证据）+ 版本（对齐 UX §6.9）。
|
||
|
||
DB 存两列并行 dict（`{name:value}` + `{name:[evidence]}`）；响应合并为
|
||
`list[DimensionEntry]`，给 TS 客户端强类型（替代弱类型 `dict[str, Any]`）。
|
||
"""
|
||
|
||
dimensions: list[DimensionEntry] = Field(default_factory=list)
|
||
version: int
|
||
|
||
|
||
class RefineRequest(BaseModel):
|
||
"""回炉：重写选中段（可选改写指令）。"""
|
||
|
||
segment: str = Field(min_length=1)
|
||
instruction: str | None = None
|
||
|
||
|
||
class RefineResponse(BaseModel):
|
||
"""回炉结果：原段 + 重写段（不写库，作者采纳经既有 draft 自动保存合入）。"""
|
||
|
||
original: str
|
||
refined: str
|
||
|
||
|
||
# 上界：选段/意见文本长度守卫（防超长入参空跑 LLM；预检只看本段，无需整章）。
|
||
_MAX_CLARIFY_SEGMENT_LEN = 20000
|
||
_MAX_CLARIFY_INSTRUCTION_LEN = 2000
|
||
|
||
|
||
class RefineClarifyRequest(BaseModel):
|
||
"""润色预检澄清：选段 + 再沟通意见（WFW-9 M1 路线A 两阶段之「问题」阶段）。
|
||
|
||
与 `RefineRequest` 独立——预检只判「意见清不清楚」，不改正文。`instruction` 为作者的
|
||
再沟通意见（可空/极短，正是触发反问的场景）；带长度上界防超长入参。响应=`ClarifyDecision`
|
||
（在 ww_agents，端点直接返回，供前端 gen:api 生成强类型客户端）。
|
||
"""
|
||
|
||
segment: str = Field(min_length=1, max_length=_MAX_CLARIFY_SEGMENT_LEN)
|
||
instruction: str = Field(default="", max_length=_MAX_CLARIFY_INSTRUCTION_LEN)
|