管理规则和公约
最后更新: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 修复、小改进