🚀 CloudBase AI Toolkit 2.0 - 架构重构与能力升级

📖 故事：从 1.x 到 2.0 的进化之路

在 1.x 版本中，CloudBase AI Toolkit 建立了完整的 MCP 工具生态，为 AI 开发者提供了 39 个强大的工具。然而，随着用户需求的深入和 AI 能力的提升，我们发现了一个关键问题：规则（Rules）虽然强大，但缺乏结构化的技能体系。

2.0 版本的诞生，源于一个核心洞察：AI 需要的不只是工具，更需要专业的知识体系。我们将原有的规则系统重构为技能（Skills）体系，让 AI 能够像专业开发者一样思考和工作。

核心转变

• 从规则到技能：从分散的规则文件到结构化的技能体系
• 从功能到能力：从单一功能实现到完整能力建设
• 从工具到生态：从工具集合到完整的开发生态

✨ 核心亮点

🏗️ 架构重构：Rules → Skills 体系

用户价值：AI 开发者现在可以像专业开发者一样，按照技能模块组织知识，提升代码生成质量和开发效率。

技术实现：

• 将规则文件重构为技能（Skills）结构
• 每个技能包含完整的知识体系和最佳实践
• 支持技能的组合和复用

相关更新：

• feat(rules): 🔄 refactor rules to skills structure (440bc961)
• chore: update skills (8331ed07)

🎨 UI 设计能力：专业级设计规范

用户价值：AI 现在能够生成具有独特美学风格的界面，告别千篇一律的 AI 风格，产出真正专业的设计。

技术实现：

• 引入 Claude Code 设计原则
• 强制设计规范输出流程
• 禁止通用 AI 美学（紫色渐变、系统字体等）
• 提供完整的设计思维框架

相关更新：

• feat(ui-design): ✨ enhance UI design rules with Claude Code design principles (1fcb087c)
• feat(rules): 🔒 strengthen UI design rules reference (f8f2ca71)
• feat(rules): ✨ enforce template download and UI design doc reading (0a35013a)

🗄️ 数据库能力：MySQL + NoSQL 全栈支持

用户价值：开发者现在可以通过 AI 完成从数据建模到数据库操作的全流程，支持 MySQL 和 NoSQL 两种数据库类型。

技术实现：

• 新增 MySQL 数据库支持（查询、SQL 执行、表管理）
• 新增 NoSQL Skills（Web 和小程序端）
• 新增关系型数据库 Skills
• 支持多数据库实例管理

相关更新：

• feat(database): 🗄️ add MySQL database support (094f9cc5)
• feat: mysql mcp (77ae9c9e)
• feat: mySQL acl (7286d965)
• feat: no sql skill (a835a33c)
• feat: rdb skills (6f4aa880)

🔐 认证系统：平台化技能体系

用户价值：AI 现在能够根据不同平台（Web、小程序）自动选择正确的认证方式，减少配置错误。

技术实现：

• 新增认证技能（Auth Skills）体系
• 区分 Web 和小程序的认证方式
• 支持小程序 SDK 认证集成

相关更新：

• feat: auth skills (e9c1c3b6)
• feat: add auth in wx skill (f4eac504)
• feat: wx sdk (8f4ff400)

🚀 开发体验：模板下载与文档搜索

用户价值：开发者可以快速启动项目，AI 可以智能搜索文档，大幅提升开发效率。

技术实现：

• 新增模板下载工具（支持 React、Vue、小程序、UniApp）
• 新增文档搜索工具（智能检索知识库）
• 强制使用模板下载，避免手动创建文件
• 新增项目案例展示页面

相关更新：

• feat: download template (a3cafd2e)
• feat: search doc tool (0e70f5cd)
• feat(doc): 🎨 add project cases gallery HTML page (047ab12a)

🛠️ 基础设施：日志系统与配置同步

用户价值：更稳定的日志系统，更智能的配置同步，提升整体系统可靠性。

技术实现：

• 使用 Winston 替换自定义日志系统
• 优化配置同步脚本（支持 Skills 结构）
• 改进环境管理（过滤特殊环境）
• 修复环境 ID 管理问题

相关更新：

• feat(logger): replace custom logger with winston (37b32ae5)
• feat(scripts): 🔧 convert fix-config-hardlinks to mjs and add skills sync (2a3894c2)
• feat(env): filter special environments (4fc41382)
• fix(envid): fix envId management bugs (60f0032f)

📋 详细更新列表

🏗️ 架构重构

Rules → Skills 结构重构

• 重构内容：将原有的规则文件系统重构为技能（Skills）体系
• 影响范围：所有 IDE 配置文件、规则文件
• 技术细节：
  • 技能文件结构：config/rules/{skill-name}/SKILL.md
  • 支持技能的组合和复用
  • 优化规则引用和同步机制
• Commit：440bc961

脚本系统优化

• 重构内容：将脚本文件从 .js 迁移到 .cjs 扩展名
• 技术细节：提升 CommonJS 兼容性，支持更好的模块化
• Commit：4dbe254c

🎨 UI 设计能力增强

UI Design 规则强化

• 新增功能：
  • 引入 Claude Code 设计原则
  • 强制设计规范输出（Purpose Statement、Aesthetic Direction、Color Palette、Typography、Layout Strategy）
  • 禁止通用 AI 美学（紫色渐变、系统字体、居中布局）
  • 提供完整的设计思维框架
• 技术细节：
  • 设计规范前置检查清单
  • 自审计机制（颜色、字体、布局检查）
  • 触发词检测系统
• Commits：
  • 1fcb087c
  • f8f2ca71

模板下载强制要求

• 新增功能：强制 AI 使用模板下载工具，禁止手动创建项目文件
• 技术细节：
  • 在 Quick Reference 中添加模板下载步骤
  • 在 Core Behavior Rules 中强化要求
  • 在 Development Quality Checklist 中添加检查项
• Commit：0a35013a

🗄️ 数据库能力

MySQL 数据库支持

• 新增功能：
  • MySQL 数据库查询和管理操作
  • 支持多数据库实例（DbInstance）
  • SQL 执行（SELECT、INSERT、UPDATE、DELETE）
  • 表列表查询（包含表名、列信息、主键、外键约束）
  • MySQL ACL 支持
• 技术细节：
  • 使用 Manager SDK 的 commonservice 模块
  • 支持只读查询限制
  • 返回结构化数据（Items、Infos、RowsAffected）
• Commits：
  • 094f9cc5
  • 77ae9c9e
  • 7286d965

NoSQL Skills

• 新增功能：
  • Web 端 NoSQL Skills
  • 小程序端 NoSQL Skills
  • 统一的数据操作规范
• Commit：a835a33c

关系型数据库 Skills

• 新增功能：关系型数据库技能体系
• Commit：6f4aa880

🔐 认证系统

认证技能体系

• 新增功能：
  • 统一的认证技能（Auth Skills）体系
  • 区分 Web 和小程序的认证方式
  • Web：使用 CloudBase Web SDK 内置认证
  • 小程序：自然免登录，在云函数中获取 OPENID
• Commits：
  • e9c1c3b6
  • f4eac504

小程序 SDK 集成

• 新增功能：小程序 SDK 认证集成
• Commit：8f4ff400

🚀 开发体验

模板下载工具

• 新增功能：
  • 支持下载 React、Vue、小程序、UniApp 模板
  • 支持 IDE 特定配置下载
  • 自动保护 README.md 文件
• Commit：a3cafd2e

文档搜索工具

• 新增功能：智能检索云开发知识库
• 技术细节：支持向量搜索，快速获取专业文档和答案
• Commit：0e70f5cd

项目案例展示

• 新增功能：项目案例展示 HTML 页面
• Commit：047ab12a

环境管理优化

• 改进内容：
  • 过滤特殊环境（在环境列表选择中）
  • 修复环境 ID 管理问题
  • 添加全面的测试覆盖
• Commits：
  • 4fc41382
  • 60f0032f

工作流优化

• 改进内容：
  • 优化开发工作流
  • 优化后端策略（优先使用 SDK 直接调用数据库）
• Commit：9114b79b

🛠️ 基础设施

日志系统升级

• 改进内容：使用 Winston 替换自定义日志系统
• 技术细节：
  • 支持跨平台兼容性
  • 修复 Webpack 打包问题
  • 改进日志轮转和存储
• Commits：
  • 37b32ae5
  • e787f36c

配置同步优化

• 改进内容：
  • 将 fix-config-hardlinks 脚本转换为 .mjs
  • 添加 Skills 同步支持
  • 添加目录清理功能（同步前）
  • 改进脚本对规则的支持
• Commits：
  • 2a3894c2
  • 3fe90c31
  • 2fcc8960

配置同步到所有 IDE

• 改进内容：同步规则更新到所有 IDE 配置文件
• Commits：
  • ceb7a504
  • 87e80f20

🐛 问题修复

函数部署修复

• 修复内容：移除 updateFunctionCode 中的 runtime 参数，防止修改错误
• Commit：838f028e

CodeBuddy 配置修复

• 修复内容：更新 CodeBuddy 模板包含模式
• Commit：1d58efb1

其他修复

• 修复测试问题
• 修复技能名称和路径问题
• 修复资源 ID 问题
• 修复相对路径问题
• 修复工具描述问题

🔄 迁移指南

从 1.x 升级到 2.0

配置文件变更

规则文件路径变更：

• 旧路径：config/rules/cloudbase-rules.mdc
• 新路径：config/rules/{skill-name}/SKILL.md

影响：

• 如果你有自定义规则文件，需要迁移到新的 Skills 结构
• IDE 配置文件会自动同步，无需手动修改

技能体系使用

新增技能引用方式：

## 使用 UI Design Skill
- 在任务开始时，明确引用 `rule/ui-design-skill/SKILL.md`
- 必须输出设计规范后才能开始编码

模板下载要求

重要变更：

• AI 现在必须使用 downloadTemplate 工具下载模板
• 禁止手动创建项目文件（除非模板下载失败或用户明确要求）

影响：

• 现有项目不受影响
• 新项目开发时，AI 会自动使用模板下载功能

数据库操作

MySQL 支持：

• 新增 MySQL 数据库查询和管理功能
• 支持多数据库实例
• 支持 SQL 执行和表管理

NoSQL Skills：

• 新增 Web 和小程序端的 NoSQL Skills
• 统一的数据操作规范

认证方式

平台区分：

• Web 项目：必须使用 CloudBase Web SDK 内置认证
• 小程序项目：自然免登录，在云函数中获取 OPENID

影响：

• 现有项目需要检查认证方式是否符合新规范
• AI 会自动根据项目类型选择正确的认证方式

日志系统

Winston 日志系统：

• 日志系统已升级为 Winston
• 更好的跨平台兼容性
• 改进的日志轮转和存储

影响：

• 日志格式保持不变
• 日志文件位置和命名规则不变

🎯 未来展望

即将到来的功能

1. 更多技能模块：持续扩展技能体系，覆盖更多开发场景
2. 智能代码生成：基于技能体系的更智能代码生成
3. 多语言支持：扩展更多编程语言和框架的支持
4. 性能优化：持续优化工具执行效率和响应速度

社区反馈

我们非常重视社区反馈，如果你有任何建议或问题，欢迎：

• 提交 Issue
• 参与讨论
• 查看文档

📊 版本统计

• 总 Commit 数：55 个非合并 commit
• 新增功能：15+ 个主要功能
• 架构重构：Rules → Skills 体系
• 问题修复：10+ 个问题修复
• 文档更新：全面的文档和规范更新

🙏 致谢

感谢所有为 CloudBase AI Toolkit 2.0 做出贡献的开发者！

特别感谢：

• 所有提交代码的贡献者
• 提供反馈和建议的用户
• 参与测试和验证的社区成员

最后更新时间：2025年11月