xrk-auth

当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/sunflowermm/XRK-AGT --skill xrk-auth

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

SKILL.md

소스 지침 · 읽기 전용 미리보기

name	xrk-auth
description	当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。

docs/AUTH.md
门面：src/agent-runtime.js（_authMiddleware、checkApiAuthorization、wsConnect）
实现：src/infrastructure/http/runtime-auth.js、runtime-ws.js、auth.js

/api/ 由 HttpApi + AgentRuntime.checkApiAuthorization；公开路由 systemAuth: false。
默认所有客户端须 API Key；server.auth.loopbackExempt===true 时才允许「本机 Host+127」免 Key（公网/反代勿开）。runEnabled=true 时即便 exempt 也强制 Key。
控制台鉴权模式：公开 GET /api/system/auth-mode → requiresKey；禁止用无 Key 打受保护接口靠 401 探测。
WS：wsConnect → runtime-ws；AgentRuntime.wsf[path] 可为 { handler, skipAuth: true } 跳过系统 Key。

Header：X-API-Key、Api-Key、Authorization: Bearer|Token|ApiKey <key>；查询仅 api_key / apiKey。不接受 body 与 token/key 等易撞字段。