Files
makelore/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md
brother7 e5d271bc45
Some checks failed
Electron E2E / Electron E2E (macos-latest) (push) Has been cancelled
Electron E2E / Electron E2E (ubuntu-latest) (push) Has been cancelled
Electron E2E / Electron E2E (windows-latest) (push) Has been cancelled
docs: integrate project conversations and coding teacher
2026-09-22 13:59:36 +08:00

2.1 KiB
Raw Blame History

ADR: 官方编程老师与项目会话导航

  • Status: Accepted / implemented
  • Date: 2026-09-22
  • Approval: 用户确认详细设计、实施及合入主分支。

Decision

  • 新项目直接创建一个内部默认编程 Agent 并保存 defaultAgentId;移除创建 Agent 的产品流程。会话直接列在项目下,项目打开不自动创建会话,首次发送或显式新建才创建。旧 Agent ID、配置和 Pi 会话绑定保留;归档、改名、未读与运行状态延续原合同。
  • Works Square 运营端配置一个官方编程老师,包括提示词、顺序启用的纯文本 Skills、模型及原生思考选项、展示信息和上下文/输出预算。草稿、不可变发布版本、启停和操作记录分离;版本写入使用 expected_revision。初始化停用,发布与启用必须显式操作。
  • MakeLore Main 使用当前登录账号的受管模型网关运行独立答疑,不启动 Pi、不提供工具、不执行 Skill 脚本。老师只读取当前来源会话活动分支中已完成的用户/助手文本、用户显式引用和本话题历史;不自动读取其他会话、文件、thinking 或工具参数。
  • 本机老师话题按账号、项目和来源会话隔离并固定发布版本;每次新问题检查在线启停,云端不保存学生老师聊天。先持久化请求身份再执行;重试读取原请求,取消和重启中断可见,来源会话删除时清理相关话题。
  • “问老师”位于编程右侧面板;带回建议只追加主输入草稿,不自动提交。运营桌面试聊要求 admin 和精确已保存 draft_revision,使用示例上下文。
  • 个人云智能体、Code/Pi 执行、现有网关付款规则和项目 Plugin 生命周期保持独立。本次不增加多老师管理、跨设备老师历史或长期记忆框架。

Evidence And Release Boundary

  • Server source: 93ece7c6aa5c61f1f20b5fe3fe98bb86bb57b6f7
  • Client source: 9242a40d87
  • 合并不代表部署。目标 PostgreSQL 需升级至 20260922_0095;运营需配置、试聊、发布并启用;真实模型与点数计费仍需发布验收。