架构决策记录
ADR 记录那些不应被静默改变的架构选择。中文入口与英文索引保持相同结构；完整记录、状态和决策编号继续以英文页面为源事实。
重点决策
| 决策 | 说明 |
|---|---|
| ADR 0001：Electron 桌面壳 | 桌面窗口与平台能力的承载层 |
| ADR 0005：本地插件系统 | 用户安装插件的第一阶段边界 |
| ADR 0009：English-first 全球化 | 源语言、术语和协作规则 |
| ADR 0010：Rust host core | 特权进程、RPC 与持久化的宿主边界 |
| ADR 0053：Plan checkpoint | 计划审批、artifact 和执行 epoch |
| ADR 0079：VitePress 文档站 | 双语文档站的结构与部署方式 |
| ADR 0083：自定义全局界面字体 | 设置字体选择器与系统字体枚举（内置字体已由 ADR 0298 移除） |
| ADR 0089：主动后台子代理委托 | 非阻塞 Task、TaskWait/TaskList/TaskStop 生命周期与权限作用域 |
| ADR 0090：用户可配置的关闭行为 | 首次关闭只问一次，关闭到托盘或退出，设置里可改 |
| ADR 0095：用厂商账户登录 | 用订阅账户代替 API 密钥，凭据留在主进程，sidecar 按请求取短时令牌 |
| ADR 0106：核心五条内置命令 | 将命令面板和输入框 / 菜单冻结为五条第一方命令 |
| ADR 0108：移除内置交互式终端 | 工作面板不再承载 PTY；交互式 shell 由外部终端承担，Agent Bash 保持非交互式 |
| ADR 0128：瞬时 provider 故障的有界重试 | 为瞬时 provider 故障共享一个有界重试预算，跨请求设置和流式传输阶段共用四次重试 |
| ADR 0131：大段 Composer 粘贴写入会话临时目录 | 超过可配置阈值的纯文本粘贴保存为会话临时文件，并在原位置插入内联 @ 引用 |
| ADR 0137：保留的会话面板 | 最近访问的会话各自保留一个已挂载的面板（上限三个），切换是可见性交换而不是重建转录 |
| ADR 0141：展开侧边栏宽度可调整 | 展开侧边栏通过右边缘手柄调整 240–520px 宽度；拖过 160px 会收起（ADR 0290） |
| ADR 0142：允许非回环 HTTP MCP 端点 | 支持局域网 MCP，并明确提示明文连接风险，插件仍受网络白名单约束 |
| ADR 0145：发布本机 macOS Intel 工件 | 通过匹配的 macOS 原生运行器发布 arm64 与 Intel x64 DMG/ZIP，两个架构工件均带有明确后缀，并合并更新源 |
| ADR 0148：明确禁用应用快捷键 | 缺少覆盖使用默认值，null 表示未绑定并关闭渲染器、菜单和启动器分发 |
| ADR 0174：宿主代发的插件补全与会话上下文 | 插件可通过公开 API 列出已登录模型、读取进行中工具会话，并由宿主代打一次性补全 |
| ADR 0175：解释安静的进行中回合 | 用安静间隔状态行说明停顿（已被 0198 扩展） |
| ADR 0176：按供应商覆盖 User-Agent | 每个 AI 服务/OAuth 行可设置可选 User-Agent（已被 0178 的 headers 映射取代） |
| ADR 0177：用户可配置的出站代理 | 设置里的系统/直连/自定义代理覆盖模型请求、市场、更新和内置浏览器 |
| ADR 0178：按供应商自定义 HTTP 请求头 | 每个 AI 服务/OAuth 行可在高级选项中编辑任意非敏感请求头 |
| ADR 0179：从本地智能体存储导入模型配置 | 设置 → 导入显式扫描 Claude Code / Codex / OpenCode / Pi 的提供商配置并复制 API 密钥 |
| ADR 0180：自定义全局文字缩放 | 设置外观按比例缩放全部界面文字，不使用 px，窗口缩放仍独立 |
| ADR 0181：主进程拥有的文件选择能力 | 文件选择路径留在主进程，以一次性令牌保护导入边界，并移除不支持的文件夹选择 |
| ADR 0182：繁体中文应用程序壳 | 提供独立的繁体中文外壳、系统语言解析和发版日志目录 |
| ADR 0183：P0 国际化应用程序壳语言 | 提供德语、西班牙语和法语完整外壳目录及发版日志 |
| ADR 0184：输入框工具栏中的上下文用量检查器 | 把剩余容量检查器移到模型选择器左侧，答案下方只保留模型徽章 |
| ADR 0185：韩语应用程序壳 | 提供完整韩语外壳、系统语言解析和韩语发版日志目录 |
| ADR 0186：用宿主一次性补全总结首轮会话标题 | 首轮提示先显示回退标题，结束后由主进程按会话模型生成摘要 |
| ADR 0187：按焦点区分任务和交互式本机通知 | 任务横幅仅在窗口失焦时出现；交互询问可通知聚焦的其他会话。字段名为 kind |
| ADR 0188：模型配置导入保留不同凭据 | 同一端点的不同 API 密钥作为独立提供商导入，相同凭据仍保持幂等跳过 |
| ADR 0189：父级终态错误中止残留委托 | 父级空闲仍不中止委托；429 等终态错误会中止残留子智能体，让“继续”不再 AGENT_BUSY |
| ADR 0190：宿主门控的大文件与拖拽文件访问 | 大文件范围读取与拖拽文件授权统一经过宿主权限网关，授权只覆盖单个文件且仅存于当前插件进程 |
| ADR 0191：明确标注两个 macOS 发布架构 | macOS DMG/ZIP 统一使用 -arm64 / -x64 后缀，更新源 URL 与校验和保持一致 |
| ADR 0192：为已配置模型设置别名并允许复制模型 id | 别名只用于展示；配置页模型 id 可选择复制，请求仍使用真实 id |
| ADR 0193：上下文检查器按最后一次请求计算占用 | 占用、本轮合计和缓存读写取最新一条助手消息，不再把工具循环里的每次请求加总 |
| ADR 0194：可选的子智能体思考覆盖 | 子智能体可继承、显式关闭或不发送思考参数 |
| ADR 0195：视口固定的工作面板开关 | 非设置页右上角提供与 Cmd/Ctrl+J 等价的指针开关 |
| ADR 0196：在进行中重试行显示 provider 原因 | 悬停或聚焦重试状态行时显示错误摘要、错误码和安全的 provider 消息 |
| ADR 0197：发布 Windows 免安装便携包 | Windows x64 通道额外发布可解压 ZIP，安装程序仍走应用内更新 |
| ADR 0198：为每个安静间隔命名活动行 | 补齐 starting / preparing / compacting / recovering，并在等待 Subagent 时展示各自的粗粒度动作 |
| ADR 0200：宿主拥有的插件会话导入与归属 API | 插件历史会话由主机生成 id，并按插件、来源和外部 id 归属 |
| ADR 0201：显式插件项目 id 与宿主拥有的会话刷新 | 插件可显式绑定主机项目，成功写入由主机通知渲染器刷新 |
| ADR 0204：未签名 macOS 首次启动助手 | 只清理 PI-Desktop 的 quarantine 属性，并用 Finder 一键启动可信的未签名应用（由 ADR 0232 修订） |
| ADR 0232：macOS DMG 只保留打开说明 | 由 ADR 0296 修订：DMG 现为双图标安装；ZIP 仍保留首次启动助手 |
| ADR 0252：插件的宿主回合结束事件 | 宿主在每次已开始的回合结束时向插件宣告一次 session:turnEnded，携带回合身份与终止原因 |
完整索引
与英文 ADR 索引 逐条对应，编号、顺序与状态保持一致；状态以英文记录为准。
| 编号 | 标题 | 状态 |
|---|---|---|
| subagent-model-opt-in | 区分子代理模型自动调度许可与定义固定模型 | 已接受待实现 |
| 0001 | Electron 桌面壳 | 已接受 |
| 0002 | 使用 pi Agent Harness 作为内核 | 已接受 |
| 0003 | 混合运行时 — Rust host core + Node pi agent sidecar | 部分被取代 |
| 0004 | MVP 中不提供远程 Gateway | 已接受 |
| 0005 | 本地插件系统 | 已接受 |
| 0006 | 推迟插件市场；先构建本地插件运行时 | 已接受 |
| 0007 | 插件分发包格式采用 .piplug（zip） | 已接受 |
| 0008 | 插件运行时以独立进程隔离为目标 | 已接受 （目标） |
| 0009 | English-first 全球化 | 已接受 |
| 0010 | Rust host core | 已接受 |
| 0011 | 冻结 host RPC、存储归属与模式默认值 | 已接受 |
| 0012 | 通过 pi-ai + OpenAI 兼容扩展覆盖所有 provider/模型 | 已接受 |
| 0013 | 将设置导航整合为四个目的地 | 部分被 ADR 0026 取代 |
| 0014 | 采用宿主拥有的存储 schema v2 | 已接受 |
| 0015 | 设置内容随窗口宽度响应式布局 | 已接受 |
| 0016 | 围绕保留的多项目标签组织侧边栏 | 已接受 |
| 0017 | 移除输入框工作区上下文栏 | 已接受 |
| 0018 | 让思考模式贯穿完整会话管线 | 已接受 |
| 0019 | 工作面板子系统（内嵌浏览器、git 审阅、文件浏览） | 部分被 ADR 0108 取代 |
| 0020 | 配置 provider 工作台 | 已接受 |
| 0021 | 平台应用外壳 | 部分被 ADR 0025 取代 |
| 0022 | 应用更新交付 | 已接受 |
| 0023 | 独立的对话会话分叉 | 已接受 |
| 0024 | 输入框斜杠命令与 @ 文件引用 | 已接受 |
| 0025 | Windows/Linux 窗口不显示应用菜单 | 已接受 |
| 0026 | 将项目索引作为归档移入设置 | 部分被 ADR 0036 取代 |
| 0027 | 让 pi-ai 成为模型元数据的权威来源 | 已接受 |
| 0028 | 将工作面板运行时上下文限定到对话 | 已接受 |
| 0029 | 分离原生窗口与工作面板的调整大小归属 | 部分被 ADR 0032 取代 |
| 0030 | 回合边界上下文检查点压缩 | 已接受 |
| 0031 | 输入框提示行不放品牌图标 | 已接受 |
| 0032 | 为停靠的工作面板预留原生宽度 | 已接受（由 ADR 0033 与 ADR 0122 修订） |
| 0033 | 内部停靠工作面板（不扩展原生窗口） | 已被 ADR 0122 取代 |
| 0034 | 将命令面板并入全局搜索 | 已接受 |
| 0035 | 通过 preload 桥暴露操作系统区域设置 | 已接受 |
| 0036 | 将设置拆分为 AI 与快捷键两个目的地 | 已接受 |
| 0037 | 在 Electron main 中解析项目指令 | 已接受 |
| 0038 | 在 Electron main 中桥接插件声明的 MCP 服务器 | 已接受 |
| 0039 | 激活插件技能并以第一方 devkit 提供插件开发 | 已接受（技能交付由 D174 修订） |
| 0040 | 常驻插件服务与插件间消息总线 | 已接受 |
| 0041 | 限制宿主运行时资源并解耦消息持久化 | 已接受 |
| 0042 | 消息级内联审阅卡片 | 已被 ADR 0043 取代 |
| 0043 | 消息拥有的审阅快照与受保护回滚 | 已接受 |
| 0044 | 会话绑定的项目指令预检 | 已接受 |
| 0045 | Bash 工具继承用户登录 shell 的 PATH | 已接受 |
| 0046 | 按类别拆分的进程日志文件 | 已接受 |
| 0047 | 带精确与估算 token 来源的上下文用量检查器 | 已接受 |
| 0048 | 按回合惰性激活工具 | 已接受 |
| 0049 | 用保留尾部恢复自动上下文压缩失败 | 已接受（预检守卫由 ADR 0282 修订） |
| 0050 | 有界的 provider 流恢复与诊断 | 已接受 |
| 0051 | 将 host RPC stdio 与 Tokio 阻塞池隔离 | 已接受 |
| 0052 | Plan 运行状态与审批边界 | 已被 ADR 0053 取代 |
| 0053 | Plan checkpoint | 已接受待实现 |
| 0054 | 可选择的命令 shell 目录与执行身份 | 已接受待实现 |
| 0055 | 仅 Agent 模式；Chat 成为内部只读配置 | 已被 ADR 0052 / ADR 0053 取代 |
| 0056 | 用户拥有的 MCP 服务器与技能，共享激活作用域 | 已接受 |
| 0057 | 权限门控的外部路径与可移植原生搜索 | 已接受待实现 |
| 0058 | 扩展页密度与主题可读的按钮表面 | 已接受 |
| 0059 | 将输入框剪贴板文件持久化到会话临时目录 | 已接受 |
| 0060 | 在 RPC 锁下归档重新生成分支 | 已接受 |
| 0061 | 无感知的后台上下文压缩 | 已接受（修订 ADR 0030 / ADR 0049；第 2/4/6/7/8 条由 ADR 0064 修订） |
| 0062 | Task 工具背后的有界子智能体 | 已接受待实现 |
| 0063 | 全局子智能体定义的托管界面 | 已接受待实现 |
| 0064 | 与 Codex 对齐的上下文压缩 | 已接受（修订 ADR 0061 / ADR 0030） |
| 0065 | 平滑的外壳布局与流式反馈 | 已接受待实现 |
| 0066 | 空首页直接使用底部输入框 | 已接受待实现（修订 D111） |
| 0067 | 受 ChatGPT 启发的空首页起始引导 | 已被 D206 取代 |
| 0068 | 为工作面板增加键盘入口 | 已接受待实现 |
| 0069 | 让原生工具的路径错误可恢复 | 已接受待实现 |
| 0070 | 将输入框文件引用展示与提示序列化分离 | 已接受待实现 |
| 0071 | 采用受 Apple 启发的全局圆角层级 | 已接受待实现 |
| 0072 | 增加全局插件启动器 | 已接受待实现 |
| 0073 | 暂存下一回合输入框配置并保留停止时的吞吐 | 已接受待实现 |
| 0074 | 插件的原生通知权限 | 已接受 |
| 0075 | 开发插件权限上限需手动重载 | 已接受 |
| 0076 | 在 host-core 中捕获 Windows 保留的插件启动器组合键 | 已接受 |
| 0077 | 增加交互式多问题 asktool | 已接受待实现 |
| 0078 | 跨平台托盘常驻最小化 | 已接受待实现（由 ADR 0117 与 ADR 0123 修订） |
| 0079 | VitePress 文档站 | 已接受 |
| 0080 | 启动后预热全局插件启动器 | 已接受 |
| 0081 | 宿主拥有的跨平台插件面板外壳 | 已接受 |
| 0082 | 本地化且随页面自适应的插件面板外壳 | 已接受 |
| 0083 | 自定义全局界面字体 | 部分被 ADR 0298 取代 |
| 0084 | 推迟新任务会话创建直到首条消息 | 已接受 |
| 0085 | 让工作面板快捷键成为开关 | 已接受（修订 ADR 0068） |
| 0086 | macOS 保持常规激活策略 | 已接受 |
| 0087 | 用行锚定、标签校验的契约取代文本匹配 Edit | 已接受待实现（修订 ADR 0043 / ADR 0069） |
| 0088 | 插件文件访问按模式声明，删除可恢复 | 已接受（延续 ADR 0008 D009） |
| 0089 | 主动后台子代理委托 | 已接受待实现 |
| 0090 | 用户可配置的关闭行为 | 已接受待实现 |
| 0091 | 将 provider 限流路由到有界的同回合重试 | 已接受（修订 ADR 0050） |
| 0092 | 使用插件拥有的表面与宿主窗口控制胶囊 | 已接受 |
| 0093 | 保持严格 46px 插件拖拽带与极简胶囊 | 已接受 |
| 0094 | 每个数据目录只允许一个桌面实例 | 已接受 |
| 0095 | 用厂商账户登录 | 已接受待实现 |
| 0096 | 扁平化设置目录并就近放置市场源配置 | 已接受 |
| 0097 | 将全局默认值放在 AI 设置目的地下 | 已接受 |
| 0098 | 将每个厂商 OAuth 账户视为独立的 provider 行 | 已接受待实现 |
| 0099 | 为设置目录增加带标题的视觉分组 | 已接受 |
| 0100 | 内置子智能体继承父级权限模式 | 已接受 |
| 0101 | 按模型感知的图片附件传输 | 已接受 |
| 0102 | 发布者拥有的插件源与 Git 托管的工件存储 | 已接受待实现（取代 ADR 0006） |
| 0103 | 紧凑的上下文用量摘要 | 已接受（修订 ADR 0047） |
| 0104 | 插件贡献的工作面板视图 | 已接受 |
| 0105 | 将 Files 作为捆绑插件发布；Review 留在宿主 | 已被 ADR 0241 取代 |
| 0106 | 核心五条内置命令 | 已接受 |
| 0107 | 让当前会话任务通知抑制原子化 | 已接受 |
| 0108 | 移除内置交互式终端 | 已接受 |
| 0109 | 用操作系统关联应用打开 Files 条目 | 已接受 |
| 0110 | 为插件面板外壳间距契约设定版本 | 已接受 |
| 0111 | 在操作系统文件管理器中显示 Files | 已接受 |
| 0112 | Agent 能力管理根目录与设置 IA | 已接受 |
| 0113 | 立即持久化新任务空槽并按消息数去重 | 已接受 |
| 0114 | 持久化 provider 模型绑定与思考配置 | 已接受 |
| 0115 | 插件剪贴板历史由宿主拥有并保存在内存中 | 已接受（于 2026-08-21 修订） |
| 0116 | 将 OpenCode Go 作为固定 provider 预设 | 已接受（已修订：会话路由请求头） |
| 0117 | 原生最小化时保留 Windows 任务栏条目 | 已接受 |
| 0118 | 队列中的提示由渲染器拥有，并在回合边界停止运行 | 已接受 |
| 0119 | 事件驱动的子智能体超时 | 已接受待实现 |
| 0120 | 有界的会话历史窗口 | 已接受 |
| 0121 | 输入框提示增强保持一次性且由主进程拥有 | 已接受 |
| 0122 | 工作面板可见时预留原生宽度 | 已被 ADR 0151 取代 |
| 0123 | Windows/Linux 窗口控制使用原生任务栏最小化 | 已接受 |
| 0124 | 将临时会话绑定到独立的临时工作区 | 已接受 |
| 0125 | 渲染器交付派生品牌标记与压缩输出 | 已接受 |
| 0126 | Agent 能力页面是一个可创作的工作台 | 已接受 |
| 0127 | 转录布局索引与基于身份的截断 | 已接受 |
| 0128 | 瞬时 provider 故障的有界重试 | 已接受 |
| 0129 | 子智能体空闲看门狗约束沉默而非缓慢 | 已由 ADR 0166 修订（看门狗不再终止） |
| 0130 | 有界的已挂载转录窗口 | 已接受 |
| 0131 | 大段 Composer 粘贴写入会话临时目录 | 已接受 |
| 0132 | 将跨显示器窗口移动归因于用户 | 已接受 |
| 0133 | 使用 models.dev 作为主模型目录并以 pi-ai 回退 | 已被 ADR 0134 取代 |
| 0134 | 使用 models.dev 作为唯一模型元数据来源并保留本地快照 | 已接受 |
| 0135 | 重试未修改的已编辑提示 | 已接受 |
| 0136 | 跨上下文压缩保留活动任务边界 | 已接受 |
| 0137 | 保留的会话面板 | 已接受（修订 ADR 0130 第 4/5 条） |
| 0138 | 子智能体对等消息 | 已被 ADR 0147 取代 |
| 0140 | 将三个 Peer 工具合并为一个 Peer 工具 | 已被 ADR 0147 取代 |
| 0141 | 展开侧边栏宽度可调整 | 已接受 |
| 0142 | 允许非回环 HTTP MCP 端点 | 已接受 |
| 0143 | 会话标题可由用户重命名 | 已接受 |
| 0144 | 允许用户配置的思考级别覆盖 | 已接受 |
| 0145 | 发布本机 macOS Intel 工件 | 已接受（由 D353 / ADR 0191 修订） |
| 0146 | 按边界分配外层与内层工作面板的调整大小归属 | 已被 ADR 0151 取代 |
| 0147 | 子智能体协调的 A2A 协议栈 | 已被 ADR 0165 取代 |
| 0148 | 明确禁用应用快捷键 | 已接受 |
| 0149 | 平静的转录运行状态动效 | 已接受 |
| 0150 | 内联 SVG 空首页 agent 标记 | 已被 ADR 0152 取代 |
| 0151 | 将工作面板保持在固定应用窗口内 | 已接受 |
| 0152 | 八帧空首页吉祥物 GIF | 已接受 |
| 0153 | 在转录旁为流式回复建立检查点 | 已接受 |
| 0154 | 在宿主 IO 之前显示新任务空目的地 | 已接受 |
| 0155 | 增加智谱 / Z.AI 命名端点预设 | 已接受 |
| 0156 | 简化添加 provider 的常见路径 | 已接受 |
| 0157 | 主进程拥有的 GitHub issue 反馈 | 已接受 |
| 0158 | 保持审批卡片聚焦并记住所选模式 | 已接受 |
| 0159 | 生成的插件设置与插件局部快捷键 | 已接受 |
| 0160 | 内置区域设置注册表与可搜索的语言选择器 | 已接受（由 ADR 0182 修订） |
| 0161 | 与语言选择器一致的可搜索主题选择器 | 已接受 |
| 0162 | 跨会话 A2A 寻址 | 已被 ADR 0165 取代 |
| 0163 | 转录文件引用渲染为可预览的芯片 | 已接受 |
| 0164 | 父级 agent 跨对话协作 | 已被 ADR 0165 取代 |
| 0165 | 撤回 A2A / Peer 协调栈 | 已接受（取代 ADR 0147 / ADR 0162 / ADR 0164） |
| 0166 | 由父级判断的子智能体生命周期 | 已接受（修订 ADR 0089 / ADR 0119 / ADR 0129；致命错误路径由 ADR 0189 修订） |
| 0167 | 由 Agent 选择的 Bash 超时 | 已接受（修订 ADR 0054 / D190 / D273） |
| 0168 | 主进程拥有的 openExternal http(s)/mailto 白名单 | 已接受（修订 ADR 0109） |
| 0169 | 插件视图的分类文件预览与实时工作区事件 | 已接受（修订 ADR 0104 / ADR 0105 / ADR 0109 / ADR 0111） |
| 0170 | 将工作面板浏览器作为捆绑插件通过公开 CDP 交付 | 已接受（修订 ADR 0019 / ADR 0104 / ADR 0105） |
| 0171 | 宿主拥有的已完成回合 token 历史 | 已接受（由 ADR 0173 修订） |
| 0172 | 受约束的聊天内图片显示 | 已接受（修订 fs/read 仅工作区条款） |
| 0173 | 插件拥有的 token 用量仪表盘 | 已接受（修订 ADR 0171） |
| 0174 | 宿主代发的插件补全与会话上下文 | 已接受（修订 D019） |
| 0175 | 解释安静的进行中回合 | 已接受 |
| 0176 | 按供应商覆盖 User-Agent | 已接受（修订 ADR 0095 / ADR 0156；请求头映射已被 ADR 0178 取代） |
| 0177 | 用户可配置的出站代理 | 已接受 |
| 0178 | 按供应商自定义 HTTP 请求头 | 已接受（修订 ADR 0176 / ADR 0095 / ADR 0156） |
| 0179 | 从本地智能体存储导入模型配置 | 已接受 |
| 0180 | 自定义全局文字缩放 | 已接受 |
| 0181 | 主进程拥有的文件选择能力 | 已接受 |
| 0182 | 繁体中文应用程序壳 | 已接受（修订 ADR 0160） |
| 0183 | P0 国际化应用程序壳语言 | 已接受（修订 ADR 0160 / ADR 0182） |
| 0184 | 输入框工具栏中的上下文用量检查器 | 已接受（修订 ADR 0047 / ADR 0103） |
| 0185 | 韩语应用程序壳 | 已接受（修订 ADR 0160 / ADR 0183） |
| 0186 | 用宿主一次性补全总结首轮会话标题 | 已接受 |
| 0187 | 按焦点区分任务和交互式本机通知 | 已接受（修订 ADR 0107 / D117） |
| 0188 | 模型配置导入保留不同凭据 | 已接受（修订 ADR 0179 / D342） |
| 0189 | 父级终态错误中止残留委托 | 已接受（修订 ADR 0166 / D328） |
| 0190 | 宿主门控的大文件与拖拽文件访问 | 已接受 |
| 0191 | 明确标注两个 macOS 发布架构 | 已接受（修订 ADR 0145 / D353） |
| 0192 | 为已配置模型设置别名并允许复制模型 id | 已接受（修订 D266） |
| 0193 | 上下文检查器按最后一次请求计算占用 | 已接受（修订 ADR 0047 / ADR 0103 / ADR 0184） |
| 0194 | 可选的子智能体思考覆盖 | 已接受待实现 |
| 0195 | 视口固定的工作面板开关 | 已接受（修订 ADR 0068 / ADR 0085） |
| 0196 | 在进行中重试行显示 provider 原因 | 已接受（修订 ADR 0175） |
| 0197 | 发布 Windows 免安装便携包 | 已接受（修订 ADR 0022 / D126 / D603） |
| 0198 | 为每个安静间隔命名活动行 | 已接受（修订 ADR 0175 / ADR 0186） |
| 0200 | 宿主拥有的插件会话导入与归属 API | 已接受 |
| 0201 | 显式插件项目 id 与宿主拥有的会话刷新 | 已接受 |
| 0202 | 暴露有效的子智能体思考元数据 | 已接受 |
| 0203 | 桌面操作的本地 MCP 控制平面 | 已接受（由 D372 修订） |
| 0204 | 未签名 macOS 首次启动助手 | 已接受（由 D406 / ADR 0232 修订） |
| 0205 | 远程 Agent 控制使用专用的 Host 边界 | 已接受待实现（MVP 之后；由 D376 修订） |
| 0232 | macOS DMG 只保留打开说明 | 已接受（由 D457 / ADR 0296 修订；修订 D371 / ADR 0204） |
| 0241 | 文件视图改为 vendor 的可更新插件 | 已接受（取代 ADR 0105；issue #304） |
| 0242 | 仅增量且合并的流式更新 | 已接受（修订 0127 / 0130 / 0149 / 0153；issue #299） |
| 0243 | 技能市场公网 HTTPS 目录拉取 | 已接受（修订 ADR 0009；issue #287 / PR #290） |
| 0245 | 加固 MCP 市场公网网络边界 | 已接受 |
| 0262 | 聊天里的文件引用在主进程补全，并在文件视图中打开 | 已接受（修订 ADR 0163 / ADR 0241） |
| 0263 | 向插件视图暴露项目的文件夹根，并跨根补全引用 | 已接受（修订 ADR 0262；ADR 0249 §5） |
| 0264 | 交给宿主执行的文件动作跟随视图正在浏览的文件夹 | 已接受（修订 ADR 0263；ADR 0249 §5） |
| global-sidebar-pins | 在侧边栏全局显示置顶会话 | 已接受（修订 ADR 0016；issue #306） |
| active-turn-steering | 用 Alt+Enter 向当前回合补充指令 | 已接受 |
| 0251 | 删除项目会一并删除其拥有的会话 | 已接受 |
| 0253 | 移除子智能体轮次上限 | 已接受（取代 0062 / 0063 / 0119 / 0126 / 0166 / 0210 中关于 maxTurns 的条款） |
| 0265 | 排队队列的优先区块与行内操作 | 已接受待实现（修订 ADR 0213 / 0118） |
| 0267 | 插件标签跟随应用语言 | 已接受（修订 ADR 0160；ADR 0182） |
| 0272 | 按请求实际会走的线路判定公网地址 | 已接受待实现（修订 ADR 0243；issue #419 / PR #473） |
| 0276 | 官方插件渠道与备份渠道 | 已接受待实现（修订 ADR 0102；D442） |
| 0278 | 规范应用 ID net.aiuo.pi-desktop | 已接受（D443；修订 D141 / D371 / ADR 0204；issue #524） |
| 0279 | 可恢复的子代理委托 | 已接受待实现（修订 ADR 0062；ADR 0089；issue #513） |
| 0280 | 插件自有界面按宿主语言自行本地化 | 已接受（修订 ADR 0267；ADR 0159） |
| 0282 | 压缩摘要先重试并按实际提示大小预检，再回退保留尾部 | 已接受（修订 ADR 0049；issue #543） |
| 0283 | 远程 MCP 服务端 OAuth 2.1 认证 | 已接受 |
| 0284 | packages/host-runtime 的无头运行时边界 | 已接受（实施中）（D447；ADR 0205 R2 前置） |
| 0285 | packages/racp 的 RACP-WS 传输 | 已接受（实施中）（D448；ADR 0205 R2） |
| turn-process-and-thinking-display | 回合过程与思考展示 | 已接受（2026-09-20 修订） |
| 0289 | 签名的 macOS GitHub Release 与应用内更新 | 已接受（D450；修订 ADR 0022 / 0145 / 0191 / 0204 / D078） |
| 0290 | 恢复可拖拽侧边栏宽度，过窄时收起 | 已接受（D459；修订 ADR 0141 / ADR 0238） |
| 0291 | 移除设置页面的语音界面 | 已接受（修订 ADR 0281） |
| 0292 | 远端主机的 SSH 引导 | 已接受实施（D453；ADR 0205 R2b，扩展 ADR 0286） |
| 0294 | 项目存档改为列表 + 检查器 | 已接受（D455；修订 D267 / D168） |
| 0295 | 会话思考参数不发送 | 已接受（D456；修订 ADR 0194 / ADR 0144 / ADR 0221） |
| 0296 | 已签名 macOS DMG 改为双图标安装 | 已接受（D457；修订 ADR 0232 / ADR 0204） |
| 0297 | 提供商托管联网搜索作为适配器能力 | 已接受 |
| 0298 | 应用不再随包发布任何字体 | 已接受（D598；修订 ADR 0083 / D232） |
| registry-header-variable-spelling | Remote header variables accept the registry's {name} spelling | Proposed |
什么时候看 ADR
- 规格告诉你系统应该怎样工作。
- ADR 告诉你为什么选择这个边界，以及哪些替代方案被放弃。
- 决策日志记录更细的冻结条款和后续修订。
前往 英文 ADR 索引 查看完整记录，或打开 中文决策日志 按编号检索。
Tray session shortcuts
定时任务的调度、存储、权限与桌面入口决策见 ADR: Desktop automations。
ADR tray-session-shortcuts defines bounded native session groups and the renderer/Main ownership boundary.