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 的連接信息：

1. Settings → Plugins → Netx Ops
2. 填寫 API URL、Token 以及 Capability groups（工具分組）。

2. 啓用告警推送（可選）¶

若需接收 Netx 的關鍵告警：

1. 在插件設置中啓用 關鍵告警推送。
2. DSH 會作爲客戶端向外發起連接。
3. 選擇投遞方式：Deliver to DSH session（投遞到當前 DSH 會話）或 Deliver to WhatsApp / IM。
4. 需在 IM 投遞設置中獲取 botId 和 targetId。

3. 導出會話（可選）¶

在 Plugins 卡片中，點擊 導出全部會話，瀏覽器會下載包含當前主機所有會話的 ZIP 文件。

4. 選擇 Agent 預設¶

1. Settings → Agent presets → Custom
2. 在列表中找到 Netx Ops。首次激活主機時會自動安裝此預設。
3. 創建新會話時，在 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