Netx Ops：DeepSeek Harness Netx Ops 插件

前言¶

在 DeepSeek Harness（DSH）环境中，将智能体能力与底层网络运维系统（Netx）集成是常见需求。DSH 采用插件化架构，通过插件可以扩展原生工具、管理会话并配置 Agent 预设。Netx Ops 是一个现成的插件方案，旨在解决 DSH 与 Netx 系统的对接问题，提供原生 REST 工具、Agent 预设以及可视化的交互卡片。

核心功能¶

Netx Ops 主要包含以下能力：

原生 REST 工具：提供 netx__* 开头的 REST 接口，分为 ops 和 topology 两个工具组。
Agent 预设：内置 Agent 预设，包含相关技能。
插件卡片：提供可视化的管理界面。
关键告警推送：支持通过 WebSocket 客户端将告警推送到 DSH 会话，或投递至 IM（如 WhatsApp）。
会话导出：支持将当前主机的所有持久化会话导出为 ZIP 包。
MCP 支持：插件包含 Model Context Protocol 支持，但 DSH 运行时并非必需。

安装与启用¶

安装需要在命令行中直接执行，确保依赖项在同一行配置。

dsh plugin --profile web add `
  github:hansjone/netxops `
  github:hansjone/dsh-im-ops `
  github:hansjone/dsh-ops-cron
dsh web

注意：IM（dsh-im-ops）和 Cron（dsh-ops-cron）必须是当前配置文件行的直接依赖项。

安装完成后，插件会自动处理后续配置。

配置与使用¶

1. 插件设置¶

进入 Web 界面，配置 Netx Ops 的连接信息：

Settings → Plugins → Netx Ops
填写 API URL、Token 以及 Capability groups（工具分组）。

2. 启用告警推送（可选）¶

若需接收 Netx 的关键告警：

在插件设置中启用 关键告警推送。
DSH 会作为客户端向外发起连接。
选择投递方式：Deliver to DSH session（投递到当前 DSH 会话）或 Deliver to WhatsApp / IM。
需在 IM 投递设置中获取 botId 和 targetId。

3. 导出会话（可选）¶

在 Plugins 卡片中，点击 导出全部会话，浏览器会下载包含当前主机所有会话的 ZIP 文件。

4. 选择 Agent 预设¶

Settings → Agent presets → Custom
在列表中找到 Netx Ops。首次激活主机时会自动安装此预设。
创建新会话时，在 Agent 选择界面选择 Netx Ops。

技能维护与注意事项¶

技能编辑¶

如果需要修改技能，不能直接在插件源码中编辑。必须进入与 Netx Ops 兄弟目录的 netx 仓库中的 skills/ 树进行修改，然后运行同步脚本：

powershell -File .\scripts\sync-skills-from-netx.ps1

系统要求¶

API 连接：DSH 需要能够访问可用的 Netx HTTP API，不支持本地 pip install netx_mcp 的方式。
依赖规则：安装时，IM 和 Cron 相关插件必须与主插件放在同一行 add 命令中，否则会触发 blockExoticSubdeps 错误。

总结¶

Netx Ops 通过原生工具和 Agent 预设，为 DSH 提供了与 Netx 系统交互的标准入口。通过插件卡片，开发者可以方便地管理告警推送和会话导出。在使用时，需注意依赖项的安装顺序以及技能文件与源码仓库的对应关系。

GitHub 仓库：https://github.com/hansjone/netxops
社区目录：https://www.skillhub.cn/plugins/hansjone/netxops
许可证：MIT