weapp-vite/dist/docs/index.md

weapp-vite 一个现代化的小程序打包工具

# weapp-vite dist docs

这个目录会随 `weapp-vite` npm 包一起发布，供 AI 代理和开发者优先读取与当前包版本匹配的本地文档。

这不是 `website` 的完整镜像，而是面向 AI 与离线开发场景的精简本地知识包。

推荐顺序：

1. 先读 `README.md` 与 `getting-started.md` 获取总体能力与常用命令。
2. 涉及 AI / MCP / screenshot / DevTools logs 时读 `ai-workflows.md` 与 `mcp.md`。
3. 涉及项目目录、`AGENTS.md`、`.weapp-vite` 时读 `project-structure.md`。
4. 涉及 `vite.config.ts`、`weapp` 配置与 chunk 策略时读 `weapp-config.md`。
5. 接入 uni-app Vue 组件库或 Wot UI 时读 `uni-app-component-libraries.md`。
6. 涉及 wevu 运行时与页面/组件/store 约束时读 `wevu-authoring.md`。
7. 涉及 Vue SFC 宏、模板约束与编辑器提示时读 `vue-sfc.md`、`volar.md` 与 `define-config-overloads.md`。
8. 编写页面或组件单测时读 `testing.md`。
9. 遇到告警、prepare、截图、日志、依赖异常时读 `troubleshooting.md`。

## Included Docs

- `README.md`: weapp-vite npm 包内置文档入口，供 AI 与开发者优先读取本地版本说明。
- `mcp.md`: MCP、AI 工作流与 screenshot 验收说明。
- `volar.md`: Volar、JSON 宏与编辑器智能提示支持说明。
- `define-config-overloads.md`: defineConfig 类型重载与配置推导说明。
- `getting-started.md`: CLI 命令、prepare、build、screenshot、MCP 等快速入口。
- `ai-workflows.md`: AI 代理在其他仓库里使用 weapp-vite 的推荐工作流。
- `project-structure.md`: AGENTS.md、.weapp-vite、dist 与源码目录的职责说明。
- `weapp-config.md`: weapp 配置、autoRoutes、autoImportComponents、routeRules 与 chunk 策略。
- `uni-app-component-libraries.md`: 实验性的 uni-app 组件库转换、Wot UI 配置、99 组件矩阵与双端边界。
- `wevu-authoring.md`: wevu 页面、组件、store、router 与事件契约的推荐写法。
- `vue-sfc.md`: definePageJson、definePageMeta、v-model 与模板兼容约束。
- `troubleshooting.md`: prepare、截图、日志、wevu 依赖与 dist 同步等常见排障。
- `testing.md`: 使用 mpcore、Vitest 与 weapp-vite 真实编译产物进行页面和组件测试。