参与贡献

报告 bug、修改文档、翻译、在真机上测试、写代码，我们都欢迎。

参与方式

• 试用并报告问题：现阶段笔记本、显卡和 Wi-Fi 的硬件反馈尤其有价值。见获取帮助。
• 改进文档：每一页底部都有“编辑此页”链接。修正错字、把步骤讲清楚，或补上你希望早点知道的内容。
• 翻译：官网和文档目前有英文和简体中文。如果想添加新语言，请先在 Discord 上联系我们，以便设置。
• 写代码：在 kleinia-os 组织中寻找带 good first issue 或 help wanted 标签的 issue。

动手做大改动之前

在编写大的改动、新组件，或任何涉及公开接口的改动（agent:// 地址格式、D-Bus API、命令行选项、配置格式）之前，请先开一个 issue。一份简短的设计说明能让大家免于返工。

Pull Request

• 每个 PR 只做一件事。
• 提交信息遵循 Conventional Commits，例如 fix(gateway): retry on 429。
• 每个提交都要签署，以确认 Developer Certificate of Origin：git commit -s。
• 内核改动遵循上游 Linux 的提交补丁规范。

完整指南见各仓库中的 CONTRIBUTING.md。

使用 AI 辅助贡献

Kleinia 本身就是为智能体打造的系统，用 AI 工具帮你写代码或文档没有问题。但作者仍然是你：提交前请审查并测试所有内容，确认你有权贡献它，并能在评审中解释它。

行为准则

所有参与 Kleinia 的人，无论在 GitHub、Discord 还是其他地方，都应遵守我们的行为准则。准则基于 Contributor Covenant。