返回目录

dsh-better-sidebar

编辑精选维护状态: 活跃

omdsh-dev/dsh-better-sidebar

开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.

前往 GitHub
$ dsh plugin --profile web add dsh-better-sidebar@latest

3,461

星标

310

Fork

TypeScript

语言

MIT

许可证

2026-08-07

创建于

2026-09-09

最近推送

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

安装步骤

  1. 01

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

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

  2. 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 适配与能力边界

DSH 适配原生运行时

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 fileslazy-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 model
  • Service-first extension API (ctx.betterSidebar)

    third-party DSH plugins injecting the `betterSidebar` servicecustom sidebar tabs and file viewers registered via `registerTab` / `registerFileViewer`

  • Git panel + session-isolated dual workbench

    the session's git repository and open tabsreal 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.
2026-08-072026-08-19v0.14.0

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)。

08数据与来源

  • 作者声明github.com50a888845fc6…

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

  • 作者声明github.com50a888845fc6…

    插件按 DSH 官方规范组织(无 default 导出、双 client bundle),运行期不依赖 npm / checkout(`@deepseek-ai/*` 由 web profile 提供)。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。