TkAstral3D/CONTRIBUTING.md

贡献指南

欢迎来到 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 时请包含：

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. 执行代码检查：

   pnpm lint
   

4. 发起 Pull Request 至 dev 分支

🏅 贡献者公约

请遵守 贡献者公约，我们承诺：

• 友好包容的交流环境
• 尊重不同的开发经验
• 建设性的技术讨论

💼 代码所有权

所有贡献代码默认遵循项目 Apache-2.0 协议，作者保留对代码库的最终管理权限。