用途：hap-cli（命令 hap）把 HAP 企业平台的后端能力封装成命令行，覆盖通讯录与部门、聊天消息与群组、动态、日程、工作表记录读写、视图与字段、工作流与审批待办、自定义页面、角色权限、组织与应用管理、文件上传与分享。
安装与登录：先确认是否已安装，运行 hap --version；若提示 command not found，则执行 pip install hap-cli，装完再次确认版本。若 pip 安装成功但仍找不到 hap，说明它被装进了不在 PATH 上的 Python 环境，可改用 python3 -m pip install --user hap-cli，或用 python3 -m hap_cli 代替 hap 调用。登录使用 hap auth login（明道云 SaaS，会打开浏览器），用 hap auth whoami 确认登录成功及当前组织是否正确。私有部署、多环境多账号、组织与默认应用的设置，见 hap guide setup。
使用方式：每次动手前先运行 hap guide，它会给出当前机器上这一版 hap 的完整命令地图、可用细分主题以及常见坑，命令地图现场生成，始终与实际可跑命令一致。需要某方面细节时，按 hap guide 输出中列出的主题深入，例如写记录的取值格式、登录与环境管理、从消息触达记录、何时转交其它 skill。
限制与注意：不要凭记忆拼命令名或参数，hap-cli 会自动升级，命令和参数会变，任何时候都以 hap guide（能做什么、该走哪条路）和 hap <命令> --help（该命令的确切参数）为准。写数据尤其要小心，不同字段类型的取值格式差别很大，传错基本不会报错，服务端照样返回成功但数据是坏的；动手前先看 hap guide 里的记录写入主题，写完读回确认。