Hqchart Helper
Developmenthqchart_helperHqchart Helper is an Agent Skill for development published in the jones2000/HQChart repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
HQChart行情图表插件专用操作技能,用户需要HQChart代码、K线绘图、指标编写、周期切换、自定义图层、分时图、期货/股票合约渲染、数据接口、Canvas绘图、HQChart报错修复时自动触发;调用指令:/hqchart
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/jones2000/HQChart/blob/HEAD/HQChart-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/hqchart-helper, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
一.权威参考约束(最高优先级)
所有K线图创建、配置、绘图逻辑必须参考【K线图创建及SetOption参数详解】 所有日K线历史数据、分钟K线数据、回调入参必须参考【K线图数据格式详解】 所有K线图操作接口函数必须参考【K线图操作接口函数详情】 所有K线图配色、样式、指标参数必须参考【K线图配色和样式参数详解】 所有分时图创建、配置、绘图逻辑必须参考【分时图创建及SetOption参数详解】 所有单日分时图数据、多日分时图数据、回调入参必须参考【分时图数据格式详解】 输出代码、参数说明、数据结构示例、问题排查全部以6份文档为唯一标准,不使用非官方自定义写法。
1.1 权威官方参考文档(AI必须优先查阅)
使用本技能时,必须先读取 references/ 目录下的对应文档:
-
K线图表创建SetOption参数详解:
references/K线图创建及SetOption参数详解.md- 适用场景:创建K线图、配置参数、指标窗口、十字光标、K线样式等
- 包含:Type、Windows、Symbol、KLine、CorssCursorInfo、NetworkFilter 等全部参数说明
-
K线图表数据格式详解:
references/K线图数据格式详解.md- 适用场景:K线图数据对接、NetworkFilter回调、K线数据格式、分时数据格式等
- 包含:K线日线全量数据、实时数据、K线分钟数据、流通股本等数据结构定义
-
K线图操作接口函数详情:
references/K线图操作接口函数详情.md- 适用场景:调用K线图表API、动态修改参数、获取数据、刷新图表等
- 包含:ChangePeriod,ChangeSymbol 等接口函数说明
-
分时图表创建SetOption参数详解:
references/分时图创建及SetOption参数详解.md- 适用场景:创建分时图、配置参数、指标窗口、十字光标、分时样式等
- 包含:Type、Windows、Symbol、MinuteLine、MinuteTitle、CorssCursorInfo、NetworkFilter 等全部参数说明
-
分时图数据格式详解:
references/分时图数据格式详解.md- 适用场景:分时图数据对接、NetworkFilter回调、K线数据格式、分时数据格式等
- 包含:分时图单日数据、多日数据,实时数据、等数据结构定义
1.2 使用规范
1.2.1 初始化方式
原生 JS 方式(CDN引入):
// 注意:原生不要添加 HQChart.Chart. 前缀,这是在npm方式引入才需要
var divKLine = document.getElementById('KLineCtrl');
var chart = JSChart.Init(divKLine, false, true);
NPM 方式(Vue/React工程):
import HQChart from 'hqchart';
import 'hqchart/src/jscommon/umychart.resource/font/drawtool/iconfont.css'; //HQChart插件内部使用的iconfont图标
import 'hqchart/src/jscommon/umychart.resource/css/tools.css' //HQChart插件内置样式
var chart = HQChart.Chart.JSChart.Init(this.$refs.KLineChart);
1.2.2 CDN 引入顺序(必须严格按顺序)
<!-- HQChart插件内置样式和iconfont图标文件 -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/hqchart/src/jscommon/umychart.resource/css/tools.css" />
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/hqchart/src/jscommon/umychart.resource/font/iconfont.css" />
<script src="https://cdn.jsdelivr.net/npm/hqchart/src/jscommon/umychart.resource/js/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/hqchart/src/jscommon/umychart.resource/js/webfont.js"></script>
<!-- HQChart源码地址 -->
<script src="https://cdn.jsdelivr.net/npm/hqchart/src/jscommon/umychart/umychart.min.js"></script>
1.2.3 NPM 安装(Vue/React 工程)
# npm
npm install hqchart --save
# yarn
yarn add hqchart
# pnpm
pnpm add hqchart
1.2.3 数据对接
1.图形数据对接,统一使用'NetworkFilter'回调函数, 2.NetworkFilter挂载位置:option 顶层属性,随 SetOption 一次性传入 3.外部数据通过NetworkFilter中的callback回调函数返回给图表,图表内部根据不同的图表类型,解析不同的数据结构 4.NetworkFilter中根据不同的数据名称,返回不同的数据结构,具体数据结构请参考官方文档:
- K线图数据结构:
references/K线图数据格式详解.md - 分时图数据格式详解:
references/分时图数据格式详解.md
二.常见问题排查
HQChart 加载失败
- 检查 CDN 路径是否正确(使用
cdn.jsdelivr.net/npm/hqchart) - 检查 JS 文件加载顺序(jquery → webfont → umychart.min.js)
- 检查 CSS 文件是否正确引入(tools.css + iconfont.css)
- 确认 DOM 容器设置了
position: relative
图表不显示
- 检查 DOM 容器是否有明确的宽高
- 检查 NetworkFilter 回调是否正确返回数据
- 检查数据格式是否符合官方规范
- 检查
data.PreventDefault = true是否已设置
数据格式错误
- 日期必须是 yyyymmdd 格式的整数(如 20260702)
- 每条 K 线数据至少包含 8 个字段
- 数据必须按日期升序排列
- 成交量、成交金额单位需与官方文档一致
资源说明
references/
包含 HQChart 官方参考文档:
K线图创建及SetOption参数详解.md- K线图创建及SetOption参数详解K线图数据格式详解.md- K线图数据格式详解K线图操作接口函数详情.md- K线图API接口函数说明K线图配色和样式参数详解.md- K线图配色、样式参数说明分时图表创建SetOption参数详解.md-分时图表创建SetOption参数详解分时图数据格式详解.md- 分时图数据格式详解