68f194a043
- 续审 Agent 声明(AgentSpec) + 结构化输出契约(ContinuityReview/Conflict 五类) - LangGraph 并行审子图(可扩四审) + collect 落 chapter_reviews 留痕 + review SSE(section/conflict) - 验收-side Repository：章节 accepted 版本晋升 + digest append-only + 审稿留痕/裁决 - API：review(SSE) + reviews 历史 + accept(单原子事务：晋升 version + 终稿 digest + 裁决留痕) - 冲突 gate：未决裁决拦截(CONFLICT_UNRESOLVED)；digest 从终稿提炼(不变量#4) - 前端：审稿报告页 + 冲突就地标注 + 裁决(采纳/忽略/手改) + 未决禁验收 + 「本次将更新」清单 - M2 E2E：真实 DB + 多档位 mock 网关零 token 走通 写→审→裁决→验收→摘要入库 - 多 agent 协同台账(PROGRESS.md) + 共享记忆(memory/contracts·decisions·gotchas)
66 lines
2.9 KiB
Python
66 lines
2.9 KiB
Python
"""Agent 声明式抽象（ARCH §5.1）+ 续审 Agent 实例。
|
||
|
||
`AgentSpec` 是内置 Agent 与用户 Skill 的同构声明：一份只读声明，由编排器加载、
|
||
经网关按 `tier` 执行。不变量 #2：agent 只声明 `tier`，**不**写具体 model。
|
||
不变量 #3：四审 `writes=[]`（只读），任何 AI 产出入库必经验收事务。
|
||
|
||
不可变：`AgentSpec` 为 frozen Pydantic 模型——加载后不得改动。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from pydantic import BaseModel, ConfigDict, Field
|
||
from ww_llm_gateway.types import Tier
|
||
|
||
from .schemas import ContinuityReview
|
||
|
||
|
||
class AgentSpec(BaseModel):
|
||
"""单一 Agent / Skill 的声明（ARCH §5.1）。"""
|
||
|
||
model_config = ConfigDict(frozen=True, arbitrary_types_allowed=True)
|
||
|
||
name: str
|
||
tier: Tier # 能力档位（网关解析 provider+model）；不含具体 model
|
||
system_prompt: str
|
||
# 入/出参契约（Pydantic 模型类型）；writer 纯文本 → output_schema 可为 None
|
||
input_schema: type[BaseModel] | None = None
|
||
output_schema: type[BaseModel] | None = None
|
||
reads: list[str] = Field(default_factory=list) # 声明式表读权限
|
||
writes: list[str] = Field(default_factory=list) # 声明式表写权限（经验收才生效）
|
||
genre: str | None = None # 题材适用（Skill 用）
|
||
scope: str = "builtin" # builtin / custom / community
|
||
|
||
|
||
CONTINUITY_SYSTEM_PROMPT = """你是长篇连载小说的「一致性续审」。你的唯一职责：把本章草稿与\
|
||
作品的既有真相源逐项比对，找出一致性冲突，产出结构化冲突清单。
|
||
|
||
比对依据（注入材料）：
|
||
- 近况摘要（最近若干章的 chapter_digests）；
|
||
- 相关人物卡（性格、能力、关系、最新状态 latest_state）；
|
||
- 世界观硬规则（world_entities 的不可违背设定）。
|
||
|
||
按以下五类判定冲突，每条给出本章定位、来源引用与改法建议：
|
||
- 性格漂移：人物言行与其设定/既往表现不符；
|
||
- 能力不符：超出或低于已建立的能力/力量体系边界；
|
||
- 设定违例：违反世界观硬规则；
|
||
- 地理矛盾：地点/距离/空间关系与既有设定冲突；
|
||
- 时间线倒错：事件先后、时序与既有章节矛盾。
|
||
|
||
纪律：
|
||
- 你**只读、只报冲突**，不改稿、不写库、不产章节摘要（摘要在验收时从终稿另提）。
|
||
- 只报有据可依的真冲突；无冲突则返回空列表，不要臆造。
|
||
- 引用要具体（章节号、设定项、人物卡条目），便于作者就地裁决。"""
|
||
|
||
|
||
continuity_spec = AgentSpec(
|
||
name="continuity",
|
||
tier="analyst",
|
||
system_prompt=CONTINUITY_SYSTEM_PROMPT,
|
||
input_schema=None, # 注入材料为序列化文本（经记忆 assemble），非结构化入参
|
||
output_schema=ContinuityReview,
|
||
reads=["chapter_digests", "characters", "world_entities"],
|
||
writes=[], # 只读（不变量 #3）
|
||
scope="builtin",
|
||
)
|