docs(teacher): 集成 Yuxi 老师与学生计费边界
This commit is contained in:
@@ -4,7 +4,9 @@
|
||||
|
||||
目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定;切换项目丢弃旧读取。
|
||||
|
||||
问老师/显式引用 → Main 读取 WS 已发布定义与当前来源分支的已完成文本 → 为最近主会话/老师问答分配节选预算 → 固定话题版本并持久化 requestId → 当前账号模型网关。模型需要更多资料时,原生工具请求 → Main 校验账号/取消状态 → 只读当前项目目录/文本文件或捕获的会话原文 → 结果回传同一网关继续回答,最多六批读取后要求最终文本;输入预算包含工具数据,用量累加。回答 → Host SSE/本机话题存储 → 右侧面板;工具读取结果和原生思考不写入本机话题。取消、重启中断和结果恢复以持久请求为准;关闭面板不取消模型。带回回答只追加主草稿,运营精确草稿版本试聊只用示例上下文且无项目工具。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
|
||||
问老师/选择已下发老师 → Main 获取 WS 专用老师凭据,固定话题版本并保存问题身份与账号/项目/Pi 公开消息快照 → Yuxi 原生 Request/Run。持久读取中断 → Main 校验绑定与取消状态 → 列目录/读取文件/读取会话原文 → 主动 POST 完整配对结果 → checkpoint 关联 Run 续接。最多六批读取,保留原问题时限与学生付款人;文件使用读取时内容,会话使用本轮快照。云端保存消息和收到的片段,完整工程与 Pi 原始日志保留本机。
|
||||
|
||||
云端事件 → Main 先推进游标,再仅转发云端主线程文本 → Host SSE/本机历史 → 右侧面板。子智能体文本不混入正文或带回草稿;断线按游标与持久状态恢复。关闭面板不取消已接受问题,停止/退出请求取消原问题;重启后下次提问先停止旧问题。带回回答只追加草稿,不自动发送,旧本地老师话题保留原执行路径。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
|
||||
|
||||
## Permanent wallet and recharge
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
| Path | Responsibility | Owner Notes |
|
||||
|---|---|---|
|
||||
| `electron/coding-teacher/**`, `electron/api/routes/coding-teacher.ts`, `shared/coding-teacher.ts`, and `src/pages/Chat/Teacher*.tsx` | Main-owned 云配置、上下文节选/原文读取、本机话题、原生模型只读工具续接、Host API/SSE、独立右侧答疑与运营试聊 | 无 Pi worker 或写入/命令工具;复用 `coding-projects/project-files.ts` 读取当前项目。固定发布版本,账号/项目/来源会话隔离,试聊无真实项目工具。见 [teacher ADR](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 |
|
||||
| `electron/coding-teacher/**`, `electron/api/routes/coding-teacher.ts`, `shared/coding-teacher.ts`, and `src/pages/Chat/Teacher*.tsx` | Main-owned 老师选择、云凭据、项目/Pi 快照、三个只读工具、Yuxi 中断续接与本机话题 | `cloud-runner.ts` 跟随关联 Run 并按云端主线程路由正文;`read-tools.ts` 复用项目文件边界。账号/项目/来源会话隔离,无本机写入/命令,旧话题保留原路径。见 [teacher ADR](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 |
|
||||
| `electron/coding-projects/project-config.ts`, `src/pages/Chat/CodingProjectConversations.tsx`, and `src/components/layout/Sidebar.tsx` | 内部默认 Agent 与项目下会话导航 | 旧绑定保留;首次发送或显式新建创建会话,打开项目不创建。 |
|
||||
| `electron/coding-plugins/manifest.ts`, `release-descriptor.ts`, `signature-verifier.ts`, and `trusted-keys.ts` | Closed Plugin package/descriptor parsing, fixed code-owned resource roots, compatibility checks, canonical archive validation, and Ed25519 trust | Data Service plus exact Game Resource, Game Audio and Project Scaffold roots are code-owned. Other schema-2 packages still pass descriptor/signature/archive validation; downloadable P0 Skill assets remain text/image-only. Hosted Web Search is not a current Plugin root. |
|
||||
| `electron/coding-plugins/account-plugin-cache.ts`, `marketplace-client.ts`, and `package-store.ts` | Main-owned Account Library cache, authenticated server client, and atomic immutable device installation store | Account acquisition and device installation are separate. Package bytes switch atomically only after descriptor, signature, archive, client-range, and provenance checks; failed updates preserve the prior current release. |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# System Overview
|
||||
|
||||
官方编程老师由 Works Square 运营指定当前发布定义,MakeLore Main 按账号/项目/来源会话运行独立答疑并持久化本机话题。Main 可按需只读当前项目文件和捕获的会话原文;长上下文保留最近问答节选,原生工具结果经既有模型网关续接,仍无 Pi 执行、写文件或命令。Code 项目自动建立内部默认 Agent、会话直接列于项目下。该能力与个人云智能体独立。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
|
||||
官方编程老师由 Yuxi 原生智能体执行,Works Square 运营选择下发、同步版本并指定默认老师。Main 按账号/项目/来源会话管理本机话题,绑定当前项目和已完成 Pi 公开消息,执行云端请求的三个只读工具后主动回传结果;Yuxi 保存云端消息和收到的片段。学生支付老师模型费用,个人 Agents 保持创建者付费。正文只接收云端主线程文本,子线程事件仍推进续传游标。Code 项目默认 Agent、项目下会话和 Pi 执行保持原边界。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
|
||||
|
||||
## Current Architecture
|
||||
|
||||
|
||||
Reference in New Issue
Block a user