贡献模板句子
模板句子需要提交到我们在 GitHub 上的 Intents 仓库。句子将由语言负责人审核,如果正确则合并。你可以贡献新句子或改进现有句子。
Intent 仓库结构如下:
我们更倾向于许多小贡献而不是少数大贡献。包含大量更改的贡献很难审核。因此,我们希望每次贡献仅限于单一语言和单一 domain。
句子和测试的文件名格式为 <domain>_<intent>.yaml。因此,如果你为 cover domain 做贡献,你将更新以下文件:
sentences/<language>/cover_HassCoverOpen.yamlsentences/<language>/cover_HassCoverClose.yamltests/<language>/cover_HassCoverOpen.yamltests/<language>/cover_HassCoverClose.yaml
如何贡献
所有贡献都通过 GitHub 上的 Pull Request 完成。我们推荐使用 GitHub CodeSpaces。按照本教程开始。
我们的仓库有很多检查,你可以使用它们确保提交的句子有效。你可以在 VS Code 中使用 terminal -> run task 在本地运行它们。
当你创建 Pull Request 时,这些检查也会自动运行。如果检查失败,贡献将无法接受。
添加新语言
新语言应基于 python3 -m script.intentfest add_language <language code> <language name> 的输出,它会生成一个包含新语言所需所有文件的空语言目录。
首次贡献应限于 _common.yaml 中错误句子的翻译,以及为 homeassistant domain 添加句子和测试。
如果你无法在本地运行 add_language 脚本,请在 Discord 中请求维护者为你运行。

