烟雨
作品展示烟雨江南
用 Vibecoding 做的 Next.js 极简笔记 App，本地优先
SEO 成果：上线两周 Google 收录了 38 个页面，核心关键词排到了第二页。做了完整的 generateMetadata、sitemap.xml、robots.txt、JSON-LD 结构化数据。hreflang 配了中英双语，每页都有自引用和 x-default。内链结构是扁平化的，所有页...
6200
SEO 成果：上线两周 Google 收录了 38 个页面，核心关键词排到了第二页。做了完整的 generateMetadata、sitemap.xml、robots.txt、JSON-LD 结构化数据。hreflang 配了中英双语，每页都有自引用和 x-default。内链结构是扁平化的，所有页...
最花时间的是表单交互细节。每个表单字段都有输入约束预提示（长度/格式/范围），Zod 校验错误消息和 hint 文本保持一致，四态（加载/空/错误/成功）都有视觉反馈。破坏性操作（删除/清空）有二次确认弹窗，未保存变更离开有提醒。 认证系统踩了不少坑。Auth.js 5 beta 的 JWT ca...
部署流程：GitHub push → Vercel 自动构建 → Preview 环境 → 合并到 main → Production 环境。环境变量在 Vercel Dashboard 配置，区分 Production/Preview/Development。数据库迁移用 GitHub Actio...
上线后持续迭代，用 Vercel Analytics 监控流量和性能，用 Sentry 监控错误。每周看一次 Search Console 的搜索分析，根据关键词表现调整内容策略。用户反馈通过内置的反馈表单收集，高优需求直接排到下个迭代。 这个项目的 Admin 后台是独立认证体系，HMAC-SH...
用户反馈最积极的是暗色模式和加载体验。暗色模式用 next-themes 实现，CSS 变量控制配色。加载状态用 skeleton 骨架屏，比 spinner 体验好很多。表单提交用按钮 loading 状态 + toast 反馈，空状态有引导文案和插画。 安全方面做了：密码 bcrypt 哈希、...
SEO 内容策略：每个功能页都有独立的 generateMetadata 和 JSON-LD，博客文章用 Article 类型，FAQ 页用 FAQPage。sitemap.xml 用 ISR 缓存，发布新内容后 revalidatePath 主动刷新。长尾关键词页面用 AI 批量生成，每篇人工改写...
踩坑最深的莫过于 Server Component 中 cookies().set() 和 redirect() 不兼容的问题。一开始在 page.tsx 里设置 cookie 后 redirect，cookie 死活不生效。后来改成 Server Action 就好了。另外 next/dynami...
性能数据分享一下：PageSpeed 移动端 98 分，桌面端 100 分。LCP 0.9s，INP 86ms，CLS 0.02。关键优化是 LCP 图片用 next/image + priority，首屏不用 framer-motion 改用 CSS 动画，非首屏组件全部 next/dynamic...
用户反馈最积极的是暗色模式和加载体验。暗色模式用 next-themes 实现，CSS 变量控制配色。加载状态用 skeleton 骨架屏，比 spinner 体验好很多。表单提交用按钮 loading 状态 + toast 反馈，空状态有引导文案和插画。 性能对比：ISR vs SSR vs S...
数据库设计用了 Prisma + PostgreSQL，所有 DateTime 字段都加了 @db.Timestamptz。软删除用 deletedAt 字段，查询时自动过滤。索引方面，所有查询条件字段都加了 @@index，外键关系加了级联删除。迁移用 prisma migrate dev，生产用...
支付集成用的 Stripe，Webhook 处理订阅状态变更。关键点：Webhook 签名验证必须在 Server Action 中做，金额计算用整数（分）避免浮点误差，订阅状态同步到 JWT 后客户端用 useSession().update() 刷新。 最花时间的是表单交互细节。每个表单字段都...
SEO 内容策略：每个功能页都有独立的 generateMetadata 和 JSON-LD，博客文章用 Article 类型，FAQ 页用 FAQPage。sitemap.xml 用 ISR 缓存，发布新内容后 revalidatePath 主动刷新。长尾关键词页面用 AI 批量生成，每篇人工改写...
安全方面做了：密码 bcrypt 哈希、API 限流（认证 5 次/15min，通用 60 次/min）、CORS 只允许主域、禁止 dangerouslySetInnerHTML、环境变量分离 NEXT_PUBLIC_ 和服务端变量。XSS 和 SQL 注入 Prisma 天然防护。 性能数据分...
支付集成用的 Stripe，Webhook 处理订阅状态变更。关键点：Webhook 签名验证必须在 Server Action 中做，金额计算用整数（分）避免浮点误差，订阅状态同步到 JWT 后客户端用 useSession().update() 刷新。 用户反馈最积极的是暗色模式和加载体验。暗...
性能对比：ISR vs SSR vs SSG。我的选择是公共页面用 ISR（revalidate: 3600），用户页面用 SSR（个性化数据），认证页面用 SSG（表单页）。ISR 缓存安全要确保 SSR 输出对所有用户相同，不含 session 数据。 数据库设计用了 Prisma + Pos...
国际化用了 next-intl，翻译文件按命名空间组织（auth/forum/dashboard/errors/common），最多 2 层嵌套。ICU 插值用 {min}/{max} 占位符。中间件做 i18n 路由处理，URL 格式 /{locale}/...。所有用户可见文本都走 t()，没有...
技术架构上，Server Component 做数据获取和 SEO 输出，Client Component 只负责交互。用 Server Action 处理表单提交，Zod 校验输入，错误消息走 next-intl i18n。认证用 Auth.js 5 JWT 模式，中间件做认证重定向和 API 限...
性能数据分享一下：PageSpeed 移动端 98 分，桌面端 100 分。LCP 0.9s，INP 86ms，CLS 0.02。关键优化是 LCP 图片用 next/image + priority，首屏不用 framer-motion 改用 CSS 动画，非首屏组件全部 next/dynamic...
安全方面做了：密码 bcrypt 哈希、API 限流（认证 5 次/15min，通用 60 次/min）、CORS 只允许主域、禁止 dangerouslySetInnerHTML、环境变量分离 NEXT_PUBLIC_ 和服务端变量。XSS 和 SQL 注入 Prisma 天然防护。 踩坑最深的...
性能数据分享一下：PageSpeed 移动端 98 分，桌面端 100 分。LCP 0.9s，INP 86ms，CLS 0.02。关键优化是 LCP 图片用 next/image + priority，首屏不用 framer-motion 改用 CSS 动画，非首屏组件全部 next/dynamic...