使用 opencode + deepseek-v4-flash 编写的个人博客
Access rate limit exceeded. Please log in to continue.
个人博客
前后端分离的个人博客项目,支持前台访客浏览与后台管理员管理。
项目结构
blog/
├── blog-frontend/ # 前端项目(Vue 3)
├── blog-server/ # 后端项目(Hono + TypeScript)
└── 开发文档.md # 详细开发文档
技术栈
| 层级 | 技术 |
|---|---|
| 前端框架 | Vue 3(组合式 API + <script setup>) |
| 构建工具 | Vite |
| 前台样式 | Tailwind CSS 3 |
| 后台 UI | Element Plus |
| 路由 | Vue Router 4 |
| 状态管理 | Pinia |
| HTTP 客户端 | Axios |
| 后端框架 | Hono.js(TypeScript) |
| 数据库 | SQLite3 |
| ORM | Drizzle ORM |
| 认证 | JWT(jsonwebtoken) |
| 数据校验 | zod |
| 测试 | Vitest |
环境要求
| 工具 | 最低版本 | 建议版本 |
|---|---|---|
| Node.js | >= 18.0.0 | >= 20.0.0 |
| npm | >= 9.0.0 | >= 10.0.0 |
快速开始
一键启动(推荐)
项目根目录提供了 start.bat 脚本,可同时启动前后端开发服务器:
start.bat
启动后:
- 后端运行在
http://localhost:3000(日志输出到server.log) - 前端运行在
http://localhost:5173(日志输出到frontend.log) - 按任意键即可同时停止两个服务
分别启动
后端(blog-server)
cd blog-server
npm install
# 配置环境变量
cp .env.example .env
# 生成并推送数据库表
npm run db:generate
npm run db:push
# 初始化种子数据(可选)
npm run db:seed
# 启动开发服务器(默认端口 3000)
npm run dev
2. 前端(blog-frontend)
cd blog-frontend
npm install
# 配置环境变量
# VITE_API_BASE_URL=http://localhost:3000/api
# 启动开发服务器(默认端口 5173)
npm run dev
常用脚本
前端
| 命令 | 说明 |
|---|---|
npm run dev |
启动开发服务器 |
npm run build |
构建生产版本 |
npm run preview |
预览构建产物 |
npm run lint |
ESLint 检查 |
npm run format |
Prettier 格式化 |
npm run test |
运行测试 |
后端
| 命令 | 说明 |
|---|---|
npm run dev |
启动开发服务器(热重载) |
npm run build |
构建 TypeScript 为 JS |
npm run start |
生产模式启动 |
npm run db:generate |
生成 Drizzle 迁移文件 |
npm run db:push |
推送 Schema 到数据库 |
npm run db:seed |
运行种子数据脚本 |
npm run test |
运行测试 |
环境变量
后端(blog-server/.env)
| 变量名 | 说明 | 默认值 |
|---|---|---|
PORT |
后端监听端口 | 3000 |
DATABASE_URL |
数据库文件路径 | ./data/blog.db |
JWT_SECRET |
JWT 签名密钥(必填,最少 32 字符) | - |
CORS_ORIGIN |
允许的跨域来源 | http://localhost:5173 |
前端(blog-frontend/.env)
| 变量名 | 说明 |
|---|---|
VITE_API_BASE_URL |
API 基础地址,开发环境可通过 Vite 代理转发 |
API 文档
所有 API 以 /api/v1 为前缀,涵盖认证、文章、分类、标签、评论、设置、仪表盘、文件上传等模块。详见 开发文档.md 第 7 章。
部署架构
用户请求 → Nginx(静态文件 /api 反向代理)→ Node.js 服务(blog-server)→ SQLite3
相关文档
开发文档.md— 完整的开发规范与 API 接口设计