返回目录

dsh-ensp

精选清单收录维护状态: 活跃

lizi600jin/dsh-ensp

自动化华为 eNSP 实验:生成 .topo 文件、通过 eNSP 界面启停设备,并逐条下发 VRP 配置、按命令报错;含 12 个 MCP 工具与 23 个场景预设。

前往 GitHub
$ dsh plugin --profile desktop add dsh-ensp

156

星标

0

Fork

JavaScript

语言

GPL-3.0

许可证

2026-11-10

创建于

2026-11-14

最近推送

GPL-3.0 的 JavaScript 插件,把 DeepSeek Harness 变成华为 eNSP 的操作台:50 个场景蓝图、逐条下发配置、按断言验收并输出 Word 实验报告,仅支持 Windows 且需要管理员权限。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-15

许可证

GPL-3.0

01它能帮你完成什么?

  • 在 DeepSeek Harness 会话里搭起一套华为 eNSP 实验:生成 `.topo`、启动设备、按顺序下发每台设备的配置并逐条核对

    eNSP 能正常打开并渲染的 `.topo`、确认就绪后最小化的设备,以及逐条下发并带 `{ ok, failedAt }` 结果的配置过程

    在 Windows 上用华为 eNSP 做实验的网络工程师、讲师与学生,希望由 DSH 会话驱动实验而不是手工点按钮

  • 把做完的实验直接变成可提交的 Word 文档,而不是自己动手写

    固定六章的 `.docx`:配置原文从设备读回,验证结果是每条命令的完整输出,结论按通过 / 未通过 / 未验证三态给出

    需要提交实验报告的教师与学员,以及需要证明设备实际配置结果的人

  • 启动失败或点击无效时,先定位故障项再动拓扑

    按固定顺序逐项判定的七项结果(客户端、VirtualBox、镜像、控制台端口、输入注入、内存、锚点),失败项附带可执行的修法

    使用全新安装或刚升级的 Windows 机器的用户,以及在服务、计划任务、SSH 会话等非交互上下文里操作的用户

02如何接入 DeepSeek Harness?

前置条件

  • 仅支持 Windows —— eNSP 只有 Windows 版本,插件因此只声明 `win32`
  • 已安装且可正常运行的华为 eNSP(仓库不包含 eNSP,也不包含任何华为软件)
  • Node.js 18 或更高版本
  • DSH 0.2.0 到 0.3.0 之前的版本,兼容性由 `engines.dsh` 决定
  • 以管理员身份运行本工具与 eNSP,两者需为同一权限级别

安装步骤

  1. 01

    在插件市场搜索 `dsh-ensp` 并安装,或执行 `dsh plugin --profile desktop add dsh-ensp`

    $ dsh plugin --profile desktop add dsh-ensp

  2. 02

    不用 DSH 时:`npm install -g dsh-ensp`,再执行 `ensp status`

    $ npm install -g dsh-ensp

  3. 03

    接入 MCP 客户端(README 举例为 Claude Desktop、Cursor):配置 `{"command": "npx", "args": ["-y", "dsh-ensp", "mcp"]}`

  4. 04

    安装位置一般无需手工配置:依次探测 `--exe` / `--vbox`、`DSH_ENSP_EXE` / `DSH_VBOX` 环境变量、注册表、常见安装根目录与 `PATH`

验证接入成功

  • 先跑 `ensp doctor --topology lab.topo`:七项检查按固定顺序逐项判定,失败项给出可执行的修法,且不会启动 eNSP
  • CLI 安装段落在 `npm install -g dsh-ensp` 之后紧接着执行 `ensp status`
  • 整体按 README 推荐的顺序验收:doctor 判定环境,up 判定设备,verify 判定配置效果

03DSH 适配与能力边界

DSH 适配原生运行时

DSH 插件 —— 在会话内以模型工具的形式使用(17 个 `ensp_*` 工具),与 CLI、MCP Server 共用同一套核心,安装命令为 `dsh plugin --profile desktop add dsh-ensp`

  • 拓扑生成

    内置场景蓝图,或用 `buildTopology` 自行拼装的设备与链路→eNSP 可直接打开并正常显示的 `.topo`,接口分组与机型一致

    在 `writeTopology` 指定的路径写出 `.topo` 文件
  • 启动与停止设备

    一个 `.topo` 文件→自动定位工具栏按钮,按设备逐一确认就绪,随后最小化窗口

    启动与下发配置期间 eNSP 窗口保持最小化,不抢前台`ensp show` 只还原窗口并尝试置前,不触碰拓扑与设备状态`ensp stop` 关闭全部设备
  • 逐条下发配置

    每台设备一份脚本(控制台端口 + 命令文本)→`{ ok, failedAt }`,失败时带行号、命令与设备原始输出;“已存在”的行记为跳过,其他错误立即中断

    改动 eNSP 中正在运行的设备配置
  • 等待协议收敛

    控制台端口,加上邻居 ID、前缀,或命令与正则→轮询得到的 `{ ok, converged, output, attempts, waitedMs }`,而不是固定等待

  • 50 个场景预设

    场景名,或用 `--search` 按关键词检索→需要创建的对象、配置顺序与检查命令;`--topo` 生成蓝图拓扑,`--config` 输出每台设备的地址配置

  • 验收与实验报告

    场景名加 `--topology <文件>`→按输出内容判定的通过 / 未通过结论(约 48 个场景带针对性断言),以及六章结构的 `.docx` 报告

    对设备执行该场景的验收命令生成报告时对每台设备执行 `display current-configuration`

04适合谁?何时不该用?

适合

  • 在 Windows 上用华为 eNSP 做实验的网络工程师、讲师与学生,希望由 DSH 会话驱动实验而不是手工点按钮
  • 需要提交实验报告的教师与学员,以及需要证明设备实际配置结果的人
  • 使用全新安装或刚升级的 Windows 机器的用户,以及在服务、计划任务、SSH 会话等非交互上下文里操作的用户

不适合

  • 仅支持 Windows。eNSP 只有 Windows 版本,插件因此只声明 `win32`,没有 macOS 或 Linux 的运行路径。
  • 本工具必须以管理员身份运行,且 eNSP 需处于同一权限级别:Windows 的 UIPI 会丢弃低完整性进程发出的输入消息,普通权限下 `SendInput` 返回成功但点击无效。
  • 插件无法把 eNSP 窗口提到前台——Windows 只允许持有前台权限的进程切换前台窗口——所以运行前必须手动把 eNSP 置于最上层;窗口被其他程序覆盖时鼠标事件会落到那个程序上,工具在点击前就会停止。
  • 兼容范围锁定在 DSH 0.2.0 到 0.3.0 之前的版本,由 `engines.dsh` 判定。
  • 服务、计划任务、SSH 会话等非交互上下文不具备输入注入能力,提升权限也无法改变;可用 `ensp doctor` 的 `input-injection` 项判断当前会话是否可用。

05兼容性、维护与安全提示

  • 仅支持 Windows。eNSP 只有 Windows 版本,插件因此只声明 `win32`,没有 macOS 或 Linux 的运行路径。
  • 本工具必须以管理员身份运行,且 eNSP 需处于同一权限级别:Windows 的 UIPI 会丢弃低完整性进程发出的输入消息,普通权限下 `SendInput` 返回成功但点击无效。
  • 插件无法把 eNSP 窗口提到前台——Windows 只允许持有前台权限的进程切换前台窗口——所以运行前必须手动把 eNSP 置于最上层;窗口被其他程序覆盖时鼠标事件会落到那个程序上,工具在点击前就会停止。
  • 兼容范围锁定在 DSH 0.2.0 到 0.3.0 之前的版本,由 `engines.dsh` 判定。
  • 服务、计划任务、SSH 会话等非交互上下文不具备输入注入能力,提升权限也无法改变;可用 `ensp doctor` 的 `input-injection` 项判断当前会话是否可用。
  • 本项目是自动化外壳:不包含 eNSP、不包含任何华为软件或镜像,镜像也不会自动下载,安装 eNSP 并遵守华为软件许可是使用者自己的责任。
  • eNSP 只允许运行一个实例;异常退出可能遗留持有单实例锁的僵尸进程,导致下次启动只打开空白窗口,工具会在启动前识别并清理这类进程。
2026-11-102026-11-13v0.8.0

GPL-3.0 · 最新发布 v0.8.0(2026-11-14T09:40:23Z)

06常见问题

怎么把 dsh-ensp 装进 DeepSeek Harness?

在插件市场搜索 `dsh-ensp` 并安装,或执行 `dsh plugin --profile desktop add dsh-ensp`。README 另外还给了 CLI(`npm install -g dsh-ensp`)与 MCP Server(`npx -y dsh-ensp mcp`)两种用法,三种方式共用同一套核心。

支持哪个 DSH 版本?

DSH 0.2.0 到 0.3.0 之前的版本,兼容性由 `engines.dsh` 决定;另外需要 Node.js 18 或更高版本。

在 DSH 里使用也必须以管理员身份运行吗?

是。README 明确要求本工具以管理员身份运行,并让 eNSP 与工具处于同一权限级别:Windows 的 UIPI 会丢弃低完整性进程发出的输入消息,普通权限下 `SendInput` 返回成功但输入队列不变,表现为点击无效。服务、计划任务与 SSH 会话等非交互上下文即使提升权限也无法注入输入,可用 `ensp doctor` 的 `input-injection` 项判断当前会话是否可用。

17 个工具能覆盖哪些环节?

README 列出的 17 个工具包括 `ensp_status`、`ensp_build_topology`、`ensp_open`、`ensp_start`、`ensp_stop`、`ensp_apply`、`ensp_apply_dir`、`ensp_query`、`ensp_probe`、`ensp_show`、`ensp_images`、`ensp_doctor`、`ensp_verify`、`ensp_report`、`ensp_scenarios`、`ensp_scenario`、`ensp_preset_config`;一次完整实验推荐的顺序是 `doctor`、`up`、`verify`。

包含 eNSP 和设备镜像吗?

不包含。README 说明本项目只是自动化外壳,不含 eNSP,也不含任何华为软件或镜像;使用前需自行安装并遵守华为的软件许可。镜像不会自动下载,`ensp images` 只负责报告每个机型期望的路径,并可用你手上已有的文件完成安装。

08数据与来源

  • 作者声明github.com9f1452bb8a54…

    - DeepSeek Harness 插件:以模型工具的形式在会话内使用

  • 作者声明github.com9f1452bb8a54…

    提供 17 个工具:`ensp_status`、`ensp_build_topology`、`ensp_open`、`ensp_start`、`ensp_stop`、`ensp_apply`、`ensp_apply_dir`、`ensp_q…

  • 作者声明github.com9f1452bb8a54…

    dsh plugin --profile desktop add dsh-ensp

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。