前端插件深度指南
阅读顺序
| 页面 | 解决的问题 |
|---|---|
| 工程结构 | 每个目录放什么、谁生成、依赖只能朝哪个方向 |
| 插件清单 | fh2-plugin.json 的字段：身份、扩展点、界面、配置、权限 |
| 入口与生命周期 | 入口代码 plugin.ts 如何被激活、如何收尾 |
| 界面与状态 | 界面与入口之间怎么传数据、Vue 组件怎么挂载和卸载 |
| 多宿主插件 | 同一个插件在驾驶舱、项目、计划、消息四个页面各自运行 |
| 跨宿主通信服务 | 同一插件的多个宿主运行时之间怎么短期共享状态 |
| HTTP、WebSocket 与事件 | 怎么调后端接口、怎么收推送消息和平台事件 |
| 存储、Blob 与定时器 | 本地缓存、临时文件、定时器的规范写法 |
| 工具链与本地调试页面 | 7 个 CLI 命令各自干什么、本地调试怎么跑 |
一条插件的完整链路
fh2-plugin.json（插件清单，你写）
-> fh2-plugin generate （按清单生成类型文件）
-> src/plugin.ts （入口代码，你写）
-> src/hosts/<host>/activate.ts（各页面的激活逻辑，你写）
-> 界面契约 + Vue 组件 （你写）
-> fh2-plugin build （构建出 dist/ 产物）
-> dist/fh2-plugin.json （构建产物清单，工具链生成）dist/ 是交给平台安装的产物。不要反向修改 dist/ 里的任何文件。日常习惯
常见问题
| 现象 | 原因与处理 |
|---|---|
| 不知道从哪页开始读 | 先读工程结构和插件清单，其余按需查 |
| 想看某个扩展点或能力的细节 | 见扩展点目录和能力目录 |
| 插件报错不知道错误码含义 | 见错误码总表 |
| 本地跑不起来 | 见工具链与本地调试页面和前端调试 |
修改于 2026-10-22 03:39:49