Files
makelore/.project-docs/10-decisions/decision-index.md

43 lines
4.4 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
## Active Decisions
- [桌面智能体接入与微信绑定完成](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