开发实践

AI 开发

catchadmin 专业版文档-context7 如果正在使用任何一家 AI IDE 开发，例如 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 相关文档（这里可以是模型，可以其他功能）

升级

下载代码之后，首先需要使用 git 初始化你的仓库。初始化仓库是为了能够跟踪代码变更，方便后续的升级和团队协作。

git init

git 初始化之后会有一个默认分支，这个分支是你自己的主分支（通常是 master 或 main）。然后需要 checkout 一个特殊的分支出来，就叫 catch 分支。这个分支名称是项目特定的，用于接收官方更新。

git checkout -b catch

这个 catch（这是示例分支，可以根据实际用其他名称） 分支主要用来升级，不做任何业务开发。创建完成后，你应该立即切回到自己的 master 分支。在 master 分支上进行业务开发，或者从 master 分支再切出其他功能分支进行开发都可以。重要的是不要在 catch 分支上进行任何业务代码的修改，保持它的纯净性，这样才能顺利接收官方更新。

当官方发布新版本时，你需要到官网下载对应的 patch 包。这些补丁包包含了从当前版本到新版本的所有代码变更。下载完成之后，把补丁包放到项目根目录，然后切换到 catch 分支，使用下面的命令应用补丁：

# 首先切换到catch分支
git checkout catch

# 应用补丁文件，--whitespace=nowarn参数可以忽略空白字符的警告
php artisan catch:upgrade xxx.zip(补丁文件)

这个命令会将补丁中的所有变更应用到 catch 分支。应用完成后，你需要检查是否有冲突或错误。确认无误后，再切回到你的开发分支（这里以 master 为例），并将 catch 分支的变更合并进来：

# 切换回开发分支
git checkout master

# 合并catch分支的变更
git merge catch

这样就完成了项目升级。如果合并过程中出现冲突，你需要手动解决这些冲突，确保合并后的代码能够正常工作。合并完成后，建议运行项目测试，确认升级没有引入新的问题。