上下文
建立仓库地图、约束文件（.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
OpenAI 兼容 API：三步从默认直连切到可控网关
多数 AI 客户端只需要你替换一个 Base URL、换一个 Key。真正难的不是接上去,而是接上去之后能不能通过审计、能不能回滚、能不能预算。
确认目标网关对 /v1/chat/completions、/v1/embeddings、/v1/messages 的覆盖情况,确认 stream 事件格式、工具调用字段与官方协议一致。协议对不上,后面的调优都是浪费。
API Key 只保留在服务端环境变量或密钥管理器;禁止提交到仓库、打进浏览器 bundle、出现在终端录屏或日志里。为每个环境、每个服务独立签发,出事只回收一把,不影响其他业务。
把客户端需要的"模型名"做成配置项而非硬编码,接入 claude-opus-4-7、gpt-5、gemini-2.5-pro、deepseek-v3 这类具体名字时,用环境变量承载并写好 fallback 顺序。
节点延迟 < 200ms、人民币结算与发票、按量计费与额度告警、SLA 与 Key 回收承诺。满足这四条才适合把海外模型接进国内生产;Modb API 常被用于验证这类接入链路。