mcpField
W
windows-rescue-from-linux

windows-rescue-from-linux

github.com/timlai666その他040 回インストール今日更新
リポジトリ

windows-rescue-from-linux について

windows-rescue-from-linux は、Linux 救援環境から起動不能などの Windows を診断し、データを救出して原因に応じて修復するスキルです。ディスクの特定、読み取り専用での確認、バックアップと検証を重視し、Windows 標準ツールによる修復は WinRE に引き継ぎます。

主な機能

  1. 01Windows 救援ドライブの準備
  2. 02Windows と EFI パーティションの特定
  3. 03パーティションの読み取り専用マウント
  4. 04症状に応じた診断と修復の案内
  5. 05ファイル救出とイメージからの抽出
  6. 06変更と救援結果の確認

活用シーン

  1. 01故障した Windows ディスクからのデータ救出
  2. 02起動またはファイルシステム問題の診断
  3. 03イメージからの破損システムファイルの置換
  4. 04すぐ使える救援ドライブの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/timlai666/skills --skill windows-rescue-from-linux

インストール後、Claude Code で/windows-rescue-from-linuxを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
00-rescue-usb-preparation.md
01-safety-principles.md
02-symptom-triage.md
03-mount-windows.md
04-boot-repair.md
05-filesystem-repair.md
06-registry-edit.md
07-malware-cleanup.md
08-data-recovery.md
09-hardware-diagnostics.md
10-bitlocker.md
11-driver-and-update-issues.md
12-profile-corruption.md
13-when-linux-cannot-fix.md
14-cli-tools-catalog.md
15-image-file-replacement.md
scripts/
backup-user-data.sh
boot-diagnostic.sh
bootstrap-check.sh
disk-health-report.sh
identify-windows-volumes.sh
install-rescue-tools.sh
malware-quick-scan.sh
mount-windows-safe.sh

詳細

プロジェクトの README より

Windows 救援工具箱(從 Linux 救援系統 修 Windows)

Overview

從 Linux 救援系統 診斷無法正常使用的 Windows,救出資料並依原因修復。也能準備救援碟,或從 Windows 映像提取個別檔案、替換故障系統中的損壞檔案。需要 Windows 原生修復工具時,交接到 WinRE。

Input Contract

先從對話與現有資料確認目標:準備救援碟、只救資料,或修復 Windows。實機救援需要知道卡住的畫面與錯誤代碼、最近變更、重要資料與備份位置,以及 Linux、Windows 磁碟和可用映像在哪裡。只補問會影響下一步的缺項,已有資訊直接沿用。

Workflow

1. 依目標進入
  • 準備救援碟:讀 00-rescue-usb-preparation.md。使用者同意製作並確認目標 USB 與清除範圍後,由 AI 完成下載、工具準備、原有資料完整備份、USB 完整系統安裝、工具預裝與開機驗證;備份驗證通過後才清除 USB。交付目標是插入相容電腦即可使用,不能以 Live USB 代替或把工具安裝留到救援現場。這是獨立任務,不先要求故障電腦的症狀。
  • 實機救援:先讀 01-safety-principles.md,確認目標磁碟、備份與硬體狀態。只需救資料時,完成資料驗證即可交付。
  • 缺工具或不確定用哪個:讀 14-cli-tools-catalog.md,檢查本次會用的工具。可用 bash scripts/bootstrap-check.sh 盤點,缺少無關工具不阻擋救援。Node.js 與 AI CLI 只在使用者要於救援碟上執行它們時準備。
2. 先辨識磁碟,再掛載

用 lsblk、blkid 與裝置型號、序號、UUID 對應 Windows 碟、救援 USB、備份碟。分割區大小與標籤只能當線索,還要核對 Windows 目錄、ESP 類型與開機項指向。

有異音、讀取卡住、I/O 錯誤或健康警示時,先讀 08-data-recovery.md 評估映像救援,停止一般全碟掃描與原碟修復。SMART 無法取得時標為未知。

BitLocker 先讀 10-bitlocker.md 解鎖。一般掛載讀 03-mount-windows.md,第一次唯讀。Linux 自己的 UEFI/Legacy 開機模式不能單獨判定 Windows 的安裝模式。

3. 依症狀查閱與修復

只讀本案相關參考。多重症狀或原因不明時讀 02-symptom-triage.md,以日誌與檢查結果縮小原因。

症狀或需求何時讀哪份參考
壞碟、分割區讀不出、只救資料、救已刪檔案08 資料救援,區分檔案備份、映像與刪除檔救援
BOOTMGR missing、Windows Boot Manager 不見、BCD/EFI 損壞、雙系統選單異常04 開機修復
NTFS 掛載失敗、容量異常、分割表或檔案系統錯誤05 檔案系統修復
忘記本機密碼、帳號鎖定、修改服務或 registry06 Registry 編輯,寫入前備份整個 hive
中毒、瀏覽器綁架、不明自動啟動07 惡意軟體清理,先掃描再判斷處置
隨機當機、RAM/CPU/磁碟健康疑慮09 硬體診斷
更新後無限重啟、疑似 driver 問題、INACCESSIBLE_BOOT_DEVICE11 驅動與更新,依證據選擇修復
暫存設定檔、使用者設定檔服務登入失敗12 設定檔修復
系統組件損壞或遺失、有 ISO/WIM/ESD/SWM 或備份映像可取檔15 映像檔案替換,辨識來源、提取個別檔案並驗證替換
需要 SFC、DISM、正式安裝 driver、重建 BCD 或重設系統13 Windows 修復工具交接

修復前依 01 安全準則 保存重要資料及受影響檔案/結構。說明確切修改與還原方式,沿用已授權範圍,不逐個 sudo 或同一操作重複確認。

映像來源優先選與目標相符的版本。版本不符或無法完整確認時,也可說明差異、可能無效或引入新故障,讓使用者選擇備份後嘗試。依 15 保留可還原的替換路徑,不承諾一定能開機。

4. 驗證與交付

按改動檢查結果:檔案替換比對內容、hive 修改核對目標值與其他值、EFI 修復核對檔案與開機項、備份核對命令結果及可讀性。ntfsfix 寫入屬於修復,不是通用驗證。修檔案系統前先卸載。

完成寫入後正常卸載,再測試 Windows 開機與原故障。無法現場開機時明確列為待驗證。測試失敗先還原本次試改、重新診斷,不重複相同修法或接連換多個版本。

Scripts

在 skill 資料夾執行,先看腳本的參數與輸出位置。腳本只協助操作,不能代替本案診斷。

腳本用途
bootstrap-check.sh盤點環境與工具,不安裝
install-rescue-tools.sh依選定範圍安裝工具,準備救援碟時使用
identify-windows-volumes.sh找 Windows、EFI、Recovery 候選分割區
mount-windows-safe.sh唯讀掛載 Windows 分割區
backup-user-data.sh把指定掛載點的使用者資料備份到另一個目的地
disk-health-report.sh讀取磁碟健康資訊與檢查限制
boot-diagnostic.sh收集開機檔案、EFI、registry 與日誌線索
malware-quick-scan.sh掃描常見位置並報告偵測結果,預設不移動檔案

Output Contract

回報診斷依據、實際修改、備份/還原位置、驗證結果及尚未解決的問題。救援紀錄保存在使用者指定的外接碟或其他可持續保存的位置,供使用者或接手技師閱讀。腳本暫存在 /tmp 的報告須於重開前轉存;不把金鑰或密碼寫進紀錄。

Quality Rules

  • 先唯讀,壞碟先映像,無法解鎖的 BitLocker 不當一般 NTFS 修。
  • 從症狀判斷原因,檔名、時間、錯誤代碼與掃描命中都需要上下文。
  • 映像提取成功、檔案複製成功與恢復開機分別驗證,不互相代替。
  • tmux 能維持 SSH 斷線後的程序;不能防止斷電或 Live USB 當機。映像續作靠持續保存的 mapfile。

コメント