docs: integrate teacher streaming into main

This commit is contained in:
2026-09-29 18:30:58 +08:00
parent 8ccc4650a2
commit 6dee9ea62c
6 changed files with 54 additions and 1 deletions

View File

@@ -1,6 +1,6 @@
# ADR: 官方编程老师与项目会话导航
- Status: Accepted / implemented, project-scoped ongoing chat amended 2026-09-28
- Status: Accepted / implemented, independent reasoning and answer streaming amended 2026-09-29
- Date: 2026-09-22
- Approval: 用户确认项目默认 Agent、项目下会话、多老师列表与移除试聊;随后确认使用 Yuxi 原生智能体、客户端提供三个只读工具、沿用学生账号付费,并要求实施及合并。2026-09-24 明确取消客户端固定老师/朋友分类,统一使用后端下发智能体,并要求合并上下文预算修复。
@@ -10,6 +10,8 @@
## Decision
- 2026-09-29 用户要求 Yuxi 老师智能体的思考过程与结果都流式展示并授权合并。Main 从既有主线程事件分别接收思考增量和可替换的回答预览,经现有项目聊天 SSE 下发;思考使用独立字段保存,运行时展开、结束后折叠并可重新展开,不混入正文、工具活动、后续模型上下文或带回草稿。结构化回复未结束时仅投影已解码正文,不显示 JSON 外壳或未完成快捷回复;最终回复仍完整解析并确认正文和卡片。新消息或工具续接替换当前正文预览,同一问题的思考保留;取消或失败保留已收到的片段与原文。子线程仍只推进游标。只展示上游实际返回的思考,不更改模型配置或生成替代思考。
- 2026-09-29 用户要求并授权合并可配置快捷提示。老师快捷提示由 Yuxi 的有序 `teacher_shortcuts` 配置拥有,每项分别保存展示文案 `label` 和实际提示词 `prompt`;最多 8 项,去除首尾空白后文案 1–40 字符、提示词 1–6000 字符。普通保存只改草稿,显式发布固定列表并以 `shortcuts` 下发;同一发布重试读取原快照。明确的空列表隐藏所有入口,历史快照缺字段或 null 保留客户端旧入口,未配置草稿提供可编辑的默认项。Makelore 按顺序渲染文案,点击通过普通提问发送实际提示词,聊天记录显示实际提问;目录刷新保留项目聊天和草稿。
- 2026-09-29 用户确认一次显式发布和及时刷新并授权合并。Yuxi 管理员在可管理的原生智能体编辑页一次“保存并发布”即可更新 Makelore;普通保存只改草稿。Yuxi 固定不可变快照并携同一操作身份交给 WS,只有 WS 登记提交后才报成功,失败重试不发布后来编辑的草稿。WS 按来源绑定稳定老师 ID,首次复用唯一启用旧项,歧义需显式选择;保留默认、停用和历史,不自动合并旧身份,重新启用需要显式动作。
@@ -40,6 +42,8 @@
## Evidence And Release Boundary
- 2026-09-29 流式源 `8ccc4650a2d36ea4a1a7426dbaffc8178255a5e3` 已合入本地 main。322 项相关单测、标准类型检查、变更文件 lint、生产构建及 1 项 Electron 流式交互通过;合并保持产品与测试源一致。已核对 Yuxi 提交中的思考事件生产与保留协议,无配套服务端变更。需更新客户端;生产模型是否返回思考仍取决于云端配置与供应商,未进行真实收费模型或安装版验收。扩展 Main 类型检查仍有 66 项既有诊断,未涉及修改的老师文件。见[源记录](../30-worklog/tasks/20260929-teacher-stream-f00acb6f.md)和[集成记录](../30-worklog/tasks/20260929-merge-teacher-stream-1e4177fe.md)。
- 2026-09-29 目录刷新源通过 208 项相关单测、类型/lint/Vite 构建及独立审查;合并保持产品与测试源一致。WS 先升级 `20260929_0099` 和 revision/发布接口,再更新 Yuxi 与客户端;无本次客户端数据迁移。以下旧发布记录为历史,不代表当前 WS migration head。见[本次集成](../30-worklog/tasks/20260929-integrate-teacher-ml-a19f72c4.md)。
- 2026-09-28 组件移除源 317def79129503062d15076585881ceae753055c 无冲突快进合入本地 main。47 项相关单测、12 项浏览器布局、1 项 Electron 咨询场景及类型/lint/构建通过;产品与测试保持源字节,沿用其验证。没有服务端或历史数据迁移;未推送、打包或更新安装版。见[源任务](../30-worklog/tasks/20260928-remove-teacher-cards-ef1cf59c.md)和[集成记录](../30-worklog/tasks/20260928-merge-teacher-cards-a09c07f3.md)。

View File

@@ -1,5 +1,7 @@
# Decision Index
- [老师思考与回答流式展示](ADR-2026-09-22-coding-teacher.md):2026-09-29 已合并;主线程思考独立保存与折叠展示,正文逐步投影并由最终回复确认,快捷回复仅完成后显示;思考不进入后续模型上下文、工具活动或带回草稿。
- [老师可配置快捷提示](ADR-2026-09-22-coding-teacher.md):2026-09-29 已合并;Yuxi 有序展示文案/实际提示词,显式发布冻结,WS 版本化下发,客户端普通提问;空列表隐藏入口,历史缺字段保持旧入口。
- 2026-09-29 修订[下发智能体咨询决定](ADR-2026-09-22-coding-teacher.md):Yuxi 一次发布保持稳定老师身份;客户端五秒前台 revision 检查、入场/焦点刷新独立于聊天状态,保留项目连续聊天和运行快照。