# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概述

这是一个基于 Hexo 静态站点生成器的个人技术博客，使用 Next 主题。博客主要包含 Java、前端开发（React）、架构设计等技术文章。

## 常用命令

### 开发与预览
```bash
# 启动本地开发服务器
npm run server
# 或
hexo server

# 清理生成的文件
npm run clean
# 或
hexo clean
```

### 构建与部署
```bash
# 生成静态文件
npm run build
# 或
hexo generate

# 部署到远程服务器
npm run deploy
# 或
hexo deploy
```

### 创建新文章
```bash
# 创建新文章（使用 scaffolds/post.md 模板）
hexo new post "文章标题"

# 创建草稿
hexo new draft "草稿标题"
```

## 目录结构

```
hexo-blog/
├── _config.yml           # Hexo 主配置文件
├── _config.landscape.yml # Landscape 主题配置（未使用）
├── source/               # 源文件目录
│   ├── _posts/          # 博客文章（Markdown 格式）
│   ├── _drafts/         # 草稿文章
│   ├── _discarded/      # 已废弃文章
│   ├── _data/           # 自定义数据文件
│   ├── images/          # 图片资源
│   ├── about/           # 关于页面
│   ├── categories/      # 分类页面
│   ├── tags/            # 标签页面
│   └── guestbook/       # 留言板页面
├── themes/
│   ├── next/            # Next 主题（当前使用）
│   └── landscape/       # Landscape 主题（备用）
├── scaffolds/           # 文章模板
│   └── post.md          # 默认文章模板
└── db.json              # hexo-admin 数据库文件
```

## 配置架构

### 主配置文件 (_config.yml)
- 设置站点标题、作者、语言等基本信息
- 配置 URL 和永久链接格式
- 启用插件：mermaid 图表、搜索、分享功能等
- 部署配置：部署到 VPS 服务器

### Next 主题配置 (themes/next/_config.yml)
- 使用 Mist scheme
- 自定义样式文件：source/_data/styles.styl
- 菜单配置：首页、关于、标签、分类等
- 启用百度推送、评论系统（Waline）、分享功能等

### 自定义样式 (source/_data/styles.styl)
- 文章块样式：圆角、阴影、透明效果
- 代码块样式：自定义颜色和边框
- 自定义文字样式类：highlight-text、wavy-underline、gradient-text 等
- 自定义分隔线样式：渐变、波浪、科技感等
- AI 标签样式：带闪光动画效果

## 文章格式

### Front Matter
每篇文章应包含以下元数据：
```yaml
---
title: 文章标题
author: Gamehu
tags:
  - 标签1
  - 标签2
categories:
  - 分类名
date: YYYY-MM-DD HH:mm:ss
---
```

### 文章资源
- 启用了 `post_asset_folder: true`，每篇文章可以有自己的资源文件夹
- 图片引用使用 `{% asset_img filename.png 描述 %}` 标签

## 主题定制

### 自定义文件路径
主题支持在 `source/_data/` 目录下创建自定义文件来覆盖主题默认设置：
- `styles.styl` - 自定义样式（已使用）
- `head.njk` - 自定义 head 标签内容
- `body-end.njk` - 自定义 body 结束标签前的内容
- 等等...

### 样式类
博客定义了多个自定义样式类，可在文章中使用：
- `.highlight-text` - 黄色背景标注
- `.wavy-underline` - 波浪下划线
- `.gradient-text` - 渐变色文字
- `.ai-tag` - AI 标签（带闪光效果）
- `.article-quote` - 引言样式
- `.divider-*` - 各种分隔线样式

## 部署

- 部署方式：Git deployer
- 部署目标：VPS 服务器（ssh://root@104.128.95.214:28915/home/git/blog.git, master 分支）
- SEO 配置：启用了 sitemap、baidu sitemap、RSS 订阅