메뉴
Detects whether the Ra3MapUtils desktop app (地编伴侣) is running by calling its local HTTP companion-presence endpoint. Use when the user asks if 地编伴侣 or Ra3MapUtils is running, alive, up, reachable, or before relying on other localhost:30033 APIs.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Red Alert 3 地图脚本、WorldBuilder、Lua 4.0、脚本加载顺序、地编伴侣 Ra3MapUtils。 在编写或修改 RA3 地图 Lua、配置脚本加载顺序、区分 Lua4 与 Lua5 语法、或对照引擎 API 时使用。
使用 C# 批量编辑 Red Alert 3 地图（Ra3MapSharp / Dreamness.RA3.Map.Facade），并通过 Ra3MapUtils 地编伴侣直接执行 C#（HTTP 与 MCP）。 当用户需要地图自动化改图、地形纹理处理、单位/路径点/玩家/队伍调整、脚本 JSON 导入导出、或查询 C# 地图库 API 时使用。 Use when users ask for RA3 map editing in C#, map automation scripts, map data import/export, or running C# via companion MCP/HTTP.
Validates Red Alert 3 map Lua 4.0 script syntax and retrieves error details by calling the Ra3MapUtils local HTTP API. Use when checking .lua map scripts, Lua4 syntax, RA3 triggers/scripts, or when the user asks to verify Lua4 against the running Ra3MapUtils service.
| name | ra3-maputils-companion-http |
| description | Detects whether the Ra3MapUtils desktop app (地编伴侣) is running by calling its local HTTP companion-presence endpoint. Use when the user asks if 地编伴侣 or Ra3MapUtils is running, alive, up, reachable, or before relying on other localhost:30033 APIs. |
Ra3MapUtils 内置 Kestrel：http://127.0.0.1:30033（仅本机）。
| 方法 | 路径 | 作用 |
|---|---|---|
GET | /api/status/companion | 返回固定 appId 与展示名，用于确认是地编伴侣而非误连其他服务 |
完整 URL：http://127.0.0.1:30033/api/status/companion
code === 1000（成功，见 Ra3MapUtils ApiResponseCode.Success）data.appId === "Ra3MapUtils"（ Newtonsoft 默认 camelCase 时为 data.appId）
→ 地编伴侣进程已启动且 HTTP 服务可用。data.displayName（地编伴侣）、data.version。data.running 在成功响应中应为 true；仍以 code 与 appId 为准。
GET /api/status/ping 返回 pong 也可说明端口上有服务，但不能区分是否为 Ra3MapUtils。需要确认是地编伴侣时，请用 /api/status/companion。
curl -s "http://127.0.0.1:30033/api/status/companion"
PowerShell 也可用 Invoke-RestMethod 解析 JSON 后检查 code 与 data.appId。
在对话中需要判断地编伴侣是否运行时：用终端执行上述请求，根据结果回答用户；若失败，明确说明可能未启动或端口被占用。