技能介绍

为什么需要自动化的行情图表生成

在分析 A 股或全球宏观走势时，开发者和数据分析师通常要在多个终端间来回切换：查指数点位、看板块涨跌分布、拉个股分时图，再把关键数据手动贴进报告。这种重复的取图、截图和排版工作不仅耗时，而且容易因数据源不统一导致前后口径出现偏差。

@user_05c9e4fb/sfc-chart 就是为了解决这个具体痛点。它把南方财经（SFC）的行情图表能力封装成一个可直接被 Agent 调用的技能，让你在自然语言对话中就能拿到标准化的行情图片与配套数据。

技能如何工作

该技能底层封装了 POST /terminal/rest/common/runWidgets 接口。它支持 7 种常见 Widget：

大盘视图：市场指数走势（WidgetType=1）、涨跌分布（WidgetType=2）、板块涨跌幅榜（WidgetType=3）、当日涨幅榜（WidgetType=6）、全球指数（WidgetType=7）
个股视图：当日分时图（WidgetType=4）和 K 线图（WidgetType=5）

调用时只需在 Agent 对话里提到“图”、“图表”或具体的“XX 分时图”、“板块排行榜”等关键词，技能会依据内置的自动触发规则匹配对应函数。对于个股类型，需传入股票代码 code、chartType（minute 或 kline）以及周期 period 参数。

生成的图片会保存在本地 ~/.openclaw/workspace/nancai/ 目录下，同时返回一个可直接访问的 COS 图片链接。按规范输出时，Agent 会直接给出 file:/// 本地路径和远程查看链接，并附带一个关键行情数据表（价格、涨跌幅、成交量等），而不是把图片硬塞进 Markdown 渲染。

适用边界与注意点

凭证要求：该技能与 sfc-data 其他模块共用 token，建议通过环境变量 SFC_TOKEN 注入，优先级高于 config.json 中的 api_key。Token 缺失会直接导致请求失败。
触发依赖关键词：自动触发规则高度依赖“图”、“排行榜”、“走势图”等词汇。如果用户意图不够明确（例如只说“看看今天怎么样”），Agent 可能不会自动拉起该技能，需要显式提到图表类型。
输出格式约定：当前版本（v1.1）明确不使用 ![]() 语法嵌入图片，而是通过路径和链接文本呈现，并鼓励附上数据表。如果你希望把图片直接嵌进 IM 或网页里，需要自行处理链接拼接。
仅覆盖行情图片：它不提供原始行情数据的文本查询（那是 sfc-quote 的职责），也不做资讯和公告抓取。如果你需要的是结构化 JSON 数据而不是可视化图片，应该选择其他模块。