标签与三种布局

在“设置 → 外观 → 布局”中选择垂直、顶部或底部，主界面会立即切换到所选布局，无需关闭设置窗口。垂直布局默认使用 220pt 窄侧栏。拖动左栏与中央内容之间的分隔线可在 180...360pt 内调宽；分隔线悬停时灰色加深，双击恢复 220pt。拖动只调整宽度，不会折叠侧栏。整行标签显示目录名（主目录显示 ~），切换标签时名字保持不变；有命令正在运行的标签会在行右侧显示旋转指示器，鼠标移到标签行时该位置换成 ×，点击可直接关闭该标签，关闭后台标签不会先切换过去。旧版侧栏宽度会在该工作区窗口首次建立 Panel 布局时迁移；之后每个工作区窗口独立保存自己的左右宽度。标签行显示为左右留边的圆角卡片，选中和鼠标悬停都会给卡片加底色。鼠标移到侧栏任意位置时，顶部右侧会浮现「+」（新建标签页）；把鼠标再往上移到红绿灯那一行，旁边会额外浮现折叠图标（隐藏标签栏）。点击标签切换时「+」保持显示，不会闪一下消失；折叠后把鼠标移到窗口顶部（红绿灯右侧）会再次浮现「+」和展开图标，也可通过“显示”菜单的“显示/隐藏标签栏”恢复。新标签默认自动追加，标签面板可保持默认显示或在只有一个标签时隐藏；右键标签可快速分屏、打开文件浏览器或关闭标签。终端内容直接延伸到窗口底部，不再显示 workspace · 路径 / PANE / UTF-8 状态栏。窗口尺寸会在拖动结束后保存，“窗口大小”可恢复默认尺寸。

选择“顶部”时，窗口最顶一行是红绿灯与中央目录胶囊（项目名称）共处的标题带，标签条横贯其下一行，标签不会顶进红绿灯区域；选择“底部”时标签条贴住窗口底边，标题带保持在窗口顶部。两种横向布局的标签宽度随标题自适应：当前标签显示为主题色圆角胶囊，右端带 × 可直接关闭；其他标签是纯文字，鼠标悬停出现底色反馈，点击切换，右键菜单仍提供重命名、分屏、文件浏览器和关闭。正在运行、等待输入等状态徽章显示在对应标签右端，标签过长时按尾部截断。标签后面的「+」新建标签页；命令面板改用 ⌘⇧P 或“显示”菜单打开，不再占用标签条图标位。拖动标签仍可移动到其他窗口。

点击 TABS 右侧的整理图标可打开标签菜单：No Grouping / By Project / By Date 控制分组，Created Time / Updated Time 控制最新标签的排序依据，Insert Divider 在当前标签后加入分隔线，Remove All Dividers 清除全部手动分隔线。分组和排序选择会自动保存；只有主动选择分组时才显示分组标题。按项目分组时存在两种明确类型：本地 project 使用文件夹图标，组头和标签都只显示末级项目目录名（如 aster）；SSH project 使用电脑图标，并按最终服务器 hostname 单独分组。两种类型拥有不同 identity，SSH tab 不会混入发起连接的本地 project。完整本地路径仍作为内部身份和 tooltip，因此不同父目录下的同名项目不会被并进一组。⌘T 或侧栏「+」新建的本地标签会从当前标签的目录启动，因此直接出现在当前本地 project 分组里。在 Pane 中提交 ssh 命令后，Aster 会异步用 OpenSSH 配置解析最终 hostname：例如 ssh root@ubuntu@orb 可按 ~/.ssh/config 解析到 127.0.0.1，随后建立独立 SSH project；SSH 失败、退出或回到本地 Shell 后自动恢复本地目录归属。

右键标签并选择“重命名标签页…”可以固定名称，或添加会随运行程序继续更新的动态前缀；“恢复自动标题”重新使用程序发出的 OSC 标题。名称、前缀和最后标题会随工作区恢复。当前 Pane 里运行着已集成的 Agent CLI（Claude Code、Codex 等）时，标签会改为显示该会话的标题（由会话里的第一条有效提问推导，发出首条 prompt 后稍等片刻出现）；你手动固定的名称仍然优先，Agent 退出后恢复原标题。

在“设置 → 外观 → 标签栏”可选择新标签位置：“自动”会把空标签放到当前分组末尾、把带目录或文件的标签放到当前标签后；也可固定为列表末尾或当前标签之后。无论位置如何，⌘T 新建的标签都继承当前标签的实时工作目录；没有可继承的标签时从主目录启动。

窗口失去键盘焦点时，整个工作区会朝主题底色轻微褪色，终端光标同时停止闪烁（形状不变），便于在多窗口之间辨认哪个正在接收输入；重新聚焦即恢复，期间的第一次点击仍会正常落到终端上。终端右侧不再显示会闪现的系统滚动条，滚动历史通过滚轮、键盘和 ⌘F 查找访问。

主窗口右侧顶部与终端画布使用完全相同的背景色，普通状态显示活动 Pane 的程序标题。把鼠标移到标题上会显示当前工作目录的灰色路径胶囊；活动 Pane 运行 Agent 会话且已有标题时，胶囊改为显示会话标题，完整工作目录退到悬停 toolTip。点击后可直接设置标签名称/前缀、复制路径、在 Finder 或已安装编辑器中打开、预填 Git 命令、分屏，以及打开当前查找、全局查找、Jump to 和命令面板。“Notifications & Privileges”会跳到 Shell 通知设置。Git 写操作只预填到终端，仍由你回车确认。 Aster 会为 zsh、Bash 和 fish 加载签名的 Shell Integration；支持时，OSC 7 目录会实时同步到侧栏和会话快照，file://localhost/... 形式会自动转换为 ~/... 可读路径，并以本地目录形式安全恢复。

Shell Integration 与命令导航

• zsh 与 fish 只对 Aster 启动的当前会话注入资源；Bash 和 tmux 子 Shell 使用 .bashrc、.bash_profile、.zshrc 或 fish conf.d 中带清晰起止标记的受管区块。Aster 只改动区块本身，保留用户内容、权限和符号链接。
• “设置 → Shell → Shell 集成”默认开启。关闭前会确认并移除受管区块；命令通知、徽标等依赖设置值不会丢失。单个 Shell 可在启动前设置 ASTER_DISABLE_INTEGRATION=1。
• Command+Page Up / Page Down 跳到上一条或下一条命令；已经被滚动历史裁剪的命令不会跳到错误文本。命令开始时标签显示运行指示器，结束后按设置显示 ✓ 或非零退出码。
• Ghostty Shell Integration 负责提示符标记和命令跳转；旧引擎专属的“选区 Backspace 安全删除”在当前版本不启用。