feat: M4 文风 + M5 生成/多provider/Skill + Kimi Code 订阅接入 + 本地联调修复

M4(文风): style-auditor 双轨(提取指纹/漂移第四审)+ jobs 长任务框架(zombie reaper) + 回炉 refine + GET /style read-back。
M5(生成+扩展): worldbuilder/character-gen(入库 continuity 409 gate + partition_writes 白名单 + schema→JSONB 形变);
  网关多 provider 回退链/熔断/能力降级(Anthropic/Gemini 适配器);Skill registry + 表权限沙箱 + 规则;
  前端 角色生成器/世界观/Codex/规则页/技能库/⌘K 命令面板。
K1(Kimi Code 订阅接入): OAuth device-flow(kimi-code)+ 静态 Console key(kimi-code-key)两路径;
  coding 端点 KimiCLI 伪造头(实测 UA allow-list 门禁,缺则 403)+ JSON 模式结构化(thinking ⊥ tool_choice)。
本地联调修复: CORS 中间件;assemble 注入 premise+「写第N章」指令(修空 prompt 400);
  GET /outline·/draft read-back + 大纲/工作台/审稿页重载;写页 client/server 常量边界 + notFound 健壮化;
  字数 toLocaleString locale 水合;审稿页终稿从已存草稿 seed(修 accept 422)。
门禁: backend ruff/mypy(157)/alembic 无漂移/pytest 451 · frontend lint/tsc/vitest/build。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Yaojia Wang
2026-06-20 10:39:58 +02:00
parent 5fb7bfb1de
commit 765dbdfbd4
161 changed files with 17330 additions and 208 deletions

View File

@@ -0,0 +1,183 @@
"""T5.1 worldbuilder + character-gen 契约测试spec + schemaC6 扩 / ARCH §5.4 §6.5)。
契约测试——构造符合 schema 的 mock 响应校验字段、tier、读写权限。
worldbuilder`{entities:[{type,name,rules}]}` 硬规则显式写手档reads=projects
character-gen`{cards:[{name,role,traits,backstory,arc,speech_tics,tags,relations}]}`
写手档reads=world_entities+characterswrites=characters。不联网、无 DB。
"""
from __future__ import annotations
import pytest
from pydantic import ValidationError
from ww_agents import (
AgentSpec,
CharacterCard,
CharacterGenResult,
CharacterRelation,
WorldEntityCard,
WorldGenResult,
character_gen_spec,
worldbuilder_spec,
)
# ---- WorldGenResult schemaworldbuilder----
def test_world_gen_parses_mock_response() -> None:
# Arrange模拟网关 instructor 校验后的结构化世界观产出(硬规则显式)
mock = {
"entities": [
{
"type": "力量体系",
"name": "九转炼气",
"rules": ["只能逐境突破,不可越级", "突破必有反噬代价"],
},
{"type": "地理", "name": "无雨城", "rules": ["终年无雨"]},
]
}
# Act
result = WorldGenResult.model_validate(mock)
# Assert
assert len(result.entities) == 2
assert result.entities[0].type == "力量体系"
assert result.entities[0].name == "九转炼气"
assert result.entities[0].rules == ["只能逐境突破,不可越级", "突破必有反噬代价"]
assert result.entities[1].rules == ["终年无雨"]
def test_world_gen_defaults_to_empty_entities() -> None:
assert WorldGenResult().entities == []
def test_world_entity_rules_default_empty() -> None:
card = WorldEntityCard.model_validate({"type": "势力", "name": "天剑宗"})
assert card.rules == []
def test_world_entity_requires_type_and_name() -> None:
with pytest.raises(ValidationError):
WorldEntityCard.model_validate({"type": "势力"})
# ---- CharacterGenResult schemacharacter-gen----
def test_character_gen_parses_mock_response() -> None:
mock = {
"cards": [
{
"name": "苏黎",
"role": "对手",
"traits": ["表面冷漠", "内心挣扎"],
"backstory": "出身敌对势力,幼年遭灭门。",
"arc": "复仇者 → 动摇 → 救赎",
"speech_tics": ["惯用反问", "句末带『罢了』"],
"tags": ["亦正亦邪", "宿命纠葛"],
"relations": [{"name": "主角", "kind": "宿敌", "note": "灭门之仇"}],
}
]
}
result = CharacterGenResult.model_validate(mock)
assert len(result.cards) == 1
card = result.cards[0]
assert card.name == "苏黎"
assert card.role == "对手"
assert card.traits == ["表面冷漠", "内心挣扎"]
assert card.speech_tics == ["惯用反问", "句末带『罢了』"]
assert card.relations[0].name == "主角"
assert card.relations[0].kind == "宿敌"
assert card.relations[0].note == "灭门之仇"
def test_character_gen_defaults_to_empty_cards() -> None:
assert CharacterGenResult().cards == []
def test_character_card_optional_collections_default_empty() -> None:
card = CharacterCard.model_validate(
{"name": "", "role": "工具人", "backstory": "无名小卒", "arc": "始终如一"}
)
assert card.traits == []
assert card.speech_tics == []
assert card.tags == []
assert card.relations == []
def test_character_card_requires_core_fields() -> None:
# name/role/backstory/arc 为必填
with pytest.raises(ValidationError):
CharacterCard.model_validate({"name": "", "role": "对手"})
def test_character_relation_note_optional() -> None:
rel = CharacterRelation.model_validate({"name": "师父", "kind": "师徒"})
assert rel.note is None
# ---- worldbuilder_spec 声明 ----
def test_worldbuilder_spec_is_writer_tier() -> None:
# 不变量 #2世界观创意用写手档只声明 tier
assert worldbuilder_spec.tier == "writer"
assert worldbuilder_spec.name == "worldbuilder"
def test_worldbuilder_spec_reads_projects_writes_world_entities() -> None:
assert worldbuilder_spec.reads == ["projects"]
assert worldbuilder_spec.writes == ["world_entities"]
def test_worldbuilder_spec_output_schema() -> None:
assert worldbuilder_spec.output_schema is WorldGenResult
def test_worldbuilder_spec_prompt_documents_hard_rules() -> None:
# 硬规则须显式(供 continuity 校验引用——system_prompt 必须强调
assert "硬规则" in worldbuilder_spec.system_prompt
# ---- character_gen_spec 声明 ----
def test_character_gen_spec_is_writer_tier() -> None:
assert character_gen_spec.tier == "writer"
assert character_gen_spec.name == "character-gen"
def test_character_gen_spec_reads_world_and_characters() -> None:
# reads=world_entities+characters约束 + 防雷同对照writes=characters
assert character_gen_spec.reads == ["world_entities", "characters"]
assert character_gen_spec.writes == ["characters"]
def test_character_gen_spec_output_schema() -> None:
assert character_gen_spec.output_schema is CharacterGenResult
def test_character_gen_spec_prompt_documents_anti_duplication() -> None:
# M5-a 群像防雷同prompt 必须注入「已生成卡 + 已有角色」差异化要求
prompt = character_gen_spec.system_prompt
assert "已有角色" in prompt
assert "已生成卡" in prompt
assert "防雷同" in prompt
# ---- 共性immutable + 是 AgentSpec ----
def test_generation_specs_are_agent_specs() -> None:
assert isinstance(worldbuilder_spec, AgentSpec)
assert isinstance(character_gen_spec, AgentSpec)
def test_generation_specs_are_immutable() -> None:
with pytest.raises(ValidationError):
worldbuilder_spec.tier = "analyst"
with pytest.raises(ValidationError):
character_gen_spec.tier = "analyst"

View File

@@ -0,0 +1,191 @@
"""T4.2 style-auditor 双轨契约测试style_extract / style_drift / refiner spec + schemaC6 扩)。
契约测试——构造符合 schema 的 mock 响应校验字段、tier、双轨读写权限。
提取轨 `StyleFingerprintResult`16 维带证据);第四审 `StyleDriftReview`(段级相似度);
回炉 `refiner_spec`writer 纯文本output_schema=None。不联网、无 DB。
"""
from __future__ import annotations
import pytest
from pydantic import ValidationError
from ww_agents import (
AgentSpec,
StyleDimension,
StyleDriftReview,
StyleDriftSegment,
StyleFingerprintResult,
refiner_spec,
style_drift_spec,
style_extract_spec,
)
# ---- StyleFingerprintResult schema提取轨----
def test_style_fingerprint_parses_mock_response() -> None:
# Arrange模拟网关 instructor 校验后的结构化指纹产出(每维带原文证据)
mock = {
"dimensions": [
{
"name": "句长节奏",
"value": "短句为主、节奏明快",
"evidence": ["他一刀劈下。血溅三尺。", "风停了。"],
},
{
"name": "叙事人称",
"value": "第三人称限知",
"evidence": ["他不知道门后有什么。"],
},
]
}
# Act
fp = StyleFingerprintResult.model_validate(mock)
# Assert
assert len(fp.dimensions) == 2
assert fp.dimensions[0].name == "句长节奏"
assert fp.dimensions[0].evidence == ["他一刀劈下。血溅三尺。", "风停了。"]
assert fp.dimensions[1].value == "第三人称限知"
def test_style_fingerprint_defaults_to_empty_dimensions() -> None:
assert StyleFingerprintResult().dimensions == []
def test_style_dimension_evidence_defaults_empty() -> None:
dim = StyleDimension.model_validate({"name": "用词", "value": "古雅"})
assert dim.evidence == []
def test_style_dimension_requires_name_and_value() -> None:
with pytest.raises(ValidationError):
StyleDimension.model_validate({"name": "用词"})
# ---- StyleDriftReview schema第四审----
def test_style_drift_parses_mock_response() -> None:
mock = {
"score": 72,
"segments": [
{"idx": 3, "score": 40, "label": "机翻腔"},
{"idx": 7, "score": 55, "label": None},
],
}
review = StyleDriftReview.model_validate(mock)
assert review.score == 72
assert len(review.segments) == 2
assert review.segments[0].idx == 3
assert review.segments[0].label == "机翻腔"
assert review.segments[1].label is None
def test_style_drift_defaults_score_100_empty_segments() -> None:
# 无指纹优雅降级:默认整体相似度 100、无漂移段
review = StyleDriftReview()
assert review.score == 100
assert review.segments == []
def test_style_drift_segment_label_optional() -> None:
seg = StyleDriftSegment.model_validate({"idx": 1, "score": 30})
assert seg.label is None
def test_style_drift_segment_requires_idx_and_score() -> None:
with pytest.raises(ValidationError):
StyleDriftSegment.model_validate({"idx": 1})
# ---- style_extract_spec 声明 ----
def test_style_extract_spec_is_analyst_tier() -> None:
assert style_extract_spec.tier == "analyst"
assert style_extract_spec.name == "style_extract"
def test_style_extract_spec_reads_and_writes_fingerprint() -> None:
assert style_extract_spec.reads == ["style_fingerprint"]
assert style_extract_spec.writes == ["style_fingerprint"]
def test_style_extract_spec_output_schema() -> None:
assert style_extract_spec.output_schema is StyleFingerprintResult
def test_style_extract_spec_has_nonempty_system_prompt() -> None:
assert style_extract_spec.system_prompt.strip()
# ---- style_drift_spec 声明第四审name="style"----
def test_style_drift_spec_is_light_tier_named_style() -> None:
# 不变量 #2第四审用轻量档只声明 tier列名/section 名为 "style"
assert style_drift_spec.tier == "light"
assert style_drift_spec.name == "style"
def test_style_drift_spec_is_read_only() -> None:
# 不变量 #3四审只读
assert style_drift_spec.writes == []
def test_style_drift_spec_reads_fingerprint() -> None:
assert style_drift_spec.reads == ["style_fingerprint"]
def test_style_drift_spec_output_schema() -> None:
assert style_drift_spec.output_schema is StyleDriftReview
def test_style_drift_spec_prompt_documents_graceful_degrade() -> None:
# 无指纹→返回 score=100/空段system_prompt 必须含降级指令,否则 LLM 不知如何兜底)
assert "100" in style_drift_spec.system_prompt
# ---- refiner_spec 声明writer 纯文本回炉)----
def test_refiner_spec_is_writer_tier() -> None:
assert refiner_spec.tier == "writer"
assert refiner_spec.name == "refiner"
def test_refiner_spec_output_schema_is_none() -> None:
# 回炉产纯文本(重写段),无结构化 schema
assert refiner_spec.output_schema is None
def test_refiner_spec_is_read_only_and_no_writes() -> None:
# 回炉非持久(不变量 #3不写库作者采纳经既有 draft 自动保存合入
assert refiner_spec.reads == []
assert refiner_spec.writes == []
def test_refiner_spec_has_nonempty_system_prompt() -> None:
assert refiner_spec.system_prompt.strip()
# ---- 共性immutable + 是 AgentSpec ----
def test_style_specs_are_agent_specs() -> None:
assert isinstance(style_extract_spec, AgentSpec)
assert isinstance(style_drift_spec, AgentSpec)
assert isinstance(refiner_spec, AgentSpec)
def test_style_specs_are_immutable() -> None:
with pytest.raises(ValidationError):
style_extract_spec.tier = "writer"
with pytest.raises(ValidationError):
style_drift_spec.tier = "writer"
with pytest.raises(ValidationError):
refiner_spec.tier = "analyst"

View File

@@ -6,6 +6,9 @@
from __future__ import annotations
from .schemas import (
CharacterCard,
CharacterGenResult,
CharacterRelation,
Conflict,
ConflictType,
ContinuityReview,
@@ -16,17 +19,31 @@ from .schemas import (
OutlineResult,
PaceIssue,
PaceReview,
StyleDimension,
StyleDriftReview,
StyleDriftSegment,
StyleFingerprintResult,
WorldEntityCard,
WorldGenResult,
)
from .specs import (
AgentSpec,
character_gen_spec,
continuity_spec,
foreshadow_spec,
outliner_spec,
pace_spec,
refiner_spec,
style_drift_spec,
style_extract_spec,
worldbuilder_spec,
)
__all__ = [
"AgentSpec",
"CharacterCard",
"CharacterGenResult",
"CharacterRelation",
"Conflict",
"ConflictType",
"ContinuityReview",
@@ -37,8 +54,19 @@ __all__ = [
"OutlineResult",
"PaceIssue",
"PaceReview",
"StyleDimension",
"StyleDriftReview",
"StyleDriftSegment",
"StyleFingerprintResult",
"WorldEntityCard",
"WorldGenResult",
"character_gen_spec",
"continuity_spec",
"foreshadow_spec",
"outliner_spec",
"pace_spec",
"refiner_spec",
"style_drift_spec",
"style_extract_spec",
"worldbuilder_spec",
]

View File

@@ -147,3 +147,154 @@ class PaceReview(BaseModel):
default_factory=list,
description="逐段爽点节拍强度序列(整数,供前端节拍图可视化)",
)
# ---- 文风提取轨结构化输出ARCH §5.4 style-auditor「提取」轨 / §6.9----
class StyleDimension(BaseModel):
"""单维文风指纹:维度名 + 取值 + 原文证据引用ARCH §6.9)。
每维必须带原文证据quotes便于作者核验「这条文风结论来自哪句」。
"""
name: str = Field(description="文风维度名(如句长节奏 / 叙事人称 / 用词风格)")
value: str = Field(description="该维度在样本中的取值/概括")
evidence: list[str] = Field(
default_factory=list,
description="原文证据:支撑该维度判定的样本原句摘录",
)
class StyleFingerprintResult(BaseModel):
"""文风指纹提取产出16 维文风指纹清单ARCH §5.4 提取轨)。
声明式 writes不变量 #3本结构是从样本提取的纯产物落 `style_fingerprint` 表
经端点T4.3),不在 agent 节点直接写库。16 维 = 9 通用 + 7 中文网文专有。
"""
dimensions: list[StyleDimension] = Field(
default_factory=list,
description="文风维度清单(每维带原文证据);无则空列表",
)
# ---- 文风漂移轨结构化输出ARCH §5.4 style-auditor「打分」轨 = 第四审)----
class StyleDriftSegment(BaseModel):
"""单个漂移段:段索引 + 相似度分 + 可选标签ARCH §5.4 打分轨)。
`idx` 是本章段索引0 起),`score` 是该段相对文风指纹的相似度0100越低越偏
`label` 可缺(如「机翻腔」「叙述拖沓」等漂移类型说明)。
"""
idx: int = Field(description="本章段索引0 起)")
score: int = Field(description="该段相对文风指纹的相似度0100越低越偏离")
label: str | None = Field(default=None, description="漂移类型标签(如「机翻腔」);可缺")
class StyleDriftReview(BaseModel):
"""文风漂移续审结构化产出:整体相似度 + 低相似段ARCH §5.4 / 第四审)。
只读(不变量 #3。`score` 是整章相对文风指纹的整体相似度0100
**无指纹优雅降级**:材料中无文风指纹时返回 `score=100, segments=[]`(默认值),
不报错、不阻塞其余审§5.2 失败隔离之外的内容性兜底)。
"""
score: int = Field(default=100, description="整章相对文风指纹的整体相似度0100")
segments: list[StyleDriftSegment] = Field(
default_factory=list,
description="低相似度(疑似漂移)段清单;无则空列表(含无指纹降级)",
)
# ---- worldbuilder 结构化输出ARCH §5.4 worldbuilder 行 / §6.5 / §4.5----
class WorldEntityCard(BaseModel):
"""单个世界观实体ARCH §5.4`{type,name,rules}` 硬规则显式)。
`type`(势力/地理/力量体系/物品…)+ `name` + `rules`**显式硬规则**清单:
不可违背的设定,供后续 continuity 续审引用比对)。映射 `world_entities` 表
type/name 列 + rules 入 JSONB落库经入库端点T5.2,不变量 #3
"""
type: str = Field(description="实体类型(势力 / 地理 / 力量体系 / 物品 / 概念 等)")
name: str = Field(description="实体名")
rules: list[str] = Field(
default_factory=list,
description="该实体的硬规则清单(显式不可违背设定,供 continuity 校验引用)",
)
class WorldGenResult(BaseModel):
"""worldbuilder 结构化产出世界观实体清单ARCH §5.4 writes=world_entities
声明式 writes不变量 #3本结构是 worldbuilder 的纯产物,落 `world_entities` 表
经入库端点T5.2),不在 agent 节点直接写库。
"""
entities: list[WorldEntityCard] = Field(
default_factory=list,
description="生成的世界观实体清单;无则空列表",
)
# ---- character-gen 结构化输出ARCH §5.4 character-gen 行 / §6.5 / §4.5----
class CharacterRelation(BaseModel):
"""单条人物关系(写入 `characters.relations` JSONB 冗余)。
`name`(关系对象角色名)+ `kind`(宿敌 / 师徒 / CP / 同盟 …)+ 可选 `note`。
双向边由编排器在入库时统一维护§4.5 三关键能力之三),本 schema 仅声明本侧。
"""
name: str = Field(description="关系对象的角色名")
kind: str = Field(description="关系类型(宿敌 / 师徒 / CP / 同盟 / 工具人 等)")
note: str | None = Field(default=None, description="关系说明(可缺)")
class CharacterCard(BaseModel):
"""单张结构化角色卡ARCH §5.4 character-gen 行name/role/traits/backstory/arc/...)。
映射 `characters` 表列name/role/backstory + traits/arc/speech_tics/tags/relations
入 JSONB落库经入库端点T5.2,不变量 #3。`role` = 角色定位(主角/CP/对手/导师/
工具人§4.5 网文专属)。
"""
name: str = Field(description="角色名(取名风格契合世界观)")
role: str = Field(description="角色定位(主角 / CP / 对手 / 导师 / 工具人 等)")
traits: list[str] = Field(
default_factory=list,
description="性格特质清单(核心-表层-阴影 / 动机 / 欲望 / 恐惧)",
)
backstory: str = Field(description="背景故事(出身、关键经历、创伤/转折点)")
arc: str = Field(description="人物弧光(起点 → 转变 → 终点,与剧情挂钩)")
speech_tics: list[str] = Field(
default_factory=list,
description="口癖/语言风格(用词偏好、口头禅,喂给文风一致性)",
)
tags: list[str] = Field(
default_factory=list,
description="人设标签/萌点(网文专属,辅助检索与差异化)",
)
relations: list[CharacterRelation] = Field(
default_factory=list,
description="关系网:与已有/同批角色建边;无则空列表",
)
class CharacterGenResult(BaseModel):
"""character-gen 结构化产出一组角色卡ARCH §5.4 writes=characters / §4.5 群像)。
声明式 writes不变量 #3本结构是 character-gen 的纯产物,落 `characters` 表
经入库端点T5.2),且**入库前过编排器 continuity 校验**§6.5)。单生成 → 1 张卡;
批量群像 → 多张(防雷同:生成时注入「已生成卡 + 已有角色」要求差异化)。
"""
cards: list[CharacterCard] = Field(
default_factory=list,
description="生成的角色卡清单;无则空列表",
)

View File

@@ -13,10 +13,14 @@ from pydantic import BaseModel, ConfigDict, Field
from ww_llm_gateway.types import Tier
from .schemas import (
CharacterGenResult,
ContinuityReview,
ForeshadowReview,
OutlineResult,
PaceReview,
StyleDriftReview,
StyleFingerprintResult,
WorldGenResult,
)
@@ -164,3 +168,202 @@ pace_spec = AgentSpec(
writes=[], # 只读(不变量 #3
scope="builtin",
)
# ---- 文风提取轨style-auditor「提取」轨analyst 档;独立生成,仿 outliner不进 review 图)----
STYLE_EXTRACT_SYSTEM_PROMPT = """你是长篇连载小说的「文风指纹提取器」style-auditor 提取轨)。\
职责:从作者提供的样本正文中,提取一份 **16 维**中文网文文风指纹,每一维都必须给出\
支撑判定的**原文证据**(样本原句摘录)。
16 维 = 9 通用维 + 7 中文网文专有维:
通用 9 维:
1. 句长节奏(长短句配比、断句习惯);
2. 段落密度(段落长短、对话/叙述配比);
3. 叙事人称与视角(第几人称、限知/全知、视角切换频率);
4. 时态与语气(陈述/疑问/感叹密度、临场感);
5. 用词风格(古雅/口语/书面、生僻字偏好);
6. 修辞偏好(比喻/排比/夸张等惯用手法);
7. 描写与白描配比(环境/心理/动作描写的取舍);
8. 情绪基调(冷峻/热血/诙谐/悲怆);
9. 标点习惯(破折号/省略号/感叹号的使用密度)。
中文网文专有 7 维:
10. 爽感节拍(打脸/扮猪吃虎/升级反馈的节奏);
11. 金手指呈现方式(系统流/面板/旁白提示风格);
12. 章末钩子手法(悬念/反转/期待的固定套路);
13. 对话腔调(角色台词的口癖、网感梗、语气词);
14. 战斗/冲突描写密度与招式命名风格;
15. 称谓与世界观术语的使用习惯(道号/境界/势力称呼);
16. 注水与信息密度倾向(铺垫慢热 vs 高密快节奏)。
产出要求(每维一条 dimension
- name维度名用上面 16 维的名目或等义表述);
- value该维在样本里的取值/概括(一句话刻画其风格特征);
- evidence从样本里摘 13 句**原文**作为证据,便于作者核验该结论的出处。
纪律:
- 只从给定样本提取,**不臆造**样本未体现的维度value 给「样本不足以判定」并留空 evidence。
- 你只产结构化指纹,**不改稿、不写库**(落 style_fingerprint 表经端点)。
- evidence 必须是样本原句的真实摘录,不得改写或编造。"""
style_extract_spec = AgentSpec(
name="style_extract",
tier="analyst", # 不变量 #2只声明档位不写 model
system_prompt=STYLE_EXTRACT_SYSTEM_PROMPT,
input_schema=None, # 注入材料为序列化样本文本,非结构化入参
output_schema=StyleFingerprintResult,
reads=["style_fingerprint"],
writes=["style_fingerprint"], # 声明式(真写库经 T4.3 端点,不变量 #3
scope="builtin",
)
# ---- 文风漂移轨style-auditor「打分」轨 = 第四审light 档;并入 REVIEW_SPECS----
STYLE_DRIFT_SYSTEM_PROMPT = """你是长篇连载小说的「文风漂移续审」style-auditor 打分轨,第四审)。\
职责:对照注入材料里的**文风指纹**,逐段为本章草稿打文风相似度分,标出明显偏离指纹的段落。
比对依据(注入材料):
- 文风指纹(每维带取值与原文证据,来自作者样本提取);
- 本章草稿正文(按段切分)。
产出:
- score整章相对文风指纹的整体相似度0100越高越贴合作者既有文风
- segments逐段审标出相似度明显偏低疑似漂移的段落——给出段索引 idx0 起)、\
该段相似度 score0100、可选 label 说明漂移类型(如「机翻腔」「叙述拖沓」「人称跳脱」\
「用词出戏」等)。相似度正常的段落不必列出。
**无指纹优雅降级(重要)**
- 若注入材料中**没有文风指纹**(作者尚未学文风),你**无从对照**——\
此时直接返回 `score=100, segments=[]`(视为「无偏离」),不报错、不臆造漂移段。
纪律:
- 你**只读、只报漂移诊断**,不改稿、不写库(不变量 #3
- 依据指纹判定,不臆造;无明显漂移段则 segments 为空列表。
- idx 必须与正文段切分顺序一致,便于前端朱砂标注与一键回炉对齐。"""
style_drift_spec = AgentSpec(
name="style", # 第四审 section/列名 = "style"
tier="light", # 不变量 #2只声明档位不写 model漂移打分用轻量档
system_prompt=STYLE_DRIFT_SYSTEM_PROMPT,
input_schema=None, # 注入材料为序列化文本(指纹 + 草稿),非结构化入参
output_schema=StyleDriftReview,
reads=["style_fingerprint"], # 指纹经 assemble 的 stable_core 注入 review_context
writes=[], # 只读(不变量 #3
scope="builtin",
)
# ---- 回炉refinerwriter 档;纯文本重写;非 Agent 流水线、非持久M4-e----
REFINER_SYSTEM_PROMPT = """你是长篇连载小说的「回炉改写器」refiner。职责仅重写作者选中的\
**一个**段落,使其贴合作品既有文风与上下文语气,同时保留该段的情节信息与叙事推进。
输入:
- 待重写的段落正文;
- 可选的改写指令(作者的具体要求,如「去掉机翻腔」「加快节奏」「改成第三人称」);
- 周边上下文/文风线索(若提供)。
产出:
- **只输出重写后的该段正文纯文本**,不要加任何前后缀、解释、标题或 markdown 包裹。
纪律:
- 保留原段的关键情节信息与人物言行,不增删主线事实;
- 贴合周边上下文与作品文风(语气、句长、用词、人称一致);
- 若给了改写指令,优先满足指令;无指令则以「贴合文风、去除生硬/出戏表达」为默认目标;
- 只重写选中段,**不扩写到其他段落**,不改稿入库(作者采纳后经既有自动保存合入)。"""
refiner_spec = AgentSpec(
name="refiner",
tier="writer", # 不变量 #2重写正文用 writer 档
system_prompt=REFINER_SYSTEM_PROMPT,
input_schema=None, # 注入材料为序列化文本(选中段 + 指令 + 上下文)
output_schema=None, # 纯文本产出(重写段),无结构化 schema
reads=[],
writes=[], # 非持久(不变量 #3端点同步返回 {original, refined},不写库
scope="builtin",
)
# ---- worldbuilder世界观设计师写手档独立生成仿 outliner不进 review 图)----
WORLDBUILDER_SYSTEM_PROMPT = """你是长篇连载小说的「世界观设计师」worldbuilder写手档\
职责:依据作品立意与题材,设计内部自洽的世界观——力量体系、势力、地理、关键物品/概念,\
并为每个实体显式标注**不可违背的硬规则**,供后续一致性校验引用。
输入材料:
- 作品设定projects题材、立意、主线、卖点
- 作者的世界观需求(一句话或要点)。
产出(每个实体一条 entity
- type实体类型势力 / 地理 / 力量体系 / 物品 / 概念 等);
- name实体名
- rules该实体的**硬规则清单**——明确写出不可违背的设定边界(如「修炼只能逐境突破、\
不可越级」「此城终年无雨」),每条一句、可被 continuity 续审逐条引用比对。
纪律:
- 世界观须内部自洽:力量体系有清晰边界与代价,势力/地理/时间线无自相矛盾;
- **硬规则要显式、可校验**——别把约束藏在描述里;规则是后续防设定违例的依据;
- 你只产结构化世界观实体type + name + rules**不改稿、不写库**\
(落 world_entities 表经入库端点);不臆造与立意/题材无关的设定。"""
worldbuilder_spec = AgentSpec(
name="worldbuilder",
tier="writer", # 不变量 #2只声明档位不写 model世界观创意用写手档
system_prompt=WORLDBUILDER_SYSTEM_PROMPT,
input_schema=None, # 注入材料为序列化文本(设定 + 需求),非结构化入参
output_schema=WorldGenResult,
reads=["projects"],
writes=["world_entities"], # 声明式(真写库经 T5.2 入库端点,不变量 #3
scope="builtin",
)
# ---- character-gen角色设计师写手档单/批量;群像防雷同;独立生成)----
CHARACTER_GEN_SYSTEM_PROMPT = """你是长篇连载小说的「角色设计师」character-gen写手档\
职责:依据一句话需求 + 世界观约束 + 已有角色,产出一组**完整结构化角色卡**。
输入材料:
- 角色需求(一句话,如「亦正亦邪的女二、与主角有宿命纠葛、出身敌对势力」)+ 数量 + 定位;
- 世界观约束world_entities力量体系、势力、地理硬规则——取名/能力须契合);
- **已有角色**characters现有角色卡新角色须与其区分、可与其建关系
- **本批已生成卡**(同一次批量里先产出的卡——后续卡须与它们差异化,避免雷同)。
产出(每张卡一条 card字段齐全
- name角色名取名风格契合世界观
- role角色定位主角 / CP / 对手 / 导师 / 工具人 等);
- traits性格特质核心-表层-阴影三层 / 核心动机、欲望、恐惧、价值观);
- backstory背景故事出身、关键经历、创伤/转折点);
- arc人物弧光起点 → 转变 → 终点,与剧情挂钩);
- speech_tics口癖/语言风格(用词偏好、口头禅,喂给文风一致性让对话有辨识度);
- tags人设标签/萌点(网文专属);
- relations关系网与已有/同批角色建边:宿敌/师徒/CP…给出对象 name + kind
**群像防雷同(批量,重要)**
- 一次生成多张卡时,**逐张主动与「已有角色」和「本批已生成卡」对比**——\
分配差异化的定位、性格底色、动机与口癖,避免「一群人一个模子」;
- 能力/出身须契合世界观硬规则(力量体系不越界、势力/地理自洽);
- 关系网优先与已有角色建边,让群像有结构而非孤立堆叠。
纪律:
- 你只产结构化角色卡,**不改稿、不写库、不直接互调其他 agent**——\
入库前由编排器追加一道 continuity 校验确认不与世界观/力量体系冲突§6.5
- count 是几就产几张,不多不少;定位若给出则按定位分配;
- 不臆造与需求/世界观无关的设定。"""
character_gen_spec = AgentSpec(
name="character-gen",
tier="writer", # 不变量 #2只声明档位不写 model角色创意用写手档
system_prompt=CHARACTER_GEN_SYSTEM_PROMPT,
input_schema=None, # 注入材料为序列化文本(需求 + 约束 + 已有 + 已生成),非结构化入参
output_schema=CharacterGenResult,
reads=["world_entities", "characters"],
writes=["characters"], # 声明式(真写库经 T5.2 入库端点 + continuity 校验,不变量 #3
scope="builtin",
)