上下文
建立仓库地图、约束文件（.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
Agent 不是全能员工:它只应能做你写进白名单的事
工具调用的本质是"把生产权限暂借给模型"。工程化的做法是把白名单、沙箱、审查门和回滚一起设计——而不是上线后再去兜底。
任何写入、执行、网络请求都从拒绝开始。只有在白名单中的工具+参数模式才允许执行,其余一律转审查门。工具描述里要写清楚"能做什么、不能做什么"。
让 Agent 把目标修改以 patch 的形式输出,先在隔离目录应用,跑测试通过再 commit。永远不要让 Agent 直接改生产密钥、CI 配置、鉴权中间件。
限定可用命令、工作目录和超时;禁用 curl 到任意域名、禁用 rm -rf 和 git push --force。失败要能自动回滚到入站前状态。
把每一次工具调用、每一次模型请求、每一次 diff 应用都写进可查询的日志。Modb API 这类网关可以统一收口模型侧日志,配合客户端侧日志形成完整链路。