定位与分层：docs/底层架构设计.md（架构单一事实源）
启动链：docs/startup.md
目录树：PROJECT_OVERVIEW.md、docs/README.md
Node 26：docs/node-26-runtime.md、skill xrk-node-runtime（写 Core 服务端必读）
Core www：skill xrk-www-compat（浏览器 ≠ Node 26）

定位：融合智能体业务逻辑的通用后端 — Runtime 在 src/，业务在 core/。
分层：AgentRuntime（Runtime）→ 基础设施（Loader/基类）→ Tasker / 事件 → Core 业务。
业务在 core/<名>/(plugin|http|stream|tasker|events|commonconfig|www/<app>)；src/ 仅基础设施与工厂。
启动：见 docs/startup.md（app.js → bootstrap → start.js → agent-runtime.js）。
Node ≥ 26.0（package.json engines）；包管理仅 pnpm。

编码约定见 skill xrk-node-runtime 与 docs/node-26-runtime.md（本 skill 不重复禁止项表）。写 www/ 见 xrk-www-compat。

类型	路径
业务	`core/<core>/` 各子目录
基类/加载器	`src/infrastructure/`
工具	`src/utils/`（`bootstrap.js`、`process-signals.js`、`exec-async.js` 等）
工厂	`src/factory/`
前端	`core/<core>/www/<app>/`
浏览器兼容	`core/system-Core/www/xrk/modules/web-compat.js`

Más de este repositorio

mismo repositorio

当你需要从“应用视角”看 XRK-AGT（启动流程、Web 控制台、前后端协作、典型技术栈组合）时使用。

当你需要开发或排查 HTTP API（core/*/http/*.js）、理解 HttpApi 基类、HttpApiLoader、业务层约定时使用。

编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。浏览器环境 ≠ Node 26。

编写或审查 core/src 代码时的写法与性能规范（全局裸名、状态、I/O、异步、HTTP）。改 Core 前必读。

当你需要快速理解 system-Core 提供哪些 HTTP API/工作流/插件/Tasker/Web 控制台能力，或定位某个模块在哪实现时使用。

当你需要理解 XRK-AGT 的运行时核心（AgentRuntime 主类）、事件总线、HTTP/WS 启动流程与全局对象时使用。

name	xrk-project-overview
description	当需要从整体理解 XRK-AGT 的架构、目录、运行流程和技术栈时使用。

定位与分层：docs/底层架构设计.md（架构单一事实源）
启动链：docs/startup.md
目录树：PROJECT_OVERVIEW.md、docs/README.md
Node 26：docs/node-26-runtime.md、skill xrk-node-runtime（写 Core 服务端必读）
Core www：skill xrk-www-compat（浏览器 ≠ Node 26）

定位：融合智能体业务逻辑的通用后端 — Runtime 在 src/，业务在 core/。
分层：AgentRuntime（Runtime）→ 基础设施（Loader/基类）→ Tasker / 事件 → Core 业务。
业务在 core/<名>/(plugin|http|stream|tasker|events|commonconfig|www/<app>)；src/ 仅基础设施与工厂。
启动：见 docs/startup.md（app.js → bootstrap → start.js → agent-runtime.js）。
Node ≥ 26.0（package.json engines）；包管理仅 pnpm。

编码约定见 skill xrk-node-runtime 与 docs/node-26-runtime.md（本 skill 不重复禁止项表）。写 www/ 见 xrk-www-compat。

类型	路径
业务	`core/<core>/` 各子目录
基类/加载器	`src/infrastructure/`
工具	`src/utils/`（`bootstrap.js`、`process-signals.js`、`exec-async.js` 等）
工厂	`src/factory/`
前端	`core/<core>/www/<app>/`
浏览器兼容	`core/system-Core/www/xrk/modules/web-compat.js`