feat: 五个功能窗第一版（资源管理器/SCM/任务/终端/浏览器，照搬 better-sidebar 架构）

2026-08-17 11:47:35 +08:00
parent 86c9904b42
commit 981c2acfb3
10 changed files with 463 additions and 19 deletions
@@ -351,12 +351,12 @@ type SplitPane = {

 | 内容窗 | 可行性 | 依据 |
 | --- | --- | --- |
-| 浏览器 | ✅ 现成 | iframe + 同源路由（travelatlas 已验证） |
-| 资源管理器 | 🔶 待调研 | workspaces/directory 服务与官方目录选择器可作基底 |
-| 终端 | 🔶 待调研 | 宿主依赖含 xterm + dsh-terminal 包，接入方式需逆向确认 |
-| 任务管理 | 🔶 待调研 | todo/目标状态投影服务，需找对 API |
-| 源代码管理 | ⚠️ 受限 | 宿主无内置 git 服务；先以「终端里跑 git」替代 |
-| 自定义 vibe | ✅ 可闭环 | 描述需求 → agent 生成新项目（插件/站点）→ 注册进工作台 |
+| 浏览器 | ✅ 已实现 | iframe + 地址栏 |
+| 资源管理器 | ✅ 已实现（第一版） | 服务端 /api/worktable/fs 目录列表（参考 better-sidebar 架构）；文件打开待后续 |
+| 源代码管理 | ✅ 已实现（第一版） | 服务端 /api/worktable/git（porcelain v1 -z）；diff/暂存/提交待后续 |
+| 终端 | ✅ 已实现（第一版） | WS /api/worktable/term + node-pty + xterm（宿主缺 node-pty 时降级提示） |
+| 任务管理 | ✅ 已实现（第一版） | 客户端 sessions 快照 jobsBySession（后台任务列表，2s 刷新） |
+| 自定义 vibe | ✅ 可闭环 | 描述需求 → agent 生成新项目（插件/站点）→ 注册进工作台（UI 已留 ✨ 入口） |

 ### 13.8 里程碑

@@ -333,3 +333,27 @@
  该布局支持 ⇄ 翻转（聊天通高贴左时内容区在右）。
 - 预设：t3 的 chatFull=true；缩略图改为左品字 + 右通高聊天；词典 preset.t3 改名「左品右聊 / Pin + chat」。
 - 验证：构建 + node --check 通过；服务端实时下发（含 chatFullHeight）；待用户刷新实测。
+
+## 补记（5 个功能窗照搬 better-sidebar 架构，第一版实现）
+
+- 用户要求：参照已安装的 dsh-better-sidebar，把前 5 个内容窗（浏览器/资源管理器/
+  源代码管理/任务管理/终端）做成真正生效的，自定义暂缓。
+- 调研结论（better-sidebar 架构）：内容窗能力 = 它自己服务端的路由（fs 列表、git 命令、
+  node-pty + WebSocket 升级路由、任务回放）+ 客户端 xterm/iframe；注册 Upgrade 走
+  ctx.webServer.registerUpgrade。
+- 实现（dsh-worktable）：
+  ① 服务端重写（src/index.ts）：POST /api/worktable/fs（readdir 目录优先排序、上限 500）、
+  POST /api/worktable/git（status porcelain v1 -z + 分支）、WS /api/worktable/term
+  （node-pty 生成 shell + resize 协议；node-pty/ws 缺失时路由不注册、终端窗降级提示）；
+  build.mjs 服务端 external 增加 ws/node-pty（运行时从宿主 node_modules 解析，
+  better-sidebar 已带）。
+  ② 客户端（split.tsx）：ExplorerPane（面包屑路径/上一级/后退/刷新/目录进入）、
+  GitPane（分支 + 变更清单，XY 着色）、JobsPane（sessions 快照 jobsBySession 列表、
+  状态圆点、2s 刷新）、TerminalPane（xterm + WS + ResizeObserver fit/resize）；
+  新增 SplitEnv（setSplitEnv 注入 getScope/getJobs），工作台从 useSessions 快照取
+  当前会话与 cwd、jobsBySession。
+  ③ 依赖：devDependencies 增加 xterm ^5.3.0（已 npm install，打包进 client.js）。
+- 注意：服务端路由改动需**重启 dsh web 后生效**（bundle 启动时组合；客户端已实时下发）。
+  未安排自动重启（用户要求，其他窗口仍在工作）。
+- 待后续：文件打开/编辑、SCM diff/暂存/提交、终端 cwd 信任客户端（better-sidebar 用
+  服务端 header.cwd，后续对齐）、jobs 输出回放。