docs: integrate project conversations and coding teacher
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-22 13:59:36 +08:00
parent 00ad84c094
commit e5d271bc45
9 changed files with 110 additions and 3 deletions

View File

@@ -1,5 +1,11 @@
# Data Flow
## Project conversations and teacher chat
目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定;切换项目丢弃旧读取。
问老师/显式引用 → Main 读取 WS 已发布定义与当前来源分支的已完成文本 → 固定话题版本并持久化 requestId → 当前账号模型网关 → Host SSE/本机话题存储 → 右侧面板。取消、重启中断和结果恢复以持久请求为准;关闭面板不取消模型。带回回答只追加主草稿,运营精确草稿版本试聊只用示例上下文。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
## 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 刷新当前账号。