native-to-weapp-vite-wevu-migration
weapp-vite/weapp-vite · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por weapp-vite/weapp-vite no skills.sh. Instale com: npx skills add weapp-vite/weapp-vite@native-to-weapp-vite-wevu-migration
Details
- Kind
- Agent skills
- Publisher
- weapp-vite
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 507
- Forks
- 30
- Open pull requests
- 9
- Last push
- 2026-10-08T10:58:52Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-10-07 06:30:02
- Updated
- 2026-10-07 06:30:02
- Origin id
weapp-vite/weapp-vite/native-to-weapp-vite-wevu-migration
README
<p align="center"> <img src="https://raw.githubusercontent.com/weapp-vite/weapp-vite/HEAD/website/public/logo.png" height="150" alt="weapp-vite logo"> </p> <h1 align="center">weapp-vite</h1> <p align="center"> <a href="https://deepwiki.com/weapp-vite/weapp-vite"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a> <a href="https://www.npmjs.com/package/weapp-vite"><img src="https://img.shields.io/npm/v/weapp-vite?logo=npm&label=npm" alt="npm version"></a> <a href="https://www.npmjs.com/package/weapp-vite"><img src="https://img.shields.io/npm/dm/weapp-vite?logo=npm&label=downloads" alt="npm downloads"></a> <a href="https://github.com/weapp-vite/weapp-vite/stargazers"><img src="https://img.shields.io/github/stars/weapp-vite/weapp-vite?style=social" alt="GitHub stars"></a> <a href="https://github.com/weapp-vite/weapp-vite/blob/main/LICENSE"><img src="https://img.shields.io/github/license/weapp-vite/weapp-vite" alt="License"></a> <a href="https://github.com/weapp-vite/weapp-vite/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/weapp-vite/weapp-vite/ci.yml?branch=main&label=CI" alt="CI status"></a> <a href="https://atomgit.com/sonofmagic/weapp-vite"><img src="https://atomgit.com/sonofmagic/weapp-vite/star/badge.svg" alt="GitCode Star"></a> </p> <p align="center"><strong>给小程序现代化的开发体验</strong></p> <p align="center"><a href="https://vite.weapp.dev">中文文档</a> · <a href="https://github.com/weapp-vite/weapp-vite/blob/HEAD/README.en-US.md">English README</a></p> `weapp-vite` 面向正在维护小程序的团队：既保留原生小程序的目录、语法和平台能力，又把 TypeScript、Vite/Rolldown、Vue SFC、自动化调试和 AI 协作带进日常研发。你可以从一个新模板开始，也可以把已有项目渐进接入进来。 ## 目录 - [为什么选择 weapp-vite](#为什么选择-weapp-vite) - [特性亮点](#特性亮点) - [快速开始](#快速开始) - [仓库结构](#仓库结构) - [核心包](#核心包) - [文档](#文档) - [参与贡献](#参与贡献) - [贡献者](#贡献者) - [Star History](#star-history) - [许可证](#许可证) ## 为什么选择 weapp-vite - **不必推翻现有小程序**：可以继续写原生 `Page` / `Component`、WXML、WXSS 和 JSON 配置；存量项目也能按目录迁移、配置补齐、依赖安装的方式渐进接入。 - **把日常开发效率补齐**：TypeScript、ESM、Sass/Less、PostCSS、Tailwind CSS、JSONC、路径别名和 Vite 插件生态可以直接进入小程序工程，不再靠零散脚本拼维护体验。 - **减少小程序工程的重复劳动**：自动构建 `miniprogram_npm`、分包依赖分析、自动导入组件、自动路由、布局、生成页面/组件等能力，适合页面多、分包多、组件多的项目。 - **保留原生能力，同时可逐步升级写法**：团队可以先用 `weapp-vite + 原生` 稳定构建链路，再在新页面或局部模块中引入 Vue SFC 与 Wevu，而不是一次性重写业务。 - **更适合真实小程序调试和验收**：`wv dev --open`、DevTools 配置预热、日志桥接、截图、截图对比、`preview/upload` 透传和 `analyze` 能覆盖从开发到上传前检查的常见链路。 - **让 AI 协作落到真实运行时**：脚手架会生成 `AGENTS.md`，并可接入 MCP、DevTools 日志、运行时截图和截图对比，让 AI 不只改代码，还能按小程序环境做验证。 ## 特性亮点 - 新项目：用 [`create-weapp-vite`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/create-weapp-vite) 选择原生、多平台 + Web、Vue SFC 多平台 + Web、Wevu、Tailwind CSS、TDesign、Vant、插件或组件库模板，并自动对齐依赖组合。 - 存量项目：通过手动集成或 `wv init` 接入现有小程序，保留原有页面结构和平台能力。 - Vue SFC：在小程序里使用 `.vue`、`<script setup>`、JSON 宏、class/style 绑定和 Wevu 响应式运行时。 - uni-app 组件库：通过 `WotUiResolver()` 或 `UviewPlusResolver()` 在微信小程序与 Web 中使用经过全组件矩阵验证的 Wot UI、uview-plus Vue SFC。 - 工程体验：支持构建、开发监听、HMR、组件自动导入、自动路由、分包策略、npm 构建和产物分析。 - IDE 与验收：集成 WeChat DevTools 打开、日志、截图、截图对比、预览和上传等工作流。 - AI 友好：提供 MCP、packaged docs、skills 指引和面向真实小程序运行时的检查入口。 ## 快速开始 ### 创建新项目 ```bash pnpm create weapp-vite ``` 需要用同一份源码覆盖微信、支付宝、抖音、百度、京东、小红书与 Web 时，可以按写法选择原生或 Vue SFC 多平台模板： ```bash # 原生 Page / Component pnpm create weapp-vite my-app multi-platform # Wevu + Vue SFC pnpm create weapp-vite my-app multi-platform-sfc ``` 两个模板都坚持单目标构建，具体命令、输出目录和验收边界见[多平台构建指南](https://vite.weapp.dev/guide/multi-platform)。 也可以使用： ```bash yarn create weapp-vite npm create weapp-vite@latest ``` 脚手架默认使用随包发布的依赖版本（`bundled`），生成项目时不查询远程版本，AI skills 默认跳过。模板随 npm 包分发，生成过程不需要下载 GitHub 模板。创建后进入项目目录执行 `pnpm install`、`pnpm build`、`pnpm dev`。 pnpm 12.5.1 默认有 24 小时发布冷却期（`minimumReleaseAge=1440`）。新版本发布后，`pnpm create weapp-vite` / `pnpm create weapp-vite@latest` 即使用官方源和全新缓存，也可能先运行满足发布年龄的旧版。默认非严格模式允许为明确指定的精确版本记录例外；启用严格模式的用户仍需等待或按 pnpm 提示与团队策略审批。不要仅凭选中旧版判断镜像或缓存异常，也不必全局关闭安全检查，详见[发布冷却期与精确版本恢复](https://vite.weapp.dev/packages/create-weapp-vite#pnpm-release-age)。 需要更新兼容版本时可显式启用联网查询，并指定当前可用的源： ```bash pnpm create weapp-vite my-app wevu --dependency-versions=compatible --registry=https://registry.npmmirror.com/ ``` 查询会读取 npm registry、作用域源、代理和 CA 配置，核心依赖与 Tailwind 共用最多 5 秒的网络预算；失败保留随包版本。`--registry` 只作用于脚手架启动后的查询及安装提示，首次下载脚手架仍由 pnpm 的配置决定。国内镜像可能延迟同步，网络异常、发布冷却期、旧脚手架缓存与精确版本恢复步骤见[脚手架文档](https://vite.weapp.dev/packages/create-weapp-vite)。离线生成不等于离线安装，依赖安装仍需要可用的 registry 或完整本地缓存。 ### 本地开发当前仓库 ```bash pnpm install pnpm build:pkgs pnpm test ``` 常用补充命令： ```bash pnpm build:apps pnpm build:templates pnpm build:docs ``` ## 仓库结构 - `packages/` 和 `packages-runtime/`：核心工具链与运行时包 - `@weapp-core/`：workspace 共享工具、常量和初始化能力 - `apps/`：示例和 playground 应用 - `templates/`：脚手架使用的项目模板 - `e2e/` 和 `e2e-apps/`：CI、真实运行时和 issue 复现覆盖 - `website/`：公开文档站点 - `docs/`：架构说明、计划和报告 - `extensions/`：编辑器和集成扩展 ## 核心包 - [`weapp-vite`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/weapp-vite)：主要的小程序构建器 - [`create-weapp-vite`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/create-weapp-vite)：官方项目脚手架 - [`@weapp-vite/mcp`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/mcp)：MCP 相关工具 - [`weapp-ide-cli`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/weapp-ide-cli)：微信开发者工具工作流辅助 CLI - [`rolldown-require`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages/rolldown-require)：基于 Rolldown 的文件打包与 require 辅助工具 - [`@wevu/query`](https://github.com/weapp-vite/weapp-vite/blob/HEAD/packages-runtime/wevu-query)：独立的 Wevu 服务端状态包，提供查询缓存、mutation 与分页；[使用指南](https://vite.weapp.dev/wevu/store#server-state-query) ## 文档 - 中文文档：<https://vite.weapp.dev> - 贡献指南：[CONTRIBUTING.md](https://github.com/weapp-vite/weapp-vite/blob/HEAD/CONTRIBUTING.md) - English README：[README.en-US.md](https://github.com/weapp-vite/weapp-vite/blob/HEAD/README.en-US.md) ## 参与贡献 欢迎提交 issue 和 PR： - 通过 issue 反馈 bug、功能建议或文档缺口。 - 通过 PR 提交修复、重构、文档或示例。 - 分享生产实践、中间件和生态集成经验。 贡献细节请查看 [CONTRIBUTING.md](https://github.com/weapp-vite/weapp-vite/blob/HEAD/CONTRIBUTING.md)。 ## 贡献者 感谢 [所有贡献者](https://github.com/weapp-vite/weapp-vite/graphs/contributors)。 ## Star History [](https://star-history.com/#weapp-vite/weapp-vite&Date) ## 许可证 本项目基于 MIT License 发布，详见 [LICENSE](https://github.com/weapp-vite/weapp-vite/blob/HEAD/LICENSE)。 ## AI 改动验收 通过 `wv accept --inspect --json` 检查环境；审阅配置后运行 `wv accept --trust --json`。现有 MCP 同时提供验收启动、状态、取消和报告工具，无需模型 Key。[接入指南](https://vite.weapp.dev/guide/acceptance)。独立 `weapp-agent` CLI 同仓维护并保留原命令。