用途：通过 ibl.ai 平台 API 读取和发送组织通知，并管理相关配置。
主要能力：查询未读通知数量与通知列表（可按 status、channel、exclude_channel、start_date、end_date、tags 过滤，分页）；将指定通知标记为已读/未读、批量更新用户全部通知状态、删除单条通知；使用两步式通知构建器——先 preview/ 解析收件人并返回 build_id，再 send/ 实际发送或定时发送（preview/ 传入 process_on 即变为定时）；validate_source/ 与 {build_id}/recipients/ 可在提交前校验收件人。还支持管理用户通知偏好（邮件/推送开关、频率、按类型开关）、注册与注销 FCM 推送设备令牌，以及组织管理员维护通知模板（编辑、启用/禁用、重置为平台默认、发送测试渲染）和测试 SMTP 配置。
使用方式：基础地址为 https://api.iblai.app，所有请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY；路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{platform_key} 通常为 $IBLAI_ORG。端点位于 https://api.iblai.app/dm/api/notification/v1/ 下。未连接时先运行 /iblai-api-login 填充环境变量。示例：curl -s "https://api.iblai.app/dm/api/notification/v1/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/notifications-count/?status=UNREAD" -H "Authorization: Api-Token $IBLAI_API_KEY"。
适用场景：在智能体或自动化流程中读取、发送、定时组织通知，管理用户偏好与推送设备，或由管理员配置模板与 SMTP。
限制：发送通知、模板测试和 SMTP 测试均会对外发送真实邮件，执行前需与用户确认收件人；mark-all-as-read 与 bulk-update 等批量操作也需先确认。模板 toggle/ 是平台级开关，与按用户的通知偏好不同。部分字段为只读。具体权限（RBAC）与更多概念见随附参考文档。