mirror of
https://github.com/hansjone/netxops.git
synced 2026-10-13 09:20:45 +08:00
65 lines
3 KiB
Markdown
65 lines
3 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. 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`).
|
||
|
||
## Flexible publication
|
||
|
||
Settings → Plugins → Netx Ops supports a master publication switch and independent
|
||
targets for ops, topology, biz-monitor, and knowledge-base capabilities:
|
||
|
||
- Enable in the built-in **Netx Ops** preset.
|
||
- Select specific other presets from the live Host roster.
|
||
- Publish to **all presets** through the Host layer.
|
||
|
||
Tools and corresponding skills follow the same policy. Changes auto-save and apply
|
||
to current and new sessions on their next model request. Turning the master switch
|
||
off removes all plugin-managed Netx tools and skills while retaining your selections.
|
||
After upgrading the plugin, restart each installed Host once; subsequent publication
|
||
changes do not need a restart.
|
||
|
||
See the [Chinese diagnosis and validation report](docs/PUBLICATION-REVIEW.zh.md).
|
||
Development checks: `bun run typecheck`, `bun test`, and `bun run preview:client`.
|
||
|
||
**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
|