hithink-tech hithink-finance-market
普通行情和本地行情派生能力。优先使用本地库覆盖的历史/面板能力，必要时走远端同花顺金融数据服务。
前置条件表
| 条件 | 操作 |
|---|---|
| 开始任何 CLI 调用 | 先读取并遵循 hithink-finance-shared |
| 不确定命令是否存在或参数是否变化 | 运行 hithink-finance capabilities --format json，再运行 hithink-finance schema <id> --format json |
| 需要执行下表某个命令 | 先读取对应 reference 文件，不要只凭命令名猜参数 |
| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 --output <path> 落盘；远端 stdout 只返回摘要 |
快速决策
| 用户意图 | 首选命令 / 路由 |
|---|---|
| 单票历史日线/K 线 | market history；--source auto 会在本地覆盖时走本地 |
| 实时或分页行情快照 | market snapshot |
| 集合竞价实时/终态快照 | market auction-snapshot |
| 集合竞价短期基准 | market auction-benchmark |
| 交易日历 | market calendar |
| 复权因子 | market adjustment-factors |
| 公司行动/除权除息事件 | market corporate-actions |
| 全市场区间面板/批量研究输入 | market panel --output <file> |
| 涨跌停池、炸板池、连板、热股、龙虎榜、异动 | 切到 hithink-finance-special-data |
Shortcuts
| 命令 | 何时使用 |
|---|---|
| market adjustment-factors | 查询本地日级复权因子；需要本地库。 |
| market auction-benchmark | Query the short-term auction benchmark; omit date for the Asia/Shanghai current date and read resolved date/date_ms from data |
| market auction-snapshot | Query auction snapshots whose timestamp is the response assembly timestamp |
| market calendar | Query the one-year A-share trading calendar |
| market corporate-actions | Query adjustment events |
| market history | Query daily A-share history |
| market panel | 需要本地库覆盖请求窗口；适合作为研究样本输入。 |
| market snapshot | Query A-share price snapshots |
原生命令与 schema
hithink-finance capabilities --format json
hithink-finance schema <capability-id> --format json
hithink-finance market <command> --help
使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
权限表
| 命令类型 | 要求 |
|---|---|
| 远端服务查询 | API Key 来自系统凭据库、HITHINK_FINANCE_API_KEY 或 --api-key-stdin |
| 本地 DuckDB 查询/导出 | 本地库存在且 schema 兼容；可用全局 --db <path> 指定 |
| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 --yes |
边界声明
- 不提供投资建议、买卖判断或收益承诺；只返回数据或中立统计。
- 全市场、长区间、多标的结果必须落盘，只汇报路径、行数和关键元信息。