Add Netx Ops Plugins settings card for URL and token.

Ship the browser half so Settings → Plugins can configure apiUrl/lang/python and NETX_API_TOKEN without OS env vars.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-09-04 22:16:14 +08:00
parent 45922ffd29
commit fd1a86ec2f
14 changed files with 1492 additions and 57 deletions

View file

@ -1,46 +1,44 @@
# netxops — Netx Ops for DeepSeek Harness
Public **DeepSeek Harness** package: host bridge (settings + credentials → netx MCP) and an **ops agent preset** (persona + playbooks).
Public **DeepSeek Harness** package: host bridge + **Plugins settings card** + ops agent preset.
- GitHub: https://github.com/hansjone/netxops
- Topic: [`dsh-plugin`](https://github.com/topics/dsh-plugin)
- npm name: `dsh-netxops`
- Package: `dsh-netxops`
- Brand: **Netx Ops**
## What you get
| Piece | Where | Purpose |
|-------|--------|---------|
| Host plugin `dsh-netxops` | `src/index.ts` + `cordis.patch.yml` | `apiUrl` / `lang` in settings; token as credential `NETX_API_TOKEN`; mounts `mcp__netx__*` |
| Host plugin | `src/index.ts` + `cordis.patch.yml` | settings `netxops` + credential `NETX_API_TOKEN` → `mcp__netx__*` |
| Plugins card | `src/client/` → `lib/client.js` | Settings → Plugins → fill URL / token in UI |
| Agent preset | `presets/netxops/` | Persona + UME / managed-NE skills |
**Not OS env:** do not put `NETX_API_URL` / `NETX_API_TOKEN` in system environment for day-to-day use — configure inside DSH (settings + credentials). See [docs/INSTALL.md](docs/INSTALL.md).
**No OS env required** for day-to-day use. See [docs/INSTALL.md](docs/INSTALL.md).
**Not in v1:** topology canvas MCP, Excel report plugin, Plugins settings **card** UI (Host namespace is ready; browser card follows DSH cookbook).
**Not in v1:** topology canvas MCP, Excel report plugin.
## Quick start
```powershell
# 1) Host bridge + MCP tools
dsh plugin --profile web add github:hansjone/netxops
# 2) Token (credentials store, same family as model keys)
powershell -File .\scripts\set-netx-token.ps1 -Token "nxt_…"
# 3) Ops preset (persona + skills)
powershell -File .\scripts\link-preset.ps1
# Then: Settings → Plugins → Netx Ops → paste token + API URL → Save
```
Then open DSH → session preset **Netx Ops**.
## Local debug
Against [`DeepSeekHarness`](https://github.com/deepseek-ai/deepseek-harness) checkout: [examples/local-debug/README.md](examples/local-debug/README.md).
[examples/local-debug/README.md](examples/local-debug/README.md)
```powershell
bun run bundle # rebuild Plugins card after src/client changes
```
## Related
- Data plane: [hansjone/netx](https://github.com/hansjone/netx)
- Porting from oclaw: [docs/PORTING.md](docs/PORTING.md)
- Porting: [docs/PORTING.md](docs/PORTING.md)
## License