把问题说清楚
给出版本、输入、命令与结果。小而独立的复现，往往比一段长描述更有价值。
开源 · 贡献指南
共同构建，
从一个
具体的改进开始。
了解参与方式+
一个清楚的问题。
一个可以复现的例子。
一段值得保留下来的经验。
每一种专业，
都可以留下贡献。
代码之外，清楚的说明、能够复现的问题和真实的工程约束，同样帮助一个项目变得更好。
让实现更可靠
补充边界条件、失败路径和测试。先证明为什么要改，再让改动能够被检验。
让方法更易懂
完善运行说明、示例与双语解释。能被下一位使用者理解，是复用的第一步。
从本地验证，
到可审查的改动。
先围绕下载包建立一个能够独立复现的工作目录，再讨论需要如何改进。
- 01
选择准确版本
保存版本号与包校验值，阅读 README 和 LICENSE。
- 02
复现现有行为
代码包先运行示例与测试；模板包核对字段和填写说明。用合成数据重现问题。
- 03
保持改动聚焦
一次解决一个问题，补充必要的测试与文档。
- 04
准备审查材料
整理原因、差异、复现方法和影响范围，再通过确认的项目协作渠道提交。
先把问题，
写成别人能复现的样子。
填写两项关键信息，生成一份本地 Markdown 问题说明。它可以随代码和测试结果一起进入后续讨论。
仅本地生成，不会上传或发送。请使用合成数据，移除密钥与客户资料。
直接下载空白模板让协作，有清楚的依据。
许可与归属
本栏目参考包采用 MIT 许可。使用或再分发时保留包内版权与许可声明；提交内容应来自你有权分享的代码、文档或样例。
查看参考包许可可验证与可复现
说明适用版本与环境，保留最小输入和预期结果。测试通过不等于所有业务场景都适用；需要写清新的限制与变化。
明确范围有测试依据无敏感信息