dsh-popout-sidebar
e2mcc/dsh-popout-sidebar
可弹出式侧边栏:侧边栏展示产物与文件树,支持多种文件预览形式;并可弹出为独立浏览器标签页(可拖至另一显示器);兼容其他sidebar插件,可以同时显示。
安装
把 dsh-popout-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 自己的记录,不是读源码猜的。 最近一次 昨天,DeepSeek Harness 0.2.2-rc.5.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-popout-sidebar 之前,先看这几条
- 源码在这里: e2mcc/dsh-popout-sidebar——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 dsh-popout-sidebar 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.5,昨天。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类)
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — 为 DeepSeek Harness 添加弹出侧边栏,展示 artifacts 与文件树。
谁该装 — 在 DeepSeek Harness 中运行代理任务时,需要展示 artifacts 和文件树的用户适合安装此插件。 如果你希望侧边栏插件与其他 sidebar 插件完全独立的用户可以选择不安装此插件,因为此插件支持与其他 sidebar 插件共存。
注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 会执行 shell 命令,但未发现明显的坑。
锐评 — 我会安装它,因为它支持与其他 sidebar 插件共存。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-popout-sidebar 是做什么的

dsh-popout-sidebar 是一个 DeepSeek Harness 插件,为 Web UI 增加产物列表、工作区文件树和独立浏览器标签页预览。侧边栏可查看代码、纯文本、Markdown、图片、PDF 与 HTML,也能显示 edit 的删除/新增片段,复制路径或向会话输入框写入 @path。独立页面地址为 /popout-sidebar,可拖到另一台显示器;面板还能与其他 sidebar 同时显示并自动让位。
DeepSeek Harness 插件由 Host 和浏览器端 Client 组成。Host 监听 tools/result 中成功的 write、edit,并监听 tools/execute 中的 bash、pwsh。对于命令产生的文件,插件通过递归 fs.listDir 和版本 token 指纹比较工作区前后状态,读取目录与文件内容后建立产物记录;结果通过 harness.handle 和 /popout-sidebar/* 路由提供给 Client。设置保存在浏览器 localStorage 的 dsh-popout-sidebar:settings 中。
适合需要持续查看 agent 产物、文件变化和预览内容的 DeepSeek Harness 用户。不需要文件树时,或不希望插件读取工作区目录、文件内容并观察 bash/pwsh 间接改动时,不应使用它。插件面向 Web profile,安装后还需重启服务并硬刷新浏览器。
dsh-popout-sidebar 的文档
dsh-popout-sidebar 的行为说明
DeepSeek Harness 加载 Host 和 Web Client。Client 通过 shell.overlay 注册常驻入口和浮动面板;Host 监听 tools/result 的 write、edit,提取 file_path,并记录 old_string、new_string。对 bash、pwsh,插件使用 fs.listDir 递归快照和版本 token 指纹比较前后工作区,跳过 node_modules、.git 等目录。RPC 包括 artifacts.list、artifacts.read、artifacts.remove、artifacts.listDir。
dsh-popout-sidebar 的配置
设置写入浏览器 localStorage 的 dsh-popout-sidebar:settings:
| 设置 | 默认值 |
|---|---|
| 默认展开 | 开 |
| 自动刷新 | 开,每 2 秒拉取 |
| 文件树 | 开 |
| 最短面板宽度 | 20%,范围 20–60% |
| 预览区默认高度 | 70%,范围 20–80% |
面板左边缘和预览分界线都可拖动;独立标签页默认浅色,可用 ?scheme=dark。
dsh-popout-sidebar 的路由
DeepSeek Harness 提供 /popout-sidebar 页面,以及 /popout-sidebar/data、/popout-sidebar/content、/popout-sidebar/media、/popout-sidebar/remove、/popout-sidebar/listdir。Client 通过跨标签页 localStorage 同步当前会话和工作区。
命令与环境要求
DeepSeek Harness 将插件安装到 web profile。更新使用 dsh plugin --profile web update dsh-popout-sidebar。修改 Host 后重启 dsh web,修改 Client 后用 Cmd/Ctrl+Shift+R 硬刷新。README 未说明环境变量或额外平台要求。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-popout-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 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上