更新日誌

调整首页渲染结构，降低首屏 JS 与水合成本，同时保留动效与视觉质感。

性能架构

• Hero 拆为 Server 结构 + Client 交互岛（输入、验证、提示）
• 星空背景改为 Server 渲染并保留纯 CSS 动画
• landing 动画改为轻量 Reveal/CSS 过渡，替代 framer-motion

互动体验调整

• 牌阵入口改为链接跳转，折叠区改为原生 details
• 统计数字保留客户端小组件更新
• 验证弹窗与提示轮播改为 CSS 动画

相关文件

• src/themes/default/blocks/tarot-hero.tsx
• src/themes/default/blocks/tarot-hero-client.tsx
• src/themes/default/blocks/feature-showcase.tsx
• src/themes/default/blocks/feature-showcase-count.tsx
• src/themes/default/blocks/trust-features.tsx
• src/themes/default/blocks/comparison.tsx
• src/themes/default/blocks/testimonials.tsx
• src/themes/default/blocks/cta-line.tsx
• src/shared/components/ui/reveal.tsx
• src/components/tarot-ui/StarBackground.tsx
• src/components/ui/RotatingHint.tsx
• src/components/ui/QuestionValidationModal.tsx
• src/config/style/global.css

强化部落格内容管理与呈现，补齐后台功能，并加入内容维护脚本。

后台功能

• 文章与分类新增关键词搜索
• 文章新增/编辑支持标签（tags）

详情页版式

• 作者名称与发布时间放在同一行
• 移除右侧作者卡片，阅读区域更集中

内容维护

• 新增导入、日期重排、同步回文件的脚本
• 文章发布时间分散到过去 6 个月，含 2026 的内容集中在 2025 年 12 月

相关文件

• src/app/[locale]/(admin)/admin/posts/page.tsx
• src/app/[locale]/(admin)/admin/posts/add/page.tsx
• src/app/[locale]/(admin)/admin/posts/[id]/edit/page.tsx
• src/app/[locale]/(admin)/admin/categories/page.tsx
• src/shared/models/post.tsx
• src/shared/models/taxonomy.ts
• src/themes/default/blocks/blog-detail.tsx
• scripts/import-blog.ts
• scripts/redistribute-blog-dates.ts
• scripts/sync-blog-dates-to-files.ts

成功将朱莉安塔羅部署到 Vercel 生产环境，配置自定义域名。

部署概要

• 域名: juliantarot.com (Namecheap)
• 平台: Vercel Edge Runtime
• AI 服务: OpenRouter (Gemini 2.5 Flash)

主要变更

Edge Runtime API 密钥修复

修复了生产环境 AI 功能无法使用的关键问题。根本原因是环境变量在模块加载时（构建时）被读取，导致 Edge Runtime 中 API 密钥为空。

修复前（错误）:

export const OPENROUTER_API_KEY = process.env.OPENROUTER_API_KEY || "";

修复后（正确）:

export const getOpenRouterApiKey = () => process.env.OPENROUTER_API_KEY || "";

修改的文件

• src/lib/ai-gemini.ts - 改为运行时函数导出
• src/app/api/reading/interpret/route.ts - 运行时读取 API 密钥
• src/app/api/reading/followup/route.ts - 运行时读取 API 密钥
• src/app/api/validate-question/route.ts - 运行时读取 API 密钥

环境变量配置

生产环境必需的环境变量：

• OPENROUTER_API_KEY - AI 服务 API 密钥
• DATABASE_URL - PostgreSQL 连接字符串
• AUTH_SECRET - 认证加密密钥
• NEXT_PUBLIC_APP_URL - 生产环境 URL (https://juliantarot.com)

验证结果

• 本地和云端代码已确认完全一致
• 环境变量是两个环境之间的唯一差异
• AI 流式响应功能已在生产环境确认正常工作

ShipAny Two 基于最新的 Next.js 16，在编译性能方面有很大提升，本地开发更快、内存占用更小。

快速开始

git clone git@github.com:shipanyai/shipany-template-two.git

ShipAny Two 文档

ShipAny 是一个基于 NextJS 的 AI SaaS 开发框架，内置丰富的组件和 AI SDK，帮助你快速完成 AI SaaS 项目开发。

快速开始

git clone git@github.com:shipanyai/shipany-template-one.git

ShipAny One 文档