SuperAPI AI 工具集

vtable-skill

编程与开发

查看项目

更新于 10-19 18:59

技能介绍

VTable Skill 是一个面向 @visactor/vtable 的开发助手技能,以宿主 Agent 的模型驱动,帮助用户完成 VTable 表格组件的创建、配置、改造和排错。

【用途与定位】 该技能的角色是 VTable 开发助手,基于 @visactor/vtable 提供高性能表格组件开发支持。它熟悉三种核心表格类型:ListTable、PivotTable、PivotChart,覆盖全部 13 种单元格类型、样式与主题系统、自定义渲染、事件系统和完整 API。当用户询问能力范围时,助手可用第一人称简要说明可帮助创建与配置表格、构建单元格、配置样式主题与自定义渲染、实现交互、诊断修复问题以及生成可运行 TypeScript 示例,并推荐官方入门文档 https://www.visactor.io/vtable/guide/Getting_Started/Getting_Started。

【主要能力】

  1. 表格创建与配置:帮助初始化 ListTable、PivotTable、PivotChart,处理 columns 列配置、透视表行列维度与指标、数据绑定 records/dataSource、聚合规则 aggregationRules 等。
  2. 单元格类型:支持 text、link、image、chart 等 13 种单元格类型,按 cellType 与 ColumnDefine 结构组织。
  3. 样式与主题:支持静态值和回调函数两种样式形式,可配置 DARK、ARCO 等主题。
  4. 自定义渲染与布局:customRender 用于低级自定义渲染,customLayout/JSX 优先推荐用于自定义布局。
  5. 交互与事件:支持选择、hover、编辑、排序、拖拽、滚动等交互配置,以及 tableInstance.on('event_name', handler) 事件监听。
  6. 问题诊断:针对表格不显示、性能、事件、内存泄漏等问题进行诊断与修复建议。
  7. 代码与演示生成:生成 TypeScript 示例,并通过脚本输出可运行 HTML。

【使用方式】 运行环境为 Python 3.9+,生成脚本仅使用标准库;脚本路径相对于技能安装目录,数据和输出路径相对于命令工作目录。使用示例中的路径需替换为实际安装目录。生成或编辑场景调用 scripts/generate_demo_html.py,诊断场景调用 scripts/generate_diagnosis_html.py,所有输出必须通过脚本生成 HTML,不允许手写 HTML 或仅输出片段。标准调用示例:python3 scripts/generate_demo_html.py --spec-file ./table-output/spec.js --output-dir ./table-output。从其他工作目录执行时,使用已加载技能的实际路径定位脚本。--output-dir 接受普通文件系统目录,绝对路径直接使用,相对路径相对于命令执行的工作目录;--output 可指定完整文件路径,两者同时传入时以 --output-dir 为准。

【知识查询机制】 技能内置 references/ 知识库,包含 knowledge/(结构化知识文档)、type/(用户可见类型定义)和 examples/(示例代码模式)。根据用户问题先用关键词命中路由表,按顺序加载对应文件,只加载解决当前问题必需的 1-3 个文件;用户需要可运行 demo 或完整配置时,再补充加载最接近的示例。

【代码生成规范】 始终使用 TypeScript,import 来源为 '@visactor/vtable';表格实例化必须指定 container;列定义使用 ColumnsDefine 或 rows/columns/indicators;样式支持静态值与回调函数;事件监听使用 tableInstance.on;销毁表格必须调用 tableInstance.release();透视表数据分析需配置 aggregationRules;动态样式使用 StylePropertyFunctionArg,当前单元格读 arg.dataValue(展示值读 arg.value),需同一行其他字段时用 arg.table.getRecordByRowCol(arg.col, arg.row)?.field。sparkline 仅使用 cellType: 'sparkline' 与 sparklineSpec: { type: 'line', xField: 'month', yField: 'value' },每条 record 的目标字段须为非空点数组,标量、缺失字段或空数组不会渲染迷你图。生成或续改明细表时需读取请求范围内的完整原始记录,不可自行补齐未读取的数据。

【适用场景】 适合需要快速搭建 VTable 表格、配置复杂列与单元格类型、实现透视表分析、定制样式主题、编写自定义渲染与布局、处理交互事件,以及排查表格显示与性能问题的开发场景。也可用于生成可直接运行的 TypeScript 示例和 HTML 演示。

【限制与约束】 生成的 HTML 通过公开 unpkg CDN 加载固定版本图表库和编辑器,需要网络;不需要 VisActor 托管 API、登录或模型 Key,使用宿主 Agent 的模型。不要修改已安装的技能文件,只在用户指定的输出目录写入产物;禁止创建或覆盖 scripts/ 下的脚本文件。输入代码不得包含 import/export,需先移除再写入 spec.js 或 config.js。应避免在同一 container 上重复 new 表格实例而不 release、在样式回调或 customRender 中做重计算、在事件回调中递归触发布局或重绘类 API。关于收费、价格与具体平台支持等未在资料中提供的信息,暂未提供。