القائمة
用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。
التثبيت باستخدام 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 处理标的目录、股票/指数代码搜索、名称或 ticker 到 thscode 的消歧、A 股或指数代码表分页导出；行情价格转 hithink-finance-market，指数成分转 hithink-finance-index。
当用户或 Agent 需要通过同花顺金融数据服务获取、查询、同步、分析或导出 A 股行情、财报、指数、板块、公募基金、特色数据或本地 DuckDB 数据，或需要选择、安装、配置、诊断 REST API、MCP、hithink-finance CLI、Python SDK/marketdb 时使用。
用于 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-shared |
| description | 用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。 |
共享规则和生命周期入口。只放全局约束、认证、输出、安全、更新和 Skills 管理，不承载业务取数路由。
| 条件 | 操作 |
|---|---|
| 第一次接触此 CLI 或怀疑版本漂移 | 运行 hithink-finance version --format json 和 hithink-finance capabilities --format json |
| 需要机器读取 | 始终加 --format json |
| 结果可能很大 | 使用命令声明的 --output <path> 落盘；远端 stdout 只返回摘要 |
| 需要远端同花顺金融数据服务 | 先确认 auth status 或准备 HITHINK_FINANCE_API_KEY / --api-key-stdin |
| 用户意图 | 首选命令 / 路由 |
|---|---|
| 检查 CLI 是否可用或版本 | hithink-finance version --format json |
| 查看真实能力清单 | hithink-finance capabilities --format json |
| 查看某个命令参数契约 | hithink-finance schema <capability-id> --format json |
| 获取并保存 API Key | 先打开 https://fuyao.aicubes.cn/admin 获取 API Key，再运行 hithink-finance auth login --api-key-stdin --format json；交互终端也可运行 hithink-finance auth login 隐藏输入 |
| 检查认证状态 | hithink-finance auth status --format json |
| 查看非敏感配置 | hithink-finance config show --format json |
| 诊断运行环境 | hithink-finance doctor --format json |
| 同步/修复配套 Skills | hithink-finance skills status --format json 或 hithink-finance skills sync --format json |
| 更新 CLI | hithink-finance update --check --format json 或 hithink-finance update --repair --format json |
| 预览卸载 | hithink-finance uninstall --plan --format json |
| 需要了解 | 读取 |
|---|---|
| JSON 输出、大结果、安全规则 | global-rules.md |
| API Key、profile、配置优先级 | auth-and-config.md |
| version、doctor、update、uninstall | lifecycle.md |
| skills status/sync/remove | skills-management.md |
| 能力 | 凭据 |
|---|---|
| 本地 data/db/market panel | 通常不需要 API Key，除非需要同步或初始化远端 dump |
| symbol/market remote/special/financials/index/fund | 需要统一 API Key |
| skills/update/uninstall | 需要本机文件系统权限；不要写全局非 CLI 管理目录 |
