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,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 DSH-better-sidebar 之前,先看这几条
- 源码在这里: omdsh-dev/DSH-better-sidebar——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 DSH-better-sidebar 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类)
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — 在 DSH 里加可编辑文件树、Git、终端底栏和子 agent 拓扑,其他 plugin 也可注册页签。
谁该装 — 在 DSH 里驱 agent 改仓库,人还要边看这次动了哪些文件、后台子任务和命令输出边上手改时,对得上号。 仓库已经在外部 IDE 里编和提交、DSH 只用来下任务读回复的人不必装,那条链路不经过这块界面。
注意 — 实测在全新 profile 里装上,并被 DeepSeek Harness 写入该 profile。宿主需 DSH 0.2.1-rc.1 及以上;仍停在 0.2.0-rc.2 或 0.2.1-alpha.5 时不能跟 latest,必须按宿主钉版本,装完还要硬刷新浏览器。运行中会执行 shell 命令;Git Graph 只读、不展示 tag,Side Chat 仍标 beta。
锐评 — 换我:装。我多出来的那一票,是模型能调 sidebar_open 自己拉开侧栏,少一次人手去点。
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-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上