[Dify 实战] provider.yaml 专篇：基于真实样例逐字段解析、常见坑与调试清单

本文只讲 Provider 层 的 provider.yaml，并完全以我给出的真实 YAML 为基准来拆解说明。
我们会逐字段解释作用、与 manifest.yaml / tool 层的衔接关系、最常见报错与排查方法，并给出一份“增强版范例”和上线前检查表。

---

0. 我的真实 provider.yaml

identity:
  author: "***"
  name: "file_translator"
  label:
    en_US: "file_translator"
    zh_Hans: "file_translator"
    pt_BR: "file_translator"
  description:
    en_US: "profile file to file translation service"
    zh_Hans: "profile file to file translation service"
    pt_BR: "profile file to file translation service"
  icon: "icon.svg"
tools:
  - tools/txt_