weapp-vite 6.11.9 → 6.12.1

package/README.md

@@ -31,6 +31,8 @@
 
 ## 快速开始
 
+> 说明：CLI 同时支持完整命令 `weapp-vite` 与简写命令 `wv`，两者等价。下面的示例默认使用 `weapp-vite`，你也可以按个人习惯替换成 `wv`。
+
 ### Vue 项目
 
 ```typescript
@@ -85,6 +87,42 @@ function handleClick() {
 - Vite 插件识别 weapp-vite 宿主：https://vite.icebreaker.top/guide/vite-plugin-host
 - MCP 集成使用指南：[docs/mcp.md](./docs/mcp.md)
 
+## AI 项目指引
+
+通过 `create-weapp-vite` 创建的新项目，现在会默认携带一个根目录 `AGENTS.md`。同时，`weapp-vite` npm 包会随版本发布一份本地文档目录：`node_modules/weapp-vite/dist/docs/`。
+
+这个文件会告诉常见 AI 编程代理：
+
+- 安装依赖后，优先阅读 `node_modules/weapp-vite/dist/docs/README.md`、`node_modules/weapp-vite/dist/docs/mcp.md` 等本地版本文档
+- CLI 同时支持 `weapp-vite` 与 `wv`
+- 需要做小程序截图验收时，优先使用 `weapp-vite screenshot` 或 `wv screenshot`
+- 不要把小程序运行时截图退化成通用浏览器截图
+- 需要看 DevTools 终端日志时，优先使用 `weapp-vite ide logs --open` 或 `wv ide logs --open`
+
+`dist/docs` 当前会内置这些文件：
+
+- `README.md`
+- `getting-started.md`
+- `ai-workflows.md`
+- `project-structure.md`
+- `weapp-config.md`
+- `wevu-authoring.md`
+- `vue-sfc.md`
+- `troubleshooting.md`
+- `mcp.md`
+- `volar.md`
+- `define-config-overloads.md`
+- `index.md`
+
+推荐的截图命令示例：
+
+```sh
+weapp-vite screenshot --project ./dist/build/mp-weixin --page pages/index/index --output .tmp/acceptance.png --json
+
+# 等价写法
+wv screenshot --project ./dist/build/mp-weixin --page pages/index/index --output .tmp/acceptance.png --json
+```
+
 ## DevTools 日志桥接
 
 `weapp-vite` 现在支持把微信开发者工具里的小程序 `console` 输出桥接到当前终端。
@@ -116,6 +154,9 @@ export default defineConfig({
 ```sh
 weapp-vite ide logs
 weapp-vite ide logs --open
+# 等价写法
+wv ide logs
+wv ide logs --open
 ```
 
 ## CLI 中调用 weapp-ide-cli
@@ -127,6 +168,8 @@ weapp-vite preview --project ./dist/build/mp-weixin
 weapp-vite upload --project ./dist/build/mp-weixin -v 1.0.0 -d "release"
 weapp-vite config lang zh
 weapp-vite navigate pages/index/index --project ./dist/build/mp-weixin
+# 等价写法
+wv preview --project ./dist/build/mp-weixin
 ```
 
 也支持命名空间写法：
@@ -135,6 +178,8 @@ weapp-vite navigate pages/index/index --project ./dist/build/mp-weixin
 weapp-vite ide preview --project ./dist/build/mp-weixin
 weapp-vite ide config show
 weapp-vite ide logs --open
+# 等价写法
+wv ide preview --project ./dist/build/mp-weixin
 ```
 
 ## CLI 启动 MCP
@@ -146,12 +191,16 @@ weapp-vite ide logs --open
 
 ```sh
 weapp-vite mcp
+# 等价写法
+wv mcp
 ```
 
 指定工作区根路径：
 
 ```sh
 weapp-vite mcp --workspace-root /absolute/path/to/weapp-vite
+# 等价写法
+wv mcp --workspace-root /absolute/path/to/weapp-vite
 ```
 
 在 `vite.config.ts` 中开启自动启动：

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext } from "./createContext-DZgOqIMU.mjs";
+import { i as getCompilerContext, l as getRouteRuntimeGlobalKeys } from "./createContext-Dk8fZ9cf.mjs";
 //#region src/auto-routes.ts
 const ROUTE_RUNTIME_OVERRIDE_KEY = Symbol.for("weapp-vite.route-runtime");
 function createGetter(resolver) {
@@ -28,7 +28,10 @@ function resolveMiniProgramGlobal() {
 	const runtime = globalThis;
 	const overrideRuntime = runtime[ROUTE_RUNTIME_OVERRIDE_KEY];
 	if (overrideRuntime) return overrideRuntime;
-	return runtime.wx ?? runtime.tt ?? runtime.my;
+	for (const key of getRouteRuntimeGlobalKeys()) {
+		const candidate = runtime[key];
+		if (candidate) return candidate;
+	}
 }
 function callRouteMethod(methodName, option) {
 	const miniProgramGlobal = resolveMiniProgramGlobal();