STARDUSTLC666/dsh-docker 预览 preview

STARDUSTLC666/dsh-docker

Plugin插件 Native原生 ⭐ 3 MIT Dev Workflow开发与代码工作流

DeepSeek Harness 容器管理插件:docker_ps/logs/inspect/exec/manage 五工具,官方 subprocess 服务、argv 无 shell 注入、exec 审批门、零运行时依赖。· 面向 DeepSeek Harness 智能体的容器管理方案。

Project Overview项目介绍

This is a native DSH plugin built exclusively for DeepSeek Harness that provides Docker container management capabilities. It ships seven tools that cover common Docker operations including listing containers and images, checking container logs, inspecting container details, executing commands inside containers, managing container lifecycles, and checking Docker daemon health. The plugin calls the local docker CLI via DSH’s official subprocess service, passes all arguments as an independent argv array to eliminate shell injection risks, and enables approval gates for high-risk operations by default. It has zero additional runtime dependencies beyond a working local Docker installation.

You can install this plugin directly from the DSH command line using the command dsh plugin --profile web add @stardustlc/dsh-docker. The only requirement beyond DSH itself is that you have a working Docker installation on your local machine, and that the docker command is accessible in your system PATH. If the docker executable is not in your system PATH, you can manually specify its full location via the dockerPath configuration option in your DSH profile. You can also set a custom timeout for all Docker operations, or disable the default approval gates for high-risk actions if needed, though disabling these security gates is not recommended for regular use.

This plugin has been verified to work correctly on official DSH versions 0.1.5-rc.1 and 0.1.5-rc.2 with Node.js version 24.16.0. It requires the same Node.js version range as the installed DSH: either 22.x version 22.19.0 or higher, or Node.js 24 or higher. It is released under the permissive open-source MIT license, so it is free to use, modify, and redistribute for any purpose. It also includes multiple additional security protections such as container name validation, operation timeout clamping, and strict limits on log output length to prevent accidental or malicious harm to your system.

这是一个专为DeepSeek Harness(DSH)开发的原生容器管理插件,提供七个Docker管理工具,覆盖容器与镜像列表查询、日志查看、容器详情获取、容器内命令执行、容器生命周期管理和Docker服务健康检查等功能。它通过官方subprocess服务调用本地docker CLI,所有参数以独立argv数组传递,可避免shell注入风险,默认开启高危操作审批门,且无额外运行时依赖。

开发者可以通过DSH命令行快速安装该插件,安装命令为dsh plugin --profile web add @stardustlc/dsh-docker,仅要求本机已安装Docker且docker命令可被访问,若Docker不在系统PATH中可通过配置项dockerPath手动指定。插件支持自定义操作超时时间,也可根据需求关闭默认开启的审批门,不过不推荐关闭高危操作的审批防护,安装后AI代理即可直接调用插件提供的Docker工具。

该插件已在官方DSH 0.1.5-rc1、rc2版本和Node.js 24.16.0上验证通过,要求Node版本与DSH一致,即22.19及以上的22.x,或24及以上版本。卸载可通过DSH命令行执行,卸载后需重启DSH Web服务,如需彻底清理还需手动删除配置文件中的对应条目。插件采用MIT许可证开源,无使用成本,安全设计上做了多重防护,包括容器名校验、操作超时钳制和日志行数限制,避免恶意或误操作风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile desktop add @stardustlc/dsh-docker

把 STARDUSTLC666/dsh-docker 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-docker

English

dsh-docker 鲸鱼娘插件封面

在 DSH 中查看和管理本机 Docker 容器与镜像。

npm downloads

功能

  • 查看容器、镜像、日志和资源状态。
  • 运行容器内命令,执行常用管理操作。
  • 执行和破坏性操作遵循宿主审批。

安装

桌面版可在「插件」面板按包名 @stardustlc/dsh-docker 安装。已配置 dsh 命令时也可使用:

dsh plugin --profile desktop add @stardustlc/dsh-docker

网页版把命令中的 desktop 改为 web。安装后重启 DSH。

开始使用

安装后可说:“检查这个容器为什么退出,先查看状态和日志。”

依赖与配置

需要已安装且可访问的 Docker CLI 与 Docker 服务。

详细配置、工具参数与排错见使用说明。从源码独立开发时,Node 要求以 package.json 为准。

文档

License

MIT

← 上一个 Prev agnes-media 下一个 Next dsh-workspace-explorer →