用途：这是一个 HubSpot CRM 入门示例，帮助开发者用 HubSpot API 完成联系人、公司、交易三类记录的增删改查，适合在开始新 HubSpot 集成、验证环境配置或学习基础 CRM 操作时使用。
主要能力：覆盖创建联系人、读取联系人（可指定属性与关联）、更新联系人属性、创建公司并与联系人建立关联、创建交易并关联联系人与公司，以及搜索已有联系人和归档（删除）记录。示例使用真实端点与 SDK 方法，如 POST /crm/v3/objects/contacts、GET /crm/v3/objects/contacts/{contactId}、PATCH /crm/v3/objects/contacts/{contactId}、POST /crm/v3/objects/companies、PUT /crm/v4/objects/contacts/{contactId}/associations/companies/{companyId}、POST /crm/v3/objects/deals、POST /crm/v3/objects/contacts/search 和 DELETE /crm/v3/objects/contacts/{contactId}。
使用方式：需先完成 hubspot-install-auth 配置，准备具有 crm.objects.contacts.read 与 crm.objects.contacts.write 权限范围的私有应用，并安装 @hubspot/api-client。代码中通过环境变量 HUBSPOT_ACCESS_TOKEN 初始化客户端，再调用 client.crm.contacts.basicApi、client.crm.companies.basicApi、client.crm.deals.basicApi、client.crm.associations.v4.basicApi 和 client.crm.contacts.searchApi 等方法。
适用场景：新集成起步、环境连通性测试、学习 HubSpot CRM 对象模型与关联关系。
限制与错误处理：常见错误包括 409 冲突（邮箱已存在，可先搜索或 getById）、400 请求错误（属性名或值无效，需在 Settings > Properties 核对）、404 未找到（记录 ID 不存在或已归档）、PROPERTY_DOESNT_EXIST（自定义属性未创建，需先在设置中创建）。资料未提供收费、价格、平台支持范围等更多信息。