[Dify 实战] Tool 级 YAML 全解析：以 txt_translate 工具为例的参数设计与 LLM 调用规范

本文是 Dify 插件 YAML 三部曲的最后一篇。
前两篇我们分别讲了 manifest.yaml（插件全局元信息）与 provider.yaml（能力域定义与工具注册）。
本篇聚焦插件最核心的一层——Tool 级 YAML，即每个可调用功能（API/动作/脚本逻辑）的声明。
我们将结合我的真实 txt_translate.yaml，逐字段拆解其结构、设计思路与最佳实践。

---

一、Tool 层在 Dify 插件体系中的定位

在 Dify 的插件架构中：

层级	职责	举例
manifest.yaml	定义插件元信息、权限与 Provider 注册	“这是一个文件翻译插件”
provider.yaml	定义 Provider（能力域）及挂载工具列表	“我提供 txt/do