wevu 概览

wevu 是一个面向小程序（以微信小程序为主）的轻量运行时。你可以把它理解成：“把 Vue 3 的响应式心智模型带到小程序里”，但不引入 Virtual DOM，而是用快照 diff 来尽量减少 setData 的更新量。

它主要提供：

wevu 不改变小程序“数据驱动 + 模板渲染”的基本模型：你仍然写 WXML/WXSS（或配合 weapp-vite 用 Vue SFC 编写模板/样式/配置），但业务逻辑可以用熟悉的 Composition API 组织起来。

wevu 在整套体系里的位置

如果你同时使用 weapp-vite 的 Vue SFC：

因此遇到问题时可以快速分层定位：

这段背景不影响使用，你可以先跳过：

最初想叫 wevue（weapp + vue），但 npm 已被占用，于是缩写成了 wevu。
在为 weapp-vite 补齐 Vue SFC 支持时，调研过社区方案（如 vue-mini），但编译器与运行时都需要大改，最后选择自己实现以更贴合小程序。
借鉴 Vue 3 的响应式设计思路，并考虑多小程序平台适配，逐步形成现在的 wevu。

响应式与调度：与 Vue 3 相同心智的 ref / reactive / computed / watch / watchEffect，更新通过微任务批量调度（nextTick）。
页面/组件注册：defineComponent() 统一通过小程序 Component() 注册；createApp() 可在存在全局 App() 时自动注册应用；createWevuComponent() 供 weapp-vite 编译产物调用。
最小化 setData：运行时把 state + computed 转为 plain snapshot，diff 后只把变化路径传给 setData。
双向绑定辅助：bindModel(path) 生成适配小程序事件的数据/事件绑定对象。
Store（状态管理）：defineStore / storeToRefs / createStore（可选插件入口）。

导入约定

运行时 API 都从 wevu 主入口导入；不支持 wevu/store、wevu/runtime 等子路径。wevu/compiler 仅供 weapp-vite 等编译侧工具使用（非稳定用户 API）。

wevu/compiler 用来承载 wevu 与编译工具之间的共享常量，避免在多个项目里重复写字符串：

WE_VU_MODULE_ID：运行时入口模块名（wevu）。
WE_VU_RUNTIME_APIS：运行时 API 名称集合（如 createApp / defineComponent / createWevuComponent）。
WE_VU_PAGE_HOOK_TO_FEATURE：页面 hook 与 features 的映射表。

这些导出面向编译工具（例如 weapp-vite），应用代码不要依赖它们作为稳定 API。