# CLAUDE.md

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

## 项目概述

这是 AcePanel（服务器运维管理面板）的官方文档网站，使用 VitePress 构建，支持多语言（简体中文、繁体中文、英文）。

## 常用命令

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

# 预览构建结果
pnpm preview
```

## 项目架构

### 目录结构

- `en/` - 英文文档（源语言，Crowdin 翻译源）
- `zh_CN/` - 简体中文文档
- `zh_TW/` - 繁体中文文档
- `.vitepress/config/` - VitePress 配置
  - `index.ts` - 主配置入口，定义多语言 locales
  - `shared.ts` - 共享配置（markdown 插件、主题配置等）
  - `en.ts` / `zh_CN.ts` / `zh_TW.ts` - 各语言独立配置（导航、侧边栏）
- `.vitepress/theme/` - 自定义主题扩展
- `public/` - 静态资源

### 多语言机制

- 简体中文 (`zh_CN`) 是根路由，通过 `rewrites` 配置映射到根路径
- 英文和繁体中文分别在 `/en/` 和 `/zh_TW/` 路径下
- 使用 Crowdin 进行翻译管理，英文为源语言

### 版本历史

版本数据从 `https://api.acepanel.net/versions` API 动态获取，在配置文件构建时拉取最新 10 个版本。

### 使用的 VitePress 插件

- `@shikijs/vitepress-twoslash` - TypeScript 代码悬浮提示
- `vitepress-plugin-group-icons` - 代码块分组图标
- `vitepress-markdown-timeline` - 时间线组件

## 部署

推送到 `main` 分支会自动触发 GitHub Actions 部署到 GitHub Pages。