使用 AI 开发微应用

用自然语言描述需求，让 AI 编码助手帮助你创建页面、接入迅雷平台能力，并构建、打包微应用。

官方提供了 xunlei-miniapp-dev Skill，为 AI 助手补充微应用的工程约定、平台 API 和开发流程。你可以用它创建新应用，也可以在已有项目中添加功能或排查问题。

1. 安装 Skill

新建项目时，先准备一个工作目录；已有项目则进入项目根目录。在该目录的终端中执行：

bash

npx skills add xunlei-open/miniapp-devkit

按提示完成安装，即可在 AI 助手中使用。

可以直接复制下面的需求开始：

text

使用 $xunlei-miniapp-dev 帮我开发一个迅雷图片裁剪微应用：
- 支持选择本地图片、调整裁剪区域和实时预览；
- 通过迅雷下载裁剪结果；

在需求中补充输入来源、主要操作、预期结果，以及偏好的技术栈或界面风格，有助于 AI 生成更符合预期的应用。也可以先完成核心功能，再逐步追加需求。

图片裁剪场景可参考官方示例 image-cut-miniapp，了解本地图片处理与迅雷下载能力的结合方式。

在现有项目目录中使用 Skill，并说明要保留的功能和新增需求，例如：

text

使用 $xunlei-miniapp-dev，为当前微应用增加下载失败提示和重试操作，请先阅读现有代码，沿用项目的技术栈、依赖版本与工程结构。

AI 生成代码后，按其交付说明确认检查结果和实际产物路径。默认工程提供两种体验方式：

方式	操作	适用场景
本地加载	在生成的项目目录运行 `npm run dev`，保持服务运行；在迅雷「微应用 → 加载本地应用」中选择 `dist/` 目录	开发调试、修改后预览
ZIP 安装	运行 `npm run package`，将 `output/` 中生成的 ZIP 拖入迅雷微应用管理页面	验证打包后的应用

已有项目的命令和目录以其配置及实际终端输出为准。详细步骤见本地调试和打包。

构建成功后，还需要验证功能

构建和打包不会自动执行类型检查；如项目提供类型检查命令，应单独运行。普通浏览器中没有迅雷的 xunlei 平台对象，页面预览正常不代表下载、存储或事件等功能已通过验证。请在迅雷客户端中走完主要操作流程。

遇到问题时，把复现步骤、报错日志和预期结果一起提供给 AI，便于继续排查。