dsh-better-sidebar：为 DeepSeek Harness 提供功能丰富的侧边栏工作台

dsh-better-sidebar 是 DeepSeek Harness（DSH）的界面类插件（DSH plugin），由 omdsh-dev 维护，采用 MIT 协议，是一个服务化的侧边栏框架，旨在解决 DSH 默认界面侧边栏能力单一、扩展困难的问题。它提供右侧栏与底部面板双工作台，内置文件管理、编辑预览、内嵌浏览器、真实终端、Git 面板、后台任务等开箱即用的功能，并通过开放的 ctx.betterSidebar 服务让第三方插件注册新的侧边栏页面与文件预览器，实现能力对等。该插件基于 TypeScript 开发，最近更新于 2026-08，支持多语言（zh/en）实时切换。

dsh-better-sidebar 这个 DSH plugin 支持哪些核心特性？

• 文件工作台：资源管理器（懒加载目录树）+ CodeMirror 编辑器，支持图片、Markdown、HTML、PDF、Office 内联预览。
• 内嵌浏览器：多开网页 tab，支持后退/前进/刷新，内容运行在沙箱 iframe，外链按协议分流（HTTP 在侧边栏打开，HTTPS 走系统浏览器，可在设置页调整）。
• 真实终端：基于 xterm.js + node-pty 的真实 shell，支持断线重连回放，可选为模型注入 terminal_* 工具。
• Git 面板：真 diff + VSCode 式 diff tab、历史、右键暂存/提交/还原。
• 后台任务页：subagent 拓扑 + 后台任务（退出码/实时输出/强制终止）。
• 双工作台：右侧栏 + 底部面板，支持拖 Tab 拆分/合并分栏（可跨面板），移动端自动合并全宽抽屉。
• 会话隔离：布局/Tab/面板按会话持久化，陈旧状态自动净化。
• 声明式设置：设置页「侧边卡片」逐项独立开关，二级设置经齿轮弹窗。
• 按需加载：启动只拉 ~325KB 核心，终端/编辑器等重依赖用到才按需拉取。

dsh-better-sidebar 怎么安装？

前置要求：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。安装命令如下：

dsh plugin --profile web add github:omdsh-dev/dsh-better-sidebar

dsh-better-sidebar 如何通过服务化基座扩展？

该插件遵循服务优先理念，内置的 7 个 tab + 6 个 viewer 与第三方插件通过同一套 ctx.betterSidebar API 注册，能力完全对等。服务化基座提供完整类型导出、能力探测（version/features）、状态订阅（getSnapshot/subscribeState）、tab 角标、生命周期回调（onOpen/onActivate/onClose）、updateTab/activateTab/openFile、定向打开、meta 跨刷新持久化、插件自有设置（pluginToggles/render）以及外链点击目标认领（urlTarget）。第三方插件可深度接入，实现自定义侧边栏页面与文件预览器。

dsh-better-sidebar 兼容哪些 DeepSeek Harness 版本和平台？

该插件面向 DeepSeek Harness 生态，依赖多个官方包（如 @deepseek-ai/dsh-client-web-react、@deepseek-ai/dsh-host-webserver 等），支持 macOS、Linux 和 Windows（Git Bash/WSL 或 PowerShell）。界面文案跟随 DSH 语言（zh/en）实时切换。最近更新（v0.12.2）新增了「位置兼容模式」，为 Windows 右上角原生标题栏预留顶部空间，侧边栏整体下移，距离可在齿轮弹窗自定义（0–120px）。

查看更多 DSH 插件，访问 dsh-plugin.org