sangge/BackDoorBuster
sangge/BackDoorBuster
1
0
Fork 0
Code Issues Pull Requests Projects 1 Activity
BackDoorBuster/CONTRIBUTING.MD
sangge-win ca017e211f add contributing file
2024-04-17 00:34:56 +08:00

5.1 KiB
Raw Permalink Blame History

对 BackDoorBuster 的贡献指南

我们欢迎大家对我们的项目作出贡献！本文档提供了贡献指南，以确保每位贡献者都能顺利进行合作。

开始之前

在开始之前，请确保：

  • 安装好 python 环境
  • 熟悉使用 git 进行版本控制（Git 文档）。

如何贡献

报告问题

在创建问题报告之前，请先检查已有的问题列表，看看是否已经有人报告了相同的问题。创建问题报告时，请尽可能包括更多细节：

  • 使用清晰和描述性的标题。
  • 描述复现问题的确切步骤，包括尽可能多的细节。
  • 提供具体例子来展示这些步骤。
  • 描述你在执行步骤后观察到的行为，并指出这种行为的具体问题所在。
  • 解释你期望看到的行为及其原因。

如果您有一个新的功能想法或对现有功能的改进建议，欢迎在 GitHub 仓库的 Issues 部分提出。在提出需求时，请确保：

  • 使用清晰和具体的标题来描述需求。
  • 在描述中详细说明需求的背景、目标以及预期的效果。
  • 提供实现该功能可能涉及的详细步骤或考虑的技术点。
  • 标记相关的项目维护者或团队，以便他们能够注意到这个需求。

如何提出有效的需求：

  1. 确认之前没有人提出过相同的需求。
  2. 提供足够的信息以便他人理解这一需求的价值和用途。
  3. 可选地，提供一个可能的实现方案或示例，帮助他人更好地理解需求。

响应需求

如果您想参与实现某个已提出的需求：

  1. 在该需求的 Issue 下留言，表明您想要参与实现，以及您打算如何着手。
  2. 讨论并获得社区或项目维护者的反馈。
  3. 一旦您准备好开始工作，可以新建一个功能分支，分支名建议格式为 feature/功能名称。

创建和使用功能分支：

  1. 从最新的主分支创建您的功能分支： 
    git checkout -b feature/your-feature-name main

贡献代码

设置开发环境

  1. 在页面顶部找到并 Fork 仓库。
  2. 将 Fork 过去的仓库克隆到本地机器： 
    https://git.mamahaha.work/sangge/BackDoorBuster.git
  3. 设置开发环境。确保已安装 Python，并根据项目需求选择是否安装 Docker。

进行更改

  1. 创建一个新分支： 
    git checkout -b feature/你的新功能名
  2. 进行更改，编写清晰、可读和模块化的代码。
  3. 使用 black 进行代码格式化： 
    black your_module.py
  4. 确保你的更改符合编码标准（PEP8），并为新代码或更改添加单元测试。
  5. 提交你的更改： 
    git add .
git commit -m "添加描述性的提交信息"
  6. 将分支推送到 GitHub： 
    git push origin feature/你的新功能名

提交拉取请求

  1. 导航到本仓库。
  2. 点击“New pull request”按钮。
  3. 选择你的分支以及要对比的项目主分支。
  4. 提供你更改的详细描述及其原因。
  5. 提交拉取请求。

工作流与拉取请求处理

为了保证项目的代码质量和稳定性，我们实施了严格的审核流程。每个拉取请求（PR）必须满足以下要求才能被合并到主分支：

成员审核

  • 审批要求：每个拉取请求必须至少获得两位团队成员的审批。
  • 审批流程：
    • 审批者需要仔细检查 PR 的代码质量、结构和符合项目目标的程度。
    • 审批者应该在评论中提供反馈，如果需要更改，应明确指出。
    • 审批者可以使用平台的审批功能来正式批准或请求更改。

状态检查

  • 状态检查要求：所有 PR 必须通过配置的状态检查，这通常包括自动化测试、代码风格检查等。
  • 配置状态检查：
    • 必须通过所有指定的自动化测试。
    • 必须满足代码格式化标准，例如使用 black 格式化 Python 代码。
  • 检查完成：只有当所有状态检查都显示为“通过”（green status），PR 才能被合并。

合并标准

  • 在合并前，除了必须获得必要的审批和通过所有状态检查外，还应确保 PR 没有与主分支的冲突。
  • PR 应基于最新的主分支进行合并，以避免合并冲突和其他潜在问题。

代码风格和约定

  • 遵循 PEP8 描述的标准命名约定。
  • 使用 docstrings 和必要时的注释来文档化你的代码。
  • 确保使用类型提示，遵循 PEP 484 描述的规范。
  • 保持函数专注且紧凑；避免可能的大型单体函数。

使用工具

  • 格式化：我们使用 black 自动格式化代码。
    • 使用 pip 安装 black： 
      pip install black
    • 运行 black 确保你的代码符合我们的编码标准： 
      black path/to/your_code.py

测试

  • 使用 unittest 编写你的代码测试。
  • 确保所有测试在提交拉取请求之前都能通过。

感谢您为 BackDoorBuster 做出的贡献！我们非常感谢您的努力，使这个项目变得更好。