60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
# 贡献指南
|
||
|
||
欢迎来到 Astral 3D 社区！以下是参与贡献的指南：
|
||
|
||
## 🛠️ 开发流程
|
||
|
||
### 环境要求
|
||
- Node.js 23.11+
|
||
- PNPM
|
||
|
||
### 代码规范
|
||
1. Git 提交信息格式：
|
||
```
|
||
<type>(<scope>): <subject>
|
||
- type: feat|fix|docs|style|refactor|test|chore
|
||
- scope: Editor|Preview|Home|SDK 等模块范围
|
||
- subject: 50字内简明描述
|
||
```
|
||
|
||
2. 前端规范：
|
||
- Vue 组件使用 Composition API
|
||
- TypeScript 严格模式
|
||
- CSS 使用 UnoCSS 原子化方案
|
||
|
||
## 🐛 问题报告
|
||
使用 [GitHub Issues](https://github.com/mlt131220/Astral3D/issues) 时请包含：
|
||
1. 环境信息（OS/浏览器/Node版本）
|
||
2. 重现步骤
|
||
3. 预期与实际行为
|
||
4. 相关截图/日志
|
||
|
||
## ✨ 功能建议
|
||
1. 在 Discussions 发起提案讨论
|
||
2. 提供使用场景描述
|
||
3. 如有原型设计请附示意图
|
||
|
||
## 🌐 国际化
|
||
添加新语言请按以下步骤：
|
||
1. 在 `src/language` 创建语言文件
|
||
2. 会以文件名作为语言标识符 注册新语言
|
||
3. 在 `src/components/setting/common/Locale.vue` 中添加新语言选项
|
||
4. 提交 Pull Request 并 @ 维护者
|
||
|
||
## 🔄 代码提交
|
||
1. Fork 仓库并创建特性分支
|
||
2. 编写单元测试（重要功能必须包含）
|
||
3. 执行代码检查：
|
||
```bash
|
||
pnpm lint
|
||
```
|
||
4. 发起 Pull Request 至 dev 分支
|
||
|
||
## 🏅 贡献者公约
|
||
请遵守 [贡献者公约](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)，我们承诺：
|
||
- 友好包容的交流环境
|
||
- 尊重不同的开发经验
|
||
- 建设性的技术讨论
|
||
|
||
## 💼 代码所有权
|
||
所有贡献代码默认遵循项目 Apache-2.0 协议，作者保留对代码库的最终管理权限。 |