[Workbench T14a] 欢迎页与运行中工作区切换

[TablewareBox]

Parent

UniLab 调试工作台（UniLab Workbench）v1 技术 Spec

Decision

桌面 Workbench 先显示 UniLab 欢迎页，再由用户选择最近工作区、打开目录或新建工作区。一个窗口只绑定一个活动 WorkbenchSession 和一个 Workspace。正式产品版本为 0.1.0；Windows 主机验证后续在 #209 完成，不阻塞本功能在 macOS 的正式收口。

Acceptance criteria

• macOS 桌面应用先显示轻量欢迎页，不预先启动 Theia、OS、Agent 或 PLC-Sim
• 欢迎页提供最近工作区、打开目录和新建工作区；目录选择使用 Electron 原生 picker
• 显式 --workspace 参数可用于自动化或深链直接打开目标工作区
• 目标工作区与 Python 环境验证成功后才启动 Theia Backend，并复用同一个 BrowserWindow
• 主窗口提供切换工作区入口；存在未保存编辑时允许取消
• 切换有界停止当前 OS、Agent、PLC-Sim 与 Theia 进程树后启动目标工作区
• 启动失败返回欢迎页并展示诊断，不覆盖最后一次成功工作区
• 最近工作区只保存规范化路径和必要本机环境选择
• 切换后文件树、LSP、Terminal、Git、Material、Workflow、Agent 和环境管理指向新 Workspace
• 远程无头模式由服务端配置固定 Workspace

Remaining close gate

• 完成本轮 UI 优化并合并 uni-lab-fe PR [历史决策 D-023] 分离需关注事件与常规实时通道 #31

[TablewareBox]

T14a implementation is ready in Uni-Lab-OS/uni-lab-fe#31 (commit 454fbde).

Acceptance completed on macOS: dedicated welcome page, native open/create, canonical recents, same-window runtime Workspace switching with unsaved confirmation and bounded shutdown, packaged DMG smoke, and shared local desktop/browser session.

OS discovery decision was tightened during validation: Workbench resolves unilabos using the selected Python interpreter and records a source root only for an editable checkout. It never infers Uni-Lab-OS from a directory beside the project Workspace; ordinary wheel installs remain source-root-free, while --os-project / UNILAB_OS_PROJECT is the explicit development override.

[TablewareBox]

欢迎页、运行中切换工作区和隔离 profile 验收通过；最终安装副本显式锁定 workspace、OS checkout 与 Python 环境运行。多 renderer 会话广播修复 FE 27d36af 已推送，详细总验收见 uni-lab-fe PR #31。

[github-actions]

GitHub → Feishu OKF synchronization

Feishu snapshot: Uni-Lab-Core #211
Knowledge stage: implementation
Issue updated: 2026-08-10T13:37:57Z