@cloudbase/cli 2.8.0-beta.4 → 2.8.0-beta.5

package/rules/database.mdc

@@ -0,0 +1,25 @@
+---
+description: 数据库操作规则和注意事项
+globs: ["**/db/**/*", "**/database/**/*"]
+alwaysApply: false
+---
+
+# 数据库操作规则
+
+## CloudBase 数据库注意事项
+1. CloudBase数据库doc(id).get()返回的data是数组，需用data[0]获取文档内容
+2. 更新文档时，避免直接存储复杂对象，应提取和保存简单值
+3. 错误处理应返回error.message而非整个error对象，避免循环引用
+4. 使用new Date()替代db.serverDate()创建时间戳
+5. 对于有数据库归属的情况，检查和更新应通过云函数处理，避免数据库权限问题
+6. 云开发的云数据或者 mongodb不能在null值上创建新的嵌套字段，必要时可以用set()替代update()并删除_id
+
+## 数据库权限管理
+1. 云开发的数据库访问是有权限的，默认的基础权限有：
+   - 仅创建者可写，所有人可读
+   - 仅创建者可读写
+   - 仅管理端可写，所有人可读
+   - 仅管理端可读写
+2. 如果直接从 web 端或者小程序端请求数据库，需要考虑配置合适的数据库权限
+3. 在云函数中，默认没有权限控制
+4. 跨数据库集合的操作必须通过云函数实现

package/rules/miniprogram-development.mdc

@@ -0,0 +1,61 @@
+---
+description: 微信小程序开发规则
+globs: ["**/*.wxml", "**/*.wxss", "**/*.js", "**/*.ts", "**/*.json", "miniprogram/**/*"]
+alwaysApply: false
+---
+
+# 微信小程序开发规则
+
+## 项目结构
+1. 如果用户需要开发小程序，你会使用微信云开发的各种能力来开发项目，小程序的基础库直接用 latest 即可
+2. 小程序的项目遵循微信云开发的最佳实践，小程序一般在 miniprogram目录下，如果要开发云函数，则可以存放在 cloudfunctions 目录下，小程序的 project.config.json 需要指定miniprogramRoot这些
+3. 生成小程序页面的时候，必须包含页面的配置文件例如index.json等，要符合规范，避免编译出错
+
+## 云开发集成
+1. 小程序 wx.cloud 的时候，需要指定环境 Id，环境 id 可以通过 envQuery 工具来查询
+2. 生成小程序代码的时候，如果需要用到素材图片，比如 tabbar 的 iconPath 等地方，可以从 unsplash 通过 url 来下载，可以参考工作流程中的下载远程资源流程，在生成小程序代码的时候，如果用到了iconPath 这些，必须同时帮用户下载图标，避免构建报错
+
+## AI 大模型调用
+小程序中基础库 3.7.1版本以上已经支持直接调用大模型
+
+```js
+// 创建模型实例，这里我们使用 DeepSeek 大模型
+const model = wx.cloud.extend.AI.createModel("deepseek");
+
+// 我们先设定好 AI 的系统提示词，这里以七言绝句生成为例
+const systemPrompt =
+  "请严格按照七言绝句或七言律诗的格律要求创作，平仄需符合规则，押韵要和谐自然，韵脚字需在同一韵部。创作内容围绕用户给定的主题，七言绝句共四句，每句七个字；七言律诗共八句，每句七个字，颔联和颈联需对仗工整。同时，要融入生动的意象、丰富的情感与优美的意境，展现出古诗词的韵味与美感。";
+
+// 用户的自然语言输入，如'帮我写一首赞美玉龙雪山的诗'
+const userInput = "帮我写一首赞美玉龙雪山的诗";
+
+// 将系统提示词和用户输入，传入大模型
+const res = await model.streamText({
+  data: {
+    model: "deepseek-v3", // 指定具体的模型
+    messages: [
+      { role: "system", content: systemPrompt },
+      { role: "user", content: userInput },
+    ],
+  },
+});
+
+// 接收大模型的响应
+// 由于大模型的返回结果是流式的，所以我们这里需要循环接收完整的响应文本。
+for await (let str of res.textStream) {
+  console.log(str);
+}
+```
+
+## 微信步数获取
+**微信步数获取必须使用CloudID方式（基础库2.7.0+）**：
+- 前端：`wx.getWeRunData()` 获取cloudID，使用 `wx.cloud.CloudID(cloudID)` 传递给云函数
+- 云函数：直接使用 `weRunData.data` 获取解密后的步数数据，检查 `weRunData.errCode` 处理错误
+- 禁止使用session_key手动解密方式，CloudID更安全简单
+- 必须实现降级机制（模拟数据）处理cloudID获取失败的情况
+
+## 云函数部署和权限注意事项
+- AI自动部署云函数后，可能缺少云调用等特殊权限
+- 建议用户在微信开发者工具中右键选择云函数，选择"云端安装依赖"
+- 对于需要云调用权限的函数（如微信步数解密），建议通过开发者工具手动部署一次以获取完整权限
+- 如遇到权限问题，提示用户检查云函数的服务授权和API权限配置

package/rules/ui-design.mdc

@@ -0,0 +1,24 @@
+---
+description: 页面设计和UI规范
+globs: ["**/*.css", "**/*.scss", "**/*.less", "**/*.wxml", "**/*.html", "**/*.vue", "**/*.jsx", "**/*.tsx"]
+alwaysApply: false
+---
+
+# 页面设计规则
+
+你是专业的前端开发工程师，专长于创建高保真原型设计。你的主要工作是将用户需求转化为可直接用于开发的界面原型。请通过以下方式完所有界面的原型设计，并确保这些原型界面可以直接用于开发。
+
+## 设计流程
+1. **用户体验分析**：先分析这个 App 的主要功能和用户需求，确定核心交互逻辑。
+
+2. **产品界面规划**：作为产品经理，定义关键界面，确保信息架构合理。
+
+3. **高保真 UI 设计**：作为 UI 设计师，设计贴近真实 iOS/Android 设计规范的界面，使用现代化的 UI 元素，使其具有良好的视觉体验。
+
+4. **前端原型实现**：使用 Tailwind CSS 来处理样式，可以使用 FontAwesome 让界面更加精美、接近真实的 App 设计。拆分代码文件，保持结构清晰。
+
+5. **真实感增强**：
+   - 使用真实的 UI 图片，而非占位符图片（可从 Unsplash、Pexels、Apple 官方 UI 资源中选择）
+
+## 设计限制
+如无特别要求，给出至多4个页面即可。无需考虑生成长度与复杂度，保证应用的丰富。

package/rules/web-development.mdc

@@ -0,0 +1,44 @@
+---
+description: Web 前端项目开发规则
+globs: ["**/*.html", "**/*.js", "**/*.ts", "**/*.jsx", "**/*.tsx", "**/*.vue"]
+alwaysApply: false
+---
+
+# Web 前端开发规则
+
+## 项目结构
+1. web 项目一般前端源代码存放在 src 目录下，构建后的产物放在 dist 目录下，云函数放在 cloudfunctions 目录下
+2. 项目尽量使用 vite 等现代前端工程化体系，通过 npm 安装依赖
+3. 前端项目如何涉及到路由，可以默认用 hash 路由，可以解决路由刷新404的问题，更适合部署到静态网站托管
+
+## 部署和预览
+1. 如果是一个前端项目，你可以在构建完毕后使用云开发静态托管，先本地启动预览，然后可以跟用户确认是否需要部署到云开发静态托管，部署的时候，如果用户没有特殊要求，一般不要直接部署到根目录，并返回部署后的地址，需要是一个markdown 的链接格式
+2. 本地启动预览静态网页可以进到指定的产物目录后，可以用 `npx live-server`
+3. web 项目部署到静态托管 cdn 上时，由于无法提前预知路径，publicPath 之类的配置应该采用用相对路径而不是绝对路径。这会解决资源加载的问题
+
+## CloudBase Web SDK 使用
+1. 如果用户项目中需要用到数据库，云函数等功能，需要在 web 应用引入 @cloudbase/js-sdk@latest
+
+```js
+const app = cloudbase.init({
+  env: 'xxxx-yyy'; // 可以通过 envQuery 工具来查询环境 id
+});
+const auth = app.auth();
+
+// 检查当前登录状态
+let loginState = await auth.getLoginState();
+
+if (loginState && loginState.isLoggedIn) {
+  // 已登录
+} else {
+  // 未登录
+  // 如果是游客类型，需要用下方的方式
+  // 重要 2.x的 jssdk 匿名登录必须采用下方的方式
+  // await auth.signInAnonymously();
+  // 如果需要登录，可以用下方的方式
+  // await auth.toDefaultLoginPage()
+}
+```
+
+## 构建流程
+web 构建项目流程：确保首先执行过 npm install 命令，然后参考项目说明进行构建

package/rules/workflows.mdc

@@ -0,0 +1,30 @@
+---
+description: 开发工作流程和部署流程
+globs: []
+alwaysApply: false
+---
+
+# 开发工作流程
+
+## 部署流程
+1. 部署云函数流程：可以通过 getFunctionList MCP 工具来查询是否有云函数，然后直接调用 createFunction 或者 updateFunctionCode 更新云函数代码，只需要将functionRootPath 指向云函数目录的父目录(例如 cloudfuncitons 这个目录的绝对路径),不需要压缩代码等操作，上述工具会自动读取云函数父目录下的云函数同名目录的文件，并自动进行部署
+
+2. 部署静态托管流程：通过使用 uploadFiles 工具部署，部署完毕后提醒用户 CDN 有几分钟缓存，可以生成一个带有随机 queryString 的markdown 格式 访问链接
+
+3. 下载远程素材链接：使用 downloadRemoteFile 工具下载文件到本地，如果需要远程链接，可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
+
+4. 从知识库查询专业知识：可以使用 searchKnowledgeBase 工具智能检索云开发知识库（支持云开发与云函数、小程序前端知识等），通过向量搜索快速获取专业文档与答案
+
+5. 下载云开发 AI 规则或者其他模板：可以使用downloadTemplate 来下载，如果无法下载到当前目录，可以使用脚本来进行复制，注意隐藏文件也需要复制
+
+## 文档生成规则
+1. 你会在生成项目后生成一个 README.md 文件，里面包含项目的基本信息，例如项目名称、项目描述, 最关键的是要把项目的架构和涉及到的云开发资源说清楚，让维护者可以参考来进行修改和维护
+2. 部署完毕后，如果是 web 可以把正式部署的访问地址也写到文档中
+
+## 配置文件规则
+1. 为了方便其他不使用 AI 的人了解有哪些资源，可以在生成之后，同时生成一个 cloudbaserc.json，并支持使用 @cloudbase/cli来部署，提供 AI 调用 MCP 部署之外的另外一个选项
+
+## MCP 接口调用规则
+你调用mcp服务的时候，需要充分理解所有要调用接口的数据类型，以及返回值的类型，如果你不确定需要调用什么接口，请先查看文档和tools的描述，然后根据文档和tools的描述，确定你需要调用什么接口和参数，不要出现调用的方法参数，或者参数类型错误的情况。
+
+例如，很多接口都需要传confirm参数，这个参数是boolean类型，如果你不提供这个参数，或者提供错误的数据类型错误，那么接口会返回错误。

package/specs/ai-cli-bootstrap/QWEN.md

@@ -0,0 +1,196 @@
+# Qwen Code 使用指南
+
+## 简介
+
+Qwen Code 是一个基于 Qwen3-Coder 模型的命令行 AI 工作流工具，专门为代码理解和编辑优化。
+
+## 安装
+
+```bash
+npm install -g @qwen-code/qwen-code
+```
+
+## 配置
+
+### 环境变量
+
+在 `.env` 文件中配置以下环境变量：
+
+```bash
+# Qwen API 配置
+OPENAI_API_KEY=your_qwen_api_key_here
+OPENAI_BASE_URL=https://dashscope.aliyuncs.com
+OPENAI_MODEL=qwen-turbo
+```
+
+### 获取 API Key
+
+1. 访问 [阿里云 DashScope](https://dashscope.aliyun.com/)
+2. 注册并登录账户
+3. 创建 API Key
+4. 将 API Key 配置到环境变量中
+
+## 使用方法
+
+### 基本命令
+
+```bash
+# 启动 Qwen Code
+qwen
+
+# 指定项目目录
+cd your-project/
+qwen
+```
+
+### 常用任务
+
+#### 代码理解
+
+```
+> 描述这个系统的主要架构组件
+> 这个模块的数据流是如何工作的？
+> 有哪些安全机制？
+```
+
+#### 代码重构
+
+```
+> 重构这个函数以提高可读性和性能
+> 帮助我重构这个类以遵循更好的设计模式
+> 添加适当的错误处理和日志记录
+```
+
+#### 文档和测试
+
+```
+> 为这个函数生成全面的 JSDoc 注释
+> 为这个组件编写单元测试
+> 创建 API 文档
+```
+
+#### 工作流自动化
+
+```
+> 分析过去 7 天的 git 提交，按功能和团队成员分组
+> 将此目录中的所有图像转换为 PNG 格式
+```
+
+## 与 CloudBase 集成
+
+### 云开发项目
+
+Qwen Code 可以与 CloudBase 项目完美集成：
+
+```bash
+# 在 CloudBase 项目中使用
+cd my-cloudbase-project/
+qwen
+
+# 询问云开发相关问题
+> 如何优化这个云函数的性能？
+> 这个数据库集合的权限配置是否正确？
+> 如何添加新的云函数触发器？
+```
+
+### 最佳实践
+
+1. **项目结构分析**：让 Qwen Code 理解你的 CloudBase 项目结构
+2. **代码审查**：使用 AI 进行代码质量检查
+3. **文档生成**：自动生成 API 文档和部署说明
+4. **问题诊断**：快速定位和解决代码问题
+
+## 高级功能
+
+### 代码编辑
+
+Qwen Code 支持直接编辑代码文件：
+
+```
+> 优化这个云函数的错误处理
+> 添加 TypeScript 类型定义
+> 重构数据库查询以提高性能
+```
+
+### 工作流自动化
+
+```
+> 创建部署脚本
+> 生成测试用例
+> 设置 CI/CD 配置
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **API Key 错误**
+   - 检查 API Key 是否正确
+   - 确认账户余额充足
+
+2. **模型不可用**
+   - 确认模型名称正确
+   - 检查 API 端点配置
+
+3. **权限问题**
+   - 确认 API Key 有足够权限
+   - 检查网络连接
+
+### 调试模式
+
+```bash
+# 启用详细日志
+DEBUG=* qwen
+```
+
+## 性能优化
+
+### 上下文管理
+
+- 使用 `.qwenignore` 文件排除不必要的文件
+- 合理设置上下文窗口大小
+- 定期清理缓存
+
+### 模型选择
+
+- `qwen-turbo`: 快速响应，适合简单任务
+- `qwen-plus`: 平衡性能和准确性
+- `qwen-max`: 最高准确性，适合复杂任务
+
+## 示例项目
+
+### 云函数优化
+
+```bash
+cd cloudfunctions/
+qwen
+
+> 分析这个云函数的性能瓶颈
+> 添加适当的日志记录
+> 优化数据库查询
+```
+
+### 前端应用
+
+```bash
+cd miniprogram/
+qwen
+
+> 检查小程序代码规范
+> 优化页面加载性能
+> 添加错误处理
+```
+
+## 相关资源
+
+- [Qwen Code GitHub](https://github.com/QwenLM/qwen-code)
+- [阿里云 DashScope](https://dashscope.aliyun.com/)
+- [CloudBase 文档](https://cloud.tencent.com/document/product/876)
+- [Qwen 模型介绍](https://qwen.readthedocs.io/)
+
+## 更新日志
+
+### v1.0.0
+- 初始版本发布
+- 支持基本的代码理解和编辑功能
+- 集成 CloudBase 项目支持 

package/specs/ai-cli-bootstrap/design.md

@@ -0,0 +1,185 @@
+# 技术方案设计
+
+## 整体架构
+
+### 核心组件
+- **AICommandRouter**: 命令路由与执行引擎
+- **AIConfigManager**: 配置管理与持久化
+- **AISetupWizard**: 交互式配置向导
+- **TemplateManager**: 模板下载与完整性校验
+
+### 技术栈
+- **语言**: TypeScript
+- **CLI框架**: 基于现有 CloudBase CLI 架构
+- **配置管理**: JSON + 环境变量
+- **模板系统**: 远程下载 + 本地解压
+- **终端美化**: figlet + gradient-string + chalk
+
+## 命令设计
+
+### 主命令结构
+```bash
+tcb ai [options] -- [agent-args]
+```
+
+### 核心选项
+- `-a, --agent <name>`: 指定 AI 工具 (claude/codex/gemini)
+- `-e, --envId <id>`: 云开发环境 ID
+- `--setup`: 启动配置向导
+- `--config`: 显示当前配置
+- `--reset`: 重置配置
+
+### 参数透传机制
+- 使用 `--` 分隔符实现参数透传
+- 支持所有 agent CLI 原生参数
+- 自动注入环境变量和配置
+
+## 多 Agent 配置
+
+### 配置结构
+```json
+{
+  "defaultAgent": "claude",
+  "agents": {
+    "claude": {
+      "command": "claude",
+      "apiKey": "sk-xxx",
+      "baseUrl": "https://api.anthropic.com",
+      "model": "claude-3.5-sonnet"
+    }
+  }
+}
+```
+
+### 协议适配
+- **Anthropic协议**: 直接透传 (claude, kimi, k2)
+- **OpenAI协议**: 通过 claude-code-router 转发
+- **自定义协议**: 支持自定义 baseUrl 和认证
+
+## 路由与调用
+
+### 工具检测
+- 动态检测本地安装的工具
+- 提供安装指导和命令
+- 支持多平台兼容性
+
+### 环境变量注入
+- 自动注入 API 密钥
+- 设置基础 URL 和模型
+- 传递云开发环境 ID
+
+### claude-code-router 集成
+- 自动检测和安装
+- 智能配置生成
+- 环境变量自动注入
+
+## 模板完整性校验
+
+### 校验机制
+- 定义每个模板类型的必要文件列表
+- 解压后自动校验关键文件
+- 缺失文件时输出修复建议
+
+### 模板类型
+- **rules**: AI编辑器配置模板
+- **react**: React + CloudBase 全栈应用
+- **vue**: Vue + CloudBase 全栈应用  
+- **miniprogram**: 微信小程序 + 云开发
+- **uniapp**: UniApp + CloudBase 跨端应用
+
+## 终端输出美观
+
+### ASCII 艺术横幅
+- 使用 `figlet` 库生成 "CloudBase AI ToolKit" 艺术字体
+- 采用 "Slant" 字体样式，支持多行布局
+- 自动适配终端宽度，避免显示溢出
+
+### 渐变色彩效果
+- 使用 `gradient-string` 库实现渐变色彩
+- 色彩方案：青色 → 深蓝 → 绿色渐变
+- 支持多行文本的渐变效果
+
+### 实现细节
+```typescript
+async function showBanner() {
+  try {
+    const data = await promisify(figlet.text)(
+      `CloudBase
+AI ToolKit`,
+      {
+        font: 'Slant',
+        horizontalLayout: 'fitted',
+        verticalLayout: 'fitted',
+      }
+    );
+    console.log(
+      chalk.bold(
+        gradient(['cyan', 'rgb(0, 111, 150)', 'rgb(0, 246,136)']).multiline(
+          data + '\n'
+        )
+      )
+    );
+  } catch (e) {
+    // 降级到简单横幅
+    console.log(chalk.bold.cyanBright('⛰︎ CloudBase AI ToolKit CLI'));
+  }
+}
+```
+
+### 多终端兼容性
+- **支持终端**: iTerm2, Terminal.app, Windows Terminal, Git Bash
+- **降级处理**: 当 figlet 不可用时使用简单横幅
+- **色彩适配**: 自动检测终端色彩支持能力
+- **Unicode 支持**: 使用 emoji 和特殊字符增强视觉效果
+
+### 交互体验优化
+- **状态指示**: 使用 emoji 和颜色区分不同状态
+- **进度反馈**: 实时显示下载和安装进度
+- **错误处理**: 友好的错误信息和解决建议
+- **帮助提示**: 上下文相关的操作指导
+
+## 用户体验
+
+### 交互式配置
+- 使用 inquirer 提供友好的交互界面
+- 支持配置验证和错误提示
+- 提供默认值和快速配置选项
+
+### 错误处理
+- 详细的错误信息和解决建议
+- 支持配置重置和重新初始化
+- 网络异常时的重试机制
+
+### 帮助系统
+- 内置命令帮助和示例
+- 上下文相关的提示信息
+- 链接到官方文档和资源
+
+## 安全性
+
+### 配置安全
+- API 密钥本地加密存储
+- 环境变量安全注入
+- 配置文件权限控制
+
+### 网络安全
+- HTTPS 下载模板
+- 证书验证
+- 代理支持
+
+## 测试策略
+
+### 单元测试
+- 配置管理测试
+- 命令解析测试
+- 模板校验测试
+
+### 集成测试
+- 端到端工作流测试
+- 多平台兼容性测试
+- 错误场景测试
+
+### 用户体验测试
+- 终端输出效果测试
+- 交互流程测试
+- 性能基准测试 

package/specs/ai-cli-bootstrap/requirements.md

@@ -0,0 +1,51 @@
+# 需求文档
+
+## 介绍
+
+本需求旨在为云开发 CLI（CloudBase CLI）集成 AI 开发向导能力，内置云开发 AI ToolKit，支持主流 AI 编程 CLI（如 Claude Code、Opencode、Gemini CLI 等）的快速启动和配置。  
+该功能不直接集成第三方 CLI 工具，而是作为启动器和配置助手，提供极简与高级两种配置模式，内置云开发最佳实践和部署能力，并支持本地/远程大模型的灵活切换。  
+如本地未安装相关 AI CLI，则引导用户安装；如已安装，则可自动唤起并传递配置。  
+同时，解决现有实现中的环境变量、参数传递、CLI 兼容性、模板解压等问题。
+
+## 需求
+
+### 需求 1 - AI 开发向导启动与配置
+
+**用户故事：**  
+作为一名开发者，我希望通过云开发 CLI 一键启动 AI 编程助手（如 Claude Code、Opencode、Gemini CLI），并能自动完成环境检测、配置和最佳实践集成，从而快速体验和使用 AI 编程能力。
+
+#### 验收标准
+
+1. When 用户在云开发 CLI 中执行 AI 向导命令时，系统应检测本地是否已安装主流 AI CLI 工具（如 claude、opencode、gemini 等）。
+2. When 本地未安装目标 CLI 工具时，系统应输出清晰的安装指引（如 npm install -g @anthropic-ai/claude-code），并提示用户完成安装。
+3. When 本地已安装目标 CLI 工具时，系统应自动唤起该工具，并可传递必要的环境变量和参数（如环境 ID、API Key、模型类型等）。
+4. When 用户选择极简模式时，系统应默认使用云开发内置 DeepSeek 大模型，无需复杂配置即可体验 AI 编程。
+5. When 用户选择高级模式时，系统应支持自定义 AI 大模型（如 claude/k2/qwen/gemini/openrouter/ollama 等），并可配置 API 协议、路由、密钥等参数。
+6. When 目标 AI CLI 支持 anthropic 协议时，系统应自动透传相关参数（如 claude/k2/kimi 等）。
+7. When 目标 AI CLI 支持 OpenAI 协议时，系统应自动透传相关参数，或通过 claude-code-router 进行协议转发。
+8. When 用户配置了 claude-code-router，系统应支持自动检测和路由转发，支持多模型和多后端切换。
+9. When 用户在微信开发者工具等特殊终端使用时，CLI 输出应兼容终端特性（如防止滚动、支持浅色/深色模式）。
+10. When 用户通过 CLI 下载模板包时，系统应确保所有必要文件（包括小程序文件夹）完整解压。
+
+### 需求 2 - 兼容性与用户体验优化
+
+**用户故事：**  
+作为一名开发者，我希望云开发 CLI 的 AI 向导功能在不同终端和操作系统下都能稳定运行，输出内容美观、易读，并能及时反馈错误和操作建议。
+
+#### 验收标准
+
+1. When CLI 输出 CloudBase AI CLI 相关文字时，应自动适配浅色/深色终端，保证可读性。
+2. When 在微信开发者工具等特殊终端运行时，CLI 输出应避免内容被自动滚动，保证用户能看到最新提示。
+3. When CLI 发生错误（如参数传递失败、环境变量缺失、模板解压不完整等），应输出明确的错误信息和修复建议。
+4. When 用户需要帮助时，CLI 应提供详细的帮助文档和最佳实践指引。
+
+### 需求 3 - 安全与合规
+
+**用户故事：**  
+作为一名企业开发者，我希望云开发 CLI 的 AI 向导功能在集成第三方 AI CLI 时，能够遵守合规要求，不直接集成或分发第三方工具，仅作为启动器和配置助手。
+
+#### 验收标准
+
+1. When 启动第三方 AI CLI 时，系统不得直接集成或分发其代码，仅作为启动器和配置助手。
+2. When 需要传递敏感信息（如 API Key）时，系统应遵循最佳安全实践，避免明文泄露。
+3. When 用户未授权时，系统不得自动收集或上传用户数据。 

package/specs/ai-cli-bootstrap/tasks.md

@@ -0,0 +1,70 @@
+# 实施计划
+
+- [x] 1. 实现 tcb ai 命令的参数透传机制，支持 -- 后参数原样传递给 agent CLI
+  - 修改 `src/commands/ai/index.ts` 中的 `parseArgs` 方法，优先处理 `--` 分隔符
+  - 确保 `--` 后的所有参数直接透传给目标 AI CLI
+  - 测试参数透传功能正常工作
+  - _需求: 需求 1.1, 需求 1.2
+
+- [x] 2. 完善 Claude Code 本地检测与多平台兼容逻辑，输出推荐安装命令和 doctor 检查建议
+  - 在 `src/utils/ai/router.ts` 中增强 `isToolAvailable` 检测逻辑
+  - 添加 Windows 平台兼容性提示（WSL/Git Bash）
+  - 提供 `claude doctor` 检查建议
+  - 输出详细的安装指导
+  - _需求: 需求 1.3, 需求 2.1
+
+- [x] 3. 实现 claude-code-router 的本地检测、自动引导配置、典型配置结构生成
+  - 检测 `ccr` 命令可用性
+  - 自动安装 `@musistudio/claude-code-router`
+  - 执行 `ccr init` 初始化配置
+  - 根据用户配置生成智能 router 配置
+  - 支持自定义 provider 和路由规则
+  - _需求: 需求 1.4, 需求 2.2
+
+- [x] 4. 完善 agent CLI 路由与协议适配，支持 anthropic/OpenAI 协议自动透传或 router 转发
+  - 实现协议检测和自动适配
+  - 支持 anthropic 协议直接透传
+  - 通过 claude-code-router 转发 OpenAI 协议
+  - 自动注入环境变量和配置
+  - 处理不同协议的认证方式
+  - _需求: 需求 1.5, 需求 2.3
+
+- [x] 5. 完善模板完整性校验与自动修复，确保小程序文件夹等必要文件完整
+  - 定义每个模板类型的必要文件列表
+  - 解压后自动校验关键文件存在性
+  - 特别关注小程序 pages 文件夹完整性
+  - 缺失文件时输出具体修复建议
+  - 提供重新下载和网络检查建议
+  - _需求: 需求 3.1, 需求 3.2
+
+- [x] 6. 优化交互体验，终端输出美观、支持多终端、错误处理与帮助提示
+  - 使用 figlet 生成 ASCII 艺术横幅
+  - 添加 gradient-string 渐变色彩效果
+  - 实现多终端兼容性和降级处理
+  - 优化错误处理和帮助提示
+  - 添加详细的配置验证和解决建议
+  - 支持 emoji 和颜色区分不同状态
+  - _需求: 需求 4.1, 需求 4.2, 需求 4.3
+
+## 完成状态
+
+✅ **所有任务已完成**
+
+### 主要成果
+
+1. **参数透传机制**：完美支持 `--` 后参数原样透传
+2. **Claude Code 集成**：完整的安装检测和多平台兼容
+3. **claude-code-router 自动化**：智能检测、安装和配置
+4. **协议适配**：支持 anthropic/OpenAI 协议自动适配
+5. **模板完整性**：完善的校验和修复机制
+6. **终端美化**：ASCII 艺术横幅和渐变色彩效果
+
+### 技术亮点
+
+- 🎨 **美观的终端输出**：使用 figlet + gradient-string 生成专业横幅
+- 🔧 **智能配置管理**：自动检测、安装和配置 AI 工具
+- 🌐 **多协议支持**：无缝适配不同的 AI 服务协议
+- 🛡️ **错误处理**：友好的错误信息和解决建议
+- 📱 **多终端兼容**：支持各种终端环境和降级处理
+
+**CloudBase AI ToolKit CLI 功能已全部实现完成！** 🎉