安全模型

WindowsHelper 如何保護您的 PC + 手機、我們使用哪些加密技術以及我們明確不防禦哪些內容。最後更新時間：2026 年 4 月 25 日。

配對程式碼生命週期

配對代碼就是所有其他加密操作都由其派生的共享秘密。完整生命週期：

[ 手機產生 8 位隨機配對碼 ]
   ↓
[ 手機將配對碼與 sessionId 寫入 Firestore 的 pc_connections 文件 ]
   ↓
[ 手機在螢幕上向使用者顯示配對碼 ]
   ↓
[ 使用者讀取配對碼，輸入到 Companion 的輸入欄 ]
   ↓
[ Companion 在 Firestore 中查詢與該碼相符的等待中工作階段 ]
   ↓
[ 雙方從 SHA-256(配對碼, sessionId) 衍生加密金鑰 ]
   ↓
[ 配對碼只留在雙方記憶體中，任何一方都不會寫入 Firestore ]
   ↓
[ 中斷連線 / 重新配對會從雙方清除配對碼 ]

• 隨機： 透過加密安全的 RNG 產生的代碼。
• 30 個字元的字母表 × 8 位 ≈ 6560 億種組合。去掉了 I、L、O、Z、0 和 1，是為了避免看錯，而不是出於安全考量——代碼空間足夠密集，在 Firestore 的速率限制下，10 分鐘的暴力破解視窗無法得逞。
• 以加密形式儲存在這台電腦上。 Companion 會把代碼儲存在你 Windows 帳戶的登錄檔中，並以 DPAPI 加密，以便重新啟動後重新連線。
• 會被清除：當你中斷連線並清除工作階段、更換代碼或解除安裝時。關閉應用程式時會保留，以便 Companion 重新連線。

密碼學

AES-256-GCM（命令機密性+完整性）

透過線路發送的每個命令都使用 AES-256-GCM（一種經過身份驗證的加密模式）進行加密。

• 關鍵： 256 位，匯出為 SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce： 96 位元（12 位元組），透過每個訊息新鮮生成 Random.secure() 透過電話或 RandomNumberGenerator 在 Companion 端。
• 授權標籤： 128 位元（16 位元組），附加到密文。
• 電線格式： AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• nonce 不重複使用的安全性：來自 CSPRNG 的 96 位元 nonce，在同一個工作階段金鑰下的 2³² 則訊息範圍內，將生日悖論碰撞機率維持在約 2⁻³² —— 這是隨機 GCM nonce 的標準上限，也遠遠超出任何現實可能的命令量。

HMAC-SHA256（命令真實性）

每個命令還附帶 HMAC 簽名，因此不知道配對代碼的手機即使可以寫入 Firestore，也無法注入命令。

• 關鍵： 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). 與加密金鑰分開。
• 領域範圍： HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). 管道是文字管道字符，而不是分隔符 - 三個連接的字串。
• 驗證順序：HMAC 在解密之前完成驗證。偽造的訊息不會在加密運算上浪費任何一個 CPU 週期。

威脅模型

威脅	狀態	註解
本地網路的竊聽者	緩解	AES-GCM 密文對於 MITM 觀察者來說是不透明的。
Firestore 伺服器上的竊聽者	緩解	Google 看到的是 AESGCM:... 資料區塊，而不是命令。
攻擊者可以寫入 Firestore 但不知道程式碼	緩解	HMAC 驗證失敗；Companion 會記錄這次拒絕並拒絕執行。
破解/網路釣魚配對代碼的攻擊者	殘差	他們可以像用戶一樣發出命令。緩解措施：從托盤選單中旋轉代碼。
重播錄製的命令	殘差	sentAtMillis 與 HMAC 綁定；Companion 尚未強制有效期間，後續修復將加入有效期限。
LAN 模式未經驗證的攻擊者	緩解	WebSocket配對握手驗證碼； HMAC + AES 閘控每個後續命令。
配對密鑰被盜的手機被盜	殘差	與“用戶本身”沒有區別。緩解措施：速率限制（10 cmd/min）+破壞性命令確認需要 PC 端點擊。
從手機應用程式輸入錯誤的命令	緩解	手機端的允許清單會攔截無法識別的前綴；Companion 端的預檢會攔截指向不存在服務的命令。
意外運行破壞性命令	緩解	Companion 端會彈出對話框，必須由使用者點擊才能批准 Remove-Item、Format-Volume、reg delete、shutdown /r 等命令。
暫停/失控的 PowerShell 進程	緩解	每條命令都有時間上限——預設 5 分鐘，長時間執行的修復 45 分鐘，硬上限 60 分鐘——並且會終止整個處理程序樹。
Companion .exe 在下載和執行之間被竄改	緩解	SHA-256 公布在 companion-version.json 中，使用者可以自行核對。Authenticode 簽章計畫在正式推出前完成。
Companion 崩潰洩漏敏感狀態	緩解	崩潰報告 + Firestore 錯誤寫回清理 %USERPROFILE% / %MACHINE% / %USER%.
被竊設備，保留註冊表配對金鑰	緩解	保留的配對代碼使用 Windows DPAPI（每個帳戶）加密，因此無法從複製的磁碟或不同的 Windows 帳戶中讀取。

超出範圍

WindowsHelper 明確不防禦的情況：

• 受損的 Windows 帳戶 運行同伴。我們假設用戶的PC是他們的。在使用者的 PC 上擁有管理員權限的攻擊者已經獲勝。
• 受損的手機應用程式二進位。 我們不會對 Android/iOS 建置進行簽名，以防止超出平台應用程式商店提供的篡改功能。
• 國家級對手：有能力攻破 Google 的 Firestore 或支撐 HTTPS 的憑證授權單位的人。本產品針對的是一般使用者層面的威脅——腳本小子、隨手偷看的人、心懷不滿的家人——而不是政府。
• 透過功耗 / 電磁分析對 AES-GCM 發起的側通道攻擊。Companion 不是智慧卡。

揭露

• 電子郵件 support@windowshelper.app 有主題 [security].
• 請包含版本號碼、重現步驟、影響和理想修復。
• 我們力求在 48 小時內回覆，並在一週內評估嚴重程度。嚴重問題會在常規週期之外單獨發布版本。
• 揭露期限：自初次報告起 90 天，或更早（經雙方同意）。
• 目前沒有支付錯誤賞金——我們在發行說明中向記者表示感謝（經許可）。