SFC Chart 技能

概述

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

文件输出规则

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

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

核心功能

图表类型

使用方法

命令行调用

# 市场指数图
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

自动触发规则（重要）

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

触发关键词总结: 图、图表、走势图、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>

请求参数

响应格式

{
  "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"...}"

❌ 只生成图片，没有数据：
（仅图片链接，无行情数据表格）

📋 输出规范总结

使用场景

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

错误处理

与其他模块的区别

最佳实践

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

自动触发规则（重要）

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

输出流程：
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/

版本历史