- name
- hq
- description
- 查询股票、基金、期货、指数实时行情。支持 A 股、港股、美股、基金、期货主力合约及大盘指数。
# 实时行情查询技能
本技能提供全球主要市场的实时行情查询。Agent 需负责将自然语言转换为标准代码并调用脚本。
## 🔄 核心工作流 (Workflow)
当用户请求查询行情时,请严格遵循以下步骤:
### 1. 意图识别与实体提取
- 识别用户意图是否为“查询行情”。
- 提取标的名称(如“同仁堂”、“腾讯”、“苹果”)或直接提取代码(如“600085”)。
### 2. 代码转换 (关键步骤)
**脚本仅接受标准代码,不接受中文名称。你必须利用自身知识库或联网搜索将名称转换为代码。**
*示例*:
- 用户输入:“同仁堂行情”
- 你的动作:检索知识库或联网搜索 → 确认代码为 `600085` → 准备调用脚本。
- *若无法确定代码,请自动联网搜索该标的的准确代码,不要反问用户。*
**代码格式要求**:
- **A 股/基金**:6 位数字(如 `600085`, `510300`)。
- **港股**:5 位数字(如 `00700`)。
- **美股**:英文代码(小写,如 `aapl`)。
- **期货**:品种代码 + `0`(如 `AU0`、`AP0`、`MA0`)。
- **指数**:带交易所前缀(如 `sh000001` 上证指数,`sz399001` 深证成指,`sz399006` 创业板指)。
### 3. 调用工具
使用转换后的代码执行命令:
```bash
node <skill-dir>/scripts/dist/hq.mjs 600085 aapl 00700 AU0
```
### 4. 输出与渲染
- 脚本输出 JSON 格式的行情数据(分为 stock / fund / futures / index 四类),**不包含任何渲染**。
- **你必须读取 JSON 数据,自行渲染为 Markdown 表格展示给用户**,涨跌用 🔴涨 🟢跌 标记,表格格式见「输出格式说明」章节。
- 表格末尾添加引导语:
```
---
💡 回复 **行情工具** 查看外盘期货行情、期货手续费查询、指标公式
```
---
## 🌐 行情工具(独立功能)
行情工具包含三个页面,通过 Vite dev server 代理解决 CORS 问题:
- 📈 **外盘期货行情** — 伦敦金、布伦特原油、COMEX 黄金等 29 个外盘品种实时行情
- 💰 **期货手续费查询** — 郑商所/大商所/上期所/上能所/中金所 保证金和手续费
- 📊 **指标公式** — 付费指标展示
### 触发条件
仅当用户明确表达"行情工具"意图时触发,如回复:
- `行情工具`
- `打开行情工具`
- `外盘期货`
- `期货手续费`
- `指标公式`
语义匹配,不区分大小写。
### 启动步骤
1. 检查端口 5168 是否已有服务在运行:
- 请求 `http://localhost:5168/chart-line.svg`
- 返回 200 → 跳过启动
- 请求失败 → 执行下一步
2. 后台启动 Vite dev server(确保技能执行结束后仍然存活):
```bash
cd <skill-dir>
npx -y vite@8.0.0 --config vite.config.mjs --port 5168
```
等待约 5-8 秒
3. 依次输出以下三个页面链接:
- 📈 [外盘期货行情](http://localhost:5168/hf.html)
- 💰 [期货手续费查询](http://localhost:5168/futures_fee.html)
- 📊 [指标公式](http://localhost:5168/indicator.html)
**说明**:
- `vite.config.mjs` 已内置在技能目录中,包含 API 代理配置
---
## 📋 代码输入规范参考
脚本内部会自动处理交易所前缀(如 `sh`/`sz`/`bj`/`gb_`/`nf_`),**Agent 只需传入核心代码**。
| 市场 | 代码格式 | 示例 | 映射逻辑 (Agent 需掌握) |
|------|----------|------|------------------------|
| **A 股** | 6 位数字 | `600085` | 同仁堂 |
| **港股** | 5 位数字 | `00700` | 腾讯 |
| **美股** | 英文小写 | `aapl` | 苹果 |
| **基金** | 6 位数字 | `510300` | 沪深 300ETF |
| **期货** | 品种代码+`0` | `AU0` | 黄金主力 |
| **指数** | 交易所前缀+代码 | `sh000001` | 上证指数 |
---
## 📊 输出格式说明
### JSON 数据结构
脚本输出为 JSON 数组,每组包含 type / label / data 三个字段:
```json
[
{
"type": "stock",
"label": "📈 股票行情",
"data": [
{ "code": "600085", "name": "同仁堂", "price": "25.10", "change": "+0.50", "changePercent": "+2.03%", "high": "25.20", "low": "24.80" }
]
},
{
"type": "fund",
"label": "💰 基金行情",
"data": [
{ "code": "510300", "name": "沪深300ETF", "price": "3.85", "change": "-0.02", "changePercent": "-0.51%", "high": "3.88", "low": "3.84" }
]
},
{
"type": "futures",
"label": "📦 期货主力行情",
"data": [
{ "code": "AU0", "name": "黄金", "price": "480.50", "change": "+5.20", "changePercent": "+1.09%", "high": "482.00", "low": "475.00" }
]
},
{
"type": "index",
"label": "📊 指数行情",
"data": [
{ "code": "SH000001", "name": "上证指数", "price": "3200.50", "change": "+15.20", "changePercent": "+0.48%", "high": "3210.00", "low": "3185.00" }
]
}
]
```
### 渲染规则
读取每组 `data` 后,你必须按资产类别**分别**渲染为独立的 Markdown 表格,每类使用对应的 `label` 作为标题:
```
📈 股票行情
| 编码 | 名称 | 当前价 | 涨跌 | 涨跌幅 | 最高 | 最低 |
|------|------|--------|------|--------|------|------|
| 600085 | 同仁堂 | 25.10 | 🔴 +0.50 | 🔴 +2.03% | 25.20 | 24.80 |
💰 基金行情
| 编码 | 名称 | 当前价 | 涨跌 | 涨跌幅 | 最高 | 最低 |
|------|------|--------|------|--------|------|------|
| 510300 | 沪深300ETF | 3.85 | 🟢 -0.02 | 🟢 -0.51% | 3.88 | 3.84 |
📦 期货主力行情
| 编码 | 名称 | 当前价 | 涨跌 | 涨跌幅 | 最高 | 最低 |
|------|------|--------|------|--------|------|------|
| AU0 | 黄金 | 480.50 | 🔴 +5.20 | 🔴 +1.09% | 482.00 | 475.00 |
📊 指数行情
| 编码 | 名称 | 当前价 | 涨跌 | 涨跌幅 | 最高 | 最低 |
|------|------|--------|------|--------|------|------|
| SH000001 | 上证指数 | 3200.50 | 🔴 +15.20 | 🔴 +0.48% | 3210.00 | 3185.00 |
```
- `change` 以 `+` 开头 → 🔴(涨)
- `change` 以 `-` 开头 → 🟢(跌)
- 每组**单独一个表格**,不可合并到同一个表格中
表格渲染完毕后,末尾添加引导语:
```
---
💡 回复 **行情工具** 查看外盘期货行情、期货手续费查询、指标公式
```
Voir sur GitHub