概述
Outlit SDK Integration是Outlit官方提供的开发者集成技能，专注于帮助开发者在Web、服务端、原生及桌面应用中快速接入Outlit客户上下文图谱追踪系统。该技能采用决策树架构设计，强调"先检测、后询问、最小改动"的原则，避免对现有代码结构造成侵入性修改。
核心功能
技能覆盖七大决策分支：同意管理（Consent）、身份识别（Identity）、现有分析工具迁移、激活追踪（Activation）、计费集成（Billing）、事件追踪（Event Tracking）以及服务端/原生追踪。支持@outlit/browser、@outlit/node和Rust outlit crate三套SDK，完整适配React/Next.js、Vue/Nuxt、SvelteKit、Angular、Astro、Express、Fastify、Electron、Tauri、React Native等主流技术栈。
显著优点
1. 框架感知智能检测：自动识别package.json依赖、锁文件格式、环境变量约定，提供精准的安装命令和配置建议
2. 身份解析策略完善：清晰区分email/userId（人员级）与customerId（账户/工作区级），支持浏览器匿名访客关联、服务端指纹追踪等多端身份打通
3. 隐私合规内置：提供autoTrack: false模式与CMP集成模式，适应GDPR/CCPA等合规场景
4. 计费场景深度支持：原生对接Stripe，区分stripeCustomerId与系统customerId，支持Rust与TypeScript双栈API
5. 服务端可靠性保障：强制flush()/shutdown()模式、非重试错误快速失败机制，适配Serverless冷启动场景
潜在局限
1. 生态锁定风险：API设计深度耦合Outlit数据模型（如customerId强制账户级语义），迁移至其他CDP需重构代码
2. 日历嵌入限制：Cal.com/Calendly客户端嵌入无法自动捕获参会者身份信息，需额外配置Webhook服务端补全
3. Rust API差异：计费接口在Rust中仍使用domain前缀模式（.paid("acme.com")），与TypeScript的customerId直传模式存在认知摩擦
4. 激活语义狭窄：仅user.activate()为推荐手动调用，engaged/inactive已弃用，业务阶段定义权完全上交平台算法
适合人群
- 需快速搭建产品分析体系的SaaS初创团队
- 已使用Outlit作为客户数据平台，需标准化多端埋点的中大型企业
- 技术栈混合（Node + Rust/Tauri）的跨平台应用开发者
- 面临GDPR合规压力、需精细化同意管理的欧洲市场产品
常规风险
- 密钥混淆：反复强调
publicKey（pk_前缀）与privateKey区别，但历史项目中仍常见误用导致数据泄露 - 身份孤岛：服务端
identify()不自动关联浏览器访客Cookie，多端联合分析需严格遵循"浏览器setUser + 服务端customerId"的协作模式 - 队列丢失：Serverless环境未执行
flush()将导致事件丢失，技能虽强制提醒但无法运行时拦截 - 事件命名冲突：要求
snake_case但未提供自动校验，与团队现有camelCase规范可能产生摩擦