dsh-better-sidebar

给 DSH Web 装一个”工作台”：文件、终端、Git、内嵌浏览器、子代理，右栏 + 底栏双面板，还开放给所有插件扩展。

解决什么问题

DSH Web 原生界面缺少”工作台”式的文件与工程操作能力——看文件、跑命令、看 Git 状态、盯后台任务，往往要切到别的工具。这个插件提供右侧栏 + 底部面板双工作台，把文件、终端、Git、内嵌浏览器、后台任务整合进界面，并把 ctx.betterSidebar 服务开放给所有插件——内置的 7 个 tab 与 6 个文件预览器，和第三方插件走的是同一套 registerTab / registerFileViewer API，能力完全对等；官方不再内置、可由生态提供的功能，交由生态插件实现。布局、Tab、面板按会话持久化，移动端自动合并全宽抽屉。

核心功能

• 文件工作台：懒加载目录树 + CodeMirror 编辑器，图片 / Markdown（含 Mermaid 安全渲染）/ HTML / PDF / Office 内联预览
• 内嵌浏览器：多开网页 tab、前进后退刷新，内容跑在沙箱 iframe，外链按协议分流（HTTP 侧边栏 / HTTPS 系统浏览器，可分别调整）
• 真实终端：xterm.js + node-pty 真实 shell，断线重连回放，可选为模型注入 terminal_* 工具
• Git 面板：真 diff + VSCode 式 diff tab、历史，右键暂存 / 提交 / 还原
• 后台任务页：subagent 拓扑 + 后台任务（退出码 / 实时输出 / 强制终止）
• 双工作台：右侧栏 + 底部面板，拖 Tab 拆分 / 合并分栏（可跨面板），移动端自动合并全宽抽屉
• 服务化基座：ctx.betterSidebar 服务 + registerTab / registerFileViewer，第三方插件与内置能力对等
• 按需加载：启动只拉约 325KB 核心，终端 / 编辑器 / Mermaid 等重依赖用到才拉取

快速上手

安装：

dsh plugin --profile web add dsh-better-sidebar@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到侧边栏；DSH 对 client 改动热加载，无需重启，仅 host 半更新时才需重启。前置：Node.js ≥ 20、pnpm ≥ 10。快捷键如 Ctrl/Cmd + S 保存编辑、Ctrl + Enter Git 提交、鼠标中键关 Tab、拖 Tab 到分栏边缘拆分 / 合并。

插件作者可注入 betterSidebar 服务，用 registerTab / registerFileViewer 注册新的侧边栏页面与文件预览器。

适合谁

• 想在 DSH 界面里直接管理文件、跑终端、看 Git 与子代理状态的用户
• 想给 DSH 添加侧边栏扩展页面的插件作者（复用 ctx.betterSidebar 服务）
• 需要把文件 / 终端 / 浏览器 / Git 整合进一个工作台的 DSH 重度用户