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。
配置优先级:
- 环境变量
SFC_TOKEN(最高优先级) - 配置文件
config.json中的api_key
接口说明
基础信息
- 接口地址:
https://terminal.sfccn.com/terminal/rest/common/runWidgets - 请求方式:
POST - 请求头:
Content-Type: application/jsontoken: <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 图片链接,可直接访问或嵌入展示
输出格式规范(重要)
✅ 标准输出格式
必须使用以下格式,不要使用  语法嵌入图片:
## 📊 今日捷佳伟创分时图已生成:
**本地路径**: [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 图片语法嵌入:

❌ 暴露技术细节:
"我可以使用 sfc-chart 技能帮您生成图片..."
"调用接口:/terminal/rest/common/runWidgets"
"参数:{"widgetType":4,"code":"300724.SZ"...}"
❌ 只生成图片,没有数据:
(仅图片链接,无行情数据表格)
📋 输出规范总结
| 要求 | 说明 |
|------|------|
| ✅ 标题格式 | ## 📊 今日 xxx 图已生成: |
| ✅ 本地路径 | 使用 file:/// 协议,加粗标签 **本地路径**: |
| ✅ 远程链接 | 使用 COS 链接,加粗标签 **查看远程图片**: |
| ✅ 数据表格 | 附上关键行情数据(价格、涨跌幅、成交量等) |
| ❌ 不嵌入图片 | 不使用  语法 |
| ❌ 不暴露技术 | 不展示接口、参数、命令等技术细节 |
| ❌ 不询问用户 | 直接生成,不要问"是否要生成图片" |
使用场景
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.png或CODE_kline_YYYYMMDD_HHMMSS.png
错误处理
| 错误类型 | 处理方式 | |---------|---------| | Token 未配置 | 提示用户配置 API Token | | 接口返回错误 | 显示错误信息,建议重试 | | 图片链接失效 | 提示用户重新生成 | | 股票代码错误 | 提示检查股票代码格式 |
与其他模块的区别
| 模块 | 功能 | 输出形式 | |------|------|---------| | sfc-chart | 生成行情图片 | 图片 (PNG) | | sfc-quote | 查询行情数据 | 文本/表格 | | sfc-news | 查询资讯公告 | 文本 | | sfc-theme | 查询主题数据 | 文本/表格 |
最佳实践
- 图片 + 数据结合: 生成图片的同时提供关键数据摘要(价格、涨跌幅、成交量等)
- 自动触发: 用户请求图片时直接生成,不要询问
- 格式统一: 使用标准输出格式,不使用
语法 - 错误友好: 生成失败时提供清晰的错误提示
- 路径规范: 本地路径使用
file:///协议,远程路径使用 COS 链接 - 数据时效: 注明生成时间和数据来源
自动触发规则(重要)
当用户请求行情图片时,自动使用本技能,无需询问:
| 用户请求 | 自动触发动作 | 图表类型 |
|---------|-------------|---------|
| "生成 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 | 分时图 |
输出流程:
- 调用
query_chart.py生成图片 - 获取本地路径和远程 URL
- 按标准格式输出(标题 + 路径 + 链接)
- 附加行情数据表格(推荐)
- 注明数据来源和生成时间
文件结构
sfc-chart/
├── sfc-chart/
│ ├── SKILL.md # 本文件
│ └── query_chart.py # Python 实现脚本
├── config.json # Token 配置
└── SKILL.md # 主技能说明
生成的图片统一保存在:
~/.openclaw/workspace/nancai/
版本历史
| 版本 | 日期 | 变更 |
|------|------|------|
| v1.1 | 2026-04-16 | 优化输出格式:不使用  语法,改用链接形式;附加行情数据表格 |
| v1.0 | 2026-04-14 | 初始版本,支持 6 种图表类型 |
Scan to join WeChat group