mirror of
https://github.com/hansjone/netxops.git
synced 2026-10-09 12:10:46 +08:00
oliver
13db99484f
Path installs junction the checkout outside ~/.dsh/profiles/*/node_modules, so Node cannot see DSH peers; add link-dsh-peers scripts and document the one-time setup. Co-authored-by: Cursor <cursoragent@cursor.com>
75 lines
2.4 KiB
Markdown
75 lines
2.4 KiB
Markdown
# Install Netx Ops on DeepSeek Harness
|
|
|
|
## Prerequisites
|
|
|
|
1. **DeepSeek Harness** (`dsh`) installed or a local checkout.
|
|
2. **netx API** reachable (default `http://127.0.0.1:8890`).
|
|
3. **Python 3.11+** on the same machine as `dsh`, with `netx_mcp` importable:
|
|
|
|
```powershell
|
|
pip install "git+https://github.com/hansjone/netx.git#subdirectory=packages/netx-mcp"
|
|
python -c "import netx_mcp; print('ok')"
|
|
```
|
|
|
|
You do **not** need OS environment variables for `NETX_API_URL` / `NETX_API_TOKEN`.
|
|
|
|
## 1) Install host bridge + Plugins settings card
|
|
|
|
```bash
|
|
dsh plugin --profile <name> add github:hansjone/netxops
|
|
# or from a checkout:
|
|
dsh plugin --profile <name> add /path/to/netxops
|
|
```
|
|
|
|
This mounts `dsh-netxops` (host + browser halves):
|
|
|
|
- Host: settings namespace **`netxops`**, credential **`NETX_API_TOKEN`**, spawns `mcp__netx__*`
|
|
- Browser: **Settings → Plugins → Netx Ops** card (API URL / lang / python + token)
|
|
|
|
### Fill in the UI (recommended)
|
|
|
|
1. Open `dsh web` → **Settings** → **Plugins** → **Plugin configuration**
|
|
2. Expand **Netx Ops**
|
|
3. Paste **API token** (stored as credential `NETX_API_TOKEN`, never in settings JSON)
|
|
4. Set **API URL** (e.g. `http://127.0.0.1:8890`), optional lang / python command
|
|
5. **Save** — MCP remounts with the new values
|
|
|
|
### Optional CLI for token only
|
|
|
|
```powershell
|
|
powershell -File .\scripts\set-netx-token.ps1 -Token "nxt_…"
|
|
```
|
|
|
|
## 2) Install the agent preset (persona + skills)
|
|
|
|
```powershell
|
|
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
|
|
|
|
1. Settings → Plugins shows **Netx Ops** card; token badge becomes “Configured” after save.
|
|
2. Tools include `mcp__netx__queryUmeAlarms` (and siblings).
|
|
3. “Critical Top by host” / single `host_name` alarm query work.
|
|
|
|
See [TOOL_MAP.md](TOOL_MAP.md).
|
|
|
|
## Local `link:` / path install
|
|
|
|
When you `dsh plugin add D:\path\to\netxops`, pnpm junctions the checkout **outside** the profile tree. Node then resolves imports from that checkout, so DSH peer packages (`@deepseek-ai/schemastery`, …) are invisible unless you link them once:
|
|
|
|
```powershell
|
|
powershell -File .\scripts\link-dsh-peers.ps1
|
|
```
|
|
|
|
Unix: `./scripts/link-dsh-peers.sh`
|
|
|
|
(Requires a prior `dsh web` / profile boot so `~/.dsh/profiles/node_modules` exists.)
|
|
|
|
npm / GitHub installs place the package under the profile `node_modules` and do **not** need this step.
|