القائمة
当用户或 Agent 需要通过同花顺金融数据服务获取、查询、同步、分析或导出 A 股行情、财报、指数、板块、公募基金、特色数据或本地 DuckDB 数据，或需要选择、安装、配置、诊断 REST API、MCP、hithink-finance CLI、Python SDK/marketdb 时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
用于 Agent 通过 hithink-finance CLI 查询基金档案、持仓、净值、区间收益、持有人结构、ETF/LOF 快照和 ETF 历史；A 股行情转 hithink-finance-market，基金代码搜索转 hithink-finance-symbol。
用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。
用于 Agent 通过 hithink-finance CLI 处理标的目录、股票/指数代码搜索、名称或 ticker 到 thscode 的消歧、A 股或指数代码表分页导出；行情价格转 hithink-finance-market，指数成分转 hithink-finance-index。
用于 Agent 通过 hithink-finance CLI 管理本地 DuckDB：初始化、同步、状态、校验、迁移、修复、清理、删除、只读 SQL、导出；远端实时数据转对应业务 skill。
用于 Agent 通过 hithink-finance CLI 查询 A 股利润表、资产负债表、现金流量表、财务指标、年度/季度报告窗口；价格行情转 hithink-finance-market，指数财务不在本 skill 范围。
用于 Agent 通过 hithink-finance CLI 查询同花顺指数/概念/行业/地域/特色指数目录、指数成分股、指数快照和指数历史；个股行情转 hithink-finance-market，股票代码搜索转 hithink-finance-symbol。
| name | hithink-finance |
| description | 当用户或 Agent 需要通过同花顺金融数据服务获取、查询、同步、分析或导出 A 股行情、财报、指数、板块、公募基金、特色数据或本地 DuckDB 数据，或需要选择、安装、配置、诊断 REST API、MCP、hithink-finance CLI、Python SDK/marketdb 时使用。 |
这是“同花顺金融数据服务”的统一 Agent 入口和主路由。它负责识别需求、探测当前能力、处理配置边界并选择接入方式；选定方式后只读取对应的一级入口，由该入口继续按需披露详细契约。
允许用户使用自然语言开始，不要求用户先理解命令、接口、thscode 或复权参数。例如：
先把自然语言转换为明确的数据任务，再按当前环境选择接入方式。不要把命令选择、代码后缀或参数枚举转嫁给用户。
| 用户意图 | 任务类别 | 处理重点 |
|---|---|---|
| 股票名称、简称、代码或资产类别确认 | 标的消歧 | 转换为唯一 thscode 后再取数 |
| 最新价格、历史行情、公司行动、复权 | 行情 | 明确时间窗口与复权口径 |
| 利润表、资产负债表、现金流、财务指标 | 财务 | 明确报告期与频率 |
| 指数、概念板块、行业板块、成分股 | 指数与板块 | 区分股票、标准指数和 .TI 板块 |
| 基金资料、净值、收益、持仓、持有人、ETF/LOF 行情 | 公募基金 | 先区分 fund-otc/fund-etf/fund-lof/fund-reits 与能力边界 |
| 涨停、连板、异动、热榜、龙虎榜 | 特色数据 | 先确认是否为 today-only 能力 |
| 全市场数据、本地库、SQL、同步、导出 | 数据管理 | 检查数据新鲜度并让大结果落盘 |
HITHINK_FINANCE_API_KEY，再检查用户级 credentials.env，只报告来源和存在状态，不显示值。hithink-finance-a-share、hithink-finance-a-share-index 或 hithink-finance-meta MCP。hithink-finance；存在时读取 hithink-finance --version，不要先升级。marketdb，或是否明确要求 Python。| 场景 | 首选 | 一级入口 |
|---|---|---|
| 人类终端、Agent 执行、自动化、远端与本地数据一体化 | CLI | cli.md |
| Chat/IDE 会话已连接托管服务 | MCP | mcp.md |
| 零依赖 HTTP、自定义脚本、服务端集成 | REST API | api.md |
| Python、Notebook、研究流程或已有 marketdb | Python SDK | python-sdk.md |
CLI 高度封装远端取数、本地 DuckDB、结构化输出和大结果落盘，对人类与 Agent 都友好。MCP 最适合 Chat 场景。REST API 可塑性最高。Python SDK 适合二次开发和研究。
所有远端方式共用在 https://fuyao.aicubes.cn/admin 获取的 API Key。
统一凭据不要求安装 CLI。每次 Skill 被触发时按以下顺序检查，找到后直接复用，不再提示用户配置：
HITHINK_FINANCE_API_KEY。credentials.env：Windows %APPDATA%\hithink-finance\credentials.env，macOS ~/Library/Application Support/hithink-finance/credentials.env，Linux ${XDG_CONFIG_HOME:-~/.config}/hithink-finance/credentials.env。FUYAO_TOKEN、API_KEY 或已有 CLI 系统凭据；旧名称不再用于新配置。全部缺失时，根据当前平台给出 CLI 安装与配置入口 中的全局环境变量指引，并使用以下说明：
请先前往 https://fuyao.aicubes.cn/admin 注册并获取统一 API Key。获取后，可以按照下面的命令配置当前用户的全局环境变量；也可以直接发给我，我来为你完成配置。API Key 属于敏感凭据，聊天平台可能保留消息记录，因此更推荐使用隐藏输入或环境变量方式。
HITHINK_FINANCE_API_KEY 插值；REST/Python 读取统一凭据来源。--api-key-stdin 安全登录；已有 CLI 凭据需要同步时使用 --replace，不先 logout。SKILL.md）。hithink-finance skills status --format json 只提供包内 canonical 来源，不能证明当前 Agent 已发现或加载这些 Skills。hithink-finance skills sync --format json 并对同一目录复查。该命令可能不认识所有 Agent 工具；仍缺失且已知当前 Agent 的可写 Skills 目录时，Agent 必须从 canonical 主动复制缺失的完整 Skill 目录，再复查并在需要时新建会话重新发现。只复制官方的缺失目录，不覆盖无关 Skills，不把包内来源复制到项目目录或未知 Agent 目录；路径未知或无写入权限时，报告该唯一阻塞项。data init 的远端全量下载、导入和复权重建是长任务，必须以前台、可等待全部子进程的方式执行，并把执行宿主超时设为不少于 15 分钟。只有退出码为 0 且结构化信封 ok=true 才能开始下一条同库命令；超时或非 0 退出不等于已完成。先检查是否仍有存活 PID 持有该 DB；存在时等待它退出，不得在该 DB 上继续执行，也不得删除仍被存活 PID 持有的锁。用户明确要求中止时，才先说明影响并终止对应进程。thscode。用户给名称、简称、不完整代码或不确定资产类别时，先搜索并消歧为唯一 thscode；只有多个可信候选会改变结果时才请用户确认，不要猜 .SH、.SZ、.BJ 或指数类型。thscode 时，用一句话说明它是带交易所或指数后缀的唯一证券代码；后续不重复科普。forward，即前复权）并在结果中明示；用户要求原始成交价格时使用 none。口径会显著影响结论且用户意图仍不明确时，简要解释“前复权保持当前价格、后复权保持起始价格、none 保留原始价格”，再做一次确认。code=0；CLI 的成功条件是退出码 0 且 JSON 结构化信封 ok=true。失败时按固定顺序向用户报告：失败阶段、原始错误摘要、是否重试及原因、唯一的下一步动作、尚未完成的验证。不要只返回错误码或泛化为“服务不可用”。
4001 或 5xxx：只做有界退避重试；仍失败时报告尝试次数和最后错误。thscode；正确：先用名称或代码搜索并消歧。auth login --api-key-stdin --replace，不先 logout。