企业官网建设流程全解析

1. 从 Cursor Projects 的协调者调度说起：先给子智能体做额度分层

在 Cursor Projects beta 里，协调者智能体不直接写补丁，它把功能开发、迁移和持续维护拆给执行型子智能体并行跑。先到 TaoToken 官网 领取 TaoToken Key，再把 Cursor 自定义模型的 Base URL 指向 https://taotoken.net/api，你才能给这些子智能体做额度分层。否则你会遇到典型现象：协调者刚拆出 30 个任务，迁移子智能体把并发拉满，功能开发子智能体开始 429；或者维护子智能体半夜跑清理，第二天发现高优先级验证任务没有预算。本文把这件事拆成可跟做的步骤：领取 Key、配置自定义模型、定义子智能体额度池、生成额度表、处理 401/429/上下文超限，最后给出一套可复用的分层 Key 与周边工具配置。你最终会得到两份东西：quota-policy.json 和一张能贴进项目 README 的额度表。

2. 领取 TaoToken Key：让 Cursor Projects 的自定义模型只有一个出口

先不要急着在 Cursor 里加多个模型。额度治理的第一原则是“入口统一”。打开 TaoToken 官网，完成注册并进入控制台，在 API Keys 页面创建一把本文示例要用的 Key，复制时只保留一次，后面所有示例都用 YOUR_API_KEY 代替。若你还没有决定用哪类模型，先在模型对话里发一条最小请求验证账号可用，再回来创建 Key。

Cursor 侧配置步骤：

1. 打开 Cursor Settings → Models。
2. 如果你的版本有 OpenAI API Key / Override OpenAI Base URL，填入：
   • API Key: YOUR_API_KEY
   • Base URL: https://taotoken.net/api
3. 如果你的版本是 Custom Model / OpenAI Compatible，Provider 选 OpenAI Compatible，Base URL 同样填 https://taotoken.net/api，模型名先填 YOUR_MODEL_ID。
4. 在 Cursor Projects 中，先把协调者智能体和执行子智能体都指向这个 Provider，但不要给它们同一个并发上限。额度分层从下一步开始。
5. 保存后不要立刻开大任务。先在 Projects 里创建一个只有 README 说明的小任务，让协调者拆出 2 到 3 个子任务，确认请求能通。

验证时注意：Base URL 不要带 UTM 参数，也不要写成官网首页地址。工具配置里的 Base URL 就是 https://taotoken.net/api。如果你把带查询参数的页面地址填进去，常见结果就是 401 或 404。

本地可以用环境变量先做一次最小检查，命令在你自己的机器执行：

export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_API_KEY="YOUR_API_KEY" printf 'base=%s\nkey_prefix=%s\n' "$TAOTOKEN_BASE_URL" "${TAOTOKEN_API_KEY:0:6}"

这条命令只检查变量有没有写对，不直接连生产库，也不执行任何 SQL。真正发请求交给 Cursor 或你信任的兼容客户端。

3. 子智能体额度分层：协调者、执行者、验证者不要共用一个池

Cursor Projects 的调度模式决定了额度不能只按“模型”分。协调者虽然调用次数少，但它决定任务拆解质量；功能开发执行子智能体数量多、上下文变化快；迁移子智能体容易长时间占用大上下文；持续维护子智能体适合低优先级、可中断；验证子智能体需要稳定的小额度窗口。建议至少分五层：coordinator、feature_worker、migration_worker、maintenance_worker、verifier。

分层依据：

• 角色：协调者、执行者、验证者。
• 任务类型：功能开发、迁移、持续维护。
• 并发：协调者低并发，执行者可弹性，验证者独立。
• 上下文：迁移和重构通常更大，维护和验证更小。
• 优先级：协调者最高，验证其次，维护最低。

下面这份 quota-policy.json 可以直接作为团队初始模板。金额先用 token 预算占位，你按实际套餐和项目量调整。

{ "version": 1, "unit": "tokens", "pools": { "coordinator": { "role": "协调者", "monthly_limit": 1200000, "max_concurrency": 2, "max_context_tokens": 120000, "priority": 100, "model_alias": "taotoken-coordinator" }, "feature_worker": { "role": "功能开发执行子智能体", "monthly_limit": 18000000, "max_concurrency": 24, "max_context_tokens": 64000, "priority": 70, "model_alias": "taotoken-feature" }, "migration_worker": { "role": "迁移执行子智能体", "monthly_limit": 8000000, "max_concurrency": 8, "max_context_tokens": 96000, "priority": 60, "model_alias": "taotoken-migration" }, "maintenance_worker": { "role": "持续维护执行子智能体", "monthly_limit": 4000000, "max_concurrency": 12, "max_context_tokens": 48000, "priority": 40, "model_alias": "taotoken-maintenance" }, "verifier": { "role": "验证子智能体", "monthly_limit": 3000000, "max_concurrency": 16, "max_context_tokens": 32000, "priority": 80, "model_alias": "taotoken-verifier" } }, "fallback": { "on_401": "停止新子智能体，检查 Key 与 Base URL", "on_429": "按优先级降并发，维护任务先暂停", "on_context_exceeded": "拆分任务包，只保留相关文件摘要", "on_budget_low": "禁止启动新迁移任务，保留验证额度" } }

把它保存到项目根目录，用下面脚本生成本地额度表。脚本只读本地 JSON，不连接外部服务。

import json from pathlib import Path policy_path = Path("quota-policy.json") data = json.loads(policy_path.read_text(encoding="utf-8")) pools = data["pools"] print("| 层级 | 角色 | 月度 Token 预算 | 最大并发 | 上下文上限 | 优先级 | 模型别名 |") print("| --- | --- | ---: | ---: | ---: | ---: | --- |") for name, pool in pools.items(): print( f"| {name} | {pool['role']} | {pool['monthly_limit']:,} | " f"{pool['max_concurrency']} | {pool['max_context_tokens']:,} | " f"{pool['priority']} | {pool['model_alias']} |" ) total = sum(pool["monthly_limit"] for pool in pools.values()) print(f"\n总预算：{total:,} tokens")

执行：

python validate_quota.py > quota-table.md

生成的额度表可以直接贴进团队文档。初始版本如下：

这张表解决的是“谁可以花多少、并发多高、上下文多长、没额度时谁先停”。如果你只有一个 Key，也能用模型别名和任务标签在应用层记账；如果 TaoToken 控制台允许创建多把 Key，建议按层拆 Key：cursor-coordinator、cursor-feature、cursor-migration、cursor-maintenance、cursor-verifier。创建入口放在文末 CTA，先不要一次创建十几把，先按五层跑一周再调整。

4. 把分层策略挂到 Cursor Projects：模型别名、并发闸门、任务标签

配置好 Base URL 后，Cursor Projects 仍然会把任务交给协调者。此时要做的是让协调者“带着额度信息拆任务”。不要让协调者一次性生成无上限的子任务列表，而是让每个子任务带上 pool、priority、max_context、ttl 四个字段。一个可复制的任务包格式如下：

{ "task_id": "feature-20250612-001", "pool": "feature_worker", "priority": 70, "max_context_tokens": 64000, "ttl_minutes": 45, "allowed_paths": ["src/features/", "tests/feature/"], "forbidden_paths": ["migrations/", "infra/"], "acceptance": ["unit_test_pass", "diff_review_pass"] }

协调者负责生成这种任务包，执行子智能体只能在自己的 pool 和 allowed_paths 内工作。迁移任务使用 migration_worker，持续维护任务使用 maintenance_worker。验证子智能体只读 diff 和测试结果，不写业务文件。

并发闸门放在任务队列层，而不是只靠模型端限流。一个简单的本地闸门逻辑可以写成：

from collections import defaultdict active = defaultdict(int) limits = { "coordinator": 2, "feature_worker": 24, "migration_worker": 8, "maintenance_worker": 12, "verifier": 16, } def can_start(pool: str) -> bool: return active[pool] < limits[pool] def start(pool: str) -> None: if not can_start(pool): raise RuntimeError(f"{pool} 并发已满，按优先级排队") active[pool] += 1 def finish(pool: str) -> None: active[pool] = max(0, active[pool] - 1)

这段代码不调用外部 API，只用于说明闸门位置。真正落地时，把 start/finish 放到你的任务调度器里。这样即使 Cursor Projects 一次拆出很多子任务，迁移池也不会把功能开发池的并发吃光。

模型别名要和池对应。如果 Cursor 自定义模型只允许填一个模型名，就先填通用模型名，再在任务包中通过 pool 做应用层限流。如果允许配置多个模型入口，则按下面映射：

• coordinator → taotoken-coordinator
• feature_worker → taotoken-feature
• migration_worker → taotoken-migration
• maintenance_worker → taotoken-maintenance
• verifier → taotoken-verifier

每个别名背后可以是同一把 TaoToken Key，也可以是不同 Key。关键不是别名本身，而是额度、并发、上下文三个数字必须分开。

5. 排障：401、429、上下文超限、子智能体空转时怎么按层降级

Cursor Projects beta 的子智能体并发一高，问题会集中出现。下面按报错处理。

401 未授权：

• 检查 Cursor 自定义模型里填的是 YOUR_API_KEY，不是官网登录密码。
• 检查 Base URL 是 https://taotoken.net/api，没有多余路径、没有 UTM 参数、没有尾部空格。
• 如果 Cursor 版本会在 Base URL 后自动追加路径，先用最小任务验证，不要直接开迁移。
• 分层 Key 场景下，确认当前 pool 对应的 Key 没有过期或被禁用。

429 限流或额度触顶：

• 先降 maintenance_worker，它最适合暂停。
• 再降 migration_worker 并发，把大迁移拆成小批次。
• coordinator 和 verifier 保留最低并发，避免整个 Projects 无法汇总和验证。
• 检查是否多个子智能体共用同一把 Key，却各自按 24 并发跑。如果是，改成按层分 Key 或应用层共享并发计数。

上下文超限：

• 迁移任务最容易触发。把任务包拆成“扫描、生成变更、验证”三段。
• 只给子智能体相关文件摘要，不要把整个仓库塞进上下文。
• 对持续维护任务设置更低的 max_context_tokens，例如 32K 到 48K。
• 验证子智能体只读 diff、测试日志和接口签名，不读全量实现。

子智能体空转或重复写同一文件：

• 给任务包加文件锁或 allowed_paths，防止两个执行子智能体改同一文件。
• 验证子智能体只读，不参与写操作。
• 协调者汇总时去重，发现同一路径多个补丁就回退到串行。

额度表落地时要记录每次降级。建议在任务结果里回传：

{ "task_id": "feature-20250612-001", "pool": "feature_worker", "usage_tokens": 45210, "context_peak": 58000, "retries": 1, "fallback": "none", "status": "success" }

把 usage_tokens 按 pool 累加，你就能知道哪个层最先把预算吃满。不要在子智能体里直连生产库执行 SQL；如果需要数据库变更，让迁移子智能体生成脚本，由读者或流水线本地审核后执行。

6. 同一把 TaoToken Key 在 Claude Code、Codex、CC Switch 的复用配置

Cursor Projects 是主调度器，但团队通常还会用 Claude Code、Codex、CC Switch。这里要分开配置，不要把 Anthropic 的环境变量套到 Codex。

Claude Code 使用 settings.json。把 Base URL 指向 TaoToken，Key 用 YOUR_API_KEY：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID", "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_SMALL_MODEL_ID" } }

如果你的 Claude Code 版本读取 ~/.claude/settings.json，就把上面内容合并到已有 env 节点。ANTHROPIC_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL 按你账号可用模型替换。

Codex 使用 config.toml，单独定义 provider。它不使用 ANTHROPIC_*：

model = "YOUR_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat" [profiles.taotoken] model = "YOUR_MODEL_ID" model_provider = "taotoken"

然后在本地设置：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

CC Switch 三件套按 Claude Code 的字段填，不要填成 Codex：

• 配置名称：TaoToken
• ANTHROPIC_BASE_URL：https://taotoken.net/api
• ANTHROPIC_AUTH_TOKEN：YOUR_API_KEY
• ANTHROPIC_MODEL：YOUR_MODEL_ID

如果你的 CC Switch 界面只显示 Base URL、API Key、Model 三栏，就对应填 https://taotoken.net/api、YOUR_API_KEY、YOUR_MODEL_ID。切换后先跑一条最小请求，再切回 Cursor Projects。这样 Cursor Projects、Claude Code、Codex 用的是同一套 TaoToken 出口，但配置文件互不污染。

7. 额度表落地：日报、告警、回收与再分配

子智能体额度治理不是设完数字就结束。建议每周至少做一次回收和再分配。指标包括：

• 每层 token 使用量与预算占比。
• 每层并发峰值与 429 次数。
• 上下文峰值与超限拆分次数。
• 子任务成功率、重试率、平均耗时。
• 迁移任务与维护任务的单位产出成本。

日报模板可以这样写：

告警阈值建议：

• 单层使用率达到 80%：只允许高优先级任务进入。
• 单层使用率达到 90%：暂停低优先级 pool，保留 coordinator 和 verifier。
• 429 在 10 分钟内超过 3 次：自动把 maintenance_worker 并发减半。
• 迁移任务上下文峰值连续超过 80K：强制拆包。

回收与再分配规则：

• feature_worker 连续两周使用率低于 50%，把 20% 预算转给 verifier。
• migration_worker 临时峰值高，可以从 maintenance_worker 借额度，但要在周末归还。
• coordinator 预算不轻易削减，它是防止任务发散的控制层。
• 维护任务适合放到低峰时段，避免和功能开发抢并发。

如果你还没有创建分层 Key，可以到 TaoToken 官网 控制台先建一把主 Key，等额度表跑通后再拆。拆 Key 时保持命名一致：cursor-coordinator、cursor-feature、cursor-migration、cursor-maintenance、cursor-verifier。这样从 Cursor Projects 日志、TaoToken 控制台和本地额度表三处能对上。

8. 文末 CTA：按顺序把 TaoToken 接入你的 Cursor Projects

如果你已经决定把 Cursor Projects 的子智能体额度管起来，按下面顺序操作：

1. 先用 模型对话 发一条最小请求，确认模型可用。
2. 需要稳定并发和分层额度时，查看 Coding Plan。
3. 到 API Keys 创建 YOUR_API_KEY，并按五层拆 Key。
4. Claude Code 侧配置参考 Claude Code 文档。

最后回到 Cursor Settings → Models，把自定义模型 Base URL 指向 https://taotoken.net/api，填入 YOUR_API_KEY，再运行本文的 quota-policy.json 脚本生成额度表。先让协调者和验证者跑通，再放功能开发、迁移和维护子智能体进场。额度分层不是限制并发，而是让高优先级任务在并发洪峰里仍然有预算可用。