菜单
用于 Agent 通过 hithink-finance CLI 管理本地 DuckDB：初始化、同步、状态、校验、迁移、修复、清理、删除、只读 SQL、导出；远端实时数据转对应业务 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | hithink-finance-data |
| description | 用于 Agent 通过 hithink-finance CLI 管理本地 DuckDB：初始化、同步、状态、校验、迁移、修复、清理、删除、只读 SQL、导出；远端实时数据转对应业务 skill。 |
本地数据生命周期和 SQL 入口。负责让数据可用、可校验、可导出，而不是解释所有研究结论。
| 条件 | 操作 |
|---|---|
| 开始任何 CLI 调用 | 先读取并遵循 hithink-finance-shared |
| 不确定命令是否存在或参数是否变化 | 运行 hithink-finance capabilities --format json，再运行 hithink-finance schema <id> --format json |
| 需要执行下表某个命令 | 先读取对应 reference 文件，不要只凭命令名猜参数 |
| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 --output <path> 落盘；远端 stdout 只返回摘要 |
| 用户意图 | 首选命令 / 路由 |
|---|---|
| 首次建库或从 dump 导入 | data init |
| 增量/重新同步本地数据 | data sync |
| 查看库路径和 schema | data status |
| 质量校验 | data validate |
| 迁移计划或应用 | data migrate |
| 重建复权等派生数据 | data repair |
| 清理下载缓存 | data clean |
| 删除本地库 | data remove --plan 先预览 |
| 查看表/视图 | db describe |
| 只读 SQL 查询 | db query --sql <sql> |
| 大结果导出 | db export --sql <sql> --output <file> |
| 命令 | 何时使用 |
|---|---|
| data clean | 只清理 CLI 管理的下载缓存，不删除数据库。 |
| data init | 远端初始化需要 API Key；执行前先运行 hithink-finance auth status --format json，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 hithink-finance auth login。 |
| data migrate | 默认只输出迁移计划；应用迁移前让用户确认。 |
| data remove | 高风险操作；先运行 --plan 报告路径和大小。 |
| data repair | 用于重建派生复权因子等本地派生数据。 |
| data status | 本地库不存在时用于确认默认路径和 schema 状态。 |
| data sync | 需要 API Key；执行前先运行 hithink-finance auth status --format json，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 hithink-finance auth login。 |
| data validate | 用于同步、迁移、研究导出前的质量门禁。 |
| db describe | 查询本地 DuckDB 表和视图清单。 |
| db export | 用于大结果或下游 pandas/notebook 消费。 |
| db query | 只读 SQL；小结果才可直接读取 JSON。 |
hithink-finance capabilities --format json
hithink-finance schema <capability-id> --format json
hithink-finance data <command> --help
hithink-finance db <command> --help
使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
| 命令类型 | 要求 |
|---|---|
| 远端服务查询 | API Key 来自系统凭据库、HITHINK_FINANCE_API_KEY 或 --api-key-stdin |
| 本地 DuckDB 查询/导出 | 本地库存在且 schema 兼容；可用全局 --db <path> 指定 |
| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 --yes |
db query。--yes。db export --output <file>，不要回显全表。用于 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 需要通过同花顺金融数据服务获取、查询、同步、分析或导出 A 股行情、财报、指数、板块、公募基金、特色数据或本地 DuckDB 数据，或需要选择、安装、配置、诊断 REST API、MCP、hithink-finance CLI、Python SDK/marketdb 时使用。
用于 Agent 通过 hithink-finance CLI 查询 A 股利润表、资产负债表、现金流量表、财务指标、年度/季度报告窗口；价格行情转 hithink-finance-market，指数财务不在本 skill 范围。
用于 Agent 通过 hithink-finance CLI 查询同花顺指数/概念/行业/地域/特色指数目录、指数成分股、指数快照和指数历史；个股行情转 hithink-finance-market，股票代码搜索转 hithink-finance-symbol。