docs(teacher): 集成 Yuxi 老师与学生计费边界

.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md

@@ -1,23 +1,23 @@
 # ADR: 官方编程老师与项目会话导航
 
-- Status: Accepted / implemented
+- Status: Accepted / implemented, amended 2026-09-23
 - Date: 2026-09-22
-- Approval: 用户确认详细设计、实施及合入主分支；随后确认运营指定当前老师，并要求恢复当前会话和项目文件读取后合并修复。
+- Approval: 用户确认项目默认 Agent、项目下会话、多老师列表与移除试聊；随后确认使用 Yuxi 原生智能体、客户端提供三个只读工具、沿用学生账号付费，并要求实施及合并。
 
 ## Decision
 
-- 新项目直接创建一个内部默认编程 Agent 并保存 defaultAgentId；移除创建 Agent 的产品流程。会话直接列在项目下，项目打开不自动创建会话，首次发送或显式新建才创建。旧 Agent ID、配置和 Pi 会话绑定保留；归档、改名、未读与运行状态延续原合同。
-- Works Square 运营端下发当前使用的官方编程老师，包括提示词、顺序启用的纯文本 Skills、模型及原生思考选项、展示信息和上下文/输出预算。客户端继续消费固定 `coding-teacher` 通道；老师列表、新建与当前选择由运营端负责。草稿、不可变发布版本、启停和操作记录分离；版本写入使用 expected_revision。发布与启用必须显式操作。
-- MakeLore Main 使用当前登录账号的受管模型网关运行独立答疑，不启动 Pi、不执行 Skill 脚本。默认上下文包含当前来源活动分支的已完成用户/助手文本、用户显式引用及本话题已完成历史。长消息按预算保留最近问答的首尾节选和消息 ID，面板显示节选提示；可按需读取本轮捕获的原文，不能进入其他来源分支或其他老师话题。
-- 老师可使用 Main 提供的只读目录、项目文本文件和会话原文工具。文件路径限于当前项目，允许 `.makelore/project.json` 配置；不读取其他 `.makelore` 会话数据、`.git` 内部数据，不修改文件或执行命令。复用既有文件服务的 UTF-8 与 256 KiB 预览上限，按行读取并明确标示截断。
-- 模型原生工具调用在 Main 内完成，最多六批读取后要求最终文本。工具定义、调用、结果与原生思考均计入输入预算；较早工具轮次成组省略，用量累计覆盖每次模型请求。读取与后续请求检查账号和取消状态；原生思考仅在必要的模型续接中保留，不投影或持久化，也不读取主会话 thinking 或工具参数。
-- 本机老师话题按账号、项目和来源会话隔离并固定发布版本；每次新问题检查在线启停，云端不保存学生老师聊天。先持久化请求身份再执行；重试读取原请求，取消和重启中断可见，来源会话删除时清理相关话题。
-- “问老师”位于编程右侧面板；带回建议只追加主输入草稿，不自动提交。运营桌面试聊要求 admin 和精确已保存 draft_revision，使用示例上下文。
-- 个人云智能体、Code/Pi 执行、现有网关付款规则和项目 Plugin 生命周期保持独立。客户端使用运营指定老师，不增加客户端老师选择列表、跨设备老师历史或长期记忆框架。
+- 新项目创建内部默认编程 Agent 并保存 defaultAgentId，会话直接列在项目下。打开项目不自动创建空会话，首次发送或显式新建才创建；历史 Agent ID、配置和 Pi 会话绑定保留。
+- Yuxi 拥有老师提示词、模型和所选 Skills、知识库、MCP、子智能体。Works Square 运营菜单首先展示下发列表，添加时从 Yuxi 选择并发布当前配置，支持多位、默认选择与启停，不维护第二份提示词编辑器或试聊界面。
+- 运营显式同步 Yuxi 配置产生不可变下发版本。新话题可选择已下发老师，默认使用运营指定老师；已有话题固定原版本。配置与资源绑定固定，Skill 按问题建立运行快照，知识内容和远端工具仍由各自服务拥有；资源撤销可能阻止执行，版本不表示复制全部外部资源。
+- Yuxi 原生 Request/Run、PostgreSQL checkpoint 和 Redis 事件拥有云执行。Main 冻结本次账号、项目、来源 Pi 已完成分支的公开消息及老师话题，通过三个只读工具提供目录、UTF-8 文件行段和会话原文。文件按读取时内容提供，会话按本轮快照读取，不上传完整工程、Pi 原始日志或思考。
+- 本地工具只交给老师主线程：云端持久中断完整批次，Main 主动回传配对结果，关联 Run 续接同一问题。最多六批读取，保留原付款人、版本、上下文和截止时间；读取限当前项目，允许 .makelore/project.json，排除其余内部记录与 Git 数据，不提供本地写入或命令。
+- Works Square 验证学生编程资格，使用专用短期老师凭据；聊天模型费用记入学生 ai_programming / coding_teacher 账本。老师资源仍归 Yuxi 创建者，个人 Agents 模块继续创建者付费，老师问题不占创建者个人智能体金额上限。
+- 云端保存老师消息、执行和收到的片段；Main 按账号、项目和来源会话保存话题索引与展示历史。旧本地老师话题保留原路径。停用阻止后续调用，历史仍可查看；断线按游标和持久状态恢复，重启后中断旧问题，下次提问先停止旧问题再绑定新上下文。
+- “问老师”仍是右侧独立答疑，用户发起，不主动巡查项目。正文、保存历史和带回草稿仅接收云端主线程文本；子线程事件仍推进续传游标。带回回答只追加草稿，不自动发送。Code/Pi 执行和项目 Plugin 生命周期保持各自边界。
 
 ## Evidence And Release Boundary
 
-- Server source: 93ece7c6aa5c61f1f20b5fe3fe98bb86bb57b6f7
-- Client source: 9242a40d874984159d71494ac6510f3a248e89c0
-- Context/file repair: 44e754a43ec6d286fee6b6492da0d1f9347770e6；56 项相关测试、1 项 Electron 流程、Renderer typecheck、scoped lint 与构建通过，Main 全量严格类型检查仍有既有 66 条诊断。
-- 合并不代表部署。云端迁移和运营发布按服务端集成记录执行；真实模型工具调用与点数计费仍需发布验收。此客户端修复不修改云端配置协议或数据库，也不要求新建老师话题。
+- 配套源：Works Square 79b1da574364d6f412e4395c179b5d27cc7bbd7d；Yuxi c2792dc4938a68db8ce1e34056e84af4b06c739b；MakeLore d20c818fe79bc5833cef15d99974b699dde71c6d。
+- 源验证包括 WS 66 passed / 1 skipped、Operations 125 项及构建/浏览器验证；Yuxi 2243 passed / 1 skipped、真实 HTTP/PostgreSQL/Redis/worker/SDK 续接验证；MakeLore 51 项相关测试、typecheck、lint、构建及已有 Electron 流程验证。模型使用明确替身，真实供应商扣款与完整生产拓扑未验收。
+- 合并不代表部署；需配套发布三个端及 Yuxi worker。本次无新增数据库迁移，WS 唯一 head 仍为 20260922_0096。老师模型必须在学生网关开放，既有云接入配置与被选资源依赖须就绪。
+- 本修订取代旧 Main 独立模型循环、云端不存老师消息、纯文本 Skill、客户端不能选老师等边界。历史实施与验证保留在源任务记录；当前机制见 [产品说明](../../README.md)。

.project-docs/10-decisions/decision-index.md

@@ -1,6 +1,6 @@
 # Decision Index
 
-- [官方编程老师与项目会话导航](ADR-2026-09-22-coding-teacher.md)：2026-09-22 accepted / implemented；项目默认 Agent、项目下会话、运营版本化教师定义和 Main 独立答疑；支持当前项目/会话只读工具、长上下文节选与原文恢复，无 Pi 执行或文件写入。
+- [官方编程老师与项目会话导航](ADR-2026-09-22-coding-teacher.md)：2026-09-23 amended / implemented；运营下发多位 Yuxi 老师并指定默认，Main 提供三个项目/会话只读工具、云端续接及主线程正文路由，学生账号付费。
 
 ## Active Decisions