mirror of https://github.com/hansjone/netxops.git synced 2026-10-09 04:00:46 +08:00

hansjone 45922ffd29 Move netx URL/token into DSH host settings and credentials.

Mount MCP from dsh-netxops instead of OS env in the agent preset.

2026-09-04 22:01:04 +08:00

2.8 KiB

Raw Blame History

Install Netx Ops on DeepSeek Harness

Prerequisites

DeepSeek Harness (dsh) installed or a local checkout.
netx API reachable (default http://127.0.0.1:8890).
Python 3.11+ on the same machine as dsh, with netx_mcp importable:

pip install "git+https://github.com/hansjone/netx.git#subdirectory=packages/netx-mcp"
python -c "import netx_mcp; print('ok')"

You do not need to export NETX_API_URL / NETX_API_TOKEN in the OS environment for normal use.

1) Install host bridge (URL + token + MCP tools)

dsh plugin --profile <name> add github:hansjone/netxops
# or from a checkout:
dsh plugin --profile <name> add /path/to/netxops

This applies cordis.patch.yml, which mounts package dsh-netxops. That plugin:

Registers settings namespace netxops (apiUrl, lang, pythonCommand, …)
Reads bearer token from credentials reference NETX_API_TOKEN (same store as model keys: ~/.dsh/.credentials.yaml)
Spawns python -m netx_mcp and registers mcp__netx__* on the host tool registry

Fill API URL / language

Target UX: Settings → Plugins → Netx Ops card (settings apiUrl / lang).
The Host settings namespace is already registered; a dedicated Plugins settings card (browser half) follows the DSH settings-card cookbook and will land in a follow-up.

Until the card ships, change composition defaults in the profile patch / plugin config:

# ~/.dsh/profiles/<name>/… or override the dsh-netxops row
config:
  apiUrl: http://10.0.0.5:8890
  lang: zh
  pythonCommand: python

Or edit the installed bundle row after dsh plugin add.

Fill netx API token (secret)

Same credential store as DeepSeek API keys — not a process env var:

powershell -File .\scripts\set-netx-token.ps1 -Token "nxt_…"

./scripts/set-netx-token.sh 'nxt_…'

This writes / updates refs.NETX_API_TOKEN under %USERPROFILE%\.dsh\.credentials.yaml (or $DSH_HOME). Restart is not required if DSH is watching credentials; otherwise restart dsh web.

2) Install the agent preset (persona + skills)

git clone https://github.com/hansjone/netxops.git
cd netxops
powershell -File .\scripts\link-preset.ps1

Unix: ./scripts/link-preset.sh

Open dsh web, new session → preset Netx Ops.

Verify

Tools include mcp__netx__queryUmeAlarms (and siblings).
“Critical Top by host” → aggregate + Result/Evidence shell.
Single host_name alarm query → host-scoped tools only.

See TOOL_MAP.md.

Local debug (DeepSeekHarness checkout)

See examples/local-debug/README.md.

2.8 KiB Raw Blame History