seek://map/dsh-better-sidebar
dsh-better-sidebar 侧边栏工作台
#sidebar #workbench #terminal #git
TL;DR
omdsh-dev 的服务化侧边栏框架＋开箱即用工作台：内置文件工作台、内嵌浏览器、xterm 真实终端、Git 与本轮文件双视角、侧边对话，并通过 ctx.betterSidebar 把同一套注册 API 开放给第三方插件；据其 README，生态插件已有 28+。
Web UI 从此有了真正的 IDE 侧翼：这是一个服务化侧边栏框架，内置集合——CodeMirror 文件工作台、沙箱内嵌浏览器、node-pty 驱动的 xterm 终端、Git 与本轮文件变动视图、beta 侧边对话——全部经它发布给第三方插件的同一套 ctx.betterSidebar API 注册。README 的故障排查表对毛边相当诚实（首次安装的 pnpm 构建脚本拦截、与 @linxin666/dsh-web-ui-all 等聚合包的双挂载冲突），上述毛边都已记录在本条目中。
速览
- install
- dsh plugin --profile web add dsh-better-sidebar@latest
- license
- MIT
- note
- 首次安装会被 pnpm 11 拦截 node-pty 构建脚本：在 profile 目录执行 pnpm approve-builds --all 后重跑安装（README 常见问题表）。
要点
- 服务优先：内置 tab 与第三方插件经同一套 ctx.betterSidebar API（registerTab / registerFileViewer）对等注册；据其 README，生态插件已有 28+
- xterm.js + node-pty 真实终端，断线重连回放；可选向模型注入 terminal_* 工具，另有 sidebar_open 让模型主动在侧边栏打开文件或网页
- 文件变动 Git 视角与本轮读写追踪双视角合一，统一 diff 渲染；侧边对话（beta）继承主会话完整上下文独立运行
- npm 分发：stable 线走 @latest（v0.17.1），DSH 0.1.2-alpha.x 走 alpha dist-tag（据其 README 支持徽章，核验时对准 alpha.3）
- 右侧栏＋底部面板双工作台，tab 拖拽分合、悬浮窗与按会话布局持久化；界面跟随 DSH 语言（zh/en）
常见问题
为什么第一次安装会失败？
pnpm 11 会拦截 node-pty 的构建脚本。按 README，在 profile 目录（~/.dsh/profiles/web）执行 pnpm approve-builds --all 放行，然后重跑安装命令。
支持哪些 DSH 版本？
按 README 支持徽章：alpha dist-tag 的 v0.18.x 适配 DSH 0.1.2-alpha.x（核验时对准 alpha.3）；stable 用户继续用 @latest（v0.17.1），该线已不再支持 0.1.0-rc.8 至 0.1.1-rc.2。
页面上出现重复的侧边栏怎么办？
那是双挂载：删掉 ~/.dsh/profiles/web/cordis.patch.yml 里残留的手动 insert 段（README 故障表有记录）；0.13.x 起插件检测到同包名启用挂载也会自动退让。
官方参考