docs: integrate project conversations and coding teacher
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

This commit is contained in:
2026-09-22 13:59:36 +08:00
parent 00ad84c094
commit e5d271bc45
9 changed files with 110 additions and 3 deletions

View File

@@ -0,0 +1,20 @@
# 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: 9242a40d874984159d71494ac6510f3a248e89c0
- 合并不代表部署。目标 PostgreSQL 需升级至 20260922_0095;运营需配置、试聊、发布并启用;真实模型与点数计费仍需发布验收。

View File

@@ -1,8 +1,8 @@
# ADR-008: 交互式 AI 应用 Scaffold 与官方项目插件采用项目级激活
- Status: Accepted / implemented, amended 2026-09-07
- Status: Accepted / implemented, amended 2026-09-22
- Date: 2026-09-04
- Last amended: 2026-09-07
- Last amended: 2026-09-22
- Applies to: Project creation, `ProjectType`, code-owned official project Plugins, scaffold Skill, release readiness
## Context
@@ -31,7 +31,7 @@
## Consequences
- 模板可随官方 Plugin 版本演进,不再扩大项目创建服务的职责,也不需要把脚本上传为 Marketplace artifact。
- 普通用户可从目录选择直接进入 `/chat`;没有 Agent 时显示非阻塞空状态并提供创建首个 Agent 的入口。Project Configuration 仍处理真正无效的 metadata,但不再承担初始化仪式。
- 普通用户从目录选择直接进入 `/chat`;Main 在项目配置中直接创建内部默认 Agent 并保存 defaultAgentId,不展示手动 Agent 创建步骤。会话列于项目下,打开项目不创建空会话;首次发送或显式新建才创建。历史 Agent ID、配置与 Pi 绑定保留。Project Configuration 继续处理真正无效的 metadata。
- 旧项目无需批量迁移即可继续打开、生成脚手架和发布;普通新写入使用内部默认 `interactive_ai_app`,既有 `custom` 与历史类型保持兼容。
- 发布规则在 Skill 中可被 Agent 解释和预检,但权威执行仍只有 Main 与 Works Square,避免形成第二套发布实现。
- 这三个代码所有官方身份的既有 Agent assignment 数据不再参与有效资源计算,可以原样保留;账号移除(适用时)或项目禁用仍会阻止新父 Agent 获得资源,运行中的 generation 仍按既有冻结边界切换。
@@ -66,3 +66,7 @@
- Simplified-creation source commit: `af13aca`
- Simplified-creation integration merge: `39d7b7e`
- Simplified-creation source task: `20260906-remove-project-gate-7c31`
## 2026-09-22 Amendment
用户明确批准并实施项目默认 Agent、项目下会话和独立官方编程老师;取代旧首个 Agent 创建入口及 Agent 分组导航。项目文件生成与发布边界不变。详见[编程老师决定](ADR-2026-09-22-coding-teacher.md)。

View File

@@ -1,5 +1,7 @@
# Decision Index
- [官方编程老师与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-22 accepted / implemented;项目默认 Agent、项目下会话、运营版本化教师定义和 Main 独立无工具答疑。
## Active Decisions
- [永久词元点数账户](../40-domain/business-rules.md#permanent-token-points):2026-09-22 用户确认 / 客户端已集成;移除会员、订阅、周额度与重置卡,新注册一次赠 100 点,旧权益取消且不补送、不折算,1 元兑 50 点且永不过期。本人余额与其他付款方可用性分开,云智能体及 Plugin 原有付款边界保持;依据源 `a1cce42` 与对应集成记录。