当需要理解或扩展基础设施层（加载器、基类、路径、错误处理）等底层开发时使用。
npx skills add https://github.com/sunflowermm/XRK-AGT --skill xrk-infrastructureCopy and paste this command into Claude Code to install the skill
当你需要开发/调试 AIStream 工作流、RAG 上下文增强、子服务端回退逻辑、MCP 工具注册与作用域控制时使用。
当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。
当你需要解释/排查 HTTP 或 WebSocket 的 401、127 回环例外、API Key 机制时使用；确保业务层不重复鉴权。
当你需要理解 XRK-AGT 的运行时核心（Bot 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。
当你需要复用日志/缓存/文件/网络/批处理等基础能力，或为新模块选择合适的工具函数时使用。
当你需要新增/调整配置字段、确保 YAML 与 commonconfig schema 与代码消费一致、或解释配置路径规则时使用。
| name | xrk-infrastructure |
| description | 当需要理解或扩展基础设施层（加载器、基类、路径、错误处理）等底层开发时使用。 |
docs/底层架构设计.mddocs/框架可扩展性指南.md| 扩展点 | 基类 | 加载器 | 扫描目录 |
|---|---|---|---|
| 插件 | #infrastructure/plugins/plugin.js | plugins/loader.js | core/*/plugin/*.js |
| HTTP | #infrastructure/http/http.js | http/loader.js | core/*/http/*.js |
| 工作流 | #infrastructure/aistream/aistream.js | aistream/loader.js | core/*/stream/*.js |
| Tasker | — | tasker/loader.js | core/*/tasker/*.js |
| 事件 | #infrastructure/listener/base.js | listener/loader.js | core/*/events/*.js |
| 配置 | #infrastructure/commonconfig/commonconfig.js | commonconfig/loader.js | core/*/commonconfig/*.js |
| 渲染器 | #infrastructure/renderer/Renderer.js | renderer/loader.js | src/renderers/* |
浏览器截图实现继承 src/infrastructure/renderer/browser-renderer-base.js（Puppeteer/Playwright 共用 lock、Redis WS、截图槽位等）。
| 模块 | 路径 | 说明 |
|---|---|---|
| DB 连接 | #utils/db-connect-utils.js | Redis/Mongo 共用 retry、URL 脱敏、ARM64 检测 |
| HTTP 业务 API 约定 | src/infrastructure/http/README.md | 路由、HttpResponse、InputValidator |
| 配置种子 | src/infrastructure/config/config-seed.js | 端口配置模板复制 |
# 别名#utils/*、#infrastructure/*、#factory/*、#config/*、#data/*、#core/*、#renderers/*、#modules/*。业务用全局 segment，勿 import #oicq。
core/；改 src/ 仅限基类/加载器/工具。BotUtil.makeLog；HTTP 响应：HttpResponse（#utils/http-utils.js）；错误：#utils/error-handler.js + normalizeError。cfg.aistream → data/server_bots/{port}/aistream.yaml（非 server_bots 根目录）。xrk-node-runtime；禁止在 Core 中引入 node-fetch、promisify(exec)、instanceof Error 判错等旧写法。exec-async.js、normalize-error.js、proxy-utils.js，勿在 Core 重复封装。