netxops/README.md
oliver eb8299d155 Stop nesting github IM/cron under netxops (blockExoticSubdeps).
Profile pnpm rejects exotic subdependencies; install netxops + dsh-im-ops + dsh-ops-cron as one direct add line instead.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-06 02:41:39 +08:00

45 lines
2 KiB
Markdown

# netxops — Netx Ops for DeepSeek Harness
Public **DeepSeek Harness** package: native `netx__*` REST tools + Plugins card + **agent preset (skills included)**.
- GitHub: https://github.com/hansjone/netxops
- Package: `dsh-netxops`
- Brand: **Netx Ops**
## Install (one command)
```powershell
dsh plugin --profile web add `
github:hansjone/netxops `
github:hansjone/dsh-im-ops `
github:hansjone/dsh-ops-cron
dsh web
```
IM + cron must be **direct** profile deps (same `add` line). Nesting `github:` under netxops hits `blockExoticSubdeps` / `ERR_PNPM_EXOTIC_SUBDEP`. Details: [docs/INSTALL.md](docs/INSTALL.md).
Then:
1. Settings → **Plugins** → **Netx Ops** → API URL / token / capability groups
2. Optional: enable **关键告警推送** — DSH dials out to netx; choose **Deliver to DSH session** and/or **Deliver to WhatsApp / IM** (paste `botId`+`targetId` from IM 投递设置). The card shows live WSS status.
3. Settings → **Agent presets** → Custom → **Netx Ops** (installed automatically on first host activate)
4. New session → choose **Netx Ops**
Also need: a reachable **netx API** (no local `pip install netx_mcp`).
**Skills:** edit only in the sibling **netx** repo `skills/` tree, then `powershell -File .\scripts\sync-skills-from-netx.ps1` before publish. Linked local installs prefer `../netx/skills` or `NETX_SKILLS_ROOT` at runtime.
## What is coupled
| In the plugin | Outside (data / runtime) |
|---------------|---------------------------|
| `netx__*` REST tools (groups: ops / topology; one group ↔ one skill; optional host publish + `tools-ops|topology`) + settings + credentials | netx HTTP API (URL + token) |
| Optional key-alarm push (WSS client → sticky DSH session) | netx `/v1/integrations/dsh-alarm/ws` hub |
| Persona + skills (`netx-ops` / `netx-topology`) | |
| Agent preset auto-install to `~/.dsh/.agent-presets` | |
MCP (`python -m netx_mcp`) remains available for OpenClaw / other hosts — not required for DSH.
## License
MIT