Hamilton项目中的标签装饰器功能扩展：支持非字符串类型

在Hamilton项目的最新开发中，团队对@tag装饰器功能进行了重要扩展，使其支持非字符串类型的标签值。这一改进为数据流水线的构建提供了更灵活的元数据管理能力。

背景与需求

Hamilton作为一个数据流编排框架，其@tag装饰器原本仅支持字符串类型的标签值。这在某些场景下限制了开发者的使用灵活性。例如，当需要为某个节点标记多个业务线时，开发者只能使用多个独立标签或复杂的字符串拼接，无法直接使用列表等数据结构。

技术实现方案

经过社区讨论，开发团队确定了以下技术实现方向：

1. 结构化标签支持：允许标签值采用特定结构，而非完全开放任意JSON格式
2. 语义化设计：
   • 字符串类型表示单一标签值
   • 列表类型表示多个标签值
3. 查询系统兼容性：确保与现有的=, in, not =, not in等查询操作兼容

实际应用示例

现在开发者可以这样使用标签功能：

@tag(business_line=["US", "CA"])
def process_data(...) -> ...:
    ...

在查询时，可以使用以下方式：

dr.list_available_variables(tag_filter={"business_line": "US"})

技术优势

1. 增强的表达能力：支持列表类型后，可以更自然地表达多值标签
2. 向后兼容：原有字符串类型的标签用法保持不变
3. 查询灵活性：配合查询系统，可以实现更精细的节点筛选
4. 命名空间支持：通过点号表示法仍支持嵌套字典结构

最佳实践建议

1. 对于单一值标签，继续使用字符串类型保持简洁
2. 当需要表示多个可能值时，使用列表类型
3. 避免过度复杂的嵌套结构，保持标签的简洁性和可读性
4. 在团队内部建立一致的标签命名和使用规范

这一改进使得Hamilton在元数据管理方面更加灵活，为构建复杂数据流水线提供了更好的支持。开发者现在可以更自然地表达业务逻辑中的多值属性，同时保持查询系统的简洁性和高效性。