docs: add architecture, workflow and delivery documents

2026-09-16 19:06:19 +08:00
parent 99f6bd77b0
commit 72fc5b47c7
36 changed files with 8240 additions and 0 deletions
@@ -0,0 +1,91 @@
+# 雅文内容创造工作台 · 流程图 v2
+
+## 图1 · 主流程 v2（波次调度 + 锚点卡 + 组合总检 + 记忆确认）
+
+```mermaid
+flowchart TD
+    U["👩 你：输入主题/导图/框架"] --> C["主控Agent<br/>解析导图→任务单"]
+    C -->|"读不准的词→待确认清单问你"| TS["任务单 TaskSpec<br/>段+时间轴+产品节点+质检项"]
+    TS --> W1["波次1（并行）<br/>开场段Agent | 服务Agent预热"]
+    W1 --> W2["波次2（并行，读开场锚点卡）<br/>心法段Agent | 技法段Agent"]
+    W2 --> W3["波次3（并行，读心法/技法锚点卡）<br/>场景段Agent | 产品段Agent"]
+    W3 --> W4["波次4（读全部锚点卡）<br/>收尾段Agent | 互动标记Agent"]
+    W4 --> AQ["每段产物 + 锚点卡AnchorCard"]
+    AQ --> QC["4道质检闸：结构/内容/风格尺度/跨稿<br/>（质检报告逐条对证正文+锚点卡）"]
+    QC -->|"FAIL→打回原段"| AQ
+    QC -->|"✅全过"| HR["人工审查台（硬关卡）<br/>逐段：产物+质检报告+锚点卡"]
+    HR -->|"🔁打回→意见生成记忆建议"| PM["记忆待确认池"]
+    HR -->|"✅全部确认"| CM["组合Agent<br/>时间轴拼装→一致性总检(5项)"]
+    CM -->|"发现矛盾/回指断裂→打回对应段"| AQ
+    CM -->|"微衔接→缝合编辑（必须标记）"| OUT["直播文稿.docx（六色）<br/>+组合报告+待确认清单"]
+    PM -->|"你确认→写入"| MEM["对应Agent记忆库"]
+    PM -->|"你拒绝/屏蔽→丢弃"| D["✖"]
+```
+
+## 图2 · 上下文契约：锚点卡机制（为什么段间不会"互不懂"）
+
+```mermaid
+flowchart LR
+    subgraph 上游["段2 技法段Agent 产出"]
+        A2["段2 全文产物"]
+        AC2["锚点卡（一页摘要）<br/>技法名：八爪鱼收紧术<br/>痛点：干涩→油<br/>情绪：高·演示"]
+    end
+    A2 --> AC2
+    subgraph 下游["段3 产品段Agent（隔离）"]
+        B["只读：段2锚点卡<br/>❌不读段2全文<br/>❌不共享对话"]
+        OUT3["段3 产物：<br/>'刚才教的八爪鱼收紧术，配这瓶油…'<br/>✅回指一致"]
+    end
+    AC2 -->|"主控转交"| B
+    subgraph 组合["组合Agent 总检"]
+        CHK["一致性总检<br/>回指断裂？矛盾？时间线？情绪曲线？钩子？"]
+        CHK -->|"发现断裂→打回对应段"| A2
+        CHK -->|"通过→拼装交付"| DOC["📄 docx"]
+    end
+    OUT3 --> CHK
+```
+
+## 图3 · 哪里不对改哪里（三种路径 v2）
+
+```mermaid
+flowchart LR
+    subgraph P1["路径1 内容级打回"]
+        A1["质检或审查发现段3不对"] --> A2["打回段3+意见"]
+        A2 --> A3["段3Agent：读意见+自己记忆+上游锚点卡<br/>重新生成"]
+        A3 --> A4["段3重新质检→复审"]
+        A1 -.-> A5["段1/2/4原封不动✅"]
+    end
+    subgraph P2["路径2 规则级修正"]
+        B1["工作台改该Agent rules.md（带版本）"] --> B2["按新规则重跑该环节"]
+    end
+    subgraph P3["路径3 人工直接改"]
+        C1["审查时直接改产物（标记）"] --> C2["生成记忆建议→待确认池"]
+    end
+```
+
+## 图4 · 记忆闭环 v2（人工确认后才沉淀）
+
+```mermaid
+flowchart TD
+    SRC["沉淀来源<br/>打回意见 / 质检FAIL / 你改规则 / 复盘"] --> PM["📥 记忆待确认池<br/>（每条：目标Agent+类型+内容+来源）"]
+    PM -->|"✅ 你确认"| W["写入对应Agent记忆库<br/>L1规则/L2纠错/L3偏好/L4成功"]
+    PM -->|"❌ 拒绝"| DR["丢弃"]
+    PM -->|"🚫 屏蔽同类"| BL["该来源类型不再建议"]
+    W --> N["下次该Agent运行时注入<br/>+规则+任务切片+上游锚点卡"]
+    N --> O["产出质量提升，同一错误二次打回率↓"]
+    style PM fill:#6d597a
+    style W fill:#2d6a4f
+```
+
+## 图5 · Agent 注册中心（随便添加，数量不限）
+
+```mermaid
+flowchart TB
+    MAN["👩 你：Agent管理页"] -->|"新建向导5步"| NEW["新Agent<br/>名称/职责/规则(rules.md模板+规则片段库)<br/>输入来源(读谁锚点卡)/知识库勾选"]
+    MAN -->|"复制"| CP["复制现有Agent改名改规则<br/>（如：复制场景段→青蛇白蛇段）"]
+    MAN -->|"停用"| DIS["停用（不派单，历史保留）"]
+    NEW --> REG["Agent注册中心<br/>agent_id/类型/标签/版本历史"]
+    CP --> REG
+    REG -->|"拖进流水线"| PL["流水线编辑器<br/>节点=Agent 边=依赖<br/>质检挂载/执行顺序"]
+    PL -->|"主控按依赖分波次调度"| RUN["执行 ✅"]
+    style REG fill:#1d3557
+```