acepanel.github.io/CLAUDE.md

CLAUDE.md

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

项目概述

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

常用命令

# 安装依赖
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。