@microi.net/cli 5.5.9 → 5.6.1

package/skills/playwright-e2e/references/progressive-01-/345/205/250/350/207/252/345/212/250/347/231/273/345/275/225-/345/205/215/351/252/214/350/257/201/347/240/201-/344/275/206/344/270/215/345/205/215/345/257/206/347/240/201-/345/277/205/350/257/273.md

@@ -3,52 +3,52 @@
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
 <!-- microi-progressive:chunk id=playwright-e2e-008 sha256=353b1e7ec1d3e93d1fac92c8e9d6e520bf77b628a4141524a09404814f7affb7 -->
-## 全自动登录（免验证码，但不免密码）——必读
-
-E2E 自动化最容易卡在「登录页有图形验证码」。Microi 后端允许自动化跳过验证码，但账号和密码必须始终走真实校验；如果密码配置错了，登录接口必须返回账号或密码错误。源码见 `Microi.Server/Microi.net.Api/Controllers/SysUserController.cs`（`Login` 方法开头）。
-
-### 方式 A：自动化登录参数（远端/本地通用）
-
-- 触发条件：请求体传 `_AutomationTestLogin=true` 或 `_SkipCaptchaForAutomation=true`，且当前租户 `sys_config.AutoTestSkipCaptcha=true`（中文 Label：允许自动化测试登录时绕开验证码；字段缺失时按默认开启兼容旧库）。
-- 效果：只跳过图形验证码，仍校验 `Account` / `Pwd`。
-- 适用：MCP 连接远端租户、CI、Playwright 截图验收、接口自动化登录。
-- 风险控制：如果远端环境不希望自动化免验证码，请在系统设置关闭【允许自动化测试登录时绕开验证码】。
-
-Playwright 登录助手（直接拿 Token，不走登录页）：
-
-```js
-// helpers/microi-login.js
-export async function automationLogin(page, {
-  backend = process.env.BACKEND || 'https://localhost:61501',
-  osClient = process.env.MICROI_OSCLIENT || 'iTdos',
-  account = process.env.PW_TEST_ACCOUNT || 'admin',
-  password = process.env.PW_TEST_PASSWORD || '',
-  frontend = process.env.FRONTEND || 'http://localhost:61500',
-} = {}) {
-  const resp = await page.request.post(`${backend}/api/SysUser/Login`, {
-    headers: { OsClient: osClient },
-    data: { Account: account, Pwd: password, OsClient: osClient, _AutomationTestLogin: true },
-    ignoreHTTPSErrors: true,
-  });
-  const json = await resp.json();
-  if (json.Code !== 1) throw new Error('automationLogin failed: ' + JSON.stringify(json).slice(0, 300));
-  const token = json.Data?.Token || json.Token;
-  const userId = json.Data?.Id || json.Id;
-  await page.goto(frontend, { waitUntil: 'domcontentloaded' });
-  await page.evaluate(({ t, u, oc, account }) => {
-    localStorage.setItem('Token', t);
-    localStorage.setItem('CurrentUser', JSON.stringify({ Id: u, Account: account }));
-    localStorage.setItem('OsClient', oc);
-  }, { t: token, u: userId, oc: osClient, account });
-  return { token, userId };
-}
-```
-
-### 选型口诀
-
-- 容器、CI、本机接口自动化都使用 **`_AutomationTestLogin=true` + 真实密码**，直接 request 拿 Token。
-- 需要验证真实 UI 登录时，用同一真实账号密码填写页面；目标租户仍由 `sys_config.AutoTestSkipCaptcha` 决定是否允许自动化跳过验证码。
-- 失败时再退回 UI 兜底并保留原始错误；禁止新增 `DevLoginBypass`、Dev Key 或 `_DEV_BYPASS_`。
+## 全自动登录（免验证码，但不免密码）——必读
+
+E2E 自动化最容易卡在「登录页有图形验证码」。Microi 后端允许自动化跳过验证码，但账号和密码必须始终走真实校验；如果密码配置错了，登录接口必须返回账号或密码错误。源码见 `Microi.Server/Microi.net.Api/Controllers/SysUserController.cs`（`Login` 方法开头）。
+
+### 方式 A：自动化登录参数（远端/本地通用）
+
+- 触发条件：请求体传 `_AutomationTestLogin=true` 或 `_SkipCaptchaForAutomation=true`，且当前租户 `sys_config.AutoTestSkipCaptcha=true`（中文 Label：允许自动化测试登录时绕开验证码；字段缺失时按默认开启兼容旧库）。
+- 效果：只跳过图形验证码，仍校验 `Account` / `Pwd`。
+- 适用：MCP 连接远端租户、CI、Playwright 截图验收、接口自动化登录。
+- 风险控制：如果远端环境不希望自动化免验证码，请在系统设置关闭【允许自动化测试登录时绕开验证码】。
+
+Playwright 登录助手（直接拿 Token，不走登录页）：
+
+```js
+// helpers/microi-login.js
+export async function automationLogin(page, {
+  backend = process.env.BACKEND || 'https://localhost:61501',
+  osClient = process.env.MICROI_OSCLIENT || 'iTdos',
+  account = process.env.PW_TEST_ACCOUNT || 'admin',
+  password = process.env.PW_TEST_PASSWORD || '',
+  frontend = process.env.FRONTEND || 'http://localhost:61500',
+} = {}) {
+  const resp = await page.request.post(`${backend}/api/SysUser/Login`, {
+    headers: { OsClient: osClient },
+    data: { Account: account, Pwd: password, OsClient: osClient, _AutomationTestLogin: true },
+    ignoreHTTPSErrors: true,
+  });
+  const json = await resp.json();
+  if (json.Code !== 1) throw new Error('automationLogin failed: ' + JSON.stringify(json).slice(0, 300));
+  const token = json.Data?.Token || json.Token;
+  const userId = json.Data?.Id || json.Id;
+  await page.goto(frontend, { waitUntil: 'domcontentloaded' });
+  await page.evaluate(({ t, u, oc, account }) => {
+    localStorage.setItem('Token', t);
+    localStorage.setItem('CurrentUser', JSON.stringify({ Id: u, Account: account }));
+    localStorage.setItem('OsClient', oc);
+  }, { t: token, u: userId, oc: osClient, account });
+  return { token, userId };
+}
+```
+
+### 选型口诀
+
+- 容器、CI、本机接口自动化都使用 **`_AutomationTestLogin=true` + 真实密码**，直接 request 拿 Token。
+- 需要验证真实 UI 登录时，用同一真实账号密码填写页面；目标租户仍由 `sys_config.AutoTestSkipCaptcha` 决定是否允许自动化跳过验证码。
+- 失败时再退回 UI 兜底并保留原始错误；禁止新增 `DevLoginBypass`、Dev Key 或 `_DEV_BYPASS_`。
 - Token 可能在响应体 `Data.Token`，也可能在响应头 `Authorization`，两处都要兜底取。
 - 不要把 Token 明文写进最终报告/附件。
 
@@ -56,14 +56,14 @@ export async function automationLogin(page, {
 
 > 实测：**仅把 Token 写进 localStorage 并不能通过前端路由守卫**——页面会反复跳回 `/login`，且动态菜单路由（如 `/order`）在登录态建立前会报 `No match found`。Dev Key 头旁路（方式 A）只对 `page.request` 直连接口有效（见 `blueprint-e2e.spec.mjs`），SPA 仍需要一次真实 UI 登录会话。
 >
-> 在浏览器内做 E2E（点页面、拖拽、截图）时最稳的登录顺序：
-> 1. 跳到 `#/login`；
-> 2. 填从受保护测试进程变量或用户本轮提供的真实账号密码；
-> 3. 目标租户开启 `AutoTestSkipCaptcha` 时传自动化标记跳过验证码，否则按真实页面流程填写验证码；
-> 4. 点「登 录」，落到首页；
-> 5. 再 `location.hash = '#/<目标路由>'` 进入目标页。
+> 在浏览器内做 E2E（点页面、拖拽、截图）时最稳的登录顺序：
+> 1. 跳到 `#/login`；
+> 2. 填从受保护测试进程变量或用户本轮提供的真实账号密码；
+> 3. 目标租户开启 `AutoTestSkipCaptcha` 时传自动化标记跳过验证码，否则按真实页面流程填写验证码；
+> 4. 点「登 录」，落到首页；
+> 5. 再 `location.hash = '#/<目标路由>'` 进入目标页。
 >
-> 直连接口验收（不进页面）使用自动化标记拿 Token；历史 `_DEV_BYPASS_`、Dev Key 和 `DevLoginBypass` 均不得继续使用。
+> 直连接口验收（不进页面）使用自动化标记拿 Token；历史 `_DEV_BYPASS_`、Dev Key 和 `DevLoginBypass` 均不得继续使用。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-009 sha256=f864be2aee2ce2490d2a8e241e5852fbd0777590f771397fd3c7973017889ae7 -->
@@ -82,33 +82,33 @@ Pop-Location
 该入口会执行 `scripts/run-form-engine-freeze-trace.mjs`，完整流程如下：
 
 1. 自动配置 `Microi.Server/Microi.net.Api/Properties/launchSettings.json` 中指定 profile 的 `ASPNETCORE_ENVIRONMENT` 和 `DOTNET_ENVIRONMENT`。
-2. 从 `PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD` 读取真实测试凭据；脚本不得修改后端 `appsettings.*.json`。
-3. 本地后端未启动时，自动进入 `Microi.Server/Microi.net.Api` 后执行 `dotnet run --launch-profile Microi.net.Api`。
+2. 从 `PW_TEST_ACCOUNT` / `PW_TEST_PASSWORD` 读取真实测试凭据；脚本不得修改后端 `appsettings.*.json`。
+3. 本地后端未启动时，自动进入 `Microi.Server/Microi.net.Api` 后执行 `dotnet run --launch-profile Microi.net.Api`。
 4. 启动 Playwright，打开指定前端页面，开启 `MicroiFormTrace`，采集 `window.__MICROI_FORM_TRACE__`、console、pageerror、当前 URL 和 Playwright trace。
 5. 页面卡住或断言失败时，先看最后一批 `[MicroiFormTrace #n]`，定位是停在 `runtime:*`、`diy-select:*`、`inform-v8-*`、`field-v8-*` 还是业务 console。
 
 常用环境变量：
 
 ```powershell
-$env:FRONTEND='http://localhost:61500'
-$env:BACKEND='https://localhost:61501'
+$env:FRONTEND='http://localhost:61500'
+$env:BACKEND='https://localhost:61501'
 $env:PW_BACKEND_ENV='iTdos'
 $env:PW_ASPNETCORE_ENVIRONMENT='iTdos'
-$env:PW_DOTNET_ENVIRONMENT='iTdos'
-$env:PW_APPSETTINGS_ENV='iTdos'
-$env:MICROI_OSCLIENT='iTdos'
-$env:PW_TEST_ACCOUNT='<从本地配置读取或手工覆盖>'
-$env:PW_TEST_PASSWORD='<从本地配置读取或手工覆盖>'
-$env:MICROI_FREEZE_PATH='/#/diy/diy-design/<TableId>?PageType='
-npm run test:form-freeze:auto
-```
+$env:PW_DOTNET_ENVIRONMENT='iTdos'
+$env:PW_APPSETTINGS_ENV='iTdos'
+$env:MICROI_OSCLIENT='iTdos'
+$env:PW_TEST_ACCOUNT='<从本地配置读取或手工覆盖>'
+$env:PW_TEST_PASSWORD='<从本地配置读取或手工覆盖>'
+$env:MICROI_FREEZE_PATH='/#/diy/diy-design/<TableId>?PageType='
+npm run test:form-freeze:auto
+```
 
 可选开关：
 
 - `PW_START_BACKEND=0`：不自动启动后端，只跑测试。
 - `PW_CONFIG_BACKEND=0`：不修改 `launchSettings.json`。
-- `PW_BACKEND_PROFILE=Microi.net.Api`：指定 launch profile。
-- `PW_TEST_ACCOUNT`、`PW_TEST_PASSWORD`：仅注入当前自动化进程，必须使用真实账号密码且不得写回文件。
+- `PW_BACKEND_PROFILE=Microi.net.Api`：指定 launch profile。
+- `PW_TEST_ACCOUNT`、`PW_TEST_PASSWORD`：仅注入当前自动化进程，必须使用真实账号密码且不得写回文件。
 - `PW_HEADED=0`：无头运行。
 
 诊断代码要遵守这些规则：
@@ -152,7 +152,7 @@ uni-app H5、移动商城、分享海报、首页改版这类任务不能只跑
 
 ```powershell
 Set-Location '<uniapp-project-root>'      # 替换为项目实际路径
-$env:PW_API_BASE='https://localhost:61501' # 替换为项目后端地址
+$env:PW_API_BASE='https://localhost:61501' # 替换为项目后端地址
 $env:PW_API_ENV='development'
 $env:PW_PORT='5192'                       # 替换为项目实际端口
 npm run build:h5:local

package/skills/playwright-e2e/references/progressive-02-/346/226/207/345/255/227/345/257/271/346/257/224/345/272/246/344/270/216/345/217/257/350/257/273/346/200/247/350/207/252/345/212/250/345/214/226/346/243/200/346/237/245-/345/277/205/345/201/232.md

@@ -73,69 +73,69 @@ expect(lowContrast, '低对比度文字: ' + JSON.stringify(lowContrast.slice(0,
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-014 sha256=e5858cce6f743573d699ed7d2d07f958d15be96c28028a91163e841f6d3c016a -->
-## 安装
-
-```bash
-npm i -D @playwright/test
-npx playwright install chromium
-```
-
-### 浏览器选择强制顺序
-
-做本地页面级 Playwright 验收时，不能因为 Playwright 官方 Chromium 缓存缺失或下载超时就结束任务。必须按下面顺序自动兜底：
-
-1. 优先读取 `PW_CHROMIUM_EXECUTABLE` / `PW_BROWSER_EXECUTABLE`。
-2. Windows 优先探测本机 Edge / Chrome：`C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe`、`C:/Program Files/Microsoft/Edge/Application/msedge.exe`、`C:/Users/Administrator/AppData/Local/Google/Chrome/Bin/chrome.exe`、`C:/Program Files/Google/Chrome/Application/chrome.exe`、`C:/Program Files (x86)/Google/Chrome/Application/chrome.exe`。
-3. 再探测工作区本地缓存：`.cache/chromium/**/chrome.exe`、`.tmp/playwright-browsers/**/chrome.exe`。
-4. 仍没有浏览器时，才从吾码 CDN 下载到 `.tmp/playwright-browsers/`，并设置 `PW_CHROMIUM_EXECUTABLE`。
-5. 只有系统浏览器、本地缓存和 CDN 下载全部失败时，才允许报告“浏览器不可用”；报告中必须说明已经尝试过哪些路径。
-
-手写一次性脚本必须把浏览器探测逻辑写在 `.tmp/*.mjs` 中，截图和报告也必须输出到 `.tmp/screenshots/` 或 `.tmp/reports/`，不要写到 `Microi.Client/`、`Microi.Server/` 等子项目目录。
-
-国内或内网环境如果下载浏览器困难，可以使用本机 Edge：
-
-```bash
-$env:PW_BROWSER_CHANNEL='msedge'
-npx playwright test
-```
-
-如果本机没有可用 Edge，或必须使用 Chromium，优先从吾码 CDN 下载浏览器压缩包，不要反复卡在 Playwright 官方下载通道：
-
-| 系统 | CDN 地址 |
-|------|----------|
-| Windows x64 | `https://static.itdos.com/openclaw/chromium/chrome-win64-137.0.7151.68.zip` |
-| macOS x64 | `https://static.itdos.com/openclaw/chromium/chrome-mac-x64-137.0.7151.68.zip` |
-| macOS arm64 | `https://static.itdos.com/openclaw/chromium/chrome-mac-arm64-137.0.7151.68.zip` |
-
-Windows 示例：
-
-```powershell
-$browserRoot = Join-Path (Resolve-Path '.tmp').Path 'playwright-browsers'
-New-Item -ItemType Directory -Force -Path $browserRoot | Out-Null
-$zipPath = Join-Path $browserRoot 'chrome-win64-137.0.7151.68.zip'
-Invoke-WebRequest 'https://static.itdos.com/openclaw/chromium/chrome-win64-137.0.7151.68.zip' -OutFile $zipPath
-Expand-Archive $zipPath -DestinationPath $browserRoot -Force
-$env:PW_CHROMIUM_EXECUTABLE = (Resolve-Path (Join-Path $browserRoot 'chrome-win64/chrome.exe')).Path
-npx playwright test
-```
-
-手写 Playwright 脚本时读取 `PW_CHROMIUM_EXECUTABLE` / `PW_BROWSER_EXECUTABLE` 并传给 `chromium.launch({ executablePath })`；Playwright Test 配置中通过 `use.launchOptions.executablePath` 读取该环境变量。只有 CDN、系统浏览器和本地缓存都不可用时，才报告浏览器不可用。
-
+## 安装
+
+```bash
+npm i -D @playwright/test
+npx playwright install chromium
+```
+
+### 浏览器选择强制顺序
+
+做本地页面级 Playwright 验收时，不能因为 Playwright 官方 Chromium 缓存缺失或下载超时就结束任务。必须按下面顺序自动兜底：
+
+1. 优先读取 `PW_CHROMIUM_EXECUTABLE` / `PW_BROWSER_EXECUTABLE`。
+2. Windows 优先探测本机 Edge / Chrome：`C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe`、`C:/Program Files/Microsoft/Edge/Application/msedge.exe`、`C:/Users/Administrator/AppData/Local/Google/Chrome/Bin/chrome.exe`、`C:/Program Files/Google/Chrome/Application/chrome.exe`、`C:/Program Files (x86)/Google/Chrome/Application/chrome.exe`。
+3. 再探测工作区本地缓存：`.cache/chromium/**/chrome.exe`、`.tmp/playwright-browsers/**/chrome.exe`。
+4. 仍没有浏览器时，才从吾码 CDN 下载到 `.tmp/playwright-browsers/`，并设置 `PW_CHROMIUM_EXECUTABLE`。
+5. 只有系统浏览器、本地缓存和 CDN 下载全部失败时，才允许报告“浏览器不可用”；报告中必须说明已经尝试过哪些路径。
+
+手写一次性脚本必须把浏览器探测逻辑写在 `.tmp/*.mjs` 中，截图和报告也必须输出到 `.tmp/screenshots/` 或 `.tmp/reports/`，不要写到 `Microi.Client/`、`Microi.Server/` 等子项目目录。
+
+国内或内网环境如果下载浏览器困难，可以使用本机 Edge：
+
+```bash
+$env:PW_BROWSER_CHANNEL='msedge'
+npx playwright test
+```
+
+如果本机没有可用 Edge，或必须使用 Chromium，优先从吾码 CDN 下载浏览器压缩包，不要反复卡在 Playwright 官方下载通道：
+
+| 系统 | CDN 地址 |
+|------|----------|
+| Windows x64 | `https://static.itdos.com/openclaw/chromium/chrome-win64-137.0.7151.68.zip` |
+| macOS x64 | `https://static.itdos.com/openclaw/chromium/chrome-mac-x64-137.0.7151.68.zip` |
+| macOS arm64 | `https://static.itdos.com/openclaw/chromium/chrome-mac-arm64-137.0.7151.68.zip` |
+
+Windows 示例：
+
+```powershell
+$browserRoot = Join-Path (Resolve-Path '.tmp').Path 'playwright-browsers'
+New-Item -ItemType Directory -Force -Path $browserRoot | Out-Null
+$zipPath = Join-Path $browserRoot 'chrome-win64-137.0.7151.68.zip'
+Invoke-WebRequest 'https://static.itdos.com/openclaw/chromium/chrome-win64-137.0.7151.68.zip' -OutFile $zipPath
+Expand-Archive $zipPath -DestinationPath $browserRoot -Force
+$env:PW_CHROMIUM_EXECUTABLE = (Resolve-Path (Join-Path $browserRoot 'chrome-win64/chrome.exe')).Path
+npx playwright test
+```
+
+手写 Playwright 脚本时读取 `PW_CHROMIUM_EXECUTABLE` / `PW_BROWSER_EXECUTABLE` 并传给 `chromium.launch({ executablePath })`；Playwright Test 配置中通过 `use.launchOptions.executablePath` 读取该环境变量。只有 CDN、系统浏览器和本地缓存都不可用时，才报告浏览器不可用。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-015 sha256=b9adf7af700e045fd919bdfde321b10df89660561dd8ab476a12cba310855875 -->
-## playwright.config.js 模板
-
-```js
-import { defineConfig, devices } from '@playwright/test';
+## playwright.config.js 模板
+
+```js
+import { defineConfig, devices } from '@playwright/test';
 
 const port = process.env.PW_PORT || '5180';
-const baseURL = process.env.PW_BASE_URL || `http://127.0.0.1:${port}`;
-const webServerUrl = process.env.PW_WEB_SERVER_URL || baseURL;
-const channel = process.env.PW_BROWSER_CHANNEL || undefined;
-const executablePath = process.env.PW_CHROMIUM_EXECUTABLE || process.env.PW_BROWSER_EXECUTABLE || undefined;
-const defaultCommand = process.env.PW_APP_TYPE === 'uniapp-h5'
-  ? `npm run dev:h5 -- --host 0.0.0.0 --port ${port}`
-  : `npm run dev -- --host 0.0.0.0 --port ${port}`;
+const baseURL = process.env.PW_BASE_URL || `http://127.0.0.1:${port}`;
+const webServerUrl = process.env.PW_WEB_SERVER_URL || baseURL;
+const channel = process.env.PW_BROWSER_CHANNEL || undefined;
+const executablePath = process.env.PW_CHROMIUM_EXECUTABLE || process.env.PW_BROWSER_EXECUTABLE || undefined;
+const defaultCommand = process.env.PW_APP_TYPE === 'uniapp-h5'
+  ? `npm run dev:h5 -- --host 0.0.0.0 --port ${port}`
+  : `npm run dev -- --host 0.0.0.0 --port ${port}`;
 
 export default defineConfig({
   testDir: './tests/e2e',
@@ -145,11 +145,11 @@ export default defineConfig({
   retries: process.env.CI ? 2 : 0,
   workers: process.env.CI ? 1 : undefined,
   reporter: [['list'], ['html', { open: 'never', outputFolder: 'tests/e2e/report' }]],
-  use: {
-    baseURL,
-    ...(executablePath ? { launchOptions: { executablePath } } : {}),
-    trace: 'retain-on-failure',
-    screenshot: 'only-on-failure',
+  use: {
+    baseURL,
+    ...(executablePath ? { launchOptions: { executablePath } } : {}),
+    trace: 'retain-on-failure',
+    screenshot: 'only-on-failure',
     video: 'retain-on-failure',
     extraHTTPHeaders: {
       OsClient: process.env.PW_OS_CLIENT || 'demo'

package/skills/playwright-e2e/references/progressive-03-microi-helper-/346/250/241/346/235/277.md

@@ -15,22 +15,22 @@ export const microiEnv = {
   loginEngine: process.env.PW_LOGIN_ENGINE || 'member_login'
 };
 
-// 仅用于需要在 URL 中显式携带租户的普通 GET；POST 不调用此函数。
-export function withOsClientQuery(url) {
-  const sep = url.includes('?') ? '&' : '?';
-  return `${url}${sep}OsClient=${encodeURIComponent(microiEnv.osClient)}`;
-}
-
-export async function callEngine(request, apiEngineKey, data = {}, token = '') {
-  const res = await request.post(`${microiEnv.apiBase}/apiengine/${apiEngineKey}`, {
-    headers: {
-      'Content-Type': 'application/json',
-      apiengine: '1',
-      osclient: microiEnv.osClient,
-      ...(token ? { Token: token } : {})
-    },
-    data: { ...data, OsClient: data.OsClient || microiEnv.osClient }
-  });
+// 仅用于需要在 URL 中显式携带租户的普通 GET；POST 不调用此函数。
+export function withOsClientQuery(url) {
+  const sep = url.includes('?') ? '&' : '?';
+  return `${url}${sep}OsClient=${encodeURIComponent(microiEnv.osClient)}`;
+}
+
+export async function callEngine(request, apiEngineKey, data = {}, token = '') {
+  const res = await request.post(`${microiEnv.apiBase}/apiengine/${apiEngineKey}`, {
+    headers: {
+      'Content-Type': 'application/json',
+      apiengine: '1',
+      osclient: microiEnv.osClient,
+      ...(token ? { Token: token } : {})
+    },
+    data: { ...data, OsClient: data.OsClient || microiEnv.osClient }
+  });
   expect(res.ok(), `${apiEngineKey} HTTP status`).toBeTruthy();
   const json = await res.json();
   return json;
@@ -156,7 +156,7 @@ tests/e2e/
 3. 写操作必须做“前置清理 → 执行动作 → 后端查询确认 → 用例清理”。
 4. UI 点击不能只断言 toast；必须用 `page.waitForResponse()` 捕捉对应接口，并验证响应体。
 5. 任何 FormEngine HTTP 路由必须使用 `/api/formengine/{action}-{table}`，不要生成 `/formengine/{table}/{action}`。
-6. ApiEngine 使用稳定路径 `/apiengine/{ApiEngineKey}`，并通过唯一的 `osclient` Header 传租户；JSON/Form Body 可冗余携带 `OsClient`。普通 POST/PUT/PATCH/DELETE 禁止追加 `--OsClient--...--`。仅第三方回调或无法设置 Header/Form/Query 的 GET/HEAD 才允许特殊路径。
+6. ApiEngine 使用稳定路径 `/apiengine/{ApiEngineKey}`，并通过唯一的 `osclient` Header 传租户；JSON/Form Body 可冗余携带 `OsClient`。普通 POST/PUT/PATCH/DELETE 禁止追加 `--OsClient--...--`。仅第三方回调或无法设置 Header/Form/Query 的 GET/HEAD 才允许特殊路径。
 7. 页面级测试必须把 `请求失败`、`网络错误`、`null`、`待开发`、`开发中` 当成失败信号；这些文案如果出现在页面或 toast 中，说明功能未交付或接口契约错误。
 8. 新增、保存、结算、转赠、确认、上传等按钮不能只弹“成功/待开发”toast；必须调用真实业务接口，并通过后端查询验证状态变化。
 9. 源码守卫可作为兜底：递归扫描 `src/**/*.vue`、`src/**/*.js`，禁止残留 `待开发|开发中` 占位文案。
@@ -164,8 +164,8 @@ tests/e2e/
 11. 每个移动端项目都要有“接口清单驱动”的契约测试：静态扫描或维护清单覆盖所有 `callEngine('xxx')`，逐个 HTTP 调用并断言不是 404、不是空响应、不是字符串 `null`，且必须是标准 DosResult。
 12. 写业务闭环时必须准备可重复测试数据并清理：例如抢购要“创建测试挂单 → 调用抢购 → 验证订单 → 删除测试订单/挂单/提货卡”，购物车要“加入购物车 → 结算 → 验证订单/购物车状态 → 删除测试订单”。
 13. 图片断言必须检查真实渲染，而不是只检查元素可见。uni-app H5 的 `<image>` 会渲染成 `UNI-IMAGE`，真实图片在内部 `div.style.backgroundImage` 或子 `img` 上；不要把宿主元素的 CSS 渐变背景算作加载成功。
-14. 网络守卫要记录 `requestfailed`，特别是图片资源的 `net::ERR_BLOCKED_BY_ORB` / CORS / 404；首页 banner、商品主图、头像等公开图片必须实际加载。
-15. 页面出现浏览器原生 `alert`、`confirm` 或 `prompt` 直接判失败；测试应监听 `page.on('dialog')` 记录类型和文案后关闭对话框，再要求业务改用吾码 Tips、Element Plus 或品牌化可访问弹层。长弹窗需分别滚动到顶部、中部、底部触发反馈，并断言提示/确认层的 bounding box 中心接近当前 viewport 中心且未被遮挡。
+14. 网络守卫要记录 `requestfailed`，特别是图片资源的 `net::ERR_BLOCKED_BY_ORB` / CORS / 404；首页 banner、商品主图、头像等公开图片必须实际加载。
+15. 页面出现浏览器原生 `alert`、`confirm` 或 `prompt` 直接判失败；测试应监听 `page.on('dialog')` 记录类型和文案后关闭对话框，再要求业务改用吾码 Tips、Element Plus 或品牌化可访问弹层。长弹窗需分别滚动到顶部、中部、底部触发反馈，并断言提示/确认层的 bounding box 中心接近当前 viewport 中心且未被遮挡。
 
 移动商城/会员 H5 额外规则：
 
@@ -190,7 +190,7 @@ tests/e2e/
 - `microi_get_playwright_context`：获取可测菜单 URL、接口引擎、匿名配置。
 - `microi_plan_playwright_e2e`：生成推荐的测试文件、环境变量和冒烟路径。
 - `microi_run_engine`：调试单个接口引擎，不替代浏览器 E2E。
-- `microi_set_engine_anonymous`：登录、注册、公开首页接口需要匿名访问时使用；设置后仍要验证 HTTP `/apiengine/{key}` + `osclient` Header 返回标准 DosResult。
+- `microi_set_engine_anonymous`：登录、注册、公开首页接口需要匿名访问时使用；设置后仍要验证 HTTP `/apiengine/{key}` + `osclient` Header 返回标准 DosResult。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-022 sha256=d05000c40920ae53e9ce758385e2b7ad62a79d7d974491e241e6da8d698c9232 -->

package/skills/playwright-e2e/references/progressive-04-ci-/345/273/272/350/256/256.md

@@ -29,7 +29,7 @@ jobs:
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-024 sha256=b939c97eef28fab71caa54d134ea524d7ed7c8381deec09e38a7d694b15f53c0 -->
-## 常见问题
+## 常见问题
 
 | 现象 | 原因 | 处理 |
 |---|---|---|
@@ -41,75 +41,75 @@ jobs:
 | 保存接口代码后 MCP 自己报 `string does not contain DosIsNullOrWhiteSpace` | 后端 C# 在动态对象路径上调用扩展方法 | 改用 `string.IsNullOrWhiteSpace`，不要在 MCP 路径新增 `DosIsNullOrWhiteSpace` 调用 |
 | MCP `run_engine` 里 `V8.Db` 为 null | MCP 执行上下文没有注入直连 Db | 维护/测试引擎优先使用 `V8.FormEngine.GetTableData/UptFormData` |
 | H5 静态资源 404 | `vite.config.js` 未配置相对路径 | uni-app H5 设置 `base: './'` |
-| 本地浏览器下载失败 | Playwright 下载 Chromium 受阻 | 先用 `PW_BROWSER_CHANNEL=msedge`，没有 Edge 时从吾码 CDN 下载 Chromium 并设置 `PW_CHROMIUM_EXECUTABLE` |
-| 用例偶发失败 | HMR 或网络请求未稳定 | CI 使用静态构建，断言明确等待关键元素 |
-| 页面有横向滚动 | 组件撑出视口 | 对根容器和列表容器加 `max-width:100vw; overflow-x:hidden` |
-
-### 多服务器、多租户并行上下文模板
-
-`incognito` 的本质是独立存储上下文。Playwright 的 `browser.newContext()` 每次都会创建隔离上下文，
-比在同一个浏览器 context 中开多个 Page 更可靠：
-
-```js
-function buildLocalMicroiUrl({ apiBase, osClient, route = '/' }) {
-  return `http://localhost:61500/?OsClient=${encodeURIComponent(osClient)}`
-    + `&ApiBase=${encodeURIComponent(apiBase)}#${route}`;
-}
-
-const targetA = await browser.newContext();
-const pageA = await targetA.newPage();
-await pageA.goto(buildLocalMicroiUrl({ apiBase: apiA, osClient: tenantA, route: '/home' }));
-await pageA.waitForFunction(() => Boolean(window.__MICROI_RUNTIME_ENDPOINT__));
-await expect.poll(() => pageA.evaluate(() => window.__MICROI_RUNTIME_ENDPOINT__)).toMatchObject({
-  apiBase: apiA,
-  osClient: tenantA,
-  requiresIsolatedContextForParallelTenants: true
-});
-
-const targetB = await browser.newContext();
-// targetB 重复同样流程；禁止复用 targetA.newPage() 测 tenantB。
-```
-
-若给定的是线上吾码页面，先在第三个一次性 context 中读取
-`window.__MICROI_RUNTIME_ENDPOINT__`。旧版回退脚本只读取公开运行目标，不读取或输出 Token：
-
-```js
-const endpoint = await page.evaluate(() => {
-  const current = window.__MICROI_RUNTIME_ENDPOINT__;
-  if (current?.apiBase && current?.osClient) return current;
-  const stored = JSON.parse(localStorage.getItem('microi.net') || '{}');
-  return {
-    apiBase: window.ApiBase || stored.ApiBase || location.origin,
-    osClient: new URLSearchParams(location.search).get('OsClient') || window.OsClient || stored.OsClient || ''
-  };
-});
-```
-
-OsClient 仍为空时调用目标站点域名租户解析接口或从成功请求确认。手工 Chrome 的第二个不同租户
-至少使用无痕窗口，但同一 Chrome 无痕会话的多个窗口可能继续共享存储；三个以上目标使用独立
-Profile 或独立 `--user-data-dir`。
-
-<!-- /microi-progressive:chunk -->
+| 本地浏览器下载失败 | Playwright 下载 Chromium 受阻 | 先用 `PW_BROWSER_CHANNEL=msedge`，没有 Edge 时从吾码 CDN 下载 Chromium 并设置 `PW_CHROMIUM_EXECUTABLE` |
+| 用例偶发失败 | HMR 或网络请求未稳定 | CI 使用静态构建，断言明确等待关键元素 |
+| 页面有横向滚动 | 组件撑出视口 | 对根容器和列表容器加 `max-width:100vw; overflow-x:hidden` |
+
+### 多服务器、多租户并行上下文模板
+
+`incognito` 的本质是独立存储上下文。Playwright 的 `browser.newContext()` 每次都会创建隔离上下文，
+比在同一个浏览器 context 中开多个 Page 更可靠：
+
+```js
+function buildLocalMicroiUrl({ apiBase, osClient, route = '/' }) {
+  return `http://localhost:61500/?OsClient=${encodeURIComponent(osClient)}`
+    + `&ApiBase=${encodeURIComponent(apiBase)}#${route}`;
+}
+
+const targetA = await browser.newContext();
+const pageA = await targetA.newPage();
+await pageA.goto(buildLocalMicroiUrl({ apiBase: apiA, osClient: tenantA, route: '/home' }));
+await pageA.waitForFunction(() => Boolean(window.__MICROI_RUNTIME_ENDPOINT__));
+await expect.poll(() => pageA.evaluate(() => window.__MICROI_RUNTIME_ENDPOINT__)).toMatchObject({
+  apiBase: apiA,
+  osClient: tenantA,
+  requiresIsolatedContextForParallelTenants: true
+});
+
+const targetB = await browser.newContext();
+// targetB 重复同样流程；禁止复用 targetA.newPage() 测 tenantB。
+```
+
+若给定的是线上吾码页面，先在第三个一次性 context 中读取
+`window.__MICROI_RUNTIME_ENDPOINT__`。旧版回退脚本只读取公开运行目标，不读取或输出 Token：
+
+```js
+const endpoint = await page.evaluate(() => {
+  const current = window.__MICROI_RUNTIME_ENDPOINT__;
+  if (current?.apiBase && current?.osClient) return current;
+  const stored = JSON.parse(localStorage.getItem('microi.net') || '{}');
+  return {
+    apiBase: window.ApiBase || stored.ApiBase || location.origin,
+    osClient: new URLSearchParams(location.search).get('OsClient') || window.OsClient || stored.OsClient || ''
+  };
+});
+```
+
+OsClient 仍为空时调用目标站点域名租户解析接口或从成功请求确认。手工 Chrome 的第二个不同租户
+至少使用无痕窗口，但同一 Chrome 无痕会话的多个窗口可能继续共享存储；三个以上目标使用独立
+Profile 或独立 `--user-data-dir`。
+
+<!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-025 sha256=be071153d695081b7c20d34cb5e9563480e3f09d9cd0292f2ca4b0245438787b -->
-## 前端微服务 E2E 必测点
-
-测试 Vue3 MicroApp 微服务时，不能只验证 `/micro-app/{OsClient}/{appKey}/index.html` 或带 token 的临时 URL。必须先建立真实登录态，再访问用户实际使用的不带 token 菜单路由，例如 `/#/micro-app/{MsKey}/{RoutePath}`，并确认地址栏没有退回旧的 `micro-app-host` 长地址。
-
-同一套微服务绑定多个菜单时，至少选择 3 个真实菜单往返切换 8 轮，逐轮断言主框架 route、当前菜单和子应用可见内容匹配，且没有 `element head is missing`、`Failed to fetch`、`ERR_TOO_MANY_REDIRECTS`、`app name conflict`、永久骨架屏或空白内容。不能只断言 `<micro-app>` 元素存在。
-
-页签缓存验收必须覆盖单一所有者与清理边界：在一个缓存范围内修改表单输入、筛选、内部路由或滚动位置，切走再返回后状态应保持；连续打开 6 个菜单微服务实例，断言运行时最多保留 5 个，最久未使用的隐藏实例重入时正常冷启动；关闭当前/其它/全部 Tab 后对应实例消失，退出登录后全部实例清空。恢复页还要断言收到最新 Token/OsClient/权限/主题/视口上下文，且任一时刻只有一个可见活动微服务。若子应用有轮询或 WebSocket，记录 `appstate-change`，确认 `afterhidden` 暂停、`aftershow` 幂等恢复而没有重复连接。
-
-如果页面内提供 Microi SDK 调用按钮，必须点击并断言返回 `Code=1`，同时确认没有 `登录身份已过期`、`1001`、`1002`。只看到标题文本不代表鉴权链路通过。
-
+## 前端微服务 E2E 必测点
+
+测试 Vue3 MicroApp 微服务时，不能只验证 `/micro-app/{OsClient}/{appKey}/index.html` 或带 token 的临时 URL。必须先建立真实登录态，再访问用户实际使用的不带 token 菜单路由，例如 `/#/micro-app/{MsKey}/{RoutePath}`，并确认地址栏没有退回旧的 `micro-app-host` 长地址。
+
+同一套微服务绑定多个菜单时，至少选择 3 个真实菜单往返切换 8 轮，逐轮断言主框架 route、当前菜单和子应用可见内容匹配，且没有 `element head is missing`、`Failed to fetch`、`ERR_TOO_MANY_REDIRECTS`、`app name conflict`、永久骨架屏或空白内容。不能只断言 `<micro-app>` 元素存在。
+
+页签缓存验收必须覆盖单一所有者与清理边界：在一个缓存范围内修改表单输入、筛选、内部路由或滚动位置，切走再返回后状态应保持；连续打开 6 个菜单微服务实例，断言运行时最多保留 5 个，最久未使用的隐藏实例重入时正常冷启动；关闭当前/其它/全部 Tab 后对应实例消失，退出登录后全部实例清空。恢复页还要断言收到最新 Token/OsClient/权限/主题/视口上下文，且任一时刻只有一个可见活动微服务。若子应用有轮询或 WebSocket，记录 `appstate-change`，确认 `afterhidden` 暂停、`aftershow` 幂等恢复而没有重复连接。
+
+如果页面内提供 Microi SDK 调用按钮，必须点击并断言返回 `Code=1`，同时确认没有 `登录身份已过期`、`1001`、`1002`。只看到标题文本不代表鉴权链路通过。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=playwright-e2e-026 sha256=3c8a1e8bbe281064f30f406703230d8df213f1f1e1d124edb8f9fc8a1df782ea -->
-## 动态模块按钮验收
-
-修复或新增 `MoreBtns/FormBtns/PageBtns/PageTabs` 时，运行页看到按钮只证明“最终渲染结果”，不能证明入口确实可由模块引擎维护。至少同时保留三类证据：
-
-1. 后端/MCP 回读目标 `sys_menu`，断言对应按钮稳定 `Id`、`Name`、位置字段、`V8CodeShow` 和 `V8Code` 均已保存，并且未覆盖其它客户按钮。
-2. 使用真实管理员登录模块引擎设计器，打开目标模块，断言相应按钮编辑区能看到该按钮及代码。
-3. 分别在实际列表/卡片或 PC/移动端运行态检查按钮显隐并点击到目标交互；源码回归还要确认通用模板和宽度计算中不存在按模块 Id、Url、表名写死的同名入口。
-
-按钮通过 `V8.OpenDialog` 打开主前端定制组件时，还要断言组件已在全局注册、`ComponentName` 与注册名一致、`DataAppend` 能到达组件，并确认源码没有新增 `V8.Open<业务名>` 专用包装。按钮通过 `V8.OpenAppDialog` 打开微服务时，按 AppKey、RoutePath 和发布版本回读并验收。涉及新旧版本滚动发布时分别说明组件/应用资源尚未就绪和已就绪的预期，不得只在单一版本页面上验收。
+## 动态模块按钮验收
+
+修复或新增 `MoreBtns/FormBtns/PageBtns/PageTabs` 时，运行页看到按钮只证明“最终渲染结果”，不能证明入口确实可由模块引擎维护。至少同时保留三类证据：
+
+1. 后端/MCP 回读目标 `sys_menu`，断言对应按钮稳定 `Id`、`Name`、位置字段、`V8CodeShow` 和 `V8Code` 均已保存，并且未覆盖其它客户按钮。
+2. 使用真实管理员登录模块引擎设计器，打开目标模块，断言相应按钮编辑区能看到该按钮及代码。
+3. 分别在实际列表/卡片或 PC/移动端运行态检查按钮显隐并点击到目标交互；源码回归还要确认通用模板和宽度计算中不存在按模块 Id、Url、表名写死的同名入口。
+
+按钮通过 `V8.OpenDialog` 打开主前端定制组件时，还要断言组件已在全局注册、`ComponentName` 与注册名一致、`DataAppend` 能到达组件，并确认源码没有新增 `V8.Open<业务名>` 专用包装。按钮通过 `V8.OpenAppDialog` 打开微服务时，按 AppKey、RoutePath 和发布版本回读并验收。涉及新旧版本滚动发布时分别说明组件/应用资源尚未就绪和已就绪的预期，不得只在单一版本页面上验收。
 <!-- /microi-progressive:chunk -->

package/skills/print-engine/SKILL.md

@@ -106,9 +106,17 @@ ZICOX CC4、BLE/SPP 或
 }
 ```
 
-### table — 表格元素
-
-```json
+文本 `text` 与长文本 `longText` 的 `options.formatter` 接收
+`function(title, value, options, templateData)`；文本控件还可能传第五个 `target`。
+第一参数是标题，绑定数据在第二参数。不要直接传入 `function(value)` 编码器，否则会把
+标题当业务值打印。表格单元格的 `formatter2(title, field, row, index, options)` 是另一合同。
+金额应由后端精确计算后作为字符串输出，不能在打印页转换为 `Number` 再求和。
+业务文本经过 formatter 进入 HTML 时必须编码 `& < > " '`，并用含标签的值与大额金额
+调用真实函数签名做回归。模板保存成功只证明存储，仍须用实际数据预览分页、合计与长条款。
+
+### table — 表格元素
+
+```json
 {
   "options": {
     "left": 30, "top": 150, "height": 56, "width": 511.5,