用途：ghl 用于在 HighLevel（面向用户时须称 HighLevel，不使用 Go 前缀，也不展开内部 ghl 标识）中读取和变更数据，覆盖 CRM、通信、排期、商务、内容、管理与 AI 等领域。
连接与目录：用 /opt/hatch/bin/ghl status 检查连接；若断开，运行 /opt/hatch/bin/ghl authorize-url 并分享返回的 connect_url，由用户在 HighLevel 登录，切勿在聊天中索要凭据。用 /opt/hatch/bin/ghl list-operations 获取固定操作目录及其细粒度权限方法；list-tools 返回实时发现工具 schema。
定位子账户：用 call-tool --name list_locations --arguments-json '{"query":"<sub-account name>"}' 解析目标子账户，多个匹配时询问用户，保留其 ID 用于执行。用 describe_operation 查看精确的 path/query/body 字段与必填输入；search_operations 可搜索 HighLevel 实时目录。
执行：/opt/hatch/bin/ghl execute-operation --operation-id <operation ID> --location-id <sub-account ID> --params-json '{"path":{},"query":{},"body":{}}'。联系人创建/更新/upsert 不能含标签，须用 add-tags 或 remove-tags；商机 upsert 不能含 follower 管理字段，须用单独操作。每个逻辑写/删须提供新的 --idempotency-key <UUID>，可选 --reason 说明；--dry-run 只预览不授权后续写入。
权限与限制：CRM/日历读取与对话/消息读取权限分离；联系人编辑、备注/任务、商机、预约、自动化、消息及删除各有独立控制。消息变更每次调用均需批准；预约变更可能通知联系人或触发自动化（toNotify 默认 true），campaign 与 workflow 注册也可能发起通信。更新或删除前先读取确认记录，不得猜测 ID。CLI 不自动重试变更；写入结果未确认时应先核查状态，同一逻辑变更保持同一幂等键。发送除非提供方确认送达，否则仅报告为已接受或已排期。财务、发布、消息、访问控制和删除属重大操作，须先描述、展示确切参数，且不得跨子账户推断或复用标识。未进入固定目录的未来操作仍需一次性写入批准。