HENGSHI CLI
概述
HENGSHI CLI 是 HENGSHI 官方命令行工具，也是面向人类与 AI Agent 的统一命令入口。它把原本分散在界面点击、后台 API、临时脚本里的操作，整理成稳定、可审查、可自动化的命令工作流。
CLI 当前覆盖的核心能力包括：
- 数据连接与数据集接入
- HQL / HE 查询与数据预览
- 仪表盘、报表与元素创建 / 配置
- 权限查询、授权与回收
- 系统配置、环境检查与运维动作
- 与官方 skills 配套的 Agent 执行工作流
NOTE
从 2.0.0 开始，对外命令入口改为 hbi，文档默认使用 hbi 与 HBI_*。迁移兼容保留的是旧配置读取与 EVEREST_* 环境变量识别；重新运行官方安装脚本升级后，同目录遗留的 everest / everest.exe 会被清理，不再承诺旧命令入口继续可用。
作为 HENGSHI SENSE 与 Agent 之间的桥梁
HENGSHI CLI 的角色，不是替代 HENGSHI SENSE 页面，而是把 HENGSHI SENSE 的核心能力转成可稳定调用、审查和复用的命令入口。它既适合人工在终端直接使用，也适合被 OpenClaw 等 Agent、CI 流水线和自动化脚本调用。
在这条链路里，常见分工是：
| 层级 | 角色 | 典型职责 |
|---|---|---|
| 人 | 任务提出者与审核者 | 提要求、确认边界、审结果 |
| Agent / 自动化流程 | 编排层 | 拆步骤、组织顺序、决定下一步调用哪条命令 |
| HENGSHI CLI + skills | 桥梁与执行层 | 把 HENGSHI SENSE 的业务能力转换成结构化命令、输出与 --dry-run 预演 |
| HENGSHI SENSE 服务端 | 业务能力层 | 真正完成连接、查询、建模、授权、发布等动作 |
如果你在为 OpenClaw 或其他 Agent 设计可复用工作流，CLI 通常就是这座桥本身：上接 Agent 的任务编排，下接 HENGSHI SENSE 的真实业务能力，而不是让 Agent 自己去猜页面路径或临时拼 API。
CLI 适合解决什么问题
| 场景 | CLI 带来的价值 |
|---|---|
| 让 Agent 代做 BI 交付动作 | 统一命令与输出格式，避免“每个 Agent 猜一套 API” |
| 把高风险改动放进审批流 | --dry-run 先预演，再决定是否真正执行 |
| 把结果回传给人或其他系统 | json / yaml / table 输出更容易被读取、记录和二次处理 |
| 做批量化、可重复的运维任务 | 单命令、脚本、CI、Agent 都能复用同一条执行路径 |
| 让界面外产生的变更回到前端体验里 | 通过 SSE / Autopilot 指示器补上实时回显链路 |
命令面一览
HENGSHI CLI 不是单一功能命令，而是一整套面向 BI 交付主链路的命令树。
| 命令域 | 说明 | 示例 |
|---|---|---|
app | 应用、空间、门户、公共维度 | hbi app list --area personal-area --root |
dataset | 数据集接入与列表查看 | hbi dataset list --app retail-ops --output json |
data-model | HQL / HE 查询与数据预览 | hbi data-model query --app <id> --dataset <id> "SUM({amount})" |
dashboard | 仪表盘、报表、主题 | hbi dashboard create --app retail-ops "区域销售驾驶舱" |
element | 图表、筛选器、容器、按钮、iframe 等元素 | hbi element chart create --dashboard dsh_2048 --app retail-ops --dataset sales_daily line |
connection | 数据源连接创建与管理 | hbi connection list |
authorize | 统一授权 API | hbi authorize grant app app_42 --user 123:editor --dry-run |
preferences | 系统配置查看与变更预演 | hbi preferences everest --output json |
官方 skills 与 Agent 执行
CLI 会和官方 bundled skills 一起交付。当前常见 skills 分层包括：
hbi-core：认证、配置、输出与术语规则hbi-data：数据连接、数据集、指标与度量工作流hbi-dashboard：仪表盘规划、布局与元素配置hbi-permission：权限查询、授权与回收hbi-workflow：跨领域编排与顺序控制
这些 skills 的作用不是替代 CLI，而是把“什么时候调用哪条命令、应该先读什么、哪些动作必须先 --dry-run”这样的执行经验沉淀成可复用的标准流程。
阅读路径
如果你是第一次接触 HENGSHI CLI，建议按下面顺序阅读：
建议
如果你的目标是让 Agent 稳定执行动作，而不是人工逐条敲命令，优先看 Agent 接入与 skills 与 常用工作流。