管理规则和公约

最后更新:2026 年 7 月 4 日

社区行为准则

尊重与友善

在 GitHub Issues、Discussions 和其他社区交流中,保持尊重和友善的态度。不使用攻击性语言,不对他人进行人身攻击。建设性的批评和反馈是受欢迎的,但请保持客观和专业。

保持专注

Issue 和讨论应与 Rest Reminder 项目直接相关。技术讨论、功能建议、Bug 报告都是合适的主题。偏离主题的内容可能会被关闭或移除。

开源协作精神

本项目是 MIT 开源的社区项目。欢迎任何人参与贡献,无论是代码、文档、翻译还是设计。贡献者应遵循本公约,维护一个包容、开放的协作环境。

Issue 规范

提交前检查

提交 Issue 前,请确认:

  • 已搜索现有 Issues,确认问题未被报告过
  • 已阅读文档和常见问题,确认不是已知问题
  • 使用的是最新版本(GitHub Releases 页面查看)

Bug 报告格式

Bug 报告应包含以下信息:

  • 版本号程序主界面「关于」页面显示的版本
  • 操作系统Windows 10/11,是否为最新更新
  • 复现步骤导致问题的具体操作序列
  • 预期行为你期望看到的结果
  • 实际行为实际发生的结果
  • crash.log如有崩溃日志,请附上完整内容

功能建议

功能建议应清楚描述你希望的功能、使用场景和预期效果。越具体越好。例如,与其说「加个番茄钟功能」,不如描述你理想中的计时流程和交互方式。

Pull Request 规范

提交前

  • Fork 仓库,在独立分支上开发,不要直接修改 main
  • 确保代码通过 py_compile 语法检查
  • 如修改了 UI 逻辑,说明测试方法和验证结果
  • 遵循现有代码风格(参考 CLAUDE.md 中的规范)

PR 描述

PR 描述应包含:

  • 改动目的和背景
  • 改动内容的简要说明
  • 关联的 Issue(如有)
  • 测试验证方式

代码审查

所有 PR 都需要经过代码审查才能合并。审查关注点包括:代码质量、边界情况处理、与现有架构的一致性、以及对用户体验的影响。审查意见是协作的一部分,请以开放态度对待。

违规处理

对于严重违反本公约的行为(恶意骚扰、垃圾信息、恶意 PR 等),维护者有权关闭相关 Issue/PR,必要时封禁相关账户。所有处理决定由维护者酌情做出,旨在维护社区的健康发展。

版本号约定

项目采用语义化版本号(Semantic Versioning):

  • 主版本号(X.0.0)架构重大变更、不向后兼容的修改
  • 次版本号(0.X.0)新功能、功能增强,向后兼容
  • 修订号(0.0.X)Bug 修复、小改进