扩展开发概览

把一个页面、一条命令或一张工作台卡片，作为独立的 .mipx 扩展交付给 MIP Desktop。先理解宿主提供什么，再选择最小的接入方式。

#选择适合的接入方式

普通 Web 应用不需要为了接入平台而转换成 .mipx。扩展 SDK 与普通应用 SDK 面向不同的运行环境，权限和调用方式不能混用。

#认识三个部分

Manifest 描述扩展的身份、版本、运行入口、权限和界面贡献。宿主根据清单决定哪些入口可以显示、哪些调用可以执行。

Extension Host 执行需要宿主上下文的命令和生命周期逻辑。它与扩展 WebView 分开运行，入口应构建为宿主支持的 CommonJS JavaScript。

WebView 展示扩展自己的 HTML、CSS 和脚本，通过公开 Bridge 或扩展 SDK 使用受控能力。页面不直接导入 Desktop 的 Vue、Pinia、Electron 或内部路由。

只有页面的最小扩展可以不提供 Host 入口；需要注册命令时再增加 main。查看 Host、WebView 与 SDK 了解两种环境的区别。

#从最小能力开始

1. 按 快速开始 创建一个不访问业务后台的页面扩展。
2. 根据 Manifest 规范 声明需要的入口和权限。
3. 需要身份、后台或存储时，阅读 权限与身份。
4. 根据入口位置选择 页面与贡献点。
5. 完成 调试、打包与发布 的检查，再通过实际发布渠道交付。

#确认能力与版本

这份指南按公开扩展契约组织。示例涉及的基础能力使用 Extension API 1.x；较新的 SDK 或贡献点不代表已经存在于所有已安装的 Desktop 中。

扩展包版本、SDK 包版本、Extension API 版本和 Desktop 产品版本各自有独立含义。发布者应记录实际验证的组合，并在 Manifest 中声明相应的兼容范围。

本指南不把开发源码中的能力视为全部发行版的保证。正式签名、远程分发和高级贡献点应按目标发行版的实际支持范围验证。

#开发边界

• 包内资源应自包含，安装后不从开发机目录或在线 CDN 获取运行代码。
• 权限按需声明；能力探测成功不等于已获得授权。
• 扩展只接收必要的身份上下文，不复制 Desktop Token、Cookie 或用户缓存。
• 关闭页面、停用扩展时释放监听器、连接和定时器。

需要获取 Desktop，可返回 下载首页。