版本说明

开发插件时会遇到四类版本字段，它们解决不同的问题。

#协议版本

manifest.json 的 apiVersion 当前是 1。它决定清单和 SDK 使用哪一套交互方式。页面脚本名称中的 v1 对应页面桥接协议版本。

#插件版本

顶层 version 使用 SemVer，例如 1.2.0。每次发布新包都递增这个值；商店保存每个发布版本，桌面端据此识别更新。消费方在 dependencies 中填写提供方插件的包版本范围，例如 ^1.2.0；这与服务接口的整数版本分别校验。

当前工程中的 SDK 包版本为 0.1.0，桌面宿主版本为 0.0.1。SDK 随飞块提供，插件通过 FLYONDECK_SDK_PATH 加载它。

#服务版本

services[].version 与 uses[].version 是正整数，表示服务接口版本。提供方和消费方精确匹配，具体示例见插件服务与事件。

#配置版本

configurationVersion 是宿主管理的配置格式版本，默认为 1，与包版本分开递增。configurationMigrations 声明迁移目标版本，对应后台同名处理器集合。包发布修复或换图标时不必改变配置版本；字段改名、类型调整或动作标识变化时，提供逐版本迁移。见更新与迁移。