feat: add app management, local inference controls, and task statistics

2026-09-18 08:20:45 +08:00
parent 6dd6297414
commit bbae893c45
103 changed files with 7962 additions and 1490 deletions
@@ -1,11 +1,16 @@
-# 会话监督
+# 监督者与会话监督

-会话监督定义对长会话、工具执行和异常状态的观察、判断与介入边界。
+监督者的目标设计统一工作回顾、会话监督与故事线图谱，以智能心跳作为定时唤醒机制。计划将已有智能心跳入口升级为监督者，避免新增重复应用。当前会话监督尚在设计中，图谱仅有模拟原型，统一应用尚未接入产品。

 ## 文档导航

 | 文档 | 权威职责 |
 | --- | --- |
 | [会话监督 PRD](./prd.md) | 监督目标、证据、介入方式和产品验收 |
+| [监督者应用产品设计](./supervisor-prd.md) | 应用定位、心跳分工、知识库关系与目标范围 |
+| [逻辑设计](./logic-design.md) | 整体架构图、图谱对象关系图、状态规则与需求映射 |
+| [UI 设计](./ui-design.md) | 应用导航、工作回顾、侧栏反馈及页面状态 |
+| [User Stories](./user-stories.md) | 监督者与故事线图谱的用户操作和验收场景 |
+| [故事线图谱设计](../story-graph/prd.md) | 图谱对象、环绕时间轴与实体交互 |

-当前尚无独立 User Stories、功能逻辑、UI、技术设计和进度文档。
+统一应用的技术设计与实施进度尚未制定；逻辑待定项见[逻辑设计](./logic-design.md)。现有心跳行为见[智能心跳](../smart-heartbeat/README.md)，原型范围见[Story Graph 演示](../story-graph/README.md)。
@@ -0,0 +1,137 @@
+# 监督者逻辑设计
+
+日期：2026-09-16。状态：目标设计，尚未接入产品。图中的连线表示逻辑依赖与数据流，不代表已实现的调用接口或数据库结构。
+
+本文承接[监督者产品设计](./supervisor-prd.md)、[故事线图谱设计](../story-graph/prd.md)和[User Stories](./user-stories.md)，定义触发、整理、展示与用户后续操作之间的关系。既有会话监督的证据和介入边界继续由[会话监督 PRD](./prd.md)约束。
+
+## 整体逻辑架构
+
+```mermaid
+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 而自动获得工具权限。收集证据由应用按所选范围提供，现有心跳不具备的知识库或笔记接入属于后续工作。
+
+工作回顾、监督反馈和图谱引用同一次整理的结论与来源。展示可以裁剪为阶段摘要、会话卡片或图形，但不能分别维护相互矛盾的结论。一次整理可以没有图谱变更，也可以有整理结果但无需主动通知。
+
+应用维护来源正文；监督者维护其产生的阶段总结、事件关联、实体描述与关系。图谱是这些对象的视图。图中“纠正”只更新整理内容或关系，修改来源正文仍需进入对应应用的编辑流程。
+
+## 图谱对象关系
+
+```mermaid
+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。
+
+技术设计需确认现有实体标识能否复用、来源定位与历史版本可用性、增量整理和并发运行如何避免重复结果、已有心跳计划如何兼容。按照现有能力选择最小实现，不预设新的历史快照、恢复框架或独立知识存储。
@@ -13,6 +13,8 @@

 ## 1. 背景

+2026-09-16 产品归属更新：本 PRD 继续定义会话监督能力。统一应用命名为“监督者”，整合智能心跳入口、工作回顾和故事线图谱，目标定位与知识库分工见[监督者应用产品设计](./supervisor-prd.md)。该整合尚未实现，不改变本文既有证据和介入边界。
+
 GoodBuddy 的魔法笔记已经提供一种有价值的交互：用户持续写作，AI 在右侧以长评、建议和
 警告进行评论，用户可以选择综合、扩展、润色、质疑或发散方向。该能力是内容分析，不是
 会话监督：
@@ -0,0 +1,50 @@
+# 监督者应用产品设计
+
+日期：2026-09-16。状态：目标设计已确认，尚未接入产品。
+
+本文定义监督者应用的定位、功能边界与知识库关系。[会话监督 PRD](./prd.md)继续负责对执行过程的观察、证据与介入边界；本文将该能力纳入更完整的工作回顾应用。
+
+## 产品定位
+
+监督者是持续关注指定工作范围的智能 Agent。用户可以主动要求回顾，也可以通过智能心跳定期唤醒它。它根据可见记录判断是否需要反馈、整理阶段或更新知识关联，没有值得反馈的变化时保持安静。
+
+| 名称 | 职责 |
+| --- | --- |
+| 监督者 | 应用名称，负责观察、回顾和解释工作进展 |
+| 智能心跳 | 按计划唤醒监督者的机制，保留计划与运行管理 |
+| 监督反馈 | 会话右侧的阶段回顾、问题提示与证据入口 |
+| 故事线图谱（Story Graph） | 呈现事件、知识实体及其随时间发展的关系 |
+
+FR-S1：将现有智能心跳入口整合、升级为监督者，不增加另一个平级重复应用。当前通过应用中心管理；未来应用市场提供同一应用的发现与启用入口。市场建设不应成为监督者落地的前置条件。
+
+FR-S2：应用包含“工作回顾”和“故事线图谱”两个主视图。设置管理关注范围、心跳计划、整理时机和反馈方式。原有计划、运行记录及用户启用、常驻偏好应保留；具体标识映射与数据迁移由后续技术设计确定，本轮不更名生产页面或存储字段。
+
+## 范围与触发
+
+FR-S3：首次启用时选择项目、会话及可用来源，生成前显示范围和时间区间。应用启用不等于默认观察全部内容。已有心跳的 Global、单项目和多项目范围语义由[智能心跳 PRD](../smart-heartbeat/prd.md)定义，统一应用时保留。
+
+FR-S4：支持手动回顾，并复用已有定时检查机制。每次整理只处理所选范围内的有界输入；无新增有效信息时不重复发送反馈。事件触发、阶段自动判定和增量整理策略尚待设计，不因 Agent 定位而默认获得工具执行能力。
+
+FR-S5：会话右侧在跟随模式下展示当前会话的监督反馈；固定到 Conversation、Task 或 Experiment 时保持所选目标并显示其名称，切换聊天不改变监督目标。跨会话总结在完整应用中展示。反馈包含结论、来源和“在图谱中查看”定位入口。用户主动选择“发到当前会话”才加入聊天消息，同一结果不重复触发侧栏和全局通知。
+
+FR-S6：监督者可提出整理与修改建议；已有会话监督的观察边界继续生效。自动更新图谱不能静默覆盖用户修改的描述、已确认的关系或已有知识库正文。取消整理后保留上次结果；失败说明受影响范围并允许重试，部分结果不得显示为完整回顾。
+
+## 与知识库的关系
+
+FR-S7：知识库管理资料、索引、检索和可复用知识；监督者管理工作事件、阶段总结与演变关系。故事线图谱共用现有来源，引用知识库对象，不复制一套资料正文，也不取代已有知识库图谱。
+
+一个知识实体可以关联多份资料，一份资料也可支撑多个实体。图谱的关系与阶段记录由监督者维护，原始内容由所属会话、笔记或知识库维护。新增功能的概念实体与现有图谱实体是否共用标识，需结合现有模型制定技术方案。
+
+FR-S8：本地知识库提供双向定位：资料详情可进入相关故事线图谱，图谱详情可返回资料及引用位置。已有本地条目显示“打开知识库条目”；新归纳提供“新建条目”或“补充已有条目”，先预览内容和引用再保存。外部引用沿用现有能力，打开已保存的有界片段及可用定位信息，不承诺重新打开远端原文；缺少位置时明确提示。外部知识库保持只读；不得因图谱整合而增加对 Dify、FastGPT、RAGFlow 的写入或批量同步。
+
+FR-S9：来源事实、自动归纳、待核对关联和用户确认内容分别标注。移除关联不删除原文，纠正操作可撤销。来源失效时显示不可用状态；回放历史时使用当时已有的归纳与依据，无法恢复旧版原文时明确提示，不能以当前版本冒充历史内容。
+
+## 落地范围
+
+触发、整理与结果共享规则，以及整体架构和图谱对象关系见[逻辑设计](./logic-design.md)。
+
+首个完整流程为：启用监督者、选择范围、生成回顾、进入图谱、核对来源、携带选定上下文继续讨论。知识库双向定位与内容补充随后接入同一流程。图谱关系辅助检索需单独验证效果，不作为首版默认检索策略。
+
+当前智能心跳已有计划和手动运行能力；会话监督仍在设计中；故事线图谱只有模拟数据 Demo；应用市场尚未实现。本文不构成这些目标能力已交付的证据。
+
+具体 UI 与验收见[UI 设计](./ui-design.md)和[User Stories](./user-stories.md)。图谱对象与操作由[故事线图谱设计](../story-graph/prd.md)定义。技术设计仍需确定实体标识、来源定位、历史版本能力、计划兼容及增量整理方式。
@@ -0,0 +1,27 @@
+# 监督者 UI 设计
+
+日期：2026-09-16。状态：目标设计，遵循根目录 [UI-DESIGN.md](../../../UI-DESIGN.md)。需求对应[监督者应用产品设计](./supervisor-prd.md) FR-S1 至 FR-S9。
+
+## 应用入口
+
+应用中心中的智能心跳入口升级为“监督者”，沿用既有启用、常驻与排序能力。未来应用市场使用同一应用身份。用户停用自动心跳时仍可手动回顾；停用应用时明确说明关联自动计划的处理，既有结果仍保留。停用与运行中任务的具体行为需在逻辑设计中确定。
+
+应用页使用共享 PageTabs 展示“工作回顾 / 故事线图谱”，右上角提供设置。设置包含关注范围、心跳计划和反馈方式，已有运行记录可从工作回顾进入，保留失败详情与手动运行入口。
+
+## 工作回顾
+
+页面顶部持续显示项目或 Global 范围、来源选择与时间区间。首次使用引导用户选择来源并生成回顾。默认查看最近一次成功结果，包含阶段决定、变化与未解决事项；每项附来源和图谱定位入口。
+
+手动“回顾当前进展”是主要操作。生成中显示进度与取消；空范围提供选择来源入口；有来源但没有有效变化时显示检查时间和“暂无新进展”。失败保留上次结果并标明时间，提供重试。部分来源不可用时列出遗漏范围。
+
+## 会话侧栏
+
+右侧通用助手工作栏中的监督面板展示“监督反馈”，沿用现有[工作栏设计](../assistant-workbar/prd.md)的布局和执行边界。跟随模式对应当前会话；固定模式持续显示所选 Conversation、Task 或 Experiment，切换聊天不改变目标。反馈卡片显示所属目标、阶段、结论、未解决事项及来源。
+
+“在图谱中查看”定位到对应阶段或节点；“继续讨论”先预览节点摘要和来源引用，允许用户移除不需要的内容，再进入会话。“发到当前会话”由用户主动触发。跨会话内容需显式显示范围，不能伪装成当前会话的观察。
+
+## 故事线图谱
+
+使用 master-detail 页面壳层，左侧选择故事线，中间浏览图谱，右侧按选中对象切换详情。平铺和圆形视图使用共享 SegmentedControl；同级页面导航仍使用 PageTabs。布局、连线与回放行为见[图谱设计](../story-graph/prd.md)。
+
+窄屏时故事列表收为选择入口，详情进入可返回的独立区域；保留文字事件列表作为图谱的替代入口。节点、连线与时间事件都可从列表选择，键盘焦点可见。颜色只辅助区分故事线，关系类型还需文字说明。缩放与平移不改变右侧当前选择。
@@ -0,0 +1,21 @@
+# 监督者 User Stories
+
+日期：2026-09-16。以下为目标验收场景，尚未接入生产验证。需求编号引用[监督者产品设计](./supervisor-prd.md)与[故事线图谱设计](../story-graph/prd.md)。
+
+| 编号 | 用户故事 | Given / When / Then | 需求 |
+| --- | --- | --- | --- |
+| US-S01 | 启用后知道监督者关注哪些工作 | 给定未配置的新用户；当从应用中心启用并选择项目、来源和时间；则生成前显示范围，未选来源不被自动纳入 | FR-S1、S3 |
+| US-S02 | 隔几天回来能继续上次工作 | 给定已有阶段记录；当打开工作回顾；则看到已有决定、未解决事项和来源，并可定位图谱 | FR-S2、S5 |
+| US-S03 | 自动检查不过度打扰 | 给定已启用心跳计划；当一次检查没有有效新变化；则记录检查结果，不重复推送旧反馈 | FR-S4、S5 |
+| US-S04 | 查看某个事件影响了哪些认识 | 给定时间点含多个事件；当展开并选择一个事件；则相关实体与连线高亮，详情提供事件原文位置 | FR-G2 |
+| US-S05 | 追溯同一个知识实体的多次变化 | 给定实体先后被提出、补充和修订；当选择该实体；则同时看到多个时间点及其关系，不复制为多个同名实体 | FR-G1、G3 |
+| US-S06 | 知道不同故事为什么有关 | 给定跨故事关联；当选择连接线；则展示关联类型、理由和两端依据，可确认、纠正或移除 | FR-S9、FR-G4 |
+| US-S07 | 复盘一段时间 | 给定已有过程记录；当选择时间区间；则总结只覆盖该范围，展示决定、变化和未解决事项；回放不使用未来结论 | FR-S9、FR-G5 |
+| US-S08 | 回到知识库核对依据 | 给定知识实体引用已有资料；当点击相关资料；则本地资料打开原条目及位置，且支持返回图谱；外部引用打开已保存片段与可用定位信息，缺少位置时提示 | FR-S7、S8 |
+| US-S09 | 补充知识而不重复保存 | 给定候选归纳与已有本地条目；当选择补充并确认预览；则修改原条目并保留引用；外部只读资料不提供写回操作 | FR-S8 |
+| US-S10 | 纠正错误关系 | 给定自动归纳有误；当修改或移除关系；则原文保留，可撤销，后续自动整理不静默覆盖用户修改 | FR-S6、S9 |
+| US-S11 | 带着已有认识继续讨论 | 给定选中的知识实体；当预览并确认摘要与来源；则会话携带所选上下文，后续内容可纳入下一次整理 | FR-S3、S5 |
+| US-S12 | 生成失败后仍能使用旧结果 | 给定已有成功回顾；当新一次整理失败或取消；则旧结果仍可访问，失败或部分完成状态明确，可重试 | FR-S6 |
+| US-S13 | 来源变化后不会误读历史 | 给定来源已更新或失效；当回放旧阶段并打开引用；则显示可用的历史依据，缺失旧版本时提示，不能将最新版称作当时原文 | FR-S9 |
+| US-S14 | 升级入口后原计划仍可管理 | 给定已有心跳计划和启用偏好；当应用升级为监督者；则保持计划、运行记录与偏好，不出现第二个重复应用入口 | FR-S1、S2 |
+| US-S15 | 在窄屏或仅用键盘时查看图谱 | 给定无法方便点击图形的用户；当使用事件与节点列表选择对象；则能查看相同详情、关系与来源，并返回原选择位置 | FR-G6 |