贡献指南

感谢您对 Furion 项目的关注和贡献！本指南将指导您如何有效参与到项目中来，共同构建更强大的开源框架。

错误报告

若您在 Furion 中发现了非安全相关的漏洞，请首先在 Furion 仓库的 Issues 中搜索以确认该问题尚未被提交。若未找到相似问题，请创建一个新的 Issue，并详尽描述漏洞详情、重现步骤及环境信息。

安全问题处理

对于安全问题的披露，请遵循以下流程：

1. 收集信息：尽可能详细地记录漏洞的描述、影响范围、可能的攻击方法等信息。您可以在报告中提供相关的截图、日志文件等辅助信息。
2. 联系方式：请您提供您的联系方式，以便我们与您进行进一步的沟通和反馈。您可以在报告中留下您的电子邮件地址、社交媒体账号或其他可靠的联系方式。
3. 发送报告：请将您的安全漏洞报告发送至我们指定的安全邮箱 (monksoul@outlook.com) 或报告渠道（作者微信：ibaiqian）。如果我们有提供特定的报告指南或漏洞报告表格，请您按照指示进行报告。如果没有特定的指引，您可以通过邮件发送报告给我们的安全团队。
4. 等待回复：我们将尽快收到您的报告后进行评估，并在确认漏洞的准确性后与您联系。请理解我们可能需要一些时间来进行调查和修复漏洞，我们会及时地与您保持沟通并提供进展更新。

解决现有问题

欢迎您浏览仓库的 Issues 列表，挑选并尝试解决其中的问题。一旦解决问题，请提交 Pull Request，并在描述中关联到原始的 Issue 编号。

提出新功能建议

我们鼓励通过 Issues 来提议新功能，并使用 "Feature/新特性" 标签标记。另外，也可以通过邮件（请参阅项目文档获取联系方式）向我们发送您的建议。项目团队会在评估后，将确认开发的新功能纳入下一个版本的计划任务列表。

开发环境搭建与测试运行

从 git clone https://gitee.com/dotnetchina/Furion.git 开始，参照我们的 开发环境配置 设置 IDE 和其他相关环境。运行测试时，请按照 测试指南 操作。

变更日志撰写规则

1. 使用现在时态描述变更。
2. 首行简洁扼要，字数适中。
3. 描述变更内容需准确、完整，符合项目的变更日志规范。

编码约定

遵循项目内的编码约定，具体见 .editorconfig 文件。

分支管理约定

我们采用 GitFlow 分支管理模式进行开发，详细规定见 分支管理。

合并 Pull Request 的流程

当满足以下条件时，您的 Pull Request 可以被合并至 master/main 分支：

1. 通过持续集成 (CI) 测试。
2. 至少获得两位维护者的批准。
3. 确保与最新版本兼容且无冲突。

重要提示：无论您是修复了 bug 还是改进了功能，我们都强烈建议您将更改同步回上游（即 Furion 主仓库）。请在完成工作后通过 Pull Request 或邮件通知我们，我们将迅速进行审核并考虑合并您的改动。

请尊重并遵守我们的 行为准则，让我们共同营造一个友善、合作的开源社区氛围。感谢您的每一次贡献，若有任何疑问或需要协助，请随时联系我们。