From 896fbbb49bc31814178db14581edd56155018521 Mon Sep 17 00:00:00 2001
From: lonelywolf <13281126@qq.com>
Date: Wed, 28 Oct 2026 09:27:11 +0000
Subject: [PATCH] S14V1.70

---
 build/build.bat | 122 +++++++
 build/build.ps1 | 873 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 995 insertions(+)
 create mode 100644 build/build.bat
 create mode 100644 build/build.ps1

diff --git a/build/build.bat b/build/build.bat
new file mode 100644
index 0000000..e6d817d
--- /dev/null
+++ b/build/build.bat
@@ -0,0 +1,122 @@
+@echo off
+setlocal EnableExtensions
+title BadWolf 过滤器构建工具
+
+rem ============================================================
+rem  BadWolf 过滤器构建入口  build.bat  v1.2
+rem  本文件为 GBK(cp936) + CRLF 编码；改文案请保持该编码，否则中文乱码。
+rem ============================================================
+
+rem ---- 记录原代码页，退出前还原。本文件是 GBK，控制台非 936 先切过去。
+rem      chcp ^<nul 让子进程不继承标准输入，否则 set /p 会少读一行。
+set "OLDCP="
+for /f "tokens=2 delims=:" %%a in ('chcp ^<nul') do set "OLDCP=%%a"
+if defined OLDCP set "OLDCP=%OLDCP: =%"
+chcp 936 <nul >nul 2>nul
+
+set "RC=0"
+set "HERE=%~dp0"
+set "PS1=%HERE%build.ps1"
+set "MENU="
+if "%~1"=="" set "MENU=1"
+
+if not exist "%PS1%" goto nops1
+if /i "%~1"=="help" goto help
+if "%~1"=="/?" goto help
+if "%~1"=="?" goto help
+
+if defined MENU goto menu
+goto run
+
+rem ---------------------------------------------------------------- 菜单
+:menu
+cls
+echo ============================================================
+echo    BadWolf 过滤器构建工具
+echo ============================================================
+echo.
+echo    1. 校验        只读检查，不写任何文件
+echo    2. 构建        按模块重建合并版，自动备份，只留最近 2 份
+echo    3. 行号换算    合并版行号 与 模块行号 互相换算
+echo    4. 导出        生成行号映射表
+echo    0. 退出
+echo.
+set "SEL="
+set /p "SEL=请输入序号后回车，直接回车 = 校验："
+if "%SEL%"=="0" goto done
+if "%SEL%"=="2" goto mBld
+if "%SEL%"=="3" goto mMap
+if "%SEL%"=="4" goto mExp
+goto mChk
+
+:mChk
+set "ARGS=check"
+goto run2
+
+:mBld
+set "ARGS=build"
+goto run2
+
+:mMap
+echo.
+set "Q="
+set /p "Q=请输入行号，例如 1939 或 16:139，直接回车返回菜单："
+if "%Q%"=="" goto menu
+set "ARGS=map %Q%"
+goto run2
+
+:mExp
+set "ARGS=export"
+goto run2
+
+rem ---------------------------------------------------------------- 执行
+:run
+set "ARGS=%*"
+
+:run2
+echo.
+powershell -NoProfile -ExecutionPolicy Bypass -File "%PS1%" %ARGS%
+set "RC=%ERRORLEVEL%"
+echo.
+if "%RC%"=="0" echo [完成] 退出码 0：校验通过
+if "%RC%"=="1" echo [注意] 退出码 1：发现问题，见上面的 x 项或差异块
+if "%RC%"=="2" echo [失败] 退出码 2：环境问题，缺文件或模块编号重复
+if not defined MENU goto done
+echo.
+pause
+goto menu
+
+rem ---------------------------------------------------------------- 帮助
+:help
+echo.
+echo BadWolf 过滤器构建脚本  命令行用法
+echo.
+echo    build.bat                 打开菜单
+echo    build.bat check           校验，不写文件
+echo    build.bat build           重建合并版，自动备份
+echo    build.bat map 1939        合并版行号 转 模块行号
+echo    build.bat map 16:139      模块行号 转 合并版行号
+echo    build.bat export          导出行号映射表
+echo.
+echo 附加参数
+echo    -NoBackup           build 时不备份原文件
+echo    -KeepBackups 3      备份保留份数，默认 2
+echo    -Strict             有提示项也算不通过
+echo.
+echo 退出码  0 通过   1 有问题   2 环境问题
+echo.
+goto done
+
+rem ---------------------------------------------------------------- 缺文件
+:nops1
+echo.
+echo [错误] 同目录下找不到 build.ps1
+echo        请确认 build.bat 与 build.ps1 放在同一个文件夹里。
+echo.
+pause
+set "RC=2"
+goto done
+
+:done
+if defined OLDCP chcp %OLDCP% <nul >nul 2>nul
+exit /b %RC%
diff --git a/build/build.ps1 b/build/build.ps1
new file mode 100644
index 0000000..ca2c848
--- /dev/null
+++ b/build/build.ps1
@@ -0,0 +1,873 @@
+锘�#requires -Version 5.1
+<#
+    BadWolf 杩囨护鍣ㄦ瀯寤鸿剼鏈�  build.ps1  v1.2
+    ------------------------------------------------------------------
+    鐢ㄩ�旓細鎶婃ā鍧楃洰褰曚笅鐨� txt 鎸夋枃浠跺悕鎺掑簭鎷兼帴鎴� BadWolf-LootFilter.txt锛�
+          骞跺畬鎴愪竴鑷存�ф牎楠屼笌琛屽彿鎹㈢畻銆傜函 PowerShell锛屾棤闇�瀹夎浠讳綍杞欢銆�
+
+    v1.2 鐩稿 v1.1 鐨勫彉鍖�
+    ------------------------------------------------------------------
+      路 鑷鏂板锛氬绔� % / 鏈棴鍚� % 鎵弿锛堝崐鎴櫨鍒嗗彿浼氬悶棰滆壊鎴栨紡鍑烘槑鏂囷級
+        鍒ゅ畾锛氬厛鏁翠綋灞忚斀鍚堟硶鍗犱綅绗� %NAME%锛屽墿涓嬬殑 % 鍙斁琛屽洓绉嶅啓瀛楅潰鐧惧垎鍙风殑鎯呭舰
+              锛堟暟鍊煎悗 40%ED / 鍙虫嫭鍙峰悗 [4-6]%鐗╃悊鍑忎激 / 澶瑰湪涓や釜鍗犱綅绗︿箣闂� /
+                銆岀墿鐞嗗噺浼�%銆嶃�岄瓟娉曞噺浼�%銆嶅悗鐨勭櫨鍒嗘瘮绀烘剰绗︼級
+
+    v1.1 鐩稿 v1.0 鐨勫彉鍖�
+    ------------------------------------------------------------------
+      路 妯″潡鐧藉悕鍗曪細鍙嫾 NN-*.txt锛屽叾瀹� txt 涓�寰嬭烦杩囧苟榛勫瓧璀﹀憡锛堜笉鍐嶉潤榛樻贩鍏ワ級
+      路 澶囦唤杞浆锛歜uild 鍙繚鐣欐渶杩� 2 浠� .bak锛屽彲鐢� -KeepBackups N 璋冩暣
+      路 涓存椂鏂囦欢锛氬啓鐩樺け璐ヤ篃浼氭竻鐞� .tmp
+      路 鑷鏂板锛氱墿鍝佷唬鐮佺櫧鍚嶅崟锛坕tem_codes.txt锛�/ 姝昏鍒� / Formula 寮曠敤瀹屾暣鎬�
+      路 鐗堟湰琛岃仈鍔細鐗堟湰琛屾棩鏈熻惤鍚庝簬鏈�鏅氭ā鍧楁敼鍔ㄦ椂闂存椂鎻愮ず
+
+    鐢ㄦ硶锛堜簩閫変竴锛�
+    ------------------------------------------------------------------
+    A. 鍙屽嚮 build.bat            鈫� 鐩存帴鏍￠獙锛堢獥鍙ｄ笉鍏筹級
+    B. 鍛戒护琛岋細
+         powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1
+         powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1 build
+         powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1 map 1939
+         powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1 map 16:139
+         powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1 export
+
+    鍛戒护
+    ------------------------------------------------------------------
+      check   鏍￠獙锛堥粯璁わ紝涓嶅啓浠讳綍鏂囦欢锛�
+      build   閲嶅缓鍚堝苟鐗堬紙鑷姩澶囦唤 .bak锛屽彧淇濈暀鏈�杩� 2 浠斤紱-NoBackup 鍏抽棴澶囦唤锛�
+      map     琛屽彿鎹㈢畻锛� 1939锛堝悎骞垛啋妯″潡锛�  鎴�  16:139锛堟ā鍧椻啋鍚堝苟锛�
+      export  瀵煎嚭琛屽彿鏄犲皠琛�
+
+    鍙傛暟
+    ------------------------------------------------------------------
+      -NoBackup         build 鏃朵笉澶囦唤鍘熸枃浠�
+      -KeepBackups N    澶囦唤淇濈暀浠芥暟锛岄粯璁� 2
+      -Strict           鏈夋彁绀洪」涔熺畻涓嶉�氳繃锛堥��鍑虹爜 1锛�
+
+    閫�鍑虹爜锛�0 涓�鑷� / 1 鏈夐棶棰� / 2 鐜闂
+#>
+param(
+    [Parameter(Position = 0)][string]$Command = 'check',
+    [Parameter(Position = 1)][string]$Arg = '',
+    [switch]$NoBackup,
+    [switch]$Strict,
+    [int]$KeepBackups = 2
+)
+
+$ErrorActionPreference = 'Stop'
+
+# ---------------------------------------------------------------- 鍩虹璺緞
+$Root       = $PSScriptRoot
+$MergedName = 'BadWolf-LootFilter.txt'
+$MergedPath = Join-Path $Root $MergedName
+$MapName    = [char]0x884C + [char]0x53F7 + [char]0x6620 + [char]0x5C04 + [char]0x8868 + '.md'
+
+function Write-Line([string]$s) { Write-Host $s }
+function Format-N([long]$n) { return $n.ToString('N0', [System.Globalization.CultureInfo]::InvariantCulture) }
+function Get-Bar { return ('=' * 74) }
+function Write-Head([string]$t) { Write-Host ""; Write-Host "[$t]"; Write-Host ('-' * 74) }
+
+function Get-Md5Hex([byte[]]$Bytes) {
+    $md5 = [System.Security.Cryptography.MD5]::Create()
+    try { $h = $md5.ComputeHash($Bytes) } finally { $md5.Dispose() }
+    return (-join ($h | ForEach-Object { $_.ToString('x2') }))
+}
+
+# ---------------------------------------------------------------- 妯″潡鐩綍
+# 鍙銆屸墺10 涓� 鏁板瓧-xxx.txt銆嶇殑鐩綍锛涘涓�欓�夌洿鎺ユ姤閿欙紝缁濅笉鐚�
+function Get-ModuleDir {
+    $cands = @()
+    foreach ($d in @(Get-ChildItem -LiteralPath $Root -Directory -ErrorAction SilentlyContinue)) {
+        $n = @(Get-ChildItem -LiteralPath $d.FullName -Filter '*.txt' -File -ErrorAction SilentlyContinue |
+               Where-Object { $_.Name -match '^\d{2}-' }).Count
+        if ($n -gt 0) { $cands += [pscustomobject]@{ Path = $d.FullName; Count = $n } }
+    }
+    $good = @($cands | Where-Object { $_.Count -ge 10 } | Sort-Object -Descending Count)
+
+    if ($good.Count -eq 0) {
+        $tip = ''
+        if ($cands.Count -gt 0) {
+            $tip = '锛涘�欓�夌洰褰曪紙鏂囦欢鏁颁笉瓒筹級锛�' + (($cands | ForEach-Object { "$($_.Path)($($_.Count)涓�)" }) -join '锛�')
+        }
+        throw "鎵句笉鍒版ā鍧楃洰褰曪細$Root 涓嬫病鏈夊寘鍚� 鈮�10 涓� `00-xxx.txt` 褰㈠紡鏂囦欢鐨勬枃浠跺す$tip"
+    }
+    if ($good.Count -gt 1) {
+        $list = ($good | ForEach-Object { "$($_.Path)锛�$($_.Count) 涓級" }) -join '锛�'
+        throw "妫�娴嬪埌澶氫釜鍙兘鐨勬ā鍧楃洰褰曪紝涓洪伩鍏嶇敤閿欑洰褰曟瀯寤猴紝宸插仠姝細$list銆傝鎶婂浣欑殑绉昏蛋鎴栨敼鍚嶃��"
+    }
+    return $good[0].Path
+}
+
+# ---------------------------------------------------------------- 杞藉叆妯″潡
+# 鐧藉悕鍗曪細鍙銆孨N-鍚嶇О.txt銆嶏紱鍚嶅瓧閲屽甫 鍓湰/澶囦唤/copy/bak/(1) 鐨勮涓哄鍒跺搧锛屽悓鏍疯烦杩�
+$script:SkippedModules = @()
+$CopyNameRe = '鍓湰|澶囦唤|澶嶅埗|copy|bak|backup|\(\d+\)'
+
+function Get-Modules([string]$Dir) {
+    $allTxt  = @(Get-ChildItem -LiteralPath $Dir -Filter '*.txt' -File)
+    $files   = @($allTxt | Where-Object {
+                   $_.Name -match '^\d{2}-.*\.txt$' -and $_.Name -notmatch $CopyNameRe
+               } | Sort-Object Name)
+    $script:SkippedModules = @($allTxt | Where-Object {
+                   -not ($_.Name -match '^\d{2}-.*\.txt$') -or ($_.Name -match $CopyNameRe)
+               } | Sort-Object Name | ForEach-Object { $_.Name })
+    $list  = New-Object System.Collections.ArrayList
+    $cursor = 1
+    $strict = [System.Text.UTF8Encoding]::new($false, $true)
+
+    foreach ($f in $files) {
+        $bytes = [System.IO.File]::ReadAllBytes($f.FullName)
+        $text  = [System.Text.Encoding]::UTF8.GetString($bytes)
+        $errors = New-Object System.Collections.ArrayList
+
+        try { [void]$strict.GetString($bytes) }
+        catch { [void]$errors.Add('涓嶆槸鍚堟硶鐨� UTF-8 缂栫爜') }
+
+        if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) {
+            [void]$errors.Add('鍚� UTF-8 BOM')
+        }
+        $lfOnly = ([regex]::Matches($text, "(?<!\r)\n")).Count
+        if ($lfOnly -gt 0) { [void]$errors.Add("瀛樺湪瑁� LF 鎹㈣锛�$lfOnly 澶勶級") }
+        if ($bytes.Length -eq 0) { [void]$errors.Add('绌烘枃浠�') }
+        elseif ($bytes[$bytes.Length - 1] -ne 10) { [void]$errors.Add('鏂囦欢鏈熬缂哄皯鎹㈣') }
+
+        $lineCount = ([regex]::Matches($text, "\n")).Count
+
+        $m = [pscustomobject]@{
+            Name      = $f.Name
+            Code      = if ($f.Name.Length -ge 2) { $f.Name.Substring(0, 2) } else { '??' }
+            Path      = $f.FullName
+            Bytes     = $bytes
+            ByteLen   = $bytes.Length
+            Text      = $text
+            LineCount = $lineCount
+            Start     = $cursor
+            MTime     = $f.LastWriteTime
+            Errors    = $errors
+        }
+        $m | Add-Member -MemberType ScriptProperty -Name End -Value { $this.Start + $this.LineCount - 1 }
+        [void]$list.Add($m)
+        $cursor += $lineCount
+    }
+    return , $list.ToArray()
+}
+
+function Get-Lines([string]$Text) {
+    $a = $Text -split "`r`n"
+    if ($a.Count -gt 0 -and $a[-1] -eq '') {
+        if ($a.Count -eq 1) { return @() }
+        return $a[0..($a.Count - 2)]
+    }
+    return $a
+}
+
+function Find-ModuleOfLine($Mods, [int]$Line) {
+    foreach ($m in $Mods) { if ($Line -ge $m.Start -and $Line -le $m.End) { return $m } }
+    return $null
+}
+
+function Join-Bytes($Mods) {
+    $ms = New-Object System.IO.MemoryStream
+    try {
+        foreach ($m in $Mods) { $ms.Write($m.Bytes, 0, $m.ByteLen) }
+        return , $ms.ToArray()
+    } finally { $ms.Dispose() }
+}
+
+# ---------------------------------------------------------------- 鐧藉悕鍗�
+$Colors = @('BLACK','WHITE','GRAY','LIGHT_GRAY','DARK_GRAY','RED','DARK_RED','ORANGE','GOLD',
+            'YELLOW','GREEN','DARK_GREEN','SAGE','TEAL','BLUE','DARK_BLUE','PURPLE','CORAL',
+            'TAN','LIGHT_BLUE','VIOLET')
+$Special = @('NAME','CL','NL','CONTINUE')
+$InfoCodes = @('ED','EDAM','EDEF','RES','FRES','CRES','LRES','PRES','IAS','FCR','MFIND','LIFE',
+               'STR','DEX','AR','RANGE','PRICE','QTY','GEMTYPE','SOCKETS','MAXSOCKETS','BASENAME',
+               'BASEMINKICK','BASEMAXKICK','CRAFTALVL','REROLLALVL','UPLVL','UPSTR','UPDEX',
+               'WPNSPD','MAXDMG','ITEMCODE')
+$PhSet = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)
+foreach ($x in @($Colors + $Special + $InfoCodes)) { [void]$PhSet.Add($x) }
+$NumPrefix = @('SK','STAT','CHARSTAT','TABSK','FORMULA')
+$KwPrefix  = @('SK','STAT','CHARSTAT','TABSK','MULTI','CLSK','FORMULA')
+$IgnoreUndef = @('SPEARBASE2_3')
+$MaxLineLen = 1024
+
+function Test-Placeholder([string]$name) {
+    if ($PhSet.Contains($name)) { return $true }
+    foreach ($p in $NumPrefix) {
+        if (-not $name.StartsWith($p, [System.StringComparison]::Ordinal)) { continue }
+        $tail = $name.Substring($p.Length)
+        if ($tail -eq '') { return $true }
+        if ($tail -match '^\d+$') { return $true }
+        if ($p -eq 'FORMULA' -and $tail -match '^[A-Z0-9_]+$') { return $true }
+    }
+    return $false
+}
+
+function Test-KeywordToken([string]$t) {
+    foreach ($p in $KwPrefix) {
+        if (-not $t.StartsWith($p, [System.StringComparison]::Ordinal)) { continue }
+        $tail = $t.Substring($p.Length)
+        if ($tail -eq '') { return $true }
+        if ($tail -match '^\d+$') { return $true }
+        if ($p -eq 'FORMULA' -and $tail -match '^[A-Z0-9_]+$') { return $true }
+    }
+    return $false
+}
+
+# ---------------------------------------------------------------- 鐗╁搧浠ｇ爜鐧藉悕鍗�
+# item_codes.txt 鐢� data\global\excel 鐢熸垚锛歔codes] 鐗╁搧浠ｇ爜 / [types] 绫诲瀷浠ｇ爜銆�
+# 鏂囦欢涓嶅瓨鍦ㄥ垯璺宠繃璇ラ」妫�鏌ワ紙涓嶈涓洪敊璇級銆�
+function Get-CodeWhitelist {
+    $p = Join-Path $Root 'item_codes.txt'
+    if (-not (Test-Path -LiteralPath $p)) { return $null }
+    $set = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::OrdinalIgnoreCase)
+    foreach ($l in [System.IO.File]::ReadAllLines($p, [System.Text.Encoding]::UTF8)) {
+        $t = $l.Trim()
+        if ($t -eq '') { continue }
+        if ($t.StartsWith('#') -or $t.StartsWith('[')) { continue }
+        [void]$set.Add($t)
+    }
+    if ($set.Count -eq 0) { return $null }
+    return , $set
+}
+
+# ---------------------------------------------------------------- 瀛ょ珛 % / 鏈棴鍚� %
+# 鍗婃埅鐧惧垎鍙蜂笉浼氳杩囨护鍣ㄦ姤閿欙紝鍙細鍚炴帀棰滆壊鎴栨妸 %XXX 婕忔垚鏄庢枃锛屾墍浠ュ彧浣溿�屾彁绀恒�嶃��
+# 鍋氭硶锛氬厛鎵惧嚭鎵�鏈夊悎娉曞崰浣嶇 %NAME% 鐨勫尯闂达紝鍐嶉�愪釜妫�鏌ュ墿涓嬬殑 %锛�
+#   鏀捐  鍓嶄竴浣嶆槸鏁板瓧          40%ED銆�/35%%TAN%銆�10%绉诲姩閫熷害
+#   鏀捐  鍓嶄竴浣嶆槸 ] ) / -      [4-6]%鐗╃悊鍑忎激銆�+[50-80]% 澧炲己浼ゅ
+#   鏀捐  鍓嶄竴浣嶆槸鍗犱綅绗︾粨灏撅紝涓斿悗涓�浣嶆槸鍗犱綅绗﹀紑澶� / } / ]    %EDEF%%%GRAY%銆�%STAT258%%}
+#   鏀捐  鍓嶅洓浣嶆槸銆岀墿鐞嗗噺浼ゃ�嶃�岄瓟娉曞噺浼ゃ��  [4-6]%鐗╃悊鍑忎激%   鈫� 鐧惧垎姣斿噺浼ょ殑涓撶敤绀烘剰绗︼紝
+#          鍒绘剰涓庢暟鍊煎噺浼� [2-5]鐗╃悊鍑忎激 鍖哄垎锛�2026-10-28 鐢ㄦ埛瀹氫箟锛屼笉瑕佸垹銆佷笉瑕佹姤锛�
+#   鎶ュ嚭  鍏朵綑鍏ㄩ儴锛�%GRAY%%Steel( 缂哄彸渚с�佹娊鍔ㄦ專鎵�%%CL% 澶氫竴涓�佺铔囦箣缇紺L% 缂哄乏渚э級
+function Get-PercentFault([string[]]$Lines) {
+    $phMask    = [regex]'%[A-Za-z][A-Za-z0-9_\-]*%'
+    $nextNameRe = [regex]'^([A-Za-z][A-Za-z0-9_\-]*)'
+    $prevNameRe = [regex]'([A-Za-z][A-Za-z0-9_\-]*)$'
+    $res = New-Object System.Collections.ArrayList
+
+    for ($i = 0; $i -lt $Lines.Count; $i++) {
+        $s = $Lines[$i]
+        if (-not $s.Contains('%')) { continue }
+        if ($s.TrimStart().StartsWith('//')) { continue }
+        # 琛屽熬 // 娉ㄩ噴閲岀殑 % 涓嶅弬涓庢樉绀猴紝鍏堝垏鎺�
+        $cut  = $s.IndexOf('//')
+        $body = if ($cut -ge 0) { $s.Substring(0, $cut) } else { $s }
+        if (-not $body.Contains('%')) { continue }
+
+        $inPh    = [System.Collections.Generic.HashSet[int]]::new()
+        $phStart = [System.Collections.Generic.HashSet[int]]::new()
+        $phEnd   = [System.Collections.Generic.HashSet[int]]::new()
+        foreach ($mm in $phMask.Matches($body)) {
+            [void]$phStart.Add($mm.Index)
+            [void]$phEnd.Add($mm.Index + $mm.Length - 1)
+            for ($k = $mm.Index; $k -lt ($mm.Index + $mm.Length); $k++) { [void]$inPh.Add($k) }
+        }
+
+        $j = $body.IndexOf('%')
+        while ($j -ge 0) {
+            if ($inPh.Contains($j)) { $j = $body.IndexOf('%', $j + 1); continue }
+            $prev = if ($j -gt 0) { $body[$j - 1] } else { [char]0 }
+            $next = if ($j + 1 -lt $body.Length) { $body[$j + 1] } else { [char]0 }
+
+            $ok = $false
+            if ([char]::IsDigit($prev)) { $ok = $true }
+            elseif ('])/-'.IndexOf($prev) -ge 0) { $ok = $true }
+            elseif ($phEnd.Contains($j - 1) -and ($phStart.Contains($j + 1) -or $next -eq '}' -or $next -eq ']')) { $ok = $true }
+            elseif ($j -ge 4 -and ($body.Substring($j - 4, 4) -eq '鐗╃悊鍑忎激' -or $body.Substring($j - 4, 4) -eq '榄旀硶鍑忎激')) { $ok = $true }
+
+            if (-not $ok) {
+                $kind = '瀛ょ珛 %'
+                $nw = $nextNameRe.Match($body.Substring($j + 1))
+                $pw = $prevNameRe.Match($body.Substring(0, $j))
+                if ($pw.Success -and (Test-Placeholder $pw.Groups[1].Value)) { $kind = '缂哄乏渚� %' }
+                elseif ($nw.Success) { $kind = '缂哄彸渚� %' }
+                elseif ($phStart.Contains($j + 1) -or $next -eq '%') { $kind = '澶氫綑 %' }
+                $a    = [Math]::Max(0, $j - 16)
+                $len  = [Math]::Min(38, $body.Length - $a)
+                $snip = $body.Substring($a, $len)
+                [void]$res.Add([pscustomobject]@{ Line = $i + 1; Kind = $kind; Snippet = $snip })
+            }
+            $j = $body.IndexOf('%', $j + 1)
+        }
+    }
+    return $res.ToArray()
+}
+
+# ---------------------------------------------------------------- 鑷
+function Invoke-SelfCheck([string[]]$Lines, $Mods) {
+    $errors = New-Object System.Collections.ArrayList
+    $warns  = New-Object System.Collections.ArrayList
+
+    $ruleRe = [regex]'^ItemDisplay\[([^\]]*)\]:(.*)$'
+    $aliasRe = [regex]'^Alias\[([^\]]+)\]:(.*)$'
+    $formulaRe = [regex]'^Formula\[([^\]]+)\]:(.*)$'
+    $phRe = [regex]'%([A-Za-z][A-Za-z0-9_]*)%'
+    $tokRe = [regex]'(?<![A-Za-z0-9_])([A-Z][A-Z0-9_]{1,})(?![A-Za-z0-9_])'
+
+    $rules = New-Object System.Collections.ArrayList
+    $aliasNames = New-Object System.Collections.ArrayList
+    $formulaNames = New-Object System.Collections.ArrayList
+    $formulaCount = 0
+    $continueCount = 0
+    $phSeen = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)
+    $badPh = @{}
+    $filtlvl = 0
+    $trail = New-Object System.Collections.ArrayList
+
+    for ($i = 0; $i -lt $Lines.Count; $i++) {
+        $ln = $i + 1
+        $s = $Lines[$i]
+
+        $mr = $ruleRe.Match($s)
+        if ($mr.Success) {
+            $cond = $mr.Groups[1].Value
+            $out  = $mr.Groups[2].Value
+            [void]$rules.Add([pscustomobject]@{ Line = $ln; Cond = $cond; Out = $out })
+            if ($cond.Contains('FILTLVL')) { $filtlvl++ }
+            if ($cond.Contains('(') -or $cond.Contains(')')) {
+                $open = ([regex]::Matches($cond, '\(')).Count
+                $close = ([regex]::Matches($cond, '\)')).Count
+                if ($open -ne $close) {
+                    [void]$errors.Add("L$ln 鏉′欢鎷彿涓嶅钩琛★紙( $open / ) $close锛夛細$cond")
+                }
+            }
+        }
+        $ma = $aliasRe.Match($s)
+        if ($ma.Success) { [void]$aliasNames.Add($ma.Groups[1].Value) }
+        $mf = $formulaRe.Match($s)
+        if ($mf.Success) { $formulaCount++; [void]$formulaNames.Add($mf.Groups[1].Value) }
+
+        $continueCount += ([regex]::Matches($s, '%CONTINUE%')).Count
+
+        foreach ($pm in $phRe.Matches($s)) {
+            $nm = $pm.Groups[1].Value
+            [void]$phSeen.Add($nm)
+            if (-not (Test-Placeholder $nm)) {
+                if (-not $badPh.ContainsKey($nm)) { $badPh[$nm] = New-Object System.Collections.ArrayList }
+                [void]$badPh[$nm].Add($ln)
+            }
+        }
+
+        if ($s -ne $s.TrimEnd()) { [void]$trail.Add($ln) }
+        if ($s.Length -gt $MaxLineLen) { [void]$warns.Add("L$ln 瓒呴暱锛�$($s.Length) 瀛楃锛�") }
+    }
+
+    # 瀛ょ珛 % / 鏈棴鍚� %
+    $pctFaults = @(Get-PercentFault $Lines)
+    foreach ($f in $pctFaults) {
+        [void]$warns.Add("$($f.Kind) L$($f.Line)锛�$($f.Snippet)")
+    }
+
+    # 鍒悕閲嶅
+    $seenAlias = @{}
+    foreach ($n in $aliasNames) { if ($seenAlias.ContainsKey($n)) { $seenAlias[$n]++ } else { $seenAlias[$n] = 1 } }
+    foreach ($k in ($seenAlias.Keys | Sort-Object)) {
+        if ($seenAlias[$k] -gt 1) { [void]$errors.Add("鍒悕閲嶅瀹氫箟锛�$k") }
+    }
+
+    # 闈炴硶鍗犱綅绗�
+    foreach ($k in ($badPh.Keys | Sort-Object)) {
+        $lns = ($badPh[$k] | Select-Object -First 8) -join ','
+        [void]$errors.Add("闈炴硶鍗犱綅绗� %$k%锛�$($badPh[$k].Count) 澶勶紝琛� $lns锛�")
+    }
+
+    # 鏈畾涔夋爣璇嗭紙鍙垽鍒悕椋庢牸锛氬惈涓嬪垝绾挎垨鏁板瓧锛�
+    $defined = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)
+    foreach ($n in $aliasNames) { [void]$defined.Add($n.ToUpperInvariant()) }
+    $refs = @{}
+    foreach ($r in $rules) {
+        foreach ($tm in $tokRe.Matches($r.Cond)) {
+            $t = $tm.Groups[1].Value
+            if (-not $refs.ContainsKey($t)) { $refs[$t] = New-Object System.Collections.ArrayList }
+            [void]$refs[$t].Add($r.Line)
+        }
+    }
+    foreach ($t in ($refs.Keys | Sort-Object)) {
+        if ($defined.Contains($t)) { continue }
+        if ($IgnoreUndef -contains $t) { continue }
+        if (Test-KeywordToken $t) { continue }
+        if ($t -match '[_\d]') {
+            $lns = ($refs[$t] | Select-Object -First 4) -join ','
+            [void]$warns.Add("鏈畾涔夋爣璇� $t锛圠$lns锛�")
+        }
+    }
+
+    # 瀹屽叏閲嶅瑙勫垯
+    $dupMap = @{}
+    foreach ($r in $rules) {
+        $k = (($r.Cond -replace '\s+', ' ').Trim().ToLowerInvariant()) + '|' + (($r.Out -replace '\s+', ' ').Trim())
+        if ($dupMap.ContainsKey($k)) { $dupMap[$k] += ",$($r.Line)" } else { $dupMap[$k] = "$($r.Line)" }
+    }
+    foreach ($k in $dupMap.Keys) {
+        if ($dupMap[$k] -match ',') {
+            $c = $k.Split('|')[0]
+            if ($c.Length -gt 70) { $c = $c.Substring(0, 70) }
+            [void]$warns.Add("瀹屽叏閲嶅瑙勫垯 L$($dupMap[$k])锛�$c")
+        }
+    }
+
+    # 姝昏鍒欙細鍚屼竴鏉′欢閲嶅鍑虹幇锛屼笖鏇存棭鐨勪竴鏉℃病鏈� %CONTINUE% 鈫� 鍚庝竴鏉℃案涓嶅懡涓�
+    $stopAt = @{}
+    $deadCount = 0
+    foreach ($r in $rules) {
+        $k = ($r.Cond -replace '\s+', ' ').Trim().ToUpperInvariant()
+        if ($k -eq '') { continue }
+        if ($stopAt.ContainsKey($k)) {
+            $deadCount++
+            if ($deadCount -le 12) {
+                [void]$warns.Add("姝昏鍒� L$($r.Line) 姘镐笉鍛戒腑锛堝悓鏉′欢 L$($stopAt[$k]) 鏈甫 CONTINUE锛屽凡缁堢粨鍒ゅ畾锛夛細$($r.Cond)")
+            }
+        } elseif (-not $r.Out.ToUpperInvariant().Contains('%CONTINUE%')) {
+            $stopAt[$k] = $r.Line
+        }
+    }
+    if ($deadCount -gt 12) { [void]$warns.Add("... 鍙︽湁 $($deadCount - 12) 鏉℃瑙勫垯") }
+
+    # 鐗╁搧浠ｇ爜鐧藉悕鍗�
+    $wl = Get-CodeWhitelist
+    $wlCount = 0
+    if ($null -eq $wl) {
+        [void]$warns.Add('鏈壘鍒� item_codes.txt锛岃烦杩囩墿鍝佷唬鐮佹牎楠�')
+    } else {
+        $wlCount = $wl.Count
+        $codeRe = [regex]'^[a-z][a-z0-9]{1,5}$'
+        $badCode = @{}
+        foreach ($r in $rules) {
+            $c = [regex]::Replace($r.Cond, '%[^%]*%', ' ')
+            $c = $c.Replace('(', ' ').Replace(')', ' ').Replace('!', ' ')
+            foreach ($t in ($c -split '\s+')) {
+                if ($t -eq '') { continue }
+                if (-not $codeRe.IsMatch($t)) { continue }
+                if ($wl.Contains($t)) { continue }
+                if ($defined.Contains($t.ToUpperInvariant())) { continue }
+                if (-not $badCode.ContainsKey($t)) { $badCode[$t] = New-Object System.Collections.ArrayList }
+                [void]$badCode[$t].Add($r.Line)
+            }
+        }
+        foreach ($k in ($badCode.Keys | Sort-Object)) {
+            $lns = ($badCode[$k] | Select-Object -First 4) -join ','
+            [void]$errors.Add("鐤戜技鏃犳晥鐗╁搧浠ｇ爜 $k锛�$($badCode[$k].Count) 澶勶紝琛� $lns锛�")
+        }
+    }
+
+    # Formula 寮曠敤瀹屾暣鎬�
+    $fDef = @{}
+    foreach ($n in $formulaNames) { $fDef[$n] = $true }
+    $fRef = @{}
+    for ($i = 0; $i -lt $Lines.Count; $i++) {
+        if ($formulaRe.IsMatch($Lines[$i])) { continue }
+        foreach ($fm in [regex]::Matches($Lines[$i], 'FORMULA([A-Za-z0-9_]+)')) {
+            $n = $fm.Groups[1].Value
+            if (-not $fRef.ContainsKey($n)) { $fRef[$n] = New-Object System.Collections.ArrayList }
+            [void]$fRef[$n].Add($i + 1)
+        }
+    }
+    foreach ($n in ($fRef.Keys | Sort-Object)) {
+        if ($fDef.ContainsKey($n)) { continue }
+        $lns = ($fRef[$n] | Select-Object -First 4) -join ','
+        [void]$errors.Add("Formula 寮曠敤鏃犲畾涔夛細FORMULA$n锛�$($fRef[$n].Count) 澶勶紝琛� $lns锛�")
+    }
+    $fUnused = @($formulaNames | Where-Object { -not $fRef.ContainsKey($_) } | Sort-Object)
+    if ($fUnused.Count -gt 0) {
+        [void]$warns.Add("Formula 瀹氫箟鍚� 0 寮曠敤锛�$($fUnused -join '銆�')")
+    }
+
+    # 鐗堟湰琛岃仈鍔細鐗堟湰琛屾棩鏈� vs 鏈�鏅氭ā鍧楁敼鍔�
+    $verRe = [regex]'鏇存柊浜嶾s*(\d{2,4})[/-](\d{1,2})[/-](\d{1,2})'
+    foreach ($l in $Lines) {
+        $mv = $verRe.Match($l)
+        if (-not $mv.Success) { continue }
+        $y = [int]$mv.Groups[1].Value
+        if ($y -lt 100) { $y += 2000 }
+        $verOk = $true
+        $vd = [datetime]::MinValue
+        try { $vd = [datetime]::new($y, [int]$mv.Groups[2].Value, [int]$mv.Groups[3].Value) }
+        catch { $verOk = $false }
+        if ($verOk -and $null -ne $Mods -and $Mods.Count -gt 0) {
+            $newest = $Mods | Sort-Object MTime -Descending | Select-Object -First 1
+            if ($vd.Date -lt $newest.MTime.Date) {
+                [void]$warns.Add("鐗堟湰琛屽仠鍦� $($vd.ToString('yyyy-MM-dd'))锛屼絾鏈�鏅氭ā鍧楁敼鍔ㄦ槸 $($newest.MTime.ToString('yyyy-MM-dd'))锛�$($newest.Name)锛夆�斺�� 璁板緱鏇存柊鐗堟湰鍙�")
+            }
+        }
+        break
+    }
+
+    if ($trail.Count -gt 0) {
+        $head = ($trail | Select-Object -First 6) -join ','
+        [void]$warns.Add("琛屽熬绌虹櫧 $($trail.Count) 澶勶紙L$head鈥︼級")
+    }
+
+    return [pscustomobject]@{
+        Errors   = $errors
+        Warns    = $warns
+        Rules    = $rules.Count
+        Aliases  = $aliasNames.Count
+        Formulas = $formulaCount
+        Continue = $continueCount
+        Lines    = $Lines.Count
+        PhKinds  = $phSeen.Count
+        FiltLvl  = $filtlvl
+        WlCount  = $wlCount
+        Dead     = $deadCount
+        FRef     = $fRef.Count
+        FUnused  = $fUnused.Count
+        Pct      = $pctFaults.Count
+    }
+}
+
+# ---------------------------------------------------------------- 宸紓瀹氫綅
+function Get-DiffBlocks([string[]]$A, [string[]]$B) {
+    $blocks = New-Object System.Collections.ArrayList
+    if ($A.Count -eq 0 -or $B.Count -eq 0) { return , $blocks.ToArray() }
+
+    if ($A.Count -eq $B.Count) {
+        # 琛屾暟鐩稿悓锛氶�愯姣斿锛屽悎骞惰繛缁樊寮�
+        $cur = $null
+        for ($i = 0; $i -lt $A.Count; $i++) {
+            if ($A[$i] -cne $B[$i]) {
+                if ($null -eq $cur) {
+                    $cur = [pscustomobject]@{
+                        AFrom = $i + 1; ATo = $i + 1
+                        BFrom = $i + 1; BTo = $i + 1
+                        A = @(); B = @()
+                    }
+                }
+                $cur.ATo = $i + 1
+                $cur.BTo = $i + 1
+                $cur.A += $A[$i]
+                $cur.B += $B[$i]
+            } elseif ($null -ne $cur) {
+                [void]$blocks.Add($cur); $cur = $null
+            }
+        }
+        if ($null -ne $cur) { [void]$blocks.Add($cur) }
+        return , $blocks.ToArray()
+    }
+
+    # 琛屾暟涓嶅悓锛氭帎鎺夊叕鍏卞墠鍚庣紑锛屾姤涓棿
+    $min = [Math]::Min($A.Count, $B.Count)
+    $p = 0
+    while ($p -lt $min -and $A[$p] -ceq $B[$p]) { $p++ }
+    $s = 0
+    while ($s -lt ($min - $p) -and $A[$A.Count - 1 - $s] -ceq $B[$B.Count - 1 - $s]) { $s++ }
+
+    $blk = [pscustomobject]@{
+        AFrom = $p + 1
+        ATo   = $A.Count - $s
+        BFrom = $p + 1
+        BTo   = $B.Count - $s
+        A     = @($A[$p..([Math]::Max($p, $A.Count - $s - 1))])
+        B     = @($B[$p..([Math]::Max($p, $B.Count - $s - 1))])
+    }
+    [void]$blocks.Add($blk)
+    return , $blocks.ToArray()
+}
+
+# ---------------------------------------------------------------- check
+function Invoke-Check($Mods) {
+    Write-Line (Get-Bar)
+    Write-Line " BadWolf 杩囨护鍣�  鏋勫缓鏍￠獙"
+    Write-Line (Get-Bar)
+
+    $mergedRaw = @()
+    if (Test-Path -LiteralPath $MergedPath) {
+        $mergedRaw = [System.IO.File]::ReadAllBytes($MergedPath)
+    }
+    $mergedText  = [System.Text.Encoding]::UTF8.GetString($mergedRaw)
+    $mergedLines = Get-Lines $mergedText
+    $cat         = Join-Bytes $Mods
+    $catText     = [System.Text.Encoding]::UTF8.GetString($cat)
+    $catLines    = Get-Lines $catText
+
+    Write-Line " 妯″潡鏁�    $($Mods.Count)"
+    Write-Line " 鎷兼帴      $(Format-N $cat.Length) B   $(Format-N $catLines.Count) 琛�   MD5 $(Get-Md5Hex $cat)"
+    Write-Line " 鍚堝苟      $(Format-N $mergedRaw.Length) B   $(Format-N $mergedLines.Count) 琛�   MD5 $(Get-Md5Hex $mergedRaw)"
+
+    # ---- 1 瀹屾暣鎬�
+    Write-Head '1/5 妯″潡瀹屾暣鎬�'
+    $badMods = 0
+    foreach ($m in $Mods) {
+        if ($m.Errors.Count -eq 0) { $flag = 'OK ' } else { $flag = 'ERR'; $badMods++ }
+        $line = "  $flag [{0}] {1,5} 琛� {2,10} B   {3}" -f $m.Code, $m.LineCount, (Format-N $m.ByteLen), $m.Name
+        Write-Line $line
+        foreach ($e in $m.Errors) { Write-Line "        ! $e" }
+    }
+
+    # ---- 2 姣斿
+    Write-Head '2/5 鎷兼帴涓庢瘮瀵�'
+    $same = $false
+    if ($mergedRaw.Length -eq 0) {
+        Write-Line "  鐘舵��     鍚堝苟鐗堜笉瀛樺湪锛堥娆℃瀯寤猴紵锛夛紝鏃犲熀鍑嗗彲姣� 鈫� 杩愯 build 鐢熸垚"
+        $same = $false
+    } elseif ($cat.Length -eq $mergedRaw.Length) {
+        $same = $true
+        for ($i = 0; $i -lt $cat.Length; $i++) {
+            if ($cat[$i] -ne $mergedRaw[$i]) { $same = $false; break }
+        }
+    } else { $same = $false }
+
+    if ($mergedRaw.Length -eq 0) {
+        # 娌℃湁鍩哄噯鏂囦欢锛岃烦杩囧樊寮傚畾浣�
+    } elseif ($same) {
+        Write-Line "  鐘舵��     涓�鑷达紙閫愬瓧鑺傜浉鍚岋級"
+    } else {
+        $delta = $cat.Length - $mergedRaw.Length
+        $sign = ''
+        if ($delta -ge 0) { $sign = '+' }
+        $blocks = Get-DiffBlocks $mergedLines $catLines
+        Write-Line "  鐘舵��     涓嶄竴鑷达紙鎷兼帴姣斿悎骞剁増 $sign$delta B锛�$($blocks.Count) 涓樊寮傚潡锛�"
+        foreach ($b in $blocks) {
+            $mod = Find-ModuleOfLine $Mods $b.BFrom
+            $head = "    [宸紓] 鍚堝苟鐗� L$($b.AFrom)-$($b.ATo)"
+            if ($null -ne $mod) {
+                $ml = $b.BFrom - $mod.Start + 1
+                $mh = $b.BTo - $mod.Start + 1
+                if ($ml -eq $mh) { $head += "  鈫�  $($mod.Name) 绗� $ml 琛�" }
+                else             { $head += "  鈫�  $($mod.Name) 绗� $ml-$mh 琛�" }
+            }
+            Write-Line $head
+            $n = [Math]::Min($b.A.Count, 3)
+            for ($i = 0; $i -lt $n; $i++) {
+                Write-Line "      鍚堝苟: $($b.A[$i])"
+                Write-Line "      妯″潡: $($b.B[$i])"
+            }
+            if ($b.A.Count -ne $b.B.Count) {
+                Write-Line "      锛堣鏁� $($b.A.Count) 鈫� $($b.B.Count)锛�"
+            }
+        }
+    }
+
+    # ---- 3 琛屽彿琛�
+    Write-Head '3/5 琛屽彿鏄犲皠琛紙妯″潡 鈫� 鍚堝苟鐗堬級'
+    Write-Line "  妯″潡  鍚堝苟鐗堝尯闂�        琛屾暟        瀛楄妭   鏂囦欢鍚�"
+    foreach ($m in $Mods) {
+        $line = "  [{0}] {1,5}-{2,-5} {3,8} {4,12}   {5}" -f $m.Code, $m.Start, $m.End, $m.LineCount, (Format-N $m.ByteLen), $m.Name
+        Write-Line $line
+    }
+    $last = $Mods[$Mods.Count - 1]
+    Write-Line ("  鍚堣  1-{0,-9} {1,8} {2,12}   锛坽3} 涓ā鍧楋級" -f $last.End, $last.End, (Format-N $cat.Length), $Mods.Count)
+
+    # ---- 4 鑷
+    Write-Head '4/5 闈欐�佽嚜妫�'
+    $chk = Invoke-SelfCheck $catLines $Mods
+    Write-Line "  瑙勫垯 $($chk.Rules) 鏉� | 鍒悕 $($chk.Aliases) 涓� | 鍏紡 $($chk.Formulas) 涓� | CONTINUE $($chk.Continue) 澶� | FILTLVL $($chk.FiltLvl) 鏉�"
+    Write-Line "  琛� $(Format-N $chk.Lines) | 瀛楄妭 $(Format-N $cat.Length) | 鍗犱綅绗� $($chk.PhKinds) 绉�"
+    $wlTxt = if ($chk.WlCount -gt 0) { "鐧藉悕鍗� $($chk.WlCount) 鐮�" } else { '鐧藉悕鍗� 鏈姞杞�' }
+    Write-Line "  璇箟  $wlTxt | 姝昏鍒� $($chk.Dead) | 鍏紡寮曠敤 $($chk.FRef)/$($chk.Formulas)锛堟湭寮曠敤 $($chk.FUnused)锛�"
+    Write-Line "  绗﹀彿  瀛ょ珛 % / 鏈棴鍚� % $($chk.Pct) 澶�"
+    if ($chk.Errors.Count -gt 0) {
+        Write-Line ""
+        Write-Line "  閿欒 $($chk.Errors.Count) 椤癸細"
+        foreach ($e in ($chk.Errors | Select-Object -First 30)) { Write-Line "    x $e" }
+    } else {
+        Write-Line ""
+        Write-Line "  鏃犻敊璇紙鎷彿 / 鍗犱綅绗� / 鍒悕閲嶅 / 鐗╁搧浠ｇ爜 / 鍏紡寮曠敤锛�"
+    }
+    if ($chk.Warns.Count -gt 0) {
+        Write-Line ""
+        Write-Line "  鎻愮ず $($chk.Warns.Count) 椤癸紙涓嶉樆鏂級锛�"
+        foreach ($w in ($chk.Warns | Select-Object -First 20)) { Write-Line "    - $w" }
+        if ($chk.Warns.Count -gt 20) { Write-Line "    ... 鍙︽湁 $($chk.Warns.Count - 20) 椤�" }
+    } else {
+        Write-Line "  鏃犳彁绀洪」"
+    }
+
+    # ---- 5 缁撹
+    Write-Head '5/5 缁撹'
+    $ok = $same -and ($chk.Errors.Count -eq 0) -and ($badMods -eq 0)
+    if ($ok) {
+        Write-Line "  閫氳繃锛氬悎骞剁増涓庢ā鍧椾竴鑷达紝鑷鏃犻敊璇��"
+        if ($chk.Warns.Count -gt 0) { Write-Line "  锛堟湁 $($chk.Warns.Count) 椤规彁绀猴紝闈為樆鏂級" }
+    } else {
+        if (-not $same) { Write-Line "  x 妯″潡宸叉敼鍔ㄤ絾鍚堝苟鐗堟湭鏇存柊 鈫� 杩愯 build锛堟垨鍙屽嚮 build.bat 閫� build锛�" }
+        if ($badMods -gt 0) { Write-Line "  x $badMods 涓ā鍧楁湁缂栫爜/鎹㈣闂锛屽厛淇鍐嶆瀯寤�" }
+        if ($chk.Errors.Count -gt 0) { Write-Line "  x 鑷鍙戠幇 $($chk.Errors.Count) 椤归敊璇�" }
+    }
+    Write-Line ""
+
+    if ($Strict) { if ($ok -and $chk.Warns.Count -eq 0) { return 0 } else { return 1 } }
+    if ($ok) { return 0 } else { return 1 }
+}
+
+# ---------------------------------------------------------------- 澶囦唤杞浆
+# 鍙繚鐣欐渶杩� $Keep 浠� BadWolf-LootFilter.txt.<鏃堕棿鎴�>.bak锛堟枃浠跺悕鏃堕棿鎴冲彲鐩存帴鎸夊悕鍊掑簭锛�
+function Remove-OldBackup([int]$Keep) {
+    $dir = Split-Path -Parent $MergedPath
+    $pat = (Split-Path -Leaf $MergedPath) + '.*.bak'
+    $all = @(Get-ChildItem -LiteralPath $dir -Filter $pat -File -ErrorAction SilentlyContinue |
+             Sort-Object Name -Descending)
+    if ($all.Count -le $Keep) { return @() }
+    $gone = @($all | Select-Object -Skip $Keep)
+    foreach ($g in $gone) { Remove-Item -LiteralPath $g.FullName -Force -ErrorAction SilentlyContinue }
+    return $gone
+}
+
+# ---------------------------------------------------------------- build
+function Invoke-Build($Mods) {
+    Write-Line (Get-Bar)
+    Write-Line " BadWolf 杩囨护鍣�  鏋勫缓"
+    Write-Line (Get-Bar)
+
+    $bad = @($Mods | Where-Object { $_.Errors.Count -gt 0 })
+    if ($bad.Count -gt 0) {
+        Write-Line "  [涓] 浠ヤ笅妯″潡瀛樺湪缂栫爜/鎹㈣闂锛�"
+        foreach ($m in $bad) {
+            Write-Line "    $($m.Name)"
+            foreach ($e in $m.Errors) { Write-Line "      ! $e" }
+        }
+        return 1
+    }
+
+    $cat = Join-Bytes $Mods
+    $old = @()
+    if (Test-Path -LiteralPath $MergedPath) { $old = [System.IO.File]::ReadAllBytes($MergedPath) }
+
+    $same = $false
+    if ($old.Length -eq $cat.Length) {
+        $same = $true
+        for ($i = 0; $i -lt $cat.Length; $i++) { if ($cat[$i] -ne $old[$i]) { $same = $false; break } }
+    }
+    if ($same) {
+        Write-Line "  鍚堝苟鐗堝凡鏄渶鏂帮紝鏃犻渶閲嶅缓銆�"
+        Write-Line ""
+        return Invoke-Check $Mods
+    }
+
+    if (-not $NoBackup -and (Test-Path -LiteralPath $MergedPath)) {
+        $stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+        $bak = "$MergedPath.$stamp.bak"
+        Copy-Item -LiteralPath $MergedPath -Destination $bak -Force
+        Write-Line "  宸插浠� 鈫� $(Split-Path -Leaf $bak)"
+        if ($KeepBackups -gt 0) {
+            $gone = @(Remove-OldBackup $KeepBackups)
+            if ($gone.Count -gt 0) {
+                Write-Line "  杞浆   鍒犻櫎鏃у浠� $($gone.Count) 浠斤紙淇濈暀鏈�杩� $KeepBackups 浠斤級锛�$(($gone | ForEach-Object { $_.Name }) -join ', ')"
+            } else {
+                Write-Line "  杞浆   鐜版湁澶囦唤鏈秴杩� $KeepBackups 浠斤紝鏃犻渶鍒犻櫎"
+            }
+        }
+    }
+
+    $tmp = "$MergedPath.tmp"
+    try {
+        [System.IO.File]::WriteAllBytes($tmp, $cat)
+        Move-Item -LiteralPath $tmp -Destination $MergedPath -Force
+    } finally {
+        if (Test-Path -LiteralPath $tmp) { Remove-Item -LiteralPath $tmp -Force -ErrorAction SilentlyContinue }
+    }
+
+    $new = [System.IO.File]::ReadAllBytes($MergedPath)
+    $lineN = ([regex]::Matches([System.Text.Encoding]::UTF8.GetString($new), "\n")).Count
+    Write-Line "  宸插啓鍏� $(Format-N $new.Length) B / $(Format-N $lineN) 琛�  MD5 $(Get-Md5Hex $new)"
+
+    $okWrite = $false
+    if ($new.Length -eq $cat.Length) {
+        $okWrite = $true
+        for ($i = 0; $i -lt $cat.Length; $i++) { if ($new[$i] -ne $cat[$i]) { $okWrite = $false; break } }
+    }
+    if ($okWrite) { Write-Line "  鍐欏叆鏍￠獙閫氳繃锛堥�愬瓧鑺備竴鑷达級" } else { Write-Line "  [閿欒] 鍐欏叆鏍￠獙澶辫触"; return 1 }
+
+    Write-Line ""
+    return Invoke-Check $Mods
+}
+
+# ---------------------------------------------------------------- map
+function Invoke-Map($Mods, [string]$Q) {
+    if ($Q -match ':') {
+        $parts = $Q.Split(':')
+        $code = $parts[0]; $ln = 0
+        if (-not [int]::TryParse($parts[1], [ref]$ln)) { Write-Line "鏃犳硶瑙ｆ瀽琛屽彿锛�$Q"; return 1 }
+        $m = $Mods | Where-Object { $_.Code -eq $code -or $_.Name.StartsWith($code) } | Select-Object -First 1
+        if ($null -eq $m) { Write-Line "鎵句笉鍒版ā鍧楋細$code"; return 1 }
+        if ($ln -lt 1 -or $ln -gt $m.LineCount) { Write-Line "$($m.Name) 鍙湁 $($m.LineCount) 琛�"; return 1 }
+        $merged = $m.Start + $ln - 1
+        Write-Line "$($m.Name) 绗� $ln 琛�  鈫�  鍚堝苟鐗� L$merged"
+        $lines = Get-Lines $m.Text
+        if ($ln -le $lines.Count) { Write-Line "  $($lines[$ln - 1])" }
+        return 0
+    }
+
+    $ln = 0
+    if (-not [int]::TryParse($Q, [ref]$ln)) { Write-Line "鏃犳硶瑙ｆ瀽琛屽彿锛�$Q"; return 1 }
+    $m = Find-ModuleOfLine $Mods $ln
+    if ($null -eq $m) { Write-Line "L$ln 瓒呭嚭鑼冨洿锛�1-$($Mods[$Mods.Count-1].End)锛�"; return 1 }
+    Write-Line "鍚堝苟鐗� L$ln  鈫�  $($m.Name) 绗� $($ln - $m.Start + 1) 琛�"
+    return 0
+}
+
+# ---------------------------------------------------------------- export
+function Invoke-Export($Mods) {
+    $cat = Join-Bytes $Mods
+    $end = $Mods[$Mods.Count - 1].End
+    $sb = New-Object System.Text.StringBuilder
+    [void]$sb.AppendLine('# BadWolf 杩囨护鍣ㄨ鍙锋槧灏勮〃')
+    [void]$sb.AppendLine('')
+    [void]$sb.AppendLine("- 鐢熸垚鏃堕棿锛�$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')")
+    [void]$sb.AppendLine("- 妯″潡鏁帮細$($Mods.Count)")
+    [void]$sb.AppendLine("- 妯″潡鎷兼帴锛�$(Format-N $cat.Length) 瀛楄妭 / $(Format-N $end) 琛� / MD5 ``$(Get-Md5Hex $cat)``")
+    [void]$sb.AppendLine('- 鎹㈢畻锛歚鍚堝苟琛� = 妯″潡璧峰琛� + 妯″潡琛� - 1`')
+    [void]$sb.AppendLine('')
+    [void]$sb.AppendLine('| 妯″潡 | 鍚堝苟鐗堣捣 | 鍚堝苟鐗堟 | 琛屾暟 | 瀛楄妭 |')
+    [void]$sb.AppendLine('|---|---:|---:|---:|---:|')
+    foreach ($m in $Mods) {
+        [void]$sb.AppendLine("| $($m.Name) | $($m.Start) | $($m.End) | $($m.LineCount) | $(Format-N $m.ByteLen) |")
+    }
+    [void]$sb.AppendLine("| **鍚堣** | 1 | $end | $end | $(Format-N $cat.Length) |")
+    [void]$sb.AppendLine('')
+    [void]$sb.AppendLine('## 甯哥敤閿氱偣')
+    [void]$sb.AppendLine('')
+    foreach ($m in $Mods) {
+        if (@('00','09','16','22','28','37','39') -contains $m.Code) {
+            [void]$sb.AppendLine("- ``$($m.Code)`` $($m.Name) 鈫� L$($m.Start)鈥揕$($m.End)")
+        }
+    }
+    $path = Join-Path $Root $MapName
+    [System.IO.File]::WriteAllText($path, $sb.ToString(), (New-Object System.Text.UTF8Encoding($false)))
+    Write-Line "宸插鍑� $path"
+    return 0
+}
+
+# ---------------------------------------------------------------- 涓绘祦绋�
+try {
+    $moduleDir = Get-ModuleDir
+} catch {
+    Write-Line "[閿欒] $($_.Exception.Message)"
+    exit 2
+}
+
+Write-Line (Get-Bar)
+Write-Line " BadWolf 杩囨护鍣ㄦ瀯寤哄伐鍏凤紙PowerShell 鐗堬級"
+Write-Line (Get-Bar)
+Write-Line " 鑴氭湰浣嶇疆  $PSCommandPath"
+Write-Line " 妯″潡鐩綍  $moduleDir"
+Write-Line " 鍚堝苟鐗�    $MergedPath"
+
+$mods = Get-Modules $moduleDir
+if ($mods.Count -eq 0) { Write-Line "[閿欒] 妯″潡鐩綍閲屾病鏈� NN-*.txt 妯″潡鏂囦欢"; exit 2 }
+
+if ($script:SkippedModules.Count -gt 0) {
+    Write-Host ""
+    Write-Host " [璀﹀憡] 浠ヤ笅 txt 涓嶇鍚堛�孨N-鍚嶇О.txt銆嶏紝宸茶烦杩囷紙涓嶄細杩涘叆鍚堝苟鐗堬級锛�" -ForegroundColor Yellow
+    foreach ($n in $script:SkippedModules) { Write-Host "   - $n" -ForegroundColor Yellow }
+    Write-Host "        鑻ユ槸姝ｅ紡妯″潡锛岃鏀瑰悕鎴� 40-xxx.txt 杩欑褰㈠紡銆�" -ForegroundColor Yellow
+}
+
+# 缂栧彿蹇呴』鍞竴锛氫袱涓� 16-xxx.txt 浼氳鍚堝苟鐗堝鍑轰竴鏁存锛屼笖椤哄簭鍙栧喅浜庢枃浠跺悕锛屽繀椤讳汉宸ュ鐞�
+$dupCodes = @($mods | Group-Object Code | Where-Object { $_.Count -gt 1 })
+if ($dupCodes.Count -gt 0) {
+    Write-Line ""
+    Write-Line "[閿欒] 妯″潡缂栧彿閲嶅锛屽凡鍋滄锛堥伩鍏嶆妸涓や唤鍐呭閮芥嫾杩涘悎骞剁増锛夛細"
+    foreach ($g in $dupCodes) {
+        $names = ($g.Group | ForEach-Object { $_.Name }) -join '  /  '
+        Write-Line ("  [$($g.Name)] $names")
+    }
+    Write-Line "  澶勭悊鍔炴硶锛氭妸澶氫綑鐨勯偅浠界Щ鍑烘ā鍧楃洰褰曪紝鎴栨敼鎴愭湭鍗犵敤鐨勭紪鍙枫��"
+    exit 2
+}
+
+switch ($Command.ToLowerInvariant()) {
+    'build'  { exit (Invoke-Build $mods) }
+    'map'    { if ([string]::IsNullOrWhiteSpace($Arg)) { Write-Line "鐢ㄦ硶锛歜uild.bat map 1939    鎴�    build.bat map 16:139"; exit 2 }; exit (Invoke-Map $mods $Arg) }
+    'export' { exit (Invoke-Export $mods) }
+    'check'  { exit (Invoke-Check $mods) }
+    default  { Write-Line "[閿欒] 鏈煡鍛戒护锛�$Command锛堝彲鐢� check / build / map / export锛�"; exit 2 }
+}