8.1 KiB
监督者逻辑设计
日期：2026-09-16。状态：目标设计，尚未接入产品。图中的连线表示逻辑依赖与数据流，不代表已实现的调用接口或数据库结构。
本文承接监督者产品设计、故事线图谱设计和User Stories，定义触发、整理、展示与用户后续操作之间的关系。既有会话监督的证据和介入边界继续由会话监督 PRD约束。
整体逻辑架构
flowchart TB
subgraph Entry["入口与触发"]
App["监督者应用"]
Scope["关注范围、时间区间与整理策略"]
Manual["用户主动回顾"]
Heartbeat["智能心跳：按计划唤醒"]
end
subgraph Sources["已有内容与状态"]
Conversation["会话记录"]
Notes["魔法笔记"]
Work["任务状态与执行记录"]
Knowledge["现有知识库资料与检索引用"]
end
subgraph Supervisor["监督者 Agent"]
Collect["收集范围内的有界可见证据"]
Review["理解进展与变化，判断是否需要整理"]
Result["带来源的整理结果"]
Quiet["记录检查结果，保持安静"]
end
subgraph Outputs["结果与展示"]
Recap["工作回顾：阶段决定、变化、未解决事项"]
Feedback["监督反馈：聊天右侧展示"]
Graph["故事线图谱：事件、实体、关系与演变"]
end
subgraph Actions["用户后续操作"]
Verify["核对来源、确认或纠正整理结果"]
Continue["预览所选上下文后继续讨论"]
Save["预览并确认新建或补充本地知识条目"]
end
App --> Scope
App --> Manual
Scope --> Collect
Manual --> Collect
Heartbeat --> Collect
Conversation --> Collect
Notes --> Collect
Work --> Collect
Knowledge --> Collect
Collect --> Review
Review -->|需要整理| Result
Review -->|无有效新变化| Quiet
Result --> Recap
Result --> Feedback
Result --> Graph
Recap -->|定位阶段| Graph
Feedback -->|定位相关对象| Graph
Recap --> Verify
Graph --> Verify
Verify -->|更新确认状态或用户修订| Result
Graph --> Continue
Continue --> Conversation
Graph --> Save
Save -->|仅写入可写的本地条目| Knowledge
心跳负责唤醒，监督者负责判断；模型不因被称为 Agent 而自动获得工具权限。收集证据由应用按所选范围提供，现有心跳不具备的知识库或笔记接入属于后续工作。
工作回顾、监督反馈和图谱引用同一次整理的结论与来源。展示可以裁剪为阶段摘要、会话卡片或图形，但不能分别维护相互矛盾的结论。一次整理可以没有图谱变更，也可以有整理结果但无需主动通知。
应用维护来源正文；监督者维护其产生的阶段总结、事件关联、实体描述与关系。图谱是这些对象的视图。图中“纠正”只更新整理内容或关系，修改来源正文仍需进入对应应用的编辑流程。
图谱对象关系
flowchart LR
Story["故事线"]
Event["时间事件"]
Change["事件与实体的关联：提出、补充、验证、修订"]
Entity["知识实体"]
Relation["知识关系：类型、理由、确认状态"]
Summary["阶段总结"]
Interval["时间区间与来源范围"]
Reference["来源引用：所属对象、位置、可用版本信息"]
Original["原内容：会话、笔记、本地资料或已保存外部片段"]
Story -->|组织| Event
Story -->|关联，可跨故事共享| Entity
Story -->|按阶段回顾| Summary
Summary -->|限定覆盖范围| Interval
Summary -->|归纳范围内事件| Event
Summary -->|概括当时的认识| Entity
Event -->|一个事件可影响多个实体| Change
Change -->|一个实体可经历多个事件| Entity
Entity -->|关系起点| Relation
Relation -->|关系终点| Entity
Event -->|原始依据| Reference
Change -->|变化依据| Reference
Relation -->|关联依据| Reference
Entity -->|支撑资料| Reference
Summary -->|结论依据| Reference
Reference -->|定位，不复制正文| Original
这里的关联对象用于说明关系自身也有类型和依据，不指定存储表。知识实体与来源为多对多关系；实体可以被多个故事引用，不能仅凭同名就合并。来源可用的版本信息沿用原内容能力，不要求为此复制完整来源历史。
外圈时间轴呈现事件及阶段标记，内部平铺实体；时间到实体的连线对应事件关联，实体间连线对应知识关系。时间轴上的同日聚合点只负责显示密集事件，不形成新的知识实体。
状态与处理规则
| 规则 | 条件或状态 | 处理与用户可见结果 | 需求与场景 |
|---|---|---|---|
| L1 范围 | 手动或定时触发 | 按本次所选范围、时间和输入预算收集证据；启用应用不扩大来源范围 | FR-S3、S4；US-S01 |
| L2 检查 | 没有有效新变化 | 记录检查结果，保留旧回顾，不重复通知；用户主动查看时仍可读取原结果 | FR-S4、S5；US-S03 |
| L3 整理 | 产生新的阶段认识或关联 | 回顾、反馈和图谱引用同一整理结果；是否主动反馈按反馈策略决定 | FR-S2、S5；US-S02、S04 |
| L4 失败 | 取消、失败或部分来源不可用 | 保留上次成功结果；显示当前运行状态、已覆盖与遗漏范围，支持重试；部分结果不标为完整 | FR-S6；US-S12 |
| L5 纠正 | 用户修改描述或确认关系 | 后续自动整理提出补充或修订建议，不静默覆盖用户内容；移除关系可撤销且不删除来源 | FR-S6、S9、FR-G4；US-S06、S10 |
| L6 历史 | 选择过去时刻或时间区间 | 使用当时已有的事件与认识；来源旧版不可恢复时提示，不以当前原文冒充旧版 | FR-S9、FR-G3、G5；US-S05、S07、S13 |
| L7 目标 | 侧栏跟随或固定 | 跟随时显示当前会话，固定时保持所选目标；切换聊天不改变固定目标 | FR-S5；US-S02 |
| L8 沉淀 | 用户选择写入知识库 | 先预览并确认，再新建或补充本地条目；已有条目提供打开入口，外部引用保持只读 | FR-S7、S8；US-S08、S09 |
| L9 继续 | 用户选择继续讨论 | 预览并确认上下文后进入会话；新内容在后续整理时纳入，不立即作为已确认知识 | FR-S3、S5；US-S11 |
| L10 展示 | 改变布局或输入方式 | 保留范围、回放时刻及选择；图形和文字列表访问相同对象与来源 | FR-G2、G5、G6；US-S15 |
整理运行状态与内容确认状态分开：一次运行成功不意味着所有自动归纳均已被用户确认。运行从待处理进入整理中，再结束为成功、无新变化、部分完成、失败或已取消；重试作为新一次整理显示，不能将失败运行改称成功。具体运行标识与现有心跳状态如何映射留待技术设计。
规则冲突时，先满足所选范围与既有观察边界，再保留用户修订和来源事实，最后应用自动归纳和展示策略。新增证据与已确认结论冲突时显示待核对差异，不能自动断言旧观点失效。
完整性与待定项
本设计覆盖触发、证据输入、静默检查、正常整理、取消与失败、跨视图共享结果、用户纠正、知识库写入及历史回放。它补充产品逻辑，不代表接口、持久化或迁移方案已经完成。
仍待产品决策：停用应用时计划及运行中任务的处理方式、事件触发与阶段识别条件、反馈频率与静默判定、实体合并与拆分的交互、时间轴比例和集中度含义。既有入口偏好、计划与运行记录的保留要求见 FR-S1、S2 和 US-S14。
技术设计需确认现有实体标识能否复用、来源定位与历史版本可用性、增量整理和并发运行如何避免重复结果、已有心跳计划如何兼容。按照现有能力选择最小实现，不预设新的历史快照、恢复框架或独立知识存储。