LLM-Guard项目中BanSubstrings扫描器的参数设计优化

在LLM-Guard项目的BanSubstrings输入扫描器模块中，开发者对参数设计进行了重要优化，这些改进不仅提升了代码的健壮性，也增强了API的易用性。

参数默认值的重新设计

原实现中substrings参数默认为None的设计存在几个问题：首先，这使得类型检查变得复杂，需要额外的None值验证；其次，这种设计违背了Python的"显式优于隐式"原则。优化后的版本将substrings改为必填参数，这样可以在编译阶段就捕获错误，而不是在运行时通过assert语句检查。

这种改变带来了多重好处：

1. 移除了运行时断言检查，避免了Python优化模式(-O)下断言被移除的风险
2. 使API设计更加直观，用户必须显式提供要禁止的子字符串列表
3. 减少了维护负担，因为不再需要处理None值的特殊情况

类型注解的改进

参数类型从List[str]升级为Sequence[str]，这是一个更通用的抽象：

• Sequence是比List更宽泛的概念，包括tuple、list等任何实现了__len__的可迭代对象
• 保持了类型安全的同时提供了更大的灵活性
• 符合Python的鸭子类型哲学，用户可以使用任何序列类型而不仅限于列表

API设计的最佳实践

通过添加*参数，强制后续参数必须使用关键字形式传递：

BanSubstrings(["a", "b", "c"], match_type="str", case_sensitive=False)

这种设计消除了位置参数带来的歧义，使代码更易读和维护。虽然这是一个破坏性变更，但在项目早期阶段(v0.x)是可以接受的，且带来的长期收益远大于短期迁移成本。

对项目质量的提升

这些改进共同提升了LLM-Guard项目的代码质量：

1. 更强的类型安全性
2. 更清晰的API设计
3. 更少的运行时错误可能性
4. 更好的开发者体验(IDE支持更完善)

这些变化体现了Python最佳实践在安全关键项目中的应用，展示了如何通过精心设计的API来构建更可靠的系统。