常见问题

为什么窗口缩窄后 Panel 看起来小于设置值？

Aster 会优先给中央内容保留可操作空间，窗口不足时临时压缩右栏、再压缩左栏。这不会覆盖保存值；把窗口拉宽后会自动恢复。若要隐藏某一栏，请使用标签栏折叠或详情面板开关，不能通过拖动分隔线隐藏。

vim 或 top 显示不正常？

确认“设置 → Shell → 终端标识 → TERM”为 auto（优先使用内置 xterm-ghostty，或本机真实安装的 terminfo 名称），并开启“控制 → 允许鼠标报告”。无效的自定义名称会在 Pane 中显示启动告警并自动回退到 xterm-256color。SSH 到没有 xterm-ghostty 条目的远端主机时，可在远端安装该条目，或临时执行 TERM=xterm-256color ssh …。

输入 exit 后怎么办？

该 Pane 会直接关闭，和按 ⌘W 一样；Ctrl+D 结束 Shell 也一样。标签里只剩这一个 Pane 时，关闭的是整个标签（窗口至少保留一个标签）。关错了按 ⇧⌘T 可以找回布局，新的 Shell 会重新启动。

不带参数的 exit 会沿用上一条命令的状态码，所以非零状态码同样关闭 Pane。下面几种情况不是你主动退出，Pane 会保留最后画面并显示结束卡片：

• Shell 启动后 3 秒内就以非零状态码退出（通常是 Shell 配置写错）。
• Shell 被信号终止，或 PTY 连接异常中断。
• 远程机器上的受管终端：远端进程结束后仍显示“远端进程已结束”卡片，由你选择“重新启动 Shell”或“关闭标签”。
• 开启了「本机后台保活」的 Pane 里输入 exit 会像普通 Pane 一样关闭；只有后台服务已回收该终端或暂时不可达时，才保留结束卡片。

卡片外的历史内容仍可选择和复制。点击“重新启动 Shell”会在同一个 Pane 创建全新的 PTY，不复用已经结束的进程通道；需要排查时可从“帮助 → 反馈问题…”打开本机日志文件夹。

Recipe 会自动执行命令吗？

取决于“设置 → Recipes”的重放模式。默认会先显示命令预览并确认；选择“从不”时只恢复布局，选择信任时也只信任当前 SHA-256 内容，文件修改后会再次询问。命令按空闲 Prompt 串行重放，不会直接交给独立 /bin/sh 执行。

状态栏 AI 用量的图标旁没有百分比，或会话页是空的？

图标旁的百分比来自配额：Claude 需要按订阅登录并在钥匙串弹窗里点过允许（Aster 用 Claude Code 存在钥匙串里的登录凭据读官方接口），Codex 需要本机至少跑过一轮；API key 用户没有 5 小时 / 每周限额，只会显示图标。会话页依赖 Aster 的控制通道：同时开着两个 Aster 时，后启动的那个抢不到通道，会话页为空，配额和 Token 两页不受影响。

关闭编辑器时会丢内容吗？

不会直接丢弃。存在未保存内容时，关闭 Pane、标签或退出应用都会询问“保存 / 不保存 / 取消”；保存失败会阻止关闭。