内嵌终端(桌面)
在代码任务类型下,Windows 桌面应用提供绑定工作区目录的 xterm.js 终端。
要找全屏终端 Agent? 那是
zagens-tui— 独立二进制、三栏 UI,不是本 WebView 面板。
快捷键与入口
| 操作 | 快捷键 / 入口 |
|---|---|
| 打开并聚焦终端 | Ctrl+`(macOS:Cmd+`) |
| 新建终端会话 | Ctrl+Shift+` |
| 文件树右键 | 在终端中打开(以该目录为 cwd) |
切换到其它 Workspace tab 不会卸载终端面板(隐藏保活);拖拽改尺寸会同步 PTY resize。
Shell 与外观
- Shell 选择器 — 如默认 / PowerShell / pwsh / cmd(视本机安装)
- 可选 PowerShell Profile
- 主题、字号、选中即复制、清屏、查找(
@xterm/addon-search) - 工作区变更时提示 在此重开;进程退出后显示退出角标
适用场景
- 查看 Agent 启动的长时命令输出
- 与 Agent 并行手动执行命令
- 实时查看构建/测试日志
Agent 侧自动化仍走 exec_shell / run_tests 等工具(受沙箱与审批约束);本面板是人手 PTY。
办公模式不提供终端 — 文档流程使用 read_office / write_office。
安全
Shell 与 Agent exec_shell 在 Windows 上受 Windows 原生沙箱 约束 — 工作区外写入、profile 读取与出站网络按 elevated/unelevated 模式强制。另受 执行策略(sandbox_mode)与审批对话框约束。
可在侧栏 沙箱 与 设置 → 系统 → 安全 中配置。
建议
- 每个仓库使用独立工作区,保证终端 cwd 正确。
- 若输出停滞,检查侧栏 runtime 连接状态。
- 本地前端预览可配合 内置浏览器 的
.zagens/preview.json。