用途：在 HubSpot 生产系统中安全推进联系人生命周期阶段并维护列表完整性，避免静默破坏 CRM 数据可信度。
主要能力：一是生命周期阶段推进守卫，按内部枚举 subscriber→lead→marketingqualifiedlead→salesqualifiedlead→opportunity→customer→evangelist 顺序拦截回退更新（other 视为横向赋值）；二是动态列表条件变更后的成员快照与差异审计，规避最长 24 小时的陈旧成员窗口；三是静态列表孤儿 ID 扫描，通过批量读取识别已被硬删除的联系人；四是线索评分权威源消解，避免原生 hubspotscore 与自定义属性双源冲突；五是 Webhook 事件三层防御（快速消费入队、eventId 幂等、定时对账）；六是跨门户列表同步的两段式拉取推送。
使用方式：需 HubSpot 私有应用令牌，作用域含 crm.objects.contacts.read/write、crm.lists.read/write、crm.schemas.contacts.read；Python 3.10+ 或 Node.js 18+，jq、curl。令牌须存于密钥管理器，禁止写入源码或提交的 .env。示例命令如 curl -s "https://api.hubapi.com/crm/v3/objects/contacts/{contact-id}?properties=lifecyclestage" -H "Authorization: Bearer {your-token}" | jq '.properties.lifecyclestage'。
适用场景：营销运营集成、批量导入窗口、代理机构多门户镜像与共享抑制列表。
限制：HubSpot 对 5xx 不重试且无死信队列；动态列表拒绝直接写入成员；跨门户同步目标列表必须为静态；原生评分启用时写入 hubspotscore 会被 400 拒绝。具体实现细节与完整代码见资料中的 implementation-guide.md 与 API_REFERENCE.md，其余未提供。