160 lines
6.3 KiB
Python
160 lines
6.3 KiB
Python
from typing import Annotated, List, Literal, Optional, TypedDict
|
||
import operator
|
||
|
||
# ── 素材 ──────────────────────────────────────────────────────────────────────
|
||
|
||
class Material(TypedDict, total=False):
|
||
id: str
|
||
title: str
|
||
content: str # 截断到 500 字
|
||
source: str
|
||
published_at: str
|
||
relevance_score: float
|
||
source_type: str # "internet" | "intranet" | "skill"
|
||
url: str
|
||
recUuid: str
|
||
# skill 类素材附带的元信息(skill_name / container_path / category),其他类型为空
|
||
extra_metadata: dict
|
||
|
||
class SkillStep(TypedDict, total=False):
|
||
"""技能检索过程的单步记录,用于前端时间线展示。
|
||
|
||
type=match_skills:根据用户输入流式分析有没有匹配技能(无 skill_names)
|
||
type=list_skills:列出可用技能
|
||
type=select_skills:LLM 从中选出的相关技能
|
||
type=invoke_skill:实际调用某一个技能检索
|
||
type=stop_early:达到素材阈值,提前停止后续技能调用
|
||
"""
|
||
type: str
|
||
message: str
|
||
skill_names: List[str]
|
||
skill_name: str
|
||
matched_count: int
|
||
reason: str
|
||
|
||
class MaterialPackage(TypedDict, total=False):
|
||
keywords: List[str]
|
||
materials: List[Material]
|
||
summary: str
|
||
# 是否本次素材来自技能检索(覆盖式替换 web 检索)
|
||
skill_search_used: bool
|
||
# 技能检索的步骤记录(前端展示"使用了 X 技能"卡片)
|
||
skill_search_steps: List[SkillStep]
|
||
|
||
# ── 大纲 ──────────────────────────────────────────────────────────────────────
|
||
# 三级结构:章节(##) → 小节(###) → 子要点(bullet -)。
|
||
# Outline.sections[] = Level 1 章节(渲染为 ## 由系统注入)
|
||
# OutlineSection.key_points[] = Level 2 小节(渲染为 ### 标题)
|
||
# KeyPoint.sub_points[] = Level 3 子要点(bullet "- ...",非标题)
|
||
#
|
||
# 历史上 key_points 曾是 List[str](2 级):每个 str 既是小节标题又是渲染单位。
|
||
# 升级到 3 级后,key_points 变成 List[KeyPoint],每个 KeyPoint 自带 sub_points
|
||
# 列表;旧 session 里的 string 项由 writer_outline._parse_outline 自动 lift 成
|
||
# {point_title: <原 string>, sub_points: []},无需迁移数据。
|
||
|
||
class KeyPoint(TypedDict):
|
||
point_title: str # 小节标题(渲染为 ### 二级小标题)
|
||
sub_points: List[str] # 子要点(可为空;非空时在小节正文里以 bullet 列表呈现)
|
||
|
||
class OutlineSection(TypedDict):
|
||
section_title: str
|
||
key_points: List[KeyPoint] # 注意:旧版是 List[str],解析层做了兼容
|
||
material_ids: List[str]
|
||
|
||
class Outline(TypedDict):
|
||
title: str
|
||
sections: List[OutlineSection]
|
||
|
||
# ── 草稿 ──────────────────────────────────────────────────────────────────────
|
||
|
||
class DraftArticle(TypedDict):
|
||
title: str
|
||
outline: Outline
|
||
full_markdown: str
|
||
word_count: int
|
||
revision_count: int
|
||
|
||
# ── 编辑审核 ──────────────────────────────────────────────────────────────────
|
||
|
||
class ReviewIssue(TypedDict):
|
||
category: str # "fact" | "logic" | "language"
|
||
severity: str # "major" | "minor"
|
||
location: str
|
||
issue: str
|
||
suggestion: str
|
||
|
||
class ReviewResult(TypedDict):
|
||
verdict: str # "pass" | "reject"
|
||
fact_score: int
|
||
logic_score: int
|
||
language_score: int
|
||
overall_score: int
|
||
pass_threshold: int
|
||
revision_notes: List[ReviewIssue]
|
||
|
||
# ── 用户干预 ──────────────────────────────────────────────────────────────────
|
||
|
||
class UserInterventionPayload(TypedDict, total=False):
|
||
action: str
|
||
approved_material_ids: List[str]
|
||
extra_keywords: List[str]
|
||
# PAUSE-1 素材确认 / enable_skill_search 共用:用户在单输入框里填的自然语言
|
||
# (可能是要使用的技能名、想检索的来源、或者一段补充检索意图)。
|
||
user_query: str
|
||
edited_outline: Optional[Outline]
|
||
outline_feedback: str
|
||
user_revision_notes: str
|
||
override_verdict: bool
|
||
|
||
# ── 主状态 ────────────────────────────────────────────────────────────────────
|
||
|
||
WritingStatus = Literal[
|
||
"researching", "awaiting_material_confirm",
|
||
"writing_outline", "awaiting_outline_confirm",
|
||
"writing_draft", "awaiting_section_help", "awaiting_draft_confirm",
|
||
"reviewing", "awaiting_review_confirm",
|
||
"revising", "done", "error",
|
||
]
|
||
|
||
|
||
class BlockedSection(TypedDict):
|
||
"""严格模式下素材不足、无法写作的章节。"""
|
||
section_title: str
|
||
reason: str
|
||
|
||
class AIWritingState(TypedDict):
|
||
# 写作配置
|
||
user_intent: str
|
||
article_type: str
|
||
target_audience: str
|
||
word_count_target: int
|
||
# 素材检索关键词数量(用户指定,1~10,默认 6)
|
||
keyword_count: int
|
||
# 写作模式:strict=严格依据素材 / loose=可结合通用知识(默认 loose)
|
||
writing_mode: str
|
||
|
||
# Agent A 输出
|
||
material_package: Optional[MaterialPackage]
|
||
|
||
# Agent B 输出
|
||
current_outline: Optional[Outline]
|
||
drafts: Annotated[List[DraftArticle], operator.add]
|
||
current_draft: Optional[DraftArticle]
|
||
|
||
# Agent C 输出
|
||
review_result: Optional[ReviewResult]
|
||
|
||
# 用户干预数据(每个干预点会覆盖)
|
||
last_user_intervention: Optional[UserInterventionPayload]
|
||
|
||
# 严格模式下素材不足、待用户决策的章节(写作节点产出,求助暂停点消费)
|
||
blocked_sections: Optional[List[BlockedSection]]
|
||
|
||
# 流程控制
|
||
revision_count: int
|
||
max_revisions: int
|
||
status: WritingStatus
|
||
|
||
# SSE 进度推送队列(每个节点追加)
|
||
progress_events: Annotated[List[dict], operator.add]
|