中文 EN

AI Skills 接入

ChartKit AI Skills 接入

ChartKit Skill 是给 AI 助手使用的图表库知识包，包含 Line、Column、Pie、Scatter、Financial 图表的接入流程、数据结构、主题、图例、tooltip、动画和数据刷新规则。它适合让 AI 根据业务数据类型选择图表并生成 Qt 代码。

下载

目录结构

uigears-chartkit/
  SKILL.md
  agents/openai.yaml
  references/
    integration.md
    api-reference.md

适合的 AI 任务

  • 根据业务指标选择 Line、Column、Pie、Scatter 或 Financial 图表。
  • 生成 ChartKit 控件创建、数据填充和主题设置代码。
  • 编写多序列折线图、柱状图、环形饼图、散点图示例。
  • 排查图表空白、数据长度不匹配、tooltip 不显示、动画不重播等问题。
  • 将业务数据结构映射到 ChartKit 的 series 或 slice 数据结构。

接入步骤

  1. 下载并解压 qt-ui-uigears-chartkit-skill.zip。
  2. 将 uigears-chartkit 放到 AI 工具可读取的 skills 目录。
  3. 需求中明确说明数据类型和目标图表，例如“用 ChartKit 生成一个月度订单折线图”。
  4. 新项目接入时先让 AI 读取 references/integration.md。
  5. 需要具体图表 API 时让 AI 读取 references/api-reference.md。

示例提示词

使用 uigears-chartkit skill，根据订单月度数据生成一个 UIGQLineChart 示例，开启 tooltip、图例和动画。
使用 uigears-chartkit skill，把这些分类统计数据改成 UIGQBarChart，并说明 setCategories 和 setSeries 的对应关系。

生成代码时的约束

  • 当前产品包含 Line、Column/Bar、Pie、Scatter 和 Financial 图表。
  • 图表是 Qt 控件，可放入 Qt layout 或 WidgetKit 容器。
  • 通过公开的 setSeries(...)、setSlices(...)、setThemePreset(...) 等接口更新数据和外观。
  • 不要访问图表内部渲染对象。
  • 数据刷新后需要重播动画时调用 restartAnimation()。