情境:使用GEMINI CLI技術基底，進行中文處理操作，但AI_TUTOR不一定能完全掌握使用者端OS作業環境，而筆者是採用PowerShell做為啟用GEMINI CLI基底，但常有PYTHON程式在處理過程中，會將現有運作中之檔案編碼(預設為UTF-8)，因操作讀取關係直接將亂碼混入處理之檔案(如:*.MD、*.PY等)，所以下方資訊將有助於AI_TUTOR代理人，掌握運作中環境，將有助於改善亂碼亂入情形。
## 1. 使用者環境設定GEMINI.MD (位於 %USERPROFILE%\.gemini)，因為AI代理人會於載入系統時，讀取個人環境資訊，如果設定不同語言，它將會容易語義偏移發生可能。
## Gemini Added Memories - My preferred editor, Notepad++, is located at 'D:\Program Files\Notepad++\notepad++.exe'
- ユーザーの好きなプログラミング言語はPythonです。
- User prefers Traditional Chinese (繁體中文) for all communications. Do not use Japanese.
2. 編碼衝突架構分析 (Technical Taxonomy)
技術行為 | 技術根因 (Why) | 物理後果 / 修正建議
---------------------------|-----------------------------------------|--------------------------------------------
UTF-8-SIG (BOM) | 帶有 0xEF 0xBB 0xBF 之萬國碼簽章。 | [修正] 這是 Win32 護盾。能強制 PowerShell/CMD 正確識別中文，防止誤判為 CP950。
UTF-8 No-BOM | 缺乏顯式編碼標籤。 | [風險] 在 Win32 CLI 下極易產生物理亂碼 (憿?)，導致 RAG 索引失效。
PS 5.1 導向禁忌 | 使用 >> 會強制附加 CP950 編碼。 | 破壞 Python 線性讀取，導致 UnicodeDecodeError。嚴禁使用。
Python open() 缺省 | Win32 預設為 CP950。 | 導致環境行為不對稱。必須顯式聲明 encoding='utf-8-sig'。
BOM 物理定錨 | 作為資產誠信的「合法指紋」。 | [修正] 系統啟動時必須驗證 BOM。無 BOM 資產將被判定為「誠信斷裂」。
忽略 chcp 65001 | 活動字碼頁對管道具有強制約束力。 | Subprocess 輸出被強制轉換為 CP950，引發解析亂碼。
物理字元降級 (0x3f)| 在 CP950 環境下對 UTF-8 執行 Replace | [致命] 中文被物理替換為 "?"，導致語義不可逆損毀。
### 2.1 UTF-8-SIG 實務應用與橋接邏輯 在 Win32 複雜環境中，編碼處理遵循**架構規範**中的橋接邏輯：
* 實務場景 (Win32 PowerShell)：- 當產出數據供 Excel、Notepad、PowerShell 直接開啟時，UTF-8-SIG 是必要的物理門禁。
- 具備 BOM 後，PowerShell 5.1 會自動以 UTF-8 解析內容，不再需要複雜的 chcp 切換。
* 橋接邏輯 (The Bridge Logic)：
- 輸入誠信 (Read)：系統必須使用 encoding='utf-8-sig' 讀取，以自動剥離 BOM 並確保字串純淨。
- 輸出硬化 (Write)：核心資產 (MD, PY, JSONL) 必須強制使用 encoding='utf-8-sig' 寫入。
- 規範定義：「讀寫均用 SIG，物理鎖定 BOM」。
## 3.治理參考 (Governance Framework)，處理符合以下防禦性要求：
* 強制編碼聲明：凡涉及檔案 I/O，必須顯式定義 encoding='utf-8-sig'，嚴禁依賴 locale 缺省值。* 物理硬化機制：系統偵測到遺失 BOM (0xEF 0xBB 0xBF) 時，應立即啟動「自動轉碼」程序，標準化為 UTF-8-SIG。
* 管道免疫規範：執行跨進程調用 (Subprocess) 前，確保活動字碼頁已鎖定為 65001。
## 4. Win32 環境標準應對 Check-list
[V] I/O 審查：確認 open() 均包含 encoding='utf-8-sig'。讀取時利用 SIG 自動處理 BOM 剝離。[V] PowerShell 版本過濾：針對 PowerShell 5.1，確保 Out-File 產出的內容需再經過 額外檢核PYTHON程式進行處理。
[V] Excel 兼容性：所有 CSV 與報告輸出預設採用 UTF-8-SIG。
[V] Shell 替代方案：嚴禁使用 >>。
[V] 流解析校驗：讀取數據流前，確認字節偏移 0 處具備 BOM 特徵碼。
[V] 環境鎖定：啟動腳本首行強制執行 chcp 65001。
文字化け(Mojibake)其它資訊:
encode文字編碼查詢
