Workbench：个人终端工作台

Workbench：使用复盘与迭代计划

把真实使用中反复出现的摩擦与已经完成的项目事实分开记录，一次只选择一个可以验证的改动。

使用起点：2026-08-02 本轮校准：2026-08-23 依据：约三周主终端使用与 macOS 真机运行 状态：第二轮功能已落地，回到真实使用
本页不是功能愿望清单，也不承诺一次修完。只有真实使用事件、可复述的绕行方式和明确的验证条件才进入迭代判断；已完成事实仍由 Workbench 项目页承载。
本页目录
使用基线 已处理摩擦 配置现状 当前观察 暂缓方向 维护规则 返回项目页

当前一句话

Workbench 已经成为日常主终端；8 月 16 日记录的功能键、长链接、profile / 快捷键配置与输入诊断已经逐项落地，macOS 路径也已运行。当前重新回到使用，不继续追逐功能数量。

01

真实使用已经给出新的基线

从 2026-08-02 起，Workbench 持续承载 WSL、PowerShell、Git、构建、测试和 Codex CLI，几乎取代 Windows Terminal 成为主终端。一次因 htop F5 被迫回退的事件，后来成为补齐功能键、配置和输入诊断这一轮工作的入口；同一套代码随后也在 macOS 真机完成构建与运行。

已经稳定承担

  • 多个 PowerShell / WSL 标签及其标题和状态；
  • macOS 登录 shell 与平台快捷键；
  • 滚动、选择、复制、粘贴和跨 viewport 选择；
  • 中文宽字符、表格输出和日常 CLI 交互；
  • 主终端工作流，而不再只是临时 PoC 演示。

本轮判断方式

  • 先记录发生过的具体事件，不从功能想象出发；
  • 区分兼容缺陷、配置需求和独立项目；
  • 一次只实施一个边界明确、可以验收的改动；
  • 完成后回到真实使用，不连续追逐功能数量。
02

已确认的摩擦已经逐项落地

这里保留最初发生的操作和绕行方式，同时写明 2026-08-23 的完成状态。这样可以看到功能从哪里来，也不会把历史问题继续误写成当前待办。

事项 最初证据 当前结果 保留边界
F5 / 功能键 htop 中按 F5 无响应，只能临时打开 Windows Terminal。 F1-F12 与常用导航键编码已经补齐；htop F5 已在真实终端确认可以切换树形视图。 功能键属于终端协议输入，不进入 Workbench 快捷键配置。
长 GitLab URL 点击创建 Merge Request 的长链接后打开了文件浏览器；当前绕行是复制到浏览器。 长 URL 提取、尾部标点处理和默认浏览器调用已经修正；原始 GitLab 链接已手工回归。 只接受完整的 HTTP / HTTPS 地址，不把任意终端文本交给系统打开。
Ctrl+Shift+T 创建新标签需要明确选择 PowerShell 或 WSL；当前行为只能通过修改代码变化。 profile、action 与 keybinding 已经分开；默认 profile 和全部 Workbench action 可以通过 ~/.workbench/config.toml 配置。 配置只在启动时读取；没有设置界面或热重载。
按键可解释性 功能键和组合键出现问题时，目前无法直接看到 GPUI 收到的事件、Workbench 的决策和发送给 PTY 的字节。 Shortcut Inspector 已能显示版本、key down/up、repeat、长短按、Workbench 路由和 PTY 字节，并支持垂直拖动高度。 它仍是主窗口内的学习与诊断面板，不扩张成独立调试器。
macOS 路径 Windows 版本进入真实使用后，出现了一台可以直接验证的 macOS 设备。 GPUI、Unix PTY、登录 shell、平台复制粘贴和全屏 action 已进入实现；真机构建和远程启动已经完成。 应用打包、签名、notarization 和对外分发仍不在当前里程碑内。
03

配置已经表达最小关系

当前实现把物理按键、Workbench action 和终端 profile 分开。快捷键绑定 action，新标签 action 使用默认 profile；普通终端输入没有命中 Workbench action 时继续传入 PTY。

当前配置边界 文件接口已经存在，职责仍保持克制
Keystroke 例如 Ctrl+Shift+T
Action 例如 NewTab
Profile PowerShell、WSL 或 shell
Session ConPTY / Unix PTY 进程

当前已经拥有

  • 首次启动创建 ~/.workbench/config.toml；
  • 平台 profile、默认 profile 和全部 Workbench action；
  • 每个 action 接受一个、多个或空快捷键；
  • 未知字段、无效 profile、冲突快捷键的诊断和安全默认值。

当前刻意不拥有

  • 图形化设置页面和热重载；
  • 任意脚本、插件或复杂条件表达式；
  • 用配置重写终端标准转义序列；
  • 把长按和短按立即变成正式快捷键语义。

仍然诚实的边界：powershell、wsl 与 shell 仍是平台 profile，cfg(target_os) 也仍存在于真正的平台边界。只有第三个平台或重复修改证明当前结构妨碍维护时，才提取更通用的 backend / profile 抽象；现在不把品味问题冒充 bug。

04

接下来先观察，不继续堆功能

第二轮已经把 8 月 16 日的具体摩擦变成代码、测试和手工验收。当前顺序不再是功能排期，而是把新版本放回真实环境，等待下一次重复出现且无法绕开的证据。

01 · 继续真实使用 观察配置、快捷键和 Inspector 是否减少绕行，而不是因为它们刚完成就继续扩展。
02 · macOS 有限校准 只复核真实窗口与终端交互；不顺势进入打包、签名、发布和完整产品化。
03 · 按摩擦阅读代码 只有平台分支或 profile 模型真实妨碍修改时，才整理 cfg(target_os) 与平台后端边界。
04 · 保持项目边界 Editor、Runner、会话服务和通用插件继续独立判断，不因 Workbench 可用就自动并入。
05

没有进入本轮的方向

方向 当前位置 重新进入条件
Editor 暂缓；它涉及 IME、焦点、选区、剪贴板、未保存状态和 tab 归属。 记事本与终端之间的上下文组装再次成为高频、不可绕行的摩擦。
代码阅读器 / LSP 维持原有边界，不因能够实现就启动。 只读代码观察需求在终端稳定后仍反复出现，并能切出独立最小路径。
会话持久化 未进入；当前 session 生命周期仍与 Workbench 进程一致。 应用重启导致工作丢失成为重复事件，而不是偶发担忧。
Runner 不属于 Workbench 本轮。它更接近独立的用户态进程编排器，继续留在 Capture。 多个长期命令的启动、观察和重启形成稳定需求后，建立自己的事实源和页面。
设置界面、热重载与独立 Inspector 暂缓；当前配置文件和主窗口内可拖动面板已经够用。 手工配置或嵌入面板反复阻断真实工作流，而不只是外观偏好。
06

这张页面怎样继续维护

事项进入条件

  • 能够描述原操作、实际结果和绕行方式；
  • 能区分已确认事实与原因推测；
  • 具有明确验收动作；
  • 属于 Workbench 自身责任，而非另一个项目。

事项退出条件

  • 代码与自动验证已经完成；
  • 真实使用确认问题消失且相邻行为未退化；
  • 结果压缩回 Workbench 项目页；
  • 阶段决定才进入事件记录，不逐条复制待办。

停止条件：当下一项仍缺少具体使用证据、验收方式或清楚边界时，不因为页面上已经写了它就开始实现。计划页负责保存判断，不负责制造排期压力。