sunflowermm
sunflowermm/XRK-AGT
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/sunflowermm/XRK-AGT --skill xrk-infrastructure命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。Core www 走浏览器兼容层（xrk-www-compat）。含零配置静态与有 sign.json（纯静态/产物/反代，sign↔server 合并）挂载。
编写或审查 core/src 代码时，确保使用 Node 26 稳定 API，禁止旧写法（fetch/exec/错误/二进制）。AI 改 Core 前必读。
当你需要开发/排查 HTTP 抓取、SSRF、Playwright 受控浏览器、本地字体增强截图，或判断 web_fetch 与 browser 工作流如何选型时使用。
基于 SOC 职业分类
正在显示 SKILL.md
| name | xrk-infrastructure |
| description | 当需要理解或扩展基础设施层（加载器、基类、路径、错误处理）等底层开发时使用。 |
docs/底层架构设计.mddocs/runtime-surface.mddocs/框架可扩展性指南.md| 扩展点 | 基类 | 加载器 | 扫描目录 |
|---|---|---|---|
| 插件 | #infrastructure/plugins/plugin-base.js | plugins/loader.js | core/*/plugin/*.js |
| HTTP | #infrastructure/http/http.js | http/loader.js | core/*/http/*.js |
| 工作流 | #infrastructure/ai-workflow/ai-workflow.js | ai-workflow/loader.js | core/*/workflow/*.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 约定 | docs/http-api.md | 路由、HttpResponse、InputValidator |
| Loader 共享约定 | docs/infrastructure-shared.md | 热重载、FileLoader、批加载 |
| 基类契约 | docs/base-classes.md | plugin/HttpApi/AiWorkflow/ConfigBase/Event |
| 配置种子 | src/infrastructure/config/config-seed.js | 端口配置模板复制 |
| 运行时挂载 | #utils/runtime-globals.js | setRuntimeGlobal / getRuntimeGlobal |
# 别名#utils/*、#infrastructure/*、#factory/*、#config/*、#data/*、#core/*、#renderers/*、#modules/*。业务用裸名 msgSegment、AgentRuntime（勿 global.）；Core 业务用裸名，框架内可 import { msgSegment } from '#utils/msg-segment.js'。
core/；改 src/ 仅限基类/加载器/工具。RuntimeUtil.makeLog；HTTP 响应：HttpResponse（#utils/http-utils.js）；错误：#utils/error-handler.js + normalizeError。runtimeConfig.aiWorkflow → data/server_bots/{port}/ai-workflow.yaml（非 server_bots 根目录）。xrk-node-runtime；禁止在 Core 中引入 node-fetch、promisify(exec)、instanceof Error 判错等旧写法。exec-async.js、normalize-error.js、proxy-utils.js，勿在 Core 重复封装。