dsh-autorestart 0.7.0 → 0.8.1

package/scripts/emergency-toggle.ps1

@@ -1,22 +1,37 @@
-<#
+<#
 .SYNOPSIS
-  dsh-autorestart 的急救开关：DSH 起不来的时候，不用 DSH 也能把本插件摘掉（或装回去）。
+  The dsh-autorestart emergency switch: take this plugin out (or put it back)
+  when DSH does not come up.
 
 .DESCRIPTION
-  “刚打开插件，DSH 就起不来了” 是插件最难受的时刻：修它需要它自己。
-  这个脚本只动一个文件 —— 桌面版 profile 的 package.json —— 而且只动一个数组：
-  `dsh.profile.bundles`。
-
-    - disable：从 bundles 里拿掉 "dsh-autorestart"（本来就不在 → 报告“已经禁用”，不算失败）；
-    - enable ：把 "dsh-autorestart" 加回 bundles（已经在 → 报告“已经启用”）；
-    - status ：只读，打印现在在不在 bundles 里。
-
-  两条硬规矩：
-
-    1. 写之前先备份成 `package.json.bak-emergency-<yyyyMMdd-HHmmss>`；
-    2. 写完之后重新解析一遍 JSON 校验；校验不过就用备份回滚，并且如实报错。
-
-  文件的缩进、行尾和末尾换行都原样保留（改的是文本，不是重新序列化整个 JSON）。
+  "I enabled the plugin and DSH does not start any more" is the hardest moment
+  for a plugin: fixing it needs the plugin itself. This script touches ONE
+  file - the package.json of the desktop profile - and ONE array in it:
+  `dsh.profile.bundles`.
+
+    - disable: take "dsh-autorestart" out of the bundles (it was not there
+      anyway -> report "already disabled", that is not a failure);
+    - enable : put "dsh-autorestart" back into the bundles (it was already
+      there -> report "already enabled");
+    - status : read only, prints whether it is in the bundles right now.
+
+  Two hard rules:
+
+    1. the file is backed up as `package.json.bak-emergency-<yyyyMMdd-HHmmss>`
+       before anything is written;
+    2. after writing, the JSON is parsed again and checked; if the check
+       fails, the backup is put back and the failure is reported honestly.
+
+  The indentation, the line endings and the trailing newline of the file are
+  kept as they are (the text is edited, the JSON is not re-serialized).
+
+  LANGUAGE: this file is pure ASCII on purpose. Windows PowerShell 5.1 reads a
+  UTF-8 file without a byte order mark as ANSI, so one Chinese character
+  inside the script turns into mojibake and the script dies with a ParserError
+  before it does anything. The Chinese wording lives in
+  scripts\rescue-strings.zh.json (UTF-8, no BOM) and is read at runtime; if
+  that file is missing or broken, every message falls back to English and the
+  script says so.
 
 .EXAMPLE
   powershell -NoProfile -ExecutionPolicy Bypass -File .\emergency-toggle.ps1 -Action status
@@ -25,29 +40,76 @@
   powershell -NoProfile -ExecutionPolicy Bypass -File .\emergency-toggle.ps1 -Action disable
 
 .NOTES
-  Windows PowerShell 5.1 就能跑（没有用 6.0+ 的语法），双击的 .cmd 入口也是它。
+  Windows PowerShell 5.1 is enough (nothing from 6.0+ is used); the .cmd entry
+  point double-clicked by the user is that one too.
 #>
 [CmdletBinding()]
 param(
-  # 要做什么。
+  # What to do.
   [ValidateSet('disable', 'enable', 'status')]
   [string] $Action = 'status',
 
-  # 只打印“将会怎么写”，不落盘。
+  # Only print what would be written, change nothing.
   [switch] $DryRun,
 
-  # 要操作的 package.json（测试和别的 profile 用）。
+  # The package.json to work on (for tests and for other profiles).
   [string] $PackageJson = (Join-Path $env:USERPROFILE '.dsh\profiles\desktop\package.json')
 )
 
 $ErrorActionPreference = 'Stop'
 
-# 本插件在 bundles 里的名字。
+# The name of this plugin inside the bundles.
 $PackageName = 'dsh-autorestart'
 
-# 装回去时插在它后面（位置其实无所谓，但有个锚点更稳）。
+# The anchor it is put back after (the position does not matter, but an anchor
+# is steadier than the end of the array).
 $AnchorName = 'dsh-github-guard'
 
+# ---------------------------------------------------------------------------
+# The Chinese strings: read from rescue-strings.zh.json, fall back to English.
+# ---------------------------------------------------------------------------
+
+$script:Strings = $null
+$script:StringsError = ''
+
+function Initialize-Strings {
+  $path = Join-Path $PSScriptRoot 'rescue-strings.zh.json'
+  if (-not (Test-Path -LiteralPath $path -PathType Leaf)) {
+    $script:StringsError = (T 'common.stringsMissingEn' 'the Chinese strings file is missing: {0} (falling back to English messages)') -f $path
+    return
+  }
+  try {
+    # Read as UTF-8 explicitly: Get-Content would use the console code page.
+    $text = [System.IO.File]::ReadAllText($path, [System.Text.Encoding]::UTF8)
+    $script:Strings = $text | ConvertFrom-Json
+  } catch {
+    $script:StringsError = (T 'common.stringsBrokenEn' 'the Chinese strings file could not be read: {0} (falling back to English messages)') -f $_.Exception.Message
+    $script:Strings = $null
+  }
+}
+
+# Look a string up. The English fallback is right here in the script, so a
+# missing key (or a broken strings file) never stops the rescue.
+function T {
+  param([string] $Key, [string] $Fallback)
+  if ($null -ne $script:Strings) {
+    $node = $script:Strings
+    foreach ($part in $Key.Split('.')) {
+      if ($null -eq $node) { break }
+      $property = $node.PSObject.Properties[$part]
+      if ($null -eq $property) { $node = $null; break }
+      $node = $property.Value
+    }
+    if ($null -ne $node) {
+      $text = [string] $node
+      if ($text -ne '') { return $text }
+    }
+  }
+  return $Fallback
+}
+
+Initialize-Strings
+
 function Say {
   param([string] $Text, [string] $Color = 'Gray')
   Write-Host $Text -ForegroundColor $Color
@@ -55,22 +117,22 @@ function Say {
 
 function Fail {
   param([string] $Text)
-  Write-Host ('急救开关失败：' + $Text) -ForegroundColor Red
+  Write-Host ((T 'emergency.failed' 'the emergency switch failed: {0}') -f $Text) -ForegroundColor Red
   exit 1
 }
 
 # ---------------------------------------------------------------------------
-# 文本工具：只在 bundles 数组那一段里动刀，其余字节一个不碰。
+# Text helpers: only the bundles array is touched, every other byte stays.
 # ---------------------------------------------------------------------------
 
-# bundles 数组的方括号位置。
+# The square brackets of the bundles array.
 function Get-ArrayRange {
   param([string] $Text)
   $marker = '"bundles"'
   $markerIndex = $Text.IndexOf($marker)
-  if ($markerIndex -lt 0) { throw 'package.json 里没有 bundles 这一项' }
+  if ($markerIndex -lt 0) { throw 'package.json has no bundles entry' }
   $open = $Text.IndexOf('[', $markerIndex)
-  if ($open -lt 0) { throw 'bundles 不是数组' }
+  if ($open -lt 0) { throw 'bundles is not an array' }
   $depth = 0
   $inString = $false
   $escaped = $false
@@ -89,10 +151,11 @@ function Get-ArrayRange {
       if ($depth -eq 0) { return @($open, $i) }
     }
   }
-  throw 'bundles 数组没有闭合'
+  throw 'the bundles array is not closed'
 }
 
-# 数组里的每一项：名字、缩进、有没有逗号、它在文本里的位置。
+# Every item of the array: the name, the indentation, the comma, the position
+# in the text.
 function Get-Items {
   param([string] $Text, [int] $Open, [int] $Close)
   $body = $Text.Substring($Open + 1, $Close - $Open - 1)
@@ -101,7 +164,7 @@ function Get-Items {
   foreach ($match in [regex]::Matches($body, $pattern)) {
     $lineStart = $Open + 1 + $match.Index
     $lineEnd = $lineStart + $match.Length
-    # 这一行末尾的行尾符（\r\n 或 \n）算在行里。
+    # The line ending of that line (\r\n or \n) belongs to the line.
     if ($lineEnd -lt $Text.Length -and $Text[$lineEnd] -eq "`n") { $lineEnd++ }
     $nameGroup = $match.Groups['name']
     $commaGroup = $match.Groups['comma']
@@ -110,7 +173,8 @@ function Get-Items {
       Indent     = $match.Groups['indent'].Value
       HasComma   = ($commaGroup.Value -eq ',')
       CommaIndex = $commaGroup.Index
-      # 名字后面那个右引号之后的位置（插逗号用）。
+      # The position right after the closing quote of the name (where the
+      # comma goes).
       ContentEnd = $nameGroup.Index + $nameGroup.Length + 1
       LineStart  = $lineStart
       LineEnd    = $lineEnd
@@ -119,7 +183,7 @@ function Get-Items {
   return $items
 }
 
-# 某一行的缩进（用来插出同样式子的新行）。
+# The indentation of a line (so a new line can look the same).
 function Get-LineIndent {
   param([string] $Text, [int] $Index)
   $start = $Text.LastIndexOf("`n", [Math]::Max(0, $Index - 1))
@@ -133,7 +197,7 @@ function Get-LineIndent {
   return $indent
 }
 
-# 文件用的行尾符。
+# The line ending the file uses.
 function Get-LineEnding {
   param([string] $Text)
   if ($Text.Contains("`r`n")) { return "`r`n" }
@@ -141,11 +205,15 @@ function Get-LineEnding {
 }
 
 # ---------------------------------------------------------------------------
-# 开始。
+# Start.
 # ---------------------------------------------------------------------------
 
+if ($script:StringsError -ne '') {
+  Write-Host ('WARNING: ' + $script:StringsError) -ForegroundColor Yellow
+}
+
 if (-not (Test-Path -LiteralPath $PackageJson -PathType Leaf)) {
-  Fail ('找不到 profile 的 package.json：' + $PackageJson)
+  Fail ((T 'emergency.notFound' 'the package.json of the profile cannot be found: {0}') -f $PackageJson)
 }
 
 $path = (Resolve-Path -LiteralPath $PackageJson).Path
@@ -156,7 +224,7 @@ $raw = [System.IO.File]::ReadAllText($path)
 try {
   $document = $raw | ConvertFrom-Json
 } catch {
-  Fail ('这个 package.json 不是合法的 JSON：' + $_.Exception.Message)
+  Fail ((T 'emergency.badJson' 'this package.json is not valid JSON: {0}') -f $_.Exception.Message)
 }
 
 $bundles = @()
@@ -168,20 +236,20 @@ if ($null -ne $document -and $null -ne $document.dsh -and $null -ne $document.ds
 
 $present = ($bundles -contains $PackageName)
 
-Say ('文件：' + $path)
+Say ((T 'emergency.file' 'file: {0}') -f $path)
 
 if ($Action -eq 'status') {
-  if ($present) { Say ('已启用：' + $PackageName + ' 在 bundles 里。') 'Green' }
-  else { Say ('已禁用：' + $PackageName + ' 不在 bundles 里。') 'Yellow' }
+  if ($present) { Say ((T 'emergency.enabled' 'enabled: {0} is in the bundles.') -f $PackageName) 'Green' }
+  else { Say ((T 'emergency.disabled' 'disabled: {0} is not in the bundles.') -f $PackageName) 'Yellow' }
   exit 0
 }
 
 if ($Action -eq 'enable' -and -not $hasBundles) {
-  Fail '这个 profile 里没有 dsh.profile.bundles 列表，装不回去（请手动加一行 "dsh-autorestart"）。'
+  Fail (T 'emergency.noBundles' 'this profile has no dsh.profile.bundles list, so the plugin cannot be put back (please add a line "dsh-autorestart" by hand).')
 }
 
 # ---------------------------------------------------------------------------
-# 算出新的文本。
+# Work out the new text.
 # ---------------------------------------------------------------------------
 
 $new = $raw
@@ -191,14 +259,15 @@ $eol = Get-LineEnding $raw
 
 if ($Action -eq 'disable') {
   if (-not $present) {
-    Say ('已经禁用：bundles 里本来就没有 ' + $PackageName + '（没有改动任何文件）。') 'Yellow'
+    Say ((T 'emergency.alreadyDisabled' 'already disabled: {0} was not in the bundles anyway (no file was changed).') -f $PackageName) 'Yellow'
     exit 0
   }
   $target = $items | Where-Object { $_.Name -eq $PackageName } | Select-Object -First 1
-  if ($null -eq $target) { Fail ('在 bundles 里找不到 ' + $PackageName) }
+  if ($null -eq $target) { Fail ((T 'emergency.notInBundles' '{0} cannot be found in the bundles') -f $PackageName) }
   $shift = 0
   if (-not $target.HasComma) {
-    # 它是数组里的最后一项：前一项的逗号要去掉，否则 JSON 非法。
+    # It is the last item of the array: the comma of the item before it has to
+    # go, otherwise the JSON is invalid.
     $previous = $items | Where-Object { $_.LineEnd -le $target.LineStart } | Select-Object -Last 1
     if ($null -ne $previous -and $previous.HasComma) {
       $new = $new.Remove($previous.CommaIndex, 1)
@@ -206,11 +275,11 @@ if ($Action -eq 'disable') {
     }
   }
   $new = $new.Remove($target.LineStart + $shift, $target.LineEnd - $target.LineStart)
-  $summary = ('把 ' + $PackageName + ' 从 bundles 里拿掉')
+  $summary = (T 'emergency.summaryRemove' 'take {0} out of the bundles') -f $PackageName
 } else {
   # enable
   if ($present) {
-    Say ('已经启用：' + $PackageName + ' 本来就在 bundles 里（没有改动任何文件）。') 'Yellow'
+    Say ((T 'emergency.alreadyEnabled' 'already enabled: {0} was in the bundles anyway (no file was changed).') -f $PackageName) 'Yellow'
     exit 0
   }
   $anchor = $items | Where-Object { $_.Name -eq $AnchorName } | Select-Object -First 1
@@ -221,7 +290,8 @@ if ($Action -eq 'disable') {
       $insertAt = $anchor.LineEnd
       $line = $anchor.Indent + '"' + $PackageName + '",'
     } else {
-      # 锚点是最后一项：先给它补上逗号，再插新的一项（新的这项不带逗号）。
+      # The anchor is the last item: give it a comma first, then insert the new
+      # item (the new one has no comma).
       $new = $new.Insert($anchor.ContentEnd, ',')
       $insertAt = $anchor.LineEnd + 1
       $line = $anchor.Indent + '"' + $PackageName + '"'
@@ -237,39 +307,40 @@ if ($Action -eq 'disable') {
       }
       $line = $last.Indent + '"' + $PackageName + '"'
     } else {
-      # 数组是空的。
+      # The array is empty.
       $insertAt = $range[1]
       $line = (Get-LineIndent $raw $range[1]) + '  "' + $PackageName + '"'
     }
   }
   $new = $new.Insert($insertAt, $line + $eol)
-  $summary = ('把 ' + $PackageName + ' 加回 bundles')
+  $summary = (T 'emergency.summaryAdd' 'put {0} back into the bundles') -f $PackageName
 }
 
 if ($DryRun) {
-  Say ('[试运行] 将会' + $summary + '。') 'Cyan'
-  Say ('[试运行] 将会写入：' + $path) 'Cyan'
-  Say ('[试运行] 将会先备份成：' + $path + '.bak-emergency-<时间戳>') 'Cyan'
-  Say ('[试运行] 没有改动任何文件。') 'Cyan'
+  Say ((T 'emergency.dryRunWill' '[dry run] would {0}.') -f $summary) 'Cyan'
+  Say ((T 'emergency.dryRunWrite' '[dry run] would write: {0}') -f $path) 'Cyan'
+  Say ((T 'emergency.dryRunBackup' '[dry run] would back it up as: {0}.bak-emergency-<timestamp>') -f $path) 'Cyan'
+  Say (T 'emergency.dryRunNoChange' '[dry run] no file was changed.') 'Cyan'
   exit 0
 }
 
 # ---------------------------------------------------------------------------
-# 写：先备份，再写，然后重新解析校验；校验不过就回滚。
+# Write: back up first, write, then parse and check again; on a failure, roll
+# back.
 # ---------------------------------------------------------------------------
 
 $backup = $path + '.bak-emergency-' + (Get-Date -Format 'yyyyMMdd-HHmmss')
 try {
   Copy-Item -LiteralPath $path -Destination $backup -Force
 } catch {
-  Fail ('备份失败（没有动原文件）：' + $_.Exception.Message)
+  Fail ((T 'emergency.backupFailed' 'the backup failed (the original file was not touched): {0}') -f $_.Exception.Message)
 }
 
 try {
   $encoding = New-Object System.Text.UTF8Encoding($hasBom)
   [System.IO.File]::WriteAllText($path, $new, $encoding)
 } catch {
-  Fail ('写入失败（备份在 ' + $backup + '）：' + $_.Exception.Message)
+  Fail ((T 'emergency.writeFailed' 'the write failed (the backup is at {0}): {1}') -f $backup, $_.Exception.Message)
 }
 
 try {
@@ -280,23 +351,23 @@ try {
     $names = @($parsed.dsh.profile.bundles)
   }
   if ($Action -eq 'enable' -and -not ($names -contains $PackageName)) {
-    throw '写完之后 bundles 里仍然没有 ' + $PackageName
+    throw ('after writing, the bundles still do not hold ' + $PackageName)
   }
   if ($Action -eq 'disable' -and ($names -contains $PackageName)) {
-    throw '写完之后 bundles 里仍然有 ' + $PackageName
+    throw ('after writing, the bundles still hold ' + $PackageName)
   }
 } catch {
-  # 校验不过：用备份把原文件放回去，然后如实报错。
+  # The check failed: put the original file back, then report honestly.
   try {
     Copy-Item -LiteralPath $backup -Destination $path -Force
-    Say ('已经用备份回滚：' + $backup) 'Yellow'
+    Say ((T 'emergency.rolledBack' 'the backup was put back: {0}') -f $backup) 'Yellow'
   } catch {
-    Fail ('校验失败，而且回滚也失败了（备份在 ' + $backup + '）：' + $_.Exception.Message)
+    Fail ((T 'emergency.verifyFailedNoRollback' 'the check failed and the rollback failed too (the backup is at {0}): {1}') -f $backup, $_.Exception.Message)
   }
-  Fail ('校验失败（已回滚）：' + $_.Exception.Message)
+  Fail ((T 'emergency.verifyFailedRolledBack' 'the check failed (it was rolled back): {0}') -f $_.Exception.Message)
 }
 
-Say ('已经' + $summary + '。') 'Green'
-Say ('备份：' + $backup) 'Gray'
-Say ('请重启 DSH 才会生效。') 'Gray'
+Say ((T 'emergency.done' 'done: {0}.') -f $summary) 'Green'
+Say ((T 'emergency.backup' 'backup: {0}') -f $backup) 'Gray'
+Say (T 'emergency.restartHint' 'restart DSH for it to take effect.') 'Gray'
 exit 0

package/scripts/rescue-strings.zh.json

@@ -0,0 +1,168 @@
+{
+  "_meta": {
+    "purpose": "User-facing Chinese for the dsh-autorestart rescue kit.",
+    "encoding": "UTF-8 WITHOUT a byte order mark. The .ps1 files next to this one are pure ASCII, so this is the only place a non-ASCII byte may live. A BOM here would break JSON.parse.",
+    "placeholders": "Values may contain {0}, {1} ... placeholders that the scripts fill in with -f formatting.",
+    "fallback": "Every key has an English fallback inside the .ps1. If this file is missing or broken, the scripts say so in English and keep working in English."
+  },
+
+  "common": {
+    "stringsMissing": "中文文案文件不在：{0}（改用英文兜底）",
+    "stringsBroken": "中文文案文件读不出来：{0}（改用英文兜底）",
+    "stringsMissingEn": "the Chinese strings file is missing: {0} (falling back to English messages)",
+    "stringsBrokenEn": "the Chinese strings file could not be read: {0} (falling back to English messages)"
+  },
+
+  "restore": {
+    "title": "dsh-autorestart —— profile 快照还原器",
+    "failPrefix": "还原失败：",
+    "brokenKept": "你原来的 profile 完整地留在这里：{0}",
+    "brokenUntouched": "（这个目录没有被动过，里面还是你出事之前的样子。）",
+    "noProfileDir": "找不到要还原的 profile 目录（用 -ProfileDir 说清楚要还原哪一个）。",
+    "target": "目标 profile：{0}",
+    "targetSuffix": "（目标：{0}）",
+    "onlyProfiles": "只允许还原 {0} 里的 profile（目标：{1}）",
+    "missingDir": "目标 profile 目录不存在：{0}（还原需要那个目录已经在那儿；脚本不会为了还原去新建一个 profile 目录）",
+    "notProfile": "{0}（目标：{1}）。拒绝动手 —— 免得把不是 profile 的目录弄坏。",
+    "notProfileSuffix": "。拒绝动手 —— 免得把不是 profile 的目录弄坏。",
+    "brokenNotice": "这个 profile 已经坏了：{0}",
+    "backupsDir": "快照目录：{0}",
+    "usingSnapshot": "要用快照：{0}（{1}）",
+    "snapshotMissing": "找不到这份快照：{0}",
+    "snapshotNoManifest": "这份快照没有 manifest.json，不是一份快照：{0}",
+    "snapshotSuffix": "{0}（快照：{1}）",
+    "dryRunMove": "[试运行] 会先把现在的 profile 挪到：{0}",
+    "dryRunCopy": "[试运行] 会把 {0} 里的配置和插件复制回：{1}",
+    "dryRunVerify": "[试运行] 会回读校验 package.json / dsh.profile.bundles / {0} 的版本号。",
+    "dryRunNoChange": "[试运行] 没有改动任何文件。",
+    "moveFailed": "挪走现在的 profile 失败（没有动任何东西）：{0}",
+    "moved": "原来那份已经挪到：{0}",
+    "noProfileBefore": "原来那个 profile 目录本来就不在，直接新建。",
+    "copyFailed": "把快照复制回去失败（原来那份还在：{0}）：{1}",
+    "checkOk": "  [好] {0} —— {1}",
+    "checkSkipped": "  [跳过] {0} —— {1}",
+    "checkBad": "  [坏] {0} —— {1}",
+    "verifyFailed": "还原后的 profile 没通过校验（{0}）。",
+    "noteWithPlugins": "（含插件）",
+    "noteNoPlugins": "（只有配置文件，没有插件）",
+    "done": "已还原到 {0} 的快照{1}；现在可以重新打开 DSH。",
+    "brokenLeft": "原来那份留在了：{0}（确认没问题之后可以自己删掉它）",
+
+    "gateEmptyPath": "目标路径是空的",
+    "gateDriveRoot": "拒绝动盘符根目录",
+    "gateFsRoot": "拒绝动文件系统根目录",
+    "gateHome": "拒绝动用户主目录本身",
+    "gateSystemDir": "拒绝动系统目录：{0}",
+    "gateOtherUser": "拒绝动别人的用户目录",
+
+    "fingerprintNotProfile": "这里没有 package.json —— 不像 DSH profile",
+    "fingerprintProfile": "profile 的 package.json 里有 dsh.profile",
+    "fingerprintBrokenNoDsh": "profile 坏了（package.json 不再是 profile），但 profile 的文件还在",
+    "fingerprintBrokenNoPkg": "profile 坏了（package.json 没了），但 profile 的文件还在",
+    "fingerprintNotDshProfile": "package.json 里没有 dsh.profile，也没有别的东西能证明这是 profile",
+
+    "snapshotDirMissing": "找不到快照目录：{0}",
+    "snapshotNone": "这个目录里没有一份带 manifest 的快照：{0}",
+    "snapshotNoConfigPkg": "这份快照里没有 config\\package.json",
+    "snapshotBadConfigPkg": "这份快照的 package.json 不是合法的 JSON",
+    "snapshotNoDshProfile": "这份快照的 package.json 里没有 dsh.profile",
+    "snapshotIsProfile": "这份快照里装的是一个 DSH profile",
+    "snapshotUnknownTime": "时间不明",
+
+    "verifyPkgLabel": "package.json 能解析",
+    "verifyPkgMissing": "package.json 不存在",
+    "verifyPkgBad": "不是合法的 JSON",
+    "verifyBundlesLabel": "dsh.profile.bundles 有内容",
+    "verifyBundlesCount": "{0} 个",
+    "verifyBundlesEmpty": "没有 dsh.profile.bundles，或者它是空的",
+    "verifyPluginLabel": "{0} 的版本号读得到",
+    "verifyPluginNotDeclared": "这个 profile 没有声明要装 {0}（没什么可读）",
+    "verifyPluginMissing": "profile 里写着要装 {0}，但 node_modules\\{0} 不在 —— 配置说一套、磁盘是另一套",
+    "verifyPluginNoVersion": "读不到版本号"
+  },
+
+  "drill": {
+    "dir": "演练目录：{0}",
+    "broke": "已经故意弄坏：package.json 写成非法 JSON，插件目录删掉了。",
+    "outputHeader": "--- 还原脚本的输出（{0}）---",
+    "outputEnd": "--- 输出结束 ---",
+    "assertions": "断言：",
+    "assertPass": "  [通过] {0}",
+    "assertFail": "  [失败] {0} —— {1}",
+    "assertFailPlain": "  [失败] {0}",
+    "refusedNoResult": "  [失败] {0} —— 没有拿到运行结果",
+    "refusedNotRefused": "  [失败] {0} —— 退出码是 0，脚本根本没有拒绝",
+    "refusedNoReason": "  [失败] {0} —— 退出码是 {1}，但输出里没有拒绝原因（期望其中之一：{2}）",
+    "refusedOk": "  [通过] {0} —— 退出码 {1}，输出里有拒绝原因「{2}」",
+    "cleanup": "清理临时目录：{0}",
+    "cleaned": "临时目录已清理干净。",
+    "notCleaned": "临时目录没有清理干净，请自己删掉：{0}",
+    "failed": "演练失败：{0} 条断言没过。",
+    "passed": "演练全部通过：故意弄坏 → 还原 → 校验 → 清理，一整圈跑通了。",
+    "error": "演练出错：{0}",
+    "noScript": "演练失败：找不到 {0}",
+    "dirOccupied": "演练失败：这个演练目录已经被占用了：{0}",
+
+    "assertDryRunExit": "试运行退出码是 0",
+    "assertDryRunUntouched": "试运行没有改动 package.json",
+    "assertDryRunNoBroken": "试运行没有留下 broken 目录",
+    "assertRestoreExit": "还原退出码是 0",
+    "assertChineseOutput": "还原脚本的输出里有中文（文案是从 JSON 读的）",
+    "assertParses": "还原后 package.json 能解析",
+    "assertUsedSnapshot": "用的是带 manifest 的那份快照（跳过了更新的诱饵）",
+    "assertBundles": "还原后 dsh.profile.bundles 有内容",
+    "assertVersionReadable": "还原后插件版本读得到",
+    "assertVersionSame": "插件版本是快照里的那一个",
+    "assertBrokenExists": "broken 证据目录存在",
+    "assertBrokenKeeps": "broken 目录里保留的还是坏掉的那份",
+    "assertNotProfileRefused": "不像 profile 的目录被拒绝（退出码 + 拒绝原因）",
+    "assertNotProfileUntouched": "被拒绝的时候没有动那个目录",
+    "assertDriveRootRefused": "盘符根目录被拒绝（退出码 + 拒绝原因）",
+    "assertSystemDirRefused": "系统目录 {0} 被拒绝（退出码 + 拒绝原因）",
+    "assertSystemDirIntact": "系统目录 {0} 原封不动（没被挪走）",
+    "assertMissingDirRefused": "目标 profile 目录不存在时被拒绝（退出码 + 拒绝原因）",
+    "assertMissingDirNotCreated": "目标目录不存在时没有把它创建出来",
+    "assertLyingRefused": "声明了插件却没装 → 还原必须失败（退出码 + 拒绝原因）",
+    "assertLyingBrokenHint": "声明了插件却没装 → 明确说 broken 目录还在",
+    "assertPs1Ascii": "restore-profile.ps1 是纯 ASCII（maxByte <= 127）",
+    "assertCmdAscii": "restore-profile.cmd 是纯 ASCII",
+    "assertOnlyTemp": "演练只在临时目录里动手（broken 目录在临时目录下面）",
+    "assertLockFile": "演练目录里有锁文件",
+
+    "keywords": {
+      "notProfile": ["不像", "不是 profile"],
+      "driveRoot": ["盘符", "根目录"],
+      "systemDir": ["系统目录", "不允许"],
+      "missingDir": ["不存在"],
+      "notValidated": ["没通过校验", "校验"],
+      "dryRun": ["试运行"]
+    }
+  },
+
+  "emergency": {
+    "failed": "急救开关失败：{0}",
+    "notFound": "找不到 profile 的 package.json：{0}",
+    "badJson": "这个 package.json 不是合法的 JSON：{0}",
+    "file": "文件：{0}",
+    "enabled": "已启用：{0} 在 bundles 里。",
+    "disabled": "已禁用：{0} 不在 bundles 里。",
+    "notInBundles": "在 bundles 里找不到 {0}",
+    "alreadyDisabled": "已经禁用：bundles 里本来就没有 {0}（没有改动任何文件）。",
+    "alreadyEnabled": "已经启用：{0} 本来就在 bundles 里（没有改动任何文件）。",
+    "noBundles": "这个 profile 里没有 dsh.profile.bundles 列表，装不回去（请手动加一行 \"dsh-autorestart\"）。",
+    "dryRunWill": "[试运行] 将会{0}。",
+    "dryRunWrite": "[试运行] 将会写入：{0}",
+    "dryRunBackup": "[试运行] 将会先备份成：{0}.bak-emergency-<时间戳>",
+    "dryRunNoChange": "[试运行] 没有改动任何文件。",
+    "backupFailed": "备份失败（没有动原文件）：{0}",
+    "writeFailed": "写入失败（备份在 {0}）：{1}",
+    "rolledBack": "已经用备份回滚：{0}",
+    "verifyFailedNoRollback": "校验失败，而且回滚也失败了（备份在 {0}）：{1}",
+    "verifyFailedRolledBack": "校验失败（已回滚）：{0}",
+    "done": "已经{0}。",
+    "backup": "备份：{0}",
+    "restartHint": "请重启 DSH 才会生效。",
+    "summaryRemove": "把 dsh-autorestart 从 bundles 里拿掉",
+    "summaryAdd": "把 dsh-autorestart 加回 bundles"
+  }
+}

package/scripts/restore-profile.cmd

@@ -0,0 +1,44 @@
+@echo off
+rem dsh-autorestart - restore the profile snapshot.
+rem
+rem Double-click this file when DSH does not start any more (a plugin upgrade
+rem broke the profile, the configuration was damaged, node_modules is a mess):
+rem it puts the newest snapshot that carries a manifest back over the profile.
+rem
+rem What it does, in this order:
+rem   1. finds the newest snapshot with a manifest under <stateDir>\backups
+rem   2. MOVES the current profile to <profile>\.broken-<timestamp> (nothing is
+rem      deleted, the evidence stays)
+rem   3. copies the configuration files and the plugin tree back
+rem   4. reads the result back: package.json, dsh.profile.bundles and the
+rem      version of dsh-autorestart have to be readable
+rem
+rem It never restarts DSH for you - you do that yourself.
+rem
+rem Optional arguments are passed straight to the PowerShell script, e.g.
+rem   restore-profile.cmd -DryRun
+rem   restore-profile.cmd -ProfileDir C:\temp\drill\profile -StateDir C:\temp\drill\state
+rem
+rem NOTE: this file is ASCII on purpose. cmd.exe reads a batch file with the
+rem console code page, and a UTF-8 character in it would shift the rest of the
+rem line and be run as a command. The Chinese explanation comes from the
+rem PowerShell script below (and from scripts\README.md).
+setlocal
+set "SCRIPT=%~dp0restore-profile.ps1"
+if not exist "%SCRIPT%" (
+  echo Cannot find "%SCRIPT%".
+  echo The rescue kit is incomplete - keep the plugin folder together.
+  pause
+  exit /b 1
+)
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT%" %*
+set "RC=%ERRORLEVEL%"
+echo.
+if "%RC%"=="0" (
+  echo Done. The result is above - open DSH again.
+) else (
+  echo The restore did NOT finish. Read the red lines above.
+  echo Your old profile was not deleted - it is kept as a ".broken-<timestamp>" folder.
+)
+pause
+exit /b %RC%