Kuaida CLI

利用 AI 重新定义开发范式

我们正在进行一场研发模式变革。曾经，低代码意味着便捷但受限；源码意味着自由但低效。现在，通过 Kuaida CLI，你可以直接继承低代码平台的快速搭建成果，并无缝无损地迁移至高性能的源码环境。它像一个资深的“数字架构师”，不仅帮你打通了部署与 SSO 的脏活累活，更通过 AI-Friendly 架构让你的代码资产在 AI 时代更具生命力。

Kuaida CLI 是快搭（Kuaida）平台的官方命令行工具，致力于弥合低代码与源码开发之间的鸿沟，提供从项目初始化、能力集成到一键部署的全流程支持。

✨ 核心特性

• 🚀 零成本迁移：一个指令将现有低代码应用转换为源码应用，保留原有配置与资产。
• 🤖 AI-Friendly 架构：初始化项目即具备 AI 友好的前端架构，规范的目录结构与代码风格，为 AI 辅助编程铺平道路。
• 🧩 快速能力集成：一键接入 CBB (Common Business Blocks) 能力，目前已支持 SSO 单点登录，更多能力持续更新中。
• ☁️ 一键部署：内置标准化的构建与部署流程，支持预发（Pre）与生产（Prod）环境，告别繁琐的运维配置。
• 🛠️ 开发者体验：基于 TypeScript 开发，提供友好的交互式终端体验与详细的日志反馈。

📦 安装

# 使用 npm
npm install -g @kuaida/cli

# 使用 yarn
yarn global add @kuaida/cli

# 使用 pnpm
pnpm add -g @kuaida/cli

⚡️ 快速开始

1. 登录平台

首先，使用你的快搭账号登录 CLI：

kuaida login

2. 初始化项目（低代码转源码）

使用应用 ID (appid) 将低代码应用转换为本地源码项目：

# 在当前目录初始化名为 my-app 的项目
kuaida init my-app --appid <your-app-id>

# 或者在当前目录直接初始化
kuaida init --here --appid <your-app-id>

此步骤会自动拉取平台配置，生成 AI-Friendly 的标准前端架构。

3. 集成 CBB 能力

需要接入单点登录？无需查阅文档手动配置，一条命令即可搞定：

# 交互式选择要集成的能力
kuaida add

# 或直接指定能力（如 SSO）
kuaida add sso

4. 一键部署

开发完成后，将项目构建并部署到指定环境：

# 部署到预发环境
kuaida deploy pre

# 部署到生产环境（需二次确认）
kuaida deploy prod

📖 命令详解

kuaida init [project-name]

初始化一个新的快搭项目或将现有项目接入快搭体系。

• --appid <id>: (必填) 快搭平台的应用 ID。
• --here: 在当前目录初始化，不创建新文件夹。
• --force: 强制覆盖现有配置。
• --template <name>: 指定使用的模板（默认为标准 AI-Friendly 模板）。

kuaida add [cbb-name]

为项目添加通用业务模块（CBB）。

• [cbb-name]: 模块名称（如 sso）。如果不填，将进入交互式选择模式。
• --force: 跳过确认，强制集成。

kuaida deploy [environment]

构建并部署项目。

• [environment]: 部署环境，可选 pre (预发) 或 prod (生产)。
• --build-command <cmd>: 自定义构建命令 (默认: npm run build)。
• --output-dir <dir>: 指定产物目录 (默认自动检测 dist, build 等)。
• --skip-build: 跳过本地构建，直接部署现有产物。

kuaida auth

管理账号认证状态。

• kuaida login: 登录。
• kuaida logout: 登出。
• kuaida me: 查看当前登录用户信息。

🤝 参与贡献

欢迎提交 Issue 或 Pull Request 来改进 Kuaida CLI。

📄 License

MIT