DSH Better Sidebar:文件、终端与 Git 插件
omdsh-dev/DSH-better-sidebar
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
安装
把 DSH-better-sidebar 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 DSH-better-sidebar 之前,先看这几条
- 源码在这里: omdsh-dev/DSH-better-sidebar——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
- 自动识别到:终端执行。授权之前请先读一遍源码。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — DSH-better-sidebar 是一个侧边栏工作台,能渲染文件、编辑代码、运行终端、处理 Git 状态并支持子代理,第三方插件可通过同一 API 注册新标签页。
谁该装 — 在使用 DeepSeek Harness 时若需侧边栏展示文件状态、终端输出和 Git 变更,并使用 DSH 模型处理代码文件,此插件能提供完整工作台能力。 如果你主要进行纯文本交互而不涉及文件和终端工具的人,可以考虑其他轻量界面方案,因为它是为多功能文件管理场景准备的。
注意 — 实测在全新 profile 里装上并被 harness 注册进 profile。安装依赖构建脚本时会执行 shell 命令,可能需额外步骤处理。没发现明显的坑。
锐评 — 我会装它,因为它能整合侧边栏文件和终端能力;前提是安装时处理好构建依赖的额外步骤。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
DSH-better-sidebar 是做什么的

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 可能需要编译工具链。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
DSH-better-sidebar 的同类插件
dsh-web-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
我们跑过,装得上
dsh-web-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上