用途:自动检测用户项目使用的框架,并在正确位置完成 Flows SDK 的完整安装与配置。
主要能力:先检查项目中是否已存在 @flows/react 或 @flows/js,若已安装则询问是否重装或重新配置;分析项目结构判断是 monorepo 还是单应用,monorepo 会列出检测到的应用包让用户选择安装目标;通过锁文件识别包管理器(pnpm-lock.yaml→pnpm、yarn.lock→yarn、bun.lock/bun.lockb→bun、package-lock.json→npm,默认 npm);按 package.json 依赖顺序检测框架(Next.js 优先于 React,Nuxt 优先于 Vue),并区分 Next.js App Router 与 Pages Router、Svelte 4 与 5;无匹配时按框架特征文件回退检测;检测 tsconfig.json 决定文件扩展名与类型注解。
使用方式:安装命令为 React/Next.js 用 npm i @flows/react @flows/react-components,其他框架用 npm i @flows/js @flows/js-components,并按检测到的包管理器替换为 pnpm add、yarn add 或 bun add。需要用户提供 Flows 仪表盘 Settings > General 中的 Organization ID。安装后按对应框架参考文件添加 SDK 初始化,替换 YOUR_ORGANIZATION_ID,保留 YOUR_USER_ID 占位符。随后验证依赖与文件,TypeScript 项目运行 tsc --noEmit 等类型检查。可选设置身份验证,需后端计算签名,禁止在客户端计算签名或把密钥放入浏览器可见环境变量。最后安装最佳实践技能:npx skills add RBND-studio/flows.sh --skill flows-best-practices。
适用场景:为使用上述框架的前端项目快速接入 Flows SDK。
限制:未检测到框架时需用户手动选择;身份验证需要后端支持;具体收费、价格与效果资料暂未提供。