Workbench 工作台

Workbench 是 Chat 和 Yeaft Session 右侧的开发工具面板。终端、Git 和文件运行在所选 Agent 上；浏览器直接使用客户端设备。工具状态绑定所属 Session 及其工作目录。

打开和关闭 Workbench

使用 Chat 顶栏或 Yeaft Session 操作区中的 Workbench 按钮。

Workbench 首先显示包含四张能力卡的选择页：

• 终端 — 在当前 Session 工作目录中运行命令
• Git — 查看仓库状态和代码差异
• 文件 — 浏览、预览和编辑 Agent 本地文件
• 浏览器 — 通过客户端 iframe 打开外部 HTTP/HTTPS 网页，无需配置 Agent 浏览器

四张卡始终可见。标记为当前 Agent 不可用的卡仍可打开查看可用性说明，但不会启动虚假或残缺的工具。

只有用户选择的能力才会启动。关闭当前能力会返回选择页，并把键盘焦点还给原来的能力卡；关闭 Workbench 才会收起整个面板。面板也支持最大化和拖动左侧边缘调整宽度。

Workbench 使用规范的 Session route。即使两个 Session 位于同一个 Agent，切换 Session 也会返回选择页，并隔离前一个 Session 的终端、Git 和文件状态。

终端

终端通过 xterm.js 连接 Agent 上的 PTY：

• 在所选 Session 的工作目录中启动
• 支持水平和垂直分屏
• 支持 vim、tmux、htop 等常规终端程序
• 终端状态只属于创建它的 Session route

使用终端工具栏分屏或关闭终端 pane。使用 Workbench 返回按钮可回到能力选择页，而不收起整个 Workbench。

文件

文件能力提供类似 VS Code 的文件树、编辑器和预览界面。

文件树

• 展开和折叠目录
• 使用 Ctrl+P 快速打开文件
• 新建、删除、移动、复制或上传文件
• 刷新目录树，或在所选 Agent 上选择其他文件夹

普通 Session 中，手动选择的文件可位于 Session 工作目录之外；浏览、编辑和预览使用 Agent 运行账号的文件系统权限，不会修改 Session 工作目录。工作项的文件能力仍限制在工作项 workspace 内；回复中的自动文件和图片引用仍要求位于 Session workspace 内。

打开或切换文件会自动展开父目录并高亮当前文件。点击编辑器路径中的任意一级即可显示文件树并定位该目录，点击文件名则定位文件。普通 Session 打开树外文件时可自动将树根移到文件父目录，不改变 Session 工作目录、不丢失编辑；工作项导航仍限制在 workspace 内。

Windows 顶层盘符列表只显示固定磁盘，不列出映射网络盘、移动盘或光驱。Agent 通过 Windows PowerShell 异步查询磁盘类型，执行超时为 5 秒，不探测磁盘根目录；并发请求共享同一次查询，后续请求重新刷新。枚举失败时显示错误和重试入口，而不是空列表。其他路径仍可通过已有的直接路径输入入口访问，原有权限和 workspace 边界不变。macOS/Linux 的根目录浏览不受影响。

编辑和预览

• 多文件编辑和语法高亮
• 使用 Ctrl+F / Ctrl+H 查找和替换
• 使用 Ctrl+S 保存到 Agent
• 预览 Markdown、图片、PDF、支持的 Office 文档，以及浏览器支持的 MP4、M4V、WebM、OGV/OGG 和 MOV 视频；视频从 Agent 流式读取，也可直接下载

音频文件（.mp3、.wav、.m4a、.flac、.aac）通过浏览器原生控件本地播放，能否播放取决于浏览器支持的编码；.ogg 继续使用视频流式路径。所有非文本文件均提供下载，预览失败时也保留入口。PDF 在浏览器阅读器不可用或空白时提供下载提示。Office 文件仅本地渲染：忽略旧的 Office Online 设置，不会将私有预览地址发送给微软或云转换服务。旧版 .doc、PowerPoint（.ppt / .pptx）、压缩包及其他暂不支持的二进制文件显示格式和下载入口，不作为乱码文本打开。未知文件中出现控制字节或无效 UTF-8 时同样使用安全回退；非 UTF-8 编码的文本请下载后在本地打开。

CSV（.csv）、SVG（.svg）、HTML（.html / .htm）和 Markdown 默认打开预览，可通过 预览 / 编辑 切换；预览使用当前编辑内容，即使尚未保存。HTML 使用隔离的静态预览，保留内联样式及 data 图片，不执行脚本、不跳转链接、不提交表单，也不加载外部或相对路径资源；需要完整交互或多文件网页时，请使用项目的本地开发服务器。

CSV 和本地 Excel（.xlsx / .xls）共用只读表格控件：单击列标题依次切换升序、降序和原始顺序；可搜索全部列，或按所选列筛选包含指定文本的行。操作仅覆盖有界的已加载预览，不写入文件；排序后仍显示原始记录/工作表行号。单击或拖动单元格选择矩形区域，Shift+单击或 Shift+方向键扩展，使用复制选区或 Ctrl/Cmd+C 复制纯文本 TSV。方向键移动焦点，Ctrl/Cmd+A 选择当前 50 行页面。切换页码、工作表、表头、排序或筛选会清除选区。粘贴到其他表格软件时，类似公式的文本可能被解释，请按需使用目标软件的“粘贴为文本”。

Excel 本地预览支持多工作表切换、固定列标题与行号，以及独立的横向/纵向滚动，适配浅色和深色主题。默认使用 A/B/C 列标，可按需启用首行作为表头。仅显示缓存/格式化后的单元格值，不重新计算公式，不执行链接、宏或 HTML，不还原图表与合并单元格布局，也不是工作簿编辑器。最多提供前 100 个工作表名称；在独立 Worker 中按选中的工作表解析，单次超时 15 秒、文件上限 20 MiB，每张表最多 1,000 行、100 列，每格 10,000 字符，合计显示 100 万字符。空工作表、部分预览以及无效/加密/超时文件均有明确提示。预览不足时请下载原文件并使用表格软件打开。

CSV 以只读表格呈现，支持固定表头、行号、横向滚动和每页 50 行；无表头文件可以关闭首行作为表头。支持逗号分隔、引号内换行、转义引号、UTF-8 BOM 和空字段；单元格仅显示文本，不执行公式或 HTML。预览最多解析前 100 万个源字符，显示 1,000 条记录、100 列，每格最多 10,000 个字符；达到上限会明确提示部分预览，扫描边界处不完整的记录不展示。这些限制不会修改原文件，编辑仍显示完整加载的文本；格式错误会提示记录序号，可切换到编辑修复。

SVG 以安全图片模式呈现，支持渐变、滤镜及自包含的 CSS/SMIL 动画；不执行 JavaScript 或加载外链资源。点击画面可放大查看；无效 SVG 会显示错误，仍可切换到编辑修复源码。

从回复中点击文件引用时，Workbench 会直接进入当前 Session route 对应的文件能力，加载文件内容；引用带行号时定位到起始行。支持 Markdown 链接、行内代码和普通文本中的路径，例如 src/main.js:20-35、src/main.js#L20-L35、docs/设计说明.md。包含空格的路径请使用行内代码或 Markdown 链接。

文件引用会在流式输出期间分批识别，回复结束后再次确认。只有当前 Agent 确认存在于该 Session workspace 中的文件才显示为可点击链接；不存在、重名且无法唯一确定、或 workspace 外的路径不会自动链接。外部 HTTP/HTTPS 链接在 Workbench 浏览器中打开，不会映射成本地同名文件；Ctrl/Cmd 点击保留浏览器原生新标签页行为。

临时解析错误最多自动重试两次。已完成回复中尚未解析的路径，在当前 Session 后续工作结束时最多再检查两次，以识别稍后创建的文件，不会无限轮询。若点击后读取失败或连接中断，Files 会显示错误；连接恢复后再次点击同一引用即可重新读取，无需关闭页签。已加载的内容和未保存的编辑不会因重复点击而被覆盖。

非视频二进制预览和下载支持最大 20 MiB 的文件。视频使用有界字节范围流式传输，不受整文件传输上限影响。支持 Session route 的预览地址不会因切换 Session 或 Server 的 10 分钟文件缓存回收而过期；缓存未命中时，Server 自动从原 Agent 读取，无需手动续期。地址是绑定原用户、Agent、Session 和 workspace 的访问凭据，请勿公开分享。每次访问都会检查当前权限；Agent 离线、文件删除、Session 归档或工作目录变化会导致访问失败。回源读取的是原路径的当前内容，不是永久快照。轮换 Server 的 JWT_SECRET 会使既有地址失效。旧版无 Session route 的预览仍使用临时缓存。

Git

Git 显示当前 Session 所选仓库的状态：

• 分支及 ahead/behind 状态
• 已暂存、已修改和未跟踪文件
• 文件差异
• 暂存、取消暂存、丢弃、提交和推送
• 在当前 Session workspace 中选择其他仓库的文件夹选择器

合并冲突和 interactive rebase 请使用终端处理。

浏览器

浏览器直接在客户端 iframe 中打开 HTTP/HTTPS 页面，不启动 Agent 浏览器、不安装 Chromium、不使用 WebRTC，也不经 Server 代理页面流量。无需 Browser Runtime 能力，Work Center 中也可使用。

• 普通点击回复、Markdown 文件预览或工作项交付物中的外链，会在这里打开；Ctrl/Cmd 点击、中键和下载链接保留原生行为。
• 支持地址输入、刷新和新标签页打开。地址栏保留打开时的地址；跨域重定向和页面内部导航无法可靠观测，因此不提供虚假的前进/后退按钮。
• 地址仅在所属 Agent/Session 或工作项及 workspace 内恢复，只保留到 Workbench 组件销毁。切换工具可恢复最后打开的地址；关闭浏览器标签清除地址，刷新 Yeaft 页面也会清除临时状态。
• localhost 和内网地址指的是客户端设备和网络，不是 Agent。HTTPS 的 Yeaft 页面可能阻止 HTTP 内容。
• 网站可以通过 CSP 或 X-Frame-Options 禁止嵌入。面板始终提示内嵌限制；等待较久会停止加载提示，但不会把跨域 load 事件或超时误判为网站已成功打开或已被拦截。空白、脚本或登录不可用时，使用新标签页打开，让客户端真实浏览器使用自己的 Cookie、登录态和完整站点功能（仍受浏览器及企业策略约束）。Yeaft 不绕过网站限制，也不复制登录凭据。
• 与文件面板的 HTML 静态预览不同，浏览器沙箱允许 JavaScript（内联及外部脚本）和表单，不授予同源、弹窗和顶层导航权限。模块脚本及 fetch 仍受 CORS 限制，登录和存储等功能也可能受限。需要完整站点能力时可用新标签页打开。拒绝包含凭据的地址及 Yeaft 同源目的地。外部网页不继承 Yeaft 的深浅主题。

旧 Agent Browser Runtime 配置和 CLI 保留兼容，当前 Workbench 视图不使用它们。打开此视图不会修改已有 Runtime 进程或实例数据。

常见问题

某项能力不可用

• 终端、Git 和文件需要所选 Agent 的对应 capability；route-scoped 工具还需要 workbench_session_routes。浏览器不需要 Agent 浏览器能力。
• 必要时升级 Agent，并检查启动日志

终端打不开

• 检查 Agent 日志中的 PTY 启动错误
• 确认 Agent 安装包含受支持的 PTY 后端

文件或 Git 指向错误项目

• 确认当前选中的 Session 及其工作目录
• 修改 Session metadata 后，关闭并重新打开对应能力

文件无法保存

• 确认 Agent 进程用户对目标路径有写权限