DSH-better-sidebar

Name: omdsh-dev/DSH-better-sidebar
Author: omdsh-dev

omdsh-dev/DSH-better-sidebar

侧边栏完整工作台：内置文件渲染编辑、终端、Git 与子代理，支持三方插件注册新 Tab。

1,590102TypeScriptMIT源码

安装

把 DSH-better-sidebar 装进 DeepSeek Harness

npm 方式

直接拉已发布的 tarball，不用克隆整个仓库，也不需要额外配置。如果你用的是别的 profile，把 `web` 换成对应的名字。

GitHub 方式 · npm 包

从 GitHub 装会执行项目自己的构建脚本，而 pnpm 默认拦着不让跑——先跑一次这条命令，pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

安装前须知

装 DSH-better-sidebar 之前，先看这几条

源码在这里： omdsh-dev/DSH-better-sidebar——已进入社区精选库，DSH 自带的插件市场就是从这儿装的。
开源协议：MIT。
自动识别到：终端执行。授权之前请先读一遍源码。
被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

DSH-better-sidebar 是做什么的

Abstract flow of files, processes, shell access and extensions into split workspaces.

DSH-better-sidebar 是一个 DeepSeek Harness 插件，把右侧栏和底部面板组合成可扩展的工作台。它提供懒加载文件树、CodeMirror 编辑器，以及图片、Markdown、HTML、PDF 的内联预览；同时包含内嵌浏览器、Git 面板、后台任务与子代理视图和真实终端。Tab 可以在两个面板之间拆分、合并和移动，布局与 Tab 会按会话保存。

它通过 npm 包中的 dsh.bundle.patch 和 cordis.patch.yml 挂载，由 DSH 的插件机制加入 dsh.profile.bundles，不改写 DSH 源码。插件向所有扩展开放 ctx.betterSidebar 服务，第三方可用 registerTab、registerFileViewer 注册页面和文件查看器，还能使用能力探测、状态订阅、Tab 生命周期、定向打开、meta 持久化及插件设置等接口。

适合需要在同一工作区查看文件、操作 Git、浏览网页并监督后台任务的 agent，也适合要向侧边栏添加功能的插件作者。不适合不需要额外工作台，或不能接受 agent 获得 shell 权限的环境：终端由 xterm.js 和 node-pty 连接真实 shell，并可选向模型提供 terminal_* tools。环境还要求 Node.js ≥ 20、pnpm ≥ 10 和可运行的 DSH web profile；Windows 在缺少匹配的 node-pty 二进制文件时可能需要 VS Build Tools。

DSH-better-sidebar 的文档

环境要求

README 要求先能运行 dsh web，并使用 Node.js ≥ 20 与 pnpm ≥ 10。默认 profile 路径是 ~/.dsh/profiles/web，目录不存在时运行 dsh web 会初始化它。Windows 的终端依赖匹配的 node-pty 预编译文件；没有对应版本时可能需要 VS Build Tools。

命令与挂载

仓库提供 scripts/install.sh 和 scripts/install.ps1。脚本会准备 pnpm 设置，通过 DSH 注册插件，识别 dsh.bundle.patch，并写入 dsh.profile.bundles；也会清理 cordis.patch.yml 中旧的手动挂载，避免出现两个侧边栏。脚本支持 --restart、--dry-run；PowerShell 对应 -Version、-Restart、-DryRun。

配置

设置页按卡片提供独立开关，二级选项位于齿轮弹窗。HTTP 链接默认在侧边栏打开，HTTPS 默认交给系统浏览器，两者可分别调整。位置兼容模式默认关闭，可为 Windows 原生标题栏预留 0–120px。界面跟随 DSH 的 zh/en 切换，终端和编辑器依赖按需加载。

服务 API 与限制

第三方插件通过 ctx.betterSidebar 接入，可调用 registerTab、registerFileViewer、getSnapshot、subscribeState、updateTab、activateTab 和 openFile。Tab 支持 onOpen、onActivate、onClose、角标、meta、urlTarget，以及 pluginToggles、render。终端断线后可回放输出；若 node-pty 加载失败，Windows 可能需要编译工具链。