.
├── Kirameku/ # 前端（Next.js App Router）
│ ├── app/ # 页面路由
│ │ ├── novel/ # 小说阅读系统（书架 → 搜索 → 目录 → 阅读）
│ │ ├── bookmark/ # 收藏夹（站点导航）
│ │ ├── posts/ # 文章系统
│ │ ├── moments/ # 说说
│ │ ├── friends/ # 友链（漂流瓶主题）
│ │ └── ... # 更多页面
│ ├── components/ # UI 组件
│ │ ├── layout/ # 导航栏、页脚
│ │ ├── providers/ # 主题、上下文
│ │ └── ui/ # 通用组件
│ └── siteConfig.ts # 站点全局配置
│
└── Kirameku-backend/ # 后端（FastAPI）
├── app/
│ ├── api/ # RESTful API 接口
│ ├── models/ # SQLModel 数据模型
│ ├── schemas/ # Pydantic 请求/响应模型
│ └── services/ # 业务逻辑层
├── admin/ # 管理后台（Vue 3 + Element Plus）
└── init_db.sql # 数据库初始化脚本
|
前端
|
后端
|
|
管理后台
|
阅读服务
|
| 模块 | 路径 | 描述 |
|---|---|---|
| 首页 | / |
文章预览、说说、照片墙，一站式入口 |
| 文章 | /posts |
分类筛选、标签、Markdown 渲染、代码高亮 |
| 说说 | /moments |
碎片化记录，类朋友圈时间线 |
| 杂谈 | /messages |
轻量话题讨论区 |
| 小说 | /novel |
书架 → 搜索 → 目录 → 阅读，完整阅读体验 |
| 收藏夹 | /bookmark |
站点导航，分类管理，平台标签，自动获取 favicon |
| 项目 | /projects |
个人项目展示，支持搜索，GitHub/Gitee 链接 |
| 友链 | /friends |
漂流瓶主题，可拖动交互 |
| 照片墙 | /photowall |
相册瀑布流展示 |
| 归档 | /timeline |
时间河流可视化，拖动浏览全部文章 |
| 音乐 | /music |
云音乐播放器，支持歌单 |
| 关于 | /about |
关于博主 |
文章、分类、标签、评论、留言、说说、相册、项目、友链、收藏夹、站点配置 — 全部可视化管理，支持图片压缩上传至阿里云 OSS。
cd Kirameku-backend
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Mac/Linux
# venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp .env.example .env
# 编辑 .env，填入数据库、密钥、OSS 等配置
# 初始化数据库
psql -U postgres -d your_db -f init_db.sql
# 打包管理后台
cd admin && pnpm install && pnpm build && cd ..
# 启动
uvicorn app.main:app --host 0.0.0.0 --port 8000API 文档：http://localhost:8000/docs
管理后台：http://localhost:8000/admin
cd Kirameku
pnpm install
pnpm dev # 开发模式 → http://localhost:3000
# 部署
pnpm build && pnpm start# reader-master 独立部署
java -jar reader-master.jar
# 默认端口 8085，前端通过 /reader3/ 路径代理访问Kirameku-backend/.env：
# 数据库
DATABASE_URL=postgresql://user:password@host:5432/dbname
# JWT
SECRET_KEY=your-secret-key
# 阿里云 OSS
OSS_ACCESS_KEY_ID=your-access-key-id
OSS_ACCESS_KEY_SECRET=your-access-key-secret
OSS_ENDPOINT=oss-cn-xxx.aliyuncs.com
OSS_BUCKET=your-bucket-name- Glassmorphism 风格 — 全站毛玻璃质感，亮色暗色双主题
- 微交互动画 — Framer Motion 驱动，页面过渡、卡片悬停、果冻弹跳
- 小说阅读系统 — 四级路由架构（书架/搜索/目录/阅读），SSE 流式搜索，阅读设置持久化
- 收藏夹 — 自动获取站点 favicon，平台标签，搜索过滤
- 漂流瓶友链 — 可拖动的漂浮瓶子，点击查看详情
- 时间河流 — 归档页的可视化时间线，拖动交互
- Live2D 看板娘 — 右下角可互动，连续点击 Logo 7 次触发彩蛋
- 移动端适配 — 响应式布局，移动端导航菜单
MIT