22 KiB
22 KiB
雅文内容创造工作台 · 设计文档 v1
日期：2026-08-25 ｜ 状态：设计评审稿 ｜ 目标：多 Agent 内容工厂，主控派单 → 环节 Agent 生产 → 质检 → 人工审查 → 组合成直播文稿，全程可改、越用越懂
1. 项目概述
一个多 Agent 内容生产工作台，专为雅文老师直播文稿生产打造：
- 你只输入：当天要做的内容主题 + 导图/框架/思维（内容+时间的权威大纲）
- 工作台自动完成：主控 Agent 拆解任务 → 按环节派发给生产 Agent → 每个环节产物独立质检 → 质检通过后送人工审查 → 全部确认后组合成一篇完整直播文稿（含颜色标记 docx）
- 你可以干预任何环节：每个 Agent 的规则可改、每个环节的产物可打回重做、打回意见会沉淀成该 Agent 的记忆，越用越贴合你的标准
2. 需求 → 设计对策映射
| # | 你的要求 | 设计对策 |
|---|---|---|
| 1 | 很多个 Agent 组成 | 1 主控 + 4~N 生产 Agent + 4 质检 Agent + 1 组合 Agent + 2 服务型 Agent（产品顾问/风格顾问） |
| 2 | 每个 Agent 可设置规则做对应的事 | 每个 Agent 一个 rules.md（规则文件），你直接编辑，随时生效 |
| 3 | 上下文隔离 | Agent 间不共享对话历史，只传递结构化任务单；每 Agent 独立会话 |
| 4 | 知识库共用 | 一个只读共享知识库，所有 Agent 可检索，任何 Agent 不可写 |
| 5 | 哪里不对改哪里 | 打回粒度 = 环节产物：打回哪段只重跑哪段，其他不动；规则级修正 + 人工直接改三种路径 |
| 6 | 给主 Agent 主题/导图即可 | 主控 Agent 解析导图 → 生成任务单 → 自动派发、跟踪、汇总 |
| 7 | 每件产物都有质检 Agent | 每个环节产物生成后立即自动过 4 道质检闸，不过关打回原环节 |
| 8 | 质检过还要人工审查 | 人工审查台是硬关卡：质检全过 ≠ 交付，人工确认后才放行 |
| 9 | 组合成一篇直播文稿 | 组合 Agent 按任务单时间轴拼装 + 衔接检查 + 生成六色标记 docx |
| 10 | Agent 自主学习、越用越懂 | 每 Agent 独立记忆库：纠错、偏好、成功案例沉淀，写入有触发机制 |
| 11 | 记忆库隔离 | 记忆按 Agent 命名空间隔离，互不可见；只有共享知识库是共用的 |
3. 系统架构总览
┌────────────────────────── 你（唯一入口） ──────────────────────────┐
│ 输入：主题 / 导图 / 框架 / 思维（当天权威大纲） │
│ 干预：改 Agent 规则 · 打回环节 · 直接改产物 · 审查确认 │
└────────────────────────────────┬──────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────┐
│ 主控 Agent（主编） │
│ ① 解析导图 → ② 生成任务单 TaskSpec → ③ 派发 → ④ 跟踪 → ⑤ 汇总 │
│ 记忆：项目管理偏好（压缩决策、交付习惯） │
└──────┬──────────┬──────────┬──────────┬──────────┬───────────────┘
▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ 段Agent1 │ │ 段Agent2 │ │ 段Agent3 │ │ 段AgentN │ │ 服务型 │
│ 开场/心法 │ │ 技法/场景 │ │ 产品/销售 │ │ 收尾/钩子 │ │ 产品顾问 │
│ 独立上下文 │ │ 独立上下文 │ │ 独立上下文 │ │ 独立上下文 │ │ 风格顾问 │
│ 独立记忆库 │ │ 独立记忆库 │ │ 独立记忆库 │ │ 独立记忆库 │ │(只读供给)│
└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
▼ ▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ 共享只读知识库（所有人可查，无人可写） │
│ 数字雅文档案/范稿 | 训练营框架/导图库 | 直播原文库(73场) │
│ 备稿库(99篇) | 产品知识库(观品) | 质检规则库 │
└─────────────────────────────────────────────────────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ 质检闸（每件产物独立过 4 道，并行） │
│ ①结构质检 ②内容质检 ③风格尺度质检 ④跨稿质检 │
│ 各质检 Agent 有独立记忆：常见错误模式库，越查越准 │
└──────┬──────────────────────────────────────────────────────┘
▼ 全部通过
┌─────────────────────────────────────────────────────────────┐
│ ═══ 人工审查台（硬关卡）═══ │
│ 逐段查看：产物 + 质检报告 + 高亮差异 │
│ 操作：✅通过 / 🔁打回(附意见→进该Agent记忆) / ✏️直接改 │
└──────┬──────────────────────────────────────────────────────┘
▼ 全部确认
┌─────────────────────────────────────────────────────────────┐
│ 组合 Agent（总编）：时间轴拼装 → 衔接/回指检查 │
│ → 生成说明 → 六色标记 docx（宋体10.5pt） │
└─────────────────────────────────────────────────────────────┘
▼
📄 最终交付：直播文稿.docx + clean.txt + 待确认清单
4. Agent 拓扑与职责
4.1 主控 Agent（主编/Coordinator）— 唯一派单者
| 项 | 说明 |
|---|---|
| 职责 | 解析导图/主题 → 生成任务单 → 派发 → 跟踪进度 → 汇总质检/审查结果 → 决定重跑/放行 |
| 输入 | 你的原始输入（主题、导图 md/图片、框架文字） |
| 输出 | 任务单 TaskSpec（结构化 JSON/MD，是全局唯一任务契约） |
| 规则文件 | agents/coordinator/rules.md（拆解原则：导图=内容+时间权威大纲、节点逐条对应、读不准的词列待确认清单、时间总和校验、压缩决策写进交付说明） |
| 记忆库 | agents/coordinator/memory/（你的项目管理偏好：压缩习惯、交付格式、确认偏好） |
| 关键动作 | 导图读不准的词（手写/OCR 常错）必须先列出来问你再动稿——这是全流程第一道防错闸 |
4.2 生产 Agent（环节 Agent）— 按段划分，默认模板如下，数量可增减
每个段 Agent 只生产任务单里分配给它的那一段，产出独立文件。
| Agent | 产出内容 | 该 Agent 规则要点（rules.md 示例） | 质检重点 |
|---|---|---|---|
| 开场段 Agent | 扎心开场+承诺钩子，开场 30 分钟内见主题、第一件产品尽量前置 | 开场降档（性感画面撤下换自嘲暖场）、案例/悬念 30 秒入题 | 结构/风格尺度 |
| 心法段 Agent | 心法金句、认知颠覆、"为什么"铺垫 | 先讲"为什么要听"再进干货；金句只作点缀不作产品引入载体 | 内容/风格 |
| 技法段 Agent | 痛点技法展示：步骤骨架+画面点+跟练互动 | 技法快准狠（第一步…第二步…第三步）；可跟练动作+互动指令；每个卖点前必有痛点技法展示 | 内容/结构 |
| 场景段 Agent | 角色扮演/SM 场景/水元素段等（按导图） | 色情小说档画面感写法；SM 道具带安全提示；场景=环境/衣着/光线/气味/心理/动作过程 | 风格/合规 |
| 产品段 Agent | 产品体验感写作+销售话术 | 一产品一概念不混谈；产品随动作进场（拿第一瓶）；卖货节点宁早勿晚；价格以当轮指令为准 | 内容/跨稿 |
| 收尾段 Agent | 信念收尾（最后 30 秒纯信念不卖货）+次日钩子 | 钩子=导图次日真实框架，技法名与导图一致；不写死待确认道具 | 跨稿/风格 |
| 互动标记 Agent | 全稿表演标记补全（灰字） | （停顿三秒）（压低声音）（等弹幕）（演示）（拿第一瓶）；禁止报幕式转场 | 结构 |
段划分原则：与导图节点一一对应（导图是权威大纲），默认 6-15 段随当天导图增减。段 Agent 之间互不读取对方产物——防止上下文串扰（隔离的核心）。
4.3 服务型 Agent（只读供给，不产稿）
| Agent | 职责 |
|---|---|
| 产品顾问 Agent | 查产品知识库（观品 chunks.jsonl），产出产品事实卡（功效/价格口径/概念边界），供产品段 Agent 使用；记忆沉淀"产品概念边界"（水润≠养护等） |
| 风格顾问 Agent | 加载数字雅文人格档案/范稿/文本层铁律，产出"本场风格校准卡"（称呼、句式、金句密度、暗语表），供所有生产 Agent 使用 |
4.4 质检 Agent — 4 道闸并行
| 质检 Agent | 检查清单（来自实战沉淀的审查五类+铁律） | 打回依据 |
|---|---|---|
| ① 结构质检 | 逻辑硬伤（自相矛盾/段序错乱/数据不自洽/预告打架/语义反字/时序张力）、笔误错字（漏字/同音/人名混乱/括号配对）、结构残留（提词备注/上半场无下半场/他稿时间线）、时间轴核对（每段标题时间标注、总和=直播时长） | 任何 FAIL → 打回原段 Agent |
| ② 内容质检 | 每个卖点前是否有痛点技法展示（不放心法带入）、一产品一概念（"养护"字样清零）、技法密度（可跟练清单存在）、讲解前有"为什么"、删讲解不删画面、产品数量=导图产品节点数 | 同上 |
| ③ 风格尺度质检 | 色情小说档词清单（腿心/热意/颤/烫 ≥3）、禁词清零（妹妹/豆豆/龙根/蛋蛋/射/喷/缴械=0）、反问句归零（对不对/明白吗）、表演标记覆盖率、破折号清零、无教学框架外露、无知识库来源标注 | 同上 |
| ④ 跨稿质检 | day N-1 结尾预告的技法逐条兑现、价格/术语跨稿一致（以当轮指令为准）、产品名与台账对齐、回指句一致性（产品退场后相关回指句清理） | 同上 |
质检输出：结构化报告 qc_report.json（每条问题带位置+描述+修改建议+严重级），报告逐条对证正文（质检报告≠事实——用户对"表面功夫"敏感，报告与正文脱节必须抓出来）。
4.5 组合 Agent（总编/Composer）
| 项 | 说明 |
|---|---|
| 职责 | 全部通过后：按任务单时间轴拼装 → 段间衔接检查（话题自然滑入，禁报幕式转场）→ 产品回指一致性 → 生成六色标记 docx（黑/红/紫/绿/灰/蓝）→ 生成说明 + 待确认清单 + clean.txt |
| 输入 | 所有通过审查的段产物 + 任务单 |
| 输出 | 直播文稿.docx（宋体 10.5pt，段落自然合并 85-110 段）+ 生成说明（生成依据/时间压缩决策/跨稿对账/合规处理/占位符） |
| 记忆 | 沉淀"通过稿的组合模式"（衔接句样板、图例规范） |
5. 上下文隔离机制（核心设计）
隔离原则：Agent 之间只通过"文件系统 + 结构化契约"通信，绝不共享对话。
┌─ 任务单 TaskSpec（主控产出，全流程唯一契约）────────────────┐
│ campaign_id / date_id / 导图源文件引用 │
│ segments: [{ id, title, 时间范围, 类型(心法/技法/产品/场景), │
│ 导图节点原文, 产品节点, 交付要求 }] │
│ quality_gates: 本场启用的质检项 + 词清单 │
└─────────────────────────────────────────────────────────────┘
每个段 Agent 运行时只看到：
✅ 任务单中属于自己的 segment 切片
✅ 共享知识库（只读检索接口）
✅ 自己的规则文件 + 自己的记忆库
❌ 其他段的产物
❌ 其他 Agent 的对话历史/记忆
❌ 主控与用户的对话
质检 Agent 运行时只看到：
✅ 被检段产物 + 任务单对应切片 + 知识库质检规则 + 自己的错误模式记忆
❌ 其他段产物（除非打回时作为上下文补充，由主控显式授权）
隔离的物理载体：work/<campaign_id>/segments/<segment_id>/ 每个段一个目录，产物独立文件；Agent 会话按段独立起停。
6. 共享知识库（只读、共用）
| 库 | 内容 | 说明 |
|---|---|---|
| 风格档案库 | 数字雅文人格档案、day1 定稿基准、仿雅文范稿、文本层铁律 10 条 | "怎么讲"的最高权威 |
| 框架导图库 | 七天营导图、28 天重排版总纲、历史任务单 | 生成新稿的权威大纲引用 |
| 直播原文库 | 73 场 SRT 转录（573 万字，E:\03_直播素材\直播合集） | 素材/案例/原话检索 |
| 备稿库 | 99 篇备稿（150 万字，Desktop\直播文稿） | 历史定稿/跨稿对账依据 |
| 产品知识库 | 观品产品知识库 chunks.jsonl | 产品事实/功效/概念边界（价格口径以当轮指令为准） |
| 质检规则库 | 五类审查清单、词清单、铁律 | 质检 Agent 的检查依据 |
写权限：无。所有 Agent 只读检索。产出和记忆一律写各自工作区/记忆库——知识库保持原始状态。
7. 记忆系统设计（自主学习 · 每 Agent 隔离）
7.1 记忆分层
| 层 | 类型 | 来源 | 示例 | 优先级 |
|---|---|---|---|---|
| L1 | 规则记忆 | 用户显式纠正（你改规则/打回时说的"以后都…"） | "卖货节点宁早勿晚；产品前必须有痛点技法展示" | 最高，等同于改 rules |
| L2 | 纠错记忆 | 质检 FAIL 自动沉淀 | "本段上次因'养护'字样残留被打回" | 高，重跑时必读 |
| L3 | 偏好记忆 | 人工审查意见 | "你上次打回说：心法段金句太多太密" | 高 |
| L4 | 成功记忆 | 通过稿复盘（可选） | "开场段上次通过时用了自嘲暖场模式" | 中，仅参考 |
7.2 沉淀红线（重要——来自你们实战的两轮纠正）
- ✅ 可沉淀：怎么讲（打法、结构、风格、质检标准、转场手法）
- ❌ 不可沉淀：讲什么（价格、头衔、技法名、产品组合、场次性口径）——每篇独立，以当轮指令/导图为准
- 记忆条目必须带来源标签（哪场/哪次打回），场次性数据只能进"参考池"且带过期标记，绝不升级为规则
7.3 记忆写入时机（自动 + 手动）
- 人工打回时 → 打回意见自动结构化写入对应 Agent 的 L3
- 质检 FAIL → 错误模式自动写入质检 Agent 的 L2（同段重跑时注入）
- 你编辑 rules.md → 记为 L1
- 每轮跑完 → 主控询问是否复盘沉淀（不自动，避免噪音）
7.4 记忆库物理隔离
memory/
coordinator/ ← 主控记忆（项目管理偏好）
segment_opening/ ← 开场段 Agent 记忆
segment_xinfa/ ← 心法段 Agent 记忆
segment_jifa/ ← 技法段 Agent 记忆
qc_structure/ ← 结构质检记忆（错误模式）
qc_content/ ← 内容质检记忆
qc_style/ ← 风格尺度质检记忆
qc_cross/ ← 跨稿质检记忆
composer/ ← 组合 Agent 记忆
每个库独立命名空间，Agent 运行时只挂载自己的记忆文件。
8. 全流程时序（正常路径 + 打回路径）
正常路径：
你 ──主题/导图──▶ 主控 ──任务单──▶ [段Agent们 并行] ──每段产物──▶ [4道质检并行]
▶ 质检报告 ──▶ 人工审查台 ──全部✅──▶ 组合Agent ──▶ 直播文稿.docx
打回路径（哪里不对改哪里）：
人工审查 🔁打回段3 ──意见──▶ 段3 Agent（读取意见+自己记忆+任务单切片）
──重新生成段3──▶ 质检(段3) ──▶ 人工复审 ──✅──▶ 继续
（段1/2/4 产物原封不动，不重跑）
规则修改路径：
你 ──改 rules.md──▶ 指定 Agent ──重跑该环节──▶ 质检 ──▶ 审查
9. 数据模型（核心 Schema）
// 任务单 TaskSpec
{
"campaign_id": "2026-08-26-day5",
"mindmap_source": "导图文件路径",
"total_duration": 120,
"segments": [
{
"id": "seg-01",
"title": "开场·扎心+承诺",
"time": "00:00-00:08",
"type": "opening",
"mindmap_node": "导图节点原文转录",
"products": [],
"requirements": ["开场降档", "30秒入题"]
}
],
"quality_gates": ["structure", "content", "style", "cross"],
"word_limits": {"min": 5000, "target": 6758}
}
// 质检报告 QCReport
{
"segment_id": "seg-03",
"checks": [
{"id": "structure-04", "name": "时间轴核对", "status": "FAIL",
"issues": [{"location": "段标题③", "desc": "时间标注 00:22-00:30 与导图 00:20-00:28 不符",
"suggestion": "改回导图时间", "severity": "high"}]}
],
"verdict": "FAIL"
}
// 记忆条目 MemoryEntry
{
"agent_id": "segment_jifa",
"type": "L3_preference",
"content": "技法段讲解前必须先给'为什么'铺垫1-2句再进干货",
"source": "2026-08-day4打回#2",
"created": "2026-08-25",
"status": "active"
}
10. 落地技术选型（三条路，先看后定）
| 方案 | 形态 | 优点 | 缺点 | 工期 |
|---|---|---|---|---|
| A. 轻量版（推荐先跑） | 基于现有 Hermes 体系：每 Agent = 一个 skill + 独立记忆目录 + 独立工作目录；主控用 delegate_task 派发；质检用脚本+LLM 双检；组合复用 make_color_docs.py 引擎 | 零新基建、直接复用全部现有技能/素材库/质检清单、今天就可用 | 无可视化界面（命令行/对话式操作）、并行度受 Hermes 限制 | 1-2 天 |
| B. 工作台版（正式目标） | 独立 Web 应用：FastAPI + DeepSeek API + SQLite + 前端看板。可视化：任务单看板、每段产物卡片、质检报告红绿灯、打回/通过按钮、规则编辑器 | 符合"工作台"体验、人工审查台最顺、可多人协作 | 开发量中等（知识库检索/记忆库/编排层都要自建） | 1-2 周 |
| C. dsh 编排版 | 用 dsh 多 Agent 拓扑 + 自定义 harness 脚本 | 复用你已有的 dsh | dsh 目前偏单 Agent CLI/Web UI，多 Agent 编排要自己写协调层，且无工作台 UI | 1 周 |
建议路径：先用 A 把流程跑通（生成一篇真实稿子验证全链路，同时把任务单/质检报告/记忆的 schema 在实际使用中敲定），再上 B 做可视化工作台——A 跑出来的数据模型直接成为 B 的数据库结构。
11. 里程碑
| 阶段 | 内容 | 验收标准 |
|---|---|---|
| M1 流程验证（A 方案） | 搭好目录骨架 + 主控拆解 + 3 个段 Agent + 2 道质检 + 人工审查 + 组合 | 用一天真实导图跑出完整直播文稿，打回重跑某段不影响其他段 |
| M2 记忆闭环 | 记忆库全部 Agent 落地 + 打回意见自动沉淀 + 重跑注入 | 同一错误第二次打回率显著下降 |
| M3 工作台 UI（B 方案） | 任务看板 + 产物卡片 + 质检红绿灯 + 审查操作 + 规则编辑器 | 全程可视化，不再依赖对话式操作 |
| M4 增强 | 多天批量跑（跨稿质检自动对账 day N-1 预告）、知识库增量导入 | 连续生成多天稿，跨稿质检 0 漏项 |
12. 风险与红线（设计内嵌，来自实战教训）
- 导图读取：手写/OCR 导图读不准的词，主控必须先列待确认清单问你再动稿（"龙蛇混杂/跟班戏"教训）
- 口径不沉淀：记忆库严禁把场次性口径（价格/头衔/技法名/产品组合）升级为跨稿规则（两轮纠正教训）；规则只沉淀"怎么讲"
- 质检报告≠事实：质检 Agent 的每条断言必须能对证正文，报告与正文脱节=质检自身 FAIL（"表面功夫"红线）
- 产品概念边界：一产品一概念（水润≠养护），全稿"养护"清零——写入内容质检固定检查项
- 上下文串扰：段 Agent 只读自己的切片+知识库，任何"参考其他段"的需求必须经主控显式授权（防止隐含口径漂移）
- 记忆噪音：L4 成功记忆不自动写入，只在你确认复盘时沉淀，避免"越用越偏"
- 合规底线：质检保留合规闸（无证宣称/绝对化用语/编造解剖名词），生成机制沿用防拒审信封（授权上下文只进后台不进正文）
待你确认的问题：
- 段 Agent 的默认划分（开场/心法/技法/场景/产品/收尾/互动标记 7 个）是否符合你脑子里的环节？要增减哪些？
- 落地路径选 A（今天就能跑）还是直接上 B（工作台 UI）？还是 A 先验证再 B？
- 记忆沉淀时机：打回意见自动沉淀（推荐）vs 全部手动确认，你倾向哪种？