# 架构决策记录（ADR）

架构决策记录（Architecture Decision Record）逐项记录项目的关键架构决策： 背景、决策、后果。编号越大越新。以下列表按编号排列，全文见对应页面。

## 阅读指引

  • 当前架构**以 :doc:`architecture` 为准；ADR 记录决策的**历史语境， 两者不一致时以架构文档为准。

  • ADR-0001 至 0005 记录旧 GUI（tod/gui/）时代的决策，相关机制 （ScriptEntry 脚本注册、JobStatus、运行前确认弹窗）已随 ADR-0007 的 大爆炸替换废弃，仅作历史参考。

  • ADR-0006 起为现行 GUI 的决策：e2m2e 前端定位（0006）、大爆炸替换 （0007）、output/ 持久化（0008）、Pydantic 自动参数面板（0009）、 内嵌可视化（0010）、算法层直调（0011）、卡顿与接口边界依赖上游 （0012）、星历可视化坐标与时间约定（0013）、UI 迁移到 Tauri（0014）、 UI 组件库与参数覆写层（0015）、功能补齐与 catalog 分布（0016）、 Linux 打包（0017）、桌面自动更新（0018）、sidecar 子树生命周期 （0019）、严肃语义色板视觉语言（0020）、主画布时间轴（0021， 原与 0014 同号，已改编）、AI 助手定位与模型服务策略（0022）、 AI 助手架构（0023）、记录用户元数据归属 catalog 记录字段（0024）、 助手会话历史与多会话（0025）、思考等级与过程展示（0026）、助手宿主内置工具——情景生成/修改（0027）、会合视图保留质心原点与显示层感知修复（0028）。