docs(coding-teacher): integrate read-only project context repair

2026-09-22 19:21:26 +08:00
parent 44e754a43e
commit 9b5324fb2e
9 changed files with 32 additions and 10 deletions
--- a/.project-docs/20-architecture/data-flow.md
+++ b/.project-docs/20-architecture/data-flow.md
@@ -4,7 +4,7 @@

 目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定；切换项目丢弃旧读取。

-问老师/显式引用 → Main 读取 WS 已发布定义与当前来源分支的已完成文本 → 固定话题版本并持久化 requestId → 当前账号模型网关 → Host SSE/本机话题存储 → 右侧面板。取消、重启中断和结果恢复以持久请求为准；关闭面板不取消模型。带回回答只追加主草稿，运营精确草稿版本试聊只用示例上下文。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
+问老师/显式引用 → Main 读取 WS 已发布定义与当前来源分支的已完成文本 → 为最近主会话/老师问答分配节选预算 → 固定话题版本并持久化 requestId → 当前账号模型网关。模型需要更多资料时，原生工具请求 → Main 校验账号/取消状态 → 只读当前项目目录/文本文件或捕获的会话原文 → 结果回传同一网关继续回答，最多六批读取后要求最终文本；输入预算包含工具数据，用量累加。回答 → Host SSE/本机话题存储 → 右侧面板；工具读取结果和原生思考不写入本机话题。取消、重启中断和结果恢复以持久请求为准；关闭面板不取消模型。带回回答只追加主草稿，运营精确草稿版本试聊只用示例上下文且无项目工具。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。

 ## Permanent wallet and recharge

--- a/.project-docs/20-architecture/module-map.md
+++ b/.project-docs/20-architecture/module-map.md
@@ -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 或工具；固定发布版本，账号/项目/来源会话隔离。见 [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 云配置、上下文节选/原文读取、本机话题、原生模型只读工具续接、Host API/SSE、独立右侧答疑与运营试聊 | 无 Pi worker 或写入/命令工具；复用 `coding-projects/project-files.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. |
--- a/.project-docs/20-architecture/system-overview.md
+++ b/.project-docs/20-architecture/system-overview.md
@@ -1,6 +1,6 @@
 # System Overview

-官方编程老师由 Works Square 运营维护一个版本化定义，MakeLore Main 按账号/项目/来源会话运行独立无工具答疑并持久化本机话题；Code 项目自动建立内部默认 Agent、会话直接列于项目下。该能力与个人云智能体及 Pi 执行独立。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
+官方编程老师由 Works Square 运营指定当前发布定义，MakeLore Main 按账号/项目/来源会话运行独立答疑并持久化本机话题。Main 可按需只读当前项目文件和捕获的会话原文；长上下文保留最近问答节选，原生工具结果经既有模型网关续接，仍无 Pi 执行、写文件或命令。Code 项目自动建立内部默认 Agent、会话直接列于项目下。该能力与个人云智能体独立。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。

 ## Current Architecture