终端与 SSH

创建终端#

点击会话栏 + 或空白 LIVE 页 + NEW；旁边的文件夹图标可快速重开最近目录。表单目前创建本地终端，不提供 SSH/tmux 字段；服务端接口与工作空间恢复仍支持这些类型。

• 本地：通过 node-pty 启动你的 $SHELL。
• SSH：调用系统 ssh -t，使用端口、密钥和 user@host；首次连接接受主机密钥。GET /api/ssh-keys 列出 ~/.ssh/ 中的密钥。
• tmux attach：连接已有 tmux 会话。
• tmux new：将命令包装为新 tmux 会话，名称自动生成。

表单字段#

工作目录与命令必填，默认使用上次值；目录支持历史与浏览。可选标题、Room 分组、Central session 类型、API Key 覆盖、Claude Remote Control、模型与推理强度，以及额外的 Commands Terminal。

Claude API Key 覆盖 ANTHROPIC_API_KEY；Codex 覆盖 OPENAI_API_KEY。Claude 推理强度包含 low、medium、high、xhigh、max、ultracode，作为 --model/--effort 参数传入。Codex 模型列表取决于账号可用模型。

以 claude 开头的命令会加入 -n 标题，AASC 会自动回答该工作目录的信任提示。中央会话有更严格的启动限制，见中央会话。

终端功能#

终端使用 xterm.js，包含 fit、unicode11 与 canvas 插件，支持 CJK 文本选择。网页链接在浏览器打开；文件路径提供应用内打开、系统打开或文件管理器定位。

选中文字可进入解释／翻译浮层，工具栏的闪光按钮可对当前会话关闭此功能。其他工具包括主题、Escape、粘贴、滚动到底部、自动滚动、刷新、清屏、克隆、分叉、重启、重连与弹出窗口，按当前状态显示。

主题#

默认 Auto 跟随控制面板。可选 Default、Dark、Monokai、Dracula、Solarized-dark、Nord、Windows-xp、Github-dark，逐会话保存。

输出回放#

服务端保存终端回放缓冲；新设备订阅先收到历史输出，不会重新执行任务。默认 1 MB，可在 Settings → ADVANCED → Terminal 调整为 0.25–32 MB，仅影响之后新建的终端。同页可设置每个终端的实时滚动历史，默认 5,000 行。

全屏#

点击全屏按钮或 Alt+F11，再按一次退出，可在设置中改键。AASC 启动的终端默认设置 CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1，以便选择文本。若需要 Claude 自身的全屏模式，可在 shell 配置设为 0。

等待 Shell 就绪#

服务端先缓存最多 4096 字节输出并去掉 ANSI，静默 50 毫秒后检查末行是否以 $、#、% 或 > 结束。本地等待最多两秒，SSH 最多十秒。超时后仍会发送命令，并记录警告。

关联会话#

创建终端时注入 AGENT_MANAGER_TERMINAL_ID；SSH/tmux 会在启动命令中导出，因为 SSH 不自动传递环境变量。钩子读取后作为 agent_terminal_id 发送，服务端据此匹配。详见会话匹配。

提示词队列#

详情页 QUEUE 与终端下方队列共享同一份本地数据，也同步给已授权设备。

• Add：添加提示词，支持图片、文本文件、粘贴与拖放。
• 类型：once、loop、schedule；EDIT 可编辑主提示词前后的步骤。
• SEND：立即发送一次性任务；NOW：立即开始循环、定时或连续任务。
• Auto-send：逐会话设置，默认开启；idle、waiting 或 input 时自动发送下一项。
• Auto-enter：默认开启，输入后按 Enter；关闭时只输入文本。
• 通过拖拽或箭头排序；MOVE 可移到另一会话。

按 Esc 停止上一轮，或子代理／后台 shell 尚在执行时，队列会暂停并显示 Resume。循环与定时由控制面板运行，没有打开的面板窗口时会暂停。

数量限制#

最多同时 50 个会话、130 个终端；额外的 Commands Terminal 不计入 50 个会话限制。达到限制后拒绝新建，请先结束不需要的会话。

恢复与重连#

Resume 在旧终端或项目中新终端尝试恢复 Claude/Codex，失败则在同一卡片启动新会话；不会回退到 --continue。历史提问保留在 CONVERSATION 中。

Reconnect 为终端已结束的会话新建终端；Restart session 退出代理后重连，保留卡片与配置。详见恢复会话。