更新日志
vibestrap 的最新进展。
v1.0.0
April 29th, 2026v1.0 —— 完整脚手架
这是 vibestrap 今天交付的全部内容。每一处面向客户的页面、每一个 provider 抽象、 每一个开发工具——一次购买,全部归你。永不再次收费,未来每一个版本都会自动归你。
认证
- Better Auth 1.4,邮箱 + 密码(含验证、重置、修改流程)
- Google OAuth、GitHub OAuth、Google One-Tap
user与admin双角色,含审计字段(lastLoginAt、IP、UA)
支付——三个 provider 一个接口
siteConfig.payment.enabled 可以同时启用多个 provider;
defaultProvider 决定裸 /checkout 走哪一家。
- Stripe —— 北美 / 欧洲首选
- Creem —— 中国大陆友好(支付宝 / 微信支付)
- NOWPayments —— 加密货币结算(BTC、ETH、USDC……)
订阅、一次性付款、积分包、幂等 webhook、多币种(美元 + 人民币)、客户门户—— 全部在所有 provider 上一致。
积分账本
四类(GRANT / CONSUME / EXPIRE / REFUND)不可变账本,
原子余额更新。每一笔积分变动都可审计。
AI 原语
六个 provider(1 个 mock + 5 个真实)在同一个 AIProvider 接口之后:
OpenRouter、OpenAI、Anthropic、Replicate、fal.ai,
外加一个确定性的离线 mock ——demo 不需要任何 key 就能跑。
AIManager 把每一次调用都包在积分守卫、token 预扣 + 结算、失败自动退款、
可选缓存、单步 provider fallback 之后。每次调用的可观测数据 ——
输入/输出 token(provider 返回则记录)、TTFT、总延迟、状态 —— 全部进入 ai_call 表。
4 个 hook —— useGeneration、useTask、useCredits、useHistory ——
加上一个 17 组件的 AI 原生 UI 库(TokenMeter、ChatBubble、
GenerationCard、ImageGallery、ModelPicker、StreamingText、
RegenerateButton……)。
我们故意不做美元成本仪表盘,也不做 Prompt 注册表 admin —— 实际账单的权威来源是 provider 后台,prompt UI 又因产品形态不同差异巨大,没法做出一个对所有买家都合适的起步骨架。
三个能跑的 demo
/demos/chat—— 流式对话,含模型选择/demos/image—— prompt → 4 张图,含延迟统计/demos/document—— 粘贴文档,提问
三个都默认走 mock provider。配上真实 key 即可切到生产模型。
增长与信任
- 在线客服 —— Crisp / Tawk.to / Intercom / Chatwoot
- Affiliate 推广 —— Affonso / Rewardful + 一个内置 provider, 兼容任意支付 provider
- Newsletter —— Beehiiv 双重确认
- 反机器人 —— Cloudflare Turnstile
分析
5 个 provider,全部条件加载、只在配置后才启用: Vercel Analytics、GA4、PostHog、Plausible、Umami。
Admin
/admin/usage—— 近 30 天按模型的 AI 调用、token、成功率、延迟/admin/users与/admin/orders运维
源码交付 —— 用 GitHub 邀请,不发 zip
买家付完款,去 /settings/purchases 填自己的 GitHub 用户名,服务端
就把他作为只读(pull)collaborator 加进你的私有 Org repo。
他 git clone 之后,后续每一个版本他 git pull 就拿到,永久免费。
三层架构,故意解耦:
src/github/invite.ts—— 薄薄的 API client,封装PUT /repos/{owner}/{repo}/collaborators/{username}src/actions/send-github-invite.ts——userActionClient门槛:必须有paid的payment记录才会调邀请src/app/[locale]/(app)/settings/purchases/github-invite-form.tsx—— 纯 UI,Sonner toast 对应每个 invite 返回码
只要一个 env:GITHUB_INVITE_TOKEN(fine-grained PAT,只授一个 repo)。
60 天轮换 runbook 在 docs/operations/github-invite-delivery.mdx。
内容与国际化
- 完全双语营销站(英 + 中,
as-neededlocale 前缀) - Fumadocs 驱动的
/docs/blog/changelog,含并列*.zh.mdx文件 - 每一篇文档都有中文版;中文内容不会渗到英文路由,反之亦然
打磨
- 自动生成 OG 图、sitemap、robots
- locale 感知 not-found、全局 error 边界、loading 状态
- 110 路由运行时 smoke + i18n 对齐校验 + Vitest 单测
- GitHub Actions CI(typecheck + lint + test + i18n + build),每次 push 都跑
部署
- Vercel —— push,设环境变量,部署。详见
DEPLOYMENT.md。 - Cloudflare Workers ——
wrangler.toml.example+ OpenNext 适配, 含 serverless Postgres 连接池注意事项。