扩展、服务与能力的关系

扩展、服务和能力，是同一套使用流程里的三个不同层级：扩展提供功能，服务保存共用配置，能力则是任务实际选择和执行的操作。

内置或安装

扩展

一份提供具体功能的代码包，既可能内置，也可能由你安装。

例如提供翻译、语种检测、OCR、文本处理，或连接其他工具的操作。
保存配置

服务

从扩展创建出来的一份配置实例。

它保存账号、API Key、服务商、Base URL、区域或文件等共用的运行设置。
供任务选择

能力

服务下面一个可以在应用里选择和执行的具体操作。

同一种能力可以复制、重命名、排序，并分别配置成适合不同任务的版本。

一个扩展可以创建多个服务，一个服务也可以包含多个能力实例。

所以，提供功能的代码、它使用的共用配置和任务选择的具体操作，会作为不同对象分别出现。

它们是怎样组合的

你可以安装多个扩展。一个服务代表一套账号、凭据和公共配置。同一个扩展可以添加多个服务；同一种能力也可以复制成多份，并为每一份设置不同的参数。

扩展 A
├─ 服务 A1：一套账号、凭据和公共配置
│  ├─ 翻译能力 1：参数方案 A
│  ├─ 翻译能力 2：复制后使用参数方案 B
│  └─ 语种检测能力
└─ 服务 A2：扩展 A 的另一套服务配置
 └─ 翻译能力 3

扩展 B
└─ 服务 B1：另一个扩展的独立服务配置
 ├─ OCR 能力
 └─ 通用能力

四种能力

翻译	进行文本翻译，或查询单词和短语。
OCR	识别图片中的文字与文字区域。
语种检测	判断一段文本使用的语种。
通用能力	提供不属于以上三类的其他操作。

从扩展到可用能力

使用 Float Translate 内置的扩展，或者安装其他扩展。
从扩展添加并配置服务。服务保存账号、API Key、服务商、Base URL、区域或本地文件等共用设置。
查看服务下面的能力实例，启用需要的操作，并完成每项能力自己的配置。
把能力放到兼容的位置，例如浮动胶囊、面板、快捷键或工作流。

一个扩展可以支持多个服务，每个服务也可以提供多个能力实例。复制能力或为它单独配置参数时，会得到一项拥有独立设置的操作；服务的共用配置仍由服务统一保存。

为什么能否放置取决于兼容性

只有目标位置能够提供能力所需的输入和上下文时，Float Translate 才会在该位置提供这项能力。能力类型只说明它的大致用途，并不保证同一类型的所有能力都能放到每个位置。

输入和输出必须接得上。 文字能力不能直接处理图片，必须先由 OCR 产生文字；在工作流中，上一步的输出也必须符合下一项能力的输入要求。
目标位置必须提供所需上下文。 作用于翻译结果的操作需要先有结果；依赖选中文字的操作，也不一定适合缺少选区上下文的快捷键。
服务和能力必须可用。 服务配置不完整、能力被禁用、凭据不可用，或者当前语言和应用条件不受支持时，已经放置的能力也可能无法运行。

放置兼容性回答的是能力可以加到哪里；当前可用性回答的是它现在能不能处理这次输入。因此，一项能力可以正确地放在某个位置，却因为当前任务条件不符而暂时不可用。

找不到某项能力时

确认对应扩展已经启用，并且服务确实存在。
检查服务配置是否完整，能力实例是否已启用。
检查目标位置能否提供这项能力需要的输入和上下文。
如果是在工作流中，检查上一步是否产生了兼容的输出。
前往目标位置自己的设置，把能力加入想使用的位置。

能力设置请查看配置能力。放置方法请继续查看浮动胶囊、快捷键、翻译面板或创建工作流。