上下文
建立仓库地图、约束文件（.cursorrules / CLAUDE.md）和可验证的任务边界，减少模型猜测空间。
独立构建者 · 第 02 期
把 AI 产品
有章法地送上线。
给独立构建者与小团队：从提示词到生产环境，Vibe Coding 工程站关注可观测的工作流、清晰的 API 边界，以及上线前的每一个工程判断。
// 00 · 是什么
Vibe Coding 不等于「让 AI 乱写」。
由 Andrej Karpathy 提出的概念常被误解成"反正接受就好"。工程站的立场是：Vibe 只是入口，工程化才是出口。可观测、可回滚、可审计——这三件事决定了 AI 生成的代码能不能活到生产。
「我只是看一眼、说一句、跑一下，大多数时候就能跑起来。」
— Karpathy, 2025 → 对独立开发者和产品团队，这句话之后还要再加三件事：观察、验证、回滚。
// 01 · 工程体系
把「感觉能用」
变成「确实能交付」。
工程化的 Vibe Coding 不是跳过工程，而是把工程约束尽早交给模型、尽早交给团队。
契约
先定义 API 输入输出、权限、错误处理和成本上限，再写业务代码。契约先行是独立团队的"杠杆"。
信号
用日志、测试和人工审查确认每一次生成结果——而不是等用户投诉才知道上线出了问题。
// 02 · 实战配方
工程化配方
配方 / 001把 OpenAI 兼容 API 接入自家产品Base URL · 密钥 · 模型 · 流式响应 · 用量查看方案 →
配方 / 002让 AI Agent 在边界内执行任务权限 · 工具调用 · 审查门 · 回滚内部文档 →
配方 / 003上线前的成本与稳定性检查配额 · 重试 · 降级 · 可观测性内部文档 →
配方 / 004多模型路由：Claude / GPT / Gemini / DeepSeek路由 · 降级 · 成本分层 · 延迟查看方案 →
// 03 · API 栈 · 国内优先
直连 Anthropic / OpenAI 卡在三件事上
- 网络美西节点时延 300ms+，长上下文经常超时断流
- 支付国际卡 + 公司实体准入门槛，个人难直通
- 合规Key 突然封禁、账户审查、业务被动中断
Modb API 提供 OpenAI 兼容的中转网关：一个 base_url 对接 Claude / GPT / Gemini / DeepSeek 全家桶，人民币结算，国内节点低延迟，适合把海外模型"工程化"接入国内生产。
打开 Modb API ↗// 04 · 入门教材
完整入门教材
一次性打包。
从环境搭建、提示词工程到 API 接入、上线清单——我们把工程站的全部实战文档整理成一份教材，放在夸克网盘，持续更新。
- → 工具链安装（Cursor / Claude Code / Codex）
- → 提示词工程与 .cursorrules 模板
- → OpenAI 兼容 API 接入与多模型路由
- → 上线前的监控、成本、回滚清单
▶ 打开教材
Vibe Coding实战手册
// 05 · 边界
工程站的工程边界
适合推上线
- MVP、原型、内部工具
- 数据清洗、ETL、运维脚本
- Agent / 聊天机器人 / RAG
- 给已有系统叠加 AI 能力
需要谨慎
- 强合规领域（金融 / 医疗 / 支付）
- 核心算法与性能关键路径
- 生产密钥、用户隐私、鉴权体系
- 分布式一致性与状态机
// 06 · 上线自检
当所有信号转绿，
再上线也不迟。
先用小流量、可回滚的方式发布。模型地址和价格以服务提供方当前文档为准，密钥只放在服务端环境变量。
FIELD GUIDE
上线前的 20 分钟自检,比上线后两周救火便宜
"demo 能跑"和"生产能活"中间隔着一张清单。清单不长,但一条都不能跳过。
客户端侧设置 max_tokens、超时、重试次数;服务端侧设置每用户、每接口的 RPS 和日消耗上限。超过阈值直接拒绝,不要等账单来提醒你。
生产 Key 只在后端读取,前端一律通过自家接口中转。至少每 90 天轮换一次,监控 Key 的使用来源 IP。
新模型、新 prompt、新路由上线先走 5% 流量,观察 24 小时的失败率、延迟、成本再放量。所有变更都要能一键回滚到前一个版本。
PII 在入模前脱敏;对话和工具调用的日志留痕;模型供应商的 DPA 和数据驻留说明存档。Modb API 这类网关常用于把海外模型请求收口到国内可审计的链路里。