docs: record consultation integration checkpoint and registry blocker
Some checks failed
Electron E2E / Electron E2E (macos-latest) (push) Has been cancelled
Electron E2E / Electron E2E (ubuntu-latest) (push) Has been cancelled
Electron E2E / Electron E2E (windows-latest) (push) Has been cancelled

This commit is contained in:
2026-09-24 12:35:28 +08:00
parent 8a157be4f6
commit 0a8fce67a4
11 changed files with 44 additions and 11 deletions

View File

@@ -1,13 +1,15 @@
# Data Flow
## Project conversations and teacher chat
## Project conversations and distributed-agent consultation
目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定;切换项目丢弃旧读取。
问老师/选择已下发老师 → Main 获取 WS 专用老师凭据,固定话题版本并保存问题身份与账号/项目/Pi 公开消息快照 → Yuxi 原生 Request/Run。持久读取中断 → Main 校验绑定与取消状态 → 列目录/读取文件/读取会话原文 → 主动 POST 完整配对结果 → checkpoint 关联 Run 续接。最多六批读取,保留原问题时限与学生付款人;文件使用读取时内容,会话使用本轮快照。云端保存消息和收到的片段,完整工程与 Pi 原始日志保留本机。
统一智能体入口/选择已下发项 → Main 获取 WS 专用凭据,以所选或运营默认智能体创建项目级话题并固定版本 → 保存问题身份及当前账号/项目/本轮 Pi 公开消息快照 → Yuxi 原生 Request/Run。名称、人设和展示资料来自发布定义,不叠加本地老师/朋友人格。持久读取中断 → Main 校验绑定与取消状态 → 列目录/读取文件/读取会话原文 → 主动 POST 完整配对结果 → checkpoint 关联 Run 续接。所有下发项均遵守相同工具边界。最多六批读取,保留原问题时限与学生付款人;文件使用读取时内容,会话使用本轮快照。云端保存消息和收到的片段,完整工程与 Pi 原始日志保留本机。
云端事件 → Main 先推进游标,再仅转发云端主线程文本 → Host SSE/本机历史 → 右侧面板。子智能体文本不混入正文或带回草稿;断线按游标与持久状态恢复。关闭面板不取消已接受问题,停止/退出请求取消原问题;重启后下次提问先停止旧问题。带回回答只追加草稿,不自动发送,旧本地老师话题保留原执行路径。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
编译完整请求 → 本地路径按近似 Token 预算、云端路径按实际 JSON query 字节预算裁剪来源节选 → 提交前按同一计量复核。问题、明确引用及固定讨论指令保持完整;真正的固定配置超限单独提示。旧合成朋友历史和草稿只读展示,不创建新调用或自动绑定;现有结构化讨论、主动跟进和项目草稿继续使用统一咨询身份。
## Permanent wallet and recharge
账号菜单 / PointWallet → `src/lib/works-billing.ts` → Main 固定 `/api/works/billing/*` 路由 → Works Square 账务 API。Main 持有认证与账号绑定,通过 `shared/works-billing.ts` 的公开 DTO 投影余额、产品、订单及流水;充值沿用 Renderer capability,Renderer 不传付款人、价格、Token 或任意上游地址。账号切换后 Main 与账号绑定的 UI 丢弃迟到结果,打开菜单和窗口 focus 刷新当前账号。