docs: fix bilingual download guidance

Author: DESKTOP-HA04FD6\Admin

docs/AI_INTEGRATION.en.md

@@ -143,7 +143,7 @@ For normal reads, use the `nextCursor` and `resumeReceipt` returned by the servi
 Use the following only when explicitly accepting that continuity cannot be verified:
 
 ```text
---after-sequence <十进制序号> --allow-unverified-seek
+--after-sequence <decimal-sequence-number> --allow-unverified-seek
 ```
 
 This type of read may omit or duplicate events, or cross a range that cannot be proven. Its result must be marked as an unverified seek.

docs/INSTALL.md

@@ -28,14 +28,14 @@
 只从本项目 GitHub Releases 页面下载安装包。发布页同时提供 `SHA256SUMS.txt`，可选地用 PowerShell 核对：
 
 ```powershell
-Get-FileHash '.\Lemon串口监控-安装程序-x64.exe' -Algorithm SHA256
+Get-FileHash '.\LemonSerialMonitor-Setup-x64.exe' -Algorithm SHA256
 ```
 
 显示的 SHA-256 应与同一版本发布页一致。文件来源或哈希不一致时不要运行。
 
 ## 一键安装
 
-1. 双击 `Lemon串口监控-安装程序-x64.exe`。
+1. 双击 `LemonSerialMonitor-Setup-x64.exe`。
 2. Windows 显示 SmartScreen 或“用户账户控制”时，只在下载来源和 SHA-256 与同版 Release 一致后继续。
 3. 完整阅读“本地测试证书使用说明”，勾选接受后继续。
 4. 选择桌面程序安装位置。默认是：

docs/TROUBLESHOOTING.en.md

@@ -122,7 +122,7 @@ Export processes the full persisted session, not only the selected rows. To copy
 First run:
 
 ```powershell
-& '<安装目录>\ai\Lemon.SerialMonitor.AI.exe' status --json
+& '<installation-directory>\ai\Lemon.SerialMonitor.AI.exe' status --json
 ```
 
 Check:

scripts/Test-BilingualDocs.ps1

@@ -116,10 +116,18 @@ foreach ($relativePath in $documents.Keys) {
 }
 
 $installerAssetName = 'LemonSerialMonitor-Setup-x64.exe'
-if ($documents['README.md'].IndexOf(
-        $installerAssetName,
-        [StringComparison]::Ordinal) -lt 0) {
-    throw "README.md must contain installer asset name $installerAssetName"
+$installerDownloadPaths = @(
+    'README.md',
+    'README.en.md',
+    'docs/INSTALL.md',
+    'docs/INSTALL.en.md'
+)
+foreach ($relativePath in $installerDownloadPaths) {
+    if ($documents[$relativePath].IndexOf(
+            $installerAssetName,
+            [StringComparison]::Ordinal) -lt 0) {
+        throw "$relativePath must contain installer asset name $installerAssetName"
+    }
 }
 
 $englishCorpus = @(

tests/powershell/BilingualDocs.Tests.ps1

@@ -27,6 +27,14 @@ $safetyTerms = @(
     'not hardware certification'
 )
 
+$installerAssetName = 'LemonSerialMonitor-Setup-x64.exe'
+$installerDownloadPaths = @(
+    'README.md',
+    'README.en.md',
+    'docs/INSTALL.md',
+    'docs/INSTALL.en.md'
+)
+
 function Write-TestUtf8File {
     param(
         [Parameter(Mandatory)][string] $Path,
@@ -51,14 +59,17 @@ function New-BilingualDocsFixture {
             '# Chinese fixture',
             "[English]($englishBaseName)"
         )
-        if ($pair.Key -eq 'README.md') {
-            $chineseLines += 'Download LemonSerialMonitor-Setup-x64.exe.'
+        if ($script:installerDownloadPaths -contains $pair.Key) {
+            $chineseLines += "Download $script:installerAssetName."
         }
 
         $englishLines = @(
             '# English fixture',
             "[Chinese]($chineseBaseName)"
         )
+        if ($script:installerDownloadPaths -contains $pair.Value) {
+            $englishLines += "Download $script:installerAssetName."
+        }
         if ($pair.Value -eq 'README.en.md') {
             $englishLines += $script:safetyTerms
         }
@@ -165,20 +176,28 @@ Describe 'Bilingual documentation guard' {
         $message | Should Match 'UTF-8'
     }
 
-    It 'rejects the wrong installer asset name in README.md' {
-        $root = Join-Path $TestDrive 'wrong-installer'
+    It 'rejects the wrong installer asset name in <RelativePath>' -TestCases @(
+        @{ RelativePath = 'README.md' },
+        @{ RelativePath = 'README.en.md' },
+        @{ RelativePath = 'docs/INSTALL.md' },
+        @{ RelativePath = 'docs/INSTALL.en.md' }
+    ) {
+        param([string] $RelativePath)
+
+        $fixtureName = $RelativePath -replace '[^A-Za-z0-9]', '-'
+        $root = Join-Path $TestDrive ('wrong-installer-' + $fixtureName)
         New-BilingualDocsFixture -Root $root
-        $readmePath = Join-Path $root 'README.md'
-        $readme = [IO.File]::ReadAllText($readmePath)
+        $documentPath = Join-Path $root $RelativePath
+        $document = [IO.File]::ReadAllText($documentPath)
         Write-TestUtf8File `
-            -Path $readmePath `
-            -Content $readme.Replace(
-                'LemonSerialMonitor-Setup-x64.exe',
+            -Path $documentPath `
+            -Content $document.Replace(
+                $installerAssetName,
                 'LemonSerialMonitor-Setup.exe')
 
         $message = Get-BilingualGuardError -Root $root
 
-        $message | Should Match 'README\.md'
+        $message | Should Match ([regex]::Escape($RelativePath))
         $message | Should Match 'LemonSerialMonitor-Setup-x64\.exe'
     }