mcpField
H
hap-cli

hap-cli

github.com/mingdaocom生产力13153 次安装5 周前更新
代码仓库

关于 hap-cli

hap-cli 是访问 HAP 企业平台功能的命令行工具,覆盖通讯录、工作表、工作流和权限等。指南强调操作前查看实时命令地图,以确认当前版本的命令与参数。

主要功能

  1. 01访问通讯录与部门
  2. 02处理聊天、群组和动态
  3. 03读写工作表记录
  4. 04管理工作流与审批
  5. 05用 hap guide 查看命令

适用场景

  1. 01查询 hap 当前可用命令
  2. 02谨慎更新工作表记录
  3. 03通过命令行处理组织事务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mingdaocom/hap-skills --skill hap-cli

安装后在 Claude Code 中输入/hap-cli确认已加载。

详细介绍

来自项目 README

hap-cli 使用导航

hap-cli(命令 hap)把 HAP 企业平台的后端能力封装成命令行,覆盖: 通讯录与部门、聊天消息与群组、动态、日程、工作表记录读写、视图与字段、 工作流与审批待办、自定义页面、角色权限、组织与应用管理、文件上传与分享。

第一步:确认 hap 已安装

hap --version

有版本号输出就跳到下一步。 报 command not found 就先装:

pip install hap-cli

装完再跑一次 hap --version 确认。如果 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 guide

它会给出当前这台机器上这一版 hap 的完整命令地图、可用的细分主题,以及最常踩的坑。 命令地图是现场生成的,永远和实际能跑的命令一致。

需要具体某方面的细节,按 hap guide 输出里列出的主题深入,例如写记录的取值格式、 登录与环境管理、从消息触达记录、什么时候该转交其它 skill。

铁律

不要凭记忆拼命令名或参数。

hap-cli 会自动升级,命令和参数会变。任何时候都以这两个为准:

  • hap guide —— 能做什么、该走哪条路
  • hap <命令> --help —— 这个命令的确切参数

写数据尤其要小心:不同字段类型的取值格式差别很大,而且传错基本不会报错, 服务端照样返回成功但数据是坏的。动手前先看 hap guide 里的记录写入主题, 写完读回确认。

评论

支持 Markdown