用途：识别并抑制 HubSpot 中收到营销邮件但从未打开过的“幽灵联系人”。这类联系人会持续拉低发件人层面的互动信号，影响 Gmail、Microsoft 等收件方的收件箱投放，甚至波及活跃联系人。
主要能力：按“已送达 > 0、从未打开、从未退信”条件查找幽灵联系人；统计总数、仍为营销状态的数量、按送达量分档；导出完整审计 CSV；通过 API 创建主抑制名单和高送达无打开复核名单；在 HubSpot UI 中批量将联系人设为非营销。
关键用法：需 HubSpot 私有应用访问令牌，含 crm.objects.contacts.read 与 crm.lists.read/crm.lists.write 权限；Python 3.10+ 与 uv；.env 中配置 HUBSPOT_ACCESS_TOKEN；UI 抑制步骤需 Super Admin 或 Marketing Hub Admin 权限。可运行 uv run skills/suppress-ghost-contacts/scripts/before.py 与 uv run skills/suppress-ghost-contacts/scripts/after.py。流程为 Plan -> Before -> Execute -> After，无 execute 脚本。
重要限制：hs_marketable_status 通过 API 为只读，实际抑制必须在 HubSpot UI 或工作流中完成；“从未打开”在 HubSpot 中存储为 null 而非 0，必须使用 NOT_HAS_PROPERTY 操作符，用 EQ 0 会返回空结果；hs_email_bounce 同理。Search API 分页上限 10K，需按送达量分段查询导出。建议先抑制超过送达阈值（通常 5-15）的联系人，低于阈值的单独观察。技能推荐每月执行抑制、每季度复核删除，两个名单永久保持动态。