用途：实现 HubSpot CRM 从线索捕获到交易创建的完整销售管道工作流，覆盖联系人 upsert、公司查找或创建、交易创建、交易阶段推进与活动（备注）记录，是 HubSpot CRM 的核心变现路径。
主要能力：按邮箱搜索并创建或更新联系人；按域名查找或创建公司；读取交易管道与阶段后创建交易并关联联系人与公司；按阶段名称推进交易阶段；在联系人与交易上记录备注活动。
使用方式：需先完成 hubspot-install-auth 配置，并具备 crm.objects.contacts.write、crm.objects.companies.write、crm.objects.deals.write 权限范围，同时了解自身的交易管道与阶段。使用 @hubspot/api-client 初始化客户端，传入 process.env.HUBSPOT_ACCESS_TOKEN，并设置 numberOfApiCallRetries: 3。流程依次调用联系人搜索与创建/更新、公司搜索与创建、管道查询、交易创建、交易更新与备注创建等接口。
适用场景：线索捕获、联系人管理、交易创建或端到端销售流程自动化。
限制与错误处理：创建时重复邮箱会返回 409，需采用先搜索再创建的写法；阶段 ID 无效返回 400 PIPELINE_STAGE_NOT_FOUND，需先获取管道阶段；关联类型错误返回 INVALID_ASSOCIATION_TYPE；自定义属性不存在返回 PROPERTY_DOESNT_EXIST，需先在 HubSpot 设置中创建属性。营销自动化工作流可参考 hubspot-core-workflow-b。