用途:这是一个 Bitrix24 的 Nuxt 4 仪表盘应用模板,既可作为独立应用基于模拟数据运行,也可嵌入 Bitrix24 中通过 B24 Frame SDK 读取 CRM 数据。界面全部由 @bitrix24/b24ui-nuxt 组件和 @bitrix24/b24icons-vue 图标组成,所有可见字符串在 19 个语言区域中本地化。
主要能力与规则:使用语义化颜色令牌(如 text-description、bg-elevated、border-muted、air-primary),禁止使用原始 Tailwind 调色板(如 text-gray-500、bg-blue-600);禁止硬编码面向用户的字符串,所有文本经 i18n 处理,键先加入 i18n/locales/en.json;所有 B24 访问通过 useB24(),组件中不得直接 new B24Frame();页面保持精简,功能 UI 放在 app/components/<feature>/,数据放在 app/composables/ 或 server/api/;新数据须先以模拟数据独立渲染,再接入真实 CRM 数据。
使用方式:第一步先确定集成目标——若为 Bitrix24 Vibecoding,先执行 recipes/setup-target.md 中的移除流程(剥离 @bitrix24/b24jssdk 与 -nuxt),再基于模拟数据构建并使用 https://vibecode.bitrix24.tech/llms.txt;若为 REST API,则保留 SDK,遵循 recipes/setup-target.md,使用 JS SDK 文档并推荐 REST API MCP Server。用户未说明时应询问,不要假设。按任务只加载所需参考文件:架构、约定、i18n、b24-integration,以及 setup-target、add-page、data-layer 等配方。组件 API 参考见 https://bitrix24.github.io/b24ui/llms.txt。
完成前检查:pnpm lint 通过(pnpm lint --fix 自动修复风格规则)、pnpm typecheck 通过、无硬编码用户字符串、无原始 Tailwind 调色板颜色、新数据可在模拟数据下独立渲染。
限制与待办:所有页面本地化尚未完成;AI 匿名反馈回路仍在开发中(交付项,规格待定);app/pages/install.vue 目前实现仅客户端安装流程,其 placement/userFields 处理器为演示绑定。