| name | hithink-finance-shared |
| description | 用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。 |
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
权限表
| 能力 | 凭据 |
|---|
| 本地 data/db/market panel | 通常不需要 API Key，除非需要同步或初始化远端 dump |
| symbol/market remote/special/financials/index/fund | 需要统一 API Key |
| skills/update/uninstall | 需要本机文件系统权限；不要写全局非 CLI 管理目录 |
边界声明
- 业务取数请求必须切到 symbol、market、special-data、financials、index、fund、data 或 research skill。
- 不要把 API Key 写入命令、配置文件、日志、Markdown、Git 或对话正文；优先 stdin 或系统凭据库。
- 不要把 stderr 更新提示、诊断详情或完整大数据结果当作最终答案原样展开。
