fix: build

Author: overtrue

.cursorrules

@@ -1,92 +1,97 @@
-# RustFS.com 项目 Cursor Rules
+# RustFS.com 项目开发规范
 
-## 核心目标
-这套 Cursor rule 适用于所有编程任务，要求工程师以**高级工程师的视角**，严格按照流程执行任务，确保代码改动精准、高效，且不会引入问题或不必要的复杂性。
+## 📋 项目概述
 
-## 规则的五个关键步骤
+RustFS.com 是一个基于 Next.js 的现代化分布式存储系统官网，采用 TypeScript + Tailwind CSS 技术栈，支持深色模式和响应式设计。
 
-### 1. 明确任务范围
-- 在写代码前，先分析任务，明确目标
-- 制定清晰的计划，列出需要修改的函数、模块或组件，并说明原因
-- 只有在计划清晰且经过深思熟虑后，才开始写代码
+## 🎯 核心开发原则
 
-### 2. 精准定位代码修改点
-- 确定需要修改的具体文件和代码行
-- 避免无关文件的改动，若涉及多个文件，需明确说明每个文件的改动理由
-- 除非任务明确要求，否则不创建新抽象或重构代码
+### 五大执行步骤
 
-### 3. 最小化、隔离化的代码改动
-- 只编写任务直接所需的代码
-- 避免添加不必要的日志、注释、测试、待办事项或错误处理
-- 不要进行"顺手"的额外修改，确保新代码不干扰现有功能
+#### 1. 任务分析与规划
+- **明确目标**：在开始编码前，深入理解任务需求和预期结果
+- **制定计划**：列出需要修改的具体文件、组件和函数，说明修改原因
+- **风险评估**：评估改动对现有功能的影响，制定回滚方案
 
-### 4. 严格检查代码
-- 检查代码的正确性、是否符合任务范围，以及是否会引发副作用
-- 确保代码与现有代码风格一致，防止破坏已有功能
-- 评估改动是否会影响下游系统
+#### 2. 精准代码定位
+- **文件识别**：确定需要修改的具体文件和代码行号
+- **影响分析**：避免无关文件的改动，明确每个文件的修改理由
+- **最小化原则**：除非任务明确要求，否则不创建新的抽象层或重构现有代码
 
-### 5. 清晰交付成果
-- 总结改动的具体内容和原因
-- 列出所有修改的文件及其具体变更
-- 说明任何假设或潜在风险，供他人审查
+#### 3. 最小化代码改动
+- **专注核心**：只编写任务直接所需的代码
+- **避免冗余**：不添加不必要的日志、注释、测试或错误处理
+- **隔离性**：确保新代码不会干扰现有功能，保持代码的独立性
 
-## 核心原则
-- **不即兴发挥**：严格按照任务要求执行，不随意创新
-- **不过度设计**：避免复杂化，只做必要的工作
-- **不偏离规则**：始终遵循这套流程，确保代码安全、可靠
+#### 4. 严格代码审查
+- **正确性检查**：验证代码逻辑的正确性和完整性
+- **风格一致性**：确保代码符合项目既定的编码风格
+- **副作用评估**：评估改动对下游系统的影响
+
+#### 5. 清晰交付文档
+- **变更总结**：详细说明所有修改的内容和原因
+- **文件清单**：列出所有修改的文件及其具体变更
+- **风险说明**：标注任何假设或潜在风险点
+
+### 核心原则
+- **🎯 精准执行**：严格按照任务要求执行，不随意创新
+- **⚡ 高效开发**：避免过度设计，只做必要的工作
+- **🛡️ 安全可靠**：始终遵循开发流程，确保代码质量和系统稳定性
+- **🔒 谨慎修改**：明确知道需要修改才改，没把握就不要动已有的代码
 
 ---
 
-## 项目技术规范
+## 🛠️ 技术栈规范
 
-### 技术栈
+### 核心技术
 - **框架**: Next.js 15.3.4 (App Router)
-- **语言**: TypeScript (ES2017+)
-- **UI**: Tailwind CSS 4 + shadcn/ui
+- **语言**: TypeScript (ES2017+, 严格模式)
+- **样式**: Tailwind CSS 4 + shadcn/ui
 - **图标**: Lucide React
-- **主题**: next-themes (支持深色模式)
+- **主题**: next-themes (深色模式支持)
 - **动画**: motion + tw-animate-css
 - **国际化**: 中文为主 (lang="zh-CN")
 
-### 项目结构约定
+### 项目目录结构
 ```
-app/                    # Next.js App Router 目录
-├── components/         # 页面级组件
-│   ├── buttons/       # 按钮组件
-│   └── *.tsx         # 功能组件
-├── layout.tsx         # 根布局
-├── page.tsx          # 首页
-└── globals.css       # 全局样式
-
-components/            # 通用组件库
-├── ui/               # shadcn/ui 组件
-└── magicui/         # 自定义 UI 组件
-
-data/                 # 静态数据
-├── features.tsx      # 产品功能数据
-├── reviews.json      # 用户评价
-└── *.json           # 其他配置数据
-
-lib/                  # 工具函数
-└── utils.ts         # Tailwind merge 等工具
-
-public/              # 静态资源
-├── images/          # 图片资源
-└── svgs/           # SVG 图标
+rustfs.com/
+├── app/                    # Next.js App Router 目录
+│   ├── components/         # 页面级组件
+│   │   ├── buttons/       # 按钮组件集合
+│   │   └── *.tsx         # 功能组件
+│   ├── download/          # 下载页面
+│   ├── layout.tsx         # 根布局
+│   ├── page.tsx          # 首页
+│   └── globals.css       # 全局样式
+├── components/            # 通用组件库
+│   ├── ui/               # shadcn/ui 组件
+│   └── magicui/         # 自定义 UI 组件
+├── data/                 # 静态数据
+│   ├── features.tsx      # 产品功能数据
+│   ├── reviews.json      # 用户评价
+│   └── *.json           # 其他配置数据
+├── lib/                  # 工具函数
+│   └── utils.ts         # Tailwind merge 等工具
+└── public/              # 静态资源
+    ├── images/          # 图片资源
+    └── svgs/           # SVG 图标
 ```
 
-### 代码风格规范
+---
+
+## 📝 编码规范
+
+### TypeScript 规范
+- **严格模式**: 启用 `"strict": true` 配置
+- **语法版本**: 优先使用 ES2017+ 语法特性
+- **组件定义**: 使用箭头函数或 `export default function`
+- **类型导入**: 使用 `import type { }` 语法
 
-#### TypeScript 约定
-- 使用严格模式 (`"strict": true`)
-- 优先使用 ES2017+ 语法
-- 函数组件使用箭头函数或 `export default function`
-- 类型导入使用 `import type { }`
+### React 组件规范
 
-#### React 组件规范
+#### 标准组件结构
 ```typescript
-// ✅ 推荐的组件结构
-'use client' // 客户端组件需要标注
+'use client' // 客户端组件必须标注
 
 import { ComponentProps } from 'react'
 import { cn } from '@/lib/utils'
@@ -109,42 +114,11 @@ export default function ComponentName({
 }
 ```
 
-#### Tailwind CSS 规范
-- 使用 `cn()` 函数合并类名
-- 优先使用 Tailwind 类，避免自定义 CSS
-- 响应式设计：`sm:` `md:` `lg:` `xl:`
-- 深色模式：`dark:` 前缀
-- 主题色彩：`primary` `secondary` `muted-foreground` 等语义化颜色
-
-#### 样式约定
-```typescript
-// ✅ 正确的样式写法
-className={cn(
-  "base-classes",
-  "responsive sm:class md:class lg:class",
-  "dark:class dark:hover:class",
-  conditionalClass && "conditional-class",
-  className // 允许外部覆盖
-)}
-```
-
-### 内容规范
-- **语言**: 所有用户界面文本使用中文
-- **术语**: 统一使用 "RustFS" (不是 rustfs 或 Rustfs)
-- **链接**: 文档链接统一指向 `https://docs.rustfs.com`
-- **品牌**: 保持与分布式存储系统的专业形象一致
-
-### 文件命名约定
-- 组件文件：`kebab-case.tsx` (如 `app-header.tsx`)
-- 数据文件：`kebab-case.json` 或 `.tsx`
-- 工具函数：`camelCase.ts`
-- 页面文件：遵循 Next.js App Router 约定
-
-### 导入顺序
+#### 导入顺序规范
 ```typescript
 // 1. React 相关
 import React from 'react'
-import { useState } from 'react'
+import { useState, useEffect } from 'react'
 
 // 2. Next.js 相关
 import Link from 'next/link'
@@ -162,38 +136,101 @@ import { Button } from '@/components/ui/button'
 import type { ComponentProps } from 'react'
 ```
 
-### 性能要求
-- 图片使用 Next.js `Image` 组件优化
-- 客户端组件最小化，优先服务端渲染
-- 懒加载大型组件和数据
-- 避免不必要的重渲染
-
-### 禁止事项
-- ❌ 不要修改 `components.json` shadcn/ui 配置
-- ❌ 不要在组件中硬编码数据，使用 `data/` 目录
-- ❌ 不要破坏现有的深色模式支持
-- ❌ 不要使用内联样式，统一使用 Tailwind
-- ❌ 不要忽略 TypeScript 类型错误
-- ❌ 不要修改已有的 API 接口和配置结构
-
-### 提交要求
-- 每次修改需要说明影响的组件和页面
-- 确保深色模式正常工作
-- 确保响应式布局不被破坏
-- 验证中文内容显示正确
+### Tailwind CSS 规范
+
+#### 样式编写约定
+```typescript
+// ✅ 推荐的样式写法
+className={cn(
+  "base-classes",
+  "responsive sm:class md:class lg:class",
+  "dark:class dark:hover:class",
+  conditionalClass && "conditional-class",
+  className // 允许外部覆盖
+)}
+```
+
+#### 响应式设计
+- **断点**: `sm:` (640px) `md:` (768px) `lg:` (1024px) `xl:` (1280px)
+- **深色模式**: 使用 `dark:` 前缀
+- **主题色彩**: 使用语义化颜色 `primary` `secondary` `muted-foreground`
+
+### 文件命名规范
+- **组件文件**: `kebab-case.tsx` (如 `app-header.tsx`)
+- **数据文件**: `kebab-case.json` 或 `.tsx`
+- **工具函数**: `camelCase.ts`
+- **页面文件**: 遵循 Next.js App Router 约定
+
+---
+
+## 🎨 内容与品牌规范
+
+### 语言与术语
+- **界面语言**: 所有用户界面文本使用中文
+- **品牌名称**: 统一使用 "RustFS" (首字母大写)
+- **文档链接**: 统一指向 `https://docs.rustfs.com`
+- **品牌形象**: 保持分布式存储系统的专业形象
+
+### 性能优化要求
+- **图片优化**: 使用 Next.js `Image` 组件
+- **服务端渲染**: 优先使用 SSR，最小化客户端组件
+- **懒加载**: 对大型组件和数据实施懒加载
+- **重渲染优化**: 避免不必要的组件重渲染
 
 ---
 
-## 执行检查清单
+## ⚠️ 禁止事项
 
-在每次代码改动前，请确认：
-1. ✅ 已明确理解任务目标和范围
-2. ✅ 已制定清晰的修改计划
-3. ✅ 代码符合项目技术规范
-4. ✅ 遵循组件和样式约定
-5. ✅ 不会破坏现有功能
-6. ✅ 通过 TypeScript 类型检查
-7. ✅ 响应式和深色模式兼容
-8. ✅ 中文内容正确显示
+### 严格禁止
+- ❌ 修改 `components.json` shadcn/ui 配置文件
+- ❌ 在组件中硬编码数据，必须使用 `data/` 目录
+- ❌ 破坏现有的深色模式支持
+- ❌ 使用内联样式，统一使用 Tailwind CSS
+- ❌ 忽略 TypeScript 类型错误
+- ❌ 修改已有的 API 接口和配置结构
+
+### 开发注意事项
+- ❌ 不要进行"顺手"的额外修改
+- ❌ 不要添加不必要的日志或注释
+- ❌ 不要创建任务范围外的抽象层
+- ❌ **不要修改已有代码，除非明确知道需要修改**
+- ✅ **只有在明确知道需要修改且有把握的情况下才改动现有代码**
+
+---
+
+## 📋 质量检查清单
+
+### 代码改动前检查
+1. ✅ **任务理解**: 已明确理解任务目标和范围
+2. ✅ **计划制定**: 已制定清晰的修改计划
+3. ✅ **技术规范**: 代码符合项目技术规范
+4. ✅ **编码风格**: 遵循组件和样式约定
+5. ✅ **功能保护**: 不会破坏现有功能
+6. ✅ **类型安全**: 通过 TypeScript 类型检查
+7. ✅ **响应式兼容**: 响应式布局和深色模式兼容
+8. ✅ **内容正确**: 中文内容显示正确
+9. ✅ **修改必要性**: 明确知道需要修改且有把握
+
+### 提交前验证
+- ✅ 所有修改的文件已列出
+- ✅ 深色模式功能正常
+- ✅ 响应式布局无异常
+- ✅ 中文内容显示正确
+- ✅ 无 TypeScript 错误
+- ✅ 无控制台警告
+
+---
+
+## 🎯 核心要求
+
+**精准、高效、不引入复杂性** - 这是我们的开发准则。
+
+每次代码改动都应该：
+- 🎯 **精准**: 只修改任务要求的代码
+- ⚡ **高效**: 避免不必要的复杂化
+- 🛡️ **安全**: 确保系统稳定性和代码质量
+- 🔒 **谨慎**: 明确知道需要修改才改，没把握就不要动已有的代码
+
+---
 
-记住：**精准、高效、不引入复杂性** 是我们的核心要求。
+*最后更新: 2024年12月*

LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2024 rustfs team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For questions or support, please contact: hello@rustfs.com