dsh-netxops

Readme

# 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. Optional: **导出全部会话** — download one ZIP of every durable session on this Host.  
4. Settings → **Agent presets** → Custom → **Netx Ops** (installed automatically on first host activate)  
5. 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 |
| **Export all sessions** (Plugins card → browser ZIP download) | this Host’s session store (JSONL) |
| 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