3.7 KiB
贡献指南
感谢您对 Furion 项目的关注和贡献！本指南将指导您如何有效参与到项目中来，共同构建更强大的开源框架。
错误报告
若您在 Furion 中发现了非安全相关的漏洞，请首先在 Furion 仓库的 Issues 中搜索以确认该问题尚未被提交。若未找到相似问题，请创建一个新的 Issue，并详尽描述漏洞详情、重现步骤及环境信息。
安全问题处理
对于安全问题的披露，请遵循以下流程：
- 收集信息：尽可能详细地记录漏洞的描述、影响范围、可能的攻击方法等信息。您可以在报告中提供相关的截图、日志文件等辅助信息。
- 联系方式：请您提供您的联系方式，以便我们与您进行进一步的沟通和反馈。您可以在报告中留下您的电子邮件地址、社交媒体账号或其他可靠的联系方式。
- 发送报告：请将您的安全漏洞报告发送至我们指定的安全邮箱 (monksoul@outlook.com) 或报告渠道（作者微信：ibaiqian）。如果我们有提供特定的报告指南或漏洞报告表格，请您按照指示进行报告。如果没有特定的指引，您可以通过邮件发送报告给我们的安全团队。
- 等待回复：我们将尽快收到您的报告后进行评估，并在确认漏洞的准确性后与您联系。请理解我们可能需要一些时间来进行调查和修复漏洞，我们会及时地与您保持沟通并提供进展更新。
解决现有问题
欢迎您浏览仓库的 Issues 列表，挑选并尝试解决其中的问题。一旦解决问题，请提交 Pull Request，并在描述中关联到原始的 Issue 编号。
提出新功能建议
我们鼓励通过 Issues 来提议新功能，并使用 "Feature/新特性" 标签标记。另外，也可以通过邮件（请参阅项目文档获取联系方式）向我们发送您的建议。项目团队会在评估后，将确认开发的新功能纳入下一个版本的计划任务列表。
开发环境搭建与测试运行
从 git clone https://gitee.com/dotnetchina/Furion.git 开始，参照我们的 开发环境配置 设置 IDE 和其他相关环境。运行测试时，请按照 测试指南 操作。
变更日志撰写规则
- 使用现在时态描述变更。
- 首行简洁扼要，字数适中。
- 描述变更内容需准确、完整，符合项目的变更日志规范。
编码约定
遵循项目内的编码约定，具体见 .editorconfig 文件。
分支管理约定
我们采用 GitFlow 分支管理模式进行开发，详细规定见 分支管理。
合并 Pull Request 的流程
当满足以下条件时，您的 Pull Request 可以被合并至 master/main 分支：
- 通过持续集成 (CI) 测试。
- 至少获得两位维护者的批准。
- 确保与最新版本兼容且无冲突。
重要提示：无论您是修复了 bug 还是改进了功能，我们都强烈建议您将更改同步回上游（即 Furion 主仓库）。请在完成工作后通过 Pull Request 或邮件通知我们，我们将迅速进行审核并考虑合并您的改动。
请尊重并遵守我们的 行为准则，让我们共同营造一个友善、合作的开源社区氛围。感谢您的每一次贡献，若有任何疑问或需要协助，请随时联系我们。