企业官网建设流程全解析

🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度

1. 任务目标与产物：在已有 Postgres schema 的仓库里生成 Prisma migration

本文要解决的问题很具体：一个已经跑着 Postgres 的仓库，schema.prisma里已经有一批模型，现在需要新增字段、调整索引、补上关系，然后让 Roo Code 在 Agent 模式下直接产出可执行的 Prisma migration 文件，而不是只给一段“建议 SQL”。模型选用 Kimi K2.7 Code，通过 TaoToken 提供 Key 与 Base URL，Roo Code 在调用模型时消耗 Token。TaoToken 官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= ，API 地址固定为 https://taotoken.net/api 。

产物有三样：一是 Roo Code 的 provider 配置片段，二是prisma/migrations/下真实生成的 migration 目录与migration.sql，三是可复现的验证命令。整条链路不依赖手工写 SQL，也不依赖“先改 schema 再凭记忆补迁移”的土办法。Roo Code 在这里扮演的是带文件读写能力的 Agent，它需要读schema.prisma、读现有 migration 历史、写新 migration 文件，并在必要时调用终端执行prisma migrate dev或prisma migrate diff。

需要提前说明的是，本文不含任何排行分数，也不对模型做跑分对比。Kimi K2.7 Code 的选择依据是它在代码补全与多文件编辑上的稳定性，以及通过 TaoToken 调用时的响应一致性。具体价格、可用模型列表、上下文长度以 TaoToken 官网当前页面为准，本文不复制可能过期的数字。

2. 操作步骤：从创建 Key 到 Roo Code 发出第一条迁移指令

第一步是在 TaoToken 官网创建 API Key。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= ，进入控制台后创建 Key，复制保存。这个 Key 只用于 Roo Code 的 provider 配置，不写进仓库任何文件。

第二步是确认仓库现状。假设仓库结构如下：

repo/ ├── prisma/ │ ├── schema.prisma │ └── migrations/ │ ├── 20240101000000_init/ │ │ └── migration.sql │ └── migration_lock.toml ├── package.json └── .env

schema.prisma里已有User、Post两个模型，现在要新增Comment模型，并给Post加publishedAt字段与索引。目标不是手写 SQL，而是让 Roo Code 读 schema、读历史迁移、生成新迁移。

第三步是安装并启动 Roo Code。Roo Code 作为 VS Code 扩展安装后，在侧边栏打开，切换到 Agent 模式。此时先不急着发任务，先把 provider 配好，否则 Agent 会在调用模型时直接报鉴权错误。

第四步是准备一条足够明确的 Agent 指令。指令里要包含三件事：要改的模型、要加的字段与索引、以及“生成 migration 文件而不是只给 SQL”的硬性要求。示例指令如下：

在当前仓库中完成以下 Prisma schema 变更，并生成对应的 migration 文件： 1. 新增 Comment 模型，字段 id、content、createdAt、authorId、postId，其中 authorId 关联 User.id，postId 关联 Post.id。 2. 给 Post 模型新增 publishedAt DateTime? 字段，并添加 @@index([publishedAt])。 3. 不要手工写 migration.sql，使用 prisma migrate dev --create-only 生成迁移目录后再检查内容。 4. 完成后输出 migration 目录路径与 migration.sql 内容。

这条指令的关键在于第 3 点：--create-only让 Prisma 只生成迁移文件而不立即应用，Agent 可以在写入后继续检查 diff，避免直接改库。Roo Code 在 Agent 模式下会依次读取schema.prisma、列出migrations/目录、修改 schema、执行终端命令、读取生成的migration.sql，最后把结果回传。

如果仓库里已有未提交的 schema 改动，建议先git stash或提交，否则 Agent 读到的 schema 与迁移历史可能不一致，生成的迁移会包含意外变更。

3. TaoToken 接入与配置：Roo Code provider 片段与 Base URL

Roo Code 的模型 provider 配置在设置页完成，核心是三项：API Provider 选 OpenAI Compatible，Base URL 填https://taotoken.net/api，API Key 填 TaoToken 控制台创建的 Key。模型 ID 填 Kimi K2.7 Code 对应的 ID，具体 ID 以 TaoToken 官网模型列表为准。

配置完成后，Roo Code 的设置会落盘到 VS Code 的全局配置里。对应的 provider 片段大致如下（不同版本字段名可能略有差异，以实际设置为准）：

{ "rooCode.provider": "openai", "rooCode.openaiBaseUrl": "https://taotoken.net/api", "rooCode.openaiApiKey": "YOUR_TAOTOKEN_API_KEY", "rooCode.openaiModelId": "kimi-k2.7-code", "rooCode.agentMode": true, "rooCode.autoApproval": { "readFiles": true, "writeFiles": true, "executeCommands": false } }

这里有两个细节值得注意。第一，executeCommands建议先设为false，让 Agent 在需要执行prisma migrate dev时弹出确认，人工看一眼命令再放行；确认链路稳定后再考虑放开。第二，Base URL 必须带/api，不要写成首页地址，否则请求会打到错误路径。

如果同时使用 Claude Code 或 Codex，配置方式不同：Claude Code 走settings.json里的ANTHROPIC_BASE_URL与ANTHROPIC_API_KEY，Codex 走config.toml。Roo Code 本身不读这两个文件，它只认自己的 provider 设置。若用 CC Switch 管理多套配置，注意三件套（provider、Base URL、Key）要成套切换，避免 Key 与 Base URL 来自不同通道。

配置完成后，在 Roo Code 里发一条最小测试指令，例如“读取 package.json 并告诉我 prisma 版本”，确认模型能正常返回。若返回 401，检查 Key 是否复制完整；若返回 404，检查 Base URL 是否漏了/api或多了斜杠。排障时优先看 Roo Code 的输出面板，那里会打印实际请求地址。

4. 可验证结果与失败分支：migration diff 与验证命令

Agent 执行完成后，仓库里应出现新的迁移目录，例如：

prisma/migrations/20250612093000_add_comment_and_published_at/ └── migration.sql

migration.sql的内容应包含CREATE TABLE "Comment"、ALTER TABLE "Post" ADD COLUMN "publishedAt"、CREATE INDEX等语句。一个典型的 diff 片段如下：

-- CreateTable CREATE TABLE "Comment" ( "id" SERIAL NOT NULL, "content" TEXT NOT NULL, "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, "authorId" INTEGER NOT NULL, "postId" INTEGER NOT NULL, CONSTRAINT "Comment_pkey" PRIMARY KEY ("id") ); -- AlterTable ALTER TABLE "Post" ADD COLUMN "publishedAt" TIMESTAMP(3); -- CreateIndex CREATE INDEX "Post_publishedAt_idx" ON "Post"("publishedAt"); -- AddForeignKey ALTER TABLE "Comment" ADD CONSTRAINT "Comment_authorId_fkey" FOREIGN KEY ("authorId") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE; ALTER TABLE "Comment" ADD CONSTRAINT "Comment_postId_fkey" FOREIGN KEY ("postId") REFERENCES "Post"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

验证命令分三层。第一层是 schema 校验：

npx prisma validate

第二层是迁移状态检查，确认新迁移已被识别但未应用：

npx prisma migrate status

第三层是实际应用并生成客户端：

npx prisma migrate dev npx prisma generate

如果只想看 diff 而不落盘，可以用：

npx prisma migrate diff \ --from-migrations prisma/migrations \ --to-schema-datamodel prisma/schema.prisma \ --shadow-database-url $SHADOW_DATABASE_URL

失败分支主要有四类。第一类是 Agent 只输出了 SQL 而没有写文件，此时检查指令里是否明确要求“生成 migration 文件”，并确认writeFiles自动批准是否开启。第二类是迁移历史与 schema 不一致，prisma migrate status会提示 drift，需要先prisma migrate resolve或重建 shadow database。第三类是外键顺序错误，migration.sql里先建Comment后建User引用会失败，Prisma 通常会自动排序，但手工干预后可能打乱。第四类是 Token 消耗异常，长上下文仓库里 Agent 反复读文件会推高消耗，建议在指令里限定读取范围，例如“只读 prisma 目录与 package.json”。

5. 限制、成本与模型选择：以官网为准

Roo Code 的 Agent 能力有边界。它能读文件、写文件、执行命令，但不等于能替代数据库管理员。涉及数据回填、大表加索引、并发写入的迁移，仍需要人工评估锁表风险。prisma migrate dev适合开发环境，生产环境应走prisma migrate deploy，且迁移文件要经过 review。

成本方面，TaoToken 按 Token 计费，具体单价、免费额度、模型可用性以官网当前页面为准。Kimi K2.7 Code 在代码任务上的表现与上下文长度相关，仓库越大，Agent 读取的文件越多，Token 消耗越高。控制成本的做法包括：在指令里限定文件范围、关闭不必要的自动读取、把大仓库拆成子目录任务。

模型选择上，本文只使用 Kimi K2.7 Code 一条路径，不对其他模型做横向评测。若需要切换模型，在 Roo Code 的 provider 设置里改模型 ID 即可，Base URL 与 Key 不变。切换后建议先用小任务验证响应格式，再跑迁移任务。

需要再次强调，本文不含排行分数，也不引用任何榜单数据。所有关于模型能力、价格、可用性的描述，均以 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_generate&utm_medium=csdn&utm_campaign=generate&utm_content= 当前展示为准。接入与排障相关的文档入口在 https://taotoken.net/api ，Key 管理在控制台完成。若后续需要长期跑 Agent 任务，可以关注 Coding Plan 相关页面；若只是临时接入与排障，优先看 API Keys 与接入文档。

最后给一条实践建议：把 migration 生成任务拆成“先 create-only 生成、再人工 review、最后 migrate dev 应用”三步，Roo Code 负责第一步与第三步的命令执行，人工负责中间 review。这样既保留了 Agent 的效率，也避免了自动应用迁移带来的不可逆风险。

🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度