飞块插件开发

欢迎来到飞块插件开发世界！

通过飞块插件，你可以将自己的奇思妙想转化为按键操作和屏幕交互——无论是做一个一键格式化文本的效率动作，还是打造一个精美展示系统监控、实时天气的“超级块”（Widget）。

通常情况下，开发一个插件只需要从两个核心文件开始：

• manifest.json（清单文件）：负责“声明”插件能做什么（包含哪些动作、界面、配置和权限）。
• index.js（后台入口）：负责“实现”具体业务逻辑（编写实际的 JavaScript 函数）。

当用户启动飞块时，宿主会自动读取你的清单并把动作呈现在编辑器中；每当用户按下按键或触发流程，飞块就会在后台调用你编写的对应函数。

---

#插件是如何运行的？

为了保障运行效率和界面灵活性，飞块采用了后台逻辑与前端展示分离的双层架构：

1. 后台进程（Node.js 运行环境）
   插件的后台代码运行在电脑主机的独立进程中，原生支持 Node.js 标准库。飞块负责拉起并管理该进程，并注入官方 SDK，方便你随时调用系统功能、发起网络请求或广播实时状态。最棒的是，用户无需在电脑上单独安装 Node.js，开箱即用。

2. 前端展示（HTML / Web 运行环境）
   超级块的 UI 是标准的 Web 页面，运行在桌面端预览视图或移动端设备浏览器中。页面通过页面 SDK 订阅数据与派发交互，而具体的计算、数据存取则交给后台处理。这种分工让跨设备交互变得格外清晰自然——例如，一个计数器可以在电脑后台安全保存数值，同时在手机屏幕上实时渲染并流畅响应触摸。

---

#推荐起步路线

如果你刚刚接触飞块，建议按照以下节奏循序渐进：

1. 准备开发工具：先阅读使用插件开发工具包，全局安装官方 CLI 工具 flyon，了解如何一键初始化、本地调试与打包。
2. 动手实践第一个插件：跟随创建第一个插件教程，亲手写一个接收姓名并返回问候语的动作。在实际流程中看到自己写的代码运行起来，建立完整认知。
3. 探索核心能力：
   • 如果你想向按键或屏幕广播动态变化的数据，请阅读发布状态；
   • 如果你想定制专属的可视化 UI 与触控面板，请阅读创建超级块；
   • 如果需要与其它插件联动，请阅读请求数据与调用服务。

---

#快速查阅接口与示例

• 查阅规范与 API：随时翻阅参考文档。清单配置项可直接从 manifest.json 索引切入；后台方法请查看 context 下各功能命名空间。每个字段与 API 都有固定、权威的规格说明。
• 开箱即用的完整工程：在示例插件中，我们准备了 7 个可独立运行的示例项目，从极简动作到多端状态同步一应俱全，欢迎随时下载调试与借鉴。