Releases: TencentCloudBase/CloudBase-AI-ToolKit
Releases · TencentCloudBase/CloudBase-AI-ToolKit
🚀 CloudBase AI Toolkit 2.0 - 架构重构与能力升级
🚀 CloudBase AI Toolkit 2.0 - 架构重构与能力升级
🎉 从规则到技能，从工具到生态
一次架构级的进化，让 AI 开发更智能、更专业、更高效
📖 故事：从 1.x 到 2.0 的进化之路
在 1.x 版本中，CloudBase AI Toolkit 建立了完整的 MCP 工具生态，为 AI 开发者提供了 39 个强大的工具。然而，随着用户需求的深入和 AI 能力的提升，我们发现了一个关键问题：规则（Rules）虽然强大，但缺乏结构化的技能体系。
2.0 版本的诞生，源于一个核心洞察：AI 需要的不只是工具，更需要专业的知识体系。我们将原有的规则系统重构为技能（Skills）体系，让 AI 能够像专业开发者一样思考和工作。
核心转变
- 从规则到技能：从分散的规则文件到结构化的技能体系
- 从功能到能力：从单一功能实现到完整能力建设
- 从工具到生态：从工具集合到完整的开发生态
✨ 核心亮点
🏗️ 架构重构：Rules → Skills 体系
用户价值：AI 开发者现在可以像专业开发者一样，按照技能模块组织知识，提升代码生成质量和开发效率。
技术实现：
- 将规则文件重构为技能（Skills）结构
- 每个技能包含完整的知识体系和最佳实践
- 支持技能的组合和复用
相关更新：
🎨 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 认证集成
相关更新：
🚀 开发体验：模板下载与文档搜索
用户价值：开发者可以快速启动项目，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：
模板下载强制要求
- 新增功能：强制 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：
NoSQL Skills
- 新增功能：
- Web 端 NoSQL Skills
- 小程序端 NoSQL Skills
- 统一的数据操作规范
- Commit：a835a33c
关系型数据库 Skills
- 新增功能：关系型数据库技能体系
- Commit：6f4aa880
🔐 认证系统
认证技能体系
- 新增功能：
- 统一的认证技能（Auth Skills）体系
- 区分 Web 和小程序的认证方式
- Web：使用 CloudBase Web SDK 内置认证
- 小程序：自然免登录，在云函数中获取 OPENID
- Commits：
小程序 SDK 集成
- 新增功能：小程序 SDK 认证集成
- Commit：8f4ff400
🚀 开发体验
模板下载工具
- 新增功能：
- 支持下载 React、Vue、小程序、UniApp 模板
- 支持 IDE 特定配置下载
- 自动保护 README.md 文件
- Commit：a3cafd2e
文档搜索工具
- 新增功能：智能检索云开发知识库
- 技术细节：支持向量搜索，快速获取专业文档和答案
- Commit：0e70f5cd
项目案例展示
- 新增功能：项目案例展示 HTML 页面
- Commit：047ab12a
环境管理优化
工作流优化
- 改进内容：
- 优化开发工作流
- 优化后端策略（优先使用 SDK 直接调用数据库）
- Commit：9114b79b
🛠️ 基础设施
日志系统升级
配置同步优化
- 改进内容：
- 将 fix-config-hardlinks 脚本转换为 .mjs
- 添加 Skills 同步支持
- 添加目录清理功能（同步前）
- 改进脚本对规则的支持
- Commits：
配置同步到所有 IDE
🐛 问题修复
函数部署修复
- 修复内容：移除
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
- 更好的跨平台兼容性
- 改进的日志轮转和存储
影响：
- 日志格式保持不变
- 日志文件位置和命名规则不变
🎯 未来展望
即将到来的功能
- 更多技能模块：持续扩展技能体系，覆盖更多开发场景
- *智能代码生成...
v1.9.0 - Zero Dependency Publish Support
🚀 Major Features
Zero Dependency Publish Support
- ✨ Add zero-dependency publish support for @cloudbase/cloudbase-mcp
- 📦 Automatically remove dependencies from published package.json
- 🔧 Add publish scripts (prepare-publish.cjs, restore-deps.cjs, emergency-restore.cjs)
- ⚡ Improve installation speed and npx experience
- 🛡️ Enhanced error handling and automatic recovery mechanisms
Documentation
- 📝 Add comprehensive requirements spec for zero-dependency publish
- 📚 Add custom command definitions for Cursor IDE
- 🔗 Standardize AI assistant workflows
📋 Changes Since v1.8.40
Features
- feat(mcp): add zero-dependency publish support
- docs(cursor): add custom command definitions
- docs: update readme
- feat(config): add deployPrompt workflow for CloudBase deployment automation
- feat(docs): update README to English version and simplify OpenAI Codex CLI setup
Technical Details
- All dependencies are bundled via webpack
- Published packages have zero dependencies for faster installation
- Comprehensive test coverage for bundle quality
- Reference implementations from @anthropic-ai/claude-code and @tencent-ai/codebuddy-code
🔗 Links
AI Toolkit 1.8 全新升级
🚀 CloudBase AI ToolKit v1.8.40 升级日志
✨ 新功能亮点
🎉 AI CLI 集成 - 新增 CloudBase AI CLI，支持一键管理多种 AI 编程工具
☁️ 云托管插件 - 新增云托管后端服服务管理功能，查询、部署、运维一体化，支持多种后端语言
🤖 AI 数据建模 - 通过 Mermaid ER图智能创建 MySQL 数据模型
📋 工作流优化 - 新增 /spec 和 /no_spec 命令控制开发流程
🔐 安全规则管理 - 统一管理数据库、云函数、存储的安全规则
🎁 邀请码激活 - 支持 AI 编程用户邀请码激活功能
🔧 多 IDE 支持 - 新增 CodeBuddy、Qwen Code、OpenCode 等 IDE 支持
📝 认证规则优化 - 明确 Web 和小程序的认证方式差异
📊 函数日志 V2 - 升级到新版日志接口，支持按需查询详情
🛡️ 增强稳定性 - 遥测优化、Webpack 重构、错误处理改进
🎉 CloudBase AI CLI - 开发工具集成
🌟 核心优势
- 🏗️ 统一管理 - 一个命令管理多种 AI 编程 CLI 工具，无需在多个工具间切换
- 🤖 多模型支持 - 支持内置和自定义各种大模型，包括 Kimi K2、智谱 GLM-4.5 等
- 🚀 一键开发部署 - 从代码生成到云端部署的完整流程，支持 Web 应用、小程序、后端服务
- 🌍 无处不在 - 可在任意环境中运行，包括小程序开发者工具、VS Code、GitHub Actions 等
💻 快速开始
# 一键安装
curl https://static.cloudbase.net/cli/install/install.sh -fsS | bash
# 开始使用
tcb ai🎯 支持的 AI 工具
- Claude Code
- OpenAI Codex
- aider
- Qwen Code
- 其他主流 AI 编程工具
🔧 技术改进
- 优化日志系统，支持跨平台兼容性和竞态条件修复
- 增强遥测功能，改进错误跟踪和请求 ID 支持
- 重构构建系统，采用模块化 Webpack 配置
- 改进工具文档，增强可读性和参数说明
- 优化数据库工具，支持对象数组参数和嵌套 JSON
- 增强小程序调试工具和微信开发者工具集成
🐛 问题修复
- 修复 IDE 文件过滤问题，支持特定 IDE 类型
- 解决环境 ID 获取的循环依赖死锁问题
- 修复数据库工具参数序列化和语法错误
- 优化函数部署依赖安装配置
- 改进 README 保护机制和模板下载功能
📚 文档更新
- 新增插件系统文档和使用指南
- 优化 FAQ 和故障排除指南
- 增强教程和案例学习资料
- 更新 MCP 工具参考文档
🚀 升级指南
更新 MCP 工具
方法一：自动更新（推荐）
在你的 AI 开发工具的 MCP 列表中，找到 cloudbase 并重新启用或刷新 MCP 列表即可自动安装最新版本。
方法二：手动更新
如果自动更新不成功，可以先禁用再重新启用 cloudbase，或者重启你的 AI IDE。
方法三：使用最新版本
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["npm-global-exec@latest", "@cloudbase/cloudbase-mcp@latest"]
}
}
}更新项目规则
在项目中对 AI 说：
在当前项目中下载云开发 AI 规则，并强制覆盖
或者指定特定 IDE：
在当前项目中下载云开发 AI 规则，只包含 Cursor 配置，并强制覆盖
🙏 致谢
感谢所有贡献者为 CloudBase AI ToolKit 做出的贡献！
特别感谢社区用户提供的反馈和建议，让我们能够持续改进工具功能。
📞 获取帮助
⭐ 如果这个项目对你有帮助，请给我们一个 Star！
