# Contributing to LingXu

感谢你有兴趣为灵墟项目做出贡献！

## 🌟 贡献方式

### 内容贡献

我们欢迎以下类型的内容贡献：

- **玄学知识** - 易经、八字、风水等专业知识
- **历史资料** - 朝代历史、人物传记、古籍文献
- **神话故事** - 洪荒神话、仙侠传说、神兽故事
- **修炼体系** - 功法设计、境界划分、丹药配方
- **翻译** - 将内容翻译成其他语言

### 代码贡献

1. **Fork** 本仓库
2. **Clone** 你 Fork 的仓库
3. 创建**特性分支** (`git checkout -b feature/amazing-feature`)
4. **Commit** 你的更改 (`git commit -m 'Add amazing feature'`)
5. **Push** 到分支 (`git push origin feature/amazing-feature`)
6. 提交 **Pull Request**

### 设计贡献

- UI/UX 改进
- 动画效果
- 图标和插画
- Logo 设计

---

## 📋 开发指南

### 环境要求

- Node.js >= 18.0.0
- pnpm >= 8.0.0

### 本地开发

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建项目
pnpm build

# 代码检查
pnpm lint
```

### 代码规范

- 使用 TypeScript 编写代码
- 遵循 ESLint 规则
- 组件使用函数式组件 + Hooks
- 样式使用 SCSS Modules 或 Tailwind CSS
- 提交信息使用约定式提交格式

### 目录结构

```
src/
├── components/     # React 组件
├── hooks/          # 自定义 Hooks
├── lib/            # 工具函数和常量
├── pages/          # Next.js 页面
├── stores/         # Zustand 状态
└── styles/         # 全局样式
```

---

## 🎯 贡献优先级

### 高优先级

- [ ] 完善易经六十四卦内容
- [ ] 实现八字排盘功能
- [ ] 添加风水罗盘交互
- [ ] 编写神兽图鉴内容
- [ ] 优化移动端体验

### 中优先级

- [ ] 添加更多占卜方式
- [ ] 完善历史朝代内容
- [ ] 实现修炼模拟器
- [ ] 添加符箓生成器

### 低优先级

- [ ] 添加英文翻译
- [ ] 优化动画性能
- [ ] 添加更多粒子效果

---

## 📝 内容指南

### 玄学内容

- 尊重传统文化，不做误导性解读
- 标注内容来源，区分经典原文和现代解读
- 保持客观中立，不宣扬迷信

### 历史内容

- 确保史实准确
- 标注史料来源
- 区分正史和野史

### 神话内容

- 标注出处（《山海经》、《封神演义》等）
- 区分不同版本的神话故事
- 创作内容需标注"原创"

---

## 🤝 行为准则

- 尊重所有贡献者
- 保持友善和包容
- 接受建设性批评
- 关注项目本身，而非个人

---

## 📞 联系方式

- GitHub Issues: 提交 Bug 或功能建议
- GitHub Discussions: 讨论想法和问题
- Pull Requests: 提交代码贡献

---

再次感谢你的贡献！🙏