docs(teacher): 记录一次发布与配置刷新集成
This commit is contained in:
@@ -10,11 +10,14 @@
|
||||
|
||||
## Decision
|
||||
|
||||
- 2026-09-29 用户确认一次显式发布和及时刷新并授权合并。Yuxi 管理员在可管理的原生智能体编辑页一次“保存并发布”即可更新 Makelore；普通保存只改草稿。Yuxi 固定不可变快照并携同一操作身份交给 WS，只有 WS 登记提交后才报成功，失败重试不发布后来编辑的草稿。WS 按来源绑定稳定老师 ID，首次复用唯一启用旧项，歧义需显式选择；保留默认、停用和历史，不自动合并旧身份，重新启用需要显式动作。
|
||||
- 前台每五秒读取小型目录 revision，进入模块及回到前台补查，变化才重新读取完整配置；后台停止轮询。刷新独立于聊天、输入和正在回答，不触发模型。Main 每次接受新问题仍读取当前版本，运行中的问题固定原版本，同项目可见聊天保持连续。 五秒是检查间隔，实际可见时间还包含网络请求，不承诺离线或故障时延迟。
|
||||
|
||||
- 2026-09-28 用户要求移除老师对话栏的结构化组件并确认合并；远程回复清理和恢复工作一并集成。新咨询由 Main 统一声明 `{reply, quickReplies}`，正文和 0–3 条可选快捷回复按所选智能体云端配置生成，客户端只提供入口事实、上下文与输出格式。超额新卡片保留正文及原文诊断，不截断或展示；历史卡片数量不改写。旧组件状态和快照作为不透明档案保留，不恢复交互、主动导入或进入模型上下文，旧组件修改路由已移除。 结果不确定的旧请求保留请求 ID、问题、引用与来源，客户端重试移除退役组件字段，Main 按已有请求身份返回结果，避免重复执行。
|
||||
- 2026-09-28 用户确认像微信联系人一样持续聊天，随后明确纠正：不同项目必须有不同会话，并授权修复及合并。唯一可见聊天身份为账号＋项目＋稳定 config_id；同一项目不按名称、默认标记、Pi 会话或发布版本创建第二个可见聊天。项目隔离历史、草稿、已读和模型上下文；本次范围为本机持久化，不含跨设备同步。
|
||||
- 新项目创建内部默认编程 Agent 并保存 defaultAgentId，会话直接列在项目下。打开项目不自动创建空会话，首次发送或显式新建才创建；历史 Agent ID、配置和 Pi 会话绑定保留。
|
||||
- Yuxi 拥有老师提示词、模型和所选 Skills、知识库、MCP、子智能体。Works Square 运营菜单首先展示下发列表，添加时从 Yuxi 选择并发布当前配置，支持多位、默认选择与启停，不维护第二份提示词编辑器或试聊界面。
|
||||
- 运营显式同步 Yuxi 配置产生不可变下发版本。每次接受新问题使用当前已下发版本，运行中的问题保持原版本；版本变化不另建可见聊天。配置与资源绑定固定，Skill 按问题建立运行快照，知识内容和远端工具仍由各自服务拥有；资源撤销可能阻止执行，版本不表示复制全部外部资源。
|
||||
- Yuxi 显式发布或运营同步产生不可变下发版本。每次接受新问题使用当前已下发版本，运行中的问题保持原版本；版本变化不另建可见聊天。配置与资源绑定固定，Skill 按问题建立运行快照，知识内容和远端工具仍由各自服务拥有；资源撤销可能阻止执行，版本不表示复制全部外部资源。
|
||||
- Yuxi 原生 Request/Run、PostgreSQL checkpoint 和 Redis 事件拥有云执行。Main 冻结本次账号、项目、来源 Pi 已完成分支的公开消息及老师话题，通过三个只读工具提供目录、UTF-8 文件行段和会话原文。文件按读取时内容提供，会话按本轮快照读取，不上传完整工程、Pi 原始日志或思考。
|
||||
- 本地工具只交给老师主线程：云端持久中断完整批次，Main 主动回传配对结果，关联 Run 续接同一问题。用户于 2026-09-27 授权改造读取工具：声明 read_protocol=2 的客户端支持按层目录与连续原文分页，每问题最多 12 批、成功结果累计 64 KiB、单页 8 KiB，剩余不足 512 字节时收尾；旧客户端保持六批。最后结果消费后显式禁止继续选工具并要求基于已有证据回答。保留原付款人、版本、上下文和截止时间；读取限当前项目，允许 .makelore/project.json，排除其余内部记录与 Git 数据，不提供本地写入或命令。
|
||||
- Works Square 验证学生编程资格，使用专用短期老师凭据；聊天模型费用记入学生 ai_programming / coding_teacher 账本。老师资源仍归 Yuxi 创建者，个人 Agents 模块继续创建者付费，老师问题不占创建者个人智能体金额上限。
|
||||
@@ -35,6 +38,8 @@
|
||||
|
||||
## Evidence And Release Boundary
|
||||
|
||||
- 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)。
|
||||
|
||||
- 2026-09-28 项目隔离修复源 `4b41c23a3a5e9da1a329b1b69930787a670163de` 已合入本地 main，纠正上述原跨项目假设。382 项相关测试、标准 typecheck、变更文件 lint、Vite 构建和 3 项 Electron 场景通过，覆盖同一智能体的双项目历史／草稿切换、升级导入及目录刷新；扩展 Main 仍有 66 项既有诊断。合并保持产品／测试与已验证源一致，沿用源证据；没有更新安装版或验收线上模型。见[修复源记录](../30-worklog/tasks/20260928-agent-project-chat-6644c06d.md)与[续接集成记录](../30-worklog/tasks/20260928-merge-agent-single-chat-9911c6df.md#project-isolation-correction-resume)。
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Decision Index
|
||||
|
||||
- 2026-09-29 修订[下发智能体咨询决定](ADR-2026-09-22-coding-teacher.md)：Yuxi 一次发布保持稳定老师身份；客户端五秒前台 revision 检查、入场/焦点刷新独立于聊天状态，保留项目连续聊天和运行快照。
|
||||
|
||||
- 2026-09-26 已确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)：某一领域杰出人物的能力转化而成的智能体，供平台学生使用；蒸馏属于实现方法，以真实案例验证领域能力；补充下方既有咨询技术决定。
|
||||
|
||||
- [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md)：2026-09-28 amended / implemented；按用户纠正，唯一持续聊天身份为账号＋项目＋下发智能体，不同项目隔离历史、草稿、已读与模型上下文，保留同项目无新话题入口的交互。Pi 来源／发布版本在每轮接受时冻结，同项目变化只轮转内部线程。旧全局聊天按每轮可证明的项目分入对应会话，保留原文件并开启新云端执行段；不明归属仅保留原档案。学生计费、统一只读工具和主线程正文保持；老师对话使用 reply-v1 正文与 0–3 条可选快捷回复，退役组件仅留原档案；本地恢复完整旧正文，无法完整恢复时显式重试且保留草稿；主动观察建议接入由独立任务继续并绑定对应项目。
|
||||
|
||||
Reference in New Issue
Block a user