first

CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# 贡献指南
+
+感谢你对本项目的兴趣！我们欢迎任何形式的贡献，无论是报告 bug、提交功能请求、改进文档，还是直接提交代码。为了使贡献过程更加顺利，请按照以下指南进行操作。
+
+## 如何开始
+
+1. **Fork 项目**：首先将项目 `Fork` 到你的 `GitHub` 账户。
+2. **克隆到本地**：将你 `Fork` 后的仓库克隆到本地。
+   ```bash
+   git clone https://github.com/你的用户名/uniapp-vue3-template.git
+   ```
+3. **创建分支**：在进行任何修改之前，先创建一个新的分支。
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+4. **进行修改**：根据你的需求进行代码修改或文档编辑。
+5. **提交更改**：完成修改后，使用以下命令提交更改：
+   ```bash
+   pnpm cz
+   ```
+6. **推送分支**：将你的分支推送到 GitHub。
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+7. **创建 Pull Request**：在 `GitHub` 上，提交你的 `Pull Request`，描述清楚你所做的更改。
+
+## 提交代码规范
+
+- **代码格式**：只要你安装了依赖项，就不用担心代码风格。`Git` 钩子会在提交时为你格式化和修复它们。
+- **简洁明了的提交信息**：提交信息应简明扼要，说明改动的目的和内容。建议使用以下格式：
+  ```
+  [类型]：简要说明
+  ```
+  例如：
+  ```
+  feat: 添加新功能
+  fix: 修复 bug
+  docs: 更新文档
+  style: 格式调整
+  perf: 性能优化
+  refactor: 代码重构
+  test: 添加/修改测试
+  ci: 持续集成、工作流
+  revert: 撤销更改
+  chore: 其他修改（更新依赖、修改配置等）
+  ```
+
+## 贡献前请注意
+
+- **讨论功能请求**：在提交功能请求之前，确保这个功能是项目当前的方向。
+- **修复 bug**：在修复 `bug` 之前，先检查现有的 `issue` 列表，看看是否有人已经报告了相同的问题。
+- **文档改进**：欢迎任何形式的文档改进。文档有时会被遗漏，但它对于项目的可用性至关重要。
+
+## 测试
+
+在提交 `Pull Request` 之前，请确保测试成功通过。如果有修改涉及到核心功能，请确保你的改动不会破坏现有的功能。
+
+## 行为规范
+
+希望在这个项目中创建一个友好和包容的社区。请遵循以下行为准则：
+
+- 尊重他人，避免人身攻击、歧视或骚扰。
+- 提供有建设性的反馈，不论是代码还是讨论。
+- 对不同的观点保持开放的态度，愿意倾听他人的建议。
+
+## 相关文档
+
+- [项目主页](https://github.com/oyjt/uniapp-vue3-template)
+- [问题追踪](https://github.com/oyjt/uniapp-vue3-template/issues)
+
+感谢你的贡献！期待与你的合作！