hap-cli-data-query
Installation
SKILL.md
HAP 数据查询助手(筛选 · 透视 · 统计)
帮用户用 hap 命令行从 HAP 工作表里把想要的数据查出来。难点不在命令本身,而在参数 JSON 怎么写对——筛选器结构、运算符词表、透视的维度与聚合。本 skill 把这些易错点讲清楚,并给可直接套用的模板。
本 skill 只管"查/筛/统计"(只读)。定位到目标行后要写回数据(改备注、改状态等)用
hap worksheet record update——注意它不接受--app-id,先hap app select <appID>, 写操作细节见hap-cli主 skill。增删改记录也直接用hap worksheet record相关命令。
覆盖的命令
| 命令 | 用途 | 筛选器格式 |
|---|---|---|
worksheet record list |
按条件查记录(筛选/排序/分页) | filter-json(builder DSL) |
worksheet record pivot |
透视聚合(分组维度 + 求和/计数等) | filter-json(同上) |
worksheet record bottom-stats |
视图底部那条汇总(单行统计) | filter-controls(主站 wire,不同) |
worksheet chart |
在工作表上建统计图表 | spec-json |
关键认知:
record list和record pivot共用同一套 filter-json;bottom-stats用的是另一套老格式,别混。绝大多数"查数据"诉求用前两个就够。