Brotli Python库压缩模式参数说明优化建议

Brotli作为Google开发的高效压缩算法，其Python实现提供了compress函数用于数据压缩。近期社区对函数参数说明提出了改进建议，特别是关于mode参数的文档描述需要更清晰明确。

当前compress函数的mode参数文档仅说明了可选常量MODE_GENERIC、MODE_TEXT和MODE_FONT，但没有明确指出这些常量对应的整数值。对于不熟悉Brotli库的开发人员来说，这种文档描述方式可能会造成使用上的困惑。

技术实现上，Brotli压缩模式实际上是通过三个整数值来区分的：

• 0表示通用压缩模式(MODE_GENERIC)
• 1表示针对UTF-8文本优化的压缩模式(MODE_TEXT)
• 2表示针对WOFF 2.0字体数据优化的压缩模式(MODE_FONT)

建议的文档改进将直接说明这些整数值及其对应场景，使开发者能够更清楚地了解参数的实际取值要求。这种改进对于以下场景特别有价值：

1. 当开发者需要动态选择压缩模式时，可以直接使用整数值而非导入常量
2. 在代码审查或调试时，能更直观地理解传入的mode参数值
3. 对于不使用IDE自动补全功能的开发者，文档提供了完整的参数信息

这种文档改进遵循了Python社区的最佳实践，即在提供常量别名的同时，也明确说明底层实现使用的实际值，使API文档更加完整和实用。