@farris/cli 2.3.8 → 2.3.11

package/lib/plugins/msw-adapter.js

@@ -0,0 +1,141 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { pathToFileURL } from 'node:url';
+import { randomUUID } from 'node:crypto';
+/** @farris/cli 目前适配的 msw 主版本（应用的 msw 由模板声明、随工作区 catalog 统一） */
+const SUPPORTED_MAJOR = 2;
+const toPosix = (p) => p.split('\\').join('/');
+/** 路径比较统一按 posix + 小写（Windows 下 server 侧给的是 C:/...，本地 join 给的是 C:\...） */
+const normalize = (p) => toPosix(p).toLowerCase();
+// handleRequest 的 emitter 参数只用于生命周期事件通知，dev 期无需监听；
+// msw 未从包根导出该类型，按参数位置断言，避免额外依赖 strict-event-emitter
+const noopEmitter = { emit() { } };
+const sharedOptions = { onUnhandledRequest: () => null };
+const loadingRuntimes = new Map();
+async function resolveAppMsw(appRoot) {
+    const require = createRequire(join(appRoot, 'package.json'));
+    let entry;
+    let pkgPath;
+    try {
+        // 先按包名解析：pnpm 下命中应用自己的 node_modules，npm 下命中提升后的 node_modules
+        pkgPath = require.resolve('msw/package.json');
+        entry = require.resolve('msw');
+    }
+    catch (err) {
+        throw new Error(`未能在应用目录解析到 msw（${appRoot}）：请先在应用工程内安装依赖（msw 已由应用模板放入 devDependencies）。` +
+            `若工程由旧版脚手架创建，请升级 @farris/cli 或手动执行 pnpm add -D msw@^2。原因：` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    const version = String(JSON.parse(readFileSync(pkgPath, 'utf8')).version ?? '');
+    const major = Number.parseInt(version.split('.')[0] ?? '', 10);
+    if (major !== SUPPORTED_MAJOR) {
+        throw new Error(`应用安装的 msw 版本为 ${version}，@farris/cli 目前只适配 ${SUPPORTED_MAJOR}.x：` +
+            `请把应用里的 msw 对齐到 ${SUPPORTED_MAJOR}.x（工作区 catalog 已统一版本）`);
+    }
+    const mod = (await import(pathToFileURL(entry).href));
+    const handleRequest = mod.handleRequest ?? mod.default?.handleRequest;
+    if (typeof handleRequest !== 'function') {
+        throw new Error(`msw ${version} 的入口未导出 handleRequest（${entry}），无法执行 mock handler`);
+    }
+    return { handleRequest, version };
+}
+/**
+ * 从应用目录解析并加载 msw（应用 devDependencies 里的那一份）。
+ * 同一应用目录只加载一次；加载失败不缓存，装好依赖后重试即可。
+ */
+export function loadAppMsw(appRoot) {
+    const cached = loadingRuntimes.get(appRoot);
+    if (cached) {
+        return cached;
+    }
+    const loading = resolveAppMsw(appRoot);
+    loadingRuntimes.set(appRoot, loading);
+    loading.catch(() => loadingRuntimes.delete(appRoot));
+    return loading;
+}
+/** 读取 handler 的 info（方法/路径），用于重复路径校验 */
+export function handlerInfo(handler) {
+    return handler.info ?? {};
+}
+/** 默认导出的项是否为 MSW 的 HTTP handler */
+export function isRequestHandler(value) {
+    return !!value && typeof handlerInfo(value).method === 'string';
+}
+/** 是否位于指定目录内（按 posix、大小写不敏感比较，并要求完整目录边界，避免同名前缀目录误判） */
+export function isInsideDir(file, dir) {
+    const target = normalize(file);
+    const base = normalize(dir).replace(/\/+$/, '');
+    return target === base || target.startsWith(`${base}/`);
+}
+/** 非流式场景下的请求体读取（按 chunk 收集） */
+function readBufferedBody(req) {
+    return new Promise((resolve) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(String(chunk)));
+        req.on('end', () => resolve(chunks.length > 0 ? chunks.join('') : undefined));
+        req.on('error', () => resolve(undefined));
+    });
+}
+/** 把 Node 请求转成 fetch Request（handleRequest 的输入） */
+export async function toWebRequest(req, origin) {
+    const method = (req.method ?? 'GET').toUpperCase();
+    const hasBody = method !== 'GET' && method !== 'HEAD';
+    const init = {
+        method,
+        headers: new Headers(req.headers)
+    };
+    if (hasBody) {
+        // 真实 dev server 下 req 是可读流，直接流式交给 fetch；测试替身等场景退化为缓冲读取
+        init.duplex = 'half';
+        init.body =
+            req.readable && typeof Readable.toWeb === 'function'
+                ? Readable.toWeb(req)
+                : await readBufferedBody(req);
+    }
+    return new Request(new URL(req.url ?? '/', origin), init);
+}
+/** 把 fetch Response 流式写回 Node 响应 */
+async function writeResponse(res, response) {
+    res.statusCode = response.status;
+    if (response.statusText) {
+        res.statusMessage = response.statusText;
+    }
+    response.headers.forEach((value, name) => {
+        // appendHeader 才符合多值头（如 set-cookie）的语义，Node 18.3 起可用
+        if (typeof res.appendHeader === 'function') {
+            res.appendHeader(name, value);
+        }
+        else {
+            res.setHeader(name, value);
+        }
+    });
+    if (response.body) {
+        try {
+            await pipeline(Readable.fromWeb(response.body), res);
+        }
+        catch {
+            // 客户端提前断开或响应流异常：连接已不可用，回收即可，不向上抛
+            res.destroy();
+        }
+        return;
+    }
+    res.end();
+}
+/**
+ * 用应用侧的 msw 处理一次请求。
+ * 命中 mock 时写回响应并返回状态码；未命中返回 null，由调用方放行给代理或 404 守卫。
+ */
+export async function runMockHandlers(req, res, handlers, runtime) {
+    const origin = `http://${req.headers.host ?? 'localhost'}`;
+    const request = await toWebRequest(req, origin);
+    const response = await runtime.handleRequest(request, randomUUID(), handlers, sharedOptions, noopEmitter, { resolutionContext: { baseUrl: origin } });
+    if (!response) {
+        return null;
+    }
+    await writeResponse(res, response);
+    return response.status;
+}
+//# sourceMappingURL=msw-adapter.js.map

package/lib/plugins/msw-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msw-adapter.js","sourceRoot":"","sources":["../../src/plugins/msw-adapter.ts"],"names":[],"mappings":"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"}

package/lib/plugins/replace.js

@@ -1,18 +1,18 @@
-import { getPackageName } from '../common/constant.js';
-export function replace(path) {
-    return {
-        name: 'farris-replace-path',
-        renderChunk(code, chunk) {
-            const fileNames = chunk.fileName.split('.');
-            const format = fileNames[fileNames.length - 2];
-            // const regExpress = new RegExp(/@farris\/mobile-ui-vue\/([\w-]+)/g);
-            const dynamicRegExp = new RegExp(`${getPackageName().replace(/\//g, '\\/')}\\/([\\w-]+)`, // 自动转义斜杠
-            'g');
-            return code.replace(dynamicRegExp, (match, captureGroup) => {
-                return path(format, [captureGroup]);
-            });
-        }
-    };
-}
-;
+import { getPackageName } from '../common/constant.js';
+export function replace(path) {
+    return {
+        name: 'farris-replace-path',
+        renderChunk(code, chunk) {
+            const fileNames = chunk.fileName.split('.');
+            const format = fileNames[fileNames.length - 2];
+            // const regExpress = new RegExp(/@farris\/mobile-ui-vue\/([\w-]+)/g);
+            const dynamicRegExp = new RegExp(`${getPackageName().replace(/\//g, '\\/')}\\/([\\w-]+)`, // 自动转义斜杠
+            'g');
+            return code.replace(dynamicRegExp, (match, captureGroup) => {
+                return path(format, [captureGroup]);
+            });
+        }
+    };
+}
+;
 //# sourceMappingURL=replace.js.map

package/lib/plugins/systemjs-bundle.js

@@ -1,16 +1,16 @@
-export function systemjsBundle() {
-    return {
-        name: 'systemjs-bundle',
-        outputOptions(options) {
-            if (options.format === 'systemjs') {
-                return {
-                    ...options,
-                    name: undefined
-                };
-            }
-            return options;
-        }
-    };
-}
-;
+export function systemjsBundle() {
+    return {
+        name: 'systemjs-bundle',
+        outputOptions(options) {
+            if (options.format === 'systemjs') {
+                return {
+                    ...options,
+                    name: undefined
+                };
+            }
+            return options;
+        }
+    };
+}
+;
 //# sourceMappingURL=systemjs-bundle.js.map

package/lib/plugins/systemjs-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"systemjs-bundle.js","sourceRoot":"","sources":["../../src/plugins/systemjs-bundle.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,aAAa,CAAC,OAAY;YACxB,IAAG,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE;gBAChC,OAAO;oBACL,GAAG,OAAO;oBACV,IAAI,EAAE,SAAS;iBAChB,CAAC;aACH;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAAA,CAAC"}
+{"version":3,"file":"systemjs-bundle.js","sourceRoot":"","sources":["../../src/plugins/systemjs-bundle.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,aAAa,CAAC,OAAY;YACxB,IAAG,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,OAAO;oBACL,GAAG,OAAO;oBACV,IAAI,EAAE,SAAS;iBAChB,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAAA,CAAC"}

package/package.json

@@ -1,87 +1,93 @@
-{
-    "name": "@farris/cli",
-    "private": false,
-    "version": "2.3.8",
-    "type": "module",
-    "typings": "lib/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./lib/commands/create.js",
-            "import": "./lib/commands/create.js"
-        }
-    },
-    "bin": {
-        "farris-cli": "./bin/index.js"
-    },
-    "engines": {
-        "node": "^18.0.0 || >=20.0.0",
-        "pnpm": ">=9.0.0"
-    },
-    "scripts": {
-        "build": "rimraf ./lib && tsc",
-        "test": "vitest run --config vitest.config.ts"
-    },
-    "files": [
-        "lib",
-        "templates",
-        "bin"
-    ],
-    "license": "MIT",
-    "dependencies": {
-        "commander": "^9.4.0",
-        "glob": "^10.4.5",
-        "inquirer": "^9.3.0",
-        "ora": "^8.0.1"
-    },
-    "peerDependencies": {
-        "@vitejs/plugin-vue": "^5.2.4",
-        "@vitejs/plugin-vue-jsx": "^3.0.0",
-        "esbuild": "^0.23.0",
-        "esbuild-sass-plugin": "^3.3.1",
-        "typescript": "^5.7.3",
-        "vite": "^5.4.19",
-        "vite-plugin-css-injected-by-js": "^3.5.2",
-        "vite-plugin-dts": "^3.9.1"
-    },
-    "peerDependenciesMeta": {
-        "@vitejs/plugin-vue": {
-            "optional": true
-        },
-        "@vitejs/plugin-vue-jsx": {
-            "optional": true
-        },
-        "esbuild": {
-            "optional": true
-        },
-        "esbuild-sass-plugin": {
-            "optional": true
-        },
-        "typescript": {
-            "optional": true
-        },
-        "vite": {
-            "optional": true
-        },
-        "vite-plugin-css-injected-by-js": {
-            "optional": true
-        },
-        "vite-plugin-dts": {
-            "optional": true
-        }
-    },
-    "devDependencies": {
-        "@types/inquirer": "^9.0.7",
-        "@vitejs/plugin-vue": "^5.2.4",
-        "@vitejs/plugin-vue-jsx": "^3.0.0",
-        "esbuild": "^0.23.0",
-        "esbuild-sass-plugin": "^3.3.1",
-        "rimraf": "^5.0.7",
-        "sass": "^1.90.0",
-        "typescript": "^5.7.3",
-        "vite": "^5.4.19",
-        "vite-plugin-css-injected-by-js": "^3.5.2",
-        "vite-plugin-dts": "^3.9.1",
-        "vitest": "^1.6.1",
-        "vue": "^3.5.13"
-    }
-}
+{
+    "name": "@farris/cli",
+    "private": false,
+    "version": "2.3.11",
+    "type": "module",
+    "typings": "lib/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./lib/commands/create.js",
+            "import": "./lib/commands/create.js"
+        }
+    },
+    "bin": {
+        "farris-cli": "./bin/index.js"
+    },
+    "engines": {
+        "node": "^18.0.0 || >=20.0.0",
+        "pnpm": ">=9.0.0"
+    },
+    "scripts": {
+        "build": "rimraf ./lib && tsc",
+        "prepublishOnly": "npm run build",
+        "test": "vitest run --config vitest.config.ts"
+    },
+    "files": [
+        "lib",
+        "templates",
+        "bin"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "commander": "^9.4.0",
+        "glob": "^10.4.5",
+        "inquirer": "^9.3.0",
+        "ora": "^8.0.1"
+    },
+    "peerDependencies": {
+        "@vitejs/plugin-vue": "^5.2.4",
+        "@vitejs/plugin-vue-jsx": "^3.0.0",
+        "esbuild": "^0.23.0",
+        "esbuild-sass-plugin": "^3.3.1",
+        "msw": "^2.15.0",
+        "typescript": "^5.7.3",
+        "vite": "^5.4.19",
+        "vite-plugin-css-injected-by-js": "^3.5.2",
+        "vite-plugin-dts": "^3.9.1"
+    },
+    "peerDependenciesMeta": {
+        "@vitejs/plugin-vue": {
+            "optional": true
+        },
+        "@vitejs/plugin-vue-jsx": {
+            "optional": true
+        },
+        "esbuild": {
+            "optional": true
+        },
+        "esbuild-sass-plugin": {
+            "optional": true
+        },
+        "msw": {
+            "optional": true
+        },
+        "typescript": {
+            "optional": true
+        },
+        "vite": {
+            "optional": true
+        },
+        "vite-plugin-css-injected-by-js": {
+            "optional": true
+        },
+        "vite-plugin-dts": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@types/inquirer": "^9.0.7",
+        "@vitejs/plugin-vue": "^5.2.4",
+        "@vitejs/plugin-vue-jsx": "^3.0.0",
+        "esbuild": "^0.23.0",
+        "esbuild-sass-plugin": "^3.3.1",
+        "msw": "^2.15.0",
+        "rimraf": "^5.0.7",
+        "sass": "^1.90.0",
+        "typescript": "^5.7.3",
+        "vite": "^5.4.19",
+        "vite-plugin-css-injected-by-js": "^3.5.2",
+        "vite-plugin-dts": "^3.9.1",
+        "vitest": "^1.6.1",
+        "vue": "^3.5.13"
+    }
+}

package/templates/create/AGENTS.md

@@ -52,9 +52,10 @@
 
 ### 2.5 数据来源与 Mock
 
-- 开发期接口数据来自工程内 `mock/` 目录（写法与行为见该目录 README）；未命中的请求按 `farris.config.mjs` 的 `proxy` 转发。
-- 联调真实后端：在**工程目录内**执行 `pnpm dev --no-mock`，业务代码不改。
-- 请求路径必须与 mock 的 `url` 逐字一致；禁止在组件里散落假数据；`mock/` 不得进入构建产物。
+- 开发期接口数据默认来自工程内 `mock/` 目录，用 **MSW handler** 写法（见该目录 README）；未命中请求按 `farris.config.mjs` 的 `proxy` 转发。
+- 联调真实后端：在**工程目录内**执行 `pnpm dev --no-mock`（或 `MOCK=none pnpm dev`），业务代码不改。
+- 请求路径必须与 mock 的 `url` 逐字一致；禁止在组件里散落假数据。
+- mock 不得进入构建产物：`msw` 已在应用 `devDependencies`（开发期依赖），不要在 `mock/` 之外引用它，也不要把它加到 `dependencies`。
 
 ### 2.6 工程内生成器
 

package/templates/lib/.gitignore.tpl

@@ -31,3 +31,4 @@ package-lock.json
 .windsurf/
 .trae/
 .opencode/
+.prototypes/

package/templates/micro/.gitignore.tpl

@@ -31,3 +31,4 @@ package-lock.json
 .windsurf/
 .trae/
 .opencode/
+.prototypes/

package/templates/micro/mock/README.md

@@ -1,40 +1,53 @@
 # mock 目录
 
-开发期接口数据。一个领域一个文件，命名 `*.mock.ts`，默认导出路由数组：
+开发期接口数据。用 MSW 写法，库本身的用法见 MSW 官方文档。一个领域一个文件，命名 `*.mock.ts`，只导出 handler 数组：
 
 ```ts
-export default [
-  {
-    url: '/api/v1/users', // 必须与代码中的请求路径逐字一致
-    method: 'GET', // 默认 GET
-    timeout: 300, // 可选 模拟延迟毫秒
-    status: 200, // 可选 响应状态码
-    response: ({ query, params, body }) => ({
-      data: [],
-      total: 0
-    })
-  }
+import { http, HttpResponse, delay } from 'msw';
+
+export const handlers = [
+  http.get('/api/v1/users', async ({ request }) => {
+    const keyword = new URL(request.url).searchParams.get('keyword') ?? '';
+    await delay(300); // 可选：模拟延迟，单位毫秒
+    return HttpResponse.json({ data: [], total: 0 }); // 形状跟客户端出口走
+  }),
+  http.get('/api/v1/users/:id', ({ params }) => HttpResponse.json({ data: { id: params.id } })),
+  http.post('/api/v1/users', async ({ request }) => {
+    const body = await request.json();
+    return HttpResponse.json({ id: 'u-new', ...body }, { status: 201 });
+  })
 ];
 ```
 
 ## 加一条 mock 并验证
 
-1. 先在 `src/api/` 里确认请求路径（例如 `/api/v1/users`），逐字抄进 `url`。
-2. 新建或追加 `mock/<领域>.mock.ts`，按上面的形状写 `url` / `method` / `response`。
+1. 先在 `src/api/` 里确认实际请求路径（例如 `/api/v1/users`），逐字抄进 handler 路径，前缀也要带上。
+2. 新建或追加 `mock/<领域>.mock.ts`，按上面的形状写 handler；同一前缀下字面量路径写在 `:参数名` 之前。
 3. 在工程目录执行 `pnpm dev`，打开用到该接口的页面，**验证**返回的是 mock 数据。
-4. 需要联调真实后端时：`pnpm dev --no-mock`（或 `MOCK=none pnpm dev`），业务代码不改。
+4. 需要联调真实后端时执行 `pnpm dev --no-mock`（或 `MOCK=none pnpm dev`），业务代码不改。
 
-## 规则
+规则：
 
-- url 必须与代码中的请求路径逐字一致，见 `src/api/` 下的接口模块。
-- 路径参数在 url 里用 `:参数名` 表示，例如 `/api/v1/users/:id`；查询参数不写进 url，在 response 的 `query` 里读取。
-- mock 响应体必须能被工程的 HTTP 客户端正确消费，形状跟着客户端出口走。
-- 同一 url 不允许在多个 mock 文件中重复定义，重复时开发服务启动即报错。
-- mock 只用于开发期：不进构建产物，也不要在组件里散落假数据。
+- url 必须与代码实际发出的请求路径逐字一致，前缀也要带上；请求路径见 `src/api/` 下的接口模块。
+- url 只写路径，以 `/` 开头，不要写协议与主机。写 `/api/v1/users`，不要写 `http://localhost:3000/api/v1/users`；主机或端口不同时不会命中。
+- 路径参数在 url 里用 `:参数名` 表示，例如 `/api/v1/users/:id`。查询参数不写进 url，用 `new URL(request.url).searchParams` 读取。
+- 同一前缀下同时有字面量路径与 `:参数名` 路径时，字面量写在前面。MSW 取第一个匹配的 handler，`/api/v1/users/current` 排在 `/api/v1/users/:id` 后面会被 `:id` 接走。
+- 响应体必须能被工程的 HTTP 客户端正确消费，形状跟着客户端出口走。数据要有业务语义，用中文姓名、机构、单据号这类内容，不要用占位文本。
+- 关键场景要模拟：空态、错误、慢响应。错误用 `HttpResponse.json(..., { status: 500 })`；慢响应用 `delay`。
+- 目录里只放 handler 文件。共享数据或工具函数要放进 `_` 开头的文件，例如 `_data.ts`，加载时会跳过；其他文件会被当作 handler 文件加载，导出内容不是 handler 就会报错。
+- 同一路径不允许在多个 mock 文件中重复定义，重复时开发服务启动或请求即报错。
+- 文件只导出 handler 数组，写 `export const handlers = [...]` 或 `export default [...]`。不需要 `setupServer` / `setupWorker` 接线；接线由脚手架完成。
+- `msw` 已由模板放进应用 `devDependencies`，版本随工作区 catalog 统一。不要把它加到 `dependencies`，也不要在 `mock/` 之外引用它，否则构建期会报错。
+- mock 只用于开发期，不参与构建，也不要在组件里散落假数据。
 
-## 行为与开关
+行为：
 
-- 命中 mock → 返回 mock 数据。
-- 未命中 → 按 `farris.config.mjs` 的 `proxy` 配置转发真实后端。
-- 未命中且未配代理的 `/api` 路径 → 返回 404 并提示，便于排查漏配。
-- 开关：工程目录内 `pnpm dev` 默认生效；`pnpm dev --no-mock` 或 `MOCK=none pnpm dev` 进真实后端联调。
+- 命中 mock 时返回 mock 数据。
+- 未命中时按 `farris.config.mjs` 的 `proxy` 配置转发真实后端。
+- 未命中且未配代理的 `/api` 路径返回 404 并提示，便于排查漏配。
+
+开关：在工程目录执行 `pnpm dev` 默认生效；`pnpm dev --no-mock` 或 `MOCK=none pnpm dev` 进入真实后端联调。
+
+类型：本目录附带独立的 `tsconfig.json`，只服务于编辑器与按需类型检查。应用自身的 `typecheck` 不包含本目录，mock 也不参与构建。
+
+约定版本 2026-09。本文件随 `@farris/cli` 模板发布，AI 协作以本文件为准。

package/templates/micro/mock/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  // mock 目录的独立 TS 工程：只服务于编辑器与按需类型检查（应用自身的 typecheck 不含本目录）。
+  // msw 是应用的开发期依赖（见 package.json 的 devDependencies），按常规模块解析即可。
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "composite": false,
+    "noEmit": true
+  },
+  "include": ["**/*.ts", "**/*.d.ts"]
+}

package/templates/micro/package.json

@@ -35,6 +35,7 @@
     "eslint": "^8.57.0",
     "eslint-plugin-vue": "^9.23.0",
     "jsdom": "^25.0.1",
+    "msw": "^2.15.0",
     "prettier": "^3.2.5",
     "typescript": "~5.4.0",
     "vite": "^5.4.19",

package/templates/mobile/.gitignore.tpl

@@ -31,3 +31,4 @@ package-lock.json
 .windsurf/
 .trae/
 .opencode/
+.prototypes/

package/templates/mobile/mock/README.md

@@ -1,40 +1,53 @@
 # mock 目录
 
-开发期接口数据。一个领域一个文件，命名 `*.mock.ts`，默认导出路由数组：
+开发期接口数据。用 MSW 写法，库本身的用法见 MSW 官方文档。一个领域一个文件，命名 `*.mock.ts`，只导出 handler 数组：
 
 ```ts
-export default [
-  {
-    url: '/api/v1/users', // 必须与代码中的请求路径逐字一致
-    method: 'GET', // 默认 GET
-    timeout: 300, // 可选 模拟延迟毫秒
-    status: 200, // 可选 响应状态码
-    response: ({ query, params, body }) => ({
-      data: [],
-      total: 0
-    })
-  }
+import { http, HttpResponse, delay } from 'msw';
+
+export const handlers = [
+  http.get('/api/v1/users', async ({ request }) => {
+    const keyword = new URL(request.url).searchParams.get('keyword') ?? '';
+    await delay(300); // 可选：模拟延迟，单位毫秒
+    return HttpResponse.json({ data: [], total: 0 }); // 形状跟客户端出口走
+  }),
+  http.get('/api/v1/users/:id', ({ params }) => HttpResponse.json({ data: { id: params.id } })),
+  http.post('/api/v1/users', async ({ request }) => {
+    const body = await request.json();
+    return HttpResponse.json({ id: 'u-new', ...body }, { status: 201 });
+  })
 ];
 ```
 
 ## 加一条 mock 并验证
 
-1. 先在 `src/api/` 里确认请求路径（例如 `/api/v1/users`），逐字抄进 `url`。
-2. 新建或追加 `mock/<领域>.mock.ts`，按上面的形状写 `url` / `method` / `response`。
+1. 先在 `src/api/` 里确认实际请求路径（例如 `/api/v1/users`），逐字抄进 handler 路径，前缀也要带上。
+2. 新建或追加 `mock/<领域>.mock.ts`，按上面的形状写 handler；同一前缀下字面量路径写在 `:参数名` 之前。
 3. 在工程目录执行 `pnpm dev`，打开用到该接口的页面，**验证**返回的是 mock 数据。
-4. 需要联调真实后端时：`pnpm dev --no-mock`（或 `MOCK=none pnpm dev`），业务代码不改。
+4. 需要联调真实后端时执行 `pnpm dev --no-mock`（或 `MOCK=none pnpm dev`），业务代码不改。
 
-## 规则
+规则：
 
-- url 必须与代码中的请求路径逐字一致，见 `src/api/` 下的接口模块。
-- 路径参数在 url 里用 `:参数名` 表示，例如 `/api/v1/users/:id`；查询参数不写进 url，在 response 的 `query` 里读取。
-- mock 响应体必须能被工程的 HTTP 客户端正确消费，形状跟着客户端出口走。
-- 同一 url 不允许在多个 mock 文件中重复定义，重复时开发服务启动即报错。
-- mock 只用于开发期：不进构建产物，也不要在组件里散落假数据。
+- url 必须与代码实际发出的请求路径逐字一致，前缀也要带上；请求路径见 `src/api/` 下的接口模块。
+- url 只写路径，以 `/` 开头，不要写协议与主机。写 `/api/v1/users`，不要写 `http://localhost:3000/api/v1/users`；主机或端口不同时不会命中。
+- 路径参数在 url 里用 `:参数名` 表示，例如 `/api/v1/users/:id`。查询参数不写进 url，用 `new URL(request.url).searchParams` 读取。
+- 同一前缀下同时有字面量路径与 `:参数名` 路径时，字面量写在前面。MSW 取第一个匹配的 handler，`/api/v1/users/current` 排在 `/api/v1/users/:id` 后面会被 `:id` 接走。
+- 响应体必须能被工程的 HTTP 客户端正确消费，形状跟着客户端出口走。数据要有业务语义，用中文姓名、机构、单据号这类内容，不要用占位文本。
+- 关键场景要模拟：空态、错误、慢响应。错误用 `HttpResponse.json(..., { status: 500 })`；慢响应用 `delay`。
+- 目录里只放 handler 文件。共享数据或工具函数要放进 `_` 开头的文件，例如 `_data.ts`，加载时会跳过；其他文件会被当作 handler 文件加载，导出内容不是 handler 就会报错。
+- 同一路径不允许在多个 mock 文件中重复定义，重复时开发服务启动或请求即报错。
+- 文件只导出 handler 数组，写 `export const handlers = [...]` 或 `export default [...]`。不需要 `setupServer` / `setupWorker` 接线；接线由脚手架完成。
+- `msw` 已由模板放进应用 `devDependencies`，版本随工作区 catalog 统一。不要把它加到 `dependencies`，也不要在 `mock/` 之外引用它，否则构建期会报错。
+- mock 只用于开发期，不参与构建，也不要在组件里散落假数据。
 
-## 行为与开关
+行为：
 
-- 命中 mock → 返回 mock 数据。
-- 未命中 → 按 `farris.config.mjs` 的 `proxy` 配置转发真实后端。
-- 未命中且未配代理的 `/api` 路径 → 返回 404 并提示，便于排查漏配。
-- 开关：工程目录内 `pnpm dev` 默认生效；`pnpm dev --no-mock` 或 `MOCK=none pnpm dev` 进真实后端联调。
+- 命中 mock 时返回 mock 数据。
+- 未命中时按 `farris.config.mjs` 的 `proxy` 配置转发真实后端。
+- 未命中且未配代理的 `/api` 路径返回 404 并提示，便于排查漏配。
+
+开关：在工程目录执行 `pnpm dev` 默认生效；`pnpm dev --no-mock` 或 `MOCK=none pnpm dev` 进入真实后端联调。
+
+类型：本目录附带独立的 `tsconfig.json`，只服务于编辑器与按需类型检查。应用自身的 `typecheck` 不包含本目录，mock 也不参与构建。
+
+约定版本 2026-09。本文件随 `@farris/cli` 模板发布，AI 协作以本文件为准。