LLM项目中的工具函数参数优化：从--tools到--functions的演进

在LLM命令行工具的开发迭代过程中，参数设计往往需要随着功能演进不断优化。近期项目针对工具函数加载机制进行了重要改进，将原有的--tools参数升级为更符合语义的--functions参数，并引入了文件加载和多参数支持能力。

参数语义的精准化

原先的--tools参数存在两个主要问题：首先容易与单数形式的--tool参数产生混淆，后者用于指定工具名称；其次在YAML模板配置中，tools:字段通常用于列出工具名称列表，而函数代码块需要另外处理。新采用的--functions参数名称更清晰地表达了其功能本质——加载包含Python函数的代码块。

文件加载机制的实现

改进后的参数支持直接传入Python文件路径，系统会自动检测满足以下条件的输入：

1. 字符串不含换行符
2. 以.py结尾
3. 对应文件实际存在

这种设计既保持了向后兼容性（仍支持直接传入代码字符串），又大大提升了复杂函数集的复用性。用户可以将常用工具函数组织在独立的Python模块中，通过文件路径直接引用。

多参数支持的扩展

新版本允许--functions参数多次指定，这意味着：

1. 可以将不同功能的工具函数分类存放在多个文件中
2. 支持渐进式地添加功能模块
3. 便于团队协作时函数库的模块化管理

这种改进与sqlite-utils工具的参数设计保持了一致性，降低了用户在不同工具间的认知成本。

技术实现要点

在底层实现上，系统需要处理三种输入形式：

1. 直接的多行Python代码字符串
2. 单行.py文件路径
3. 多个上述参数的组合

对于文件输入，系统会读取文件内容后将其作为普通代码字符串处理，确保核心逻辑的一致性。多参数情况下，所有函数代码会在内存中合并后统一编译执行。

这种参数设计的演进体现了API设计中的几个重要原则：语义明确性、使用便捷性和扩展灵活性，为命令行工具的函数扩展机制提供了优秀的实践范例。