From 5331143806904c2fdedccf0795dfb3306568f798 Mon Sep 17 00:00:00 2001 From: npc0-hue Date: Thu, 13 Aug 2026 09:45:33 +0800 Subject: [PATCH] Document local development and server management guidance --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index a3459d6..d68d613 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,19 @@ The platform_web visual direction is a unified themed game operations console: t - `platform_web/` contains the management frontend. - `plugins/` contains game management plugins and plugin SDK/examples. +## Local Development + +- `scum.npc0.com` is NAT-mapped to the local frontend at `http://127.0.0.1:5173/`. +- GPT must ignore the `.local-debug/` directory when searching, inspecting, or modifying repository files. + +## Server Management MCP Notes + +- For remote server work, use the `server-management` MCP path, not raw SSH. Start with `list_devices`, then `test_connection`, then `ssh_exec`; the configured 枣庄 device is named `枣庄服务器` with id `FyBDIohqPhRx7Cia`. +- If native MCP tool wrappers return `unsupported call`, do not keep retrying the same wrapper. Read the server-management plugin MCP config and call the local MCP JSON-RPC gateway (`initialize`, `tools/list`, `tools/call`) from a small Node script; never print or commit MCP headers, tokens, host credentials, or raw `.mcp.json` contents. +- If local access to the MCP gateway fails with `EPERM` on `127.0.0.1`, request sandbox escalation for that MCP gateway call instead of falling back to raw SSH. +- On Windows targets, assume `ssh_exec` may run under `cmd`; for PowerShell diagnostics, send `powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand ` to avoid quoting/glob problems. +- For SCUM current-service discovery, run bounded read-only scripts on `枣庄服务器` itself and return only redacted aggregates/fingerprints. Do not download or parse `SCUM.db` on the platform/plugin/browser side; product evidence must flow through Platform durable jobs and Run typed/redacted envelopes. + The machine-side run executor lives in the independent repository `git@git.npc0.com:admin343/run.git`; do not re-add a `run/` source tree to this repository. Do not place implementation code outside the matching root. Shared contracts must be generated or copied through explicit contract packages, not imported by reaching across ownership boundaries casually.