mesalogo
d80d42b032
Main no longer opens desktop business SQLite. A single utility-process
storage owner holds the Assistant, Knowledge, attachment, document-result,
remote-binding and native model-ledger databases and runs whole domain
transactions; Main and Runtime callers use explicit async domain operations.
- Remove the Main readWithFallback path and the supervision worker's
separate business write connection; manifests are scanned read-only and
committed by the sole writer.
- Remote events are ACKed only after commit; process loss reports
unconfirmed writes instead of replaying them.
- Use native utilityProcess messaging with one in-flight bound (32) and
ordered waiting instead of capacity rejection and retries.
- Start the storage process before the window so startup overlaps.
- Keep short tool output in memory and store full output once in owned
storage; paging, branching, restart and deletion reuse that copy.
- Put required runtime launch files under goodbuddy-prefixed owned temp
directories and reclaim confirmed stale ones; stop writing duplicate
parsed.md.
- Add lint guards for SQLite ownership and architecture, concurrency
acceptance fixtures, and maintenance/architecture documentation.
Validation: typecheck and lint pass. Alternating baseline (edf019aa) vs
candidate runs show no regression on single-session, C01, C02, C04 and a
5-minute C06; Main p99 drops from ~21 ms to ~16.7 ms under concurrency.
Fresh portable copy (1.75M events) upgrade content unchanged; real-model
output paging passes with 4 external requests. Full npm test runs had
1-9 different timing-sensitive failures per run that pass when rerun.
Not covered: C03 review publication, C07 source body, app-level C05.
监督者与会话监督
监督者统一工作回顾、会话监督与故事线图谱，以智能心跳作为定时唤醒机制。现有智能心跳页面承载监督者工作回顾入口，手动回顾、定时结果投影、来源原文、实体/关系确认、继续讨论、知识库预览提交和侧栏反馈已经接入。历史回顾定位到对应结果图谱；侧栏按会话或任务查询，并支持固定目标。同 scope 的跨 run 实体复用依赖模型显式选择 Main 提供的候选引用，Main 处理 UUID 和旧文本主键的精确映射，具体规则和验证边界见实施进度。
监督者可在“设置 → 模型”选择已有文本模型或跟随应用默认，连接与凭据复用规则及执行期间的模型一致性见监督者模型选择。
文档导航
主页面包含工作回顾、故事线图谱、自动监督、活动记录和设置。工作回顾阅读统一监督结果并选择历史，图谱定位同一结果；自动监督管理计划、监督建议和只读的旧报告。活动记录展示统一执行、进度、建议阶段及详情，可按计划 ID 筛选；设置管理模型选择和算法参数。当前布局以 UI 设计为准。活动读取实际手动回顾及心跳执行，合并展示同一次心跳触发的监督回顾与建议阶段；状态规则、历史缺失和保留期限见活动记录。
心跳的职责为“定时触发增量回顾＋按配置介入（建议）”，不再先生成独立报告；手动“回顾”默认增量，历史重看改为显式“重新整理”。规则见心跳职责与介入，需求 FR-S12，验收 US-S32、US-S33，2026-09-30 已实现（主动介入除外），验证见实施进度。
监督回顾按来源版本及正文位置增量处理，手动回顾与心跳共享进度，无变化时跳过模型；“重新整理”才重读所选区间。旧的进度、失败重试和删除边界见自动增量与手动重看。
未发布回顾在会话删除后省略相关来源并继续，具体覆盖和历史保留规则见会话删除。
| 文档 | 权威职责 |
|---|---|
| 会话监督 PRD | 监督目标、证据、介入方式和产品验收 |
| 监督者应用产品设计 | 应用定位、心跳分工、知识库关系与目标范围 |
| 逻辑设计 | 整体架构图、图谱对象关系图、状态规则与需求映射 |
| UI 设计 | 应用导航、工作回顾、侧栏反馈及页面状态 |
| User Stories | 监督者与故事线图谱的用户操作和验收场景 |
| 技术设计 | Main/Renderer 分层、数据模型、IPC、安全边界和实施顺序 |
| 时态 Story Graph MCP 设计 | 只读工具、时间与版本语义、Runtime 接入，以及后续跨范围事实复用和记忆过渡合同 |
| 回顾分块调度设计 | 第 0 节定义生产分页、批次持久化、续跑、当前设置及剩余边界；其余章节保留改造前基线、目标设计和原型证据 |
| 故事线模型改造设计 | 全局 › 项目 › 功能 › 子线索的故事层级、故事归属与经验抽取阶段、用户调整及实施顺序（目标设计） |
| 实施进度 | 已验证实现、验证证据和当前边界 |
| Renderer 修复与测量 | K01、K03、K04 的界面回归、源码 Electron 对照及测量限制 |
| 故事线图谱设计 | 图谱对象、环绕时间轴与实体交互 |
生产入口已接通完整来源分页、叶子持久化、持续处理至完成、活动页主动暂停/继续及批次详情；设置可调页大小、批次正文/消息上限、单次响应容量、两个模型超时和共享并发。实际合同及限制见生产接线。真实 DeepSeek 验证已覆盖一个完整的 27 条消息会话；较早的 129 条消息实验仍未完成。两次实验共 5 次付费请求，详情见进度。原始 AbortError 原因尚未由日志确定。
实施状态以代码和实施进度为准。逻辑待定项见逻辑设计，架构边界见技术设计。现有心跳行为见智能心跳，原型范围见Story Graph 演示。
Agent 可按需通过三个只读 MCP 工具读取决定、演变和来源。会话设置中的“使用故事图谱”默认开启，仅在监督者应用启用时显示；关闭会话开关或应用后不暴露工具并拒绝旧会话调用。规则见 MCP 接入合同，验证边界见实施进度。当前 memory 读取、精确 scope 增量进度和候选身份保留；跨 scope 叶子复用、读取入口切换及 as_of 仍属后续能力。