# 贡献指南

[English](#contributing-guidelines) | 中文

感谢你对 Awesome AI 工具库的关注！我们欢迎所有形式的贡献。

## 如何贡献

### 提交新工具

1. **确保工具质量**
   - 工具必须是可用的（链接有效）
   - 工具应该有一定的用户基础或独特价值
   - 优先考虑有官方支持或活跃维护的工具

2. **格式要求**
   - 按照现有表格格式添加工具信息
   - 包含：工具名称、描述、访问方式、定价、链接
   - 使用正确的图标标记（见下方说明）

3. **图标说明**
   ```
   访问性：🌍 全球可用 | 🇨🇳 国内可用 | 🪜 需要科学上网
   定价：💰 免费使用 | 💳 订阅制 | 💎 按量付费
   状态：🔥 当前热门 | 🆕 2024-2025新品 | ⚡ 推荐首选
   ```

### 提交 Issue

- **新工具推荐**：使用「工具推荐」模板
- **链接失效**：使用「链接问题」模板
- **分类建议**：使用「功能建议」模板
- **其他问题**：使用「Bug 报告」模板

### 提交 Pull Request

1. Fork 本仓库
2. 创建你的功能分支 (`git checkout -b feature/add-new-tool`)
3. 提交你的更改 (`git commit -m 'Add: 新工具名称'`)
4. 推送到分支 (`git push origin feature/add-new-tool`)
5. 创建 Pull Request

### Commit 规范

请使用以下格式：
- `Add: 添加新工具描述`
- `Update: 更新现有工具信息`
- `Fix: 修复链接或错误`
- `Docs: 更新文档`

## 分类标准

| 分类 | 包含内容 |
|------|---------|
| AI 对话与智能体 | 聊天机器人、对话模型、AI 助手 |
| AI 图像创作 | 图像生成、编辑、风格转换 |
| AI 视频制作 | 视频生成、编辑、特效 |
| AI 编程助手 | 代码补全、代码生成、开发工具 |
| AI 音乐与音频 | 音乐生成、语音合成、音频处理 |
| AI 办公效率 | 文档处理、演示制作、数据分析 |
| 开发者工具 | API、SDK、集成方案 |
| 学习资源 | 教程、社区、文档 |

## 质量标准

我们会根据以下标准审核提交的工具：

- ✅ 链接有效且可访问
- ✅ 工具有实际使用价值
- ✅ 描述准确且客观
- ✅ 分类正确
- ✅ 没有重复

## 行为准则

请参阅我们的 [行为准则](CODE_OF_CONDUCT.md)。

---

# Contributing Guidelines

English | [中文](#贡献指南)

Thank you for your interest in contributing to Awesome AI! We welcome all contributions.

## How to Contribute

### Submitting New Tools

1. **Ensure Quality**
   - The tool must be accessible (valid link)
   - The tool should have a user base or unique value
   - Prefer officially supported or actively maintained tools

2. **Format Requirements**
   - Follow the existing table format
   - Include: tool name, description, accessibility, pricing, link
   - Use correct icon markers (see below)

3. **Icon Guide**
   ```
   Accessibility: 🌍 Global | 🇨🇳 China | 🪜 VPN Required
   Pricing: 💰 Free | 💳 Subscription | 💎 Pay-as-you-go
   Status: 🔥 Hot | 🆕 New (2024-2025) | ⚡ Recommended
   ```

### Submitting Issues

- **New Tool Recommendation**: Use the "Tool Recommendation" template
- **Broken Links**: Use the "Link Issue" template
- **Category Suggestions**: Use the "Feature Request" template
- **Other Issues**: Use the "Bug Report" template

### Submitting Pull Requests

1. Fork this repository
2. Create your feature branch (`git checkout -b feature/add-new-tool`)
3. Commit your changes (`git commit -m 'Add: New Tool Name'`)
4. Push to the branch (`git push origin feature/add-new-tool`)
5. Create a Pull Request

### Commit Convention

Please use this format:
- `Add: Description of new tool`
- `Update: Update existing tool info`
- `Fix: Fix links or errors`
- `Docs: Update documentation`

## Quality Standards

We review submitted tools based on:

- ✅ Valid and accessible links
- ✅ Practical use value
- ✅ Accurate and objective descriptions
- ✅ Correct categorization
- ✅ No duplicates

## Code of Conduct

Please read our [Code of Conduct](CODE_OF_CONDUCT.md).

---

感谢你的贡献！/ Thank you for contributing!
