Test Integration 是 Affitor 提供的一项 CLI 测试能力，用于端到端验证 Affitor 追踪管线是否正常工作。当用户提到“test tracking”“verify integration”“test affitor”等意图时，该技能会被触发。
用途 该技能的核心用途是帮助开发者确认 Affitor 的联盟追踪集成已经正确配置并能完整运行。它通过向 Affitor API 发送模拟事件，验证从点击到注册再到销售的各环节是否被正确接收、存储和归因。
主要能力
- 分步测试：提供三个独立的测试命令，分别覆盖追踪管线的不同阶段。
- npx affitor test click：发送模拟的联盟点击事件，确认追踪 API 接受并存储该点击，同时验证 program ID 和 API key 是否有效。
- npx affitor test lead：发送带有模拟客户的注册/线索事件，确认归因链接（click → signup）是否生效，并验证线索 API 端点可达。
- npx affitor test sale：发送带有模拟交易的销售事件，确认收入归因（customer → affiliate）是否正常，并验证金额与货币的处理。
- 整体状态检查：npx affitor status 可显示程序配置、Stripe 连接状态（若使用 Stripe 自动设置）以及最近 24 小时的事件计数。
- 故障排查：提供常见问题与修复对照表，例如“No config found”需先运行 npx affitor init；“Invalid API key”需重新运行 npx affitor init 获取新密钥；“Click test passed but lead failed”需检查注册与销售调用中的 customer_key 是否一致；“Sale test shows $0 commission”需确认程序设置中已配置佣金比例。
- 调试模式：针对浏览器端追踪问题，可启用 debug 模式在浏览器控制台查看事件。可通过 script 标签引入 https://api.affitor.com/js/affitor-tracker.js 并设置 data-affitor-program-id 与 data-affitor-debug="true"，或通过 SDK 调用 loadAffitor('YOUR_PROGRAM_ID', { debug: true })。
使用方式 在项目环境中通过 npx 直接运行上述命令即可。首次使用前通常需要先执行 npx affitor init 完成初始化配置。测试命令会向 Affitor API 发送测试事件并返回处理结果。
适用场景 适用于已集成 Affitor 追踪的开发者，在开发、联调或上线前验证追踪管线是否端到端可用；也适用于排查点击、注册或销售事件未被正确记录的问题。
限制 该技能依赖 Affitor 服务与有效的 program ID、API key；测试事件为模拟数据，不代表真实业务数据；关于具体收费、价格、平台支持范围等信息，资料中暂未提供。