SuperAPI AI 工具集

xrk-config

通用与其它

查看项目

更新于 11-05 17:20

技能介绍

xrk-config 是 xrkseek/xrk-agt 项目中的配置维护技能,面向需要改动或排查配置体系的场景。

用途与职责边界:当需要新增或调整配置字段、确保 YAML 默认模板、commonconfig schema 与代码实际消费保持一致,或需要解释配置路径规则时使用。它不替代其他子系统的实现说明,也不应在缺少证据时臆造路径或字段。

权威文档与实现位置:配置基类文档位于 docs/config-base.md;SystemConfig 位于 core/system-Core/commonconfig/system.js;各配置 schema 位于 core/system-Core/commonconfig/*.js;配置路径规则的核心常量位于 src/infrastructure/config/config-constants.js。项目概览见 PROJECT_OVERVIEW.md,代码入口为 src/ 与 core/ 下对应子目录。

配置路径规则:全局配置存放于 data/server_bots/<name>.yaml,示例包括 agt、device、monitor、notice、mongodb、redis;随端口配置存放于 data/server_bots/{port}/<name>.yaml,示例包括 server、chatbot、group、aistream;工厂 LLM 配置同样存放于 data/server_bots/{port}/<name>.yaml,示例包括 openai_llm、volcengine_llm、gemini_compat_llm 等,具体见 FACTORY_CONFIG_PATTERNS。默认模板位于 config/default_config/<name>.yaml,Cfg 在文件缺失时会自动复制到目标路径。

Schema 来源分为三类:独立文件形式为 core/system-Core/commonconfig/<name>.js,与 YAML 同名,例如 openai_llm.js;聚合在 system.js 中的包括 agt、server、chatbot、device、group、notice、redis、mongodb、monitor、aistream 等,无单独 commonconfig 文件;仅代码侧存在的如 tools.js,无对应默认 YAML。

变更清单:做配置相关改动时必须检查默认模板字段是否完整;schema 字段是否与 YAML 1:1 对应并具备合理默认值与枚举;客户端或工厂代码是否真正消费这些字段,避免写了 schema 却未被使用;若 system-Core 的 .gitignore 采用白名单机制,新增 commonconfig 文件需加入白名单。

aistream 专项:运行时配置为 data/server_bots/{port}/aistream.yaml,对应 cfg.aistream,模板为 config/default_config/aistream.yaml。常见段落包括 embedding、mcp、agentWorkspace、tools,其中 file 对应 ToolsStream、web.fetch 对应 WebStream、agentBrowser 对应 BrowserStream;desktop 工作流工具在 desktop.js 内实现,不存在 tools.desktop 的 YAML 配置。

使用方式:先确认需求属于该技能职责边界,再给出代码路径、配置路径与关键字段,最后补充风险点、验证步骤与回归范围。同时注意文档与代码冲突时以代码为准。

适用场景:需要定位子系统实现路径与配置入口,或快速给出改动落点与兼容性注意事项。常见陷阱是只给概念不给具体文件路径,或忽略配置、schema 与消费代码的一致性。