dsh-docker-sidebar

DeepSeek Harness（DSH）的 Docker 侧边栏面板 插件：在 WebUI 中悬浮一个可拖拽的 Docker 管理面板， 提供容器列表、资源监控、容器内文件浏览/查看/下载/上传/外部打开等功能。

声明：本插件完全由 DeepSeek Harness（DSH）开发并上传发布。

功能

• 🐳 容器列表：显示所有容器（运行/退出），一键刷新
• 📊 资源监控：所选容器的 CPU / 内存 / 内存占比 / 进程数，每 5 秒自动刷新
• 📁 容器内文件浏览：进入容器文件系统，浏览目录、查看文件内容
• ⬇️ 下载：从容器内下载文件到本地
• ⬆️ 上传：上传本地文件到容器内当前目录
• 🖥️ 外部打开：把容器内文件复制到临时目录并用系统默认程序打开
• 🪟 悬浮面板：可拖拽、可收起，深色主题与 WebUI 风格一致

安装

1. 把本插件目录复制到 DSH 插件目录：

   %DSH_HOME%\profiles\node_modules\dsh-docker-sidebar\
   

   （%DSH_HOME% 默认为 C:\Users\<用户名>\.dsh）

2. 在 %DSH_HOME%\profiles\web\cordis.patch.yml 中注册插件：

   - insert:
       - id: docker-panel
         name: dsh-docker-sidebar
   

3. 重启 DSH 服务，刷新 WebUI 页面，侧边栏即出现 Docker 面板。

使用

• 打开面板后，从下拉框选择容器；
• 面板标题栏可拖拽移动，右上角可刷新 / 收起；
• 在容器内文件区域浏览目录（点击目录进入、↑ 返回、输入路径回车直达）；
• 点击文件查看内容，可 下载 或 外部打开；
• 上传 按钮把本地文件上传到容器当前目录。

工作原理

插件由两部分组成：

文件	角色	说明
lib/index.js	Host 端	注册 /api/docker/* HTTP 接口，通过 docker CLI 执行容器操作
lib/client.js	客户端	在 WebUI 注入 React 悬浮面板，调用 Host 接口渲染数据

接口一览：

• GET /api/docker/containers — 容器列表
• GET /api/docker/stats — 容器资源统计
• GET /api/docker/files?container=&path= — 列目录
• GET /api/docker/read?container=&path= — 读取文件内容
• GET /api/docker/download?container=&path= — 下载文件
• POST /api/docker/upload?container=&path= — 上传文件
• GET /api/docker/open?container=&path= — 复制到本地并用默认程序打开

安全说明

• 插件通过 全权限 shell（danger-full-access）执行 docker 命令， 因为文件沙箱会拦截 Docker 引擎的命名管道（Windows 上即使 workspace-write 也无法访问）。 请仅在本机可信环境中使用。
• 接口未做鉴权，仅建议在本地（127.0.0.1）使用 DSH WebUI。

依赖

• Windows 系统（使用了 PowerShell 与 Windows 路径约定）
• 已安装并运行 Docker CLI（docker 命令可用）

声明

本插件完全由 DeepSeek Harness（DSH）开发并上传发布，代码以 MIT 协议开源，欢迎使用与二次开发。

许可

MIT