SQLBot/g2-ssr/AGENTS.md

g2-ssr Agent 说明

定位

无框架 Node.js http 服务，端口 3000。接收后端提交的图表配置，用 @antv/g2-ssr + node-canvas 渲染为 PNG。app.js 是唯一入口；图表实现位于 charts/（bar、column、line、pie、utils）。

修改

• 新增图表类型：新建 charts/<type>.js 导出 get<Xxx>Options，并在 app.js 中注册。
• 请求体、图表配置或输出路径是与 backend 的契约（图表配置在 backend/apps/chat 的会话流程中生成）；变更时两侧一起核对字段一致。
• 依赖变更只改 package.json，package-lock.json 不入库；注意容器构建依赖 canvas 相关系统库。
• Dockerfile 只 COPY app.js、package.json、charts/*、*.ttf 和 supervisord.conf，运行目录 /opt/sqlbot/g2-ssr；新增文件或改路径时核对 COPY 范围。

验证

没有测试框架，至少执行语法检查：

node --check g2-ssr/app.js
node --check g2-ssr/charts/<changed-file.js>