SuperAPI AI 工具集

hap-cli-environments

部署与运维

查看项目

更新于 10-16 06:48

技能介绍

用途:当用户用 hap 命令行操作 HAP,且授权了多个环境或多个账号时,本 skill 帮助确定在哪个环境、哪个账号上执行命令。选错环境可能在不该动的环境上造成不可逆后果。

主要能力:先通过 hap --json auth accounts 查看当前使用的环境/账号(active)及各环境的名字、登录地址、账号、组织;把用户措辞匹配到具体环境或账号,优先按名字,其次按登录地址/平台(Mingdao SaaS、Nocoly、私有部署域名)与账号匹配;支持整段会话切换或单条命令临时切换。

使用方式:hap auth accounts 列出所有环境/账号,当前带 *;hap --json auth accounts 输出结构化结果;hap auth use <名字> 切换当前环境/账号;hap --profile <名字> <命令> 仅本条命令临时使用某环境/账号;HAP_PROFILE=<名字> hap <命令> 让整个终端会话默认使用某环境/账号;hap auth whoami 确认当前用户/环境/组织。具体参数以 hap auth <子命令> --help 为准。

必须停下来问的情况:用户未指明环境/账号且操作具破坏性(删除应用、工作表、字段、记录,发布,改角色权限,批量写入);用户措辞匹配到多个环境/账号或一个都匹配不上。此时用问答卡片让用户选择,不要擅自挑一个执行,也不要默认用线上/正式环境。

执行时:每次跑命令前在回显中点明当前环境、账号、组织、登录地址;破坏性命令再加一句确认当前不是误选的正式环境。

限制与不该做:不要替用户登录或登出(auth login / auth logout),除非用户明确要求;不要把一个账号的 token 跨环境/账号复用,切换一律走 auth use / --profile,不手动搬运 token。登录/登出或建应用、查数据等操作应回到 hap-cli 及其指向的专门 skill。