用途:把通用 Web 应用改造成可在 Sealos Desktop 内运行的 Sealos 应用,或从零搭建新应用,也可产出文档或教程。
主要能力:识别起点(新建、适配已有应用、补充身份与业务数据集成、写文档);集成 Sealos 应用 SDK;将 Sealos 身份映射到业务数据;准备本地调试;准备发布。
使用方式:先安装 SDK,例如 pnpm add @labring/sealos-desktop-sdk(也可用 npm install 或 yarn add)。在仅客户端根组件中初始化一次,尽早获取 getSession() 与 getLanguage(),把 session、语言、加载状态和桌面可用性存入共享上下文或 store;需要运行时语言同步时监听 EVENT_NAME.CHANGE_I18N;在非 Sealos Desktop 环境提供降级回退。可用模板:React 用 assets/templates/react/sealos-provider.tsx,Vue 用 assets/templates/vue/use-sealos.ts。业务数据集成以 session.user.id 作为稳定用户标识,业务数据保存在应用自身数据库与 API 路由中。本地调试通常需由 Sealos Desktop 以 iframe 打开,避免服务端调用 SDK。发布前检查环境变量、数据库连接与迁移、从 Desktop 启动是否正常、跨应用导航或事件是否有效,并总结剩余人工注册或平台配置步骤。
适用场景:新建 Sealos 应用、适配已有 Web 应用、补充身份与业务数据集成、编写教程。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分细节需参考技能内附带的 references 文件(如 sdk-capabilities.md、minimal-app-template.md、nextjs-app-router.md、data-integration-patterns.md、local-debug-and-test-app.md、publish-checklist.md)。