用途：通过 ibl.ai 平台 API 管理单个组织的 CRM 数据，包括人员、组织、管道及其阶段、线索来源、交易、活动和标签，用于线索捕获、管道管理与交易流转。
主要能力：各资源支持标准 REST（GET 列表、POST 创建、GET {id} 读取、PATCH {id} 更新、DELETE {id} 删除）。交易提供专用动作：move-stage/ 流转阶段、won/ 赢单、lost/ 输单（需非空 lost_reason）。人员支持 merge/ 合并重复项、invite/ 发送邀请、link-user/ 关联平台用户。活动支持 done/ 标记完成。标签支持在 persons、organizations、deals 上附加与解除。
使用方式：基础地址为 https://api.iblai.app/dm，CRM 路径追加 /api/crm/...，例如 https://api.iblai.app/dm/api/crm/persons/。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。记录按令牌解析出的组织限定，路径中无 {org}。Person 与 Organization 的 id 为 UUID 字符串，其余资源为整数。列表 GET 使用 ?page={n} 翻页，?page_size={n} 调整每页大小（默认 50），返回信封含 count、next_page、previous_page、results。常用过滤：owner={user_id}、owner__isnull=true、管道 ?is_default=true。未连接时先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
适用场景：线索捕获、管道与阶段管理、交易推进与赢单/输单、活动时间线、标签归类、人员合并与邀请。
限制：DELETE 具破坏性，需先与用户确认；标签删除会级联移除所有关联；invite/ 会对外发信，需先确认；跨组织记录返回 404 而非 403。生命周期阶段为 lead | qualified | opportunity | customer | churned。字段级 schema、枚举与过滤参数见 references/schema.md，概念与工作流见 references/guide.md、quickstart.md、workflows.md、operations.md。