hithink-finance-shared
用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。
git clone --depth 1 https://github.com/HiThink-Tech/Financial-API /tmp/hithink-finance-shared && cp -r /tmp/hithink-finance-shared/hithink-finance-cli/skills/hithink-finance-shared ~/.claude/skills/hithink-finance-sharedSKILL.md
# hithink-finance-shared 共享规则和生命周期入口。只放全局约束、认证、输出、安全、更新和 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` | ## References | 需要了解 | 读取 | | ---------------------------------- | ------------------------------------------------------- | | JSON 输出、大结果、安全规则 | [global-rules.md](references/global-rules.md) | | API Key、profile、配置优先级 | [auth-and-config.md](references/auth-and-config.md) | | version、doctor、update、uninstall | [lifecycle.md](references/lifecycle.md) | | skills status/sync/remove | [skills-management.md](references/skills-management.md) | ## 权限表 | 能力 | 凭据 | | ------------------------------------------------------------ | ------------------------------------------------- | | 本地 data/db/market panel | 通常不需要 API Key，除非需要同步或初始化远端 dump | | symbol/market remote/special/financials/index/fund/valuation | 需要统一 API Key | | skills/update/uninstall | 需要本机文件系统权限；不要写全局非 CLI 管理目录 | ## 边界声明 - 业务取数请求必须切到 symbol、market、special-data、financials、index、fund、valuation、data 或 research skill。 - 不要把 API Key 写入命令、配置文件、日志、Markdown、Git 或对话正文；优先 stdin 或系统凭据库。 - 不要把 stderr 更新提示、诊断详情或完整大数据结果当作最终答案原样展开。
用于 Agent 通过 hithink-finance CLI 管理本地 DuckDB：初始化、同步、状态、校验、迁移、修复、清理、删除、只读 SQL、导出；远端实时数据转对应业务 skill。
用于 Agent 通过 hithink-finance CLI 查询 A 股利润表、资产负债表、现金流量表、财务指标、年度/季度报告窗口；价格行情转 hithink-finance-market，指数财务不在本 skill 范围。
用于 Agent 通过 hithink-finance CLI 查询基金档案、公司、经理、财务、诊断、资讯、募集、持仓、净值、收益、持有人结构、ETF/LOF 快照和 ETF 历史；A 股行情转 hithink-finance-market，基金代码搜索转 hithink-finance-symbol。
用于 Agent 通过 hithink-finance CLI 查询同花顺指数/概念/行业/地域/特色指数目录、指数成分股、指数快照和指数历史；个股行情转 hithink-finance-market，股票代码搜索转 hithink-finance-symbol。
用于 Agent 通过 hithink-finance CLI 获取 A 股集合竞价快照与短期基准、普通行情快照、历史 K 线、交易日历、复权因子、公司行动和本地全市场面板；涨跌停、炸板、热榜、龙虎榜、异动和游资机构榜转 hithink-finance-special-data。
用于 Agent 通过 hithink-finance CLI 基于已有本地数据做中立研究准备、面板导出、只读 SQL、描述性统计和可复现实证数据集；不用于实时取数、荐股、择时、组合建议或投资结论。
用于 Agent 通过 hithink-finance CLI 查询特色数据：涨停池、跌停池、炸板池、连板天梯、个股异动、异动原因、飙升榜、热股榜、热度历史/趋势、龙虎榜、游资和机构榜；普通行情转 hithink-finance-market。
用于 Agent 通过 hithink-finance CLI 处理标的目录、股票/指数代码搜索、名称或 ticker 到 thscode 的消歧、A 股或指数代码表分页导出；行情价格转 hithink-finance-market，指数成分转 hithink-finance-index。