Back to skills
extension
Category: Data & AnalyticsAPI key required

sfc-chart

SFC 行情图片生成技能,生成市场指数图、涨跌分布图、板块排行榜、股票分时图、K 线图、当日涨幅榜、全球指数图等行情图片。自动触发规则:当用户提到"图"、"图表"、"走势图"、"K 线图"、"分时图"、"排行榜"等关键词时自动触发

personAuthor: user_05c9e4fbhubcommunity

SFC Chart 技能

概述

本技能提供南方财经 (SFC) 行情图片生成功能,通过调用 /terminal/rest/common/runWidgets 接口生成各类市场行情图片。

文件输出规则

所有本技能生成的文件统一保存到 ~/.openclaw/workspace/nancai/ 目录下。

文件命名规范:{类型}_{主题}_{日期}.md{类型}_{主题}_{日期}.png

核心功能

图表类型

| WidgetType | 图表名称 | 参数要求 | 用途 | |:----------:|---------|---------|------| | 1 | 市场指数图 | 无 | 展示大盘指数走势 | | 2 | 市场涨跌分布图 | 无 | 展示市场涨跌家数分布 | | 3 | 板块涨跌幅榜图 | 无 | 展示板块涨跌排行 | | 4 | 股票分时图 | code, chartType='minute', period=1 | 展示个股当日分时走势 | | 5 | K 线图 | code, chartType='kline', period=0 | 展示个股 K 线走势 | | 6 | 当日涨幅榜图 | 无 | 展示当日涨幅排行 | | 7 | 全球指数图 | 无 | 展示全球主要指数走势 |

使用方法

命令行调用

# 市场指数图
python skills/sfc-chart/query_chart.py index

# 市场涨跌分布图
python skills/sfc-chart/query_chart.py distribution

# 板块涨跌幅榜图
python skills/sfc-chart/query_chart.py sector

# 股票分时图 (需要股票代码)
python skills/sfc-chart/query_chart.py minute -c 300724

# K 线图 (需要股票代码)
python skills/sfc-chart/query_chart.py kline -c 300724

# 当日涨幅榜图
python skills/sfc-chart/query_chart.py gainers

# 全球指数图 (新增)
python skills/sfc-chart/query_chart.py global

# JSON 格式输出
python skills/sfc-chart/query_chart.py minute -c 300724 --json

Python 代码调用

from query_chart import (
    get_market_index_chart,
    get_market_distribution_chart,
    get_sector_ranking_chart,
    get_stock_minute_chart,
    get_stock_kline_chart,
    get_daily_gainers_chart,
    get_global_index_chart  # 新增:全球指数图
)

# 获取市场指数图
result = get_market_index_chart()
print(result['data'])  # 图片 URL

# 获取捷佳伟创分时图
result = get_stock_minute_chart('300724')
print(result['data'])  # 图片 URL

# 获取捷佳伟创 K 线图
result = get_stock_kline_chart('300724')
print(result['data'])  # 图片 URL

# 获取板块排行榜
result = get_sector_ranking_chart()
print(result['data'])  # 图片 URL

# 获取全球指数图 (新增)
result = get_global_index_chart()
print(result['data'])  # 图片 URL

自动触发规则(重要)

当用户提到"图"、"图表"等关键词时,自动使用本技能,无需询问:

| 用户请求关键词 | 自动触发动作 | 图表类型 | |---------------|-------------|---------| | "市场指数图"、"大盘图"、"指数图"、"上证指数图" | 调用 get_market_index_chart | 市场指数 | | "涨跌分布图"、"市场情绪图"、"涨跌家数" | 调用 get_market_distribution_chart | 涨跌分布 | | "板块排行榜"、"板块图"、"行业排行"、"概念排行" | 调用 get_sector_ranking_chart | 板块排行 | | "XX 分时图"、"XX 走势图"、"XX 今日走势"、"XX 分时" | 调用 get_stock_minute_chart | 分时图 | | "XX K 线图"、"XX 日线"、"XX 周线"、"XX 月线"、"XX 技术图" | 调用 get_stock_kline_chart | K 线图 | | "涨幅榜"、"涨停榜"、"今日涨幅"、"领涨榜" | 调用 get_daily_gainers_chart | 涨幅榜 | | "全球指数图"、"全球市场"、"外围市场"、"海外市场"、"美股图" | 调用 get_global_index_chart | 全球指数 | | "来张图"、"生成图表"、"画个图"、"xx 图"、"xx 图表" | 根据上下文判断类型 | 智能判断 |

触发关键词总结: 图、图表、走势图、K 线图、分时图、排行榜、榜单

重要:

  • 直接生成图片链接并展示,不要询问用户是否要使用技能
  • 当用户提到"图"、"图表"、"走势图"、"K 线图"、"分时图"、"排行榜"等关键词时自动触发
  • 不要暴露技能名称、接口、命令等技术细节

配置

API Token

与 sfc-data 其他模块共用同一个 token,配置文件位于 sfc-chart/config.json

配置优先级:

  1. 环境变量 SFC_TOKEN (最高优先级)
  2. 配置文件 config.json 中的 api_key

接口说明

基础信息

  • 接口地址: https://terminal.sfccn.com/terminal/rest/common/runWidgets
  • 请求方式: POST
  • 请求头:
    • Content-Type: application/json
    • token: <your-token>

请求参数

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | widgetType | int | 是 | 图表类型 (1-6) | | code | string | 条件必填 | 股票代码 (widgetType=4 或 5 时需要) | | chartType | string | 条件必填 | 'minute' 或 'kline' (widgetType=4 或 5 时需要) | | period | int | 条件必填 | 周期参数 (分时图=1, K 线图=0) |

响应格式

{
  "code": 0,
  "msg": "success",
  "data": "https://zixuntong-1301073378.cos.ap-shanghai.myqcloud.com/xxx/xxx.png"
}

data 字段: COS 图片链接,可直接访问或嵌入展示

输出格式规范(重要)

✅ 标准输出格式

必须使用以下格式,不要使用 ![图片](url) 语法嵌入图片:

## 📊 今日捷佳伟创分时图已生成:

**本地路径**: [C:/Users/13293/.openclaw/workspace/skills/sfc-chart/images/300724_SZ_minute_20260416_153751.png](file:///C:/Users/13293/.openclaw/workspace/skills/sfc-chart/images/300724_SZ_minute_20260416_153751.png)

**查看远程图片**: [点击查看](https://zixuntong-1301073378.cos.ap-shanghai.myqcloud.com/hangqing/img/capture-k-chart-minute-300724.SZ-1-1776325072261.png)

✅ 推荐:附加行情数据表格

生成图片后,建议附上关键行情数据:

### 📈 实时行情数据

| 指标 | 数值 | 指标 | 数值 |
|------|------|------|------|
| **当前价** | 110.39 元 | **涨跌额** | +0.20 元 |
| **涨跌幅** | +0.18% | **昨收价** | 110.19 元 |
| **最高价** | 112.29 元 | **最低价** | 108.09 元 |
| **振幅** | 3.82% | **换手率** | 4.63% |
| **成交量** | 13.34 万手 | **成交额** | 14.76 亿元 |

❌ 错误输出示例

不要这样做:

❌ 使用 Markdown 图片语法嵌入:
![捷佳伟创分时图](image_url.png)

❌ 暴露技术细节:
"我可以使用 sfc-chart 技能帮您生成图片..."
"调用接口:/terminal/rest/common/runWidgets"
"参数:{"widgetType":4,"code":"300724.SZ"...}"

❌ 只生成图片,没有数据:
(仅图片链接,无行情数据表格)

📋 输出规范总结

| 要求 | 说明 | |------|------| | ✅ 标题格式 | ## 📊 今日 xxx 图已生成: | | ✅ 本地路径 | 使用 file:/// 协议,加粗标签 **本地路径**: | | ✅ 远程链接 | 使用 COS 链接,加粗标签 **查看远程图片**: | | ✅ 数据表格 | 附上关键行情数据(价格、涨跌幅、成交量等) | | ❌ 不嵌入图片 | 不使用 ![图片](url) 语法 | | ❌ 不暴露技术 | 不展示接口、参数、命令等技术细节 | | ❌ 不询问用户 | 直接生成,不要问"是否要生成图片" |

使用场景

1. 股票走势分析

当用户询问股票走势时,可自动生成分时图或 K 线图辅助说明:

用户:分析一下捷佳伟创今天走势
响应:
1. 查询实时行情数据
2. 生成分时图
3. 结合数据和图片进行分析

2. 市场概览

当用户询问市场整体情况时,可生成市场指数图、涨跌分布图:

用户:今天市场怎么样
响应:
1. 生成市场指数图
2. 生成涨跌分布图
3. 分析市场整体表现

3. 板块/概念分析

当用户询问板块表现时,可生成板块排行榜图片:

用户:今天哪个板块最强
响应:
1. 生成板块涨跌幅榜图
2. 分析领涨板块

4. 全球市场监控(新增)

当用户询问全球市场、外围市场时,可生成全球指数图:

用户:看看全球市场情况 / 外围市场怎么样
响应:
1. 生成全球指数图
2. 分析美股、港股、欧股、亚太市场表现

图片展示方式

完整输出模板

## 📊 今日 xxx 图已生成:

**本地路径**: [路径](file:///路径)

**查看远程图片**: [点击查看](COS 链接)

---

### 📈 实时行情数据(可选但推荐)

| 指标 | 数值 | ... |
|------|------|-----|
| ... | ... | ... |

---

*数据来源:南方财经金融数据终端 | 生成时间:YYYY-MM-DD HH:MM*

图片存储位置

所有生成的图片默认保存在:

~/.openclaw/workspace/nancai/

文件名格式:

  • 市场图表:market_index_YYYYMMDD_HHMMSS.png
  • 个股图表:CODE_minute_YYYYMMDD_HHMMSS.pngCODE_kline_YYYYMMDD_HHMMSS.png

错误处理

| 错误类型 | 处理方式 | |---------|---------| | Token 未配置 | 提示用户配置 API Token | | 接口返回错误 | 显示错误信息,建议重试 | | 图片链接失效 | 提示用户重新生成 | | 股票代码错误 | 提示检查股票代码格式 |

与其他模块的区别

| 模块 | 功能 | 输出形式 | |------|------|---------| | sfc-chart | 生成行情图片 | 图片 (PNG) | | sfc-quote | 查询行情数据 | 文本/表格 | | sfc-news | 查询资讯公告 | 文本 | | sfc-theme | 查询主题数据 | 文本/表格 |

最佳实践

  1. 图片 + 数据结合: 生成图片的同时提供关键数据摘要(价格、涨跌幅、成交量等)
  2. 自动触发: 用户请求图片时直接生成,不要询问
  3. 格式统一: 使用标准输出格式,不使用 ![图片](url) 语法
  4. 错误友好: 生成失败时提供清晰的错误提示
  5. 路径规范: 本地路径使用 file:/// 协议,远程路径使用 COS 链接
  6. 数据时效: 注明生成时间和数据来源

自动触发规则(重要)

当用户请求行情图片时,自动使用本技能,无需询问:

| 用户请求 | 自动触发动作 | 图表类型 | |---------|-------------|---------| | "生成 XX 股票分时图" | 调用 get_stock_minute_chart | 分时图 | | "XX 股票 K 线图" | 调用 get_stock_kline_chart | K 线图 | | "市场指数图" | 调用 get_market_index_chart | 市场指数 | | "涨跌分布图" | 调用 get_market_distribution_chart | 涨跌分布 | | "板块排行榜图片" | 调用 get_sector_ranking_chart | 板块排行 | | "今日涨幅榜" | 调用 get_daily_gainers_chart | 涨幅榜 | | "来张 XX 的走势图" | 根据上下文判断分时/K 线 | 分时/K 线 | | "XX 今日分时" | 调用 get_stock_minute_chart | 分时图 |

输出流程:

  1. 调用 query_chart.py 生成图片
  2. 获取本地路径和远程 URL
  3. 按标准格式输出(标题 + 路径 + 链接)
  4. 附加行情数据表格(推荐)
  5. 注明数据来源和生成时间

文件结构

sfc-chart/
├── sfc-chart/
│   ├── SKILL.md          # 本文件
│   └── query_chart.py    # Python 实现脚本
├── config.json           # Token 配置
└── SKILL.md             # 主技能说明

生成的图片统一保存在:
~/.openclaw/workspace/nancai/

版本历史

| 版本 | 日期 | 变更 | |------|------|------| | v1.1 | 2026-04-16 | 优化输出格式:不使用 ![图片](url) 语法,改用链接形式;附加行情数据表格 | | v1.0 | 2026-04-14 | 初始版本,支持 6 种图表类型 |