1. AI辅助开发
插件化手册
  • FH2 插件开发手册
    • 产品简介
    • 典型场景
    • 发版说明
    • 快速开始
      • 快速开始总览
      • 第一个插件
      • 后端插件
      • 全栈闭环
    • AI辅助开发
      • AI 开发 Skill
      • 安装与复验
      • 第一个工程
      • 真实需求示例:现场问题上报
      • 改造已有工程
      • 调试与交付
    • 开发指南
      • 开发指南
      • 基础概念
        • 基础概念总览
        • 什么是插件开发
        • 平台架构
        • 前端宿主、扩展点与能力
        • 后端运行时、入口与权限
        • 开发流程
        • 安全与隔离
        • 支持范围与问题反馈
      • 开发指南
        • 开发指南总览
        • 前端插件
          • 前端插件深度指南
          • 前端工程结构
          • 插件清单(fh2-plugin.json)
          • 入口与生命周期
          • 界面与状态
          • 多宿主插件
          • 跨宿主通信服务
          • HTTP、WebSocket 与事件
          • 存储、Blob 与定时器
          • 工具链与本地调试页面
        • 后端插件
          • 后端开发深度指南
          • 后端插件的结构
          • 后端源清单 fh2-plugin.json
          • HTTP 接口处理函数
          • 消息订阅与事件处理函数
          • ctx 与能力注入
          • 数据存储与缓存
          • 流程编排
          • 触发方式
          • 连接外部系统
          • 流程编排练习(DAG)
        • 前后端协作
          • 前后端协作总览
          • 前后端共享契约
          • 端到端幂等
          • 事件、通知与状态
          • 统一错误模型
          • 链路标识与诊断日志
        • 完整练习
          • 环境准备
          • 第一个前端插件
          • 第一个后端插件
          • 第一个全栈插件
      • 能力总览
        • 能力地图
        • 能力可用性矩阵
        • 前端能力
          • 平台通用能力
            • 平台通用能力总览
            • 基础运行时:HTTP、事件、WebSocket 与存储
            • 导航、位置与通知
            • 弹窗、音频与剪贴板
            • 地图能力
            • 项目设备能力
            • WPMZ 与航线预览
            • 受控对象上传
          • 项目宿主
            • 项目宿主总览
            • 项目上下文
            • 项目侧边栏入口
            • 项目插件路由
            • 项目工作区
          • 消息宿主
            • 消息宿主总览
            • 消息告警弹层
            • 消息导航与通知
          • 计划库宿主
            • 计划库宿主总览
            • 计划库表单上下文
            • 计划库表单扩展
            • 校验、提交与 `biz_ext`
          • 驾驶舱
            • 驾驶舱插件能力总览
            • 驾驶舱扩展点
            • 上下文与遥测
            • 相机、检测与 AI
            • 场景几何与直播指针
            • 飞控、云台与任务
            • 驾驶舱平台事件
        • 后端能力
          • 后端能力地图
          • 后端能力总览
          • 配置、受管出网与集成连接
          • 事件与流程
          • 飞行任务与违停巡逻
          • 数据存储
          • 媒体与前端通知
          • 资源租约
          • 作业、目标轨迹与视频处理
      • 调试与测试
        • 调试与测试总览
        • 快速入门排错
        • 本地开发
        • Web IDE:打开工程与保存改动
        • 工作流编辑器:节点、接线与交付
        • 知识与 MCP:先判断需要哪一层事实
        • 前端本地调试
        • 后端运行时与流程调试
        • 模拟数据与测试数据
        • 集成测试与 E2E
        • 日志与链路追踪
        • 常见问题排查
      • 完整示例
        • 示例与案例总览
        • 项目侧边栏与工作区
        • 消息告警卡片
        • 计划表单任务清单
        • 驾驶舱动作与左侧面板
        • 最小后端插件
        • 最小全栈插件
        • 多宿主插件实战
        • 事故快处
        • 交通抓拍
        • 违停巡逻完整案例
      • 构建发布与安全
        • 构建、发布与安全
        • 质量门禁
        • 行业包构建与打包
        • 能力版本发布
        • 安装、升级与回滚
        • 安全基线
      • API参考
        • API 参考总览
        • 前端
          • 前端 API 参考
          • 前端插件清单结构
          • 前端 SDK API
          • 前端扩展点目录
          • 前端能力目录
          • 前端平台事件目录
          • 跨宿主通信服务 API
          • 工具链命令行参考(`fh2-plugin`)
        • 后端
          • 后端 API 参考
          • 后端插件源清单
          • 后端 HTTP 接口参考
          • 后端事件消费参考
          • 后端脚本上下文(`ctx`)
          • 后端数据存储
          • 流程编排语言
          • 流程触发器参考
          • 后端能力目录
          • 后端 HTTP API
        • 共享契约
          • 共享契约参考
          • 类型与契约目录
          • 错误模型
          • 版本兼容性
      • 附录
        • 错误码
        • 术语表
        • 常见问题
  1. AI辅助开发

调试与交付

按顺序验证:源码检查 → 本地页面 → 目标环境 → 打包。

1. 先跑源码检查#

帮我验一下这次改动:先说清楚影响哪些成员、实际要跑哪些脚本,再依次跑生成、校验、相关单测、类型检查和构建。
每条命令都把命令和结果贴出来。
顺序:generate → validate → 聚焦单测 → tsc → build。后端测试单独运行,不能用根目录的前端测试代替。
结果能说明什么
validate 通过清单声明符合当前检查
单测和类型检查通过已覆盖的逻辑正确
build 成功产物能构建
本地页面已观察当前 Mock 数据下面板工作
以上都不代表真实环境可用。

2. 失败时先定位#

构建挂了,先诊断,别重建工程。
保留原命令和错误信息,定位到文件后改一处,再用最小的命令复验一遍。
三个常见问题:
页面没有按钮:查路由、Host 挂载和成员是否启用,不要先重装依赖。
弹窗无样式:查组件库版本,样式是否挂到 ctx.styleTarget,浮层是否挂到 ctx.overlayElement。
显示成功但刷新无记录:分别查接口返回、列表和存储范围。

3. 本地调试#

可以起本地 dev 了,只用 Mock 数据。
验证成员加载、目标页面和主操作,把实际地址记下来。
做完把服务停掉。
工具栏有四个面板:
面板用途
插件成员、版本和启用状态
Host页面需要的宿主与实际挂载
场景模拟输入和事件
诊断构建、激活和运行记录

4. 目标环境预览(可选)#

先给我 preview 的预检,别启动。
确认一下目标环境是不是 HTTP、登录权限够不够、本地后端是什么版本。
把代理、调试面板和怎么恢复说清楚,等我确认再动。
确认后按 CLI 输出的地址操作,结束后停止服务并恢复代理。本地能跑不代表宿主能加载。

5. 打包与报告#

核对一下 pack 的范围和产物位置,我确认后你再执行。
不要上传、不要发布、也不要部署。
在行业工作区根或 Capability 根打包,不在单个成员目录打包。
交付报告应包含:
改动文件和版本
生成的产物位置
每项检查的命令和结果
页面由谁验证
未执行的项:上传、部署、真机验证

可选:MCP 与 Web IDE#

MCP 让客户端直接调用本地 Toolchain;Web IDE 用 serve 打开,可以修改本地工程。
启动前确认地址和写入范围,用完停止。
build / pack 是异步任务:轮询到 succeeded、failed 或 cancelled 才算结束,任务受理不等于完成。
Web IDE 保存看逐文件回执,区分 saved、failed、conflicted、pending。
DAG 校验通过只代表编辑期检查通过,不代表可以部署或执行。
规则查调试与测试和交付指南。
修改于 2026-10-25 08:35:27
上一页
改造已有工程
下一页
开发指南
Built with