SuperAPI AI 工具集

build-custom-charts

智能体与模型

查看项目

更新于 10-16 05:48

技能介绍

用途:当项目需要超出 nao 内置图表类型(如 bar、line、pie)的可视化时,使用本技能创建或更新自定义 nao 图表模块。

主要能力:在 agent/charts 目录下新增 <type>.js 文件,<type> 需以小写字母开头,之后可含小写字母、数字、连字符或下划线,且不得与内置图表类型或 table 冲突,违规名称会被静默忽略。文件必须导出 render 函数,接收 element 与 context。context 包含:data(引用的 execute_sql 结果行)、config(chartType、xAxisKey、xAxisType、series、title)、colors(nao 默认图表调色板)、theme(light 或 dark)、libs(已安装的 React、ReactDOM、Recharts 模块)。

使用方式:使用纯 JavaScript,不使用 JSX;不要直接 import 裸包名,改用 context.libs 中的库。React 图表必须返回清理函数以卸载其 root。可选添加 agent/charts/<type>.json,含 name 与 description,description 用于告知智能体何时选用该图表;无元数据时 nao 会从文件名推导名称。编辑模块后,活跃的自定义图表会在几秒内重新加载。

适用场景:仅在已认证的交互式网页聊天中渲染自定义图表。

限制:Stories、PNG 导出、自动化、MCP 嵌入和消息渠道均使用内置图表。模块需保持自包含,并视为受信任的项目代码;需为事件监听器、定时器、React root 及其他资源返回清理逻辑。