十类设置

设置使用唯一独立窗口，默认内容尺寸为 700 × 460 pt；打开后主工作区保持原尺寸、原内容并完整可见，运行中的终端不会中断。设置保持打开时，主窗口仍可切换或创建 Tab、操作和拆分 Pane，变化会立即显示。拖动设置窗口顶部可移动窗口；窗口四周都可以拖动调整尺寸，最窄 700 pt、最矮 460 pt；调整后的宽度和高度都会被记住，下次打开继续使用（换到更小的屏幕时自动收回到屏幕内）。黄色最小化按钮禁用，点击红灯只关闭设置窗口。Dock 右键菜单不提供“打开设置…”入口，也不会把设置窗口列为“Aster 设置”。

设置内容现在由 Aster 内置网页渲染，左侧保持通用、Shell、控制、编辑器、智能体、视图、外观、Recipes、快捷键和高级十类导航。顶部搜索会在全部分类中查找设置项；点击结果会跳到对应分类。开关、下拉、文本、颜色和滑杆会立即保存，错误值会显示提示并恢复当前真值。设置页面本身不联网，也不会打开 Otty 或其它产品页面；只有「更新 → 现在检查」和「控制 → 补全数据库 → 立即更新」两个按钮会由 Aster 主程序发起网络请求。

• “高级 → 配置文件”可打开 ~/Library/Application Support/Aster/settings.json；修改后点击“重新加载配置”。文件格式版本为 3，导入仍兼容旧版 Aster JSON。
• Windows 文本渲染会显示“Windows”标记；Aster for macOS 会保留该值供配置往返，但不会应用，也不能在当前平台编辑。
• “快捷键”中点击键帽后直接按新的组合键；修改会更新 AppKit 菜单快捷键并跨启动保留，Esc 取消本次录制。
• “Recipes”会列出 ~/Library/Application Support/Aster/Recipes 下的 .asterrecipe，可在 Finder 中定位或打开目录。
• 设置页保留系统动作的真实失败信息：例如 Shell 集成、Agent 集成、CLI 安装或配置导入失败时，不会把开关伪装成成功。

左侧导航固定为 200 pt 并延伸到窗口顶部；窗口拉宽时，右侧单列内容自动填满新增空间，卡片和控件随可用宽度调整，不会在右侧留下空白。左上角搜索使用中性灰背景，打开设置时不会自动获得输入焦点；点击搜索框可跨十类设置搜索标签与说明，选择结果会跳到对应分类和字段。右侧内容按「分组标题 + 圆角卡片」组织并从页面顶部开始，内容较长时可使用滚动条。切换分类只更换右侧内容，开关、滑杆、步进器与输入框都是就地响应；收到 Swift 真值快照后会保留当前分类。外观页的“左侧 Panel 宽度”和“右侧 Panel 宽度”编辑最近活动的工作区窗口。

• 通用：界面语言、启动行为、窗口关闭行为、关闭标签页 / 窗口 / 面板的确认策略，以及系统集成（注册为 ssh:// 链接的默认终端、常用外部应用的默认终端、Finder「在 Aster 中打开」服务、完全磁盘访问入口），以及软件更新（自动检查、自动下载安装、稳定/预览通道、立即检查）。
• Shell：按 Otty 同构排列——新窗口/新标签页/新分屏的工作目录、Shell/SSH 集成、Aster CLI（安装命令、省略 aster 前缀、覆盖已有命令、自定义别名）、常用文件夹（自动记录、管理已跟踪/已忽略、Zoxide 同步）、会话恢复（复用器、Code Agent、终端恢复协议、恢复进程三档：不重启/仅白名单内/所有运行中的进程）、声音（终端响铃、出错蜂鸣）、通知（系统权限状态、应用/完成/出错/watch 通知、前台策略、按类别选择的通知声音、Dock 图标跳动——持续跳到切回 Aster）和终端标识。TERM 通过下拉选择，auto 优先使用应用内置的 xterm-ghostty（能力与终端引擎一致），缺少条目时回退到兼容的 xterm-256color；选择“自定义…”后可填写本机真实安装的 terminfo 名称。
• 控制：与 Otty 相同，严格按自动补全、选择、滚动、打开方式、链接协议、键盘、鼠标、安全输入、剪贴板九组排列；包含 inline suggestion、Option/Meta、VT100 keypad、TUI 鼠标绕过、复制清理、危险粘贴、链接 scheme/安全例外、首尾滚动和安全输入指示。
• 编辑器：自动换行、行号、不可见字符、Tab 宽度、滚动越过末尾、Vim 按键与富文档预览。
• 智能体：八类 Agent（含 Grok Build）的启用状态、结构化启动命令、集成安装/卸载、标签徽章、通知与运行选项。
• 视图：对齐 Otty 的四组。「标签页与标题定制」按项（别名 / 图标 / 标题各一张规则列表）或按项目（一个项目同时设三项）排列规则；每条规则由路径、命令、Agent、SSH 主机、文件等条件（全部成立才命中，无条件即所有标签页）加上项目别名、图标（61 个内置图标或 emoji，可着色）和标题模板组成，模板支持 ${alias}、${cwd}、${folder}、${user}、${host}、${agent}、${branch}、${command}、${title}、${shell}、${index}、${file}，${title|folder|'Shell'} 取第一个有值的；规则标题优先级低于手动固定名、高于自动标题。「标签页图标与角标」选择图标与角标合并（共用一个指示位，有状态时角标接管）或分开（图标在左、角标在右并隐藏 shell 名），以及命令完成 / 失败 / 等待输入三种角标开关。「网页窗格」控制是否把 cookie 写盘（只影响之后新开的窗格）并可一键清除全部浏览数据。「详情面板」用拖动排序和开关决定信息 / 大纲 / Git / 文件 / 记忆哪些显示、按什么顺序，还可以「添加视图」：在面板内运行终端程序（如 lazydocker，命令与目录支持 ${cwd}、${pid} 等变量，目录留空时使用 ~/.config/aster/views/<名称>）或加载一个网页（可按移动版请求）。
• 外观：当前工作区左右 Panel 宽度、标签位置与自动隐藏、窗口尺寸、Dock 任务状态、浅深色主题、主题编辑/导入、文本样式、字体来源与回退、光标颜色/样式/闪烁/动画。
• Recipes：命令重放与按内容信任策略；外部命令必须按所选策略确认。
• 快捷键：查看内置快捷键。
• 高级：自动进度命令、标题修改/读取权限、导入/导出 JSON 配置、重置和运行内核信息。

全局设置可随配置保存与导出；左右 Panel 宽度属于工作区窗口，仅随对应工作区保存，不包含在配置导入/导出中。通知最终是否显示还取决于 macOS“系统设置 → 通知”中的应用权限和横幅样式。