perf(weapp-tailwindcss): 优化多构建器热路径缓存复用

.changeset/e2e-watch-group-entry.md

@@ -0,0 +1,9 @@
+---
+"weapp-tailwindcss": patch
+---
+
+完善 `e2e:watch` 热更新回归流程：
+
+- 新增 `demo` 与 `apps` 分组测试入口，避免分组执行时重复跑单 case 文件
+- 将 `test:watch-hmr` 切换为 `node --import tsx` 启动，修复部分环境下 `tsx` IPC `EPERM` 导致的回归无法启动问题
+- 调整 `apps/taro-webpack-tailwindcss-v4` 的 watch 回归命令，确保 Taro webpack 场景下模板、脚本、样式热更新都能稳定校验

.changeset/honest-hounds-hug.md

@@ -0,0 +1,7 @@
+---
+"weapp-tailwindcss": patch
+---
+
+增强多平台热更新回归覆盖，补齐 `uni-app`、`uni-app-vue3-vite`、`mpx` 的 comment-carrier 场景，并新增汇总断言校验 same-class 稳定性、comment-carrier 命中数量与热更新时间指标。
+
+修复 `uni-app-vue3-vite` 在 comment-carrier 场景下 marker 无法进入运行时输出导致 watch-hmr 卡住的问题，同时将关键 HMR 用例接入 `E2E Watch` 工作流，确保 PR 与夜间任务都能持续校验多平台热更新链路。

.changeset/pre.json

@@ -0,0 +1,79 @@
+{
+  "mode": "pre",
+  "tag": "alpha",
+  "initialVersions": {
+    "react-app": "0.0.0",
+    "rsmax-app-ts": "1.0.0",
+    "tailwindcss-weapp": "0.0.1",
+    "taro-webpack-tailwindcss-v4": "1.0.0",
+    "uni-app-x-hbuilderx-tailwindcss3": "0.0.0",
+    "uni-app-x-hbuilderx-tailwindcss4": "0.0.0",
+    "vite-native": "1.0.19",
+    "vite-native-skyline": "1.0.1",
+    "vite-native-ts": "1.0.12",
+    "vite-native-ts-skyline": "1.0.1",
+    "vue-app": "0.0.0",
+    "weapp-wechat-zhihu": "1.0.0",
+    "@native-app/postcss7-compat": "1.0.1",
+    "benchmark": "0.0.1",
+    "benchmark-tailwindcss3": "0.0.8",
+    "benchmark-tailwindcss4": "0.0.6",
+    "@weapp-tailwindcss-demo/gulp-app": "0.0.5",
+    "@weapp-tailwindcss-demo/mpx-app": "0.1.0",
+    "@weapp-tailwindcss-demo/mpx-tailwindcss-v4": "0.1.0",
+    "@weapp-tailwindcss-demo/native": "1.0.0",
+    "@weapp-tailwindcss-demo/native-mina": "1.0.0",
+    "@weapp-tailwindcss-demo/native-ts": "1.0.0",
+    "@weapp-tailwindcss-demo/rax-app": "0.1.0",
+    "@weapp-tailwindcss-demo/taro-app": "1.0.1",
+    "@weapp-tailwindcss-demo/taro-app-vite": "1.0.0",
+    "@weapp-tailwindcss-demo/taro-vite-tailwindcss-v4": "1.0.0",
+    "@weapp-tailwindcss-demo/taro-vue3-app": "1.0.0",
+    "@weapp-tailwindcss-demo/taro-webpack-tailwindcss-v4": "1.0.0",
+    "@weapp-tailwindcss-demo/uni-app": "0.1.0",
+    "@weapp-tailwindcss-demo/uni-app-tailwindcss-v4": "0.0.0",
+    "@weapp-tailwindcss-demo/uni-app-vue3-vite": "0.0.1",
+    "@weapp-tailwindcss-demo/uni-app-webpack-tailwindcss-v4": "0.1.0",
+    "@weapp-tailwindcss-demo/uni-app-webpack5": "0.1.0",
+    "@weapp-tailwindcss-demo/uni-app-x-hbuilderx-tailwindcss3": "0.0.0",
+    "@weapp-tailwindcss-demo/uni-app-x-hbuilderx-tailwindcss4": "0.0.0",
+    "@weapp-tailwindcss-demo/web": "1.0.0",
+    "@weapp-tailwindcss/e2e": "0.0.0",
+    "@weapp-tailwindcss/cva": "0.1.6",
+    "@weapp-tailwindcss/merge": "2.1.6",
+    "@weapp-tailwindcss/merge-v3": "0.1.6",
+    "@weapp-tailwindcss/runtime": "0.1.5",
+    "tailwind-variant-v3": "0.2.1",
+    "theme-transition": "2.0.1",
+    "@weapp-tailwindcss/typography": "0.2.6",
+    "@weapp-tailwindcss/ui": "0.0.6",
+    "@weapp-tailwindcss/variants": "0.2.1",
+    "@weapp-tailwindcss/variants-v3": "0.1.1",
+    "@weapp-tailwindcss/babel": "0.0.3",
+    "@weapp-tailwindcss/build-all": "0.0.21",
+    "@weapp-tailwindcss/debug-uni-app-x": "0.0.3",
+    "@weapp-tailwindcss/experimental": "0.0.1",
+    "@weapp-tailwindcss/init": "1.0.10",
+    "@weapp-tailwindcss/logger": "1.1.0",
+    "@weapp-tailwindcss/minify-preserve": "0.0.0",
+    "@weapp-tailwindcss/postcss": "2.1.5",
+    "@weapp-tailwindcss/shared": "1.1.2",
+    "tailwindcss-config": "1.1.4",
+    "tailwindcss-core-plugins-extractor": "0.2.0",
+    "tailwindcss-injector": "1.0.10",
+    "@weapp-tailwindcss/test-helper": "0.0.1",
+    "weapp-style-injector": "0.0.1",
+    "weapp-tailwindcss": "4.10.3",
+    "weapp-tw": "0.0.0",
+    "weapptw": "0.0.0",
+    "wetw": "0.1.1",
+    "@weapp-tailwindcss/website": "1.0.17"
+  },
+  "changesets": [
+    "bright-horses-clean",
+    "e2e-watch-group-entry",
+    "honest-hounds-hug",
+    "perf-hot-path-caching",
+    "weapp-tailwindcss-alias"
+  ]
+}

.changeset/tailwindcss-patch-874-alpha.md

@@ -0,0 +1,13 @@
+---
+'weapp-tailwindcss': patch
+'weapp-tw': patch
+'tailwindcss-injector': patch
+'@weapp-tailwindcss/postcss': patch
+'@weapp-tailwindcss/ui': patch
+'@weapp-tailwindcss/shared': patch
+'@weapp-tailwindcss/init': patch
+'@weapp-tailwindcss/typography': patch
+'wetw': patch
+---
+
+升级 `tailwindcss-patch` 到 `8.7.4-alpha.0`，同步消费最新的 alpha 版本依赖。

.changeset/weapp-tailwindcss-alias.md

@@ -0,0 +1,10 @@
+---
+'weapp-tailwindcss': minor
+---
+
+为所有编译插件入口新增 `weappTailwindcss` 别名导出，方便用户统一简写引用：
+
+- `weapp-tailwindcss/webpack` → `UnifiedWebpackPluginV5` 的别名
+- `weapp-tailwindcss/webpack4` → `UnifiedWebpackPluginV4` 的别名
+- `weapp-tailwindcss/vite` → `UnifiedViteWeappTailwindcssPlugin` 的别名
+- `weapp-tailwindcss/gulp` → `createPlugins` 的别名

.claude/skills/playwright-cli/references/test-generation.md

@@ -45,8 +45,8 @@ test('login flow', async ({ page }) => {
   await page.getByRole('textbox', { name: 'Password' }).fill('password123')
   await page.getByRole('button', { name: 'Sign In' }).click()
 
-  // Add assertions
-  await expect(page).toHaveURL(/.*dashboard/)
+  // 验证跳转到 dashboard
+  await expect(page).toHaveURL('https://example.com/dashboard')
 })
 ```
 

.codex/skills/playwright-cli/references/test-generation.md

@@ -45,8 +45,8 @@ test('login flow', async ({ page }) => {
   await page.getByRole('textbox', { name: 'Password' }).fill('password123')
   await page.getByRole('button', { name: 'Sign In' }).click()
 
-  // Add assertions
-  await expect(page).toHaveURL(/.*dashboard/)
+  // 验证跳转到 dashboard
+  await expect(page).toHaveURL('https://example.com/dashboard')
 })
 ```
 

.gitattributes

@@ -14,7 +14,8 @@
 ##   Handle line endings automatically for files detected as
 ##   text and leave all files detected as binary untouched.
 ##   This will handle all files NOT defined below.
-*                 text=auto
+##   强制所有文本文件使用 LF，避免 Windows CI 上 CRLF 导致 prettier 报错
+*                 text=auto eol=lf
 
 # Source code
 *.bash            text eol=lf

.github/scripts/e2e-watch-report.cjs

@@ -6,6 +6,37 @@ const fs = require('node:fs')
 const path = require('node:path')
 const process = require('node:process')
 
+/** 匹配换行符（兼容 CRLF） */
+const CRLF_RE = /\r?\n/
+/** 替换换行为转义表示 */
+const NEWLINE_REPLACE_RE = /\n/g
+/** 匹配 rollback 阶段（不区分大小写） */
+const ROLLBACK_RE = /rollback/i
+/** 按管道符分隔 token */
+const TOKEN_SEPARATOR_RE = /\s+\|\s+/
+/** 匹配截断的 bg hex / 未闭合 bg / 未闭合 px token（多行） */
+const BG_PX_FALLBACK_RE = /\bbg-\s+\[#?[0-9a-fA-F]{3,8}\]?|\bbg-\[[^\]]*$|\bpx-\[[^\]]*$/m
+/** 截断的 bg hex token */
+const TRUNCATED_BG_HEX_RE = /\bbg-\s+\[#?[0-9a-fA-F]{3,8}\]?/g
+/** 未闭合 bg token */
+const UNTERMINATED_BG_RE = /\bbg-\[[^\]]*$/gm
+/** 未闭合 px token */
+const UNTERMINATED_PX_RE = /\bpx-\[[^\]]*$/gm
+/** bg token 内含空白 */
+const BG_WHITESPACE_INSIDE_RE = /\bbg-\[[^\]\s]*\s[^\]\s]*\]/g
+/** px token 内含空白 */
+const PX_WHITESPACE_INSIDE_RE = /\bpx-\[[^\]\s]*\s[^\]\s]*\]/g
+/** 缓存失效相关关键词 */
+const CACHE_INVALIDATION_RE = /invalidation|context-not-found|cache/
+/** 文件系统竞态相关关键词 */
+const FS_RACE_RE = /enoent|eperm|ebusy|eacces|crlf|lf|rename|path/
+/** 进程/超时相关关键词 */
+const PROCESS_TIMEOUT_RE = /timeout|exceeded|watch process exited|sigkill|fatal|killed/
+/** 匹配 mutation kind */
+const MUTATION_KIND_RE = /mutation=(template|script|style)/g
+/** 匹配 round 名称 */
+const ROUND_NAME_RE = /round=([a-z0-9-]+)/g
+
 const ROOT_DIR = path.resolve(process.cwd(), 'e2e/benchmark/e2e-watch-hmr')
 const SNAPSHOTS_DIR = path.join(ROOT_DIR, 'snapshots')
 const FAILURES_DIR = path.join(ROOT_DIR, 'failures')
@@ -35,7 +66,7 @@ function listFilesSafe(dir, filter) {
 
 function parseKvContent(content) {
   const out = {}
-  for (const line of content.split(/\r?\n/)) {
+  for (const line of content.split(CRLF_RE)) {
     const index = line.indexOf('=')
     if (index <= 0) {
       continue
@@ -61,10 +92,10 @@ function summarizeDiff(before, after) {
   }
   const beforeContext = before
     .slice(Math.max(0, index - 40), Math.min(before.length, index + 120))
-    .replace(/\n/g, '\\n')
+    .replace(NEWLINE_REPLACE_RE, '\\n')
   const afterContext = after
     .slice(Math.max(0, index - 40), Math.min(after.length, index + 120))
-    .replace(/\n/g, '\\n')
+    .replace(NEWLINE_REPLACE_RE, '\\n')
   return `firstDiff=${index}, len=${before.length}->${after.length}\n  before=${beforeContext}\n  after=${afterContext}`
 }
 
@@ -99,7 +130,7 @@ function resolvePhase(rawPhase, errorText) {
   if (rawPhase === 'add' || rawPhase === 'modify') {
     return 'hot-update'
   }
-  if (/rollback/i.test(errorText)) {
+  if (ROLLBACK_RE.test(errorText)) {
     return 'rollback'
   }
   return 'hot-update'
@@ -118,13 +149,13 @@ function pickPrimaryFailure(failureLogs, failureSnapshots) {
       phase: resolvePhase(kv.phase || '', kv.error || ''),
       project: kv.project || 'unknown',
       sourceFile: kv.source || 'unknown',
-      tokens: (kv.tokens || '').split(/\s+\|\s+/).filter(Boolean),
+      tokens: (kv.tokens || '').split(TOKEN_SEPARATOR_RE).filter(Boolean),
       error: kv.error || '',
     }
   }
 
   if (failureSnapshots.length > 0) {
-    const item = failureSnapshots[failureSnapshots.length - 1]
+    const item = failureSnapshots.at(-1)
     return {
       source: 'snapshot',
       file: item.dir,
@@ -164,7 +195,7 @@ function pickFailureSnapshot(primary, snapshots) {
       && item.meta.roundName === primary.round
       && item.meta.phase === primary.phaseRaw,
   )
-  return exact || candidates[candidates.length - 1]
+  return exact || candidates.at(-1)
 }
 
 function pickMetricFromReport(report, primary) {
@@ -218,9 +249,7 @@ function pickSnippet(source, probes) {
   }
 
   if (hitIndex < 0) {
-    const fallback = source.match(
-      /\bbg-\s+\[#?[0-9a-fA-F]{3,8}\]?|\bbg-\[[^\]]*$|\bpx-\[[^\]]*$/m,
-    )
+    const fallback = source.match(BG_PX_FALLBACK_RE)
     if (fallback?.index != null) {
       hitIndex = fallback.index
     }
@@ -237,11 +266,11 @@ function pickSnippet(source, probes) {
 
 function detectTokenAnomalies(source) {
   const patterns = [
-    { name: 'truncated-bg-hex', re: /\bbg-\s+\[#?[0-9a-fA-F]{3,8}\]?/g },
-    { name: 'unterminated-bg-token', re: /\bbg-\[[^\]]*$/gm },
-    { name: 'unterminated-px-token', re: /\bpx-\[[^\]]*$/gm },
-    { name: 'bg-whitespace-inside-token', re: /\bbg-\[[^\]\s]*\s[^\]\s]*\]/g },
-    { name: 'px-whitespace-inside-token', re: /\bpx-\[[^\]\s]*\s[^\]\s]*\]/g },
+    { name: 'truncated-bg-hex', re: TRUNCATED_BG_HEX_RE },
+    { name: 'unterminated-bg-token', re: UNTERMINATED_BG_RE },
+    { name: 'unterminated-px-token', re: UNTERMINATED_PX_RE },
+    { name: 'bg-whitespace-inside-token', re: BG_WHITESPACE_INSIDE_RE },
+    { name: 'px-whitespace-inside-token', re: PX_WHITESPACE_INSIDE_RE },
   ]
 
   const findings = []
@@ -267,7 +296,7 @@ function scoreAttribution(primary, evidence) {
     ['进程/超时问题', 0],
   ])
 
-  if (/invalidation|context-not-found|cache/.test(text)) {
+  if (CACHE_INVALIDATION_RE.test(text)) {
     scores.set(
       'cache key/invalidation',
       scores.get('cache key/invalidation') + 2,
@@ -286,13 +315,13 @@ function scoreAttribution(primary, evidence) {
       scores.get('transform emit mismatch') + 3,
     )
   }
-  if (/enoent|eperm|ebusy|eacces|crlf|lf|rename|path/.test(text)) {
+  if (FS_RACE_RE.test(text)) {
     scores.set(
       '文件系统竞态/路径换行差异',
       scores.get('文件系统竞态/路径换行差异') + 3,
     )
   }
-  if (/timeout|exceeded|watch process exited|sigkill|fatal|killed/.test(text)) {
+  if (PROCESS_TIMEOUT_RE.test(text)) {
     scores.set('进程/超时问题', scores.get('进程/超时问题') + 3)
   }
   if (primary.phase === 'rollback') {
@@ -393,7 +422,7 @@ function generateDiffSummary() {
       lines.push(`- ${path.basename(file)}`)
       const content = readUtf8(file).trim()
       if (content) {
-        for (const line of content.split(/\r?\n/)) {
+        for (const line of content.split(CRLF_RE)) {
           lines.push(`  ${line}`)
         }
       }
@@ -619,8 +648,8 @@ function publishJobSummary() {
     for (const log of logs) {
       const content = fs.readFileSync(path.join(FAILURES_DIR, log), 'utf8')
       const kindMatches
-        = content.match(/mutation=(template|script|style)/g) || []
-      const roundMatches = content.match(/round=([a-z0-9-]+)/g) || []
+        = content.match(MUTATION_KIND_RE) || []
+      const roundMatches = content.match(ROUND_NAME_RE) || []
       for (const matched of kindMatches) {
         failedKinds.add(matched.replace('mutation=', ''))
       }

.github/workflows/ci.yml

@@ -69,6 +69,7 @@ jobs:
           } >> "$GITHUB_STEP_SUMMARY"
 
       - name: Upload coverage reports to Codecov
+        if: matrix.os == 'ubuntu-latest' && matrix.node-version == 22
         uses: codecov/codecov-action@v5
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}