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,163 @@
"""生成/入库端点的请求/响应 schemaC3 扩 / ARCH §6.5 / §7.2)。
snake_case前端经 OpenAPI 生成 TS 类型消费。改字段 → 前端必须 `pnpm gen:api`。
生成走**即时返回**(预览 → 作者确认 → 入库),非 jobs 长任务M5-d
- `POST /world/generate` / `POST /characters/generate`:返回**预览**(不持久化)。
- `POST /characters`(入库):作者确认的角色卡 → 过 continuity 预检 gate + 权限白名单 → 写库。
视图字段贴 `ww_agents.WorldEntityCard`/`CharacterCard`保持生成产物形traits/speech_tics
是 list、arc 是 str入库时由写侧 repo 转 DB JSONB 形,见 character_repo
"""
from __future__ import annotations
from pydantic import BaseModel, Field
from ww_api.schemas.rules import RuleView
# 批量生成数量上限(防一次性巨量调用;原型保守值)。
MAX_GENERATE_COUNT = 12
# ---- 世界观生成(预览)----
class WorldGenerateRequest(BaseModel):
"""POST /projects/:id/world/generate据需求生成世界观实体预览"""
brief: str = Field(min_length=1, description="世界观生成需求(题材/设定方向/约束)")
class WorldEntityCardView(BaseModel):
"""单个世界观实体卡(贴 ww_agents.WorldEntityCard预览 + 入库共用形)。"""
type: str = Field(description="实体类型(势力 / 地理 / 力量体系 / 物品 / 概念 等)")
name: str = Field(description="实体名")
rules: list[str] = Field(default_factory=list, description="该实体的硬规则清单")
class WorldGenPreviewResponse(BaseModel):
"""世界观生成预览(不持久化;作者确认后另走入库,本期入库端点为角色)。"""
entities: list[WorldEntityCardView] = Field(default_factory=list)
# ---- 角色生成(预览)----
class CharacterGenerateRequest(BaseModel):
"""POST /projects/:id/characters/generate据需求生成角色卡预览群像防雷同"""
brief: str = Field(min_length=1, description="角色生成需求")
count: int = Field(default=1, ge=1, le=MAX_GENERATE_COUNT, description="生成数量")
role: str | None = Field(default=None, description="角色定位(主角/CP/对手/导师/工具人 等)")
class CharacterRelationView(BaseModel):
"""单条人物关系(贴 ww_agents.CharacterRelation"""
name: str
kind: str
note: str | None = None
class CharacterCardView(BaseModel):
"""单张角色卡(贴 ww_agents.CharacterCard预览 + 入库请求共用形)。"""
name: str = Field(description="角色名")
role: str = Field(description="角色定位")
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[CharacterRelationView] = Field(default_factory=list, description="关系网")
class CharacterGenPreviewResponse(BaseModel):
"""角色生成预览(不持久化;作者确认后经 POST /characters 入库)。"""
cards: list[CharacterCardView] = Field(default_factory=list)
# ---- 角色入库(作者确认后;过 continuity gate + 权限白名单)----
class CharacterIngestRequest(BaseModel):
"""POST /projects/:id/characters把作者确认的角色卡入库。
`acknowledge_conflicts`:作者已查看并接受预检冲突时置 `true`,越过 continuity gate
(仿 accept 的冲突裁决:不静默入库,须作者确认;默认 false → 有冲突即 409见端点
"""
cards: list[CharacterCardView] = Field(min_length=1, description="待入库的角色卡(至少 1 张)")
acknowledge_conflicts: bool = Field(
default=False, description="作者已知悉并接受 continuity 冲突 → 放行入库"
)
class IngestConflictView(BaseModel):
"""入库预检检出的单条 continuity 冲突(贴 ww_agents.Conflict 五类)。"""
type: str
where: str
refs: list[str] = Field(default_factory=list)
suggestion: str
class CharacterIngestResponse(BaseModel):
"""角色入库结果201写入的角色 + 被白名单丢弃的越权表(审计)。"""
created: list[str] = Field(default_factory=list, description="写入的角色名(按入参顺序)")
rejected_tables: list[str] = Field(
default_factory=list, description="被权限白名单丢弃的越权写表名(审计;正常为空)"
)
# ---- 读端点:设定库 Codex角色 / 世界观全量列表)----
class CharacterListResponse(BaseModel):
"""GET /projects/:id/characters已入库角色全量列表设定库 Codex 真源)。
DB JSONB dict 列 → API list/str 反向解包(入库形变的逆向,见 character_repo
`{"items":[...]}`→list、`{"text":...}`→strtags/relations 直落 list。
"""
characters: list[CharacterCardView] = Field(default_factory=list)
class WorldEntityListResponse(BaseModel):
"""GET /projects/:id/world_entities已入库世界观实体全量列表设定库 Codex 真源)。
DB JSONB dict 列 `{"rules":[...]}`→裸 listworldbuilder 形变的逆向)。
"""
world_entities: list[WorldEntityCardView] = Field(default_factory=list)
# ---- 读端点:规则列表 + 技能库T5.6 前端)----
class RuleListResponse(BaseModel):
"""GET /projects/:id/rules规则列表规则页"""
rules: list[RuleView] = Field(default_factory=list)
class SkillView(BaseModel):
"""单个 skill 的声明式视图(技能库 UI"""
name: str
scope: str = Field(description="builtin / custom / community")
tier: str = Field(description="能力档位writer / analyst / light")
reads: list[str] = Field(default_factory=list)
writes: list[str] = Field(default_factory=list)
genre: str | None = None
class SkillListResponse(BaseModel):
"""GET /skills技能库列表按 name 升序)。"""
skills: list[SkillView] = Field(default_factory=list)