Files
makelore/.project-docs/10-decisions/decision-index.md
brother7 1c07f7b5cb
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
Merge remote main with teacher streaming and composer updates
2026-09-29 21:37:50 +08:00

57 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 检查、入场/焦点刷新独立于聊天状态,保留项目连续聊天和运行快照。
- 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 条可选快捷回复,退役组件仅留原档案;本地恢复完整旧正文,无法完整恢复时显式重试且保留草稿;主动观察建议接入由独立任务继续并绑定对应项目。
## Active Decisions
- [永久词元点数账户](../40-domain/business-rules.md#permanent-token-points):2026-09-22 用户确认 / 客户端已集成;移除会员、订阅、周额度与重置卡,新注册一次赠 100 点,旧权益取消且不补送、不折算,1 元兑 50 点且永不过期。本人余额与其他付款方可用性分开,云智能体及 Plugin 原有付款边界保持;依据源 `a1cce42` 与对应集成记录。
- [桌面智能体接入与微信绑定完成](ADR-2026-09-11-personal-cloud-agents.md):2026-09-20 amended / implemented;移除指定用户分享界面,入口改为“使用与接入”;确认微信绑定后收起二维码并提示下一步,路由和启用仍由用户明确操作。
- [知识文档处理与可用状态](ADR-2026-09-11-personal-cloud-agents.md#知识文档处理与可用状态):2026-09-15 amended / implemented;上传、导入、替换自动解析索引,持续刷新阶段与真实可用性,失败可恢复且保留旧资料。
- [知识库向量配置与平台承担](ADR-2026-09-11-personal-cloud-agents.md):2026-09-15 amended / implemented;embedding 由 Yuxi 配置并直连供应商,不计用户用量、词元点数或金额预算,聊天沿用原计费。
- [个人云智能体与微信渠道](ADR-2026-09-11-personal-cloud-agents.md):2026-09-14 amended / implemented;每个微信账号独立扫码、选择已发布智能体;只接受扫码身份,移除邀请/使用范围/调用者管理。多账号路由、创建者计费及历史内容隔离保留;真实部署验收待执行。
- [官方模型能力与原生思考选项](ADR-2026-09-12-official-model-capabilities.md):2026-09-12 accepted / implemented;one-api 官方事实、Works v2 授权投影、受管模型图片输入与 Main-owned reasoningChoice,取代受管模型的静态推测与 Pi 枚举映射。
- [个人云智能体平台](ADR-2026-09-11-personal-cloud-agents.md):2026-09-15 amended / implemented;三端分工、创建者付费及独立预算保留,桌面工作区面向非专业用户与 8–15 岁学生提供创建引导、基础要求、明确保存后重新试用和首次自用确认。“我的要求”与“高级设置”采用双 Tab,保留高级分类与未保存输入。保存/试用版本与恢复身份分离,验证及发布边界见决策。
| ID | Decision | Status | Date | Applies To | Detail |
|---|---|---|---|---|---|
| ADR-008 | 交互式 AI 应用使用单一内部默认类型;目录式创建、Main-owned UUID、项目级官方插件、可选 Scaffold Skill 与发布权威分离 | Accepted / implemented, amended 2026-09-07 | 2026-09-04 | Project creation、`ProjectType`/identity、Official Plugins、Marketplace delivery、project-wide activation、Game Resource auto-delivery、release readiness | `adr-008-interactive-ai-app-scaffold.md` |
| ADR-007 | AI Design 采用单一 Current Specification、Living Form 与不可变 Quote 的 V2 权威;active plan 与 reference alias 是其公共投影 | Accepted / implemented, amended 2026-09-07 | 2026-08-30 | AI Design Renderer、Electron Main、Works Square V2 API | `adr-007-ai-design-living-form-v2.md` |
| ADR-002 | Robot V1 采用 Main 门控的引导式热点配网并衔接现有六位 Binding | Accepted / implemented, default on | 2026-08-16 | Robot Renderer、Host API、Electron Main、现有固件热点入口 | `adr-002-robot-guided-hotspot-binding-v1.md` |
| ADR-003 | Robot 配网页内扫描并连接 Windows/macOS 热点 | Accepted / implemented with physical release gates pending | 2026-08-16 | Robot Renderer、Host API、Electron Main、Windows WLAN、macOS CoreWLAN/CoreLocation | `adr-003-robot-in-app-hotspot-connection.md` |
| ADR-004 | Works Square 统一拥有桌面认证生命周期边界 | Accepted / implemented | 2026-08-19 | Renderer、Host API、Electron Main、Works Square auth facade | `adr-004-square-auth-lifecycle-boundary.md` |
| ADR-006 | Makelore Code 以 Pi `0.84.2` 为唯一 runtime,父 Conversation 复用一个 Main-owned Agent Server 并隔离逻辑 Runtime/Session/provider/lease,产品只暴露 Snapshot/Patch 合同 | Accepted / implemented, amended 2026-08-31 | 2026-08-26 | Code Renderer、Host API、Electron Main、Pi runtime、Provider/resource、packaging | `adr-006-pi-runtime-hard-cutover.md` |
## Superseded Decisions
| ID | Decision | Superseded By | Date |
|---|---|---|---|
| ADR-001 | AI 绘画 Workspace / Conversation 状态归属 | ADR-007 | 2026-08-30 |
| ADR-005 | Learning 运营精选项目目录与下载边界 | 2026-09-04 用户产品决定:从 Makelore 移除 Learning;源 `5a7cb9b`,集成 `bd0873f` | 2026-09-04 |
## Decision Criteria
Create or update an ADR when a choice affects:
- project positioning
- architecture boundaries
- public behavior
- data model
- long-term maintenance
- user-facing workflow
- 2026-09-29 远程输入区与本地流式输出合并:[老师模型与语音、时间戳及独立介绍](ADR-2026-09-22-coding-teacher.md)保留项目聊天和云端人设;[桌面窗口/空作品预览边界](../20-architecture/system-overview.md#integrated-desktop-and-consultation-boundaries-2026-09-29)由 Main 持有。模型选择配套服务仍需单独上线。