docs: add architecture, workflow and delivery documents

This commit is contained in:
yi
2026-09-16 19:06:19 +08:00
parent 99f6bd77b0
commit 72fc5b47c7
36 changed files with 8240 additions and 0 deletions
+201
View File
@@ -0,0 +1,201 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>雅文内容创造工作台 · 流程图 v4</title>
<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
<style>
body { background:#0f1117; color:#e6e6e6; font-family:"Microsoft YaHei",system-ui,sans-serif; margin:0; padding:24px; }
h1 { text-align:center; font-size:22px; color:#fff; margin-bottom:4px; }
.sub { text-align:center; color:#888; font-size:13px; margin-bottom:28px; }
.card { background:#1a1d27; border:1px solid #2a2e3d; border-radius:12px; padding:20px 16px; margin-bottom:28px; }
.card h2 { font-size:16px; color:#ffd479; margin:0 0 14px 8px; }
.mermaid { display:flex; justify-content:center; overflow-x:auto; }
.tag { display:inline-block; background:#2a2e3d; color:#9aa4bf; font-size:12px; padding:2px 10px; border-radius:10px; margin-left:8px; font-weight:normal;}
footer { text-align:center; color:#555; font-size:12px; margin-top:16px; }
</style>
</head>
<body>
<h1>雅文内容创造工作台 · 流程图 v4</h1>
<div class="sub">开放画布 + RAG知识库 + 26内容标签 + 锚点卡契约 + 记忆人工确认|2026-08-25</div>
<div class="card">
<h2>图1 · RAG 知识库建库管道 <span class="tag">导入即建,全自动</span></h2>
<pre class="mermaid">
flowchart LR
F["素材文件<br/>docx / srt / md / txt / json / 导图"] --> P1["① 导入<br/>拖拽上传+进度条"]
P1 --> P2["② 格式解析<br/>docx提取正文 / srt去时间戳 / json结构抽取"]
P2 --> P3["③ 清洗<br/>去空行/提词备注/字幕断句合并"]
P3 --> P4["④ 分块<br/>标题感知+语义边界 400-600字 重叠15%<br/>元数据:库/文件/章节/序号"]
P4 --> P5["⑤ 向量化<br/>BGE-M3 本地Embedding(离线,数据不出本机)"]
P5 --> P6["⑥ 入库<br/>ChromaDB collection=知识库(天然隔离)"]
P6 --> P7["⑦ 检索测试页<br/>输入query验证命中质量"]
style P6 fill:#1d3557
</pre>
</div>
<div class="card">
<h2>图2 · Agent 取料(混合检索+引用溯源)</h2>
<pre class="mermaid">
flowchart TD
A["生产Agent 生成请求"] --> Q["query构造<br/>任务切片+上游锚点卡+检索意图"]
Q --> H{"混合检索<br/>只在挂接的collection内"}
H -->|"向量 top-k"| V["BGE-M3 语义相似度"]
H -->|"关键词 top-k"| K["BM25 精确命中<br/>(技法名/产品名/暗语)"]
V --> M["合并去重"]
K --> M
M --> R["可选:rerank重排"]
R --> S["引用溯源<br/>每条带:库/文件/章节/原文块/相似度"]
S --> INJ["注入Agent上下文<br/>(后台标注来源,正文不出现'知识库里说')"]
INJ --> OUT["段产物"]
OUT --> QC["质检一键核对引用<br/>选中一句→看引用→对证原文"]
QC -->|"查无来源=FAIL"| A
style QC fill:#6d597a
</pre>
</div>
<div class="card">
<h2>图3 · 知识库隔离与 Agent 挂接</h2>
<pre class="mermaid">
flowchart TB
subgraph KB["📚 知识库(ChromaDB collection 物理隔离)"]
C1["风格档案库"]
C2["产品知识库"]
C3["直播原文库(73场SRT)"]
C4["备稿库(99篇)"]
C5["你建的库:青蛇白蛇素材库"]
end
subgraph AG["Agent 挂接(多选)"]
PA["产品销售Agent<br/>☑风格档案 ☑产品知识库"]
JA["技法Agent<br/>☑风格档案 ☑直播原文库"]
end
C1 --> PA
C2 --> PA
C1 --> JA
C3 --> JA
PA -.->|"查不到"| X["原文库/青蛇库"]
JA -.->|"查不到"| Y["产品库"]
</pre>
</div>
<div class="card">
<h2>图4 · Agent 关系画布(顺序可改/单独启停/任意连线)</h2>
<pre class="mermaid">
flowchart LR
M["主控Agent"] --> A["开场 ●"]
A --> X1["心法Agent1 ●"]
A -.->|"可选"| X2["心法Agent2 ○停用"]
X1 --> J1["技法Agent1 ●"]
X1 --> J2["技法Agent2 ● 并行"]
X1 --> G["功法 ●"]
J1 --> P["产品销售 ●"]
J2 --> V["画面 ●"]
G --> S["场景 ●"]
V --> E["收尾 ●"]
S --> E
P --> E
E --> H["钩子 ●"]
H --> CM["组合Agent"]
style X2 fill:#444,color:#999,stroke-dasharray: 5 5
</pre>
</div>
<div class="card">
<h2>图5 · 内容标签体系(26个 / 6大类 / ★核心13个)</h2>
<pre class="mermaid">
flowchart LR
subgraph 结构["结构类"]
A1["开场★"]; A2["转场"]; A3["收尾★"]; A4["钩子★"]; A5["预告"]
end
subgraph 内容["内容类"]
B1["心法★"]; B2["痛点★"]; B3["动机铺垫★"]; B4["案例★"]; B5["见证"]
B6["冷知识"]; B7["金句★"]; B8["共鸣"]
end
subgraph 技法["技法类"]
C1["技法★"]; C2["功法★"]; C3["跟练★"]; C4["安全提示"]
end
subgraph 产品["产品类"]
D1["产品销售★"]; D2["产品体验★"]; D3["产品回指"]
end
subgraph 表现["表现类"]
E1["画面★"]; E2["场景★"]; E3["情绪"]; E4["氛围"]; E5["互动"]
end
subgraph 辅助["辅助类"]
F1["答疑"]; F2["双主播"]; F3["毛边"]; F4["仪式"]
end
</pre>
</div>
<div class="card">
<h2>图6 · 模型管理(每个 Agent 可选不同模型)<span class="tag">新增</span></h2>
<pre class="mermaid">
flowchart LR
subgraph 模型池["模型注册(OpenAI 兼容,可同时挂多个)"]
M1["🟦 DeepSeek<br/>deepseek-chat / R1"]
M2["🟩 硅基流动 / 智谱GLM"]
M3["🟧 Kimi / 通义"]
M4["⬜ 本地 Ollama"]
end
subgraph 画布["画布节点(每Agent独立选模型)"]
A1["主控Agent 🟦DeepSeek-R1<br/>(强推理:拆解/调度)"]
A2["心法Agent 🟩GLM<br/>(文风对比)"]
A3["画面Agent 🟧Kimi<br/>(文风对比)"]
A4["质检Agent 🟦DeepSeek-R1<br/>(严格规则执行)"]
A5["组合Agent 🟦长上下文<br/>(拼装+总检读全稿)"]
end
M1 --> A1
M1 --> A4
M1 --> A5
M2 --> A2
M3 --> A3
</pre>
</div>
<div class="card">
<h2>图7 · 节点状态机 <span class="tag">每个Agent工作状态清晰可见</span></h2>
<pre class="mermaid">
flowchart LR
P["待派发 🟦灰"] --> R["生成中 🟦蓝<br/>(显示模型+已耗时)"]
R --> Q["质检中 🟡黄<br/>(显示第几道)"]
Q --> H["待人工审查 🟣紫"]
H -->|"✅通过"| A["已通过 🟢绿"]
H -->|"🔁打回"| RW["打回重做 🟠橙<br/>(显示第几轮)"]
RW --> R
R -->|"生成失败"| F["⚠️失败 🔴红<br/>(点击看原因)"]
Q -->|"质检FAIL"| RW
F -->|"人工修复后重跑"| R
F -->|"人工跳过"| SK["跳过 ⬜灰斜线"]
F -->|"停用节点"| D["停用 ⬛暗"]
P -->|"上游停用"| SK
style F fill:#7f1d1d,color:#fff
style A fill:#14532d,color:#fff
</pre>
</div>
<div class="card">
<h2>图8 · 失败处理闭环 <span class="tag">生成不出来 → 必提醒人工</span></h2>
<pre class="mermaid">
flowchart TD
FAIL["Agent 生成失败"] --> RETRY{"可自动重试?<br/>超时/限流/截断"}
RETRY -->|"是(最多2次)"| R1["指数退避重试"]
R1 -->|"成功"| OK["✅ 继续流程"]
R1 -->|"仍失败"| MAN
RETRY -->|"否(拒审/Key错误/余额不足)"| MAN["🔴 转人工<br/>节点红标+通知中心提醒<br/>(不静默、不假装成功)"]
MAN --> PANEL["失败处理面板<br/>失败Agent/模型/错误原文/调用日志/输入上下文"]
PANEL --> ACT["人工修复动作"]
ACT -->|"🔁重试"| R1
ACT -->|"🔄换模型"| M2["换模型重跑"]
ACT -->|"📝改规则"| R2["改rules.md重跑"]
ACT -->|"✂️调任务切片"| R3["改写段描述重跑"]
ACT -->|"⏭️跳过"| SK["跳过(组合注明缺段)"]
ACT -->|"⏸️停用"| D["停用节点"]
ACT --> MEM["填修复原因 → 记忆建议<br/>→ 待确认池 → 沉淀防复发"]
style MAN fill:#7f1d1d,color:#fff
style MEM fill:#6d597a
</pre>
</div>
<footer>雅文内容创造工作台 v4 · RAG知识库版 · 2026-08-25</footer>
</body>
</html>