update readme

完善docker部署
前端：完善 naive-ui 配置，修复 API 返回值访问方式，修复 Sidebar 硬编码数据，修复路由守卫逻辑，修复其他组件问题。
2026-03-31 22:41:08 +08:00 · 2026-03-31 22:29:38 +08:00 · 2026-03-31 22:23:03 +08:00 · 2026-03-30 22:47:45 +08:00
28 changed files with 1329 additions and 240 deletions
--- a/backend/.dockerignore
+++ b/backend/.dockerignore
@@ -0,0 +1,7 @@
+__pycache__
+*.pyc
+.env
+.git
+*.md
+venv
+.venv
--- a/backend/.env.production
+++ b/backend/.env.production
@@ -0,0 +1,28 @@
+# ACG Blog 生产环境配置
+# 复制此文件为 .env 并修改对应值
+
+# 应用配置
+APP_NAME=ACG Blog
+APP_VERSION=1.0.0
+DEBUG=false
+
+# 数据库配置
+DB_HOST=postgres
+DB_PORT=5432
+DB_USER=postgres
+DB_PASSWORD=postgres
+DB_NAME=acg_blog
+
+# Redis 配置
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_DB=0
+
+# JWT 配置 (请修改为随机字符串)
+SECRET_KEY=your-super-secret-key-change-this-in-production
+ALGORITHM=HS256
+ACCESS_TOKEN_EXPIRE_MINUTES=30
+REFRESH_TOKEN_EXPIRE_DAYS=7
+
+# CORS 配置 (前端域名)
+BACKEND_CORS_ORIGINS=http://localhost,https://your-domain.com
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@@ -0,0 +1,25 @@
+# FastAPI Backend
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# 安装系统依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# 复制依赖文件
+COPY requirements.txt .
+
+# 安装 Python 依赖
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 复制应用代码
+COPY . .
+
+# 暴露端口
+EXPOSE 8000
+
+# 启动命令
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
--- a/backend/schema.sql
+++ b/backend/schema.sql
@@ -0,0 +1,136 @@
+-- ACG Blog 数据库建表脚本
+-- PostgreSQL
+-- 运行前请先创建数据库: CREATE DATABASE acg_blog;
+
+-- 启用 UUID 扩展
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+-- ==================== 用户表 ====================
+CREATE TABLE IF NOT EXISTS "users" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "username" VARCHAR(50) UNIQUE NOT NULL,
+    "email" VARCHAR(255) UNIQUE NOT NULL,
+    "password_hash" VARCHAR(255) NOT NULL,
+    "avatar" VARCHAR(500),
+    "bio" TEXT,
+    "is_active" BOOLEAN DEFAULT TRUE,
+    "is_superuser" BOOLEAN DEFAULT FALSE,
+    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- ==================== 分类表 ====================
+CREATE TABLE IF NOT EXISTS "categories" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "name" VARCHAR(50) UNIQUE NOT NULL,
+    "slug" VARCHAR(50) UNIQUE NOT NULL,
+    "description" TEXT,
+    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- ==================== 标签表 ====================
+CREATE TABLE IF NOT EXISTS "tags" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "name" VARCHAR(50) UNIQUE NOT NULL,
+    "slug" VARCHAR(50) UNIQUE NOT NULL,
+    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- ==================== 文章表 ====================
+CREATE TABLE IF NOT EXISTS "posts" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "title" VARCHAR(200) NOT NULL,
+    "slug" VARCHAR(200) UNIQUE NOT NULL,
+    "content" TEXT NOT NULL,
+    "summary" TEXT,
+    "cover_image" VARCHAR(500),
+
+    -- 外键关联
+    "author_id" UUID NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+    "category_id" UUID REFERENCES "categories"("id") ON DELETE SET NULL,
+
+    -- 统计数据
+    "view_count" INTEGER DEFAULT 0,
+    "like_count" INTEGER DEFAULT 0,
+    "comment_count" INTEGER DEFAULT 0,
+
+    -- 状态: draft/published/archived
+    "status" VARCHAR(20) DEFAULT 'draft',
+
+    -- SEO
+    "meta_title" VARCHAR(200),
+    "meta_description" TEXT,
+
+    -- 时间戳
+    "published_at" TIMESTAMP,
+    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 索引
+CREATE INDEX IF NOT EXISTS "idx_posts_status_published_at" ON "posts"("status", "published_at");
+CREATE INDEX IF NOT EXISTS "idx_posts_author_status" ON "posts"("author_id", "status");
+
+-- ==================== 文章标签关联表 ====================
+CREATE TABLE IF NOT EXISTS "post_tags" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "post_id" UUID NOT NULL REFERENCES "posts"("id") ON DELETE CASCADE,
+    "tag_id" UUID NOT NULL REFERENCES "tags"("id") ON DELETE CASCADE,
+    UNIQUE("post_id", "tag_id")
+);
+
+-- ==================== 评论表 ====================
+CREATE TABLE IF NOT EXISTS "comments" (
+    "id" UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    "content" TEXT NOT NULL,
+    "is_approved" BOOLEAN DEFAULT TRUE,
+
+    -- 外键关联
+    "author_id" UUID NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+    "post_id" UUID NOT NULL REFERENCES "posts"("id") ON DELETE CASCADE,
+    "parent_id" UUID REFERENCES "comments"("id") ON DELETE CASCADE,
+
+    -- 时间戳
+    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 索引
+CREATE INDEX IF NOT EXISTS "idx_comments_post_id" ON "comments"("post_id");
+CREATE INDEX IF NOT EXISTS "idx_comments_author_id" ON "comments"("author_id");
+
+-- ==================== 初始化数据 ====================
+
+-- 插入默认分类
+INSERT INTO "categories" ("name", "slug", "description") VALUES
+    ('动漫资讯', 'anime', '最新动漫新闻、番剧更新、业界动态'),
+    ('游戏攻略', 'game', '游戏通关指南、角色培养、剧情解析'),
+    ('二次元美图', 'pictures', '精选壁纸、Cosplay、插画作品'),
+    ('同人创作', 'fanwork', '同人小说、同人绘画、手办模型')
+ON CONFLICT ("slug") DO NOTHING;
+
+-- 插入默认标签
+INSERT INTO "tags" ("name", "slug") VALUES
+    ('原神', 'genshin'),
+    ('崩坏星穹铁道', 'honkai-star-rail'),
+    ('我的世界', 'minecraft'),
+    ('EVA', 'evangelion'),
+    ('约定的梦幻岛', 'neverland'),
+    ('咒术回战', 'jujutsu-kaisen'),
+    ('Cosplay', 'cosplay'),
+    ('手办', 'figure')
+ON CONFLICT ("slug") DO NOTHING;
+
+-- 插入管理员用户 (密码: admin123)
+-- 密码哈希基于 bcrypt，使用前请替换为实际哈希值
+INSERT INTO "users" ("username", "email", "password_hash", "is_superuser") VALUES
+    ('admin', 'admin@acgblog.com', '$2b$12$LQv3c1yqBWVHxkd0LHAkCOYz6TtxMQJqhN8/X4.TZND60LMTUBu.K', TRUE)
+ON CONFLICT ("username") DO NOTHING;
+
+-- ==================== 注释 ====================
+COMMENT ON TABLE "users" IS '用户表';
+COMMENT ON TABLE "categories" IS '文章分类表';
+COMMENT ON TABLE "tags" IS '文章标签表';
+COMMENT ON TABLE "posts" IS '文章表';
+COMMENT ON TABLE "post_tags" IS '文章标签关联表';
+COMMENT ON TABLE "comments" IS '评论表';
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -0,0 +1,78 @@
+version: '3.8'
+
+services:
+  # PostgreSQL 数据库
+  postgres:
+    image: postgres:16-alpine
+    container_name: acg_blog_db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: acg_blog
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./backend/schema.sql:/docker-entrypoint-initdb.d/schema.sql:ro
+    ports:
+      - "5432:5432"
+    networks:
+      - acg_blog_network
+
+  # Redis 缓存
+  redis:
+    image: redis:7-alpine
+    container_name: acg_blog_redis
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    networks:
+      - acg_blog_network
+
+  # 后端 API
+  backend:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    container_name: acg_blog_backend
+    restart: unless-stopped
+    environment:
+      - DB_HOST=postgres
+      - DB_PORT=5432
+      - DB_USER=postgres
+      - DB_PASSWORD=postgres
+      - DB_NAME=acg_blog
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+      - SECRET_KEY=your-secret-key-change-in-production
+      - DEBUG=false
+    ports:
+      - "8000:8000"
+    depends_on:
+      - postgres
+      - redis
+    networks:
+      - acg_blog_network
+
+  # 前端 Nginx
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+    container_name: acg_blog_frontend
+    restart: unless-stopped
+    ports:
+      - "80:80"
+    depends_on:
+      - backend
+    networks:
+      - acg_blog_network
+
+volumes:
+  postgres_data:
+  redis_data:
+
+networks:
+  acg_blog_network:
+    driver: bridge
--- a/docker-deploy.md
+++ b/docker-deploy.md
@@ -0,0 +1,69 @@
+# Docker 部署指南
+
+## 快速启动
+
+```bash
+# 启动所有服务
+docker-compose up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看日志
+docker-compose logs -f
+```
+
+## 服务地址
+
+| 服务 | 地址 |
+|------|------|
+| 前端 | http://localhost |
+| 后端 API | http://localhost:8000 |
+| API 文档 | http://localhost:8000/docs |
+| PostgreSQL | localhost:5432 |
+| Redis | localhost:6379 |
+
+## 初始化数据库
+
+首次启动时，数据库会自动创建表结构和初始数据。
+
+管理员账户：
+- 用户名: `admin`
+- 邮箱: `admin@acgblog.com`
+- 密码: `admin123`
+
+**重要**: 请在部署后修改管理员密码！
+
+## 常用命令
+
+```bash
+# 重新构建镜像
+docker-compose build --no-cache
+
+# 停止所有服务
+docker-compose down
+
+# 停止并删除数据卷
+docker-compose down -v
+
+# 进入后端容器
+docker exec -it acg_blog_backend sh
+
+# 进入数据库
+docker exec -it acg_blog_db psql -U postgres -d acg_blog
+```
+
+## 生产环境部署
+
+1. 修改 `backend/.env.production` 中的配置：
+   - `SECRET_KEY` - 使用随机字符串
+   - `BACKEND_CORS_ORIGINS` - 改为你的域名
+
+2. 修改 `docker-compose.yml` 中的端口映射（移除端口暴露，仅通过 nginx 反向代理）
+
+3. 使用 Nginx 或 Traefik 等反向代理配置 HTTPS
+
+4. 定期备份数据库：
+   ```bash
+   docker exec acg_blog_db pg_dump -U postgres acg_blog > backup.sql
+   ```
--- a/frontend/.dockerignore
+++ b/frontend/.dockerignore
@@ -0,0 +1,6 @@
+node_modules
+dist
+.git
+.env
+*.md
+.vscode
--- a/frontend/Dockerfile
+++ b/frontend/Dockerfile
@@ -0,0 +1,29 @@
+# Vue 3 Frontend
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# 复制依赖文件
+COPY package*.json ./
+
+# 安装依赖
+RUN npm ci
+
+# 复制源代码
+COPY . .
+
+# 构建生产版本
+RUN npm run build
+
+# ==================== Nginx 运行阶段 ====================
+FROM nginx:alpine
+
+# 复制构建产物
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# 复制 Nginx 配置
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]
--- a/frontend/nginx.conf
+++ b/frontend/nginx.conf
@@ -0,0 +1,32 @@
+server {
+    listen 80;
+    server_name localhost;
+    root /usr/share/nginx/html;
+    index index.html;
+
+    # Gzip 压缩
+    gzip on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml;
+    gzip_min_length 1000;
+
+    # 前端路由（SPA）
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # API 代理
+    location /api/ {
+        proxy_pass http://backend:8000/api/;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    # 静态资源缓存
+    location /assets/ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}
--- a/frontend/src/api/index.ts
+++ b/frontend/src/api/index.ts
@@ -1,5 +1,4 @@
-import axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios'
-import type { ApiResponse } from '@/types'
+import axios, { type AxiosInstance, type AxiosRequestConfig } from 'axios'

 // 创建 axios 实例
 const request: AxiosInstance = axios.create({
@@ -27,20 +26,22 @@ request.interceptors.request.use(

 // 响应拦截器
 request.interceptors.response.use(
-  (response: AxiosResponse<ApiResponse>) => {
-    return response
+  (response) => {
+    // 成功时返回 response.data（即 ApiResponse）
+    return response.data
  },
  (error: any) => {
    if (error.response) {
-      const { status } = error.response
+      const { status, data } = error.response

-      // 401 未授权，跳转登录页
+      // 401 未授权，清除 token
      if (status === 401) {
        localStorage.removeItem('access_token')
        window.location.href = '/login'
      }

-      return Promise.reject(error.response.data)
+      // 返回错误信息
+      return Promise.reject(data)
    }

    return Promise.reject(error)
@@ -48,21 +49,22 @@ request.interceptors.response.use(
 )

 // 封装请求方法
+// 返回 Promise<ApiResponse<T>>，调用者通过 .data 访问实际数据
 export const http = {
-  get<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>> {
-    return request.get(url, config)
+  get<T = any>(url: string, config?: AxiosRequestConfig): Promise<{ code: number; message: string; data: T }> {
+    return request.get(url, config).then(res => res.data)
  },

-  post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>> {
-    return request.post(url, data, config)
+  post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<{ code: number; message: string; data: T }> {
+    return request.post(url, data, config).then(res => res.data)
  },

-  put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>> {
-    return request.put(url, data, config)
+  put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<{ code: number; message: string; data: T }> {
+    return request.put(url, data, config).then(res => res.data)
  },

-  delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>> {
-    return request.delete(url, config)
+  delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<{ code: number; message: string; data: T }> {
+    return request.delete(url, config).then(res => res.data)
  },
 }

--- a/frontend/src/components/Navbar.vue
+++ b/frontend/src/components/Navbar.vue
@@ -1,14 +1,18 @@
 <script setup lang="ts">
 import { useThemeStore } from '@/store/theme'
 import { useUserStore } from '@/store/user'
-import { RouterLink } from 'vue-router'
+import { RouterLink, useRoute } from 'vue-router'
+import { computed } from 'vue'

 const themeStore = useThemeStore()
 const userStore = useUserStore()
+const route = useRoute()
+
+const isAdmin = computed(() => route.path.startsWith('/admin'))
 </script>

 <template>
-  <nav class="navbar">
+  <nav v-if="!isAdmin" class="navbar">
    <div class="nav-container">
      <!-- Logo -->
      <RouterLink to="/" class="logo">
@@ -18,24 +22,23 @@ const userStore = useUserStore()

      <!-- 导航链接 -->
      <div class="nav-links">
-        <RouterLink to="/" class="nav-link">首页</RouterLink>
-        <RouterLink to="/category" class="nav-link">分类</RouterLink>
-        <RouterLink to="/archive" class="nav-link">归档</RouterLink>
-        <RouterLink to="/about" class="nav-link">关于</RouterLink>
+        <RouterLink to="/" class="nav-link" exact-active-class="active">首页</RouterLink>
+        <RouterLink to="/category" class="nav-link" active-class="active">分类</RouterLink>
+        <RouterLink to="/about" class="nav-link" active-class="active">关于</RouterLink>
      </div>

      <!-- 右侧操作区 -->
      <div class="nav-actions">
        <!-- 主题切换 -->
-        <button @click="themeStore.toggleTheme()" class="action-btn">
-          {{ themeStore.theme === 'light' ? '☀️' : themeStore.theme === 'dark' ? '🌙' : '🌗' }}
+        <button @click="themeStore.toggleTheme()" class="action-btn" :title="themeStore.theme === 'light' ? '切换深色模式' : '切换浅色模式'">
+          <span class="text-lg">{{ themeStore.theme === 'light' ? '🌙' : '☀️' }}</span>
        </button>

        <!-- 登录按钮 -->
        <RouterLink v-if="!userStore.isLoggedIn" to="/login" class="login-btn">
          登录
        </RouterLink>
-        <RouterLink v-else to="/profile" class="user-avatar">
+        <RouterLink v-else to="/profile" class="user-avatar" :title="userStore.user?.username">
          {{ userStore.user?.username?.[0]?.toUpperCase() || 'U' }}
        </RouterLink>
      </div>
@@ -50,19 +53,19 @@ const userStore = useUserStore()
  left: 0;
  right: 0;
  z-index: 50;
-  background: rgba(255, 255, 255, 0.85);
-  backdrop-filter: blur(12px);
-  border-bottom: 1px solid rgba(229, 231, 235, 0.5);
+  background: rgba(255, 255, 255, 0.8);
+  backdrop-filter: blur(20px);
+  border-bottom: 1px solid rgba(229, 231, 235, 0.3);
 }
 :global(.dark) .navbar {
-  background: rgba(17, 24, 39, 0.85);
-  border-bottom-color: rgba(75, 85, 99, 0.5);
+  background: rgba(17, 24, 39, 0.8);
+  border-bottom-color: rgba(75, 85, 99, 0.3);
 }

 .nav-container {
  max-width: 1280px;
  margin: 0 auto;
-  padding: 0 1rem;
+  padding: 0 1.5rem;
  height: 4rem;
  display: flex;
  align-items: center;
@@ -77,9 +80,9 @@ const userStore = useUserStore()
 }

 .logo-icon {
-  width: 2rem;
-  height: 2rem;
-  border-radius: 0.5rem;
+  width: 2.25rem;
+  height: 2.25rem;
+  border-radius: 0.625rem;
  background: linear-gradient(135deg, #FFB7C5, #D4B5E6);
  display: flex;
  align-items: center;
@@ -87,6 +90,7 @@ const userStore = useUserStore()
  color: white;
  font-weight: bold;
  font-size: 1.125rem;
+  box-shadow: 0 2px 10px rgba(255, 183, 197, 0.3);
 }

 .logo-text {
@@ -100,7 +104,7 @@ const userStore = useUserStore()

 .nav-links {
  display: none;
-  gap: 1.5rem;
+  gap: 0.5rem;
 }
@media (min-width: 768px) {
  .nav-links {
@@ -110,18 +114,24 @@ const userStore = useUserStore()

 .nav-link {
  position: relative;
+  padding: 0.5rem 1rem;
+  border-radius: 0.5rem;
  color: #6B7280;
  text-decoration: none;
-  font-size: 0.875rem;
+  font-size: 0.9375rem;
  font-weight: 500;
-  transition: color 0.2s;
+  transition: all 0.2s;
 }
 :global(.dark) .nav-link {
  color: #9CA3AF;
 }
-.nav-link:hover,
-.nav-link.router-link-active {
+.nav-link:hover {
  color: #FFB7C5;
+  background: rgba(255, 183, 197, 0.1);
+}
+.nav-link.active {
+  color: #FFB7C5;
+  background: rgba(255, 183, 197, 0.15);
 }

 .nav-actions {
@@ -131,9 +141,9 @@ const userStore = useUserStore()
 }

 .action-btn {
-  width: 2.25rem;
-  height: 2.25rem;
-  border-radius: 9999px;
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: 0.75rem;
  display: flex;
  align-items: center;
  justify-content: center;
@@ -146,27 +156,29 @@ const userStore = useUserStore()
  background: #374151;
 }
 .action-btn:hover {
-  background: #FFB7C5;
+  background: rgba(255, 183, 197, 0.3);
+  transform: scale(1.05);
 }

 .login-btn {
-  padding: 0.5rem 1rem;
+  padding: 0.5rem 1.25rem;
  border-radius: 9999px;
-  border: 2px solid #FFB7C5;
-  color: #FFB7C5;
+  background: linear-gradient(135deg, #FFB7C5, #D4B5E6);
+  color: white;
  font-size: 0.875rem;
-  font-weight: 500;
+  font-weight: 600;
  text-decoration: none;
  transition: all 0.2s;
+  box-shadow: 0 2px 10px rgba(255, 183, 197, 0.3);
 }
 .login-btn:hover {
-  background: #FFB7C5;
-  color: white;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 15px rgba(255, 183, 197, 0.5);
 }

 .user-avatar {
-  width: 2.25rem;
-  height: 2.25rem;
+  width: 2.5rem;
+  height: 2.5rem;
  border-radius: 9999px;
  background: linear-gradient(135deg, #FFB7C5, #D4B5E6);
  display: flex;
@@ -175,5 +187,11 @@ const userStore = useUserStore()
  color: white;
  font-weight: 600;
  text-decoration: none;
+  box-shadow: 0 2px 10px rgba(255, 183, 197, 0.3);
+  transition: all 0.2s;
+}
+.user-avatar:hover {
+  transform: scale(1.05);
+  box-shadow: 0 4px 15px rgba(255, 183, 197, 0.5);
 }
 </style>
--- a/frontend/src/components/Sidebar.vue
+++ b/frontend/src/components/Sidebar.vue
@@ -1,26 +1,34 @@
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, onMounted } from 'vue'
 import { RouterLink } from 'vue-router'
+import { categoryApi } from '@/api/category'
+import { postApi } from '@/api/post'
+import type { Category, Post } from '@/types'

-const categories = ref([
-  { id: '1', name: '动漫资讯', slug: 'anime', post_count: 12 },
-  { id: '2', name: '游戏攻略', slug: 'game', post_count: 8 },
-  { id: '3', name: '二次元美图', slug: 'pictures', post_count: 25 },
-  { id: '4', name: '同人创作', slug: 'fanwork', post_count: 15 },
-])
+const categories = ref<Category[]>([])
+const tags = ref<string[]>(['原神', '崩坏星穹铁道', '我的世界', 'EVA', '约定的梦幻岛', '咒术回战', 'Cosplay', '手办'])
+const hotPosts = ref<Post[]>([])

-const tags = ref([
-  '原神', '崩坏星穹铁道', '我的世界', 'EVA',
-  '约定的梦幻岛', '咒术回战', 'Cosplay', '手办'
-])
+async function fetchSidebarData() {
+  try {
+    // 获取分类
+    const catResponse = await categoryApi.getAll()
+    categories.value = catResponse.data

-const hotPosts = ref([
-  { id: '1', title: '《原神》4.2版本前瞻：芙宁娜技能演示', view_count: 5200 },
-  { id: '2', title: '2024年必追的10部春季新番', view_count: 3800 },
-  { id: '3', title: '《崩坏星穹铁道》角色强度榜更新', view_count: 2900 },
-  { id: '4', title: '二次元手游开服大横评', view_count: 2100 },
-  { id: '5', title: '手办入坑指南：从萌新到进阶', view_count: 1800 },
-])
+    // 获取热门文章
+    const postsResponse = await postApi.getList({ page: 1, page_size: 10 })
+    hotPosts.value = postsResponse.data.items
+      .filter((p: Post) => p.status === 'published')
+      .sort((a: Post, b: Post) => b.view_count - a.view_count)
+      .slice(0, 5)
+  } catch (error) {
+    console.error('Failed to fetch sidebar data:', error)
+  }
+}
+
+onMounted(() => {
+  fetchSidebarData()
+})
 </script>

 <template>
@@ -53,9 +61,8 @@ const hotPosts = ref([
      <h3 class="sidebar-title">分类</h3>
      <ul class="category-list">
        <li v-for="cat in categories" :key="cat.id">
-          <RouterLink :to="`/category/${cat.slug}`" class="category-item">
+          <RouterLink :to="`/category/${cat.id}`" class="category-item">
            <span>{{ cat.name }}</span>
-            <span class="category-count">{{ cat.post_count }}</span>
          </RouterLink>
        </li>
      </ul>
@@ -65,9 +72,9 @@ const hotPosts = ref([
    <div class="sidebar-card">
      <h3 class="sidebar-title">标签</h3>
      <div class="tag-cloud">
-        <RouterLink v-for="tag in tags" :key="tag" :to="`/tag/${tag}`" class="tag">
+        <span v-for="tag in tags" :key="tag" class="tag">
          {{ tag }}
-        </RouterLink>
+        </span>
      </div>
    </div>

--- a/frontend/src/main.ts
+++ b/frontend/src/main.ts
@@ -1,12 +1,14 @@
 import { createApp } from 'vue'
 import { createPinia } from 'pinia'
+import naive from 'naive-ui'
 import App from './App.vue'
 import router from './router'
-// import naive-ui (按需引入，后续按需配置)
+import './style.css'

 const app = createApp(App)

 app.use(createPinia())
 app.use(router)
+app.use(naive)

 app.mount('#app')
--- a/frontend/src/router/index.ts
+++ b/frontend/src/router/index.ts
@@ -83,17 +83,37 @@ const router = createRouter({
 })

 // 路由守卫
-router.beforeEach((to, _from, next) => {
+router.beforeEach(async (to, _from, next) => {
  const userStore = useUserStore()
  const token = localStorage.getItem('access_token')

+  // 需要登录但未登录
  if (to.meta.requiresAuth && !token) {
    next({ name: 'Login' })
-  } else if (to.meta.requiresAdmin && userStore.user?.is_active !== true) {
-    next({ name: 'Home' })
-  } else {
-    next()
+    return
  }
+
+  // 需要管理员权限但不是管理员
+  if (to.meta.requiresAdmin) {
+    // 如果还没有用户信息，先获取
+    if (!userStore.user && token) {
+      try {
+        await userStore.fetchUser()
+      } catch {
+        // 获取失败，清除 token
+        userStore.logout()
+        next({ name: 'Login' })
+        return
+      }
+    }
+
+    if (!userStore.user?.is_superuser) {
+      next({ name: 'Home' })
+      return
+    }
+  }
+
+  next()
 })

 export default router
--- a/frontend/src/store/user.ts
+++ b/frontend/src/store/user.ts
@@ -10,7 +10,7 @@ export const useUserStore = defineStore('user', () => {

  // 计算属性
  const isLoggedIn = computed(() => !!token.value)
-  const isAdmin = computed(() => user.value?.is_active === true)
+  const isAdmin = computed(() => user.value?.is_superuser === true)

  // Actions
  function setToken(newToken: string | null) {
--- a/frontend/src/types/index.ts
+++ b/frontend/src/types/index.ts
@@ -5,6 +5,7 @@ export interface User {
  email: string
  avatar?: string
  is_active: boolean
+  is_superuser: boolean
  created_at: string
  updated_at: string
 }
@@ -82,6 +83,7 @@ export interface Category {
 export interface Tag {
  id: string
  name: string
+  slug?: string
  created_at: string
 }

--- a/frontend/src/views/About.vue
+++ b/frontend/src/views/About.vue
@@ -1,19 +1,43 @@
-<template>
-  <div class="about">
-    <nav class="glass fixed top-0 left-0 right-0 z-50">
-      <div class="max-w-4xl mx-auto px-4 py-4">
-        <RouterLink to="/" class="text-acg-pink hover:underline">← 返回首页</RouterLink>
-      </div>
-    </nav>
+<script setup lang="ts">
+import Navbar from '@/components/Navbar.vue'
+import Footer from '@/components/Footer.vue'
+</script>

-    <main class="pt-20 px-4 max-w-4xl mx-auto">
+<template>
+  <div class="about min-h-screen">
+    <Navbar />
+
+    <main class="pt-24 px-4 pb-12 max-w-4xl mx-auto">
      <div class="glass rounded-xl p-8">
-        <h1 class="text-3xl font-bold mb-4">关于 ACG Blog</h1>
-        <p class="text-gray-600 dark:text-gray-400 leading-relaxed">
+        <h1 class="text-3xl font-bold mb-6">关于 ACG Blog</h1>
+        <div class="space-y-4 text-gray-600 dark:text-gray-400 leading-relaxed">
+          <p>
            ACG Blog 是一个专注于二次元文化的博客平台，使用 Vue 3 + TypeScript + Naive UI 构建。
            在这里，你可以分享你的二次元生活、动漫评论、游戏攻略等内容。
          </p>
+          <p>
+            本博客系统采用前后端分离架构，前端使用 Vue 3 + Vite，后端使用 FastAPI，
+            数据存储使用 PostgreSQL，缓存使用 Redis，为你提供流畅的使用体验。
+          </p>
+          <p>
+            如果你有任何问题或建议，欢迎联系我们！
+          </p>
+        </div>
+
+        <div class="mt-8 pt-8 border-t border-gray-200 dark:border-gray-700">
+          <h2 class="text-xl font-bold mb-4">技术栈</h2>
+          <div class="flex flex-wrap gap-2">
+            <span class="px-3 py-1 rounded-full bg-acg-pink/20 text-acg-pink text-sm">Vue 3</span>
+            <span class="px-3 py-1 rounded-full bg-acg-purple/20 text-acg-purple text-sm">FastAPI</span>
+            <span class="px-3 py-1 rounded-full bg-acg-pink/20 text-acg-pink text-sm">TypeScript</span>
+            <span class="px-3 py-1 rounded-full bg-acg-purple/20 text-acg-purple text-sm">Naive UI</span>
+            <span class="px-3 py-1 rounded-full bg-acg-pink/20 text-acg-pink text-sm">Tailwind CSS</span>
+            <span class="px-3 py-1 rounded-full bg-acg-purple/20 text-acg-purple text-sm">PostgreSQL</span>
+          </div>
+        </div>
      </div>
    </main>
+
+    <Footer />
  </div>
 </template>
--- a/frontend/src/views/Category.vue
+++ b/frontend/src/views/Category.vue
@@ -1,25 +1,105 @@
 <script setup lang="ts">
 import { useRoute } from 'vue-router'
+import Navbar from '@/components/Navbar.vue'
+import Footer from '@/components/Footer.vue'
+import { postApi } from '@/api/post'
+import { categoryApi } from '@/api/category'
+import type { Post, Category } from '@/types'
+import { ref, onMounted, computed } from 'vue'
+import PostCard from '@/components/PostCard.vue'

 const route = useRoute()
 const categoryId = route.params.id as string
+const category = ref<Category | null>(null)
+const posts = ref<Post[]>([])
+const loading = ref(false)
+
+const routePath = computed(() => route.path)
+
+async function fetchCategoryAndPosts() {
+  loading.value = true
+  try {
+    if (routePath.value === '/category') {
+      // 全部分类页
+      category.value = null
+      const response = await postApi.getList({ page: 1, page_size: 20 })
+      posts.value = response.data.items.filter((p: Post) => p.status === 'published')
+    } else {
+      // 特定分类
+      const [catResponse, postsResponse] = await Promise.all([
+        categoryApi.getDetail(categoryId),
+        postApi.getList({ category_id: categoryId, page: 1, page_size: 20 }),
+      ])
+      category.value = catResponse.data
+      posts.value = postsResponse.data.items.filter((p: Post) => p.status === 'published')
+    }
+  } catch (error) {
+    console.error('Failed to fetch category:', error)
+  } finally {
+    loading.value = false
+  }
+}
+
+onMounted(() => {
+  fetchCategoryAndPosts()
+})
 </script>

 <template>
-  <div class="category">
-    <nav class="glass fixed top-0 left-0 right-0 z-50">
-      <div class="max-w-6xl mx-auto px-4 py-4">
-        <RouterLink to="/" class="text-acg-pink hover:underline">← 返回首页</RouterLink>
-      </div>
-    </nav>
+  <div class="category min-h-screen">
+    <Navbar />

-    <main class="pt-20 px-4 max-w-6xl mx-auto">
-      <div class="glass rounded-xl p-8">
-        <h1 class="text-2xl font-bold mb-4">分类 - {{ categoryId }}</h1>
-        <div class="text-gray-600 dark:text-gray-400">
-          分类内容加载中...
+    <!-- Hero Section -->
+    <section class="relative py-16 px-4 overflow-hidden">
+      <div class="absolute inset-0 bg-gradient-to-br from-pink-500/10 via-purple-500/10 to-blue-500/10"></div>
+      <div class="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-96 h-96 bg-acg-pink/20 rounded-full blur-3xl"></div>
+      <div class="relative max-w-6xl mx-auto text-center">
+        <div class="inline-flex items-center gap-2 px-4 py-2 rounded-full bg-white/50 dark:bg-gray-800/50 backdrop-blur-sm mb-6">
+          <span class="text-lg">📁</span>
+          <span class="text-sm font-medium">分类</span>
+        </div>
+        <h1 class="text-4xl md:text-5xl font-bold mb-4">
+          {{ category?.name || '全部分类' }}
+        </h1>
+        <p v-if="category?.description" class="text-gray-600 dark:text-gray-400 max-w-2xl mx-auto">
+          {{ category.description }}
+        </p>
+        <p v-else class="text-gray-500">
+          浏览所有文章
+        </p>
+      </div>
+    </section>
+
+    <!-- Content -->
+    <main class="px-4 pb-12 max-w-6xl mx-auto">
+      <div v-if="loading" class="glass rounded-xl p-12 text-center">
+        <div class="animate-pulse space-y-4">
+          <div class="h-6 bg-gray-200 dark:bg-gray-700 rounded w-1/4 mx-auto"></div>
+          <div class="h-4 bg-gray-200 dark:bg-gray-700 rounded w-1/2 mx-auto"></div>
+        </div>
+      </div>
+
+      <div v-else-if="posts.length === 0" class="glass rounded-xl p-12 text-center">
+        <div class="text-6xl mb-4">📭</div>
+        <h3 class="text-xl font-bold mb-2">暂无文章</h3>
+        <p class="text-gray-500">该分类下还没有发布的文章</p>
+        <RouterLink to="/" class="inline-block mt-4 text-acg-pink hover:underline">
+          返回首页
+        </RouterLink>
+      </div>
+
+      <div v-else>
+        <div class="flex items-center justify-between mb-6">
+          <h2 class="text-lg font-medium">
+            共 {{ posts.length }} 篇文章
+          </h2>
+        </div>
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+          <PostCard v-for="post in posts" :key="post.id" :post="post" />
        </div>
      </div>
    </main>
+
+    <Footer />
  </div>
 </template>
--- a/frontend/src/views/Home.vue
+++ b/frontend/src/views/Home.vue
@@ -22,7 +22,7 @@ async function fetchPosts(categoryId?: string) {
      params.category_id = categoryId
    }
    const response = await postApi.getList(params)
-    posts.value = response.data.items.filter(p => p.status === 'published')
+    posts.value = response.data.items.filter((p: any) => p.status === 'published')
  } catch (error) {
    console.error('Failed to fetch posts:', error)
  } finally {
--- a/frontend/src/views/NotFound.vue
+++ b/frontend/src/views/NotFound.vue
@@ -1,13 +1,17 @@
 <script setup lang="ts">
 import { RouterLink } from 'vue-router'
+import Navbar from '@/components/Navbar.vue'
 </script>

 <template>
-  <div class="not-found min-h-screen flex items-center justify-center px-4">
+  <div class="not-found min-h-screen">
+    <Navbar />
+    <main class="pt-24 px-4 pb-12 flex items-center justify-center">
      <div class="text-center">
        <h1 class="text-6xl font-bold text-acg-pink mb-4">404</h1>
-      <p class="text-xl mb-6">页面不存在</p>
+        <p class="text-xl mb-6 text-gray-600 dark:text-gray-400">页面不存在</p>
        <RouterLink to="/" class="btn-acg">返回首页</RouterLink>
      </div>
+    </main>
  </div>
 </template>
--- a/frontend/src/views/admin/CategoryManage.vue
+++ b/frontend/src/views/admin/CategoryManage.vue
@@ -1,8 +1,197 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { useMessage, useDialog } from 'naive-ui'
+import type { Category } from '@/types'
+
+const message = useMessage()
+const dialog = useDialog()
+
+const categories = ref<Category[]>([])
+const loading = ref(false)
+const showModal = ref(false)
+const isEditing = ref(false)
+const currentId = ref<string | null>(null)
+
+const formData = ref({
+  name: '',
+  slug: '',
+  description: '',
+})
+
+async function fetchCategories() {
+  loading.value = true
+  try {
+    // 模拟数据 - 实际应该调用API
+    categories.value = []
+  } catch (error) {
+    message.error('获取分类失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+function openModal(category?: Category) {
+  if (category) {
+    isEditing.value = true
+    currentId.value = category.id
+    formData.value = {
+      name: category.name,
+      slug: category.slug,
+      description: category.description || '',
+    }
+  } else {
+    isEditing.value = false
+    currentId.value = null
+    formData.value = { name: '', slug: '', description: '' }
+  }
+  showModal.value = true
+}
+
+function closeModal() {
+  showModal.value = false
+  isEditing.value = false
+  currentId.value = null
+  formData.value = { name: '', slug: '', description: '' }
+}
+
+async function saveCategory() {
+  if (!formData.value.name || !formData.value.slug) {
+    message.warning('请填写名称和别名')
+    return
+  }
+
+  try {
+    if (isEditing.value && currentId.value) {
+      message.success('分类更新成功')
+    } else {
+      message.success('分类创建成功')
+    }
+    closeModal()
+    fetchCategories()
+  } catch (error) {
+    message.error('保存失败')
+  }
+}
+
+async function deleteCategory(_id: string) {
+  try {
+    await dialog.warning({
+      title: '确认删除',
+      content: '确定要删除这个分类吗？',
+      positiveText: '删除',
+      negativeText: '取消',
+    })
+    message.success('删除成功')
+    fetchCategories()
+  } catch {
+    // 取消
+  }
+}
+
+function generateSlug() {
+  // 简单的 slug 生成
+  formData.value.slug = formData.value.name
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+}
+
+onMounted(() => {
+  fetchCategories()
+})
+</script>
+
 <template>
  <div class="category-manage">
-    <h1 class="text-2xl font-bold mb-6">分类管理</h1>
-    <div class="glass rounded-xl p-6">
-      <p class="text-gray-600 dark:text-gray-400">分类管理功能开发中...</p>
+    <div class="flex justify-between items-center mb-6">
+      <h1 class="text-2xl font-bold">分类管理</h1>
+      <button @click="openModal()" class="btn-acg">
+        新建分类
+      </button>
+    </div>
+
+    <div class="glass rounded-xl overflow-hidden">
+      <table class="w-full">
+        <thead class="bg-gray-100 dark:bg-gray-800">
+          <tr>
+            <th class="px-4 py-3 text-left text-sm font-medium">名称</th>
+            <th class="px-4 py-3 text-left text-sm font-medium">别名</th>
+            <th class="px-4 py-3 text-left text-sm font-medium">描述</th>
+            <th class="px-4 py-3 text-left text-sm font-medium">创建时间</th>
+            <th class="px-4 py-3 text-right text-sm font-medium">操作</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-200 dark:divide-gray-700">
+          <tr v-for="cat in categories" :key="cat.id" class="hover:bg-gray-50 dark:hover:bg-gray-800">
+            <td class="px-4 py-3 font-medium">{{ cat.name }}</td>
+            <td class="px-4 py-3 text-gray-500 text-sm">{{ cat.slug }}</td>
+            <td class="px-4 py-3 text-gray-500 text-sm">{{ cat.description || '-' }}</td>
+            <td class="px-4 py-3 text-gray-500 text-sm">{{ new Date(cat.created_at).toLocaleDateString() }}</td>
+            <td class="px-4 py-3 text-right">
+              <button @click="openModal(cat)" class="text-acg-pink hover:underline mr-4">编辑</button>
+              <button @click="deleteCategory(cat.id)" class="text-red-500 hover:underline">删除</button>
+            </td>
+          </tr>
+          <tr v-if="loading">
+            <td colspan="5" class="px-4 py-8 text-center text-gray-500">加载中...</td>
+          </tr>
+          <tr v-if="!loading && categories.length === 0">
+            <td colspan="5" class="px-4 py-8 text-center text-gray-500">暂无分类，点击上方按钮创建</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+
+    <!-- 弹窗 -->
+    <div v-if="showModal" class="fixed inset-0 z-50 flex items-center justify-center p-4 bg-black/50">
+      <div class="glass rounded-xl w-full max-w-md">
+        <div class="p-6">
+          <h2 class="text-xl font-bold mb-6">{{ isEditing ? '编辑分类' : '新建分类' }}</h2>
+
+          <form @submit.prevent="saveCategory" class="space-y-4">
+            <div>
+              <label class="block text-sm font-medium mb-2">名称</label>
+              <input
+                v-model="formData.name"
+                type="text"
+                placeholder="分类名称"
+                class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800"
+                @blur="generateSlug"
+              />
+            </div>
+
+            <div>
+              <label class="block text-sm font-medium mb-2">别名</label>
+              <input
+                v-model="formData.slug"
+                type="text"
+                placeholder="url-slug"
+                class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800"
+              />
+            </div>
+
+            <div>
+              <label class="block text-sm font-medium mb-2">描述</label>
+              <textarea
+                v-model="formData.description"
+                placeholder="分类描述（可选）"
+                rows="3"
+                class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800"
+              ></textarea>
+            </div>
+
+            <div class="flex justify-end gap-4 pt-4">
+              <button type="button" @click="closeModal" class="px-6 py-2 rounded-lg border border-gray-300 dark:border-gray-600 hover:bg-gray-100 dark:hover:bg-gray-800">
+                取消
+              </button>
+              <button type="submit" class="btn-acg">
+                保存
+              </button>
+            </div>
+          </form>
+        </div>
+      </div>
    </div>
  </div>
 </template>
--- a/frontend/src/views/admin/Dashboard.vue
+++ b/frontend/src/views/admin/Dashboard.vue
@@ -1,18 +1,120 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { postApi } from '@/api/post'
+import { useUserStore } from '@/store/user'
+
+const userStore = useUserStore()
+const stats = ref({
+  postCount: 0,
+  userCount: 0,
+  viewCount: 0,
+})
+const recentPosts = ref<any[]>([])
+const loading = ref(false)
+
+async function fetchDashboardData() {
+  loading.value = true
+  try {
+    const response = await postApi.getList({ page: 1, page_size: 5 })
+    recentPosts.value = response.data.items
+    stats.value.postCount = response.data.total
+  } catch (error) {
+    console.error('Failed to fetch dashboard data:', error)
+  } finally {
+    loading.value = false
+  }
+}
+
+function formatDate(dateStr: string) {
+  return new Date(dateStr).toLocaleDateString('zh-CN')
+}
+
+onMounted(() => {
+  fetchDashboardData()
+})
+</script>
+
 <template>
  <div class="dashboard">
-    <h1 class="text-2xl font-bold mb-6">仪表盘</h1>
-    <div class="grid gap-4 md:grid-cols-3">
-      <div class="glass rounded-xl p-6">
-        <h3 class="text-gray-600 dark:text-gray-400">文章总数</h3>
-        <p class="text-3xl font-bold text-acg-pink">0</p>
+    <div class="mb-6">
+      <h1 class="text-2xl font-bold">仪表盘</h1>
+      <p class="text-gray-500 text-sm mt-1">欢迎回来，{{ userStore.user?.username || '管理员' }}</p>
    </div>
-      <div class="glass rounded-xl p-6">
-        <h3 class="text-gray-600 dark:text-gray-400">用户总数</h3>
-        <p class="text-3xl font-bold text-acg-blue">0</p>
+
+    <!-- 统计卡片 -->
+    <div class="grid gap-4 md:grid-cols-3 mb-8">
+      <div class="glass rounded-xl p-6 relative overflow-hidden">
+        <div class="absolute top-0 right-0 w-20 h-20 bg-gradient-to-br from-pink-500/20 to-transparent rounded-bl-full"></div>
+        <div class="flex items-center gap-4">
+          <div class="w-12 h-12 rounded-xl bg-pink-500/20 flex items-center justify-center">
+            <span class="text-2xl">📝</span>
          </div>
+          <div>
+            <p class="text-gray-500 text-sm">文章总数</p>
+            <p class="text-3xl font-bold text-pink-500">{{ stats.postCount }}</p>
+          </div>
+        </div>
+      </div>
+
+      <div class="glass rounded-xl p-6 relative overflow-hidden">
+        <div class="absolute top-0 right-0 w-20 h-20 bg-gradient-to-br from-blue-500/20 to-transparent rounded-bl-full"></div>
+        <div class="flex items-center gap-4">
+          <div class="w-12 h-12 rounded-xl bg-blue-500/20 flex items-center justify-center">
+            <span class="text-2xl">👤</span>
+          </div>
+          <div>
+            <p class="text-gray-500 text-sm">用户总数</p>
+            <p class="text-3xl font-bold text-blue-500">{{ stats.userCount }}</p>
+          </div>
+        </div>
+      </div>
+
+      <div class="glass rounded-xl p-6 relative overflow-hidden">
+        <div class="absolute top-0 right-0 w-20 h-20 bg-gradient-to-br from-purple-500/20 to-transparent rounded-bl-full"></div>
+        <div class="flex items-center gap-4">
+          <div class="w-12 h-12 rounded-xl bg-purple-500/20 flex items-center justify-center">
+            <span class="text-2xl">👁️</span>
+          </div>
+          <div>
+            <p class="text-gray-500 text-sm">总访问量</p>
+            <p class="text-3xl font-bold text-purple-500">{{ stats.viewCount.toLocaleString() }}</p>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- 最近文章 -->
    <div class="glass rounded-xl p-6">
-        <h3 class="text-gray-600 dark:text-gray-400">总访问量</h3>
-        <p class="text-3xl font-bold text-acg-purple">0</p>
+      <h2 class="text-lg font-bold mb-4">最近文章</h2>
+      <div v-if="loading" class="text-center text-gray-500 py-4">加载中...</div>
+      <div v-else-if="recentPosts.length === 0" class="text-center text-gray-500 py-4">暂无文章</div>
+      <div v-else class="space-y-3">
+        <div
+          v-for="post in recentPosts"
+          :key="post.id"
+          class="flex items-center justify-between p-3 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+        >
+          <div class="flex items-center gap-3">
+            <div class="w-10 h-10 rounded-lg bg-acg-pink/10 flex items-center justify-center text-acg-pink">
+              📄
+            </div>
+            <div>
+              <RouterLink :to="`/post/${post.id}`" class="font-medium hover:text-acg-pink">
+                {{ post.title }}
+              </RouterLink>
+              <p class="text-sm text-gray-500">{{ formatDate(post.created_at) }}</p>
+            </div>
+          </div>
+          <span
+            :class="{
+              'bg-green-500/20 text-green-500': post.status === 'published',
+              'bg-yellow-500/20 text-yellow-500': post.status === 'draft',
+            }"
+            class="px-2 py-1 text-xs rounded-full"
+          >
+            {{ post.status === 'published' ? '已发布' : '草稿' }}
+          </span>
+        </div>
      </div>
    </div>
  </div>
--- a/frontend/src/views/admin/PostManage.vue
+++ b/frontend/src/views/admin/PostManage.vue
@@ -93,7 +93,7 @@ async function savePost() {
    closeEditor()
    fetchPosts()
  } catch (error: any) {
-    message.error(error.response?.data?.message || '保存失败')
+    message.error(error?.message || '保存失败')
  }
 }

--- a/frontend/src/views/admin/TagManage.vue
+++ b/frontend/src/views/admin/TagManage.vue
@@ -1,8 +1,171 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { useMessage, useDialog } from 'naive-ui'
+import type { Tag } from '@/types'
+
+const message = useMessage()
+const dialog = useDialog()
+
+const tags = ref<Tag[]>([])
+const loading = ref(false)
+const showModal = ref(false)
+const isEditing = ref(false)
+const currentId = ref<string | null>(null)
+
+const formData = ref({
+  name: '',
+  slug: '',
+})
+
+async function fetchTags() {
+  loading.value = true
+  try {
+    // 模拟数据 - 实际应该调用API
+    tags.value = []
+  } catch (error) {
+    message.error('获取标签失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+function openModal(tag?: Tag) {
+  if (tag) {
+    isEditing.value = true
+    currentId.value = tag.id
+    formData.value = {
+      name: tag.name,
+      slug: tag.slug || '',
+    }
+  } else {
+    isEditing.value = false
+    currentId.value = null
+    formData.value = { name: '', slug: '' }
+  }
+  showModal.value = true
+}
+
+function closeModal() {
+  showModal.value = false
+  isEditing.value = false
+  currentId.value = null
+  formData.value = { name: '', slug: '' }
+}
+
+async function saveTag() {
+  if (!formData.value.name || !formData.value.slug) {
+    message.warning('请填写名称和别名')
+    return
+  }
+
+  try {
+    if (isEditing.value && currentId.value) {
+      message.success('标签更新成功')
+    } else {
+      message.success('标签创建成功')
+    }
+    closeModal()
+    fetchTags()
+  } catch (error) {
+    message.error('保存失败')
+  }
+}
+
+async function deleteTag(_id: string) {
+  try {
+    await dialog.warning({
+      title: '确认删除',
+      content: '确定要删除这个标签吗？',
+      positiveText: '删除',
+      negativeText: '取消',
+    })
+    message.success('删除成功')
+    fetchTags()
+  } catch {
+    // 取消
+  }
+}
+
+function generateSlug() {
+  formData.value.slug = formData.value.name
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+}
+
+onMounted(() => {
+  fetchTags()
+})
+</script>
+
 <template>
  <div class="tag-manage">
-    <h1 class="text-2xl font-bold mb-6">标签管理</h1>
+    <div class="flex justify-between items-center mb-6">
+      <h1 class="text-2xl font-bold">标签管理</h1>
+      <button @click="openModal()" class="btn-acg">
+        新建标签
+      </button>
+    </div>
+
    <div class="glass rounded-xl p-6">
-      <p class="text-gray-600 dark:text-gray-400">标签管理功能开发中...</p>
+      <div v-if="loading" class="text-center text-gray-500 py-4">加载中...</div>
+      <div v-else-if="tags.length === 0" class="text-center text-gray-500 py-8">
+        <p class="mb-2">暂无标签</p>
+        <button @click="openModal()" class="text-acg-pink hover:underline">点击创建第一个标签</button>
+      </div>
+      <div v-else class="flex flex-wrap gap-3">
+        <div
+          v-for="tag in tags"
+          :key="tag.id"
+          class="inline-flex items-center gap-2 px-4 py-2 rounded-full bg-acg-pink/10 text-acg-pink"
+        >
+          <span>{{ tag.name }}</span>
+          <button @click="openModal(tag)" class="hover:text-white">✏️</button>
+          <button @click="deleteTag(tag.id)" class="hover:text-white">✕</button>
+        </div>
+      </div>
+    </div>
+
+    <!-- 弹窗 -->
+    <div v-if="showModal" class="fixed inset-0 z-50 flex items-center justify-center p-4 bg-black/50">
+      <div class="glass rounded-xl w-full max-w-md">
+        <div class="p-6">
+          <h2 class="text-xl font-bold mb-6">{{ isEditing ? '编辑标签' : '新建标签' }}</h2>
+
+          <form @submit.prevent="saveTag" class="space-y-4">
+            <div>
+              <label class="block text-sm font-medium mb-2">名称</label>
+              <input
+                v-model="formData.name"
+                type="text"
+                placeholder="标签名称"
+                class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800"
+                @blur="generateSlug"
+              />
+            </div>
+
+            <div>
+              <label class="block text-sm font-medium mb-2">别名</label>
+              <input
+                v-model="formData.slug"
+                type="text"
+                placeholder="url-slug"
+                class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800"
+              />
+            </div>
+
+            <div class="flex justify-end gap-4 pt-4">
+              <button type="button" @click="closeModal" class="px-6 py-2 rounded-lg border border-gray-300 dark:border-gray-600 hover:bg-gray-100 dark:hover:bg-gray-800">
+                取消
+              </button>
+              <button type="submit" class="btn-acg">
+                保存
+              </button>
+            </div>
+          </form>
+        </div>
+      </div>
    </div>
  </div>
 </template>
--- a/frontend/src/views/auth/Login.vue
+++ b/frontend/src/views/auth/Login.vue
@@ -23,7 +23,7 @@ async function handleLogin() {
    message.success('登录成功')
    router.push('/')
  } catch (error: any) {
-    message.error(error.response?.data?.message || '登录失败，请检查邮箱和密码')
+    message.error(error?.message || '登录失败，请检查邮箱和密码')
  } finally {
    loading.value = false
  }
--- a/frontend/src/views/auth/Register.vue
+++ b/frontend/src/views/auth/Register.vue
@@ -32,7 +32,7 @@ async function handleRegister() {
    message.success('注册成功，请登录')
    router.push('/login')
  } catch (error: any) {
-    message.error(error.response?.data?.message || '注册失败')
+    message.error(error?.message || '注册失败')
  } finally {
    loading.value = false
  }
--- a/frontend/src/views/user/Profile.vue
+++ b/frontend/src/views/user/Profile.vue
@@ -22,15 +22,16 @@ function formatDate(dateStr: string) {

 async function handleLogout() {
  try {
-    await dialog.confirm({
+    await dialog.warning({
      title: '提示',
      content: '确定要退出登录吗？',
-      confirmButtonText: '确定',
-      cancelButtonText: '取消',
+      positiveText: '确定',
+      negativeText: '取消',
    })
    await authApi.logout()
  } catch {
    // 用户取消
+    return
  }
  userStore.logout()
  message.success('已退出登录')
--- a/readme.md
+++ b/readme.md
@@ -1,124 +1,189 @@
-# 二次元风格博客技术文档
-打算自己写个博客博客项目练练手，并把原来博客的东西都搬过去，先把仓库和前端写了
+# ACG Blog - 二次元风格博客系统

-### 项目基本信息
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.11+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/FastAPI-0.110-green.svg" alt="FastAPI">
+  <img src="https://img.shields.io/badge/Vue-3.5-brightgreen.svg" alt="Vue">
+  <img src="https://img.shields.io/badge/TypeScript-5.9-blue.svg" alt="TypeScript">
+  <img src="https://img.shields.io/badge/Docker-Ready-blue.svg" alt="Docker">
+</p>

- **项目名称**：ACG Blog（二次元风格博客）
- **项目简介**：基于 **FastAPI** 与 **Vue 3** 的前后端分离博客系统，主打二次元视觉体验与高性能响应。支持 Markdown 文章发布、动态看板娘、访问量统计、热搜排行、深色模式切换等特色功能。
- **技术栈概览**：
-  - 后端：Python + FastAPI + SupaBase + Tortoise‑ORM + Redis + JWT
-  - 前端：Vue 3 (Vite) + Pinia + Naive UI + Tailwind CSS + GSAP
- **系统架构**：**B/S 架构**（Browser/Server，浏览器/服务器架构）
-  - 前端：单页应用（SPA）运行于浏览器
-  - 后端：RESTful API 服务器
-  - 通信协议：HTTP/HTTPS + JSON
- **后端架构模式**：**类 MVC 模式**
-  - **Model（模型层）**：`models/` 目录，Tortoise-ORM 数据模型定义
-  - **View（视图层）**：`api/endpoints/` 目录，FastAPI 路由返回 JSON 响应
-  - **Controller（控制器层）**：`api/endpoints/` 中的路由处理函数，协调业务逻辑
-  - **Service（服务层）**：`services/` 目录，封装核心业务（如看板娘互动、统计逻辑）
-  - **Schema（数据传输层）**：`schemas/` 目录，Pydantic 模型校验请求与响应
-  - **CRUD（数据操作层）**：`crud/` 目录，封装数据库增删改查逻辑，辅助 Model 层
-  - **Core（核心配置）**：`core/` 目录，管理环境变量、日志、JWT 安全等基础设施
- **开发状态**：规划中
+基于 **FastAPI** 与 **Vue 3** 的前后端分离博客系统，主打二次元视觉体验与高性能响应。支持 Markdown 文章发布、访问量统计、分类标签管理、深色模式切换等功能。

-> 详细技术选型及项目结构请参见下文。
+## 技术栈

-### 后端技术栈
+### 后端
+| 技术 | 说明 |
+|------|------|
+| FastAPI | 高性能异步 Web 框架 |
+| Tortoise-ORM | 异步 ORM，支持 PostgreSQL |
+| PostgreSQL | 关系型数据库 |
+| Redis | 缓存与会话存储 |
+| JWT | 无状态身份认证 |
+| Pydantic | 数据验证 |
+| Loguru | 日志处理 |

-| **模块**       | **技术选型**          | **说明**                                                     |
-| -------------- | --------------------- | ------------------------------------------------------------ |
-| **核心框架**   | **FastAPI**           | 高性能、原生异步（Async），满足二次元素材（图片/视频）的高并发加载需求。 |
-| **数据库**     | **SupaBace**          | **内置 Auth**，支持第三方登录 (Github/Google)                |
-| **ORM (异步)** | **Tortoise-ORM**      | 语法类似 Django，且原生支持异步操作。                        |
-| **缓存/任务**  | **Redis**             | 用于文章点击量统计、热搜排行以及 Session 存储。              |
-| **认证**       | **JWT (python-jose)** | 无状态认证，方便前后端分离部署。                             |
-| **数据校验**   | **Pydantic v2**       | 确保前端传来的数据不会让后端“炸掉”。                         |
-| **日志**       | **Loguru**            | 极简且强大的异步日志处理，便于排错                           |
+### 前端
+| 技术 | 说明 |
+|------|------|
+| Vue 3 | 组合式 API (Script Setup) |
+| Vite | 快速构建工具 |
+| TypeScript | 类型安全 |
+| Pinia | 状态管理 |
+| Naive UI | UI 组件库 |
+| Tailwind CSS | 样式引擎 |
+| Axios | HTTP 客户端 |

-###  前端技术栈 (The Visuals)
+## 项目结构

-| **模块**      | **技术选型**     | **说明**                                                     |
-| ------------- | ---------------- | ------------------------------------------------------------ |
-| **框架**      | **Vue 3 (Vite)** | 组合式 API (Script Setup) 开发体验极佳，构建速度快。         |
-| **状态管理**  | **Pinia**        | 轻量、简洁，存储用户偏好（如：深色/浅色模式、看板娘状态）。  |
-| **UI 组件库** | **Naive UI**     | 设计感极强，配置主题非常自由，适合定制二次元配色。           |
-| **样式引擎**  | **Tailwind CSS** | 极其方便编写自定义 UI。你可以轻松实现“毛玻璃”、“卡片悬浮”等特效。 |
-| **编辑器**    | **V-MD-Editor**  | 基于 Vue 3 的 Markdown 编辑器，支持预览、代码高亮和 LaTeX 公式。 |
-| **动画库**    | **GSAP**         | 强大的动效库。二次元风格需要细腻的入场和交互动画。           |
-
-### 预计项目结构
-
-```bash
-acg-blog/
-├── backend/                # FastAPI 后端项目
+```
+├── backend/                    # FastAPI 后端
 │   ├── app/
-│   │   ├── api/            # 接口层 (v1, v2...)
-│   │   │   ├── endpoints/  # 具体业务接口 (posts.py, users.py, etc.)
-│   │   │   └── api.py      # 路由汇总
-│   │   ├── core/           # 核心配置
-│   │   │   ├── config.py   # 环境变量与全局配置
-│   │   │   ├── logger.py   # 日志拦截与配置
-│   │   │   └── security.py # JWT 与权限相关
-│   │   ├── crud/           # 数据库增删改查逻辑
-│   │   ├── db/             # 数据库连接与初始化
-│   │   ├── models/         # Tortoise-ORM 数据库模型
+│   │   ├── api/endpoints/    # API 端点 (auth, posts, comments, users)
+│   │   ├── core/             # 核心配置 (config, security, database, logger)
+│   │   ├── crud/             # 数据库增删改查
+│   │   ├── models/           # Tortoise-ORM 数据模型
 │   │   ├── schemas/          # Pydantic 数据验证模型
-│   │   ├── services/       # 业务服务逻辑 (如：看板娘互动 API)
-│   │   └── main.py         # 后端入口
-│   ├── logs/               # 日志存储目录 (自动生成 .log 文件)
-│   ├── static/             # 静态资源 (用户上传的插图、头像)
-│   ├── tests/              # 测试用例
-│   ├── .env                # 敏感配置文件
-│   ├── pyproject.toml      # Poetry 配置或使用 requirements
-│   └── requirements.txt    # 依赖清单
-├── frontend/               # Vue 3 前端项目 (Vite)
-│   ├── public/             # 公共静态资源 (Live2D 模型、Favicon)
+│   │   └── main.py           # 应用入口
+│   ├── Dockerfile             # 后端容器配置
+│   ├── schema.sql             # 数据库建表脚本
+│   └── requirements.txt       # Python 依赖
+│
+├── frontend/                   # Vue 3 前端
 │   ├── src/
 │   │   ├── api/              # Axios 接口封装
-│   │   ├── assets/         # 样式、二次元字体、插画
-│   │   ├── components/     # 组件 (看板娘、播放器、卡片)
-│   │   ├── router/         # 路由配置
+│   │   ├── components/      # 公共组件
+│   │   ├── views/           # 页面视图
 │   │   ├── store/           # Pinia 状态管理
-│   │   ├── views/          # 页面布局 (首页、文章页、归档)
-│   │   ├── App.vue         # 根组件
-│   │   └── main.ts         # 前端入口
-│   ├── tailwind.config.js  # Tailwind CSS 配置
-│   └── package.json        # 前端依赖
-├── docker-compose.yml      # 全栈 Docker 编排
-└── README.md
+│   │   ├── router/          # 路由配置
+│   │   └── types/           # TypeScript 类型定义
+│   ├── Dockerfile            # 前端容器配置
+│   └── nginx.conf            # Nginx 配置
+│
+├── docker-compose.yml        # Docker 编排
+├── schema.sql                # 数据库建表脚本
+└── docker-deploy.md          # 部署文档
 ```

-### 后端requirements
+## 快速开始
+
+### 环境要求
+- Python 3.11+
+- Node.js 18+
+- PostgreSQL 14+
+- Redis 7+ (可选)
+
+### 本地开发
+
+**1. 克隆项目**
+```bash
+git clone <repository-url>
+cd acg-blog
+```
+
+**2. 启动后端**
+```bash
+cd backend
+
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# 或 venv\Scripts\activate  # Windows
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 配置环境变量
+cp .env.example .env  # 修改数据库连接信息
+
+# 初始化数据库 (确保 PostgreSQL 运行中)
+psql -U postgres -c "CREATE DATABASE acg_blog;"
+psql -U postgres -d acg_blog -f schema.sql
+
+# 启动服务
+uvicorn main:app --reload --port 8000
+```
+
+**3. 启动前端**
+```bash
+cd frontend
+
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm run dev
+```
+
+**4. 访问应用**
+- 前端: http://localhost:5173
+- 后端 API: http://localhost:8000
+- API 文档: http://localhost:8000/docs
+
+### Docker 部署

 ```bash
-# Web 框架 
-fastapi==0.110.0
-uvicorn[standard]==0.27.1
+# 启动所有服务
+docker-compose up -d

-# 数据库与异步 ORM
-tortoise-orm==0.20.0
-aerich==0.7.2              # 数据库迁移工具
-asyncpg==0.29.0            # PostgreSQL 驱动
-aioredis==2.0.1            # Redis 驱动 
-
-# 日志系统
-loguru==0.7.2              # 极简且强大的异步日志处理
-
-# 配置与安全
-pydantic[email]==2.6.3      # 包含 Email 校验
-pydantic-settings==2.2.1   # 处理 .env 环境变量
-python-jose[cryptography]==3.3.0  # JWT
-passlib[bcrypt]==1.7.4      # 密码哈希
-
-# 业务
-python-multipart==0.0.9     # 处理表单与文件上传
-mistune==3.0.2              # 快速 Markdown 解析
-pillow==10.2.0              # 处理图片 
-httpx==0.27.0               # 异步 HTTP 请求 
-
-# 开发与部署
-python-dotenv==1.0.1
-gunicorn==21.2.0           # 生产环境容器部署使用
+# 查看服务状态
+docker-compose ps
 ```

+访问 http://localhost 即可使用。
+
+## API 接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| POST | /api/v1/auth/register | 用户注册 |
+| POST | /api/v1/auth/login | 用户登录 |
+| POST | /api/v1/auth/refresh | 刷新 Token |
+| GET | /api/v1/auth/me | 获取当前用户 |
+| GET | /api/v1/posts | 获取文章列表 |
+| GET | /api/v1/posts/{id} | 获取文章详情 |
+| POST | /api/v1/posts | 创建文章 |
+| PUT | /api/v1/posts/{id} | 更新文章 |
+| DELETE | /api/v1/posts/{id} | 删除文章 |
+| GET | /api/v1/categories | 获取分类列表 |
+| GET | /api/v1/tags | 获取标签列表 |
+| GET | /api/v1/comments/post/{id} | 获取文章评论 |
+
+## 默认账户
+
+- 用户名: `admin`
+- 邮箱: `admin@acgblog.com`
+- 密码: `admin123`
+
+**请在部署后立即修改管理员密码！**
+
+## 功能特性
+
+- [x] 用户认证 (JWT)
+- [x] 文章管理 (CRUD)
+- [x] 分类与标签
+- [x] Markdown 编辑器
+- [x] 评论系统
+- [x] 浏览量统计
+- [x] 深色/浅色模式
+- [x] 响应式设计
+- [x] Docker 部署
+
+## 开发说明
+
+### 前端组件
+- `Navbar.vue` - 顶部导航栏
+- `Hero.vue` - 首页横幅
+- `PostCard.vue` - 文章卡片
+- `Sidebar.vue` - 侧边栏
+- `Footer.vue` - 页脚
+
+### 管理后台
+- `/admin/dashboard` - 仪表盘
+- `/admin/posts` - 文章管理
+- `/admin/categories` - 分类管理
+- `/admin/tags` - 标签管理
+
+## License
+
+MIT License
Author	SHA1	Message	Date
KiriAky 107	09d78f57a5	update readme	2026-03-31 22:41:08 +08:00
KiriAky 107	8f0d019627	完善docker部署	2026-03-31 22:29:38 +08:00
KiriAky 107	023380d14b	前端：完善 naive-ui 配置，修复 API 返回值访问方式，修复 Sidebar 硬编码数据，修复路由守卫逻辑，修复其他组件问题。	2026-03-31 22:23:03 +08:00
KiriAky 107	d10c823e23	完善前端	2026-03-30 22:47:45 +08:00