用途：升级 intercom-client npm 包并处理 Intercom API 版本变更，在不破坏生产流量的前提下完成迁移。v6 的 TypeScript 重写改变了 API 表面，最主要的是将 users/leads 统一为 contacts API，本技能通过基于分支、经类型检查的升级流程，让每处破坏性变更在合并前由编译器和测试暴露。
主要能力：包含完整的 v5→v6 迁移指南（每个变更操作的前后代码对比、API 版本固定、升级步骤、类型导入变更、方法速查表），以及三个端到端示例。
必要用法：先检测版本，命令包括 npm list intercom-client、npm view intercom-client version，以及用 curl 请求 https://api.intercom.io/me 检查响应头中的 intercom-version。若已装主版本低于 6 而目标不低于 6，需预期 TypeScript 重写带来的破坏性变更。迁移时把 new Intercom.Client() 换成 new IntercomClient()，users/leads 调用迁到统一的 contacts API，位置参数改名（id → contactId/conversationId），错误处理改为 IntercomError 实例检查。仅在原始 fetch 请求或需冻结响应结构时显式固定 API 版本，SDK 会自动发送兼容的 Intercom-Version 头。升级在专用分支上进行，例如 git checkout -b upgrade/intercom-client-v6、npm install intercom-client@latest、npx tsc --noEmit、npm test，逐个修复编译器报错直至通过。
认证：调用使用工作区访问令牌作为 Bearer 令牌，从 INTERCOM_ACCESS_TOKEN 环境变量读取，切勿硬编码；集成测试建议使用独立的开发工作区令牌 DEV_TOKEN。
适用场景：已安装 intercom-client、有 Git 和可用测试套件、迁移到 v6+ 且配置了 TypeScript 的项目。限制：需要可运行测试套件和开发工作区验证，缺失信息暂未提供。