Flower Daily 是一个基于 Next.js 全栈开发的内容管理系统，专注于花卉及其花语的展示与管理。系统集成了 AI（DeepSeek/OpenAI）自动生成内容功能以及 Unsplash 图片搜索功能。
- 框架: Next.js 14+ (App Router)
- 语言: TypeScript
- 数据库 ORM: Prisma
- 数据库: SQLite (默认) / 可切换 PostgreSQL 或 MySQL
- 样式: Tailwind CSS
- UI 组件: Lucide React
- 外部服务:
- Unsplash API (图片搜索)
- OpenAI 兼容接口 (DeepSeek 等 AI 内容生成)
在开始部署之前，请确保您的环境满足以下要求：
- Node.js: v18.17.0 或更高版本
- 包管理器: npm, yarn, 或 pnpm
- 数据库:
- 本地开发默认为 SQLite（无需额外安装）。
- 生产环境建议使用 PostgreSQL 或 MySQL（需修改 Prisma 配置）。
git clone <repository-url>
cd flower-daily
npm install
# 或者
yarn install
# 或者
pnpm install
在项目根目录创建一个 .env 文件。您可以复制 .env.example（如果存在），或者直接创建：
# .env
# 数据库连接地址
# 如果使用 SQLite (默认):
DATABASE_URL="file:./dev.db"
# 如果使用 PostgreSQL:
# DATABASE_URL="postgresql://user:password@localhost:5432/flower_daily?schema=public"
# 如果代码中有使用到加密相关的密钥 (参考 lib/crypto.ts)
# 建议设置一个强随机字符串
NEXT_PUBLIC_APP_URL="http://localhost:3000"
使用 Prisma 初始化数据库表结构：
# 生成 Prisma Client
npx prisma generate
# 推送数据库结构 (开发环境)
npx prisma migrate dev --name init
由于系统有登录鉴权（app/login），您需要手动在数据库中创建一个初始用户，或者使用 Prisma Studio 进行操作：
npx prisma studio
- 在浏览器打开 Prisma Studio。
- 选择
User模型。 - 添加一条记录：
username: admin (或您喜欢的用户名)password: (注意：生产环境应存储哈希后的密码，但在开发初期如果 auth 逻辑较简单，请确认app/actions/auth.ts中的密码比对逻辑。如果是明文存储或简单加密，请直接填入；如果是 bcrypt，请填入哈希值)。roleId: (需先创建 Role 表数据，如code: admin)
npm run dev
访问 http://localhost:3000 查看应用。
由于本项目使用 Next.js，部署到 Vercel 是最简单的选择。
- 代码推送: 将代码推送到 GitHub/GitLab。
- 导入项目: 在 Vercel 面板导入该仓库。
- 环境变量: 在 Vercel 设置中添加
DATABASE_URL。
- 注意: Vercel Serverless 环境不支持本地 SQLite 文件的持久化。如果您部署到 Vercel，强烈建议将数据库切换为 PostgreSQL (如 Vercel Postgres, Supabase, Neon)。
- 构建命令: Vercel 会自动识别，通常为
npm run build。 - 部署: 点击 Deploy。
如果您希望部署在自己的服务器上（使用 SQLite 或其他数据库）：
- 构建项目:
npm run build
- 启动服务:
npm start
建议使用 pm2 来守护进程：
pm2 start npm --name "flower-daily" -- start
系统启动并登录后台后，请务必完成以下配置以启用完整功能：
访问路径：/admin/settings (假设路由)
为使用 Unsplash 图片搜索功能：
- 服务商: Unsplash
- Access Key: 填入您的 Unsplash Access Key
- Secret Key: 填入您的 Unsplash Secret Key
- 激活状态: 开启
为使用 AI 自动生成花语和信息：
- Base URL: 例如
https://api.deepseek.com/v1(或 OpenAI 地址) - API Key: 填入您的 API Key
- 模型名称: 例如
deepseek-chat或gpt-3.5-turbo - 激活状态: 开启
flower-daily/
├── app/ # Next.js App Router 页面与路由
│ ├── actions/ # Server Actions (后端逻辑)
│ ├── admin/ # 后台管理页面
│ ├── api/ # API 路由
│ └── ...
├── components/ # React 组件
│ ├── FlowerForm.tsx # 花卉录入表单
│ ├── BatchImport... # 批量导入组件
│ └── ...
├── lib/ # 工具库
│ ├── prisma.ts # 数据库实例
│ ├── crypto.ts # 加密工具
│ └── utils.ts # 通用工具
├── public/ # 静态资源
└── prisma/ # 数据库 Schema 与迁移文件
- 数据库类型:
prisma/schema.prisma默认配置为sqlite。若要切换数据库，请修改provider并更新.env中的DATABASE_URL格式。 - 安全性:
lib/crypto.ts用于加密存储敏感配置（如 API Key）。请确保生产环境密钥安全。 - 图片链接: 系统目前存储的是图片 URL (主要来自 Unsplash)。如果使用
BatchImport导入 Excel，请确保 Excel 模板格式正确。
- 数据库连接失败: 检查
DATABASE_URL是否正确配置，确保数据库服务已启动。 - API 调用失败: 确认
Base URL和API Key是否正确，检查网络连接。 - 图片加载失败: 检查 Unsplash Access Key 是否有效，或尝试刷新图片缓存。
- AI 响应失败: 确认模型名称是否正确，检查 API Key 是否有效。
- Windows 权限问题: 错误代码
os error 1314对应 Windows 的ERROR_PRIVILEGE_NOT_HELD，提示“客户端没有所需的特权”。
以下是解决此问题的几种方法，按推荐程度排序：
Windows 默认只允许管理员创建软链接。
- 关闭当前的终端或 VS Code。
- 右键点击 VS Code 图标或 PowerShell/CMD 图标。
- 选择 “以管理员身份运行”。
- 再次运行
npm run build。
开启开发者模式后，Windows 允许普通用户创建软链接，无需每次都用管理员权限。
- 打开 Windows 设置。
- 搜索 “开发者设置” (Developer settings)。
- 找到 “开发人员模式” (Developer Mode) 并将其开关打开。
- 重启终端，再次尝试构建。
日志显示你正在使用 Next.js 16.1.0 并且启用了 Turbopack (▲ Next.js 16.1.0 (Turbopack) )。虽然 Next.js 15/16 正在逐步推广 Turbopack，但如果它在你的环境中不稳定，可以尝试强制使用 Webpack 打包（通常是默认行为，除非你在 next.config.ts 或命令中开启了它）。
- 检查
package.json中的build脚本。如果是"build": "next build --turbo"，请去掉--turbo，改为"build": "next build"。 - 如果已经是
"build": "next build"，但 Next.js 16 默认启用了 Turbopack 导致问题，你可以尝试显式关闭它（目前通常默认是 Webpack，除非 Next.js 16 改变了策略或你在配置文件中开启了实验性选项）。
总结建议：
请先尝试 方法 1（以管理员运行） 或 方法 2（开启开发者模式），这通常能直接解决 os error 1314 问题。