NoWayOS
ZH
GitHub
菜单关闭

检查与贡献

获取帮助与参与贡献

在哪里提问、报告缺陷或漏洞,以及如何向 NoWayOS 提议变更。

NoWayOS 在 GitHub 上的 NoWayOS 组织下公开开发。在那里,您可以找到代码、就代码提问,并对它进行修改。

问题与缺陷

请在相关的代码仓库中提交 issue:操作系统相关的提交到 nowayos,屏幕转换相关的提交到 screen-compiler,示例应用相关的提交到 showcase。一个好的 issue 会说明您运行了什么、预期是什么、实际发生了什么,并附上输出,以及您运行时所在的提交。

提交之前,不妨先看看:每个代码仓库中的 DEVELOPING.md 介绍了构建、测试和代码布局,术语表则解释了各个术语。

安全漏洞

请不要为漏洞提交公开 issue。 请按照各代码仓库的 SECURITY.md 所述私下报告:通过代码仓库 Security 选项卡中 GitHub 的私密漏洞报告功能,或发送电子邮件至 security@nowayos.com。在修复可用之前,报告会一直保密。

提议变更

每项变更都由同一套关卡评判,这些关卡写在 Defence Agent 中:每道关卡检查什么、应对什么威胁、谁有权修改它。详情请见各代码仓库的 CONTRIBUTING.md。

  1. 从一个 issue 开始,而且是维护者已接受的 issue:您可以新开一个,也可以在已有的 issue 下表示您想接手。
  2. 阅读代码仓库的 DEVELOPING.md,尤其是其中的基本规则:关卡会强制执行这些规则,因此违反任何一条的变更都无法通过。
  3. 完成变更,并附上测试。如果是修复缺陷,请先写出会失败的测试。
  4. 运行 make ci,确认它通过。
  5. 签署每一次提交(git commit -s):Signed-off-by 这一行用于证明您遵守开发者来源证书,没有这一行的提交无法通过。
  6. 使用代码仓库的模板提交拉取请求:说明它改了什么、为什么改,驱动程序的参考来源,以及是否得到过 AI 助手的任何帮助。如果它放宽了系统的授权,请明确说明: 更宽的授权会被当作安全变更来审查。

术语

NoWayOS 有几个词用的是特定含义:保护域、授权、预期文件、故障安全状态等等。术语表对每一个都作了定义。