用途:澄清 b24jssdk 与 VibeCode 的定位差异,指导在 Bitrix24 项目中正确选择。b24jssdk 是围绕 Bitrix24 REST 的 TypeScript 薄封装;VibeCode 是独立的 HTTP 服务,提供 JSON Entity API(/v1/deals、/v1/contacts 等)、AI Router(/v1/ai/chat/completions)、web search(/v1/search)以及托管部署的 infrastructure API,并非 Bitrix24 REST。
主要建议:对任何 Bitrix24 形态的操作默认用 b24jssdk(B24Hook/B24Frame/B24OAuth);仅在需要 AI Router、web search 或 VibeCode 基础设施时使用 VibeCode。两者不应混用于实体调用,因为字段名与过滤语法不同:b24jssdk 用 actions.v2.callList.make 等与 Bitrix24 REST 操作符,VibeCode 用 MongoDB 风格($gte、$lte、$ne、$contains、$in),认证分别为 webhook 密钥/OAuth 与 X-Api-Key: vibe_api_…。
用法:若仅有 AI 或搜索需求,可保留 b24jssdk 处理 Bitrix24,用普通 fetch 调用 VibeCode 端点。资料给出示例:用 $b24.actions.v2.call.make 读取 CRM 条目,再 fetch('https://vibecode.bitrix24.tech/v1/ai/chat/completions') 获取 AI 建议,最后用 crm.timeline.comment.add 写回。
限制与反模式:不要把 vibe_api_… 传给 B24Hook.fromWebhookUrl();不要把 MongoDB 风格过滤器传给 actions.v{2,3}.*.make;不要在同一批 deals 上混用 /v1/deals/search 与 crm.item.list;不要把 VibeCode 密钥存入 B24Frame.options.appSet。文末提醒需根据示例中是否出现 @bitrix24/b24jssdk 或 fetch + X-Api-Key 来判断产品归属。未提供具体价格、平台或效果信息。