用途:xrk-renderer 是 xrk-agt 项目内的渲染器技能,面向需要理解、使用或扩展 HTML 模板渲染与截图输出能力的场景,也可服务于让 AI 生成图片报表或可视化的需求。
主要能力:该技能以文档与代码入口组织知识。权威文档为 docs/renderer.md,基类位于 src/infrastructure/renderer/Renderer.js,渲染器目录为 src/renderers/*。Renderer 基类只负责模板读写、缓存和监听(dealTpl),具体截图逻辑由 Puppeteer/Playwright 等具体实现承担。
配置方式:全局配置来源为 agt.browser.renderer(puppeteer/playwright);各渲染器配置位于 data/server_bots/{port}/renderers/{type}/config.yaml,缺省时从 src/renderers/{type}/config_default.yaml 合并。
使用方式:典型用法是在插件中通过 RendererLoader.getRenderer('puppeteer') 获取实例,调用 dealTpl 渲染 HTML,再调用 renderImage 输出图片。
适用场景:需要定位该子系统的实现路径与配置入口;需要快速给出改动落点与兼容性注意事项。
限制:不用于替代其他子系统的实现说明;不在缺少证据时臆造路径或字段。执行时应先确认需求属于该技能职责边界,再给出代码路径、配置路径与关键字段,最后补充风险点、验证步骤与回归范围。文档与代码冲突时以代码为准,并注意配置、Schema 与消费代码的一致性。其他项目概览与代码入口可参考 PROJECT_OVERVIEW.md 及 src/、core/ 对应子目录。