netxops/README.md
oliver 92279c1220 Add session bulk export and multi-target IM alarm delivery.
Ops can download every Host session as a ZIP for HQ analysis, fan key alarms to multiple WhatsApp targets, and the Plugins card copy stays short.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-06 14:11:54 +08:00

47 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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