lat/CONTRIBUTING.md

Contributing to LAT / 参与 LAT 贡献

DCO / Commit sign-off

Every commit must include a Developer Certificate of Origin (DCO) sign-off. By signing off, you certify the statements in DCO 1.1, including that you have the right to submit the contribution under the project's open source license.

Create a signed-off commit with:

git commit -s -m "your commit message"

The -s option adds a trailer like this to the commit message:

Signed-off-by: Name <email@example.com>

The name and email in Signed-off-by must match the commit author. A DCO sign-off is an author attestation and is different from GPG or SSH cryptographic commit signing.

Automation and AI assistants must not add Signed-off-by without your explicit confirmation and authorization. You must review the contribution, take responsibility for it, and explicitly authorize the signed commit or commits.

To add a sign-off to the latest commit:

git commit --amend --signoff
git push --force-with-lease

The push is needed only if the original commit was already pushed. To add sign-offs to multiple commits on a branch:

git fetch origin
git rebase --signoff origin/master
git push --force-with-lease

The command adds your sign-off to every rebased commit. Use it only when you authored or otherwise have the right to certify every commit being rebased, and do not remove existing sign-offs. Rebasing rewrites commit history, so coordinate with anyone else using the branch before rebasing or force-pushing it.

每个提交都必须包含开发者原创声明（Developer Certificate of Origin，DCO） 签署。签署表示你确认 DCO 1.1 中的声明， 包括你有权按照项目的开源许可证提交该贡献。

请使用以下命令创建带签署的提交：

git commit -s -m "提交说明"

-s 选项会在提交说明末尾添加类似下面的内容：

Signed-off-by: 姓名 <email@example.com>

Signed-off-by 中的姓名和邮箱必须与提交作者一致。DCO 签署是作者对提交 来源和授权的声明，与 GPG 或 SSH 的密码学提交签名不同。

未经你明确确认和授权，自动化工具和 AI 助手不得添加 Signed-off-by。 你必须审阅贡献、承担责任，并明确授权需要签署的一个或多个提交。

如果最新的提交忘记签署，可以执行：

git commit --amend --signoff
git push --force-with-lease

只有原提交已经推送到远端时才需要再次推送。如果分支上的多个提交都 需要补充签署，可以执行：

git fetch origin
git rebase --signoff origin/master
git push --force-with-lease

该命令会为所有被 rebase 的提交添加你的签署。只有当每个提交都是你 创作的，或者你有权对其作出认证时，才能使用该命令；同时不要删除已有 签署。rebase 会改写提交历史，因此在 rebase 或强制推送前，请先与同样 使用该分支的其他贡献者协调。

Before opening a pull request / 提交 Pull Request 前

• Keep each change focused and follow the relevant commit convention.

• Build or test the affected functionality and describe the validation in the pull request, or explain why validation is not applicable.

• Confirm that every commit in the pull request contains a Signed-off-by trailer.

• 请保持每项变更内容集中，并遵循相关的 提交规范。

• 请构建或测试受影响的功能并在 Pull Request 中说明结果；如不适用，请说明 原因。

• 请确认 Pull Request 中的每个提交都包含 Signed-off-by。