06. 设置信息架构

翻译说明： 本页是与 英文源规格 一一对应的机器辅助翻译。代码、协议字段和标识符保持原文；如翻译与英文源事实有歧义，以英文版本为准。

1. 设置根目录（Codex 全页 shell）

设置是一个全窗口页面，取代了应用程序侧边栏+主镶边（Codex 电子行为）：

• 仅左侧设置导轨（侧边栏表面 #f4f4f4 浅色/#000 深色），~275px（Codex 金色，宽度为 1200）
• 铁路顶部：交通灯许可，返回应用程序（返回应用），药丸搜索设置...
• 横跨导轨和内容窗格的 46px 顶部带是一个原生窗口 拖动区域；交互式控件仍然明确不可拖动
• 带有图标的紧凑导航目录，按以下顺序：
  1. 基础 — Lucide SlidersHorizontal（外观，默认）
  2. 全局AI / AI - Lucide Sparkles（权限、上下文管理）
  3. 快捷键 — Lucide Keyboard（键盘快捷键）
  4. 说明 — Lucide FileText（全局和项目说明文件）
  5. 模型配置 — Lucide Bot（提供商和默认模型）
  6. 导入 — Lucide Download（从其他工具引入会话）
  7. 项目档案 — Lucide Archive（持久项目索引）
  8. 信息 — Lucide Info（版本、日志、更新、开发人员） 图标具有装饰性（通过 SVG 默认设置为 aria-hidden）并保持单色 带有导轨标签；不要在此处重复使用 refresh/rotate 字形。
• 不显示其他设置目的地或占位符导航行
• 主表面上的主要内容窗格，带有大部分标题+升高 圆形的行卡。其内容使用后可用的完整宽度 固定导轨和窗格排水沟，并随着窗口不断调整大小。

2. 章节内容

基础知识

• 外观卡：
  • 主题：三个可选预览卡（系统/浅色/深色、系统 首先）有一个实时迷你窗口模型、每个选项的描述和 选定的检查徽章；选择更新 settings.theme
  • 语言：三张可选预览卡（自动/简体中文/英语） 示例文本预览、每个选项的描述和选定的检查徽章； 选择更新 settings.language
  • 自动语言检测通过主进程解析操作系统区域设置 (app.getLocale()) 而不是渲染器的 navigator.language，并且 自动卡片内嵌显示检测到的语言（例如“当前：简体中文”）
  • 本机选择触发器及其打开的选项列表使用活动主题的 macOS、Windows 和 Linux 上的可读 foreground/background 配对；的 共享的本机选择契约适用于每个应用程序表面
• 默认卡保留主机支持的默认模式和输入发送 控制。
• 文件打开目标、菜单栏行为和底部面板行为不是 渲染直到其主机支持的设置模式和运行时效果存在。

全局 AI（ai 选项卡）

• 权限卡：全局权限模式控制 （询问/接受编辑/自动）控制代理如何自主行动。
• 命令 shell 卡：主机发现的本机 PowerShell 目录， cmd、Git Bash 和 ID 为 windows-powershell、cmd、git-bash 的 Bash 和 bash（如果支持）。选定的 defaultCommandShell 持续存在 重新启动；写入拒绝不可用或错误的平台 ID。如果一个坚持 选择稍后变得不可用，使用第一个可用的平台 shell 并显示回退状态。 Bash 回合验证其固定的 ID/dialect 执行前。
• 上下文管理无卡且无控件（D200 / ADR 0061，由 D203 / ADR 0064）。自动保护始终开启，其预算和 保留限制源自活动模型的窗口，因此有 用户不能从这里调整任何东西——参考实现不能 也暴露这些值。设置搜索索引没有压缩键。 手动 /compact 在空闲状态下仍然可以从命令面板中使用 会议；记录显示每次压缩发生的位置以及上下文 使用检查器显示是否安装了检查点。

快捷方式（shortcuts 选项卡）

• 键盘快捷键卡：
  • 列出来自一个共享快捷方式地图的导航、代理和窗口操作
  • 渲染平台本机修饰符标签（⌘ 位于 macOS 上，Ctrl 位于 Windows/Linux) 和平台特定的全屏默认值
  • 单击绑定记录下一个修饰和弦或 F1–F12； Escape 取消录音
  • 重复的应用程序绑定和 operating-system/editor-reserved 和弦 因内联错误而被拒绝
  • 每个覆盖都可以独立恢复，并且所有覆盖都可以 一起恢复
  • 覆盖持续存在于可选的 AppSettings.keybindings 中； macOS 本机菜单 加速器和渲染器拥有的快捷方式从同一地图更新
• macOS 和 Alt + Space 上的插件启动器默认为 Option + Space 在 Windows/Linux 上；它的本地全局注册遵循相同的覆盖， 而聚焦的无框窗口保留了 Alt + Space 后备

模型配置（agent 选项卡）

• Studio Hero：提供商计数、就绪计数和当前默认 provider/model 摘要
• 默认卡：
  • 通过分段控制（Agent / Plan / Goal）的默认操作模式，以及 Agent 选择新会话和新计划任务
  • 保留的旧 Chat 默认值显示并存储为 Plan
  • 默认模型ID
  • 输入以作为开关发送（本地偏好；不在 Codex General 黄金版上）
• 提供商工作室：
  • OpenAI 兼容的添加提供程序对话框（从添加提供程序/空状态 CTA 打开）
  • 带有头像缩写、主机、默认模型、秘密状态的提供商卡， 和测试/make-default/删除操作
  • add/edit 对话框仅配置连接身份（名称、端点、 API 样式、模型 ID 和密码）；模型参数来自 pi-ai，为 此处不可编辑
  • 具有主要添加操作的空状态
  • API 键在保存后永远不会显示原始内容

权限模式选择器在 Composer 中仍然可用，而 会话位于 Agent、Plan 或 Goal 中。在 Plan 和 Goal 中，它控制 Bash 仅确认：询问并接受编辑提示，而自动可能会运行变异 无需确认的 Bash 命令。默认卡必须描述两者 契约模式是意图边界，而不是严格的只读安全配置文件。

说明（instructions 选项卡）

• 编辑每个 PI-Desktop Agent 会话使用的全局指令 Markdown。
• 显示解析的指令文件路径并通过主机支持保存 指令 API；项目指令仍由活动项目管理 菜单并在全局层之后解决。

导入

• 扫描支持的当地代理店并通过以下方式审核候选人 SessionImportPanel
• 源和项目路径分组行为如下 08-组件规范 §18

项目档案

• 重用持久项目索引作为设置规模管理界面
• 始终包含存档记录；归档行被分组，从不隐藏，所以 目的地仍然没有可见性切换
• 支持项目搜索、添加、激活、项目会话扩展、固定、 archive/restore，然后关闭
• 布局为三个堆叠带 (D168)：
  1. 概述横幅 - 一句话意图，主要添加项目 操作和四个实时计数器（项目、打开、存档、会话） 总计来自构建下面列表的同一通道
  2. 工具栏 — 具有清晰可见性和匹配计数的搜索字段 搜索，加上两个选项排序分段控件（最近、名称）
  3. 分组索引 — 按“固定”、“全部”顺序始终可见的部分 项目，已存档；每个部分显示其标签和行数并呈现 它的行位于一个带有细线分隔符的设置面板内。空部分 被省略
• 行剖析：披露控制、颜色字形、带有状态标签的项目名称 （活动、开放、固定字形、已存档），一条元线携带缩短的 等宽路径、分支和会话计数、相对上次活动时间以及 hover/focus-revealed 操作对（新任务，行菜单）
• 行菜单对引脚上方的 create/edit 操作、archive/restore 和 破坏性的关闭动作，并在 Escape 或任何外部压力下关闭
• 项目搜索还匹配会议标题。匹配会话保留和 扩大其拥有的项目；扩展会议按最新活动排序， 显示计数和相对更新时间，并批量显示其他行 八个而不是默默地截断历史
• 激活项目或项目会话返回聊天；存档并关闭 即使活动工作空间发生变化，操作也会使项目存档保持打开状态

信息

• app/host/protocol版本+开放日志
• 使用当前交付状态和一项适用操作更新行： 检查更新、查看版本或重新启动以更新
• 开发者卡：
  • 开发者模式关闭，除非可选持续存在 AppSettings.developerMode 值是 true
  • 开发者模式开关解锁“打开控制台”按钮，每个按钮上按 F12 平台、Windows/Linux 上的 Ctrl+Shift+I 以及 macOS 查看菜单开发人员 工具项
  • 禁用开发者模式会关闭打开的控制台并禁用或删除 每个入口点；设置搜索索引卡、交换机和控制台 行动
• 更新行始终显示发行说明操作。它打开一个模式 包含按最新顺序排列的完整发布的稳定变更日志， 本地化为产品语言并标记当前可用的 存在的版本
• 当有更新可用、正在下载或已下载并附加主要更新时 双区域设置产品说明，更新行显示紧凑的“新增内容” 状态文本下的列表（与环境横幅相同的注释；D164）。的 当应用程序是最新的或更新时，完整历史模式仍然可用 检查在开发中被禁用

3. 导航规则

• 配置文件页脚/命令面板打开设置整页（默认基础知识）
• Composer 模型菜单和提供程序设置操作深层链接到提供程序 Agent 内的卡
• 插件管理仍然可以从独立的应用程序外壳中获得 插件目的地，包括加载、启用、禁用和卸载；是的 设置中不重复
• 项目档案由设置搜索索引，不会复制为主页 侧边栏目标或独立的全局搜索页面
• 返回应用程序返回聊天外壳

4. 验收

1.打开设置隐藏编码应用侧边栏（全页接管） 2. Rail 显示搜索+返回和精确的基础知识、全局 AI/AI、快捷方式、 说明、模型配置、导入、项目存档和其中的信息 订单 3.外观是Basics的一部分，没有独立的铁路目的地 4. Providers 是 Agent 的一部分，没有独立的铁路目的地 5. 插件没有设置目的地； app-shell 插件页面支持 加载、启用、禁用和卸载 6. Basics 仅显示主机支持的外观和默认卡；人工智能 目的地显示权限和命令 shell；快捷方式 目的地显示键盘快捷键卡；信息显示开发者卡。 不呈现其他设置目的地 7. 提供商机密从不显示原始密钥值 8.模型配置显示提供程序工作室（英雄+默认+添加对话框+卡片）而不是密集的始终在线表单转储 9.行描述使用语义辅助文本并保持至少4.5:1 与浅色和深色主题的卡片表面形成对比 10. 从“设置”两侧拖动空白顶部区域可移动本机 窗口，不会阻塞后退、搜索或导航控件 11. 调整窗口大小可扩展或收缩内容卡 可用内容窗格；固定导轨和窗格排水沟保持完好无损 页面没有水平溢出 12. 项目归档始终公开归档记录，并且可以在无需修复的情况下恢复它们 在应用程序 shell 中复制索引 13. 项目存档呈现概览计数器、搜索+排序工具栏以及 固定/所有项目/存档部分；柜台同意 呈现的行数，排序对每个部分内的行进行重新排序，而无需 隐藏任何内容，清除搜索即可恢复完整索引 14.信息呈现禁用、检查、最新、可用、下载、 已下载，并且错误更新状态而不添加其他目标 15. 本机选择选项列表在浅色和深色主题中仍然可读， 包括 Chromium 将打开的列表表面委托给 Windows 时；的 相同的全局规则涵盖非设置本机选择 16.快捷录音拒绝无修饰符的非功能键，保留 editor/OS 和弦，以及冲突；成功覆盖立即驱动 应用程序行为和 macOS 菜单加速器并在重新启动后继续存在 17. 开发者工具默认不可用；启用开发者模式 解锁本地化设置操作和平台快捷方式，持续存在 重新启动后，禁用它会关闭打开的控制台 18. 上下文管理根本不公开任何设置；保护始终开启并且 其预算随着活动模型的上下文窗口而变化，因此不会持续存在 值可能会使小窗口模型无法压缩或防护被禁用 19. 默认操作模式选择器包含 Agent、Plan 和 Goal；遗产 聊天值迁移到 Plan 并且不会重新显示为可选选项 20. 命令 shell 选择保留平台有效的目录 ID，公开 unavailable/fallback 状态，并且从不授权过时的 ID/dialect

5. Chrome 指标基础知识

外壳保留了 Codex 金铬，同时允许内容窗格使用 当前窗口宽度：

代币	价值
导轨宽度	〜275像素
轨道灯背景	#f4f4f4
主动导航药丸	更密集的 6px/10px 焊盘，~8px 半径，轨道上的灰色混合
章节标题	28px / 560，第一条基线 ~y70
内容宽度	栏杆和天沟后的完整可用窗格宽度
卡半径	~14px 升高行程
切换	32×20 拇指 16，中性重音（非绿色）
开放靶点药丸	前导 VS Code 字形