Windows 終端環境

Windows 自帶的傳統控制台（cmd.exe / conhost）預設字型不含 emoji 與 Nerd Font 圖示字形， 也不支援真彩色，所以 zqagent 在這裡只能降級顯示：✅ 變成 [OK]、表格邊框退化為 ASCII、 顏色偏暗淡。功能不受影響，但觀感與 Linux / macOS 差一截。

本頁給出推薦設定，以及 zqagent 內建的自動引導。

推薦設定

層次	推薦	說明
終端	Windows Terminal	真彩色、GPU 加速、標籤頁與分屏，可同時承載 cmd / PowerShell / WSL
字型	Nerd Font（等寬）	補全圖示字形，如 JetBrainsMono Nerd Font
Shell	PowerShell 7 或 Git Bash	指令碼體驗更接近 Linux
提示符	oh-my-posh / starship	圖示化提示符與 git 狀態

1. 安裝 Windows Terminal

方式 A（推薦，Win10 1809+ 自帶 winget）：

winget install --id Microsoft.WindowsTerminal -e --accept-source-agreements --accept-package-agreements

方式 B：開啟「Microsoft Store」，搜尋 Windows Terminal 安裝。

2. 安裝 Nerd Font

winget install --id DEVCOM.JetBrainsMonoNerdFont -e --accept-source-agreements --accept-package-agreements

等價字型任選其一（包名可用 winget search nerd 查）：CaskaydiaCove Nerd Font、 FiraCode Nerd Font、Hack Nerd Font。也可以到 Nerd Fonts 官網 下載，解壓後右鍵字型檔案 →「為所有使用者安裝」。

注意：Nerd Font 不等於普通的 JetBrains Mono。裝完要在終端裡選帶 Nerd Font 字尾的那一款，否則圖示仍是方塊。

3. 設為預設終端

Windows Terminal → 設定 → 啟動 →「預設終端應用程式」→ 選 Windows Terminal。 此後從 cmd.exe / PowerShell 啟動的也會進入 Windows Terminal。

4. 在 Windows Terminal 裡選中字型

設定 → 設定檔案 → 預設值 → 外觀 → 字型 → 選 JetBrainsMono Nerd Font。

也可以直接改 settings.json：

{
  "profiles": {
    "defaults": {
      "font": { "face": "JetBrainsMono Nerd Font", "size": 11 }
    }
  }
}

5. 讓 shell 更好用（可選）

winget install --id Microsoft.PowerShell -e      # PowerShell 7
winget install --id JanDeDobbeleer.OhMyPosh -e   # oh-my-posh 提示符

zqagent 的行為

• 啟動時探測終端能力：不支援 emoji / Unicode 時，自動把自身輸出降級為 ASCII 標記 （✅→[OK]、❌→[x]、⚠️→[!]），Markdown 表格也改用 ASCII 邊框。
• 檢測到傳統控制台時會主動引導：先詢問是否讓 agent 用 winget 自動安裝 Windows Terminal 與 Nerd Font（命令逐條走審核）；裝不成、或尚未設定 LLM 連線時， 直接列印手動安裝教程。
• 相關環境變數：

變數	作用
ZQAGENT_TERM_SETUP=0	關閉啟動時的終端環境引導
ZQAGENT_TERM_SETUP=1	強制觸發引導（便於預覽教程）
ZQAGENT_EMOJI=1/0	強制開啟 / 關閉 emoji 與 Unicode 表格
ZQAGENT_ASCII=1	強制降級為 ASCII 標記

故障排查

現象	處理
winget 不存在	在「Microsoft Store」搜尋「應用安裝程式」(App Installer) 安裝，或改用上面的方式 B
圖示仍是方塊	終端裡選的字型不是 Nerd Font 那一款
emoji 仍顯示為 ?	確認已在 Windows Terminal 中執行，且 ZQAGENT_EMOJI 未被設為 0
顏色偏暗淡	conhost 不支援真彩色，換用 Windows Terminal 即可

下一步

• CLI 使用
• 內建工具