# 参与贡献

欢迎通过 Issue 讨论缺陷、约束定义、测试场景和维护方向。提交代码前请先说明问题边界；对算法行为的改变应附带最小输入、期望不变量和结果差异。

## 开发流程

1. 从 `main` 创建短生命周期分支；
2. 保持提交单一主题，使用 `feat:`, `fix:`, `test:`, `docs:` 等清晰前缀；
3. 新功能同时添加测试与文档；
4. 运行 README 中的完整验收命令；
5. 在 Pull Request 中说明设计、测试记录、兼容性和许可证影响。

不接受空实现、重复代码凑行数、隐藏网络请求、硬编码凭据或没有来源记录的第三方素材。涉及整数单位、随机数序列、候选排序和 JSON 字段的变更会影响可复现性，必须在更新日志中明确记录。

## Issue 建议内容

- 当前行为和期望行为；
- 最小可复现输入及 MoonBit 版本；
- 执行命令和完整错误信息；
- 是否影响费用、缺供、电池边界或停电保供；
- 如提出功能，说明功能边界和维护价值。