MIT 许可的服务化侧边栏框架,通过官方 dsh plugin CLI 原生安装进 DeepSeek Harness web profile,内置文件工作台、真实终端、Git 面板,并开放第三方插件注册新 Tab 的扩展 API。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-21
许可证
MIT
01它能帮你完成什么?
Turn the DeepSeek Harness web UI into a full IDE-style workbench: files, terminal, Git and subagents in a sidebar
Right sidebar + bottom panel dual workbench with 7 built-in tabs: file explorer + CodeMirror editor with inline image / Markdown / HTML / PDF preview, embedded browser, real terminal, Git panel, background tasks and a plugin directory
DeepSeek Harness (dsh web) users who want an IDE-grade sidebar UI without leaving the harness
Extend the DSH sidebar with custom tabs and file viewers from other plugins
New sidebar pages and file previewers registered through the `ctx.betterSidebar` service (`registerTab` / `registerFileViewer`), with the same API the built-in 7 tabs + 6 viewers use
DSH plugin developers building UI panels on top of a shared sidebar foundation
02如何接入 DeepSeek Harness?
前置条件
- DSH installed and running (`dsh web` works)
- Node.js ≥ 20 and pnpm ≥ 10
- DSH 0.1.0-rc.8 — this release pins all `@deepseek-ai/*` dependencies to `^0.1.0-rc.8`; rc.7 and earlier cannot resolve the dependencies
安装步骤
- 01
Run `dsh plugin --profile web add dsh-better-sidebar@latest`
$ dsh plugin --profile web add dsh-better-sidebar@latest
- 02
Hard-refresh the browser (Cmd/Ctrl+Shift+R) to load the sidebar — DSH hot-loads client changes, so no restart is needed unless the host half updates
验证接入成功
- Hard-refresh the browser (Cmd/Ctrl+Shift+R); the sidebar workbench appears in the DSH web UI
03DSH 适配与能力边界
Native DSH web-profile plugin installed via the official `dsh plugin --profile web add` command, organized per the official DSH plugin spec (host/client dual-half, dual client bundles)
File workbench with inline preview
workspace files→lazy-loading directory tree + CodeMirror editor; inline preview for images, Markdown (Mermaid with strict safe rendering), HTML and PDF; drag-and-drop file/folder upload
saves go through atomic `fs.write`; uploads write files into the workspace (media/preview routes are limited to the session cwd)Real terminal (xterm.js + node-pty)
shell configuration (shell / shellArgs settable in the settings page or cordis.patch.yml)→real shell with disconnect-reconnect replay; optional `terminal_*` tools injected for the model
spawns real shell processes on the host; optionally exposes terminal tools to the modelService-first extension API (ctx.betterSidebar)
third-party DSH plugins injecting the `betterSidebar` service→custom sidebar tabs and file viewers registered via `registerTab` / `registerFileViewer`
Git panel + session-isolated dual workbench
the session's git repository and open tabs→real diff with VSCode-style diff tabs, history, right-click stage / commit / restore; layout, tabs and panels persisted per session
invokes the git CLI (stage/commit/restore) but never sets git identity
04适合谁?何时不该用?
适合
- DeepSeek Harness (dsh web) users who want an IDE-grade sidebar UI without leaving the harness
- DSH plugin developers building UI panels on top of a shared sidebar foundation
不适合
- The current release requires DSH 0.1.0-rc.8 — all `@deepseek-ai/*` peer/dev dependencies are pinned to `^0.1.0-rc.8`, and DSH rc.7 or earlier cannot resolve the dependencies (upgrade DSH first).
- The real terminal depends on node-pty prebuilt binaries; if your Node version has no prebuild (common on Windows), a compile toolchain such as VS Build Tools is required.
05兼容性、维护与安全提示
- The current release requires DSH 0.1.0-rc.8 — all `@deepseek-ai/*` peer/dev dependencies are pinned to `^0.1.0-rc.8`, and DSH rc.7 or earlier cannot resolve the dependencies (upgrade DSH first).
- Git integration has no push/pull/fetch, there is no file watcher (manual refresh needed), and inline file-open buttons in tool output cannot be intercepted.
- The real terminal depends on node-pty prebuilt binaries; if your Node version has no prebuild (common on Windows), a compile toolchain such as VS Build Tools is required.
MIT · actively maintained (latest release v0.14.0, 2026-08-19)
06常见问题
如何把 dsh-better-sidebar 安装到 DeepSeek Harness?
在 DSH 可正常运行(`dsh web`)的前提下执行 `dsh plugin --profile web add dsh-better-sidebar@latest`,然后硬刷新浏览器(Cmd/Ctrl+Shift+R)即可看到侧边栏。client 改动热加载无需重启,仅 host 半更新时需要重启。前置条件:Node.js ≥ 20、pnpm ≥ 10。
它是 DSH 原生插件还是 MCP?
是原生 DSH 插件:按 DSH 官方插件规范组织(无 default 导出、双 client bundle),通过官方 `dsh plugin` 命令安装到 web profile,运行期 `@deepseek-ai/*` 模块由 web profile 提供,不走 MCP。
对 DSH 版本有什么要求?
当前版本适配 DSH 0.1.0-rc.8,全部 `@deepseek-ai/*` 依赖升至 `^0.1.0-rc.8`。rc.7 及更早的 DSH 环境无法解析本版依赖,需要先升级 DSH。
其他插件能在侧边栏里加页面吗?
可以。插件自 v0.4.0 起暴露 `ctx.betterSidebar` 服务,第三方插件通过 `registerTab` / `registerFileViewer` 注册侧边栏页面和文件预览器,与内置的 7 个 tab、6 个 viewer 使用同一套 API。
有哪些已知限制?
Git 面板不支持 push/pull/fetch,没有文件 watcher(需手动刷新);真实终端依赖 node-pty,Windows 上若当前 Node 版本没有预编译二进制,需要安装编译工具链(VS Build Tools)。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件:Claude Code 风,鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件:自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆,很丝滑的开发体验。
dsh-popout-sidebar
作者 e2mcc
将侧边栏弹出为独立浏览器标签页,可拖到另一块屏幕使用
seektty
作者 hilbert-beinghappy
面向 DeepSeek Harness 的 Claude Code 风格终端界面,支持 Windows、macOS 与 Linux,兼容透明终端、VS Code 主题和自定义配色。
08数据与来源
dsh plugin --profile web add dsh-better-sidebar@latest
插件按 DSH 官方规范组织(无 default 导出、双 client bundle),运行期不依赖 npm / checkout(`@deepseek-ai/*` 由 web profile 提供)。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
