向 Class Widgets 贡献代码

反馈

反馈 Bug

如果您在使用 Class Widgets 时遇到问题，可以在 Issues 中提交 Bug 反馈。

您的 Bug 反馈需要：

在最新版和最新提交中未修复；
没有与您的 Bug 反馈相同或相似的 Issue。

如果您的 Bug 反馈与其他重复，我们将以“重复”原因关闭（Close as Duplicate）您的 Issue。您可以在 Issue 状态中找到对应的 Issue。

提交新功能请求

如果您在使用 Class Widgets 时有关于新功能的想法，您可以在 Discussions 中提交 新功能请求。

请注意，您的功能请求需要：

在 Class Widgets 版本和最新提交中没有实现；
没有与您的功能请求相同或相似的 Discussion；
提交的功能是用户广泛需要的，插件不能替代的，且没有超出 软件本来 的开发目标，而非 添加与课表及教学辅助无关的内容 。

如果您的请求不符合上述要求，您的请求可能会被关闭，或转为插件请求。

提交插件请求

如果您在使用 Class Widgets 时有关于新功能的想法，且该想法可以用插件实现，您可以在 Issues 中提交插件请求。

注意，您的插件请求需要：

在 Class Widgets 版本和最新提交中没有实现；
没有与您的插件请求相同或相似的 Issue；
提交的功能是用户需要的，不是 添加与课表及教学辅助无关的内容 。
尽量详细说明插件的背景与动机，用途以及效果，以便插件开发人员能理解您想要实现的功能。

如果开发者认为您提交的功能是用户广泛需要的，您的请求可能会被转为功能请求。您的 Issue 会被关闭并锁定，您可以通过页面上方的链接找到您的请求。

贡献代码

贡献准则

您为 Class Widgets 贡献的代码需要：

稳定
您贡献的代码需要能尽可能在多个平台稳定工作。
具有泛用性
与功能请求一样，您贡献的代码需要面向大部分用户。如果您的代码专用性较强，可以考虑开发插件或与开发者讨论。

提交

提交时，请尽量遵守约定式提交规范。

在约定式提交规范上，我们还建议您：

添加动词
如果您的提交是 fix（修复）类型，请您在提交信息中添加“修复”等动词和“的问题”等词汇。
如果您的提交是 feat（功能）类型，您可以在提交信息中添加“增加”等动词和“功能”等词汇。这不是硬性要求。
注明范围（scope）
如果您的提交是 feat（功能）类型，且添加的是一整个功能，您不需要注明范围；如果添加的功能是一个大功能下的小功能（如天气（weather）功能下的高德地图天气功能），请您添加范围。
如果您的提交是 fix（修复）类型，且修复的部分不属于下表的任何一个，您可以不添加范围；反之，请您添加范围。
在文档底部有一份对照表。

啊不对现在还没有快了快了

发起拉取请求

在提交拉取请求前，请先对您的代码进行测试。随后您可以向本仓库提交拉取请求。请您在拉取请求中简要说明您的更改。

Important

因为 Class Widgets 同时兼容 Windows 7 及更新版本，Linux 和 macOS，请确保您引入的库同时兼容以上三类操作系统的对应版本，或对不兼容的系统或版本进行了规避。
如果您不能在三个系统分别进行测试，您仍然可以提交拉取请求，但请在拉取请求描述中注明已测试的操作系统，以便我们进行测试。

合并拉取请求

在经过团队成员的代码审查和测试后，您的拉取请求会被合并。

还有问题？

您可以加入 QQ 群或 Discord 服务器与开发者和其他用户讨论。

附录

功能对照表

中	英
主程序小组件	/
天气	weather
提醒	tip
TTS	tts
插件广场	pp plugin_plaza
设置	settings
设置 - 课表	schedule
设置 - CSES	cses
设置 - 个性化	customize
设置 - 高级选项	advanced
额外选项	exact
额外选项 - 调休额外选项 - 换课	temp

4.6 KiB Executable File Raw Permalink Blame History Unescape Escape