开发实践

AI 开发

catchadmin 专业版文档-context7 如果正在使用任何一家 AI IDE 开发，例如codex， cursor 或者 claude code 等等。你都可以通过 context7 mcp 来协作开发。你只需要安装 context7 mcp，然后使用下面的 mcp 的配置。

// cursor 示例
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

在 cursor 配置如下图，则说明 mcp 成功了

目前我每次使用，都会先让 AI 通过 context7 mcp 查询文档即可，提示词如下。

请先通过 context7 mcp 查询 catchadmin 相关文档（这里可以是模型，可以其他功能）

Skills

如果需要使用 skills，需要更新核心包到 1.0.3，CatchAdmin 提供了一套非常健全的 Skills 开发技能用来开发。得分在 85+，相较于 MCP，skills 可以显著减少 token 消耗。可以使用下面给命令发布

php artisan catch:publish:skills

升级

项目交付后，建议使用 Git 管理代码。后续升级时，可以通过 Git 记录本地改动、创建升级分支、解决代码冲突。

首次下载代码后，可以先初始化仓库并提交一次初始版本：

git init
git add .
git commit -m "init project"

升级前先确认当前工作区状态：

git status

如果有本地改动，推荐先提交本地代码：

git add .
git commit -m "backup before upgrade"

也可以使用 stash 临时保存本地改动：

git stash push -u -m "backup before upgrade"

然后从当前分支创建一个升级分支，后续升级操作都在这个分支完成：

git checkout -b upgrade/v5.1.0

从官网下载对应版本的补丁包，并将补丁包放到项目根目录。假设补丁包名称为 xxxx.zip，执行升级命令：

php artisan catch:upgrade xxxx.zip

升级命令会将补丁包中的文件覆盖到当前升级分支。覆盖完成后，查看文件变更：

git status

如果升级前使用了 stash，此时恢复本地改动：

git stash pop

如果恢复本地改动或后续合并时出现冲突，根据 Git 标记解决冲突文件。冲突解决完成后，提交升级结果：

git add .
git commit -m "upgrade to v5.1.0"

确认项目可以正常运行后，将升级分支合并回开发分支。下面以 main 分支为例：

git checkout main
git merge upgrade/v5.1.0

如果项目主分支是 master 或其他分支名，请替换为实际分支名。