SuperAPI AI 工具集

fusion-developer-portal

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:指导开发 Fusion 门户外壳(portal shell),即承载 Fusion 应用的宿主应用,负责在共享界面(页头、上下文选择器、导航)中加载、路由和渲染子应用。

主要能力:搭建新门户;配置门户级模块(遥测、分析、导航、服务、应用模块);构建自定义应用加载器或门户外壳;添加门户级路由(/apps/:appKey/*);使用 Apploader 组件或 useApploader 钩子嵌入应用;接入页头、上下文选择器、书签侧边栏;添加门户级分析与遥测;门户构建与部署。

使用方式:用 Fusion Framework CLI 搭建,先 mkdir 并 pnpm init,再 pnpm add -D @equinor/fusion-framework-cli,创建 portal.manifest.ts 等文件,用 pnpm fusion-framework-cli portal dev 或 ffc portal dev 启动。门户级配置使用 FrameworkConfigurator(不同于应用的 AppModuleInitiator),模块会提升到所有子应用;MSAL/认证在门户级配置并被应用继承。构建部署用 ffc portal build、ffc portal upload --portal-id <id>、ffc portal tag。认证用 az login 或 FUSION_TOKEN 环境变量,切勿在命令中粘贴令牌。

适用场景:新建或修改门户、配置门户模块、理解门户运行时如何加载初始化应用、门户部署。不适用:应用级功能开发、后端服务改动、帮助中心集成、技能编写、问题编写。

限制:Apploader 为实验性 POC,嵌入应用可能有路由与上下文问题,仅适合 PowerBI、PowerApps 等简单视图;MSAL 只在门户级配置,不要在应用中配置;不要臆造门户 API,仅引用 MCP 确认或文档记录的 API;源码中不得含密钥,MSAL 客户端 ID 须来自环境变量;不要修改生产 Fusion 门户,本技能仅覆盖自定义门户开发;所有改动使用约定式提交。部分细节(如遥测 OpenTelemetry/Application Insights 配置)需参考其 references 文档,资料未展开。