前言¶

在 Cursor、Claude Code 等环境里做 A 股短线或量化相关对话时，常见问题是：模型能讲概念，却缺少统一的「查数—画图—对比」路径。自己拼脚本要处理代码解析、分钟周期写法、指数与个股接口差异；多只股票还要对齐行情字段和走势归一化。SkillHub 上的 同花顺（坐标 @user_6b3ace61/straightflush，当前版本 1.0.0）把能力写进 SKILL.md：底层走 thsdk，由 Agent 按场景选用分钟 K 线、板块成分、盘口大单、竞价异动与批量对比等流程。下面介绍它是什么、能做什么、如何安装与典型触发方式。

这是什么¶

同花顺 是 SkillHub community 来源、分类为 professional（子类「金融分析」）的 Agent Skill，发布者为 user_6b3ace61。页面标签标明 requires_api_key=false，即 Skill 本身不要求单独配置 API Key。

一句话定位：基于 thsdk 的高级股票分析 Skill——把行情、K 线、板块、盘口、大单、竞价、分时及多股对比等操作收敛到同一套调用约定里，并写明何时必须启用本 Skill（见官方简介中的关键词列表）。

官方入口：

• API 页：https://api.skillhub.cn/user_6b3ace61/straightflush
• SkillHub 详情：https://www.skillhub.cn/skills/user_6b3ace61/straightflush

核心功能¶

以下能力与官方简介及 Skill 包内 SKILL.md 一致，按数据类型归纳。

行情与 K 线¶

• 分钟 K 线：周期包括 1m / 5m / 15m / 30m / 60m / 120m（Skill 强调须写 "5m" 等形式，不能写 "5min"）。
• 日 K 及更长周期：day / week / month 等；支持按条数或时间范围拉取，可选前复权等参数。
• 日内分时、历史某日分时：如 intraday_data、min_snapshot。
• 港股、美股、外汇、期货：对应 market_data_hk / market_data_us / market_data_forex / market_data_future 等（以 Skill 场景表为准）。

板块、指数与成分¶

• 主要指数、申万行业、概念板块相关列表与行情。
• 板块成分股、行业排名类需求：通过 ths_industry、ths_concept、market_data_block、block_constituents、market_data_index 等组合完成；指数需用 market_data_index，不能误用个股行情接口。

短线与资金面¶

• 盘口深度：五档及买卖盘详情（如 depth、order_book_bid / order_book_ask）。
• 大单流向：big_order_flow。
• 集合竞价异动：如 call_auction_anomaly("USHA") 等扫描方式。

多股批量分析¶

• 多只股票 表格对比、归一化走势图、相关性热力图；Skill 内提供 examples/03_multi_stock_compare.py 等示例脚本说明批量 search_symbols、market_data_cn 与 klines 的配合方式。

资讯与其它¶

• 资讯 / 快讯：news()。
• 问财 NLP 选股与条件查询：wencai_nlp(...)（示例见 examples/05_wencai_nlp.py）。
• IPO、权息等辅助接口在场景速查表中列出。

Skill 还约定：用户意图模糊时先澄清（例如「分析一下某股」需确认要看实时、分钟 K、日 K 还是多股对比）；意图明确时直接执行。

安装与启用¶

安装分两层：Skill 包（给 Agent 读规则）与 Python 依赖 thsdk（真正取数）。

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 官方安装文档检查或安装 CLI：

command -v skillhub && skillhub --version

未安装时可执行（完整安装或仅 CLI，以 https://skillhub.cn/install/skillhub.md 为准）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装同花顺 Skill¶

搜索确认坐标后安装。官方搜索结果显示的安装命令为：

skillhub search straightflush
skillhub install straightflush --namespace user_6b3ace61 --dir <当前 Agent 的 skills 目录>

--dir 必须指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不被加载。SkillHub 文档中的常见路径包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

安装完成后需按你所用客户端的要求 重新加载或重启 Agent，使新 Skill 生效。

3. 安装 thsdk¶

Skill 包内要求 Python 侧依赖：

pip install --upgrade thsdk

系统要求（来自 Skill 文档）：Python 3.9+；支持 Linux（x86_64 / arm64）、macOS、Windows。连接示例为游客模式，无需在 Skill 层配置账户：

from thsdk import THS

with THS() as ths:
    ...

典型用法¶

启用 Skill 后，用自然语言触发即可；下列表述与官方简介中的 必须使用此 skill 条件一致，Agent 应优先走本 Skill 而非泛化回答。

单股分钟走势

拉一下宁德时代最近一个交易日的 5 分钟 K 线，并标一下成交量异动。

对应能力：klines(code, interval="5m", count=...)，代码需先 search_symbols 得到 THSCODE（如 USZA300033）。

板块与成分

看下申万行业里涨幅靠前的几个行业，并列出其中一个概念板块的成分股行情。

多股对比

对比贵州茅台、五粮液、泸州老窖、山西汾酒近 30 日前复权走势，给表格、归一化图和相关性。

Skill 仓库内 examples/03_multi_stock_compare.py 描述了批量解析、按市场分组查行情与作图的步骤，可作为 Agent 或人工复现的参考。

盘口与竞价

看下某只沪市股票的五档盘口和大单流向；再扫一下集合竞价异动。

跨市场或资讯

查一下某港股代码的实时行情；顺便拉几条相关快讯。

查任何中文名或缩写前，Skill 要求先 search_symbols 解析为完整 THSCODE，并遵守「单条 / 多条 A 股」的选码规则；常用指数代码（如 USHI000001 上证指数）可直接使用。

适用场景与注意¶

适合谁

• 需要在对话里同时看 2 只以上 股票、做 涨幅对比 或 相关性 分析的用户。
• 关注 短线交易、盘中 分钟 K 线、日内走势、盘口、大单、竞价异动 的场景。
• 做 量化研究 或板块轮动，需要行业、概念、成分股与指数行情联动时。
• 话题涉及 港股、美股、外汇、期货、资讯、快讯 且希望走统一 thsdk 接口时。

限制与注意

1. 名称与数据源：Skill 展示名为「同花顺」，实现依赖社区发布的 Skill 文档与 thsdk（PyPI：thsdk），使用前请自行确认数据许可、延迟与合规要求。
2. 网络与环境：取数依赖本机可访问 thsdk 所用服务；沙箱或离线环境需自行验证。
3. 安装路径：skillhub install 务必带 --dir，并与 Cursor / Claude Code / Codex 等实际 skills 目录一致。
4. 接口细节：指数与个股、不同 MarketStr 前缀的接口不可混用；分钟周期字符串格式错误会导致调用失败（见 Skill 内 K 线章节）。
5. 社区 Skill：来源为 community，发布者 user_6b3ace61；SkillHub 页面展示下载量等统计会随时间变化，以详情页为准。

结尾¶

同花顺 Skill 把 thsdk 上的分钟 K 线、板块指数、盘口大单、竞价异动、分时与多股批量对比写进 Agent 可执行的规范里，并明确一批应强制启用该 Skill 的对话关键词。若你已在用 Cursor 或 Claude Code 做 A 股相关分析，可按上文安装 Skill 与 thsdk，从分钟走势或多股对比类问题开始验证。

官方地址：https://api.skillhub.cn/user_6b3ace61/straightflush（SkillHub 页面：https://www.skillhub.cn/skills/user_6b3ace61/straightflush）。