merge: v0.5.0 terminal search, keyword alerts, TeraTerm-compatible TTL

Settings -> Terminal gains a 'Show script trace in terminal' checkbox
(AppSettings.ShowScriptTrace, default on). When off, TTL trace lines
([wait] progress, sent-command echo, errors) are no longer drawn in
the terminal. dispstr moves to a dedicated Display event and always
shows, since it is the script explicitly printing something.

Trace was already display-only (never written to session logs, the AI
serial bridge, or the device) - docs now state this explicitly.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

ARCHITECTURE.md

@@ -32,7 +32,7 @@ ETTerms 是一個給工程師 / 韌體 / 硬體驗證人員用的**單一視窗
 | 祕密儲存 | **Windows Credential Manager**（DPAPI / CredMan） | 連線密碼、SSH key passphrase，不落地明碼 |
 | PDU 控制（選用） | **SnmpSharpNet** | 沿用 MyTeraTerm PDU 控制（`pductrl` / `pduconnect`） |
 | 日誌 | 自製 **AppLogger**（從 MyTeraTerm 移植） | 檔案 + Debug 雙輸出 |
-| AI / MCP 整合（選用） | **stdio MCP server**（官方 C# SDK `ModelContextProtocol`） | 獨立行程，但不自己開 port——經本機 named pipe 橋接到 GUI 持有的 serial session，把收發暴露成 AI 可呼叫工具（Kiro CLI / Claude CLI），見 [AI / MCP Integration](#ai--mcp-integrationserial-mcp-server) |
+| AI / MCP 整合（選用） | **stdio MCP server**（官方 C# SDK `ModelContextProtocol`） | 兩個獨立 server：`ETTerms.SerialMcp`（不自己開 port，經本機 named pipe 橋接 GUI 持有的 serial session）與 `ETTerms.PduMcp`（直接打 SNMP 控制 PDU 插座，不需 GUI）；把收發 / 電源控制暴露成 AI 可呼叫工具（Kiro CLI / Claude CLI），見 [AI / MCP Integration](#ai--mcp-integrationserial-mcp--pdu-mcp-server) |
 | 打包 | `dotnet publish` + （選用）Inno Setup / MSIX | 單機安裝，current-user |
 
 > **與舊版 MyTeraTerm 的關鍵差異：** 舊版是把真正的 `ttermpro.exe`（TeraTerm）嵌進 Panel，靠 **com0com 虛擬 COM 對**攔截 serial 來跑腳本。ETTerms 改走**全原生**：SSH.NET 做 SSH、`System.IO.Ports` 做 serial、自繪 VT100 控制項做終端機畫面，**不再依賴外部 TeraTerm exe，也不再需要 com0com**。腳本引擎從「驅動 com0com bridge」改成「驅動原生 `ISessionChannel`」。
@@ -118,8 +118,11 @@ ETTerms/
         │   ├── MainForm.cs         #   主視窗：Rail + Sidebar + Workspace（含深色標題列 DWM）
         │   ├── MainForm.Designer.cs
         │   ├── Theme.cs            #   全域深色配色 (KKTerm 風格)
-        │   ├── ActivityRail.cs     #   左側圖示列 (Terminal/Scripts/Settings)
+        │   ├── ActivityRail.cs     #   左側圖示列 (Terminal/Status/Settings/About)
         │   ├── ConnectionSidebar.cs#   仿 KKTerm 可編輯資料夾樹（搜尋/CRUD/拖曳分類）
+        │   ├── StatusView.cs       #   Status 檢視：分頁式（PDU…），PDU 連線後每 3 秒背景輪詢插座狀態，並可用表格內 Control 鈕直接開關各 Port
+        │   ├── SettingsView.cs     #   Settings 檢視：分頁式（Terminal / AI MCP）
+        │   ├── AboutView.cs        #   About 檢視（版本 / 連結）
         │   ├── Dialogs/            #   ── 深色對話框 ──
         │   │   ├── DarkDialog.cs       #   對話框基底（深色 + DWM 標題列）
         │   │   ├── TextPromptDialog.cs #   單行輸入（資料夾命名 / 改名）
@@ -131,7 +134,8 @@ ETTerms/
         │
         ├── Terminal/               # ── 終端機渲染 ──
         │   ├── TerminalView.cs     #   自繪 VT100 控制項 (owner-drawn)
-        │   ├── AnsiParser.cs       #   ANSI/VT100 escape 解析狀態機
+        │   ├── DarkScrollBar.cs    #   自繪深色垂直捲軸 (細長/圓角滑塊, 配深色主題)
+        │   ├── AnsiParser.cs       #   ANSI/VT100 escape 解析狀態機 (含 DEC 2004 bracketed paste)
         │   ├── ScreenBuffer.cs     #   字格緩衝 (rows×cols, 屬性/顏色)
         │   └── TerminalInput.cs    #   鍵盤 → byte 序列 (含特殊鍵)
         │
@@ -139,7 +143,7 @@ ETTerms/
         │   ├── ISessionChannel.cs  #   Write(byte[]) + event DataReceived
         │   ├── SshChannel.cs       #   SSH.NET 實作 (ShellStream)
         │   ├── SerialChannel.cs    #   System.IO.Ports 實作
-        │   ├── ShellChannel.cs     #   Windows ConPTY 本機 Shell
+        │   ├── ShellChannel.cs     #   Windows ConPTY 本機 Shell（StartupDirectory 不存在時 fallback 使用者家目錄）
         │   ├── SessionPage.cs      #   一個分頁 = TerminalView + Channel + 狀態
         │   ├── SessionManager.cs   #   開 / 關 / 列舉所有 active session
         │   ├── SerialBridgeServer.cs# ✅ 本機 named pipe server：把 serial session 的讀寫橋接給 MCP（Phase 9）
@@ -160,6 +164,7 @@ ETTerms/
         └── Infrastructure/
             ├── AppLogger.cs        #   日誌 (port 自 MyTeraTerm)
             ├── AppSettings.cs      #   使用者偏好 (JSON, %LocalAppData%\ETTerms\settings.json)
+            ├── McpRegistrar.cs     # ✅ 一鍵把 Serial MCP 註冊/移除到 Claude Code / Kiro 設定檔（Settings → AI MCP）
             └── NativeTheme.cs      #   深色標題列 (DWM)
     │
     └── ETTerms.SerialMcp/          # ✅ Serial MCP server（stdio）——不自己開 port，經 named pipe 橋接 GUI
@@ -294,6 +299,9 @@ ETTerms 是單視窗多分頁，沒有「路由」，以下以**功能面板**
 - 接收 channel bytes → `AnsiParser` → `ScreenBuffer` → 繪製
 - 鍵盤輸入 → `TerminalInput` → byte 序列 → channel
 - 支援：scrollback、選取 / 複製、貼上、字型 / 配色（從 `TerminalProfile`）
+- **捲動：** 滑鼠滾輪或右側自繪深色捲軸 `DarkScrollBar`（拖曳滑塊 / 點軌道翻頁）；`ContentWidth` 扣掉捲軸寬避免文字被蓋，捲軸範圍 / 位置在 `Feed` / 滾輪 / resize 時同步
+- **貼上：** 對方啟用 bracketed paste（DEC mode 2004，如 PSReadLine / Kiro CLI）時，整段以 `ESC[200~ … ESC[201~` 包夾送出，避免多行貼上被逐行 Enter 立即送出；未啟用則逐字送出
+- **複製：** 右鍵複製選取內容後自動清除反白（提示已複製）
 
 ### Script Editor / Runner（Scripts 檢視）
 - 載入 / 編輯 `.ttl` 腳本（語法沿用 MyTeraTerm）
@@ -355,7 +363,16 @@ ScriptRunner.RunAsync(scriptText, activeChannel)
 
 ---
 
-## AI / MCP Integration（Serial MCP Server）
+## AI / MCP Integration（Serial MCP + PDU MCP Server）
+
+ETTerms 提供**兩個獨立的 stdio MCP server**給 AI agent（Kiro CLI / Claude CLI）：
+
+- **`ETTerms.SerialMcp`** — 收發 serial。COM port 獨佔，故由 GUI 唯一持有、MCP 經本機 named pipe 橋接（見下方）。
+- **`ETTerms.PduMcp`** — 控制 SNMP PDU 電源插座。SNMP(UDP) 非獨佔，故 MCP **直接打 SNMP**，不需 GUI 在跑、也不經 pipe。
+
+兩者都能用 GUI **Settings → AI MCP** 一鍵 Setup（`McpRegistrar` 會同時註冊 `etterms-serial` 與 `etterms-pdu`）。
+
+### Serial MCP Server
 
 > 讓 **Kiro CLI / Claude CLI** 等 AI agent 收發 serial，**且使用者能在 ETTerms GUI 即時看到 AI 的每筆收發**。
 >
@@ -411,7 +428,11 @@ ETTerms GUI（單一行程，唯一開 COM3 的人）
 - **可視性：** AI 的 TX 在 GUI 以 `[AI]` 標色，與使用者手打的輸入區分；RX 兩邊同源。
 - **安全：** 本機、無雲、不碰 credential；pipe 僅限本機行程，只搬 serial bytes。
 
-### 註冊（Kiro CLI）
+### 註冊（兩種方式）
+
+**方式 A — 一鍵設定（推薦，v0.2.1）：** GUI **Settings → AI MCP** 分頁，對 Claude Code / Kiro 各按 **Setup** 即可。`McpRegistrar` 以 read-modify-write 把 `etterms-serial` 寫進該 CLI 的使用者層級設定檔（Claude Code：`~/.claude.json`；Kiro：`~/.kiro/settings/mcp.json`），保留檔內其他既有 MCP server，原子寫回避免壞檔。註冊的執行檔路徑指向 `<ETTerms.exe>\ETTerms.SerialMcp\ETTerms.SerialMcp.exe`（與 publish 慣例對齊，必定存在）；卡片同時顯示 CLI 驗證指令，按 **Remove** 可移除。
+
+**方式 B — 手動 CLI：**
 
 ```powershell
 kiro-cli mcp add --name serial --command dotnet `
@@ -420,6 +441,33 @@ kiro-cli mcp add --name serial --command dotnet `
 
 或寫進 agent.json 的 `mcpServers`；Claude CLI 則用其對應的 `mcpServers` 設定。**使用前提：先在 ETTerms GUI 開好要操作的 serial 連線**，AI 才能 `serial_attach` 上去。註冊後即可對 AI 說「列出目前 serial session → 接上 COM3 → 送指令看回應」。
 
+### PDU MCP Server（v0.3.0）
+
+> 讓 AI agent 直接控制 SNMP PDU 的電源插座，**典型用途：測試中自動 power-cycle DUT**。
+
+**關鍵設計：直接打 SNMP，不經 GUI 橋接。** 與 serial 不同，PDU 走 SNMP（UDP）**非獨佔**——多個行程可同時對同一台 PDU 下命令。因此 `ETTerms.PduMcp` 不需要像 serial 那樣繞 GUI 的 named pipe，而是內含一份精簡版 `PduController`（OID 邏輯複製自 GUI 的 `Scripting/Pdu/PduController`，診斷改走 stderr 以免污染 stdio JSON-RPC）直接與 PDU 對話。**好處：GUI 不必開著，AI 也能控制 PDU；最少程式碼、最穩。**
+
+```
+Kiro/Claude CLI ── 啟動子行程 ETTerms.PduMcp（stdio / JSON-RPC）
+                        └─ SnmpSharpNet ──(SNMP/UDP 161)──► PDU（iPoMan II/III）
+```
+
+連線狀態（device IP → controller）以行程內單例 `PduRegistry` 保存，跨工具呼叫保留，直到 `pdu_disconnect` 或行程結束。
+
+**暴露的工具：**
+
+| 工具 | 參數 | 說明 |
+|------|------|------|
+| `pdu_connect` | ip | 以 SNMP 連線並驗證 PDU 回應，成功回傳 model name；控制前必須先呼叫 |
+| `pdu_list` | — | 列出本 session 已連線的 PDU（依 IP） |
+| `pdu_set_port` | ip, port, on | 將某插座開(on=true)/關(off=false) |
+| `pdu_get_port` | ip, port | 讀單一插座的狀態 / 電流(mA) / 功率(W) |
+| `pdu_status` | ip | 讀全部 12 個插座的狀態 / 電流 / 功率 |
+| `pdu_power_cycle` | ip, port, offSeconds? | 關 → 等 offSeconds → 開（重啟 DUT） |
+| `pdu_disconnect` | ip | 解除本 session 的 PDU 連線（不改變插座狀態） |
+
+> 所有工具回傳統一的 `{ "ok": bool, "result"/"error": ... }` JSON。SNMP community 目前沿用 GUI 版的 `"private"`。
+
 ---
 
 ## Key Constraints & Business Rules
@@ -480,13 +528,73 @@ cd F:\10_AI\ETTerms
 dotnet build
 dotnet run --project src\ETTerms\ETTerms.csproj
 
-# 5. 打包（後期 Phase）
+# 5. 打包（見下方「Publish / 打包慣例」）
-dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained false
+dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained false `
+    -o src\ETTerms\Publish\ETTerms_v<Version>
 #    後續可用 Inno Setup / MSIX 做安裝程式
 ```
 
 ---
 
+## Publish / 打包慣例
+
+> 每次發 Release 都依此規則產出，方便辨識版本與一併攜帶 MCP server。
+
+**輸出位置（固定）：** `src\ETTerms\Publish\ETTerms_v{Version}\`
+- `{Version}` 取自 `src\ETTerms\ETTerms.csproj` 的 `<Version>`（例：`0.2.0`）。
+- 資料夾命名：`ETTerms_v{Version}`（前綴 `v`，例：`ETTerms_v0.2.0`）。
+- `Publish/` 已 gitignore（`publish/`），**不入 git**。
+
+**內容結構：**
+```
+ETTerms_v0.3.0\
+├── ETTerms v0.3.0.exe        # 主程式 apphost，改名為「ETTerms v{Version}.exe」
+├── ETTerms.dll + 各相依 dll  # SSH.NET / SQLite / SnmpSharpNet / System.IO.Ports …
+├── ETTerms.SerialMcp\        # Serial MCP server，獨立發佈到子資料夾（相依 dll 與 GUI 隔離）
+│   ├── ETTerms.SerialMcp.exe
+│   └── ETTerms.SerialMcp.dll + 相依
+└── ETTerms.PduMcp\           # PDU MCP server（v0.3.0），同樣獨立發佈到子資料夾
+    ├── ETTerms.PduMcp.exe
+    └── ETTerms.PduMcp.dll + 相依（含 SnmpSharpNet）
+```
+
+**規則：**
+1. **GUI publish 會自動帶上兩個 MCP server**：`ETTerms.csproj` 有 `PublishMcpServers` target（`AfterTargets="Publish"`），會把 `ETTerms.SerialMcp` 與 `ETTerms.PduMcp` 一併發佈到各自的 `<publish>\<server>\` **子資料夾**（與 GUI 相依 dll 隔離）。因此**只要發佈 GUI 一個指令**即可，不必再單獨發 MCP。
+   - 對齊 `McpRegistrar.ResolveServerExe()`：它解析的 `<ETTerms.exe>\<server>\<server>.exe` 因此**必定存在**，AI MCP 一鍵設定寫進去的路徑才不會落空。
+   - MCP 子發佈會**跟隨 GUI 的 `SelfContained` 設定**（target 內以 `$(SelfContained)` 傳入）：框架相依版的 MCP 也框架相依；portable 版的 MCP 也免 runtime。
+2. **主 exe 改名**：`dotnet publish` 產生的 `ETTerms.exe` 重新命名為 **`ETTerms v{Version}.exe`**。
+   - 可安全改名：.NET apphost 內部記錄要載入的 `ETTerms.dll`，**不靠自身檔名**，改名後仍正常啟動。
+
+### 兩種發佈版本（兩個都要產出）
+
+| 版本 | 資料夾 | 指令旗標 | 需 .NET Runtime？ | 用途 |
+|------|--------|----------|-------------------|------|
+| **A. 框架相依（預設）** | `ETTerms_v{Version}\` | `--self-contained false` | ✅ 需先裝 .NET 8 Desktop Runtime | 體積小；給已具備 runtime 的環境 |
+| **B. Portable（免安裝）** | `ETTerms_v{Version}_portable\` | `--self-contained true` | ❌ 不需要，runtime 已內含 | 體積大（約 240MB）；給受 MIS 管控、不便裝 runtime 的環境，解壓即用、免系統管理員權限 |
+
+> ⚠️ **不要開 trimming**（`PublishTrimmed`）：WinForms 大量用反射，trim 後易在執行時出錯。
+
+**PowerShell 範例（一次產出兩種）：**
+```powershell
+$ver = ([regex]::Match((Get-Content src\ETTerms\ETTerms.csproj -Raw), '<Version>([^<]+)</Version>')).Groups[1].Value
+
+# A. 框架相依版 → ETTerms_v{Version}\
+$root = "src\ETTerms\Publish\ETTerms_v$ver"
+if (Test-Path $root) { Remove-Item $root -Recurse -Force }
+dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained false -o $root
+Rename-Item (Join-Path $root "ETTerms.exe") "ETTerms v$ver.exe"
+
+# B. Portable 免安裝版 → ETTerms_v{Version}_portable\（runtime 已內含；MCP 也跟著 self-contained）
+$proot = "src\ETTerms\Publish\ETTerms_v${ver}_portable"
+if (Test-Path $proot) { Remove-Item $proot -Recurse -Force }
+dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained true -o $proot
+Rename-Item (Join-Path $proot "ETTerms.exe") "ETTerms v$ver.exe"
+```
+
+> 兩版的 `ETTerms.SerialMcp\` 與 `ETTerms.PduMcp\` 子資料夾都由 `PublishMcpServers` target 自動產生；portable 版的 MCP 也是 self-contained，故 AI MCP 功能在無 runtime 環境同樣可用。
+
+---
+
 ## Development Phases
 
 > 依使用者要求「**前面先把 GUI 做出來，後面再慢慢補功能**」排序：

CLAUDE.md

@@ -10,6 +10,18 @@ ETTerms 是一個 **C# .NET 8 WinForms** 的原生 Windows 終端機工作台，
 
 **進度：** Phase 1–5 ✅、Phase 6 ✅（TTL 引擎 + Group 同步，SSH 待驗收）、Phase 7 ✅（Settings/About）、Phase 8 ✅（PDU + Shell/ConPTY + SFTP + Settings 擴充）、Phase 9 ✅（Serial MCP server：**GUI 持有 COM port，MCP 經本機 named pipe 橋接**，AI 收發的資料即時以 `[AI]` 標色顯示在 GUI）。打包待指示。
 
+**v0.5.0：** 搜尋 / 關鍵字警示 / TTL 大擴充。**(1) Ctrl+F scrollback 搜尋** — `TerminalView` 內建搜尋列（Enter 往上找、Shift+Enter 往下、F3/Esc），全部命中黃底、目前命中橘底；命中以「絕對行號 = `ScreenBuffer.DroppedLines` + abs」錨定，環形緩衝丟舊行不漂移。**(2) 關鍵字高亮 + 分頁警示** — `AppSettings.KeywordRules`（`KeywordRule{Text,Enabled}` + 全域開關），Settings 新 **Highlight** 分頁可增刪/勾選；`TerminalView` 每次重繪只掃可見行標紅底（不分大小寫），`Feed` 路徑用獨立 Decoder+去 ANSI 偵測觸發 `KeywordAlert`（每關鍵字 2s 冷卻）→ `SessionPage` → `WorkspaceView` 把**非 active 分頁**的圓點標紅、切過去自動清除。**(3) TTL 對齊 TeraTerm** — 新 `TtlExpression` 運算式解析器（括號/邏輯/比較/十六進位 `0x`/`$`，失敗退回 legacy 規則相容舊腳本）；新增控制流 `goto/call(行內執行，迴圈內可用)/return/for-next/do-loop/until-enduntil/break/continue/end/exit/include/mpause`、等待 `waitln/waitregex/recvln/wait 多字串(TeraTerm 語意：逾時 result=0 繼續)/mtimeout`、字串 `strlen/strcompare/strconcat/strcopy/strinsert/strremove/strmatch/strscan/strreplace/strtrim/strsplit/strjoin/tolower/toupper/str2int/int2str/code2str/str2code/sprintf(→inputstr)/expandenv`、檔案 `fileopen/filereadln(result=1 是 EOF)/filewrite(ln)/fileclose/filecreate/filedelete/filesearch/basename/dirname/makepath/foldercreate/folderdelete/foldersearch/getdir/setdir`、雜項 `beep/getdate/gettime(strftime 子集)/getenv/setenv/random/exec/getver/getttdir/uptime/ifdefined/clipb2var/var2clipb/inputbox/yesnobox/crc32/checksum8/16/32/dispstr`、serial 專用 `sendbreak/setbaud/setdtr/setrts/sendfile`（`SerialChannel` 新增對應方法）；單行 `if <expr> <statement>` 支援；`Preprocess` 引號內 `;` 不再被當註解；系統變數 `inputstr/matchstr/groupmatchstr1-9`；`_vars` 改大小寫不敏感；**單字串 `wait` 保留 ETTerms settle+逾時中止語意（勿改）**，多字串才是 TeraTerm 語意。`SessionPage` 把 `runner.Output`（trace：`[wait]`/`>>`/錯誤）以灰色 echo 進終端機，**可由 Settings → Terminal 的 `ShowScriptTrace` 開關關閉**；`dispstr` 走獨立的 `Display` 事件一律顯示。灰色訊息只進畫面 buffer——不進 ⏺ Log 側錄、不進 AI bridge、不送裝置（機台原始 log 乾淨）。指令表＋範例：[docs/ttl-script-reference.md](docs/ttl-script-reference.md)（前段 ETTerms 獨有、後段與 TeraTerm 共有）。
+
+**v0.4.0：** 效能 / 穩定性總整理（來自全 codebase 審視）。**(1) 終端機繪製熱路徑去配置** — `TerminalView` 快取 4 種 Font 變體（Bold/Underline 組合）與單一可變色 `SolidBrush`，run 合併時每 cell 顏色只解析一次，`Dispose` 收掉 GDI 資源；**(2) scrollback 改環形緩衝** — `ScreenBuffer` 從 `List+RemoveRange(0,…)`（滿了每行 O(n) 搬移）改 O(1) ring buffer；**(3) UTF-8 跨 chunk 亂碼修正（3 處）** — `TTLInterpreter.OnData`、`SerialBridgeServer` rx 轉發、`SessionLogger.Write` 改用 stateful `Decoder`（比照 `AnsiParser` 原本的正確做法）；**(4) PDU SNMP 批次查詢** — 新共用專案 **`src/ETTerms.PduCore/`** 取代 GUI 與 PduMcp 兩份複製的 `PduController`（log 走建構子委派），新增 `GetAllPortsStatus()` 一個 SNMP GET 帶 12 個 varbind，12 port 輪詢從 36 個 UDP 來回縮成 3 個（StatusView 與 `pdu_status` 都改用）；**(5) ShellChannel 資源修正** — `DeleteProcThreadAttributeList`+`FreeHGlobal` 釋放 attribute list、`CloseHandle(pi.hProcess)`，shell 自行 exit 時顯示灰色 `[ETTerms] shell process exited` 提示；**(6) SSH 斷線可見** — 訂 `ErrorOccurred`/`ShellStream.Closed` 顯示提示，`Write` 例外不再炸 UI thread；**(7) 終端機行為** — 新輸出只在已貼底時跟隨（看歷史不被拉回底部）、alt screen 滾輪轉方向鍵（vim/htop 可滾）、回應 DSR `ESC[6n`/`ESC[5n` 與 DA `ESC[c`（TUI 查游標位置不再卡住）；**(8) TTL** — `_recv` 上限 1MB、wait 輪詢長度沒變不重掃；**(9) 去重複** — `ScriptRunner` 兩個 Run 合併、`TtlScript` 共用選檔/group 指令檢查（SessionPage/WorkspaceView 三份流程收斂）、`ConnectionStore` 讀取改 InvariantCulture+RoundtripKind。註：group `waitall` 一個成員失敗其他成員停在 barrier 是**刻意行為**（使用者要求整組停下），勿「修」。
+
+**v0.3.2：** **(1) 新增左側 `Status` rail view** — 位於 Terminal 與 Settings 之間（圖示 `⚡`，新增 `ActivityRail.RailView.Status` 列舉與 `Items`），獨立 `App/StatusView.cs`，沿用 `SettingsView` 的自繪 tab strip + panel 切換風格（避免 TabControl 白邊）；`MainForm` 加 `_statusView` 欄位、佈局與 rail 切換可見性。目前只有 **PDU 分頁**，未來會再加分頁（`MakeTab(...)` 即可擴充）。**(2) PDU 搬到 Status 並改自動輪詢** — PDU 從 `SettingsView` 移到 `StatusView`，**移除手動 Refresh 按鈕**，連線成功後以 `System.Threading.Timer`（period 3000ms）在**背景執行緒**讀 SNMP、再 `BeginInvoke` 回 UI 更新表格（不卡 UI）；`Interlocked` 旗標防止前一輪未讀完就重入；斷線 / 控制項 Dispose 時自動停掉 timer 與 `PduController`；表格下方顯示「last update HH:mm:ss」。`SettingsView` 移除 `BuildPduTab`/`RefreshPduGrid` 與 `ETTerms.Scripting.Pdu` import，現只剩 **Terminal / AI MCP** 兩分頁。**(2b) PDU 分頁加手動開關鈕** — 狀態表格新增 **Control** 欄（`DataGridViewButtonColumn`），每個 Port 一顆鈕，文字隨狀態切換（ON→「Turn OFF」、OFF→「Turn ON」、未知→「—」）；點擊在背景執行緒呼叫 `PduController.SetPortOn/SetPortOff`（不卡 UI），等 ~400ms 後回讀刷新整表，失敗跳 `MessageBox`；未連線點擊會提示先 Connect，斷線時清空表格避免顯示過時狀態。**(3) 修 `ShellChannel` 啟動目錄 fallback** — 本機 Shell 的 `StartupDirectory` 若已不存在（外接碟拔除 / 資料夾被刪）會 `CreateProcess failed: 267 (ERROR_DIRECTORY)`；改為「為空 **或** `Directory.Exists` 為 false」即 fallback 到使用者家目錄（`Environment.SpecialFolder.UserProfile`，隨登入者變動，例如 `C:\Users\et_wen`），與 Windows PowerShell 行為一致。
+
+**v0.3.1：** 終端機體驗修正（皆在 `src/ETTerms/Terminal/`）。**(1) 深色垂直捲軸** — 新增自繪 `DarkScrollBar`（細長、無箭頭、圓角滑塊，配合 KKTerm 深色主題），`TerminalView` 右側 `Dock=Right` 掛上，`ContentWidth` 扣掉捲軸寬避免文字被蓋，`UpdateScrollBar()` 在 `Feed` / 滾輪 / resize 時同步滑塊範圍與位置，滾輪與拖曳互通。**(2) 多行貼上修正** — `AnsiParser` 新增 `BracketedPaste`（DEC mode 2004）；`TerminalView.Paste()` 在對方啟用 bracketed paste（PSReadLine / Kiro CLI 等）時以 `ESC[200~ … ESC[201~` 包夾整段，視為「單次貼上」而非逐行 Enter 立即送出；未啟用時退回原本逐字送出。**(3) 右鍵複製清反白** — 右鍵複製後清掉 `_hasSel` 並重繪，讓使用者知道已複製。
+
+**v0.3.0：** 新增 **`ETTerms.PduMcp`**（stdio MCP server）：讓 AI agent 直接控制 SNMP PDU 插座。與 serial 不同，PDU 走 SNMP(UDP) **非獨佔**，故 PduMcp **直接打 SNMP、不經 GUI 橋接**（內含精簡版 `PduController`，OID 邏輯複製自 GUI 版，log 走 stderr），GUI 不開著也能用。工具：`pdu_connect` / `pdu_list` / `pdu_set_port` / `pdu_get_port` / `pdu_status` / `pdu_power_cycle` / `pdu_disconnect`，回傳統一 `{ok, result/error}` JSON；連線狀態以行程內單例 `PduRegistry`（IP→controller）保存。`McpRegistrar` 改為多 server，**Settings → AI MCP 一鍵同時註冊 `etterms-serial` 與 `etterms-pdu`**；`ETTerms.csproj` 的 publish target 更名 `PublishMcpServers`，GUI publish 會把兩個 MCP 各自帶到 `\ETTerms.SerialMcp\`、`\ETTerms.PduMcp\` 子資料夾。
+
+**v0.2.1：** 新增 GUI **Settings → AI MCP** 分頁（`McpRegistrar`）：對 Claude Code（`~/.claude.json`）與 Kiro（`~/.kiro/settings/mcp.json`）**一鍵 Setup / Remove** 註冊 `etterms-serial` MCP server，read-modify-write 保留檔內其他設定、原子寫回；卡片附 CLI 驗證指令。`ETTerms.csproj` 加 publish target（`AfterTargets=Publish`），GUI publish 會自動把 MCP server 帶到子資料夾，與 `McpRegistrar.ResolveServerExe()` 解析路徑對齊。
+
 **v0.2.0：** Phase 9 完成 — `ETTerms.SerialMcp`（stdio MCP server）+ GUI `SerialBridgeServer`（named pipe `\\.\pipe\etterms-serial`）上線，提供 `serial_list` / `serial_attach` / `serial_write` / `serial_read` / `serial_detach` 五個工具，AI 的 TX 在 GUI 以 `[AI]` 標色即時 echo；視窗 / 工作列 / About 改用 Choco 圖示，標題列顯示版本號。見 [docs/serial-mcp-guide.md](docs/serial-mcp-guide.md)。
 
 **v0.1.2：** 新增 `sprintf2`（TeraTerm 相容 C printf 格式化）；`wait` 改為命中關鍵字後須等裝置安靜（`SettleMs` 預設 300ms）才接受並取「最後一次」出現，排除輸出中途的指令回顯（避免腳本搶跑）。
@@ -25,7 +37,7 @@ ETTerms 是一個 **C# .NET 8 WinForms** 的原生 Windows 終端機工作台，
 - **連線儲存：** SQLite（`Microsoft.Data.Sqlite`）
 - **密碼儲存：** Windows Credential Manager（不落地明碼）
 - **PDU：** SnmpSharpNet（iPoMan II/III via SNMP）
-- **AI / MCP（選用）：** stdio MCP server（`ETTerms.SerialMcp`，官方 C# SDK `ModelContextProtocol`）。**不自己開 COM port**，而是經本機 named pipe 接上 GUI 持有的 serial session，把 serial 收發暴露給 Kiro CLI / Claude CLI；AI 的 TX/RX 同步顯示在 GUI
+- **AI / MCP（選用）：** 兩個 stdio MCP server（官方 C# SDK `ModelContextProtocol`）。`ETTerms.SerialMcp`：**不自己開 COM port**，經本機 named pipe 接上 GUI 持有的 serial session，AI 的 TX/RX 同步顯示在 GUI。`ETTerms.PduMcp`（v0.3.0）：**直接打 SNMP** 控制 PDU 插座，非獨佔故不需 GUI 在跑。皆暴露給 Kiro CLI / Claude CLI
 - **設定持久化：** JSON → `%LocalAppData%\ETTerms\settings.json`
 
 ## 常用指令
@@ -38,16 +50,31 @@ dotnet run --project src\ETTerms\ETTerms.csproj
 # 加套件
 dotnet add src\ETTerms package SSH.NET
 
-# 打包
+# 打包（見「Publish / 打包慣例」）—— 兩種版本都產出，輸出到 src\ETTerms\Publish\
-dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained false
+# GUI publish 會「自動」把 ETTerms.SerialMcp 與 ETTerms.PduMcp 一併發到各自的子資料夾
+# （ETTerms.csproj 的 PublishMcpServers target，AfterTargets=Publish），且 MCP 跟隨 GUI 的 self-contained 設定。
+$ver = ([regex]::Match((Get-Content src\ETTerms\ETTerms.csproj -Raw), '<Version>([^<]+)</Version>')).Groups[1].Value
+
+# A. 框架相依版（需目標機已裝 .NET 8 Desktop Runtime）→ ETTerms_v{Version}\
+$root = "src\ETTerms\Publish\ETTerms_v$ver"
+dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained false -o $root
+Rename-Item (Join-Path $root "ETTerms.exe") "ETTerms v$ver.exe"
+
+# B. Portable 免安裝版（runtime 內含，免裝、免管理員）→ ETTerms_v{Version}_portable\
+$proot = "src\ETTerms\Publish\ETTerms_v${ver}_portable"
+dotnet publish src\ETTerms\ETTerms.csproj -c Release -r win-x64 --self-contained true -o $proot
+Rename-Item (Join-Path $proot "ETTerms.exe") "ETTerms v$ver.exe"
 
 # 註冊 Serial MCP server（給 AI agent 操作 serial）
+# 推薦：GUI Settings → AI MCP 分頁，對 Claude Code / Kiro 按 Setup 一鍵註冊（McpRegistrar）。
+# 或手動 CLI：
 kiro-cli mcp add --name serial --command dotnet --args "run --project src\ETTerms.SerialMcp\ETTerms.SerialMcp.csproj"
 ```
 
 ## 開發慣例
 
 - **命名：** PascalCase 類別 / 方法，`_camelCase` 私有欄位；檔名 = 類別名。
+- **Publish / 打包：** 輸出到 `src\ETTerms\Publish\`；主 exe 改名為 `ETTerms v{Version}.exe`；`ETTerms.SerialMcp` 與 `ETTerms.PduMcp` 一併發到其下 `ETTerms.SerialMcp\`、`ETTerms.PduMcp\` 子資料夾（且跟隨 GUI 的 self-contained 設定）。**兩種版本都產出**：框架相依 `ETTerms_v{Version}\`（`--self-contained false`，需裝 .NET 8 Desktop Runtime）＋ portable 免安裝 `ETTerms_v{Version}_portable\`（`--self-contained true`，runtime 內含）。不要開 trimming（WinForms 反射）。詳見 [ARCHITECTURE.md](ARCHITECTURE.md#publish--打包慣例)。
 - **分層：** UI（`App/`）只認 `ISessionChannel` 抽象，不直接相依 SSH.NET / SerialPort。
 - **執行緒：** channel I/O 在背景；所有 UI 更新一律 `Control.Invoke` 回 UI thread。
 - **commit：** 走 Conventional Commits（`feat:` / `fix:` / `refactor:` …）。
@@ -63,10 +90,14 @@ kiro-cli mcp add --name serial --command dotnet --args "run --project src\ETTerm
 - ⚠️ VT 相容性以常見情境（VT100 / 常見 ANSI）為主，冷門 escape 後補，不阻塞 GUI 進度。
 - ⚠️ 本專案**無伺服端祕密 / 無 DB 密碼 / 無 EC2 / 無 VM**，因此不套用 AWS / VirtualBox 部署流程。
 - ⚠️ Group 同步指令（`waitall` / `sendlnall` / `sendlngroup`）**只能在 Run Group 模式**使用；`▶ Script` 和 `▶ Run All` 須拒絕含這些指令的腳本。
+- ⚠️ Group `waitall` 的 barrier 行為：**一個成員失敗/停止，其他成員會停在 barrier 等** —— 這是刻意設計（整組一起停下來），不是 bug，勿改成 RemoveParticipant。
+- ⚠️ `SshChannel.Resize` 用反射挖 SSH.NET 私有 `_channel` 呼叫 `SendWindowChangeRequest`（該 API 未公開）。**升級 SSH.NET 版本時必須驗證 resize 仍有效**（連上後拉視窗大小看遠端 TUI 是否跟著變）。
 
 ## 資料夾用途
 
 - **`src/ETTerms/`** — 主應用程式（WinForms 視窗外殼 + 連線 / 終端機 / 腳本引擎）。
 - **`src/ETTerms.SerialMcp/`** — ✅ stdio MCP server（給 AI agent 收發 serial）。獨立行程，但**不直接開 COM port**：經本機 named pipe 連到 GUI 的 `SerialBridgeServer`，由 GUI 代為讀寫實體 port；net8.0 console + `ModelContextProtocol` SDK。
+- **`src/ETTerms.PduMcp/`** — ✅ stdio MCP server（給 AI agent 控制 SNMP PDU，v0.3.0）。獨立行程，**直接打 SNMP**，不經 GUI、GUI 不開著也能用；net8.0 console + `ModelContextProtocol`，PDU 邏輯用 `ETTerms.PduCore`。
+- **`src/ETTerms.PduCore/`** — ✅ PDU SNMP 控制共用庫（v0.4.0）。GUI 與 PduMcp 共用的唯一 `PduController`（先前兩份複製已移除）；診斷 log 走建構子注入委派（GUI→AppLogger、MCP→stderr）；含批次查詢 `GetAllPortsStatus()`。
 - **`For_AI/`** — AI 協作素材與**參考專案**（`KKTerm-main` UI 參考、`MyTeraTerm` Script 參考）。整個資料夾 gitignored，僅供開發對照。
 - 本專案**無 `secret/` 資料夾**：沒有伺服端祕密 / DB 密碼 / compile-time secret，連線密碼一律走 Windows Credential Manager。

ETTerms.slnx

@@ -2,5 +2,7 @@
   <Folder Name="/src/">
     <Project Path="src/ETTerms/ETTerms.csproj" />
     <Project Path="src/ETTerms.SerialMcp/ETTerms.SerialMcp.csproj" />
+    <Project Path="src/ETTerms.PduMcp/ETTerms.PduMcp.csproj" />
+    <Project Path="src/ETTerms.PduCore/ETTerms.PduCore.csproj" />
   </Folder>
 </Solution>

README.md

@@ -4,7 +4,7 @@
 
 > A native Windows terminal workspace (C# .NET 8 WinForms) — **SSH**, **Serial Port**, and **local Shell (ConPTY)** in one window, with a **TTL scripting engine** ported from MyTeraTerm for automation, plus an optional **Serial MCP server** that lets AI agents (Kiro CLI / Claude CLI) drive the serial port directly. Standalone, no cloud, no login.
 
-![version](https://img.shields.io/badge/version-0.1.0-blue.svg) ![platform](https://img.shields.io/badge/platform-Windows-0078D6.svg?logo=windows&logoColor=white) ![.NET](https://img.shields.io/badge/.NET-8.0-512BD4.svg?logo=dotnet&logoColor=white) ![UI](https://img.shields.io/badge/UI-WinForms-5C2D91.svg) ![SSH](https://img.shields.io/badge/SSH-SSH.NET-success.svg) ![Serial](https://img.shields.io/badge/Serial-System.IO.Ports-success.svg) ![status](https://img.shields.io/badge/status-WIP-orange.svg) ![license](https://img.shields.io/badge/license-MIT-green.svg)
+![version](https://img.shields.io/badge/version-0.3.3-blue.svg) ![platform](https://img.shields.io/badge/platform-Windows-0078D6.svg?logo=windows&logoColor=white) ![.NET](https://img.shields.io/badge/.NET-8.0-512BD4.svg?logo=dotnet&logoColor=white) ![UI](https://img.shields.io/badge/UI-WinForms-5C2D91.svg) ![SSH](https://img.shields.io/badge/SSH-SSH.NET-success.svg) ![Serial](https://img.shields.io/badge/Serial-System.IO.Ports-success.svg) ![status](https://img.shields.io/badge/status-beta-yellow.svg) ![license](https://img.shields.io/badge/license-MIT-green.svg)
 
 ---
 
@@ -63,12 +63,14 @@
 
 - ⚡ **PDU power control (optional)**
   - Control PDU outlets over SNMP (`SnmpSharpNet`) to power-cycle devices during tests
+  - **Status → PDU** tab: connect to a PDU, auto-poll outlet state every 3 s, and toggle any port on/off with per-row **Control** buttons
   - Script commands: `pduconnect` / `pductrl`
 
-- 🤖 **AI / MCP integration (optional, planned)**
+- 🤖 **AI / MCP integration (optional)**
   - The **GUI owns the COM port**; a standalone stdio **Serial MCP server** bridges to it over a local named pipe for **Kiro CLI / Claude CLI**
   - Tools: `serial_list` / `serial_attach` / `serial_write` / `serial_read` / `serial_detach`
   - AI's serial TX/RX shows live in the GUI tagged `[AI]` — open the port in the GUI first, then let the AI attach
+  - **One-click setup** in **Settings → AI MCP**: register the server into Claude Code / Kiro with a single button
 
 - 📊 **Session RX logging**
   - `logopen` / `logwrite` / `logclose` write session output to file
@@ -76,9 +78,10 @@
 ### Terminal Rendering
 
 - 🎨 Owner-drawn VT100 / ANSI control, double-buffered cell grid
-- 🌑 KKTerm-style dark theme (incl. DWM dark title bar)
+- 🌑 KKTerm-style dark theme (incl. DWM dark title bar + dark terminal scrollbar)
 - 🔤 Configurable font / size / palette / scrollback
-- 📋 Select / copy / paste
+- 🖱️ Scroll back through long output with the mouse wheel or the dark scrollbar
+- 📋 Select / copy / paste — right-click copy clears the highlight; multi-line paste uses **bracketed paste** so it isn't submitted line-by-line
 
 ---
 
@@ -271,7 +274,7 @@ wait 'login: '
 
 ## 🤖 AI / MCP Integration
 
-> 🔜 **Planned (Phase 9).** Let AI agents (**Kiro CLI / Claude CLI**) send/receive on a serial port **while you watch it live in the ETTerms GUI**.
+> Let AI agents (**Kiro CLI / Claude CLI**) send/receive on a serial port **while you watch it live in the ETTerms GUI**.
 
 **Key design: the GUI owns the COM port; the MCP server never opens it.** A COM port can be opened by only one process at a time, so rather than the MCP server grabbing it, the GUI is the sole owner and runs a local **named pipe server** (`SerialBridgeServer`). The standalone `ETTerms.SerialMcp` (launched by Kiro/Claude CLI) is a thin client: every `write` / `read` is forwarded over the pipe to the GUI, which does the real port I/O. AI's TX is echoed into the terminal tagged `[AI]`, so RX/TX flow through the GUI channel and what you see is exactly what the AI sees.
 
@@ -287,7 +290,11 @@ Full closed loop — all inside the ETTerms GUI:
 | `serial_read` | waitFor?, timeoutMs? | Drain accumulated RX; optionally wait for a substring / timeout |
 | `serial_detach` | — | Unbind (does **not** close the GUI's port) |
 
-Register in Kiro CLI:
+### One-click setup (recommended)
+
+In **Settings → AI MCP**, click **Setup** on the Claude Code or Kiro card to register the Serial MCP server into that CLI's user-level config (`~/.claude.json` / `~/.kiro/settings/mcp.json`) with a single button. Your other MCP servers are preserved, and each card shows the CLI command to verify the connection. **Remove** unregisters it.
+
+### Manual setup
 
 ```powershell
 kiro-cli mcp add --name serial --command dotnet --args "run --project src\ETTerms.SerialMcp\ETTerms.SerialMcp.csproj"
@@ -377,8 +384,8 @@ ETTerms/
 │   ├── Sessions/             # Connection abstraction: ISessionChannel / SshChannel / SerialChannel / ShellChannel
 │   ├── Connections/          # Connection data: Connection / ConnectionStore(SQLite) / CredentialVault
 │   ├── Scripting/            # TTL engine: TTLInterpreter / ScriptRunner / GroupSyncContext / Pdu
-│   └── Infrastructure/       # AppLogger / AppSettings / NativeTheme
+│   └── Infrastructure/       # AppLogger / AppSettings / McpRegistrar / NativeTheme
-└── src/ETTerms.SerialMcp/    # 🔜 Serial MCP server (stdio) — lets AI agents drive the serial port
+└── src/ETTerms.SerialMcp/    # Serial MCP server (stdio) — lets AI agents drive the serial port
 ```
 
 **Core design:** every connection implements `ISessionChannel` (`Write(byte[])` + `event DataReceived`). `TerminalView` and `TTLInterpreter` only know this abstraction, so SSH / Serial / Shell look identical to upper layers — the key to "one script engine driving multiple connection types." See [ARCHITECTURE.md](ARCHITECTURE.md).
@@ -397,18 +404,54 @@ ETTerms/
 
 ## 📜 Version History
 
-### v0.1.0 (in development)
+### v0.3.3
+
+- **Terminal input fix** — after the terminal had printed output (Serial or PowerShell), switching away and back (minimize, or click another app) could leave it unable to accept typing or **Enter**, forcing a session reopen; idle sessions were never affected
+- Cause: once output built up scrollback, the terminal's scrollbar could steal keyboard focus on window re-activation. The scrollbar is now mouse-only and never takes focus, so input keeps working no matter how much has printed
+
+### v0.3.2
+
+- **Status → PDU tab** — a dedicated `Status` rail view hosts the PDU panel: connect by IP, auto-poll all 12 outlets every 3 s (background thread, no manual Refresh), with live current / power readouts
+- **Manual outlet control buttons** — each row has a **Control** button that toggles that port on/off over SNMP; the label tracks state (ON → "Turn OFF", OFF → "Turn ON"), the SNMP set runs off the UI thread, and the grid refreshes after the command
+
+### v0.3.1
+
+- **Terminal usability fixes** — added a **dark vertical scrollbar** (drag or click-to-page through long output instead of long mouse-wheel scrolling)
+- **Multi-line paste** into Kiro CLI / PSReadLine now pastes as a single block (**bracketed paste**, DEC mode 2004) instead of submitting each line immediately
+- Right-click copy now **clears the highlight** so you know it worked
+
+### v0.3.0
+
+- **AI-driven PDU power control (MCP)** — new `ETTerms.PduMcp` server lets AI agents (Kiro CLI / Claude CLI) control an SNMP PDU directly: outlets on/off, status, and power-cycle a DUT during automated tests
+- PDU runs over SNMP (UDP, non-exclusive), so the AI talks to it directly — the ETTerms GUI does not need to be running
+- Tools: `pdu_connect` / `pdu_list` / `pdu_set_port` / `pdu_get_port` / `pdu_status` / `pdu_power_cycle` / `pdu_disconnect`
+- **Settings → AI MCP** now registers both `etterms-serial` and `etterms-pdu` with one click; publishing the GUI auto-bundles both MCP servers
+
+### v0.2.2
+
+- **Terminal stability** — the terminal no longer freezes after minimizing or switching tabs (most noticeable with full-screen TUIs like Kiro CLI in PowerShell); a degenerate 1×1 size is no longer sent to the pseudo-console
+- **Shift+Enter** inserts a newline in the shell, so you can type multi-line commands (plain Enter still submits)
+- **High-DPI fixes** — text and buttons no longer clipped at 125% / 150% scaling (PerMonitorV2); toolbar / settings / sidebar / About now scale adaptively
+
+### v0.2.1
+
+- **AI MCP one-click setup** — new **Settings → AI MCP** tab registers the Serial MCP server into Claude Code (`~/.claude.json`) or Kiro (`~/.kiro/settings/mcp.json`) with a single button; existing MCP servers are preserved, and each card shows the verify command
+- Publish now auto-bundles `ETTerms.SerialMcp` into the app folder, so the registered path always resolves
+
+### v0.2.0
+
+- **Phase 9: Serial MCP server** (`ETTerms.SerialMcp`) — AI agents (Kiro CLI / Claude CLI) send/receive on the serial port while you watch it live in the GUI
+- GUI is the sole COM-port owner; the MCP server bridges over a local named pipe (`SerialBridgeServer`) and never opens the port itself
+- Tools: `serial_list` / `serial_attach` / `serial_write` / `serial_read` / `serial_detach`; AI's TX echoed into the terminal tagged `[AI]`
+- New app icon (window / taskbar / executable); version shown in the title bar
+
+### v0.1.0
 
 - Phases 1–8 complete: window shell, connection sidebar, tiling workspace, Serial / SSH / local Shell (ConPTY) / SFTP
 - Owner-drawn VT100 terminal rendering
 - TTL scripting engine (ported from MyTeraTerm) + Group sync execution
 - PDU power control (SNMP)
 - Settings / About
-- Packaging TBD
-
-**Planned**
-
-- Phase 9: Serial MCP server (`ETTerms.SerialMcp`) — let AI agents (Kiro CLI / Claude CLI) drive the serial port directly
 
 ---
 
@@ -420,7 +463,7 @@ Licensed under the **MIT License** — see [LICENSE](LICENSE).
 
 ## 🙏 Acknowledgments
 
-- **[KKTerm](https://github.com/)** — UI design reference (Activity Rail + tabbed workspace + Saved Connections)
+- **[KKTerm](https://github.com/ryantsai/KKTerm)** — by ryantsai (MIT) — UI design reference (Activity Rail + tabbed workspace + Saved Connections)
 - **MyTeraTerm** — source of the TTL scripting engine and `AppLogger`
 - **[SSH.NET](https://github.com/sshnet/SSH.NET)**, **[SnmpSharpNet](http://www.snmpsharpnet.com/)** — open-source connectivity / SNMP libraries
 - **Microsoft** — .NET 8, WinForms, ConPTY, Credential Manager

README.zh-TW.md

@@ -4,7 +4,7 @@
 
 > 原生 Windows 終端機工作台（C# .NET 8 WinForms）—— 一個視窗整合 **SSH**、**Serial Port**、**本機 Shell (ConPTY)** 連線，內建從 MyTeraTerm 移植的 **TTL 腳本引擎**做自動化，並提供選用的 **Serial MCP server**，讓 AI agent（Kiro CLI / Claude CLI）直接操作 serial port。單機、無雲、無登入系統。
 
-![version](https://img.shields.io/badge/version-0.1.0-blue.svg) ![platform](https://img.shields.io/badge/platform-Windows-0078D6.svg?logo=windows&logoColor=white) ![.NET](https://img.shields.io/badge/.NET-8.0-512BD4.svg?logo=dotnet&logoColor=white) ![UI](https://img.shields.io/badge/UI-WinForms-5C2D91.svg) ![SSH](https://img.shields.io/badge/SSH-SSH.NET-success.svg) ![Serial](https://img.shields.io/badge/Serial-System.IO.Ports-success.svg) ![status](https://img.shields.io/badge/status-WIP-orange.svg) ![license](https://img.shields.io/badge/license-MIT-green.svg)
+![version](https://img.shields.io/badge/version-0.3.3-blue.svg) ![platform](https://img.shields.io/badge/platform-Windows-0078D6.svg?logo=windows&logoColor=white) ![.NET](https://img.shields.io/badge/.NET-8.0-512BD4.svg?logo=dotnet&logoColor=white) ![UI](https://img.shields.io/badge/UI-WinForms-5C2D91.svg) ![SSH](https://img.shields.io/badge/SSH-SSH.NET-success.svg) ![Serial](https://img.shields.io/badge/Serial-System.IO.Ports-success.svg) ![status](https://img.shields.io/badge/status-beta-yellow.svg) ![license](https://img.shields.io/badge/license-MIT-green.svg)
 
 ---
 
@@ -63,12 +63,14 @@
 
 - ⚡ **PDU 電源控制（選用）**
   - 透過 SNMP（`SnmpSharpNet`）控制 PDU 插座，測試中遠端電源循環
+  - **Status → PDU** 分頁：連線 PDU 後每 3 秒自動輪詢插座狀態，並可用各列的 **Control** 鈕直接開 / 關該 Port
   - 腳本指令：`pduconnect` / `pductrl`
 
-- 🤖 **AI / MCP 整合（選用，規劃中）**
+- 🤖 **AI / MCP 整合（選用）**
   - **COM port 由 GUI 持有**；獨立的 stdio **Serial MCP server** 經本機 named pipe 橋接過去，供 **Kiro CLI / Claude CLI** 使用
   - 工具：`serial_list` / `serial_attach` / `serial_write` / `serial_read` / `serial_detach`
   - AI 的 serial 收發會即時顯示在 GUI（標 `[AI]`）——先在 GUI 開好 port，再讓 AI attach
+  - **一鍵設定**：在 **設定 → AI MCP** 一個按鈕就把 server 註冊進 Claude Code / Kiro
 
 - 📊 **連線 RX 日誌**
   - `logopen` / `logwrite` / `logclose` 將工作階段輸出寫檔
@@ -76,9 +78,10 @@
 ### 終端機渲染
 
 - 🎨 自繪 VT100 / ANSI 控制項（owner-drawn），雙緩衝繪字格
-- 🌑 KKTerm 風格深色主題（含 DWM 深色標題列）
+- 🌑 KKTerm 風格深色主題（含 DWM 深色標題列 + 深色終端機捲軸）
 - 🔤 可調字型 / 字級 / 配色 / scrollback 行數
-- 📋 選取 / 複製 / 貼上
+- 🖱️ 用滑鼠滾輪或深色捲軸往回捲長輸出
+- 📋 選取 / 複製 / 貼上 —— 右鍵複製會清掉反白；多行貼上採 **bracketed paste**，不會被逐行送出
 
 ---
 
@@ -271,7 +274,7 @@ wait 'login: '
 
 ## 🤖 AI / MCP 整合
 
-> 🔜 **規劃中（Phase 9）。** 讓 AI agent（**Kiro CLI / Claude CLI**）收發 serial，**而且你能在 ETTerms GUI 即時看到 AI 的每筆收發**。
+> 讓 AI agent（**Kiro CLI / Claude CLI**）收發 serial，**而且你能在 ETTerms GUI 即時看到 AI 的每筆收發**。
 
 **關鍵設計：COM port 由 GUI 唯一持有，MCP server 不自己開 port。** 一個 COM port 同時只能被一個行程開啟；因此不讓 MCP server 自己開，而是 **GUI 當 port 的唯一擁有者**，在 GUI 內跑一支本機 **named pipe server**（`SerialBridgeServer`）。獨立的 `ETTerms.SerialMcp`（由 Kiro/Claude CLI 啟動）退化成瘦客戶端：所有 `write` / `read` 都經 pipe 轉發給 GUI，由 GUI 代為讀寫實體 port。AI 的 TX 會以 `[AI]` 標色 echo 進終端機，RX/TX 都流經 GUI channel，**你看到的就是 AI 看到的**。
 
@@ -287,7 +290,11 @@ wait 'login: '
 | `serial_read` | waitFor?, timeoutMs? | 取出累積的 RX；可等待子字串或逾時 |
 | `serial_detach` | — | 解除綁定（**不會**關閉 GUI 的 port） |
 
-在 Kiro CLI 註冊：
+### 一鍵設定（推薦）
+
+在 **設定 → AI MCP**，對 Claude Code 或 Kiro 卡片按 **Setup**，一個按鈕就把 Serial MCP server 寫進該 CLI 的使用者層級設定檔（`~/.claude.json` / `~/.kiro/settings/mcp.json`）。你既有的其他 MCP server 會被保留，卡片並顯示用來驗證連線的 CLI 指令。按 **Remove** 即可移除。
+
+### 手動設定
 
 ```powershell
 kiro-cli mcp add --name serial --command dotnet --args "run --project src\ETTerms.SerialMcp\ETTerms.SerialMcp.csproj"
@@ -377,8 +384,8 @@ ETTerms/
 │   ├── Sessions/             # 連線抽象：ISessionChannel / SshChannel / SerialChannel / ShellChannel
 │   ├── Connections/          # 連線資料：Connection / ConnectionStore(SQLite) / CredentialVault
 │   ├── Scripting/            # TTL 引擎：TTLInterpreter / ScriptRunner / GroupSyncContext / Pdu
-│   └── Infrastructure/       # AppLogger / AppSettings / NativeTheme
+│   └── Infrastructure/       # AppLogger / AppSettings / McpRegistrar / NativeTheme
-└── src/ETTerms.SerialMcp/    # 🔜 Serial MCP server（stdio）—— 讓 AI agent 直接操作 serial port
+└── src/ETTerms.SerialMcp/    # Serial MCP server（stdio）—— 讓 AI agent 直接操作 serial port
 ```
 
 **核心設計：** 所有連線都實作 `ISessionChannel`（`Write(byte[])` + `event DataReceived`）。`TerminalView` 與 `TTLInterpreter` 只認得這個抽象，因此 SSH / Serial / Shell 對上層完全一致——這是「同一套腳本引擎驅動多種連線」的關鍵。詳見 [ARCHITECTURE.md](ARCHITECTURE.md)。
@@ -397,18 +404,54 @@ ETTerms/
 
 ## 📜 版本紀錄
 
-### v0.1.0（開發中）
+### v0.3.3
+
+- **終端機輸入修正** —— 終端機印過輸出後（Serial 或 PowerShell），切走再切回（縮小視窗、或點其他程式）可能導致無法打字或按 **Enter**，只能重開 session；閒置時則不受影響
+- 原因：輸出累積出 scrollback 後，視窗重新取得焦點時終端機捲軸可能搶走鍵盤焦點。捲軸已改為純滑鼠操作、永不吃焦點，無論印出多少都能正常輸入
+
+### v0.3.2
+
+- **Status → PDU 分頁** —— 新增 `Status` rail 檢視，PDU 面板移到此處：輸入 IP 連線後每 3 秒自動輪詢全部 12 個插座（背景執行緒，免手動 Refresh），即時顯示電流 / 功率
+- **手動插座開關鈕** —— 每列新增 **Control** 鈕，按一下即透過 SNMP 切換該 Port 開 / 關；按鈕文字隨狀態變動（ON →「Turn OFF」、OFF →「Turn ON」），SNMP 設定在 UI 執行緒外執行，下命令後自動回讀刷新表格
+
+### v0.3.1
+
+- **終端機體驗修正** —— 新增**深色垂直捲軸**（拖曳滑塊或點軌道翻頁，不必狂滾滑鼠看長輸出）
+- 貼多行到 Kiro CLI / PSReadLine 現在會**整段一次貼上**（**bracketed paste**，DEC mode 2004），不再逐行立即送出
+- 右鍵複製後會**清掉反白**，讓你知道已複製
+
+### v0.3.0
+
+- **AI 控制 PDU 電源（MCP）** —— 新增 `ETTerms.PduMcp` server，讓 AI agent（Kiro CLI / Claude CLI）直接控制 SNMP PDU：插座開 / 關、讀狀態、自動化測試時 power-cycle 一台 DUT
+- PDU 走 SNMP（UDP，非獨佔），AI 直接打 PDU —— ETTerms GUI 不需開著
+- 工具：`pdu_connect` / `pdu_list` / `pdu_set_port` / `pdu_get_port` / `pdu_status` / `pdu_power_cycle` / `pdu_disconnect`
+- **設定 → AI MCP** 一鍵同時註冊 `etterms-serial` 與 `etterms-pdu`；publish 會自動把兩個 MCP server 一併打包
+
+### v0.2.2
+
+- **終端機穩定性** —— 視窗最小化或切換分頁後終端機不再卡住（跑全螢幕 TUI 如 PowerShell 裡的 Kiro CLI 最明顯）；不再把退化的 1×1 尺寸送給 pseudo-console
+- **Shift+Enter** 在 shell 插入換行，可輸入多行指令（單純 Enter 仍是送出）
+- **高 DPI 修正** —— 125% / 150% 縮放下文字與按鈕不再被裁切（PerMonitorV2）；toolbar / 設定 / 側欄 / About 改為自適應縮放
+
+### v0.2.1
+
+- **AI MCP 一鍵設定** —— 新增 **設定 → AI MCP** 分頁，一個按鈕就把 Serial MCP server 註冊進 Claude Code（`~/.claude.json`）或 Kiro（`~/.kiro/settings/mcp.json`）；保留檔內其他既有 MCP server，卡片並顯示驗證指令
+- Publish 會自動把 `ETTerms.SerialMcp` 一併打包進 app 資料夾，註冊寫入的路徑必定存在
+
+### v0.2.0
+
+- **Phase 9：Serial MCP server**（`ETTerms.SerialMcp`）—— AI agent（Kiro CLI / Claude CLI）可在 serial port 收發，而你在 GUI 即時看著
+- COM port 由 GUI 唯一持有；MCP server 經本機 named pipe（`SerialBridgeServer`）橋接，自己不開 port
+- 工具：`serial_list` / `serial_attach` / `serial_write` / `serial_read` / `serial_detach`；AI 的 TX 在終端機以 `[AI]` 標色 echo
+- 新增 app 圖示（視窗 / 工作列 / 執行檔）；標題列顯示版本號
+
+### v0.1.0
 
 - Phase 1–8 完成：視窗外殼、連線側欄、平鋪工作區、Serial / SSH / 本機 Shell (ConPTY) / SFTP
 - 自繪 VT100 終端機渲染
 - TTL 腳本引擎（移植自 MyTeraTerm）+ Group 同步執行
 - PDU 電源控制（SNMP）
 - Settings / About
-- 打包待規劃
-
-**規劃中**
-
-- Phase 9：Serial MCP server（`ETTerms.SerialMcp`）—— 讓 AI agent（Kiro CLI / Claude CLI）直接操作 serial port
 
 ---
 
@@ -420,7 +463,7 @@ ETTerms/
 
 ## 🙏 致謝
 
-- **[KKTerm](https://github.com/)** — UI 設計參考（Activity Rail + 分頁工作區 + Saved Connections）
+- **[KKTerm](https://github.com/ryantsai/KKTerm)** — by ryantsai（MIT）UI 設計參考（Activity Rail + 分頁工作區 + Saved Connections）
 - **MyTeraTerm** — TTL 腳本引擎與 `AppLogger` 來源
 - **[SSH.NET](https://github.com/sshnet/SSH.NET)**、**[SnmpSharpNet](http://www.snmpsharpnet.com/)** — 開源連線 / SNMP 函式庫
 - **Microsoft** — .NET 8、WinForms、ConPTY、Credential Manager

docs/release-notes/v0.3.2.md

@@ -0,0 +1,40 @@
+# v0.3.2 — Status page with PDU outlet control
+
+## ✨ New features
+
+**Status page — control PDU outlets with buttons**
+* New **Status** view (the **⚡** icon on the left, between Terminal and Settings) with a **PDU** tab —
+  connect to your PDU by IP and see every outlet at a glance: state, current (mA) and power (W).
+* Each outlet row now has its own **Control** button: the label tracks the live state
+  (**Turn ON** when off, **Turn OFF** when on), so a single click flips that port. The SNMP command
+  runs off the UI thread, the grid refreshes after the change, and it resets cleanly on disconnect.
+* Outlet status **auto-refreshes every 3 seconds** in the background — no more manual Refresh button.
+* The PDU panel moved out of **Settings** into its own Status tab (Settings now keeps just
+  **Terminal / AI MCP**), and the layout is ready for more Status tabs later.
+
+## 🐛 Bug fixes
+
+**Local Shell startup**
+* Fixed: the local Shell no longer fails to start when its saved working folder is gone
+  (e.g. an unplugged USB drive or a deleted folder), which previously caused
+  `CreateProcess failed: 267 (ERROR_DIRECTORY)`. It now falls back to your home folder,
+  matching Windows PowerShell behavior.
+
+## 📦 Downloads
+
+Two builds are produced:
+
+| Build | Needs .NET 8 Desktop Runtime? | Notes |
+|-------|-------------------------------|-------|
+| **Standard** (`ETTerms_v0.3.2`) | ✅ Yes | Smaller; for machines that already have the runtime |
+| **Portable** (`ETTerms_v0.3.2_portable`) | ❌ No | Runtime bundled — unzip and run, no install / admin needed |
+
+Run `ETTerms v0.3.2.exe`.
+
+## 🔗 Links
+* PDU MCP & Serial MCP setup guide:
+  [docs/serial-mcp-guide.md](https://github.com/ETWen/ETTerms/blob/main/docs/serial-mcp-guide.md)
+* TTL reference:
+  [docs/ttl-script-reference.md](https://github.com/ETWen/ETTerms/blob/main/docs/ttl-script-reference.md)
+
+**Full changelog:** [v0.3.1...v0.3.2](https://github.com/ETWen/ETTerms/compare/v0.3.1...v0.3.2)

docs/release-notes/v0.3.3.md

@@ -0,0 +1,32 @@
+# v0.3.3 — Terminal input no longer dies after activity
+
+## 🐛 Bug fixes
+
+**Terminal stops accepting input after you switch away and back**
+* Fixed: once the terminal had printed some output (on a **Serial** or **PowerShell** tab),
+  switching away and back — minimizing the window, or clicking another app — could leave the
+  terminal unable to accept any typing or **Enter**. Previously the only way out was to close
+  and reopen the session (re-open the COM port / start a fresh PowerShell).
+* While the session sat idle, this never happened — it only showed up after enough output had
+  scrolled by, which is exactly when it bit you mid-task.
+* Cause: after enough output built up scrollback, the terminal's scrollbar could grab the
+  keyboard focus when the window regained focus, and the scrollbar has no keyboard handling —
+  so your keystrokes went nowhere. The scrollbar is now mouse-only and never takes focus, so
+  the terminal keeps working no matter how much it has printed.
+
+## 📦 Downloads
+
+Two builds are produced:
+
+| Build | Needs .NET 8 Desktop Runtime? | Notes |
+|-------|-------------------------------|-------|
+| **Standard** (`ETTerms_v0.3.3`) | ✅ Yes | Smaller; for machines that already have the runtime |
+| **Portable** (`ETTerms_v0.3.3_portable`) | ❌ No | Runtime bundled — unzip and run, no install / admin needed |
+
+Run `ETTerms v0.3.3.exe`.
+
+## 🔗 Links
+* PDU MCP & Serial MCP setup guide:
+  [docs/serial-mcp-guide.md](https://github.com/ETWen/ETTerms/blob/main/docs/serial-mcp-guide.md)
+
+**Full changelog:** [v0.3.2...v0.3.3](https://github.com/ETWen/ETTerms/compare/v0.3.2...v0.3.3)

docs/release-notes/v0.4.0.md

@@ -0,0 +1,61 @@
+# v0.4.0 — Performance & stability overhaul
+
+## ✨ New features
+
+**Terminal performance overhaul**
+* Heavy output (long boot logs, big file dumps) now renders much more smoothly — drawing was
+  reworked to stop re-creating fonts and brushes on every frame.
+* Scroll-back history storage was rebuilt so the terminal stays fast no matter how much output
+  has accumulated; previously it got slower and slower once the history buffer filled up.
+
+**Full-screen apps (vim / htop) behave like a real terminal**
+* The mouse wheel now scrolls inside full-screen tools like `vim` and `htop` instead of doing nothing.
+* Tools that ask the terminal "where is the cursor?" now get an answer — fixes full-screen apps
+  that could hang on startup or draw at the wrong position.
+
+**Connection status you can actually see**
+* When an SSH connection drops or hits an error, a message now appears right in the tab —
+  no more sessions that silently stop responding.
+* When the local shell exits (e.g. you type `exit`), the tab shows
+  `[ETTerms] shell process exited` instead of just going dead.
+
+**Faster PDU status (GUI and AI)**
+* Outlet polling now bundles all 12 ports into a few SNMP requests instead of 36 separate ones —
+  the Status page refreshes faster, and an unreachable PDU no longer stalls the poll for minutes.
+* The AI `pdu_status` tool gets the same speed-up.
+
+## 🐛 Bug fixes
+
+**Garbled Chinese / non-English text**
+* Fixed: multi-byte characters could occasionally turn into `�` garbage when text was split
+  across data chunks — this affected TTL script `wait` matching, what the AI reads over the
+  serial bridge, and saved session log files. All three now decode correctly.
+
+**Scrolling**
+* Fixed: while you were scrolled back reading history, any new output yanked the view down to
+  the bottom. The view now stays where you are and only follows when you're already at the bottom.
+
+**Resource & stability**
+* Fixed small memory and handle leaks when opening and closing many local shell tabs over a
+  long session.
+* Fixed: typing into an SSH session after the connection died could crash the window — it now
+  just prints a short "write failed" note in the tab.
+
+## 📦 Downloads
+
+Two builds are produced:
+
+| Build | Needs .NET 8 Desktop Runtime? | Notes |
+|-------|-------------------------------|-------|
+| **Standard** (`ETTerms_v0.4.0`) | ✅ Yes | Smaller; for machines that already have the runtime |
+| **Portable** (`ETTerms_v0.4.0_portable`) | ❌ No | Runtime bundled — unzip and run, no install / admin needed |
+
+Run `ETTerms v0.4.0.exe`.
+
+## 🔗 Links
+* PDU MCP & Serial MCP setup guide:
+  [docs/serial-mcp-guide.md](https://github.com/ETWen/ETTerms/blob/main/docs/serial-mcp-guide.md)
+* TTL reference:
+  [docs/ttl-script-reference.md](https://github.com/ETWen/ETTerms/blob/main/docs/ttl-script-reference.md)
+
+**Full changelog:** [v0.3.3...v0.4.0](https://github.com/ETWen/ETTerms/compare/v0.3.3...v0.4.0)

docs/ttl-script-reference.md

@@ -1,178 +1,306 @@
 # TTL Script Reference — ETTerms
 
 > ETTerms 的 TTL（Tera Term Language）腳本引擎移植自 MyTeraTerm，改為驅動原生
-> `ISessionChannel`（SSH / Serial 皆可）。在 **Scripts 檢視**載入 `.ttl` 腳本，對
+> `ISessionChannel`（SSH / Serial / Shell 皆可）。在分頁上按 **▶ Script** 載入 `.ttl`
-> **目前 active session** 執行（先在 Terminal 檢視開好連線）。
+> 對該分頁執行；或用 toolbar 的 **▶ Run All** / **▶ Group1-3** 批次執行。
+>
+> v0.5.0 起大幅對齊 [TeraTerm macro 指令集](https://teratermproject.github.io/manual/5/en/macro/command/index.html)。
+> 本文**前段是 ETTerms 獨有指令**，**後段是與 TeraTerm 共有的指令**。
 
 執行於背景執行緒，可隨時按 **Stop** 中止；`wait` / `pause` 期間皆可取消。
 
+腳本的 trace 訊息（`[wait]` 進度、`>>` 送出回顯、錯誤）會以灰色顯示在該分頁的終端機裡，
+可由 **Settings → Terminal → Show script trace in terminal** 關閉；`dispstr` 是腳本明確要
+顯示的內容，一律顯示。**這些灰色訊息只出現在畫面上**——不會送到裝置、不會寫進 ⏺ Log
+側錄檔、AI serial bridge 也讀不到，機台原始 log 保持乾淨。
+
 ---
 
 ## 語法規則
 
 - 一行一個指令；前後空白會被去除。
-- 註解：`;` 之後到行尾視為註解。
+- 註解：`;` 之後到行尾（**引號內的 `;` 不算**）。
-- 字串引號 `'...'` 或 `"..."` 皆可，送出時引號會被去除。
+- 字串引號 `'...'` 或 `"..."` 皆可。
-- 變數以 `名稱 = 值` 指派；名稱須符合 `^[a-zA-Z_][a-zA-Z0-9_]*$`。
+- Label：`:名稱` 一行，供 `goto` / `call` 跳轉。
-- 內建變數 `result`：`wait` 命中為 `1`、逾時為 `0`。
+- 變數以 `名稱 = 運算式` 指派；名稱須符合 `[a-zA-Z_][a-zA-Z0-9_]*`，大小寫不分。
-- 換行：`sendln` 自動附加 `\r\n`。
+- 運算式支援：整數（十進位 / `0x1F` / `$1F`）、字串、括號、`+ - * / %`、
+  比較 `= == <> != > < >= <=`、邏輯 `and or xor not`（同義 `&& || !`）。
+  比較時兩邊都是數字用數值比較，否則字串比較；未定義變數視為 `0`。
+- 單行 if：`if <條件> <指令>`（如 `if result = 0 goto retry`）；區塊 if 用 `then ... endif`。
+
+### 系統變數
+
+| 變數 | 說明 |
+|------|------|
+| `result` | 多數指令的結果碼（各指令說明）。 |
+| `inputstr` | `waitln` / `recvln` / `inputbox` / `sprintf` 的結果字串。 |
+| `matchstr` | `waitregex` / `strmatch` 命中的整段文字。 |
+| `groupmatchstr1`〜`9` | regex 群組（`waitregex` / `strmatch`）或 `strsplit` 的分段。 |
+| `timeout` | wait 家族的逾時（秒），`timeout = 10`；0 = 無限等待。 |
+| `mtimeout` | 逾時的毫秒部分，與 `timeout` 相加（`mtimeout = 500`）。 |
 
 ---
 
-## 指令對照表
+# 一、ETTerms 獨有指令
+
+## Group 同步（多分頁協同）
+
+以下指令**只能在 Run Group 模式**下使用（toolbar 的 `▶ Group1-3`）。
+`▶ Script` 和 `▶ Run All` 會拒絕含這些指令的腳本。
+Group 內的成員依序編為 **A, B, C...**（顯示在 cell footer，如 `[Group1-A]`）。
+
+> ⚠ 刻意設計：group 同步時**一個成員停止（Stop / 逾時 / 錯誤），其他成員會停在
+> barrier 等**——整組一起停下來，避免半組繼續跑造成狀態不一致。
 
 | 指令 | 語法 | 說明 |
 |------|------|------|
-| `send` | `send '文字'` | 送出文字（不加換行）到 active session。 |
+| `waitall` | `waitall '字串'` | 各成員各自 `wait` 到字串出現，再等其他成員到齊才繼續。 |
-| `sendln` | `sendln '文字'` | 送出文字並附加 `\r\n`。 |
+| `sendlnall` | `sendlnall '文字'` | 等所有成員到達此行後，每人各自 `sendln` 同一段文字。 |
-| `wait` | `wait '字串'` | **一直等到**接收緩衝出現指定字串才往下；預設無限等待（可按 Stop 取消）。命中後會再確認裝置「安靜」約 300ms（無新資料）才接受，以排除夾在輸出中途的回顯（如 `SVOS> help`），並消費到該字串**最後一次**出現（含）之前的內容，`result=1`。 |
+| `sendlngroup` | `sendlngroup A '文字'` | 只有指定 member（A/B/C...）`sendln`，其他成員跳過。 |
-| `pause` | `pause 秒數` | 暫停指定秒數（可被 Stop 中止）。 |
-| `timeout` | `timeout = 秒數` | 設定 `wait` 的逾時秒數。預設 `0`＝無限等待；若設為 `N>0`，`wait` 超過 N 秒仍未命中會**中止整個腳本並報錯**（不會略過 `wait` 往下做）。 |
-| `flushrecv` | `flushrecv` | 清空接收緩衝區。 |
-| `logopen` | `logopen '檔名'` | 開啟 log 檔（覆寫）；`send` 與 `logwrite` 會寫入。 |
-| `logwrite` | `logwrite '文字'` | 寫一行到 log 檔。 |
-| `logclose` | `logclose` | 關閉 log 檔（腳本結束時自動關閉）。 |
-| `messagebox` | `messagebox '訊息'` | 跳出訊息對話框。 |
-| `sprintf2` | `sprintf2 變數 格式 [引數 ...]` | C `printf` 風格格式化，結果存入字串變數。詳見下方說明。 |
-| `if` / `elseif` / `else` / `endif` | 見下 | 條件分支（可巢狀）。 |
-| `while` / `endwhile` | 見下 | 迴圈（可巢狀，可被 Stop 中止）。 |
-| `名稱 = 值` | `idx = 0` | 變數指派，支援 `+ - * /` 整數運算與字串。 |
-
-> **注意：** PDU 控制指令（`pductrl` / `pduconnect`）屬 Phase 7，本階段尚未提供。
-
----
-
-## Group 同步指令
-
-以下指令**只能在 Run Group 模式**下使用（toolbar 的 `▶ Group1` / `▶ Group2` / `▶ Group3`）。
-若在 `▶ Script`（分頁個別執行）或 `▶ Run All` 使用，會跳 Warning 並拒絕執行。
-
-Group 內的成員依加入順序編為 **A, B, C, D...**，顯示在 cell footer（如 `[Group1-A]`）。
-
-| 指令 | 語法 | 說明 |
-|------|------|------|
-| `waitall` | `waitall '字串'` | 各成員各自 `wait` 到指定字串出現後，再等其他成員也完成，全員到齊才繼續下一步。 |
-| `sendlnall` | `sendlnall '文字'` | 等所有成員到達此行後，每人各自對自己的 channel `sendln` 同一段文字。 |
-| `sendlngroup` | `sendlngroup A '文字'` | 只有指定 member（A/B/C...）會 `sendln`，其他成員跳過。用於 Group 內各設備需送不同指令的情境。 |
-
-### Group 範例：同步升級多台交換機
 
 ```ttl
-; Group1 有 A=SW1, B=SW2, C=SW3
+; Group1 有 A=SW1, B=SW2, C=SW3 — 同步升級
-; 每台各自等到 prompt 再同步
 waitall '#'
-
-; 各送不同指令
 sendlngroup A 'copy tftp://10.0.0.1/sw1.bin flash:'
 sendlngroup B 'copy tftp://10.0.0.1/sw2.bin flash:'
 sendlngroup C 'copy tftp://10.0.0.1/sw3.bin flash:'
-
-; 等所有人下載完畢
 waitall '#'
-
-; 全員一起 reload
 sendlnall 'reload'
-waitall 'confirm'
-sendlnall 'y'
 ```
 
-### Group 設定方式
+## PDU 電源控制（iPoMan II/III，SNMP）
 
-1. 在分頁 Tab 上**右鍵** → 選擇 `Group 1` / `Group 2` / `Group 3`（或 `No Group` 取消）
+| 指令 | 語法 | 說明 |
-2. 設定後 cell footer 會顯示 `[Group1-A]`、`[Group1-B]` 等標籤
+|------|------|------|
-3. 點 toolbar 的 `▶ Group1` 載入 `.ttl` 檔，Group 內所有成員平行執行同一份腳本
+| `pduconnect` | `pduconnect <device> <ip>` | 連 PDU 並驗證，`result` 1/0。device 為自訂編號。 |
+| `pductrl` | `pductrl <device> <port> <0\|1>` | 指定插座 OFF(0)/ON(1)，`result` 1/0。 |
+
+```ttl
+pduconnect 1 192.168.1.21
+if result = 0 goto fail
+pductrl 1 3 0        ; DUT 斷電
+pause 5
+pductrl 1 3 1        ; DUT 上電
+wait 'login:'
+:fail
+```
+
+## 行為與 TeraTerm 不同之處（重要）
+
+| 項目 | ETTerms 行為 |
+|------|--------------|
+| `wait`（**單字串**） | 命中後需裝置**安靜 300ms**（無新資料）才接受，並取「最後一次」出現——排除輸出中途的指令回顯（如 `SVOS> help`）造成腳本搶跑。**逾時會中止腳本**（TeraTerm 是 `result=0` 繼續）。 |
+| `wait`（**多字串**） | TeraTerm 相容：任一命中即繼續，`result` = 第幾個字串（1 起算）；逾時 `result=0` **繼續執行**、無 settle。 |
+| `goto` / 跨區塊跳轉 | `goto` 跳出 `if`/`while` 區塊後，該區塊的迴圈控制即結束（同層繼續直行）。避免 goto 跳「進」區塊中間。 |
+| `call` | 可以在迴圈 / if 內使用（行內執行，返回後迴圈續跑）。 |
+| `include` | 路徑須為絕對路徑，或相對於 ETTerms 的工作目錄。 |
+| 浮點數 | TTL 無浮點型別；`sprintf/sprintf2` 的浮點引數以字串傳入（`'3.14'`）。 |
 
 ---
 
-## 條件運算子
+# 二、與 TeraTerm 共有指令
 
-`if` / `elseif` / `while` 條件支援：
+## 通訊
 
-| 運算子 | 類型 | 範例 |
+| 指令 | 語法 | 說明 |
-|--------|------|------|
+|------|------|------|
-| `>=` `<=` `>` `<` | 數值 | `if idx >= 3 then` |
+| `send` | `send '文字'` | 送出文字（不加換行）。 |
-| `==` `!=` | 字串 / 數值 | `if result == 1 then` |
+| `sendln` | `sendln '文字'` | 送出文字 + `\r\n`。 |
-| `=` | 數值或字串相等 | `if result = 0 then` |
+| `sendfile` | `sendfile '路徑'` | 把整個檔案內容原樣送出（`result` 1/0）。 |
-| （無運算子） | 非零為真 | `if result then` |
+| `wait` | `wait '字串' ['字串2' ...]` | 等待字串出現（行為差異見上表）。 |
+| `waitln` | `waitln '字串' ['字串2' ...]` | 等**包含**任一字串的完整一行；該行存入 `inputstr`，`result`=第幾個；逾時 0。 |
+| `waitregex` | `waitregex '樣式' ['樣式2' ...]` | 等 regex 命中；`matchstr` / `groupmatchstr1-9` 設定，`result`=第幾個；逾時 0。 |
+| `recvln` | `recvln` | 收下一行到 `inputstr`；`result` 1 成功 / 0 逾時。 |
+| `flushrecv` | `flushrecv` | 清空接收緩衝。 |
+| `dispstr` | `dispstr '文字' [更多...]` | 在終端機顯示訊息（灰色；不送裝置、不進側錄 log、不受 Show script trace 開關影響）。 |
+| `sendbreak` | `sendbreak` | 送 serial break（**Serial 限定**，約 300ms）。 |
+| `setbaud` | `setbaud 115200` | 執行中改 baud rate（**Serial 限定**）。 |
+| `setdtr` / `setrts` | `setdtr 1` / `setrts 0` | 控制 DTR / RTS 腳位（**Serial 限定**）。 |
 
-`then` 關鍵字可省略。
+## 控制流
+
+| 指令 | 語法 | 說明 |
+|------|------|------|
+| `if` | `if <條件> <指令>` 或 `if <條件> then ... [elseif] [else] endif` | 單行或區塊，可巢狀。 |
+| `while` / `endwhile` | `while <條件>` | 條件為真時重複。 |
+| `until` / `enduntil` | `until <條件>` | 條件為**假**時重複。 |
+| `for` / `next` | `for i 1 10` | i 從 1 到 10（含），自動 ±1。 |
+| `do` / `loop` | `do [while\|until <條件>]` ... `loop [while\|until <條件>]` | 前測或後測迴圈；都不帶條件時為無限迴圈（用 `break` 離開）。 |
+| `break` / `continue` | | 跳出 / 提前進入下一輪（while / until / for / do 皆可）。 |
+| `goto` | `goto 標籤` | 跳到 `:標籤`。 |
+| `call` / `return` | `call 標籤` | 呼叫副程式（`:標籤` 起，`return` 返回；可在迴圈內用）。 |
+| `include` | `include '檔案.ttl'` | 執行另一個腳本檔（可巢狀 8 層；檔內 `exit` 只離開該檔）。 |
+| `pause` | `pause 秒` | 暫停（可 Stop 取消）。 |
+| `mpause` | `mpause 毫秒` | 毫秒級暫停。 |
+| `end` | `end` | 結束腳本（成功）。 |
+| `exit` | `exit` | include 檔內＝離開該檔；主檔＝同 `end`。 |
+| `timeout` / `mtimeout` | `timeout = 10` | wait 家族逾時（秒 / 毫秒，兩者相加）。 |
+
+## 字串
+
+| 指令 | 語法 | 說明 |
+|------|------|------|
+| `strlen` | `strlen <str>` | `result` = 長度。 |
+| `strcompare` | `strcompare <s1> <s2>` | `result` = -1 / 0 / 1。 |
+| `strconcat` | `strconcat <strvar> <str>` | strvar += str。 |
+| `strcopy` | `strcopy <str> <pos> <len> <strvar>` | 取子字串（pos 1 起算）。 |
+| `strinsert` / `strremove` | `strinsert <strvar> <pos> <str>` / `strremove <strvar> <pos> <len>` | 插入 / 刪除。 |
+| `strscan` | `strscan <str> <substr>` | `result` = 位置（1 起算，0 = 沒找到）。 |
+| `strmatch` | `strmatch <str> <regex>` | regex 比對：`result` = 位置，`matchstr` / `groupmatchstr1-9`。 |
+| `strreplace` | `strreplace <strvar> <pos> <regex> <newstr>` | 自 pos 起 regex 全部取代，`result` 1/0。 |
+| `strtrim` | `strtrim <strvar> ['字元集']` | 去頭尾字元（預設空白）。 |
+| `strsplit` | `strsplit <str> <sep> [count]` | 切成 `groupmatchstr1-9`，`result` = 個數。 |
+| `strjoin` | `strjoin <strvar> <sep> [count]` | 把 `groupmatchstr1..count` 接回一串。 |
+| `tolower` / `toupper` | `tolower <strvar> <str>` | 轉小寫 / 大寫。 |
+| `str2int` / `int2str` | `str2int <intvar> <str>` / `int2str <strvar> <int>` | 字串 ↔ 整數（str2int 的 `result` 1/0）。 |
+| `code2str` / `str2code` | `code2str <strvar> 65` / `str2code <intvar> 'A'` | 字元碼 ↔ 字元。 |
+| `sprintf` | `sprintf <格式> [引數...]` | C printf 格式化 → **`inputstr`**。 |
+| `sprintf2` | `sprintf2 <strvar> <格式> [引數...]` | 同上但存到指定變數（詳見下節）。 |
+| `expandenv` | `expandenv <strvar> '%USERPROFILE%\x'` | 展開環境變數。 |
+
+## 檔案 / 資料夾
+
+| 指令 | 語法 | 說明 |
+|------|------|------|
+| `fileopen` | `fileopen <fhvar> <路徑> <append 0\|1> [readonly 0\|1]` | 開檔；fh 存入變數（-1 失敗）。readonly=1 開來讀。 |
+| `filecreate` | `filecreate <fhvar> <路徑>` | 建新檔（覆寫）供寫入。 |
+| `filereadln` | `filereadln <fh> <strvar>` | 讀一行；`result` **1 = EOF**、0 = 成功（TeraTerm 相容）。 |
+| `filewrite` / `filewriteln` | `filewrite <fh> <str>` | 寫入（ln 版加換行）。 |
+| `fileclose` | `fileclose <fh>` | 關檔（腳本結束會自動關）。 |
+| `filedelete` | `filedelete <路徑>` | 刪檔，`result` 1/0。 |
+| `filesearch` | `filesearch <路徑>` | `result` 1 = 檔案存在。 |
+| `basename` / `dirname` | `basename <strvar> <路徑>` | 取檔名 / 取目錄。 |
+| `makepath` | `makepath <strvar> <dir> <file>` | 合成路徑。 |
+| `foldercreate` / `folderdelete` / `foldersearch` | `foldercreate <路徑>` | 建 / 刪（空）/ 查資料夾。 |
+| `getdir` / `setdir` | `getdir <strvar>` / `setdir <路徑>` | 取得 / 變更工作目錄。 |
+| `logopen` / `logwrite` / `logclose` | `logopen '檔名'` | 腳本專屬 log 檔（`send` 與 `logwrite` 會寫入）。 |
+
+## 對話框 / 雜項
+
+| 指令 | 語法 | 說明 |
+|------|------|------|
+| `messagebox` | `messagebox '訊息' ['標題']` | 訊息框。 |
+| `inputbox` | `inputbox '提示' ['標題'] [預設值]` | 輸入框 → `inputstr`（取消 `result=0`）。 |
+| `yesnobox` | `yesnobox '訊息' ['標題']` | Yes/No → `result` 1/0。 |
+| `beep` | `beep` | 系統提示音。 |
+| `getdate` / `gettime` | `getdate <strvar> ['%Y%m%d']` | 日期 / 時間字串（strftime 子集：`%Y %y %m %d %H %M %S %j %a %A %b`）。 |
+| `getenv` / `setenv` | `getenv 'PATH' <strvar>` | 讀 / 寫環境變數（行程內）。 |
+| `random` | `random <intvar> <max>` | 0〜max（含）亂數。 |
+| `exec` | `exec '記事本.exe 檔案' ['show'\|'hide'] [wait 0\|1]` | 啟動外部程式；wait=1 時 `result` = exit code。 |
+| `getver` | `getver <strvar>` | ETTerms 版本字串。 |
+| `getttdir` | `getttdir <strvar>` | ETTerms 執行檔目錄。 |
+| `uptime` | `uptime <intvar>` | 系統開機至今毫秒數。 |
+| `ifdefined` | `ifdefined <var>` | `result`：0 未定義 / 1 整數 / 2 字串。 |
+| `clipb2var` / `var2clipb` | `clipb2var <strvar>` / `var2clipb <str>` | 剪貼簿 ↔ 變數。 |
+| `crc32` | `crc32 <intvar> <str>` | CRC-32。 |
+| `checksum8/16/32` | `checksum8 <intvar> <str>` | byte 加總（8/16/32 bit）。 |
+
+### 未支援（節錄）
+
+檔案傳輸協定（`xmodem*` / `zmodem*` / `kmt*` / `scp*`）、連線管理（`connect` / `disconnect` /
+`closett`）、密碼系列（`getpassword` 等——ETTerms 密碼一律走 Windows Credential Manager）、
+陣列（`intdim` / `strdim`）、`waitevent` / `waitn` / `setecho` / `settitle` / `listbox` / `statusbox`。
 
 ---
 
 ## sprintf2 格式化
 
-`sprintf2 變數 格式字串 [引數 ...]` 以 C 語言 `printf` 規則格式化，結果存入指定字串變數，與
+`sprintf2 變數 格式字串 [引數 ...]` 以 C `printf` 規則格式化，與 Tera Term 一致。
-Tera Term 的 `sprintf2` 行為一致。
 
 ```ttl
-sprintf2 ver 'Tera Term 4.%d' 51            ; ver = "Tera Term 4.51"
+sprintf2 ver 'Tera Term 4.%d' 51                  ; ver = "Tera Term 4.51"
-sprintf2 win 'Windows %d (+%s)' 2000 'SP4'   ; win = "Windows 2000 (+SP4)"
 sprintf2 test '%s=%d %s=0x%x' 'dec' 10 'hex' 33   ; test = "dec=10 hex=0x21"
-messagebox test
 ```
 
-- **轉換型別**：`c d i o u x X e E f g G a A s`
+- **轉換型別**：`c d i o u x X e E f g G a A s`；**旗標**：`- + 0 #` 與空白；寬度/精度支援 `*`
-- **旗標**：`-`（靠左）、`+`（顯示正負號）、`0`（補零）、`#`（替代格式，如 `0x`）、空白（正數前空格）
+- 浮點數以**字串**傳入：`sprintf2 s '%.2f' '3.14159'`
-- **寬度／精度**：十進位整數，或用 `*` 從引數動態取得（如 `%*d`、`%.*f`）
+- 格式字串不展開變數（保持字面值），引數會展開，故 `sprintf2 s '%s,' s` 可累加自身
-- 浮點數須以**字串**傳入（TTL 無浮點型別），例 `sprintf2 s '%.2f' '3.14159'`
+- `result`：0 成功、1 缺格式、2 格式無效、3 引數無效、4 目的變數無效
-- **格式字串不展開變數**（保持字面值），僅各引數會展開變數，故可累加自身：
-  `sprintf2 s '%s,' s` 會把 `s` 接上 `,`
-
-執行後設定系統變數 `result`：
-
-| 值 | 狀態 |
-|----|------|
-| 0 | 格式化成功 |
-| 1 | 缺少格式字串 |
-| 2 | 格式無效 |
-| 3 | 引數無效（缺少或無法解析） |
-| 4 | 目的變數名稱無效 |
 
 ---
 
-## 範例：SSH 自動登入 + 收 log
+## 範例
+
+### 自動登入 + 失敗重試（goto / 單行 if）
 
 ```ttl
-; 等提示字元，逐步登入並收集輸出
 timeout = 15
+retry = 0
 
+:login
+sendln ''
 wait 'login:'
 sendln 'admin'
 wait 'Password:'
 sendln 'secret'
-wait '$'
+wait 'Login incorrect' '$'
+if result = 2 goto ok        ; 第 2 個字串（$ 提示）命中 → 成功
+retry = retry + 1
+if retry < 3 goto login
+messagebox '登入失敗 3 次' 'Login'
+end
 
-logopen 'session.log'
+:ok
-sendln 'uname -a'
+dispstr 'login ok'
-wait '$'
-sendln 'uptime'
-wait '$'
-logclose
-
-messagebox 'Done'
 ```
 
-## 範例：while 迴圈下命令
+### waitln + strmatch 解析輸出
 
 ```ttl
-idx = 0
+sendln 'show environment'
-while idx < 5
+timeout = 10
-    sendln 'echo loop'
+waitln 'Temperature'                       ; 例如 "Temperature: 47 C"
-    wait '$'
+if result = 0 goto notfound
-    idx = idx + 1
+strmatch inputstr 'Temperature:\s*(\d+)'
-endwhile
+if result > 0 then
-```
+    str2int temp groupmatchstr1
-
+    if temp > 60 then
-## 範例：if / elseif / else
+        messagebox '過溫！' 'ALERT'
-
+    endif
-```ttl
-sendln 'whoami'
-wait '$'
-if result == 1 then
-    logwrite 'prompt matched'
-elseif result == 0 then
-    logwrite 'timed out'
-else
-    logwrite 'unknown'
 endif
+:notfound
+```
+
+### for 迴圈 + 檔案輸出
+
+```ttl
+getdate today '%Y%m%d'
+sprintf 'report_%s.txt' today
+filecreate fh inputstr
+
+for i 1 5
+    sendln 'cat /proc/loadavg'
+    recvln                       ; 回顯
+    recvln                       ; 資料行
+    filewriteln fh inputstr
+    pause 2
+next
+fileclose fh
+```
+
+### call 副程式（迴圈內可用）
+
+```ttl
+for i 1 3
+    call powercycle
+    wait 'login:'
+next
+end
+
+:powercycle
+pductrl 1 3 0
+pause 5
+pductrl 1 3 1
+return
+```
+
+### do-loop 等裝置就緒
+
+```ttl
+; 注意：單字串 wait 逾時會「中止腳本」，輪詢請用 waitln（逾時 result=0 繼續）
+timeout = 2
+do
+    sendln ''
+    waitln 'SVOS>'
+loop until result = 1      ; 每 2 秒敲一次直到提示出現
 ```

src/ETTerms.PduCore/ETTerms.PduCore.csproj

@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>ETTerms.PduCore</RootNamespace>
+    <AssemblyName>ETTerms.PduCore</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="SnmpSharpNet" Version="0.9.7">
+      <NoWarn>NU1701</NoWarn>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>

src/ETTerms.PduCore/PduController.cs

@@ -0,0 +1,124 @@
+using System.Net;
+using SnmpSharpNet;
+
+namespace ETTerms.PduCore;
+
+/// <summary>
+/// PDU controller for iPoMan II/III models via SNMP。
+/// GUI 與 ETTerms.PduMcp 共用的唯一實作（v0.4.0 起取代兩份複製的版本）。
+/// 診斷輸出走建構子注入的 log 委派：GUI 給 AppLogger、MCP server 給 stderr
+/// （stdio MCP 的 stdout 專供 JSON-RPC，不可污染）。
+/// SNMP 走 UDP、非獨佔，多個行程可同時對同一台 PDU 操作。
+/// </summary>
+public sealed class PduController : IDisposable
+{
+    private readonly string _ip;
+    private readonly Action<string>? _logInfo;
+    private readonly Action<string>? _logWarn;
+
+    private const string Community = "private";
+    private const int SnmpPort = 161;
+    private const int Timeout = 3000;
+
+    public string Ip => _ip;
+
+    public PduController(string ip, Action<string>? logInfo = null, Action<string>? logWarn = null)
+    {
+        _ip = ip;
+        _logInfo = logInfo;
+        _logWarn = logWarn;
+    }
+
+    /// <summary>讀 PDU 型號/名稱 OID；非空且含 "PDU" 代表連得上。</summary>
+    public string? GetModelName() => SnmpGet(".1.3.6.1.4.1.2468.1.4.2.1.1.4");
+
+    public bool CheckConnection()
+    {
+        var name = GetModelName();
+        _logInfo?.Invoke($"[PDU] CheckConnection {_ip}: name='{name ?? "<null>"}'");
+        return !string.IsNullOrEmpty(name) && name.Contains("PDU");
+    }
+
+    public bool SetPortOn(int port) => SnmpSet(PortControlOid(port), new Integer32(3));
+    public bool SetPortOff(int port) => SnmpSet(PortControlOid(port), new Integer32(4));
+
+    /// <summary>true = on, false = off, null = unknown/unreachable.</summary>
+    public bool? GetPortState(int port) => ParseState(SnmpGet(PortStateOid(port)));
+
+    public int? GetPortCurrent(int port) => int.TryParse(SnmpGet(PortCurrentOid(port)), out int v) ? v : null;
+    public double? GetPortPowerWatts(int port) => int.TryParse(SnmpGet(PortPowerOid(port)), out int v) ? v / 10.0 : null;
+
+    /// <summary>
+    /// 一次讀回所有插座的狀態 / 電流(mA) / 功率(W)。
+    /// 以 3 個批次 SNMP GET（每個 PDU 含 <paramref name="portCount"/> 個 varbind）取代
+    /// 逐 port 逐 OID 的 3×N 個請求 —— 12 port 從 36 個 UDP 來回縮成 3 個，
+    /// 逾時時的最壞情況也從 36×Timeout 縮到 3×Timeout。
+    /// </summary>
+    public (bool? State, int? CurrentMilliAmps, double? PowerWatts)[] GetAllPortsStatus(int portCount)
+    {
+        var ports = Enumerable.Range(1, portCount).ToArray();
+        var states = SnmpGetMany(ports.Select(PortStateOid).ToArray());
+        var currents = SnmpGetMany(ports.Select(PortCurrentOid).ToArray());
+        var powers = SnmpGetMany(ports.Select(PortPowerOid).ToArray());
+
+        var result = new (bool?, int?, double?)[portCount];
+        for (int i = 0; i < portCount; i++)
+        {
+            result[i] = (
+                ParseState(states[i]),
+                int.TryParse(currents[i], out int c) ? c : null,
+                int.TryParse(powers[i], out int p) ? p / 10.0 : null);
+        }
+        return result;
+    }
+
+    private static bool? ParseState(string? r) => r == "3" ? true : (r == "2" || r == "4") ? false : null;
+
+    private static string PortControlOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.4.1.2.{port}";
+    private static string PortStateOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.2.{port}";
+    private static string PortCurrentOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.3.{port}";
+    private static string PortPowerOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.5.{port}";
+
+    private bool SnmpSet(string oid, AsnType value)
+    {
+        try
+        {
+            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
+            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
+            var pdu = new SnmpSharpNet.Pdu(PduType.Set);
+            pdu.VbList.Add(new Oid(oid), value);
+            var result = (SnmpV1Packet)target.Request(pdu, param);
+            return result?.Pdu.ErrorStatus == 0;
+        }
+        catch (Exception ex) { _logWarn?.Invoke($"[PDU] SNMP SET {oid} exception: {ex.Message}"); return false; }
+    }
+
+    private string? SnmpGet(string oid)
+    {
+        var r = SnmpGetMany(new[] { oid });
+        return r[0];
+    }
+
+    /// <summary>一個 SNMP GET 帶多個 OID（varbind），回傳同序的值；失敗整批回 null。</summary>
+    private string?[] SnmpGetMany(string[] oids)
+    {
+        var result = new string?[oids.Length];
+        try
+        {
+            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
+            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
+            var pdu = new SnmpSharpNet.Pdu(PduType.Get);
+            foreach (var oid in oids) pdu.VbList.Add(new Oid(oid));
+            var resp = (SnmpV1Packet)target.Request(pdu, param);
+            if (resp == null) { _logWarn?.Invoke($"[PDU] SNMP GET ({oids.Length} oids): no response (timeout)"); return result; }
+            if (resp.Pdu.ErrorStatus != 0) { _logWarn?.Invoke($"[PDU] SNMP GET ({oids.Length} oids): ErrorStatus={resp.Pdu.ErrorStatus}"); return result; }
+            // SNMP GET 回應的 varbind 順序與請求一致，直接依 index 對回去。
+            int n = Math.Min(oids.Length, resp.Pdu.VbList.Count);
+            for (int i = 0; i < n; i++) result[i] = resp.Pdu.VbList[i].Value.ToString();
+        }
+        catch (Exception ex) { _logWarn?.Invoke($"[PDU] SNMP GET ({oids.Length} oids) exception: {ex.Message}"); }
+        return result;
+    }
+
+    public void Dispose() { }
+}

src/ETTerms.PduMcp/ETTerms.PduMcp.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>ETTerms.PduMcp</RootNamespace>
+    <AssemblyName>ETTerms.PduMcp</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="ModelContextProtocol" Version="1.2.0" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\ETTerms.PduCore\ETTerms.PduCore.csproj" />
+  </ItemGroup>
+
+</Project>

src/ETTerms.PduMcp/PduRegistry.cs

@@ -0,0 +1,35 @@
+using System.Collections.Concurrent;
+using ETTerms.PduCore;
+
+namespace ETTerms.PduMcp;
+
+/// <summary>
+/// Process-wide registry of connected PDUs, keyed by IP. The MCP server is long-lived,
+/// so connections established by <c>pdu_connect</c> persist across tool calls.
+/// </summary>
+public sealed class PduRegistry
+{
+    public static readonly PduRegistry Instance = new();
+
+    /// <summary>iPoMan II/III outlet count.</summary>
+    public const int PortCount = 12;
+
+    private readonly ConcurrentDictionary<string, PduController> _pdus = new(StringComparer.OrdinalIgnoreCase);
+
+    public PduController GetOrAdd(string ip) =>
+        _pdus.GetOrAdd(ip.Trim(), static k => new PduController(k, Log, Log));
+
+    // stdio MCP server：stdout 專供 JSON-RPC，診斷一律走 stderr。
+    private static void Log(string msg) => Console.Error.WriteLine(msg);
+
+    public bool TryGet(string ip, out PduController pdu) =>
+        _pdus.TryGetValue(ip.Trim(), out pdu!);
+
+    public bool Remove(string ip)
+    {
+        if (_pdus.TryRemove(ip.Trim(), out var pdu)) { pdu.Dispose(); return true; }
+        return false;
+    }
+
+    public IReadOnlyCollection<string> ConnectedIps => _pdus.Keys.ToArray();
+}

src/ETTerms.PduMcp/PduTools.cs

@@ -0,0 +1,144 @@
+using System.ComponentModel;
+using System.Text;
+using System.Text.Json;
+using ETTerms.PduCore;
+using ModelContextProtocol.Server;
+
+namespace ETTerms.PduMcp;
+
+/// <summary>
+/// MCP tools exposed to the AI for controlling an SNMP PDU (iPoMan II/III).
+///
+/// Unlike the serial bridge, the PDU is reached directly over SNMP — the ETTerms GUI
+/// does NOT need to be running. Connections are held per-IP and persist for the lifetime
+/// of this MCP server. Always <c>pdu_connect</c> an IP first, then control its ports.
+/// </summary>
+[McpServerToolType]
+public static class PduTools
+{
+    private static readonly JsonSerializerOptions Json = new() { WriteIndented = false };
+
+    [McpServerTool, Description("Connect to a PDU over SNMP by IP and verify it responds. Required before controlling ports. Returns the model name on success.")]
+    public static Task<string> pdu_connect(
+        [Description("PDU IP address, e.g. 192.168.1.21")] string ip)
+    {
+        ip = (ip ?? "").Trim();
+        if (ip.Length == 0) return Err("ip is required");
+        var pdu = PduRegistry.Instance.GetOrAdd(ip);
+        var model = pdu.GetModelName();
+        bool ok = !string.IsNullOrEmpty(model) && model.Contains("PDU");
+        if (!ok)
+        {
+            PduRegistry.Instance.Remove(ip);
+            return Err($"no SNMP response from PDU at {ip} (check IP/network/community)");
+        }
+        return Ok(new { ip, model });
+    }
+
+    [McpServerTool, Description("List PDUs currently connected in this MCP session (by IP).")]
+    public static Task<string> pdu_list()
+        => Ok(new { connected = PduRegistry.Instance.ConnectedIps });
+
+    [McpServerTool, Description("Turn a PDU outlet on or off. The PDU must be connected first via pdu_connect.")]
+    public static Task<string> pdu_set_port(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port,
+        [Description("true = ON, false = OFF")] bool on)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return Err(error);
+        bool ok = on ? pdu.SetPortOn(port) : pdu.SetPortOff(port);
+        if (!ok) return Err($"SNMP set failed for {ip} port {port}");
+        return Ok(new { ip, port, state = on ? "on" : "off" });
+    }
+
+    [McpServerTool, Description("Read a single outlet's state, current (mA) and power (W).")]
+    public static Task<string> pdu_get_port(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return Err(error);
+        return Ok(PortSnapshot(pdu, port));
+    }
+
+    [McpServerTool, Description("Read the state, current (mA) and power (W) of all outlets on the PDU.")]
+    public static Task<string> pdu_status(
+        [Description("PDU IP address")] string ip)
+    {
+        if (!PduRegistry.Instance.TryGet(ip, out var pdu))
+            return Err($"PDU {ip} not connected. Call pdu_connect first.");
+        // 批次 SNMP GET：12 port 只需 3 個 UDP 來回，而非逐 port 逐 OID 36 個。
+        var all = pdu.GetAllPortsStatus(PduRegistry.PortCount);
+        var ports = new List<object>();
+        for (int p = 0; p < all.Length; p++)
+        {
+            var (state, current, power) = all[p];
+            ports.Add(new
+            {
+                port = p + 1,
+                state = state == true ? "on" : state == false ? "off" : "unknown",
+                currentMilliAmps = current,
+                powerWatts = power
+            });
+        }
+        return Ok(new { ip, ports });
+    }
+
+    [McpServerTool, Description("Power-cycle an outlet: turn it OFF, wait offSeconds, then turn it ON. Useful for rebooting a DUT.")]
+    public static async Task<string> pdu_power_cycle(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port,
+        [Description("Seconds to stay off before powering back on")] int offSeconds = 5)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return await Err(error);
+        if (offSeconds < 0) offSeconds = 0;
+        if (!pdu.SetPortOff(port)) return await Err($"SNMP off failed for {ip} port {port}");
+        await Task.Delay(offSeconds * 1000);
+        if (!pdu.SetPortOn(port)) return await Err($"SNMP on failed for {ip} port {port}");
+        return await Ok(new { ip, port, action = "power_cycle", offSeconds, state = "on" });
+    }
+
+    [McpServerTool, Description("Disconnect a PDU from this MCP session (does not change outlet states).")]
+    public static Task<string> pdu_disconnect(
+        [Description("PDU IP address")] string ip)
+        => Ok(new { ip, removed = PduRegistry.Instance.Remove(ip) });
+
+    // ── helpers ──
+
+    private static bool TryResolve(string ip, int port, out PduController pdu, out string error)
+    {
+        pdu = null!;
+        error = "";
+        if (port < 1 || port > PduRegistry.PortCount)
+        {
+            error = $"port must be 1-{PduRegistry.PortCount}";
+            return false;
+        }
+        if (!PduRegistry.Instance.TryGet(ip, out pdu))
+        {
+            error = $"PDU {ip} not connected. Call pdu_connect first.";
+            return false;
+        }
+        return true;
+    }
+
+    private static object PortSnapshot(PduController pdu, int port)
+    {
+        var state = pdu.GetPortState(port);
+        return new
+        {
+            port,
+            state = state == true ? "on" : state == false ? "off" : "unknown",
+            currentMilliAmps = pdu.GetPortCurrent(port),
+            powerWatts = pdu.GetPortPowerWatts(port)
+        };
+    }
+
+    private static Task<string> Ok(object payload)
+    {
+        var node = new { ok = true, result = payload };
+        return Task.FromResult(JsonSerializer.Serialize(node, Json));
+    }
+
+    private static Task<string> Err(string message)
+        => Task.FromResult(JsonSerializer.Serialize(new { ok = false, error = message }, Json));
+}

src/ETTerms.PduMcp/Program.cs

@@ -0,0 +1,17 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+
+// stdio MCP server：把 SNMP PDU 控制暴露給 AI（Kiro / Claude CLI）。
+// 與 ETTerms.SerialMcp 不同，PDU 走 SNMP(UDP) 非獨佔，故直接打 SNMP，不需 GUI 在跑。
+var builder = Host.CreateApplicationBuilder(args);
+
+// stdio 傳輸：stdout 專供 JSON-RPC，log 一律走 stderr，否則會污染協議。
+builder.Logging.AddConsole(o => o.LogToStandardErrorThreshold = LogLevel.Trace);
+
+builder.Services
+    .AddMcpServer()
+    .WithStdioServerTransport()
+    .WithToolsFromAssembly();
+
+await builder.Build().RunAsync();

src/ETTerms/App/AboutView.cs

@@ -21,7 +21,7 @@ public sealed class AboutView : UserControl
         var left = new FlowLayoutPanel
         {
             Dock = DockStyle.Left, Width = 380, FlowDirection = FlowDirection.TopDown,
-            WrapContents = false, AutoScroll = false, Padding = new Padding(20),
+            WrapContents = false, AutoScroll = true, Padding = new Padding(20),
             BackColor = Theme.WorkspaceBack
         };
 
@@ -73,7 +73,7 @@ public sealed class AboutView : UserControl
         {
             var header = new Label
             {
-                AutoSize = false, Width = 500, Height = 22,
+                AutoSize = true,
                 Text = $"● v{entry.Version}  ·  {entry.Title}    ({entry.Date:yyyy-MM-dd})",
                 ForeColor = Theme.Accent, Font = Theme.UiFontBold,
                 Margin = new Padding(0, 8, 0, 2)
@@ -83,7 +83,7 @@ public sealed class AboutView : UserControl
             {
                 right.Controls.Add(new Label
                 {
-                    AutoSize = false, Width = 500, Height = 20,
+                    AutoSize = true,
                     Text = $"    • {change}",
                     ForeColor = Theme.Text, Font = Theme.UiFont,
                     Margin = new Padding(0)
@@ -99,18 +99,17 @@ public sealed class AboutView : UserControl
 
     private static Panel MakeCard(int width, int height, Action<FlowLayoutPanel> build)
     {
-        var card = new Panel
+        // 卡片本身就是 TopDown 的 AutoSize FlowLayoutPanel：高度永遠長到容得下內容
+        // （高 DPI 字變大也不會被裁），MinimumSize 維持 100% 的設計尺寸。
+        var card = new FlowLayoutPanel
         {
-            Width = width, Height = height, Margin = new Padding(0, 0, 0, 12),
+            FlowDirection = FlowDirection.TopDown, WrapContents = false,
+            AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(width, height),
+            Margin = new Padding(0, 0, 0, 12),
             BackColor = Theme.TabBack, Padding = new Padding(12)
         };
-        var flow = new FlowLayoutPanel
+        build(card);
-        {
-            Dock = DockStyle.Fill, FlowDirection = FlowDirection.TopDown,
-            WrapContents = false, BackColor = Theme.TabBack, AutoSize = false
-        };
-        build(flow);
-        card.Controls.Add(flow);
         return card;
     }
 
@@ -149,24 +148,31 @@ public sealed class AboutView : UserControl
     {
         return new Label
         {
-            AutoSize = false, Width = 310, Height = 20,
+            AutoSize = true,
             Text = text, Font = font, ForeColor = color,
-            TextAlign = align, Margin = new Padding(0)
+            TextAlign = align, Margin = new Padding(0, 1, 0, 1)
         };
     }
 
-    private static Panel MakeRow(string label, string value)
+    private static Control MakeRow(string label, string value)
     {
-        var row = new Panel { Width = 310, Height = 20, Margin = new Padding(0, 2, 0, 0), BackColor = Color.Transparent };
+        var row = new FlowLayoutPanel
+        {
+            AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            FlowDirection = FlowDirection.LeftToRight, WrapContents = false,
+            Margin = new Padding(0, 2, 0, 0), BackColor = Color.Transparent
+        };
         row.Controls.Add(new Label
         {
-            Text = value, AutoSize = false, Width = 230, Height = 20, Dock = DockStyle.Right,
+            Text = label, AutoSize = true, MinimumSize = new Size(70, 0),
-            ForeColor = Theme.Text, Font = Theme.UiFont, TextAlign = ContentAlignment.MiddleRight
+            ForeColor = Theme.TextDim, Font = Theme.UiFont,
+            TextAlign = ContentAlignment.MiddleLeft, Margin = new Padding(0, 0, 8, 0)
         });
         row.Controls.Add(new Label
         {
-            Text = label, AutoSize = false, Width = 70, Height = 20, Dock = DockStyle.Left,
+            Text = value, AutoSize = true,
-            ForeColor = Theme.TextDim, Font = Theme.UiFont, TextAlign = ContentAlignment.MiddleLeft
+            ForeColor = Theme.Text, Font = Theme.UiFont,
+            TextAlign = ContentAlignment.MiddleLeft, Margin = new Padding(0)
         });
         return row;
     }
@@ -177,6 +183,66 @@ public sealed class AboutView : UserControl
 
     private static readonly ChangelogEntry[] Changelog =
     [
+        new("0.5.0", new DateOnly(2026, 7, 2), "Search, keyword alerts & a much bigger scripting language",
+        [
+            "Press Ctrl+F in any terminal to search everything you've scrolled past — all hits are highlighted, Enter jumps between them.",
+            "New Settings → Highlight page: add your own keywords (like ERROR or FAIL) and they light up in red wherever they appear.",
+            "When a keyword shows up in a tab you're not looking at, that tab's dot turns red so you don't miss it.",
+            "TTL scripting grew from ~15 commands to 90+, matching Tera Term macros: loops (for / do / until), goto and subroutines, waitln / waitregex with regex capture, string and file operations, input dialogs, and serial line control (sendbreak, setbaud).",
+            "Scripts now show their progress in gray right inside the terminal — display only, never written to session logs; turn it off in Settings → Terminal (Show script trace) if you want a clean screen.",
+            "See the full command table with examples in docs/ttl-script-reference.md.",
+        ]),
+        new("0.4.0", new DateOnly(2026, 7, 2), "Performance & stability overhaul",
+        [
+            "The terminal is much smoother during heavy output (long boot logs, big file dumps) — drawing and scroll history were reworked to stay fast no matter how much text has scrolled by.",
+            "Fixed Chinese and other non-English text occasionally turning into garbled characters — in script 'wait' matching, in what the AI reads from the serial port, and in saved session logs.",
+            "While you are scrolled back reading history, new output no longer yanks the view down to the bottom.",
+            "The mouse wheel now scrolls inside full-screen tools like vim and htop instead of doing nothing.",
+            "Full-screen tools that ask the terminal where the cursor is now get an answer, fixing apps that could hang or draw at the wrong position.",
+            "You now see a clear message in the tab when an SSH connection drops or the local shell exits, instead of the session silently going dead.",
+            "PDU status refresh is much faster and lighter on the network (one bundled query instead of 36 separate ones).",
+            "Fixed small memory and handle leaks when opening many local shell tabs over a long session.",
+        ]),
+        new("0.3.3", new DateOnly(2026, 6, 16), "Bugfix — terminal input no longer dies after activity",
+        [
+            "Fixed: after the terminal had printed output (Serial or PowerShell), switching away and back — minimizing, or clicking another window — left the terminal unable to accept any typing or Enter, forcing you to reopen the session.",
+            "Cause: once enough output scrolled by, the terminal's scrollbar could steal the keyboard focus when the window regained focus. The scrollbar is now mouse-only and never takes focus, so input keeps working.",
+        ]),
+        new("0.3.2", new DateOnly(2026, 6, 11), "New Status page — control PDU outlets with buttons",
+        [
+            "New Status page (the ⚡ icon on the left) with a PDU tab — connect to your PDU by IP and see every outlet at a glance.",
+            "Each outlet now has its own on/off button: the button shows \"Turn ON\" or \"Turn OFF\" depending on the current state, so one click flips it.",
+            "Outlet status, current and power refresh automatically every 3 seconds — no need to hit Refresh anymore.",
+            "Fixed: the local Shell no longer fails to start when its saved folder is gone (e.g. an unplugged USB drive); it now falls back to your home folder.",
+        ]),
+        new("0.3.1", new DateOnly(2026, 6, 8), "Bugfix — terminal usability",
+        [
+            "Added a scrollbar on the right of the terminal — just drag it to look back through long output, instead of spinning the mouse wheel for ages.",
+            "Fixed pasting multiple lines into Kiro CLI (and similar tools): the whole block now pastes in one go, instead of each line being sent off immediately.",
+            "After you right-click to copy, the highlight now clears so you can tell the copy actually worked.",
+        ]),
+        new("0.3.0", new DateOnly(2026, 6, 8), "AI power control for PDU outlets",
+        [
+            "AI assistants (Kiro / Claude) can now switch your PDU power outlets on and off for you.",
+            "Great for automated testing — the AI can power-cycle (restart) a connected device by itself.",
+            "Works even when the main ETTerms window isn't open.",
+            "One click in Settings → AI MCP now sets up both the Serial and PDU AI helpers at the same time.",
+        ]),
+        new("0.2.2", new DateOnly(2026, 6, 5), "Bugfix — terminal stability",
+        [
+            "Fixed: the terminal no longer freezes after minimizing or switching tabs (notably in PowerShell / Kiro).",
+            "Added: Shift+Enter inserts a newline in the shell, so you can type multi-line commands.",
+        ]),
+        new("0.2.1", new DateOnly(2026, 6, 4), "AI MCP one-click setup",
+        [
+            "New Settings → AI MCP tab: register the Serial MCP server into Claude Code or Kiro with one click.",
+            "Lets AI agents drive the serial port for you.",
+        ]),
+        new("0.2.0", new DateOnly(2026, 6, 4), "Beta Version Release",
+        [
+            "AI agents can now send/receive on the serial port while you watch it live in the GUI.",
+            "New app icon and version shown in the title bar.",
+        ]),
         new("0.1.0", new DateOnly(2026, 6, 3), "Initial Release",
         [
             "Beta Version: expect bugs and missing features. Feedback welcome!",

src/ETTerms/App/ActivityRail.cs

@@ -10,17 +10,20 @@ namespace ETTerms.App;
 /// </summary>
 public sealed class ActivityRail : UserControl
 {
-    public enum RailView { Terminal, Settings, About }
+    public enum RailView { Terminal, Status, Settings, About }
 
     public event EventHandler<RailView>? ViewSelected;
 
     private RailView _active = RailView.Terminal;
     private RailView? _hover;
 
-    private const int ItemSize = 56;
+    private const int BaseItemSize = 56;
+    /// <summary>依目前螢幕 DPI 縮放的格子大小（owner-draw 不會自動縮放像素，需自己換算）。</summary>
+    private int ItemSize => (int)Math.Round(BaseItemSize * (DeviceDpi / 96.0));
     private static readonly (RailView view, string glyph, string tip)[] Items =
     {
         (RailView.Terminal, "▤", "Terminal"),
+        (RailView.Status, "⚡", "Status"),
         (RailView.Settings, "⚙", "Settings"),
         (RailView.About, "ℹ", "About"),
     };
@@ -37,6 +40,19 @@ public sealed class ActivityRail : UserControl
         Cursor = Cursors.Hand;
     }
 
+    protected override void OnHandleCreated(EventArgs e)
+    {
+        base.OnHandleCreated(e);
+        Width = ItemSize;   // handle 建立後 DeviceDpi 才正確，依實際 DPI 重設寬度
+    }
+
+    protected override void OnDpiChangedAfterParent(EventArgs e)
+    {
+        base.OnDpiChangedAfterParent(e);
+        Width = ItemSize;   // 拖到不同縮放的螢幕時跟著調整
+        Invalidate();
+    }
+
     [System.ComponentModel.DesignerSerializationVisibility(
         System.ComponentModel.DesignerSerializationVisibility.Hidden)]
     public RailView ActiveView

src/ETTerms/App/ConnectionSidebar.cs

@@ -49,10 +49,11 @@ public sealed class ConnectionSidebar : UserControl
         BackColor = Theme.SidebarBack;
 
         // ── Tab bar (Sessions / SFTP) ──
+        // 高度 40 與右側 Workspace 工具列對齊，讓「CONNECTIONS / 連線清單」與右側分頁列同一條基準線
         var tabBar = new FlowLayoutPanel
         {
-            Dock = DockStyle.Top, Height = 30, BackColor = Theme.RailBack,
+            Dock = DockStyle.Top, Height = 40, BackColor = Theme.RailBack,
-            Padding = new Padding(4, 3, 4, 0), WrapContents = false
+            Padding = new Padding(4, 7, 4, 0), WrapContents = false
         };
 
         var sessionsPanel = new Panel { Dock = DockStyle.Fill, BackColor = Theme.SidebarBack };
@@ -63,7 +64,9 @@ public sealed class ConnectionSidebar : UserControl
         {
             var b = new Button
             {
-                Text = text, Width = 70, Height = 24, FlatStyle = FlatStyle.Flat,
+                Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+                MinimumSize = new Size(70, 24), Padding = new Padding(8, 2, 8, 2),
+                FlatStyle = FlatStyle.Flat,
                 ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
                 Margin = new Padding(0, 0, 4, 0), Cursor = Cursors.Hand
             };
@@ -217,7 +220,9 @@ public sealed class ConnectionSidebar : UserControl
         var sshCombo = new ComboBox { Width = 120, DropDownStyle = ComboBoxStyle.DropDownList, BackColor = Theme.TabBack, ForeColor = Theme.Text, Font = Theme.UiFont };
         var connectBtn = new Button
         {
-            Text = "Connect", Width = 64, Height = 24, FlatStyle = FlatStyle.Flat,
+            Text = "Connect", AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(64, 24), Padding = new Padding(8, 2, 8, 2),
+            FlatStyle = FlatStyle.Flat,
             ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont, Cursor = Cursors.Hand, Margin = new Padding(4, 0, 0, 0)
         };
         connectBtn.FlatAppearance.BorderColor = Theme.SerialColor;

src/ETTerms/App/MainForm.Designer.cs

@@ -18,8 +18,10 @@ partial class MainForm
     {
         SuspendLayout();
 
-        AutoScaleDimensions = new SizeF(7F, 15F);
+        // 用 Dpi 自動縮放：尺寸縮放比例 = 螢幕 DPI 比例，與點數字型的實際渲染比例一致，
-        AutoScaleMode = AutoScaleMode.Font;
+        // 避免「字放大了、容器沒放大」造成的高 DPI 文字/按鈕被裁切。
+        AutoScaleDimensions = new SizeF(96F, 96F);
+        AutoScaleMode = AutoScaleMode.Dpi;
         ClientSize = new Size(1100, 700);
         MinimumSize = new Size(720, 480);
         BackColor = Theme.WorkspaceBack;

src/ETTerms/App/MainForm.cs

@@ -14,6 +14,7 @@ public partial class MainForm : Form
     private readonly ActivityRail _rail = new();
     private readonly ConnectionSidebar _sidebar = new();
     private readonly WorkspaceView _workspace = new();
+    private readonly StatusView _statusView = new();
     private readonly SettingsView _settings = new();
     private readonly AboutView _about = new();
     private readonly StatusStrip _status = new();
@@ -39,17 +40,19 @@ public partial class MainForm : Form
 
         var v = Assembly.GetExecutingAssembly().GetName().Version;
         var versionStr = v != null ? $"{v.Major}.{v.Minor}.{v.Build}" : "0.1.0";
-        Text = $"ETTerms   Version v{versionStr}";
+        Text = $"ETTerms   v{versionStr}";
     }
 
     private void BuildLayout()
     {
         Controls.Add(_workspace);   // Fill
+        Controls.Add(_statusView);  // Fill (hidden)
         Controls.Add(_settings);    // Fill (hidden)
         Controls.Add(_about);       // Fill (hidden)
         Controls.Add(_sidebar);     // Left (內側)
         Controls.Add(_rail);        // Left (最外側)
 
+        _statusView.Visible = false;
         _settings.Visible = false;
         _about.Visible = false;
 
@@ -68,6 +71,7 @@ public partial class MainForm : Form
             _statusLabel.Text = $"View: {view}";
             _sidebar.Visible = view == ActivityRail.RailView.Terminal;
             _workspace.Visible = view == ActivityRail.RailView.Terminal;
+            _statusView.Visible = view == ActivityRail.RailView.Status;
             _settings.Visible = view == ActivityRail.RailView.Settings;
             _about.Visible = view == ActivityRail.RailView.About;
             AppLogger.LogInfo($"View selected: {view}");

src/ETTerms/App/SettingsView.cs

@@ -1,11 +1,10 @@
 using System.Drawing;
 using System.Windows.Forms;
 using ETTerms.Infrastructure;
-using ETTerms.Scripting.Pdu;
 
 namespace ETTerms.App;
 
-/// <summary>Settings page with tabs: Terminal / PDU.</summary>
+/// <summary>Settings page with tabs: Terminal / AI MCP.</summary>
 public sealed class SettingsView : UserControl
 {
     public SettingsView()
@@ -20,22 +19,22 @@ public sealed class SettingsView : UserControl
             Padding = new Padding(4, 4, 4, 0), WrapContents = false
         };
 
-        var terminalPage = BuildTerminalTab();
-        var pduPage = BuildPduTab();
-        terminalPage.Dock = DockStyle.Fill;
-        pduPage.Dock = DockStyle.Fill;
-        pduPage.Visible = false;
-
         var body = new Panel { Dock = DockStyle.Fill, BackColor = Theme.WorkspaceBack };
-        body.Controls.Add(terminalPage);
+        var pages = new List<Panel>();
-        body.Controls.Add(pduPage);
 
         Button? activeBtn = null;
         Button MakeTab(string text, Panel page)
         {
+            page.Dock = DockStyle.Fill;
+            page.Visible = false;
+            body.Controls.Add(page);
+            pages.Add(page);
+
             var b = new Button
             {
-                Text = text, AutoSize = false, Width = 80, Height = 26, FlatStyle = FlatStyle.Flat,
+                Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+                MinimumSize = new Size(70, 26), Padding = new Padding(10, 2, 10, 2),
+                FlatStyle = FlatStyle.Flat,
                 ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
                 Margin = new Padding(0, 0, 4, 0), Cursor = Cursors.Hand
             };
@@ -43,8 +42,7 @@ public sealed class SettingsView : UserControl
             b.FlatAppearance.MouseOverBackColor = Theme.Hover;
             b.Click += (_, _) =>
             {
-                terminalPage.Visible = page == terminalPage;
+                foreach (var p in pages) p.Visible = p == page;
-                pduPage.Visible = page == pduPage;
                 if (activeBtn != null) activeBtn.BackColor = Theme.TabBack;
                 b.BackColor = Theme.TabActiveBack;
                 activeBtn = b;
@@ -52,17 +50,16 @@ public sealed class SettingsView : UserControl
             return b;
         }
 
-        var termBtn = MakeTab("Terminal", terminalPage);
+        var termBtn = MakeTab("Terminal", BuildTerminalTab());
-        var pduBtn = MakeTab("PDU", pduPage);
         tabBar.Controls.Add(termBtn);
-        tabBar.Controls.Add(pduBtn);
+        tabBar.Controls.Add(MakeTab("Highlight", BuildHighlightTab()));
-
+        tabBar.Controls.Add(MakeTab("AI MCP", BuildAiMcpTab()));
-        // Set initial active
-        termBtn.BackColor = Theme.TabActiveBack;
-        activeBtn = termBtn;
 
         Controls.Add(body);
         Controls.Add(tabBar);
+
+        // Set initial active tab
+        termBtn.PerformClick();
     }
 
     // ═══ Terminal Tab ═══
@@ -97,6 +94,14 @@ public sealed class SettingsView : UserControl
         flow.Controls.Add(MakeRow("Scrollback Lines", scrollback));
         flow.Controls.Add(MakeRow("Color Scheme", scheme));
         flow.Controls.Add(MakeRow("Default Newline", newline));
+
+        var scriptTrace = new CheckBox
+        {
+            Text = "Show script trace in terminal  ([wait] / sent commands / errors in gray; dispstr always shows)",
+            Checked = s.ShowScriptTrace, AutoSize = true,
+            ForeColor = Theme.Text, Font = Theme.UiFont, Margin = new Padding(0, 6, 0, 0)
+        };
+        flow.Controls.Add(scriptTrace);
         flow.Controls.Add(MakeSpacer(16));
 
         // Shell settings
@@ -164,6 +169,7 @@ public sealed class SettingsView : UserControl
             s.ScrollbackLines = (int)scrollback.Value;
             s.ColorScheme = scheme.Text;
             s.DefaultNewLine = newline.Text;
+            s.ShowScriptTrace = scriptTrace.Checked;
             s.ShellType = shellType.Text;
             s.ShellStartupDir = shellDir.Text;
             s.Save();
@@ -175,8 +181,117 @@ public sealed class SettingsView : UserControl
         return page;
     }
 
-    // ═══ PDU Tab ═══
+    // ═══ Highlight Tab ═══
-    private Panel BuildPduTab()
+    private Panel BuildHighlightTab()
+    {
+        var page = new Panel { BackColor = Theme.WorkspaceBack, Padding = new Padding(20) };
+        var s = AppSettings.Instance;
+
+        var flow = new FlowLayoutPanel
+        {
+            Dock = DockStyle.Fill, FlowDirection = FlowDirection.TopDown,
+            WrapContents = false, BackColor = Theme.WorkspaceBack, AutoScroll = true
+        };
+
+        flow.Controls.Add(new Label
+        {
+            Text = "Keyword Highlighting", AutoSize = true,
+            ForeColor = Theme.Accent, Font = Theme.UiFontBold, Margin = new Padding(0, 0, 0, 4)
+        });
+        flow.Controls.Add(new Label
+        {
+            Text = "Keywords below are highlighted in red in every terminal (case-insensitive).\n" +
+                   "When a keyword appears in a background tab, that tab's dot turns red until you open it.",
+            AutoSize = false, Width = 520, Height = 34,
+            ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 8)
+        });
+
+        var enable = new CheckBox
+        {
+            Text = "Enable keyword highlighting", Checked = s.KeywordHighlightEnabled,
+            AutoSize = true, ForeColor = Theme.Text, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 8)
+        };
+        flow.Controls.Add(enable);
+
+        // 規則清單：每列 = 啟用勾選 + 關鍵字（可直接編輯）
+        var grid = new DataGridView
+        {
+            Width = 420, Height = 240,
+            BackgroundColor = Theme.WorkspaceBack, ForeColor = Theme.Text, GridColor = Theme.Border,
+            BorderStyle = BorderStyle.None, CellBorderStyle = DataGridViewCellBorderStyle.SingleHorizontal,
+            DefaultCellStyle = { BackColor = Theme.TabBack, ForeColor = Theme.Text, SelectionBackColor = Theme.Hover, SelectionForeColor = Theme.Text },
+            ColumnHeadersDefaultCellStyle = { BackColor = Theme.RailBack, ForeColor = Theme.Accent, Font = Theme.UiFontBold },
+            ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Single,
+            EnableHeadersVisualStyles = false, RowHeadersVisible = false,
+            AllowUserToAddRows = false, AllowUserToDeleteRows = false,
+            AllowUserToResizeRows = false, SelectionMode = DataGridViewSelectionMode.FullRowSelect,
+            Font = Theme.UiFont, RowTemplate = { Height = 24 }, Margin = new Padding(0, 0, 0, 8)
+        };
+        grid.Columns.Add(new DataGridViewCheckBoxColumn { Name = "On", HeaderText = "On", Width = 44 });
+        grid.Columns.Add(new DataGridViewTextBoxColumn
+        {
+            Name = "Keyword", HeaderText = "Keyword",
+            AutoSizeMode = DataGridViewAutoSizeColumnMode.Fill
+        });
+        foreach (var r in s.KeywordRules) grid.Rows.Add(r.Enabled, r.Text);
+        flow.Controls.Add(grid);
+
+        // 新增 / 移除
+        var newKw = new TextBox { Width = 220, BackColor = Theme.TabBack, ForeColor = Theme.Text, Font = Theme.UiFont, BorderStyle = BorderStyle.FixedSingle };
+        var addBtn = MakeButton("Add", Theme.Accent);
+        var removeBtn = MakeButton("Remove Selected", Color.FromArgb(210, 120, 120));
+
+        void AddKeyword()
+        {
+            var t = newKw.Text.Trim();
+            if (t.Length == 0) return;
+            grid.Rows.Add(true, t);
+            newKw.Clear();
+            newKw.Focus();
+        }
+        addBtn.Click += (_, _) => AddKeyword();
+        newKw.KeyDown += (_, e) => { if (e.KeyCode == Keys.Enter) { AddKeyword(); e.Handled = e.SuppressKeyPress = true; } };
+        removeBtn.Click += (_, _) =>
+        {
+            foreach (DataGridViewRow row in grid.SelectedRows) grid.Rows.Remove(row);
+        };
+
+        var editRow = new FlowLayoutPanel
+        {
+            FlowDirection = FlowDirection.LeftToRight, AutoSize = true,
+            WrapContents = false, BackColor = Theme.WorkspaceBack, Margin = new Padding(0, 0, 0, 12)
+        };
+        editRow.Controls.Add(newKw);
+        editRow.Controls.Add(addBtn);
+        editRow.Controls.Add(removeBtn);
+        flow.Controls.Add(editRow);
+
+        var save = MakeButton("Save", Theme.Accent);
+        save.Margin = new Padding(0);
+        save.Click += (_, _) =>
+        {
+            grid.EndEdit();
+            s.KeywordHighlightEnabled = enable.Checked;
+            s.KeywordRules = grid.Rows.Cast<DataGridViewRow>()
+                .Select(r => new KeywordRule
+                {
+                    Enabled = r.Cells["On"].Value is true,
+                    Text = r.Cells["Keyword"].Value?.ToString()?.Trim() ?? ""
+                })
+                .Where(r => r.Text.Length > 0)
+                .ToList();
+            s.Save();
+            MessageBox.Show(this, "Highlight settings saved.\nThey apply immediately to all open sessions.",
+                "Highlight", MessageBoxButtons.OK, MessageBoxIcon.Information);
+        };
+        flow.Controls.Add(save);
+
+        page.Controls.Add(flow);
+        return page;
+    }
+
+    // ═══ AI MCP Tab ═══
+    private Panel BuildAiMcpTab()
     {
         var page = new Panel { BackColor = Theme.WorkspaceBack, Padding = new Padding(20) };
 
@@ -186,115 +301,179 @@ public sealed class SettingsView : UserControl
             WrapContents = false, BackColor = Theme.WorkspaceBack, AutoScroll = true
         };
 
-        // Connection row
+        flow.Controls.Add(new Label
-        var ipBox = new TextBox { Width = 160, Text = "192.168.1.21", BackColor = Theme.TabBack, ForeColor = Theme.Text, Font = Theme.UiFont };
-        var connectBtn = MakeButton("Connect", Theme.SerialColor);
-        var statusLabel = new Label { AutoSize = true, Text = "Disconnected", ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(8, 8, 0, 0) };
-
-        var connRow = new FlowLayoutPanel { FlowDirection = FlowDirection.LeftToRight, Width = 500, Height = 36, WrapContents = false, Margin = new Padding(0, 0, 0, 8) };
-        connRow.Controls.Add(new Label { Text = "PDU IP:", AutoSize = true, ForeColor = Theme.Text, Font = Theme.UiFont, Margin = new Padding(0, 6, 8, 0) });
-        connRow.Controls.Add(ipBox);
-        connRow.Controls.Add(connectBtn);
-        connRow.Controls.Add(statusLabel);
-        flow.Controls.Add(connRow);
-
-        // Port status grid
-        var grid = new DataGridView
         {
-            Width = 480, Height = 310, AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.Fill,
+            Text = "AI MCP Integration", AutoSize = true,
-            BackgroundColor = Theme.WorkspaceBack, ForeColor = Theme.Text, GridColor = Theme.Border,
+            ForeColor = Theme.Accent, Font = Theme.UiFontBold, Margin = new Padding(0, 0, 0, 4)
-            BorderStyle = BorderStyle.None, CellBorderStyle = DataGridViewCellBorderStyle.SingleHorizontal,
+        });
-            DefaultCellStyle = { BackColor = Theme.TabBack, ForeColor = Theme.Text, SelectionBackColor = Theme.Hover, SelectionForeColor = Theme.Text },
+        flow.Controls.Add(new Label
-            ColumnHeadersDefaultCellStyle = { BackColor = Theme.RailBack, ForeColor = Theme.Accent, Font = Theme.UiFontBold },
-            ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Single,
-            EnableHeadersVisualStyles = false, RowHeadersVisible = false,
-            AllowUserToAddRows = false, AllowUserToDeleteRows = false, ReadOnly = true,
-            AllowUserToResizeRows = false, SelectionMode = DataGridViewSelectionMode.FullRowSelect,
-            ScrollBars = ScrollBars.None, Font = Theme.UiFont,
-            RowTemplate = { Height = 24 },
-            Margin = new Padding(0, 8, 0, 8)
-        };
-        grid.Columns.Add("Port", "Port");
-        grid.Columns.Add("Status", "Status");
-        grid.Columns.Add("Current", "Current (mA)");
-        grid.Columns.Add("Power", "Power (W)");
-        for (int i = 1; i <= 12; i++)
-            grid.Rows.Add($"Port {i}", "—", "—", "—");
-        flow.Controls.Add(grid);
-
-        // Refresh button
-        var refreshBtn = MakeButton("Refresh", Theme.Accent);
-        flow.Controls.Add(refreshBtn);
-
-        // Logic
-        PduController? pdu = null;
-
-        connectBtn.Click += (_, _) =>
         {
-            if (pdu != null) { pdu.Dispose(); pdu = null; statusLabel.Text = "Disconnected"; statusLabel.ForeColor = Theme.TextDim; connectBtn.Text = "Connect"; return; }
+            Text = "One-click register the ETTerms MCP servers (Serial + PDU) into your AI CLI's\n" +
-            var ip = ipBox.Text.Trim();
+                   "user-level config. Serial: ETTerms owns the COM port, the AI drives it through a\n" +
-            var p = new PduController(ip);
+                   "local named pipe (open a Serial session first). PDU: the AI controls outlets\n" +
-            if (p.CheckConnection())
+                   "directly over SNMP — no GUI session required.",
+            AutoSize = false, Width = 600, Height = 64,
+            ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 8)
+        });
+
+        // Resolved MCP server exes (serial + pdu)
+        foreach (var (name, exe, exists) in McpRegistrar.ServerInfos())
+        {
+            flow.Controls.Add(new Label
             {
-                pdu = p;
+                Text = $"{name}:  {exe}",
-                statusLabel.Text = $"Connected to {ip}";
+                AutoSize = false, Width = 600, Height = 20,
-                statusLabel.ForeColor = Theme.SerialColor;
+                ForeColor = exists ? Theme.SerialColor : Color.FromArgb(210, 150, 120),
-                connectBtn.Text = "Disconnect";
+                Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 2)
-                RefreshPduGrid(pdu, grid);
+            });
-            }
+        }
-            else
+        if (!McpRegistrar.ServerExeExists())
-            {
-                p.Dispose();
-                MessageBox.Show(this, $"Failed to connect to PDU at {ip}", "PDU", MessageBoxButtons.OK, MessageBoxIcon.Warning);
-            }
-        };
-
-        refreshBtn.Click += (_, _) =>
         {
-            if (pdu == null) { MessageBox.Show(this, "Connect to PDU first.", "PDU", MessageBoxButtons.OK, MessageBoxIcon.Information); return; }
+            flow.Controls.Add(new Label
-            RefreshPduGrid(pdu, grid);
+            {
-        };
+                Text = "⚠ Some servers not built yet — publish the app (or build the MCP projects). Setup still writes the expected paths.",
+                AutoSize = false, Width = 600, Height = 20,
+                ForeColor = Color.FromArgb(210, 150, 120), Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 4)
+            });
+        }
+
+        flow.Controls.Add(MakeSpacer(10));
+        flow.Controls.Add(BuildMcpTargetCard(McpTarget.Claude));
+        flow.Controls.Add(MakeSpacer(10));
+        flow.Controls.Add(BuildMcpTargetCard(McpTarget.Kiro));
 
         page.Controls.Add(flow);
         return page;
     }
 
-    private static void RefreshPduGrid(PduController pdu, DataGridView grid)
+    /// <summary>單一 AI 目標（Claude / Kiro）的設定卡：狀態 + Setup / Remove + CLI 驗證指令。</summary>
+    private Panel BuildMcpTargetCard(McpTarget target)
     {
-        for (int i = 0; i < 12; i++)
+        var card = new Panel
         {
-            int port = i + 1;
+            Width = 600, Height = 196, BackColor = Theme.TabBack,
-            var state = pdu.GetPortState(port);
+            Padding = new Padding(14), Margin = new Padding(0, 0, 0, 4)
-            var current = pdu.GetPortCurrent(port);
+        };
-            var power = pdu.GetPortPowerWatts(port);
+        var col = new FlowLayoutPanel
-            var row = grid.Rows[i];
+        {
-            row.Cells["Status"].Value = state == true ? "ON" : state == false ? "OFF" : "—";
+            Dock = DockStyle.Fill, FlowDirection = FlowDirection.TopDown,
-            row.Cells["Current"].Value = current.HasValue ? $"{current.Value}" : "—";
+            WrapContents = false, BackColor = Theme.TabBack, AutoSize = false
-            row.Cells["Power"].Value = power.HasValue ? $"{power.Value:F1}" : "—";
+        };
-            row.DefaultCellStyle.BackColor = state == true ? Color.FromArgb(40, 80, 40) : state == false ? Color.FromArgb(60, 40, 40) : Theme.TabBack;
+
+        var title = new Label
+        {
+            Text = McpRegistrar.DisplayName(target), AutoSize = true,
+            ForeColor = Theme.Text, Font = Theme.UiFontBold, Margin = new Padding(0, 0, 0, 2)
+        };
+        var status = new Label { AutoSize = true, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 2) };
+        var pathLbl = new Label
+        {
+            Text = $"Config:  {McpRegistrar.ConfigPath(target)}",
+            AutoSize = false, Width = 560, Height = 18,
+            ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 6)
+        };
+
+        var setupBtn = MakeButton("Setup", Theme.Accent);
+        var removeBtn = MakeButton("Remove", Color.FromArgb(210, 120, 120));
+        setupBtn.Margin = new Padding(0, 0, 8, 0);
+        var btnRow = new FlowLayoutPanel
+        {
+            FlowDirection = FlowDirection.LeftToRight, AutoSize = true,
+            WrapContents = false, BackColor = Theme.TabBack, Margin = new Padding(0, 0, 0, 8)
+        };
+        btnRow.Controls.Add(setupBtn);
+        btnRow.Controls.Add(removeBtn);
+
+        var verifyLbl = new Label
+        {
+            Text = "Verify in your CLI:", AutoSize = true,
+            ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 2)
+        };
+        var verifyBox = new TextBox
+        {
+            Multiline = true, ReadOnly = true, Width = 560, Height = 56,
+            BackColor = Color.FromArgb(20, 20, 24), ForeColor = Color.FromArgb(200, 200, 200),
+            BorderStyle = BorderStyle.FixedSingle, Font = new Font("Cascadia Mono", 9f),
+            Text = McpRegistrar.VerifyHint(target)
+        };
+
+        void Refresh()
+        {
+            bool reg = McpRegistrar.IsRegistered(target);
+            status.Text = reg ? "● Configured" : "○ Not configured";
+            status.ForeColor = reg ? Theme.SerialColor : Theme.TextDim;
+            removeBtn.Enabled = reg;
         }
+
+        setupBtn.Click += (_, _) =>
+        {
+            try
+            {
+                McpRegistrar.Register(target);
+                Refresh();
+                MessageBox.Show(this,
+                    $"{McpRegistrar.DisplayName(target)} is now configured.\n\n" +
+                    "Restart your AI CLI (or open a new session), then run the verify command shown below.",
+                    "AI MCP", MessageBoxButtons.OK, MessageBoxIcon.Information);
+            }
+            catch (Exception ex)
+            {
+                MessageBox.Show(this, $"Failed to write config:\n{ex.Message}",
+                    "AI MCP", MessageBoxButtons.OK, MessageBoxIcon.Warning);
+            }
+        };
+
+        removeBtn.Click += (_, _) =>
+        {
+            try
+            {
+                McpRegistrar.Unregister(target);
+                Refresh();
+                MessageBox.Show(this,
+                    $"Removed from {McpRegistrar.DisplayName(target)}.\nRestart your AI CLI for it to take effect.",
+                    "AI MCP", MessageBoxButtons.OK, MessageBoxIcon.Information);
+            }
+            catch (Exception ex)
+            {
+                MessageBox.Show(this, $"Failed to update config:\n{ex.Message}",
+                    "AI MCP", MessageBoxButtons.OK, MessageBoxIcon.Warning);
+            }
+        };
+
+        Refresh();
+
+        col.Controls.Add(title);
+        col.Controls.Add(status);
+        col.Controls.Add(pathLbl);
+        col.Controls.Add(btnRow);
+        col.Controls.Add(verifyLbl);
+        col.Controls.Add(verifyBox);
+        card.Controls.Add(col);
+        return card;
     }
 
     // ── Helpers ──
-    private const int LabelWidth = 150;   // 標籤欄固定寬度
+    private const int LabelWidth = 150;   // 標籤欄最小寬度
     private const int InputWidth = 200;   // 所有輸入框統一寬度
 
-    private static Panel MakeRow(string label, Control control)
+    private static Control MakeRow(string label, Control control)
     {
-        var row = new Panel { Width = LabelWidth + InputWidth, Height = 32, Margin = new Padding(0, 3, 0, 3) };
+        // 用 FlowLayout + AutoSize 標籤取代絕對定位，讓高 DPI 下標籤變寬也不會被裁、且對齊穩定
-
+        var row = new FlowLayoutPanel
-        // 統一輸入框寬度 + 左緣對齊（不再 Dock.Right，避免右對齊造成左緣參差）
-        control.Width = InputWidth;
-        int top = (row.Height - control.Height) / 2;
-        control.Location = new Point(LabelWidth, top < 0 ? 0 : top);
-
-        row.Controls.Add(control);
-        row.Controls.Add(new Label
         {
-            Text = label, AutoSize = false, Width = LabelWidth, Height = row.Height,
+            AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
-            Location = new Point(0, 0), ForeColor = Theme.Text, Font = Theme.UiFont,
+            FlowDirection = FlowDirection.LeftToRight, WrapContents = false,
-            TextAlign = ContentAlignment.MiddleLeft
+            Margin = new Padding(0, 3, 0, 3), BackColor = Color.Transparent
-        });
+        };
+        var lbl = new Label
+        {
+            Text = label, AutoSize = true, MinimumSize = new Size(LabelWidth, 0),
+            ForeColor = Theme.Text, Font = Theme.UiFont,
+            TextAlign = ContentAlignment.MiddleLeft, Margin = new Padding(0, 6, 8, 0)
+        };
+        if (control.Width <= 0) control.Width = InputWidth;
+        row.Controls.Add(lbl);
+        row.Controls.Add(control);
         return row;
     }
 
@@ -302,7 +481,9 @@ public sealed class SettingsView : UserControl
     {
         var b = new Button
         {
-            Text = text, Width = 90, Height = 28, FlatStyle = FlatStyle.Flat,
+            Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(90, 28), Padding = new Padding(10, 2, 10, 2),
+            FlatStyle = FlatStyle.Flat,
             ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
             Cursor = Cursors.Hand, Margin = new Padding(8, 0, 0, 0)
         };

src/ETTerms/App/StatusView.cs

@@ -0,0 +1,286 @@
+using System.Drawing;
+using System.Windows.Forms;
+using ETTerms.Infrastructure;
+using ETTerms.PduCore;
+
+namespace ETTerms.App;
+
+/// <summary>
+/// Status page with tabs: PDU (more views to come).
+/// 風格參考 <see cref="SettingsView"/>：自繪 tab strip + panel 切換，避免 TabControl 白邊。
+/// PDU 分頁連線後每 3 秒於背景自動輪詢插座狀態（不需手動 Refresh）。
+/// </summary>
+public sealed class StatusView : UserControl
+{
+    public StatusView()
+    {
+        Dock = DockStyle.Fill;
+        BackColor = Theme.WorkspaceBack;
+
+        var tabBar = new FlowLayoutPanel
+        {
+            Dock = DockStyle.Top, Height = 32, BackColor = Theme.RailBack,
+            Padding = new Padding(4, 4, 4, 0), WrapContents = false
+        };
+
+        var body = new Panel { Dock = DockStyle.Fill, BackColor = Theme.WorkspaceBack };
+        var pages = new List<Panel>();
+
+        Button? activeBtn = null;
+        Button MakeTab(string text, Panel page)
+        {
+            page.Dock = DockStyle.Fill;
+            page.Visible = false;
+            body.Controls.Add(page);
+            pages.Add(page);
+
+            var b = new Button
+            {
+                Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+                MinimumSize = new Size(70, 26), Padding = new Padding(10, 2, 10, 2),
+                FlatStyle = FlatStyle.Flat,
+                ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
+                Margin = new Padding(0, 0, 4, 0), Cursor = Cursors.Hand
+            };
+            b.FlatAppearance.BorderColor = Theme.Border;
+            b.FlatAppearance.MouseOverBackColor = Theme.Hover;
+            b.Click += (_, _) =>
+            {
+                foreach (var p in pages) p.Visible = p == page;
+                if (activeBtn != null) activeBtn.BackColor = Theme.TabBack;
+                b.BackColor = Theme.TabActiveBack;
+                activeBtn = b;
+            };
+            return b;
+        }
+
+        var pduBtn = MakeTab("PDU", BuildPduTab());
+        tabBar.Controls.Add(pduBtn);
+
+        Controls.Add(body);
+        Controls.Add(tabBar);
+
+        pduBtn.PerformClick();
+    }
+
+    // ═══ PDU Tab ═══
+    private Panel BuildPduTab()
+    {
+        var page = new Panel { BackColor = Theme.WorkspaceBack, Padding = new Padding(20) };
+
+        var flow = new FlowLayoutPanel
+        {
+            Dock = DockStyle.Fill, FlowDirection = FlowDirection.TopDown,
+            WrapContents = false, BackColor = Theme.WorkspaceBack, AutoScroll = true
+        };
+
+        // Connection row
+        var ipBox = new TextBox { Width = 160, Text = "192.168.1.21", BackColor = Theme.TabBack, ForeColor = Theme.Text, Font = Theme.UiFont };
+        var connectBtn = MakeButton("Connect", Theme.SerialColor);
+        var statusLabel = new Label { AutoSize = true, Text = "Disconnected", ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(8, 8, 0, 0) };
+
+        var connRow = new FlowLayoutPanel { FlowDirection = FlowDirection.LeftToRight, Width = 500, Height = 36, WrapContents = false, Margin = new Padding(0, 0, 0, 8) };
+        connRow.Controls.Add(new Label { Text = "PDU IP:", AutoSize = true, ForeColor = Theme.Text, Font = Theme.UiFont, Margin = new Padding(0, 6, 8, 0) });
+        connRow.Controls.Add(ipBox);
+        connRow.Controls.Add(connectBtn);
+        connRow.Controls.Add(statusLabel);
+        flow.Controls.Add(connRow);
+
+        // Port status grid
+        var grid = new DataGridView
+        {
+            Width = 480, Height = 310, AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.Fill,
+            BackgroundColor = Theme.WorkspaceBack, ForeColor = Theme.Text, GridColor = Theme.Border,
+            BorderStyle = BorderStyle.None, CellBorderStyle = DataGridViewCellBorderStyle.SingleHorizontal,
+            DefaultCellStyle = { BackColor = Theme.TabBack, ForeColor = Theme.Text, SelectionBackColor = Theme.Hover, SelectionForeColor = Theme.Text },
+            ColumnHeadersDefaultCellStyle = { BackColor = Theme.RailBack, ForeColor = Theme.Accent, Font = Theme.UiFontBold },
+            ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Single,
+            EnableHeadersVisualStyles = false, RowHeadersVisible = false,
+            AllowUserToAddRows = false, AllowUserToDeleteRows = false, ReadOnly = true,
+            AllowUserToResizeRows = false, SelectionMode = DataGridViewSelectionMode.FullRowSelect,
+            ScrollBars = ScrollBars.None, Font = Theme.UiFont,
+            RowTemplate = { Height = 24 },
+            Margin = new Padding(0, 8, 0, 8)
+        };
+        grid.Columns.Add("Port", "Port");
+        grid.Columns.Add("Status", "Status");
+        grid.Columns.Add("Current", "Current (mA)");
+        grid.Columns.Add("Power", "Power (W)");
+
+        // 控制按鈕欄：按一下切換該 Port 的 ON/OFF
+        var actionCol = new DataGridViewButtonColumn
+        {
+            Name = "Action", HeaderText = "Control",
+            UseColumnTextForButtonValue = false, FlatStyle = FlatStyle.Flat,
+            FillWeight = 80,
+            DefaultCellStyle =
+            {
+                BackColor = Theme.TabBack, ForeColor = Theme.Text,
+                SelectionBackColor = Theme.Hover, SelectionForeColor = Theme.Text,
+                Alignment = DataGridViewContentAlignment.MiddleCenter
+            }
+        };
+        grid.Columns.Add(actionCol);
+
+        for (int i = 1; i <= 12; i++)
+            grid.Rows.Add($"Port {i}", "—", "—", "—", "—");
+        flow.Controls.Add(grid);
+
+        // 連線後每 3 秒自動輪詢（背景執行緒讀 SNMP，Invoke 回 UI 更新）
+        var pollLabel = new Label { AutoSize = true, Text = "", ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 4, 0, 0) };
+        flow.Controls.Add(pollLabel);
+
+        // Logic
+        PduController? pdu = null;
+        System.Threading.Timer? timer = null;
+        int polling = 0;   // 0=idle, 1=in-flight（避免上一次未讀完又疊一次）
+
+        void StopPolling()
+        {
+            timer?.Dispose();
+            timer = null;
+        }
+
+        void PollOnce()
+        {
+            // 已在輪詢中就跳過這一輪
+            if (System.Threading.Interlocked.Exchange(ref polling, 1) == 1) return;
+            var current = pdu;
+            if (current == null) { System.Threading.Volatile.Write(ref polling, 0); return; }
+
+            try
+            {
+                // 批次 SNMP GET：12 port 只需 3 個 UDP 來回（原本逐 port 逐 OID 36 個，
+                // 逾時時最壞一輪要 36×3 秒）。
+                var rows = current.GetAllPortsStatus(12);
+
+                if (!IsDisposed && IsHandleCreated)
+                {
+                    BeginInvoke(new Action(() =>
+                    {
+                        if (pdu != current) return;   // 期間已斷線
+                        ApplyPduRows(grid, rows);
+                        pollLabel.Text = $"Auto-refresh every 3s · last update {DateTime.Now:HH:mm:ss}";
+                    }));
+                }
+            }
+            catch { /* 輪詢失敗忽略，下一輪再試 */ }
+            finally { System.Threading.Volatile.Write(ref polling, 0); }
+        }
+
+        connectBtn.Click += (_, _) =>
+        {
+            if (pdu != null)
+            {
+                StopPolling();
+                pdu.Dispose(); pdu = null;
+                statusLabel.Text = "Disconnected"; statusLabel.ForeColor = Theme.TextDim;
+                connectBtn.Text = "Connect";
+                pollLabel.Text = "";
+                // 斷線後清空表格，避免顯示過時的狀態
+                foreach (DataGridViewRow row in grid.Rows)
+                {
+                    row.Cells["Status"].Value = "—";
+                    row.Cells["Current"].Value = "—";
+                    row.Cells["Power"].Value = "—";
+                    row.Cells["Action"].Value = "—";
+                    row.DefaultCellStyle.BackColor = Theme.TabBack;
+                }
+                return;
+            }
+
+            var ip = ipBox.Text.Trim();
+            var p = new PduController(ip, AppLogger.Info, AppLogger.LogWarning);
+            if (p.CheckConnection())
+            {
+                pdu = p;
+                statusLabel.Text = $"Connected to {ip}";
+                statusLabel.ForeColor = Theme.SerialColor;
+                connectBtn.Text = "Disconnect";
+                // 立即讀一次，之後每 3 秒一次
+                timer = new System.Threading.Timer(_ => PollOnce(), null,
+                    dueTime: 0, period: 3000);
+            }
+            else
+            {
+                p.Dispose();
+                MessageBox.Show(this, $"Failed to connect to PDU at {ip}", "PDU", MessageBoxButtons.OK, MessageBoxIcon.Warning);
+            }
+        };
+
+        // 控制項銷毀時收掉計時器與連線
+        Disposed += (_, _) => { StopPolling(); pdu?.Dispose(); };
+
+        // 按下 Control 欄按鈕：切換該 Port 的 ON/OFF（SNMP Set 在背景執行，避免卡 UI）
+        grid.CellContentClick += (_, e) =>
+        {
+            if (e.RowIndex < 0 || e.ColumnIndex < 0) return;
+            if (grid.Columns[e.ColumnIndex].Name != "Action") return;
+
+            var current = pdu;
+            if (current == null)
+            {
+                MessageBox.Show(this, "PDU is not connected. Please connect first.",
+                    "PDU", MessageBoxButtons.OK, MessageBoxIcon.Warning);
+                return;
+            }
+
+            int port = e.RowIndex + 1;
+            var statusVal = grid.Rows[e.RowIndex].Cells["Status"].Value?.ToString();
+            if (statusVal != "ON" && statusVal != "OFF") return;   // 狀態未知時不動作
+            bool turnOn = statusVal != "ON";   // 目前 ON → 關；其餘 → 開
+
+            var actionCell = grid.Rows[e.RowIndex].Cells["Action"];
+            actionCell.Value = "…";
+
+            System.Threading.Tasks.Task.Run(() =>
+            {
+                bool ok = turnOn ? current.SetPortOn(port) : current.SetPortOff(port);
+                System.Threading.Thread.Sleep(400);   // 等 PDU 套用後再讀回確認
+                PollOnce();                            // 背景讀 SNMP 後 Invoke 回 UI 更新整張表
+
+                if (!ok && !IsDisposed && IsHandleCreated)
+                {
+                    BeginInvoke(new Action(() =>
+                        MessageBox.Show(this,
+                            $"Failed to turn {(turnOn ? "ON" : "OFF")} Port {port}",
+                            "PDU", MessageBoxButtons.OK, MessageBoxIcon.Error)));
+                }
+            });
+        };
+
+        page.Controls.Add(flow);
+        return page;
+    }
+
+    private static void ApplyPduRows(DataGridView grid, (bool? State, int? CurrentMilliAmps, double? PowerWatts)[] rows)
+    {
+        for (int i = 0; i < rows.Length && i < grid.Rows.Count; i++)
+        {
+            var (state, current, power) = rows[i];
+            var row = grid.Rows[i];
+            row.Cells["Status"].Value = state == true ? "ON" : state == false ? "OFF" : "—";
+            row.Cells["Current"].Value = current.HasValue ? $"{current.Value}" : "—";
+            row.Cells["Power"].Value = power.HasValue ? $"{power.Value:F1}" : "—";
+            // 按鈕文字代表「按下後會做的動作」：ON 時顯示 Turn OFF，反之亦然
+            row.Cells["Action"].Value = state == true ? "Turn OFF" : state == false ? "Turn ON" : "—";
+            row.DefaultCellStyle.BackColor = state == true ? Color.FromArgb(40, 80, 40) : state == false ? Color.FromArgb(60, 40, 40) : Theme.TabBack;
+        }
+    }
+
+    // ── Helpers ──
+    private static Button MakeButton(string text, Color borderColor)
+    {
+        var b = new Button
+        {
+            Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(90, 28), Padding = new Padding(10, 2, 10, 2),
+            FlatStyle = FlatStyle.Flat,
+            ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
+            Cursor = Cursors.Hand, Margin = new Padding(8, 0, 0, 0)
+        };
+        b.FlatAppearance.BorderColor = borderColor;
+        b.FlatAppearance.MouseOverBackColor = Theme.Hover;
+        return b;
+    }
+}

src/ETTerms/App/Workspace/WorkspaceView.cs

@@ -20,6 +20,7 @@ public sealed class WorkspaceView : UserControl
         public required SessionPage Page;
         public Rectangle TabBounds;
         public Rectangle CloseRect;
+        public bool Alert;   // 背景分頁出現高亮關鍵字 → 標紅點，切到該分頁時清除
     }
 
     private readonly FlowLayoutPanel _toolbar;
@@ -52,7 +53,8 @@ public sealed class WorkspaceView : UserControl
         BackColor = Theme.WorkspaceBack;
 
         // 頂部工具列容器：左側為 Layout/Run 群組（Fill），右側為 Log All（Dock Right）
-        var topBar = new Panel { Dock = DockStyle.Top, Height = 38, BackColor = Theme.RailBack };
+        // 高度 40 與左側 ConnectionSidebar 的 tab bar 對齊，且容得下 AutoSize 按鈕（不被裁切）
+        var topBar = new Panel { Dock = DockStyle.Top, Height = 40, BackColor = Theme.RailBack };
 
         _toolbar = new FlowLayoutPanel
         {
@@ -113,6 +115,12 @@ public sealed class WorkspaceView : UserControl
         var page = BuildPage(conn);
         var s = new Session { Title = conn.Name, IsSsh = conn.IsSsh, Page = page };
         page.ConnectFailed += msg => OnConnectFailed(s, msg);
+        page.KeywordAlert += _ =>
+        {
+            if (s == _active || s.Alert) return;
+            s.Alert = true;
+            _tabStrip.Invalidate();
+        };
         _sessions.Add(s);
         _active = s;
         Relayout();
@@ -190,6 +198,7 @@ public sealed class WorkspaceView : UserControl
         }
         _empty.Visible = false;
         _active ??= _sessions[0];
+        _active.Alert = false;   // 使用者正在看這個分頁，警示清除
 
         int cells = _rows * _cols;
         int activeIdx = _sessions.IndexOf(_active);
@@ -359,7 +368,8 @@ public sealed class WorkspaceView : UserControl
             if (drag)
                 using (var pen = new Pen(Theme.Accent, 1))
                     g.DrawRectangle(pen, new Rectangle(s.TabBounds.Left, s.TabBounds.Top, s.TabBounds.Width - 1, s.TabBounds.Height - 1));
-            using (var dot = new SolidBrush(s.IsSsh ? Theme.SshColor : Theme.SerialColor))
+            // 警示中的背景分頁：型別圓點改紅色，切過去看時清除
+            using (var dot = new SolidBrush(s.Alert ? Color.FromArgb(235, 85, 85) : s.IsSsh ? Theme.SshColor : Theme.SerialColor))
                 g.FillEllipse(dot, s.TabBounds.Left + 9, StripH / 2 - 4, 8, 8);
             var tr = new Rectangle(s.TabBounds.Left + 22, s.TabBounds.Top, s.TabBounds.Width - 22 - CloseSz - 10, StripH);
             TextRenderer.DrawText(g, s.Title, Theme.UiFont, tr, active ? Theme.Text : Theme.TextDim,
@@ -374,7 +384,9 @@ public sealed class WorkspaceView : UserControl
     {
         var b = new Button
         {
-            Text = label, AutoSize = false, Size = new Size(44, 26), FlatStyle = FlatStyle.Flat,
+            Text = label, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(40, 26), Padding = new Padding(8, 2, 8, 2),
+            FlatStyle = FlatStyle.Flat,
             ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
             Margin = new Padding(3, 0, 3, 0), Cursor = Cursors.Hand
         };
@@ -384,11 +396,13 @@ public sealed class WorkspaceView : UserControl
         return b;
     }
 
-    private static Button MakeActionButton(string text, int width, int leftMargin, EventHandler onClick)
+    private static Button MakeActionButton(string text, int minWidth, int leftMargin, EventHandler onClick)
     {
         var b = new Button
         {
-            Text = text, AutoSize = false, Size = new Size(width, 26), FlatStyle = FlatStyle.Flat,
+            Text = text, AutoSize = true, AutoSizeMode = AutoSizeMode.GrowAndShrink,
+            MinimumSize = new Size(minWidth, 26), Padding = new Padding(10, 2, 10, 2),
+            FlatStyle = FlatStyle.Flat,
             ForeColor = Theme.Text, BackColor = Theme.TabBack, Font = Theme.UiFont,
             Margin = new Padding(leftMargin, 0, 3, 0), Cursor = Cursors.Hand
         };
@@ -447,22 +461,9 @@ public sealed class WorkspaceView : UserControl
             return;
         }
 
-        string content, name;
+        if (!TtlScript.TryPick(this, out var content, out var name)) return;
-        using (var dlg = new OpenFileDialog { Filter = "TTL scripts (*.ttl)|*.ttl|All files (*.*)|*.*" })
-        {
-            if (dlg.ShowDialog(this) != DialogResult.OK) return;
-            content = File.ReadAllText(dlg.FileName);
-            name = Path.GetFileName(dlg.FileName);
-        }
-
         // Run All 拒絕含 waitall / sendlnall 的腳本
-        if (ScriptContainsGroupCommands(content))
+        if (TtlScript.WarnIfGroupCommands(this, content, "Run All")) return;
-        {
-            MessageBox.Show(this,
-                "Script contains 'waitall' or 'sendlnall' which require Group execution.\nPlease use Run Group buttons instead.",
-                "Run All", MessageBoxButtons.OK, MessageBoxIcon.Warning);
-            return;
-        }
 
         await Task.WhenAll(serials.Select(sp => sp.RunScriptAsync(content, name)));
     }
@@ -481,29 +482,12 @@ public sealed class WorkspaceView : UserControl
             return;
         }
 
-        string content, name;
+        if (!TtlScript.TryPick(this, out var content, out var name)) return;
-        using (var dlg = new OpenFileDialog { Filter = "TTL scripts (*.ttl)|*.ttl|All files (*.*)|*.*" })
-        {
-            if (dlg.ShowDialog(this) != DialogResult.OK) return;
-            content = File.ReadAllText(dlg.FileName);
-            name = Path.GetFileName(dlg.FileName);
-        }
 
         var sync = new GroupSyncContext(members.Count);
         await Task.WhenAll(members.Select((sp, i) => sp.RunGroupScriptAsync(content, name, sync, ((char)('A' + i)).ToString())));
     }
 
-    private static bool ScriptContainsGroupCommands(string content)
-    {
-        foreach (var line in content.Split('\n'))
-        {
-            var t = line.Trim().ToLower();
-            if (t.StartsWith("waitall") || t.StartsWith("sendlnall") || t.StartsWith("sendlngroup"))
-                return true;
-        }
-        return false;
-    }
-
     protected override void Dispose(bool disposing)
     {
         if (disposing)

src/ETTerms/Connections/ConnectionStore.cs

@@ -1,3 +1,4 @@
+using System.Globalization;
 using System.Text.Json;
 using Microsoft.Data.Sqlite;
 using ETTerms.Infrastructure;
@@ -59,7 +60,8 @@ public sealed class ConnectionStore
                 Type = (ConnectionType)r.GetInt32(2),
                 SortOrder = r.GetInt32(3),
                 GroupName = r.IsDBNull(4) ? null : r.GetString(4),
-                LastUsedUtc = DateTime.Parse(r.GetString(5)),
+                // 與寫入端的 "o" (round-trip) 格式對稱，不受系統地區設定影響
+                LastUsedUtc = DateTime.Parse(r.GetString(5), CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind),
                 Ssh = blob?.Ssh,
                 Serial = blob?.Serial
             });

src/ETTerms/ETTerms.csproj

@@ -10,10 +10,13 @@
     <AssemblyName>ETTerms</AssemblyName>
 
     <!-- 版本資訊 -->
-    <Version>0.2.0</Version>
+    <Version>0.5.0</Version>
     <Product>ETTerms</Product>
     <Company>ETTerms Project</Company>
 
+    <!-- 高 DPI：PerMonitorV2，讓不同縮放比例的螢幕都能正確縮放、避免文字/按鈕被裁切 -->
+    <ApplicationHighDpiMode>PerMonitorV2</ApplicationHighDpiMode>
+
     <!-- 視窗 / 工作列 / exe 圖示 -->
     <ApplicationIcon>Assets\Choco_256x256.ico</ApplicationIcon>
   </PropertyGroup>
@@ -25,11 +28,33 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Data.Sqlite" Version="8.0.10" />
-    <PackageReference Include="SnmpSharpNet" Version="0.9.7">
-      <NoWarn>NU1701</NoWarn>
-    </PackageReference>
     <PackageReference Include="SSH.NET" Version="2024.2.0" />
     <PackageReference Include="System.IO.Ports" Version="8.0.0" />
   </ItemGroup>
 
+  <ItemGroup>
+    <!-- PDU SNMP 控制共用庫（GUI 與 ETTerms.PduMcp 共用，v0.4.0 取代兩份複製的 PduController） -->
+    <ProjectReference Include="..\ETTerms.PduCore\ETTerms.PduCore.csproj" />
+  </ItemGroup>
+
+  <!--
+    發佈 GUI 時，自動把 MCP servers（Serial + PDU）一併發佈到 <publish>\<server>\ 子資料夾。
+    這樣單一 `dotnet publish src\ETTerms` 就會產生完整自洽的 bundle，
+    且 McpRegistrar.ResolveServerExe() 解析的 <ETTerms.exe>\<server>\<server>.exe 必定存在。
+    刻意放子資料夾：與 GUI 的相依 dll 隔離，避免互相覆蓋。
+    MCP 跟隨 GUI 的 self-contained 設定：框架相依版 → MCP 也框架相依；portable(self-contained)版 → MCP 也免 runtime。
+  -->
+  <Target Name="PublishMcpServers" AfterTargets="Publish">
+    <PropertyGroup>
+      <_McpRid Condition="'$(RuntimeIdentifier)' != ''">$(RuntimeIdentifier)</_McpRid>
+      <_McpRid Condition="'$(RuntimeIdentifier)' == ''">win-x64</_McpRid>
+      <_McpSelfContained Condition="'$(SelfContained)' != ''">$(SelfContained)</_McpSelfContained>
+      <_McpSelfContained Condition="'$(SelfContained)' == ''">false</_McpSelfContained>
+    </PropertyGroup>
+    <Message Importance="high" Text="[ETTerms] Publishing ETTerms.SerialMcp -&gt; $(PublishDir)ETTerms.SerialMcp (self-contained=$(_McpSelfContained))" />
+    <Exec Command="dotnet publish &quot;$(MSBuildThisFileDirectory)..\ETTerms.SerialMcp\ETTerms.SerialMcp.csproj&quot; -c $(Configuration) -r $(_McpRid) --self-contained $(_McpSelfContained) -o &quot;$(PublishDir)ETTerms.SerialMcp&quot;" />
+    <Message Importance="high" Text="[ETTerms] Publishing ETTerms.PduMcp -&gt; $(PublishDir)ETTerms.PduMcp (self-contained=$(_McpSelfContained))" />
+    <Exec Command="dotnet publish &quot;$(MSBuildThisFileDirectory)..\ETTerms.PduMcp\ETTerms.PduMcp.csproj&quot; -c $(Configuration) -r $(_McpRid) --self-contained $(_McpSelfContained) -o &quot;$(PublishDir)ETTerms.PduMcp&quot;" />
+  </Target>
+
 </Project>

src/ETTerms/Infrastructure/AppSettings.cs

@@ -22,11 +22,18 @@ public sealed class AppSettings
     public int ScrollbackLines { get; set; } = 5000;
     public string DefaultNewLine { get; set; } = "\\r\\n";
     public string ColorScheme { get; set; } = "Dark";
+    /// <summary>TTL 腳本執行時，[wait] / >> 送出回顯 / 錯誤等 trace 是否以灰色顯示在終端機
+    /// （只影響畫面；本來就不會寫進側錄 log。dispstr 一律顯示，不受此開關影響）。</summary>
+    public bool ShowScriptTrace { get; set; } = true;
 
     // ── Shell ──
     public string ShellType { get; set; } = "PowerShell";       // PowerShell, Bash, Cmd
     public string ShellStartupDir { get; set; } = "";
 
+    // ── Keyword highlight（終端機關鍵字標色 + 分頁警示；Settings → Highlight 分頁設定）──
+    public bool KeywordHighlightEnabled { get; set; } = true;
+    public List<KeywordRule> KeywordRules { get; set; } = new();
+
     // ── Window ──
     public int WindowX { get; set; } = -1;
     public int WindowY { get; set; } = -1;
@@ -83,3 +90,10 @@ public sealed class AppSettings
         return new();
     }
 }
+
+/// <summary>一條關鍵字高亮規則：關鍵字文字 + 是否啟用（比對不分大小寫）。</summary>
+public sealed class KeywordRule
+{
+    public string Text { get; set; } = "";
+    public bool Enabled { get; set; } = true;
+}

src/ETTerms/Infrastructure/McpRegistrar.cs

@@ -0,0 +1,199 @@
+using System.IO;
+using System.Text.Json;
+using System.Text.Json.Nodes;
+
+namespace ETTerms.Infrastructure;
+
+/// <summary>支援一鍵設定 MCP 的 AI CLI 目標。</summary>
+public enum McpTarget { Claude, Kiro }
+
+/// <summary>
+/// 把 ETTerms 的 MCP servers（<c>ETTerms.SerialMcp</c> 與 <c>ETTerms.PduMcp</c>）一鍵註冊 /
+/// 移除到各 AI CLI 的「使用者層級」MCP 設定檔。採 read-modify-write，保留檔內其他既有伺服器。
+///
+/// - Claude Code：<c>~/.claude.json</c> 頂層 <c>mcpServers</c>，entry 需 <c>type:"stdio"</c>。
+/// - Kiro：<c>%USERPROFILE%\.kiro\settings\mcp.json</c> 頂層 <c>mcpServers</c>。
+///
+/// 兩個 server 一起註冊 / 移除（一鍵同時設定 serial 與 pdu）。
+/// </summary>
+public static class McpRegistrar
+{
+    /// <summary>一個可被註冊的 MCP server 描述：CLI 內名稱 + 發佈子資料夾 + 執行檔名。</summary>
+    public sealed record McpServer(string Name, string PublishFolder, string ExeName);
+
+    /// <summary>ETTerms 提供的所有 MCP servers。</summary>
+    public static readonly IReadOnlyList<McpServer> Servers = new[]
+    {
+        new McpServer("etterms-serial", "ETTerms.SerialMcp", "ETTerms.SerialMcp.exe"),
+        new McpServer("etterms-pdu",    "ETTerms.PduMcp",    "ETTerms.PduMcp.exe"),
+    };
+
+    public static string DisplayName(McpTarget t) => t switch
+    {
+        McpTarget.Claude => "Claude Code",
+        McpTarget.Kiro => "Kiro",
+        _ => t.ToString()
+    };
+
+    /// <summary>該 AI CLI 的使用者層級 MCP 設定檔路徑。</summary>
+    public static string ConfigPath(McpTarget t)
+    {
+        var home = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
+        return t switch
+        {
+            McpTarget.Claude => Path.Combine(home, ".claude.json"),
+            McpTarget.Kiro => Path.Combine(home, ".kiro", "settings", "mcp.json"),
+            _ => throw new ArgumentOutOfRangeException(nameof(t))
+        };
+    }
+
+    /// <summary>給使用者在 CLI 確認是否設定成功的指令（多行）。</summary>
+    public static string VerifyHint(McpTarget t) => t switch
+    {
+        McpTarget.Claude =>
+            "claude mcp list\r\n" +
+            "#  應看到：etterms-serial / etterms-pdu  ✓ Connected\r\n" +
+            "#  細節：  claude mcp get etterms-pdu",
+        McpTarget.Kiro =>
+            "kiro-cli mcp list\r\n" +
+            "kiro-cli mcp status --name etterms-pdu\r\n" +
+            "#  或在 Kiro IDE：點 ghost 圖示開 MCP Servers 面板查看狀態",
+        _ => ""
+    };
+
+    /// <summary>找出某個 MCP server 執行檔路徑（找不到回傳最可能的位置作為註冊值）。</summary>
+    public static string ResolveServerExe(McpServer server)
+    {
+        var baseDir = AppContext.BaseDirectory;
+        var candidates = new List<string>
+        {
+            Path.Combine(baseDir, server.PublishFolder, server.ExeName), // 發佈版（子資料夾）
+            Path.Combine(baseDir, server.ExeName),                       // 同層
+        };
+
+        // 開發版 fallback：src\ETTerms\bin\<cfg>\net8.0-windows → src\<folder>\bin\<cfg>\net8.0
+        try
+        {
+            var binCfg = new DirectoryInfo(baseDir);          // ...\net8.0-windows
+            var config = binCfg.Parent?.Name ?? "Debug";       // Debug / Release
+            var srcDir = binCfg.Parent?.Parent?.Parent?.Parent; // ...\src
+            if (srcDir != null)
+                candidates.Add(Path.Combine(srcDir.FullName, server.PublishFolder, "bin", config, "net8.0", server.ExeName));
+        }
+        catch { /* 路徑推導失敗就略過開發版 fallback */ }
+
+        foreach (var c in candidates)
+            if (File.Exists(c)) return c;
+        return candidates[0]; // 都找不到 → 回發佈版預期位置
+    }
+
+    /// <summary>所有 server 執行檔是否都存在。</summary>
+    public static bool ServerExeExists() => Servers.All(s => File.Exists(ResolveServerExe(s)));
+
+    /// <summary>列出每個 server 的解析路徑與是否存在（給 UI 顯示）。</summary>
+    public static IEnumerable<(string Name, string Exe, bool Exists)> ServerInfos()
+    {
+        foreach (var s in Servers)
+        {
+            var exe = ResolveServerExe(s);
+            yield return (s.Name, exe, File.Exists(exe));
+        }
+    }
+
+    /// <summary>該目標是否已註冊「全部」ETTerms MCP servers。</summary>
+    public static bool IsRegistered(McpTarget t)
+    {
+        try
+        {
+            var path = ConfigPath(t);
+            if (!File.Exists(path)) return false;
+            var servers = (JsonNode.Parse(File.ReadAllText(path)) as JsonObject)?["mcpServers"] as JsonObject;
+            if (servers == null) return false;
+            return Servers.All(s => servers[s.Name] != null);
+        }
+        catch { return false; }
+    }
+
+    /// <summary>註冊（或更新）所有 ETTerms MCP servers 到該目標設定檔。</summary>
+    public static void Register(McpTarget t)
+    {
+        var path = ConfigPath(t);
+        var dir = Path.GetDirectoryName(path);
+        if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
+
+        var root = LoadRoot(path);
+        if (root["mcpServers"] is not JsonObject servers)
+        {
+            servers = new JsonObject();
+            root["mcpServers"] = servers;
+        }
+        foreach (var s in Servers)
+            servers[s.Name] = BuildEntry(t, s);
+        WriteRoot(path, root);
+        AppLogger.Info($"MCP registered to {DisplayName(t)} at {path}");
+    }
+
+    /// <summary>從該目標設定檔移除所有 ETTerms MCP servers。</summary>
+    public static void Unregister(McpTarget t)
+    {
+        var path = ConfigPath(t);
+        if (!File.Exists(path)) return;
+        var root = LoadRoot(path);
+        if (root["mcpServers"] is JsonObject servers)
+        {
+            bool changed = false;
+            foreach (var s in Servers)
+                changed |= servers.Remove(s.Name);
+            if (changed)
+            {
+                WriteRoot(path, root);
+                AppLogger.Info($"MCP unregistered from {DisplayName(t)} at {path}");
+            }
+        }
+    }
+
+    private static JsonObject BuildEntry(McpTarget t, McpServer server)
+    {
+        var exe = ResolveServerExe(server);
+        return t switch
+        {
+            // Claude Code：stdio server 需 type 欄位
+            McpTarget.Claude => new JsonObject
+            {
+                ["type"] = "stdio",
+                ["command"] = exe,
+                ["args"] = new JsonArray()
+            },
+            // Kiro：local server，附 env / disabled / autoApprove 預設
+            McpTarget.Kiro => new JsonObject
+            {
+                ["command"] = exe,
+                ["args"] = new JsonArray(),
+                ["env"] = new JsonObject(),
+                ["disabled"] = false,
+                ["autoApprove"] = new JsonArray()
+            },
+            _ => throw new ArgumentOutOfRangeException(nameof(t))
+        };
+    }
+
+    /// <summary>讀入設定檔為可變 JSON 物件；不存在回空物件。檔案存在但格式錯誤則丟例外（不覆蓋使用者資料）。</summary>
+    private static JsonObject LoadRoot(string path)
+    {
+        if (!File.Exists(path)) return new JsonObject();
+        var text = File.ReadAllText(path);
+        if (string.IsNullOrWhiteSpace(text)) return new JsonObject();
+        if (JsonNode.Parse(text) is JsonObject obj) return obj;
+        throw new InvalidDataException($"{path} 不是有效的 JSON 物件，為避免覆蓋資料已中止。請手動檢查該檔。");
+    }
+
+    /// <summary>原子寫回（先寫 .tmp 再 replace），避免半寫壞檔。</summary>
+    private static void WriteRoot(string path, JsonObject root)
+    {
+        var json = root.ToJsonString(new JsonSerializerOptions { WriteIndented = true });
+        var tmp = path + ".tmp";
+        File.WriteAllText(tmp, json);
+        if (File.Exists(path)) File.Replace(tmp, path, null);
+        else File.Move(tmp, path);
+    }
+}

src/ETTerms/Infrastructure/SessionLogger.cs

@@ -23,6 +23,7 @@ public sealed class SessionLogger : IDisposable
     private readonly object _lock = new();
     private readonly StreamWriter _writer;
     private readonly StringBuilder _pending = new();
+    private readonly Decoder _decoder = Encoding.UTF8.GetDecoder();   // stateful：多位元組字元跨 chunk 不會解成亂碼
     private bool _disposed;
 
     /// <summary>實際寫入的完整檔案路徑。</summary>
@@ -52,13 +53,15 @@ public sealed class SessionLogger : IDisposable
     public void Write(byte[] data)
     {
         if (_disposed || data.Length == 0) return;
-        string text = Encoding.UTF8.GetString(data);
-        string clean = AnsiRegex.Replace(text, "").Replace("\r", "");
-        if (clean.Length == 0) return;
 
         lock (_lock)
         {
             if (_disposed) return;
+            var chars = new char[data.Length];
+            int n = _decoder.GetChars(data, 0, data.Length, chars, 0);
+            if (n == 0) return;
+            string clean = AnsiRegex.Replace(new string(chars, 0, n), "").Replace("\r", "");
+            if (clean.Length == 0) return;
             string stamp = $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss.fff}] ";
             int start = 0;
             for (int i = 0; i < clean.Length; i++)

src/ETTerms/Scripting/Pdu/PduController.cs

@@ -1,76 +0,0 @@
-using System.Net;
-using ETTerms.Infrastructure;
-using SnmpSharpNet;
-
-namespace ETTerms.Scripting.Pdu;
-
-/// <summary>
-/// PDU Controller for iPoMan II/III models via SNMP.
-/// Ported from MyTeraTerm's PDUControlLib.
-/// </summary>
-public sealed class PduController : IDisposable
-{
-    private readonly string _ip;
-    private const string Community = "private";
-    private const int SnmpPort = 161;
-    private const int Timeout = 3000;
-
-    public PduController(string ip) => _ip = ip;
-
-    public bool CheckConnection()
-    {
-        var name = SnmpGet(".1.3.6.1.4.1.2468.1.4.2.1.1.4");
-        AppLogger.Info($"[PDU] CheckConnection {_ip}: name='{name ?? "<null>"}'");
-        return !string.IsNullOrEmpty(name) && name.Contains("PDU");
-    }
-
-    public bool SetPortOn(int port) => SnmpSet(PortControlOid(port), new Integer32(3));
-    public bool SetPortOff(int port) => SnmpSet(PortControlOid(port), new Integer32(4));
-
-    public bool? GetPortState(int port)
-    {
-        var r = SnmpGet(PortStateOid(port));
-        return r == "3" ? true : (r == "2" || r == "4") ? false : null;
-    }
-
-    public int? GetPortCurrent(int port) => int.TryParse(SnmpGet(PortCurrentOid(port)), out int v) ? v : null;
-    public double? GetPortPowerWatts(int port) => int.TryParse(SnmpGet(PortPowerOid(port)), out int v) ? v / 10.0 : null;
-
-    private static string PortControlOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.4.1.2.{port}";
-    private static string PortStateOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.2.{port}";
-    private static string PortCurrentOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.3.{port}";
-    private static string PortPowerOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.5.{port}";
-
-    private bool SnmpSet(string oid, AsnType value)
-    {
-        try
-        {
-            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
-            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
-            var pdu = new SnmpSharpNet.Pdu(PduType.Set);
-            pdu.VbList.Add(new Oid(oid), value);
-            var result = (SnmpV1Packet)target.Request(pdu, param);
-            return result?.Pdu.ErrorStatus == 0;
-        }
-        catch { return false; }
-    }
-
-    private string? SnmpGet(string oid)
-    {
-        try
-        {
-            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
-            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
-            var pdu = new SnmpSharpNet.Pdu(PduType.Get);
-            pdu.VbList.Add(new Oid(oid));
-            var result = (SnmpV1Packet)target.Request(pdu, param);
-            if (result == null) { AppLogger.LogWarning($"[PDU] SNMP GET {oid}: no response (timeout)"); return null; }
-            if (result.Pdu.ErrorStatus != 0) { AppLogger.LogWarning($"[PDU] SNMP GET {oid}: ErrorStatus={result.Pdu.ErrorStatus}"); return null; }
-            foreach (var v in result.Pdu.VbList) return v.Value.ToString();
-        }
-        catch (Exception ex) { AppLogger.LogError($"[PDU] SNMP GET {oid} exception", ex); }
-        return null;
-    }
-
-    public void Dispose() { }
-}

src/ETTerms/Scripting/ScriptRunner.cs

@@ -14,47 +14,25 @@ public sealed class ScriptRunner
     /// <summary>(檔名, 行號, 指令) 進度。</summary>
     public event Action<string, int, string>? StatusChanged;
 
-    /// <summary>輸出訊息（log / 提示 / 錯誤）。</summary>
+    /// <summary>trace 訊息（[wait] 進度 / >> 送出回顯 / 錯誤）；顯示與否由 UI 依設定決定。</summary>
     public event Action<string>? Output;
 
+    /// <summary>dispstr 的顯示輸出（一律顯示）。</summary>
+    public event Action<string>? Display;
+
     /// <summary>結束：(成功, 訊息)。</summary>
     public event Action<bool, string>? Finished;
 
     public bool IsRunning { get; private set; }
 
-    public async Task RunAsync(string content, string fileName, ISessionChannel channel)
+    public Task RunAsync(string content, string fileName, ISessionChannel channel)
-    {
+        => RunCoreAsync(content, fileName, channel, null, "");
-        if (IsRunning) return;
-        IsRunning = true;
 
-        var interp = new TTLInterpreter(channel);
+    public Task RunGroupAsync(string content, string fileName, ISessionChannel channel, GroupSyncContext sync, string memberLabel = "")
-        interp.StatusChanged += (f, l, c) => StatusChanged?.Invoke(f, l, c);
+        => RunCoreAsync(content, fileName, channel, sync, memberLabel);
-        interp.Output += m => Output?.Invoke(m);
-        _interp = interp;
 
-        try
+    private async Task RunCoreAsync(string content, string fileName, ISessionChannel channel,
-        {
+        GroupSyncContext? sync, string memberLabel)
-            await Task.Run(() => interp.ExecuteScriptContent(content, fileName));
-            Finished?.Invoke(true, "Completed");
-        }
-        catch (OperationCanceledException)
-        {
-            Finished?.Invoke(false, "Cancelled");
-        }
-        catch (Exception ex)
-        {
-            Output?.Invoke($"[error] {ex.Message}");
-            Finished?.Invoke(false, ex.Message);
-        }
-        finally
-        {
-            interp.Dispose();
-            _interp = null;
-            IsRunning = false;
-        }
-    }
-
-    public async Task RunGroupAsync(string content, string fileName, ISessionChannel channel, GroupSyncContext sync, string memberLabel = "")
     {
         if (IsRunning) return;
         IsRunning = true;
@@ -62,6 +40,7 @@ public sealed class ScriptRunner
         var interp = new TTLInterpreter(channel, sync, memberLabel);
         interp.StatusChanged += (f, l, c) => StatusChanged?.Invoke(f, l, c);
         interp.Output += m => Output?.Invoke(m);
+        interp.Display += m => Display?.Invoke(m);
         _interp = interp;
 
         try

src/ETTerms/Scripting/TtlExpression.cs

@@ -0,0 +1,253 @@
+using System.Globalization;
+
+namespace ETTerms.Scripting;
+
+/// <summary>
+/// TTL 運算式解析 / 求值器（v0.5.0，供 if / elseif / while / until / for / 變數指派使用）。
+///
+/// 支援：
+///   - 整數：十進位、<c>0x1F</c>、<c>$1F</c>（TeraTerm 十六進位）
+///   - 字串常值：<c>'...'</c> 或 <c>"..."</c>
+///   - 變數（由呼叫端 resolver 解析；未定義視為 0）
+///   - 括號、一元 <c>-</c> / <c>not</c> / <c>!</c> / <c>~</c>
+///   - 算術 <c>* / % + -</c>
+///   - 比較 <c>= == &lt;&gt; != &gt; &lt; &gt;= &lt;=</c>（兩邊皆可為整數時用數值比較，否則字串比較）
+///   - 邏輯 <c>and or xor</c>（同義：<c>&amp;&amp; ||</c>）
+///
+/// 值為 <see cref="object"/>：int 或 string；比較 / 邏輯運算結果為 int 1/0。
+/// </summary>
+public static class TtlExpression
+{
+    /// <summary>求值整段文字；結尾若有多餘內容視為錯誤（FormatException）。</summary>
+    public static object Evaluate(string text, Func<string, object?> resolve)
+    {
+        int pos = 0;
+        var v = ParseOr(text, ref pos, resolve);
+        SkipWs(text, ref pos);
+        if (pos < text.Length) throw new FormatException($"unexpected '{text[pos..]}'");
+        return v;
+    }
+
+    /// <summary>從 <paramref name="pos"/> 起解析一個運算式，pos 停在運算式之後（供單行 if 判斷剩餘 statement）。</summary>
+    public static object Parse(string text, ref int pos, Func<string, object?> resolve)
+        => ParseOr(text, ref pos, resolve);
+
+    public static bool Truthy(object? v) => ToInt(v) != 0;
+
+    public static int ToInt(object? v) => v switch
+    {
+        int i => i,
+        string s when TryParseInt(s.Trim(), out int r) => r,
+        _ => 0
+    };
+
+    public static string ToStr(object? v) => v switch
+    {
+        null => "",
+        string s => s,
+        _ => v.ToString() ?? ""
+    };
+
+    // ── 文法（優先序低 → 高）─────────────────────────────────
+    private static object ParseOr(string s, ref int p, Func<string, object?> r)
+    {
+        var v = ParseAnd(s, ref p, r);
+        while (true)
+        {
+            SkipWs(s, ref p);
+            if (MatchWord(s, ref p, "or") || MatchOp(s, ref p, "||"))
+                v = (Truthy(v) | Truthy(ParseAnd(s, ref p, r))) ? 1 : 0;
+            else if (MatchWord(s, ref p, "xor"))
+                v = (Truthy(v) ^ Truthy(ParseAnd(s, ref p, r))) ? 1 : 0;
+            else return v;
+        }
+    }
+
+    private static object ParseAnd(string s, ref int p, Func<string, object?> r)
+    {
+        var v = ParseCompare(s, ref p, r);
+        while (true)
+        {
+            SkipWs(s, ref p);
+            if (MatchWord(s, ref p, "and") || MatchOp(s, ref p, "&&"))
+                v = (Truthy(v) & Truthy(ParseCompare(s, ref p, r))) ? 1 : 0;
+            else return v;
+        }
+    }
+
+    private static object ParseCompare(string s, ref int p, Func<string, object?> r)
+    {
+        var l = ParseAdd(s, ref p, r);
+        SkipWs(s, ref p);
+        string? op =
+            MatchOp(s, ref p, ">=") ? ">=" :
+            MatchOp(s, ref p, "<=") ? "<=" :
+            MatchOp(s, ref p, "<>") ? "!=" :
+            MatchOp(s, ref p, "==") ? "==" :
+            MatchOp(s, ref p, "!=") ? "!=" :
+            MatchOp(s, ref p, "=") ? "==" :
+            MatchOp(s, ref p, ">") ? ">" :
+            MatchOp(s, ref p, "<") ? "<" : null;
+        if (op == null) return l;
+
+        var rt = ParseAdd(s, ref p, r);
+
+        // 兩邊皆可為整數 → 數值比較；否則字串比較（僅 == / !=；大小比較退回數值 0）
+        bool numeric = l is int || rt is int
+            || (TryParseInt(ToStr(l).Trim(), out _) && TryParseInt(ToStr(rt).Trim(), out _));
+        if (numeric)
+        {
+            int a = ToInt(l), b = ToInt(rt);
+            return op switch
+            {
+                "==" => a == b ? 1 : 0,
+                "!=" => a != b ? 1 : 0,
+                ">=" => a >= b ? 1 : 0,
+                "<=" => a <= b ? 1 : 0,
+                ">" => a > b ? 1 : 0,
+                _ => a < b ? 1 : 0
+            };
+        }
+        int cmp = string.CompareOrdinal(ToStr(l), ToStr(rt));
+        return op switch
+        {
+            "==" => cmp == 0 ? 1 : 0,
+            "!=" => cmp != 0 ? 1 : 0,
+            ">=" => cmp >= 0 ? 1 : 0,
+            "<=" => cmp <= 0 ? 1 : 0,
+            ">" => cmp > 0 ? 1 : 0,
+            _ => cmp < 0 ? 1 : 0
+        };
+    }
+
+    private static object ParseAdd(string s, ref int p, Func<string, object?> r)
+    {
+        var v = ParseMul(s, ref p, r);
+        while (true)
+        {
+            SkipWs(s, ref p);
+            if (MatchOp(s, ref p, "+")) v = ToInt(v) + ToInt(ParseMul(s, ref p, r));
+            else if (MatchOp(s, ref p, "-")) v = ToInt(v) - ToInt(ParseMul(s, ref p, r));
+            else return v;
+        }
+    }
+
+    private static object ParseMul(string s, ref int p, Func<string, object?> r)
+    {
+        var v = ParseUnary(s, ref p, r);
+        while (true)
+        {
+            SkipWs(s, ref p);
+            if (MatchOp(s, ref p, "*")) v = ToInt(v) * ToInt(ParseUnary(s, ref p, r));
+            else if (MatchOp(s, ref p, "/"))
+            {
+                int d = ToInt(ParseUnary(s, ref p, r));
+                v = d != 0 ? ToInt(v) / d : 0;
+            }
+            else if (MatchOp(s, ref p, "%"))
+            {
+                int d = ToInt(ParseUnary(s, ref p, r));
+                v = d != 0 ? ToInt(v) % d : 0;
+            }
+            else return v;
+        }
+    }
+
+    private static object ParseUnary(string s, ref int p, Func<string, object?> r)
+    {
+        SkipWs(s, ref p);
+        if (MatchOp(s, ref p, "-")) return -ToInt(ParseUnary(s, ref p, r));
+        if (MatchOp(s, ref p, "~")) return ~ToInt(ParseUnary(s, ref p, r));
+        if (MatchOp(s, ref p, "!")) return Truthy(ParseUnary(s, ref p, r)) ? 0 : 1;
+        if (MatchWord(s, ref p, "not")) return Truthy(ParseUnary(s, ref p, r)) ? 0 : 1;
+        return ParsePrimary(s, ref p, r);
+    }
+
+    private static object ParsePrimary(string s, ref int p, Func<string, object?> r)
+    {
+        SkipWs(s, ref p);
+        if (p >= s.Length) throw new FormatException("unexpected end of expression");
+
+        char c = s[p];
+        if (c == '(')
+        {
+            p++;
+            var v = ParseOr(s, ref p, r);
+            SkipWs(s, ref p);
+            if (p >= s.Length || s[p] != ')') throw new FormatException("missing ')'");
+            p++;
+            return v;
+        }
+        if (c is '\'' or '"')
+        {
+            char q = c;
+            int start = ++p;
+            while (p < s.Length && s[p] != q) p++;
+            if (p >= s.Length) throw new FormatException("unterminated string");
+            var str = s[start..p];
+            p++;
+            return str;
+        }
+        if (c == '$')   // TeraTerm 十六進位 $1F
+        {
+            int start = ++p;
+            while (p < s.Length && Uri.IsHexDigit(s[p])) p++;
+            if (p == start) throw new FormatException("invalid hex literal");
+            return int.Parse(s[start..p], NumberStyles.HexNumber, CultureInfo.InvariantCulture);
+        }
+        if (char.IsDigit(c))
+        {
+            if (c == '0' && p + 1 < s.Length && (s[p + 1] is 'x' or 'X'))
+            {
+                int hs = p + 2, hp = hs;
+                while (hp < s.Length && Uri.IsHexDigit(s[hp])) hp++;
+                if (hp == hs) throw new FormatException("invalid hex literal");
+                p = hp;
+                return int.Parse(s[hs..hp], NumberStyles.HexNumber, CultureInfo.InvariantCulture);
+            }
+            int ds = p;
+            while (p < s.Length && char.IsDigit(s[p])) p++;
+            return int.Parse(s[ds..p], CultureInfo.InvariantCulture);
+        }
+        if (char.IsLetter(c) || c == '_')
+        {
+            int ws = p;
+            while (p < s.Length && (char.IsLetterOrDigit(s[p]) || s[p] == '_')) p++;
+            return r(s[ws..p]) ?? 0;   // 未定義變數 → 0
+        }
+        throw new FormatException($"unexpected character '{c}'");
+    }
+
+    // ── 小工具 ───────────────────────────────────────────────
+    private static void SkipWs(string s, ref int p) { while (p < s.Length && char.IsWhiteSpace(s[p])) p++; }
+
+    private static bool MatchOp(string s, ref int p, string op)
+    {
+        if (p + op.Length > s.Length || !s.AsSpan(p, op.Length).SequenceEqual(op)) return false;
+        // "=" 不可吃掉 "=="、"<" 不可吃掉 "<=" / "<>"（呼叫端已按長度優先排序，這裡防呆單字元誤判）
+        if (op == "=" && p + 1 < s.Length && s[p + 1] == '=') return false;
+        if (op == ">" && p + 1 < s.Length && s[p + 1] == '=') return false;
+        if (op == "<" && p + 1 < s.Length && (s[p + 1] == '=' || s[p + 1] == '>')) return false;
+        p += op.Length;
+        return true;
+    }
+
+    private static bool MatchWord(string s, ref int p, string word)
+    {
+        if (p + word.Length > s.Length) return false;
+        if (!s.AsSpan(p, word.Length).Equals(word, StringComparison.OrdinalIgnoreCase)) return false;
+        int after = p + word.Length;
+        if (after < s.Length && (char.IsLetterOrDigit(s[after]) || s[after] == '_')) return false;   // 是識別字的一部分
+        p = after;
+        return true;
+    }
+
+    private static bool TryParseInt(string s, out int v)
+    {
+        if (s.StartsWith("0x") || s.StartsWith("0X"))
+            return int.TryParse(s[2..], NumberStyles.HexNumber, CultureInfo.InvariantCulture, out v);
+        if (s.StartsWith("$"))
+            return int.TryParse(s[1..], NumberStyles.HexNumber, CultureInfo.InvariantCulture, out v);
+        return int.TryParse(s, NumberStyles.Integer, CultureInfo.InvariantCulture, out v);
+    }
+}

src/ETTerms/Scripting/TtlScript.cs

@@ -0,0 +1,44 @@
+using System.Windows.Forms;
+
+namespace ETTerms.Scripting;
+
+/// <summary>
+/// TTL 腳本檔的共用小工具：選檔載入與 group 指令檢查。
+/// SessionPage（▶ Script）與 WorkspaceView（Run All / Run Group）共用，避免三份重複流程。
+/// </summary>
+public static class TtlScript
+{
+    /// <summary>跳出選檔對話框並讀入腳本內容。使用者取消回傳 false。</summary>
+    public static bool TryPick(IWin32Window owner, out string content, out string fileName)
+    {
+        content = "";
+        fileName = "";
+        using var dlg = new OpenFileDialog { Filter = "TTL scripts (*.ttl)|*.ttl|All files (*.*)|*.*" };
+        if (dlg.ShowDialog(owner) != DialogResult.OK) return false;
+        content = File.ReadAllText(dlg.FileName);
+        fileName = Path.GetFileName(dlg.FileName);
+        return true;
+    }
+
+    /// <summary>腳本是否含只能在 Run Group 模式使用的同步指令（waitall / sendlnall / sendlngroup）。</summary>
+    public static bool ContainsGroupCommands(string content)
+    {
+        foreach (var line in content.Split('\n'))
+        {
+            var t = line.Trim().ToLower();
+            if (t.StartsWith("waitall") || t.StartsWith("sendlnall") || t.StartsWith("sendlngroup"))
+                return true;
+        }
+        return false;
+    }
+
+    /// <summary>含 group 指令時警告並回傳 true（呼叫端應中止，改用 Run Group）。</summary>
+    public static bool WarnIfGroupCommands(IWin32Window owner, string content, string caption)
+    {
+        if (!ContainsGroupCommands(content)) return false;
+        MessageBox.Show(owner,
+            "Script contains 'waitall' or 'sendlnall' which require Group execution.\nPlease use Run Group buttons instead.",
+            caption, MessageBoxButtons.OK, MessageBoxIcon.Warning);
+        return true;
+    }
+}

src/ETTerms/Sessions/SerialBridgeServer.cs

@@ -69,13 +69,28 @@ public sealed class SerialBridgeServer : IDisposable
                             Send(new { sessions = SerialBridge.All.Select(e => new { name = e.Name, baud = e.BaudRate }) });
                             break;
                         case "attach":
+                        {
                             Detach();
                             attached = SerialBridge.Find(req.session ?? "");
                             if (attached == null) { Send(new { ok = false, error = $"no open serial session '{req.session}' in GUI" }); break; }
-                            rx = data => Send(new { op = "rx", data = Encoding.UTF8.GetString(data) });
+                            // stateful Decoder：UTF-8 多位元組字元跨 chunk 邊界時不會解成亂碼
+                            var dec = Encoding.UTF8.GetDecoder();
+                            var decLock = new object();
+                            rx = data =>
+                            {
+                                string s;
+                                lock (decLock)
+                                {
+                                    var chars = new char[data.Length];
+                                    int n = dec.GetChars(data, 0, data.Length, chars, 0);
+                                    s = new string(chars, 0, n);
+                                }
+                                if (s.Length > 0) Send(new { op = "rx", data = s });
+                            };
                             attached.Rx += rx;
                             Send(new { ok = true, name = attached.Name });
                             break;
+                        }
                         case "write":
                             if (attached == null) { Send(new { ok = false, error = "not attached" }); break; }
                             attached.Write(req.data ?? "", req.newline);

src/ETTerms/Sessions/SerialChannel.cs

@@ -72,6 +72,22 @@ public sealed class SerialChannel : ISessionChannel
         if (_port.IsOpen) _port.Write(data, 0, data.Length);
     }
 
+    // ── TTL serial 控制指令用（sendbreak / setbaud / setdtr / setrts）──
+
+    /// <summary>送出 serial break（拉 break 狀態約 300ms）。</summary>
+    public void SendBreak()
+    {
+        if (!_port.IsOpen) return;
+        try { _port.BreakState = true; Thread.Sleep(300); }
+        finally { try { _port.BreakState = false; } catch { } }
+    }
+
+    /// <summary>執行中變更 baud rate（TTL setbaud）。</summary>
+    public void SetBaudRate(int baud) => _port.BaudRate = baud;
+
+    public void SetDtr(bool on) => _port.DtrEnable = on;
+    public void SetRts(bool on) => _port.RtsEnable = on;
+
     public void Resize(int cols, int rows) { /* serial 無 PTY size */ }
 
     public void Close()

src/ETTerms/Sessions/SessionPage.cs

@@ -63,6 +63,9 @@ public sealed class SessionPage : UserControl
     /// <summary>同步開啟失敗（主要是 Serial 連不上 / 被占用）時觸發，附帶訊息。</summary>
     public event Action<string>? ConnectFailed;
 
+    /// <summary>輸出中出現啟用的高亮關鍵字（UI thread），供 WorkspaceView 標分頁警示。</summary>
+    public event Action<string>? KeywordAlert;
+
     public SessionPage(ISessionChannel channel, string title)
     {
         _channel = channel;
@@ -90,30 +93,29 @@ public sealed class SessionPage : UserControl
         _term = new TerminalView(new TerminalProfile()) { Dock = DockStyle.Fill };
         _term.SendData += data => _channel.Write(data);
         _term.Resized += (cols, rows) => _channel.Resize(cols, rows);
+        _term.KeywordAlert += k => KeywordAlert?.Invoke(k);
 
         Controls.Add(_term);  // Fill 先加
         Controls.Add(bar);    // Top
 
         _runner.StatusChanged += (_, line, cmd) => Ui(() => _status.Text = $"line {line}: {Trunc(cmd)}");
         _runner.Finished += (_, msg) => Ui(() => { _status.Text = msg; SetRunning(false); });
+        // 腳本 trace（[wait] 進度 / >> 送出回顯 / 錯誤）以灰色 echo 到終端機；
+        // 可由 Settings → Terminal 的 Show script trace 關閉。只影響畫面，不會進側錄 log。
+        _runner.Output += m =>
+        {
+            if (!AppSettings.Instance.ShowScriptTrace) return;
+            Ui(() => _term.Feed(System.Text.Encoding.UTF8.GetBytes($"\x1b[90m{m}\x1b[0m\r\n")));
+        };
+        // dispstr 是腳本明確要顯示的內容，一律顯示（不受開關影響）
+        _runner.Display += m => Ui(() =>
+            _term.Feed(System.Text.Encoding.UTF8.GetBytes($"\x1b[90m{m}\x1b[0m\r\n")));
     }
 
     private async void OnRunScript(object? sender, EventArgs e)
     {
-        string content, name;
+        if (!TtlScript.TryPick(this, out var content, out var name)) return;
-        using (var dlg = new OpenFileDialog { Filter = "TTL scripts (*.ttl)|*.ttl|All files (*.*)|*.*" })
+        if (TtlScript.WarnIfGroupCommands(this, content, "Script")) return;
-        {
-            if (dlg.ShowDialog(this) != DialogResult.OK) return;
-            content = File.ReadAllText(dlg.FileName);
-            name = Path.GetFileName(dlg.FileName);
-        }
-        if (ContainsGroupCommands(content))
-        {
-            MessageBox.Show(this,
-                "Script contains 'waitall' or 'sendlnall' which require Group execution.\nPlease use Run Group buttons instead.",
-                "Script", MessageBoxButtons.OK, MessageBoxIcon.Warning);
-            return;
-        }
         SetRunning(true);
         await _runner.RunAsync(content, name, _channel);
     }
@@ -168,17 +170,6 @@ public sealed class SessionPage : UserControl
         _log.FlatAppearance.BorderColor = on ? Theme.SerialColor : Theme.Border;
     }
 
-    private static bool ContainsGroupCommands(string content)
-    {
-        foreach (var line in content.Split('\n'))
-        {
-            var t = line.Trim().ToLower();
-            if (t.StartsWith("waitall") || t.StartsWith("sendlnall") || t.StartsWith("sendlngroup"))
-                return true;
-        }
-        return false;
-    }
-
     private void SetRunning(bool running)
     {
         _run.Enabled = !running;

src/ETTerms/Sessions/ShellChannel.cs

@@ -66,17 +66,32 @@ public sealed class ShellChannel : ISessionChannel
         UpdateProcThreadAttribute(si.lpAttributeList, 0, (IntPtr)0x00020016 /* PROC_THREAD_ATTRIBUTE_PSEUDOCONSOLE */,
             _ptyHandle, IntPtr.Size, IntPtr.Zero, IntPtr.Zero);
 
-        string workDir = string.IsNullOrWhiteSpace(_settings.StartupDirectory)
+        // 啟動目錄：若未設定或該目錄已不存在（例如外接碟拔除、資料夾被刪），
-            ? Environment.GetFolderPath(Environment.SpecialFolder.UserProfile)
+        // 一律退回目前使用者的家目錄（C:\Users\<user>），避免 CreateProcess 失敗 267 (ERROR_DIRECTORY)。
-            : _settings.StartupDirectory;
+        string configured = _settings.StartupDirectory;
+        string workDir = (!string.IsNullOrWhiteSpace(configured) && Directory.Exists(configured))
+            ? configured
+            : Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
 
-        bool ok = CreateProcess(null, $"{exe} {args}".TrimEnd(), IntPtr.Zero, IntPtr.Zero, false,
+        bool ok;
-            0x00080000 /* EXTENDED_STARTUPINFO_PRESENT */, IntPtr.Zero, workDir, ref si, out var pi);
+        PROCESS_INFORMATION pi;
+        try
+        {
+            ok = CreateProcess(null, $"{exe} {args}".TrimEnd(), IntPtr.Zero, IntPtr.Zero, false,
+                0x00080000 /* EXTENDED_STARTUPINFO_PRESENT */, IntPtr.Zero, workDir, ref si, out pi);
+        }
+        finally
+        {
+            // attribute list 在 CreateProcess 返回後即可釋放（文件保證），不釋放會每開一個 shell 漏一次
+            DeleteProcThreadAttributeList(si.lpAttributeList);
+            Marshal.FreeHGlobal(si.lpAttributeList);
+        }
 
         if (!ok) throw new Exception($"CreateProcess failed: {Marshal.GetLastWin32Error()}");
 
         CloseHandle(pi.hThread);
         _proc = Process.GetProcessById(pi.dwProcessId);
+        CloseHandle(pi.hProcess);   // 之後都經由 _proc 操作，raw handle 不留（避免 handle 洩漏）
 
         // Start reader thread
         _reader = new Thread(ReadLoop) { IsBackground = true, Name = "ConPTY-Reader" };
@@ -98,7 +113,12 @@ public sealed class ShellChannel : ISessionChannel
                 DataReceived?.Invoke(data);
             }
         }
-        catch when (_closed) { }
+        catch { /* 使用者關閉或 ConPTY 收掉都會走到這，不可讓例外殺掉行程 */ }
+
+        // shell 自己 exit（非使用者關分頁）時給個明確提示，分頁才不會看起來像死掉
+        if (!_closed)
+            DataReceived?.Invoke(Encoding.UTF8.GetBytes(
+                "\r\n\x1b[90m[ETTerms] shell process exited\x1b[0m\r\n"));
     }
 
     public void Write(byte[] data)
@@ -173,6 +193,9 @@ public sealed class ShellChannel : ISessionChannel
     [DllImport("kernel32.dll", SetLastError = true)]
     private static extern bool UpdateProcThreadAttribute(IntPtr lpAttributeList, uint dwFlags, IntPtr Attribute, IntPtr lpValue, IntPtr cbSize, IntPtr lpPreviousValue, IntPtr lpReturnSize);
 
+    [DllImport("kernel32.dll")]
+    private static extern void DeleteProcThreadAttributeList(IntPtr lpAttributeList);
+
     [DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Auto)]
     private static extern bool CreateProcess(string? lpApplicationName, string lpCommandLine, IntPtr lpProcessAttributes, IntPtr lpThreadAttributes, bool bInheritHandles, uint dwCreationFlags, IntPtr lpEnvironment, string lpCurrentDirectory, ref STARTUPINFOEX lpStartupInfo, out PROCESS_INFORMATION lpProcessInformation);
 

src/ETTerms/Sessions/SshChannel.cs

@@ -40,9 +40,22 @@ public sealed class SshChannel : ISessionChannel
             var ci = BuildConnectionInfo();
             _client = new SshClient(ci);
             _client.HostKeyReceived += OnHostKey;
+            // 斷線 / 錯誤要讓使用者看得到，否則只會覺得「打字沒反應」
+            _client.ErrorOccurred += (_, e) =>
+            {
+                if (_closed) return;
+                Emit($"\r\n\x1b[90m[SSH error] {e.Exception.Message}\x1b[0m\r\n");
+                AppLogger.LogWarning($"SSH error {_ssh.Host}: {e.Exception.Message}");
+            };
             _client.Connect();
             _shell = _client.CreateShellStream("xterm-256color", (uint)_cols, (uint)_rows, 0, 0, 4096);
             _shell.DataReceived += (_, e) => DataReceived?.Invoke(e.Data);
+            _shell.Closed += (_, _) =>
+            {
+                if (_closed) return;
+                Emit("\r\n\x1b[90m[SSH] connection closed by remote host\x1b[0m\r\n");
+                AppLogger.Info($"SSH shell closed: {_ssh.Host}");
+            };
             AppLogger.Info($"SSH connected: {_ssh.Username}@{_ssh.Host}:{_ssh.Port}");
         }
         catch (Exception ex)
@@ -102,8 +115,15 @@ public sealed class SshChannel : ISessionChannel
     public void Write(byte[] data)
     {
         if (_shell == null) return;
-        _shell.Write(data, 0, data.Length);
+        try
-        _shell.Flush();
+        {
+            _shell.Write(data, 0, data.Length);
+            _shell.Flush();
+        }
+        catch (Exception ex)   // 連線已斷時從 UI thread 寫入不可讓例外炸掉視窗
+        {
+            if (!_closed) Emit($"\r\n\x1b[90m[SSH] write failed: {ex.Message}\x1b[0m\r\n");
+        }
     }
 
     public void Resize(int cols, int rows)

src/ETTerms/Terminal/AnsiParser.cs

@@ -19,6 +19,14 @@ public sealed class AnsiParser
     /// <summary>DECCKM：application cursor keys（影響方向鍵送出序列）。</summary>
     public bool AppCursorKeys { get; private set; }
 
+    /// <summary>DEC mode 2004：bracketed paste。啟用時貼上內容須以 ESC[200~ / ESC[201~ 包夾，
+    /// 讓 PSReadLine / Kiro CLI 等把多行貼上視為單一輸入而非逐行立即送出。</summary>
+    public bool BracketedPaste { get; private set; }
+
+    /// <summary>對查詢序列（DSR ESC[5n/6n、DA ESC[c）的回覆，須回送給遠端。
+    /// vim 等 TUI 會查游標位置，收不到回覆可能卡住或排版錯亂。</summary>
+    public event Action<byte[]>? Response;
+
     public AnsiParser(ScreenBuffer buffer) => _b = buffer;
 
     public void Feed(byte[] data)
@@ -126,9 +134,20 @@ public sealed class AnsiParser
             case 'h': SetMode(p, true); break;
             case 'l': SetMode(p, false); break;
             case 'm': Sgr(p); break;
+            case 'n': if (!_priv) DeviceStatusReport(p); break;
+            case 'c': if (!_priv) Respond("\x1b[?1;2c"); break;   // DA：VT100 with AVO
         }
     }
 
+    private void DeviceStatusReport(int[] p)
+    {
+        int code = p.Length > 0 ? p[0] : 0;
+        if (code == 5) Respond("\x1b[0n");                                          // 裝置 OK
+        else if (code == 6) Respond($"\x1b[{_b.CursorRow + 1};{_b.CursorCol + 1}R"); // 游標位置（1-based）
+    }
+
+    private void Respond(string seq) => Response?.Invoke(Encoding.ASCII.GetBytes(seq));
+
     private void SetMode(int[] p, bool set)
     {
         if (!_priv) return;
@@ -138,6 +157,7 @@ public sealed class AnsiParser
                 case 25: _b.CursorVisible = set; break;
                 case 7: _b.AutoWrap = set; break;
                 case 1: AppCursorKeys = set; break;
+                case 2004: BracketedPaste = set; break;
                 case 47: case 1047: case 1049:
                     if (set) _b.EnterAlt(); else _b.ExitAlt(); break;
             }

src/ETTerms/Terminal/DarkScrollBar.cs

@@ -0,0 +1,166 @@
+using System.Drawing;
+using System.Drawing.Drawing2D;
+using System.Windows.Forms;
+
+namespace ETTerms.Terminal;
+
+/// <summary>
+/// 自繪深色垂直捲軸：細長、無箭頭按鈕、圓角滑塊，配合終端機深色主題。
+/// API（Minimum / Maximum / Value / LargeChange / SmallChange / Scroll）對齊 <see cref="VScrollBar"/>，
+/// 方便直接替換。<see cref="Scroll"/> 只在「使用者操作」造成值變動時觸發（程式設定 Value 不觸發）。
+/// </summary>
+public sealed class DarkScrollBar : Control
+{
+    public int Minimum { get; set; } = 0;
+    public int Maximum { get; set; } = 0;
+    public int LargeChange { get; set; } = 1;
+    public int SmallChange { get; set; } = 1;
+
+    private int _value;
+    public int Value
+    {
+        get => _value;
+        set { int v = Clamp(value); if (v != _value) { _value = v; Invalidate(); } }
+    }
+
+    /// <summary>使用者拖曳 / 點軌道 / 滾輪造成值變動時觸發。</summary>
+    public event EventHandler? Scroll;
+
+    // 配色（KKTerm 深色）
+    private static readonly Color TrackColor = Color.FromArgb(24, 24, 28);
+    private static readonly Color ThumbColor = Color.FromArgb(70, 70, 82);
+    private static readonly Color ThumbHover = Color.FromArgb(100, 100, 118);
+    private static readonly Color ThumbDrag = Color.FromArgb(130, 130, 152);
+
+    private bool _hover, _dragging;
+    private int _dragOffset;
+
+    public DarkScrollBar()
+    {
+        SetStyle(ControlStyles.AllPaintingInWmPaint | ControlStyles.UserPaint
+               | ControlStyles.OptimizedDoubleBuffer | ControlStyles.ResizeRedraw, true);
+        // 純滑鼠操作的捲軸，無任何鍵盤邏輯，絕不可吃鍵盤焦點：否則身為唯一可選取子控制項，
+        // 在 scrollback 出現（Enabled=true）後，視窗切走再切回時 WinForms 會把焦點還原到它身上，
+        // 導致 TerminalView 收不到鍵盤輸入（打字 / Enter 全失效），需重開 session 才恢復。
+        SetStyle(ControlStyles.Selectable, false);
+        TabStop = false;
+        Width = 12;
+        BackColor = TrackColor;
+    }
+
+    // ── 數值範圍工具 ─────────────────────────────────────────
+    /// <summary>可達的最大 Value（與 VScrollBar 相同：Maximum - LargeChange + 1）。</summary>
+    private int MaxValue => Math.Max(Minimum, Maximum - LargeChange + 1);
+    private int Clamp(int v) => Math.Clamp(v, Minimum, MaxValue);
+    private bool Scrollable => Enabled && MaxValue > Minimum;
+
+    // ── 滑塊幾何 ─────────────────────────────────────────────
+    private const int MinThumb = 24;
+    private const int Pad = 2;
+
+    private int TrackHeight => Math.Max(1, Height - Pad * 2);
+
+    private int ThumbHeight()
+    {
+        int total = Maximum - Minimum + 1;
+        if (total <= 0) return TrackHeight;
+        int h = (int)((long)TrackHeight * LargeChange / total);
+        return Math.Clamp(h, MinThumb, TrackHeight);
+    }
+
+    private int ThumbTop()
+    {
+        int range = MaxValue - Minimum;
+        if (range <= 0) return Pad;
+        int travel = TrackHeight - ThumbHeight();
+        return Pad + (int)((long)travel * (_value - Minimum) / range);
+    }
+
+    private Rectangle ThumbRect() => new(Pad, ThumbTop(), Math.Max(1, Width - Pad * 2), ThumbHeight());
+
+    // ── 繪製 ─────────────────────────────────────────────────
+    protected override void OnPaint(PaintEventArgs e)
+    {
+        var g = e.Graphics;
+        g.Clear(TrackColor);
+        if (!Scrollable) return;          // 不可捲動時只畫底色（與停用態一致）
+
+        g.SmoothingMode = SmoothingMode.AntiAlias;
+        var r = ThumbRect();
+        var color = _dragging ? ThumbDrag : _hover ? ThumbHover : ThumbColor;
+        int radius = Math.Min(r.Width, 6);
+        using var path = RoundedRect(r, radius);
+        using var b = new SolidBrush(color);
+        g.FillPath(b, path);
+    }
+
+    private static GraphicsPath RoundedRect(Rectangle r, int radius)
+    {
+        int d = radius * 2;
+        var p = new GraphicsPath();
+        if (d <= 0 || d > r.Width || d > r.Height) { p.AddRectangle(r); return p; }
+        p.AddArc(r.X, r.Y, d, d, 180, 90);
+        p.AddArc(r.Right - d, r.Y, d, d, 270, 90);
+        p.AddArc(r.Right - d, r.Bottom - d, d, d, 0, 90);
+        p.AddArc(r.X, r.Bottom - d, d, d, 90, 90);
+        p.CloseFigure();
+        return p;
+    }
+
+    // ── 滑鼠互動 ─────────────────────────────────────────────
+    protected override void OnMouseDown(MouseEventArgs e)
+    {
+        if (e.Button != MouseButtons.Left || !Scrollable) return;
+        var thumb = ThumbRect();
+        if (thumb.Contains(e.Location))
+        {
+            _dragging = true;
+            _dragOffset = e.Y - thumb.Top;
+        }
+        else
+        {
+            // 點軌道：往點擊方向翻一頁
+            SetValueFromUser(e.Y < thumb.Top ? _value - LargeChange : _value + LargeChange);
+        }
+        Invalidate();
+    }
+
+    protected override void OnMouseMove(MouseEventArgs e)
+    {
+        bool over = ThumbRect().Contains(e.Location);
+        if (over != _hover) { _hover = over; Invalidate(); }
+
+        if (!_dragging) return;
+        int travel = TrackHeight - ThumbHeight();
+        if (travel <= 0) return;
+        int range = MaxValue - Minimum;
+        int y = Math.Clamp(e.Y - _dragOffset - Pad, 0, travel);
+        SetValueFromUser(Minimum + (int)((long)y * range / travel));
+    }
+
+    protected override void OnMouseUp(MouseEventArgs e)
+    {
+        if (_dragging) { _dragging = false; Invalidate(); }
+    }
+
+    protected override void OnMouseLeave(EventArgs e)
+    {
+        if (_hover) { _hover = false; Invalidate(); }
+    }
+
+    protected override void OnMouseWheel(MouseEventArgs e)
+    {
+        if (!Scrollable) return;
+        int step = e.Delta / 120 * SmallChange * 3;
+        SetValueFromUser(_value - step);
+    }
+
+    private void SetValueFromUser(int v)
+    {
+        int nv = Clamp(v);
+        if (nv == _value) return;
+        _value = nv;
+        Invalidate();
+        Scroll?.Invoke(this, EventArgs.Empty);
+    }
+}

src/ETTerms/Terminal/ScreenBuffer.cs

@@ -33,8 +33,11 @@ public sealed class ScreenBuffer
     public bool AutoWrap = true;
 
     private Cell[][] _screen;
-    private readonly List<Cell[]> _scrollback = new();
+    // scrollback 用環形緩衝：滿了以後 push/丟舊行都是 O(1)。
-    private readonly int _maxScroll;
+    // （原本 List + RemoveRange(0,…) 在 buffer 滿時每推一行就整串搬移，大量輸出會愈跑愈卡。）
+    private readonly Cell[]?[] _sb;
+    private int _sbHead;                 // 最舊一行的位置
+    private int _sbCount;
     private int _top, _bottom;           // 滾動區（含）
     private bool _wrapPending;
 
@@ -49,15 +52,19 @@ public sealed class ScreenBuffer
     {
         Cols = Math.Max(1, cols); Rows = Math.Max(1, rows);
         DefaultFg = fg; DefaultBg = bg; PenFg = fg; PenBg = bg;
-        _maxScroll = maxScrollback;
+        _sb = new Cell[Math.Max(0, maxScrollback)][];
         _screen = NewGrid(Rows, Cols);
         _top = 0; _bottom = Rows - 1;
     }
 
     // ── 給 TerminalView 讀取 ─────────────────────────────────
-    public int ScrollbackCount => _scrollback.Count;
+    public int ScrollbackCount => _sbCount;
-    public int TotalRows => _scrollback.Count + Rows;
+    public int TotalRows => _sbCount + Rows;
-    public Cell[] LineAt(int abs) => abs < _scrollback.Count ? _scrollback[abs] : _screen[abs - _scrollback.Count];
+    public Cell[] LineAt(int abs) => abs < _sbCount ? _sb[(_sbHead + abs) % _sb.Length]! : _screen[abs - _sbCount];
+
+    /// <summary>scrollback 滿後被丟棄的總行數。搜尋以「絕對行號 = DroppedLines + abs」錨定命中，
+    /// 舊行被丟棄時命中位置不會漂移。</summary>
+    public long DroppedLines { get; private set; }
 
     // ── 內部建構工具 ─────────────────────────────────────────
     private Cell BlankPen() => new() { Ch = ' ', Fg = PenFg, Bg = PenBg, Attr = CellAttr.None };
@@ -73,8 +80,9 @@ public sealed class ScreenBuffer
 
     private void PushScroll(Cell[] line)
     {
-        _scrollback.Add(line);
+        if (_sb.Length == 0) return;
-        if (_scrollback.Count > _maxScroll) _scrollback.RemoveRange(0, _scrollback.Count - _maxScroll);
+        if (_sbCount < _sb.Length) _sb[(_sbHead + _sbCount++) % _sb.Length] = line;
+        else { _sb[_sbHead] = line; _sbHead = (_sbHead + 1) % _sb.Length; DroppedLines++; }   // 滿了：覆蓋最舊一行
     }
 
     // ── 輸出字元 ─────────────────────────────────────────────
@@ -229,7 +237,7 @@ public sealed class ScreenBuffer
 
     public void EraseInDisplay(int mode)
     {
-        if (mode == 3) { _scrollback.Clear(); return; }
+        if (mode == 3) { DroppedLines += _sbCount; Array.Clear(_sb); _sbHead = 0; _sbCount = 0; return; }
         if (mode == 2) { for (int r = 0; r < Rows; r++) _screen[r] = BlankLine(); return; }
         if (mode == 0)
         {
@@ -270,20 +278,29 @@ public sealed class ScreenBuffer
     {
         cols = Math.Max(1, cols); rows = Math.Max(1, rows);
         if (cols == Cols && rows == Rows) return;
-        var ng = new Cell[rows][];
+        _screen = Reflow(_screen, rows, cols);
-        for (int r = 0; r < rows; r++)
+        // alt screen 啟用中也要一併 reflow 保存的主畫面，否則 resize 後 ExitAlt 會還原失敗、
-        {
+        // 畫面殘留 TUI 內容。不可把 _mainScreen 丟掉。
-            ng[r] = new Cell[cols];
+        if (_mainScreen != null) _mainScreen = Reflow(_mainScreen, rows, cols);
-            for (int c = 0; c < cols; c++)
-                ng[r][c] = (r < Rows && c < Cols) ? _screen[r][c] : BlankDefault();
-        }
-        _screen = ng;
         Rows = rows; Cols = cols;
         _top = 0; _bottom = Rows - 1;
         CursorRow = Math.Clamp(CursorRow, 0, Rows - 1);
         CursorCol = Math.Clamp(CursorCol, 0, Cols - 1);
         _wrapPending = false;
-        _mainScreen = null;
+    }
-        if (AltActive) { /* alt 下 resize：重建 alt 畫面 */ }
+
+    /// <summary>把字格陣列重排到新尺寸，保留左上重疊區，其餘填預設空白。</summary>
+    private Cell[][] Reflow(Cell[][] src, int rows, int cols)
+    {
+        int oldRows = src.Length;
+        var ng = new Cell[rows][];
+        for (int r = 0; r < rows; r++)
+        {
+            ng[r] = new Cell[cols];
+            int oldCols = r < oldRows ? src[r].Length : 0;
+            for (int c = 0; c < cols; c++)
+                ng[r][c] = (c < oldCols) ? src[r][c] : BlankDefault();
+        }
+        return ng;
     }
 }

src/ETTerms/Terminal/TerminalInput.cs

@@ -9,6 +9,11 @@ public static class TerminalInput
 {
     public static byte[]? Map(KeyEventArgs e, bool appCursor)
     {
+        // Enter：一般送 CR(\r) 視為「送出」；Shift+Enter 送 LF(\n)，讓 PSReadLine / Kiro 等
+        // 視為「插入換行」以便輸入多行指令，而不是直接送出。
+        if (e.KeyCode == Keys.Enter)
+            return new[] { (byte)(e.Shift ? '\n' : '\r') };
+
         string? seq = e.KeyCode switch
         {
             Keys.Up => appCursor ? "\x1bOA" : "\x1b[A",
@@ -21,7 +26,6 @@ public static class TerminalInput
             Keys.Delete => "\x1b[3~",
             Keys.PageUp => "\x1b[5~",
             Keys.PageDown => "\x1b[6~",
-            Keys.Enter => "\r",
             Keys.Tab => "\t",
             Keys.Escape => "\x1b",
             Keys.Back => "\x7f",
@@ -41,4 +45,17 @@ public static class TerminalInput
         };
         return seq is null ? null : Encoding.ASCII.GetBytes(seq);
     }
+
+    /// <summary>滾輪 → 上/下方向鍵序列（alt screen 用，每格 3 行）。notches 正值往上。</summary>
+    public static byte[]? WheelArrows(int notches, bool appCursor)
+    {
+        if (notches == 0) return null;
+        string one = notches > 0
+            ? (appCursor ? "\x1bOA" : "\x1b[A")
+            : (appCursor ? "\x1bOB" : "\x1b[B");
+        int count = Math.Abs(notches) * 3;
+        var sb = new StringBuilder(one.Length * count);
+        for (int i = 0; i < count; i++) sb.Append(one);
+        return Encoding.ASCII.GetBytes(sb.ToString());
+    }
 }

src/ETTerms/Terminal/TerminalView.cs

@@ -1,7 +1,9 @@
 using System.Drawing;
 using System.Runtime.InteropServices;
 using System.Text;
+using System.Text.RegularExpressions;
 using System.Windows.Forms;
+using ETTerms.Infrastructure;
 
 namespace ETTerms.Terminal;
 
@@ -17,6 +19,13 @@ public sealed class TerminalView : UserControl
     private readonly ScreenBuffer _buf;
     private readonly AnsiParser _parser;
     private readonly Font _font;
+    // 繪製熱路徑的快取：Font 建立是貴的 GDI 操作，預先做好 4 種變體；
+    // SolidBrush 的 Color 可改，用單一 brush 重複填色，避免每段 run 都 new/dispose。
+    private readonly Font _fontBold, _fontUnderline, _fontBoldUnderline;
+    private readonly SolidBrush _fill = new(Color.Black);
+    private readonly StringBuilder _runSb = new();
+    private readonly DarkScrollBar _vscroll;     // 右側深色垂直捲軸（可拖曳捲動 scrollback）
+    private bool _suppressScroll;                // 程式設定捲軸值時抑制回呼
     private int _cellW, _cellH;
     private int _scrollOffset;                  // 0 = 貼底；>0 = 往上看 scrollback
     private int _lastCols = -1, _lastRows = -1;
@@ -26,6 +35,31 @@ public sealed class TerminalView : UserControl
     private (int row, int col) _selStart, _selEnd;
     private bool _hasSel;
 
+    // ── 搜尋（Ctrl+F）──
+    private Panel? _searchPanel;
+    private TextBox _searchBox = null!;
+    private Label _searchCount = null!;
+    private readonly List<(long line, int col, int len)> _matches = new();   // line = DroppedLines + abs
+    private int _matchIdx = -1;
+
+    // ── 高亮標記（搜尋命中 + 關鍵字），每次 OnPaint 對可見行重建 ──
+    private enum MarkKind { Keyword, Search, SearchCurrent }
+    private readonly Dictionary<int, List<(int col, int len, MarkKind kind)>> _rowMarks = new();
+    private readonly StringBuilder _lineSb = new();
+    private readonly List<int> _lineColMap = new();
+
+    // ── 關鍵字警示（Feed 偵測，分頁標紅點用）──
+    private static readonly Regex AnsiStrip = new(
+        @"\x1B\][^\x07\x1B]*(\x07|\x1B\\)|\x1B[@-Z\\-_]|\x1B\[[0-?]*[ -/]*[@-~]",
+        RegexOptions.Compiled);
+    private readonly Decoder _alertDec = Encoding.UTF8.GetDecoder();
+    private string _alertCarry = "";
+    private readonly Dictionary<string, long> _alertLastFired = new(StringComparer.OrdinalIgnoreCase);
+    private const int AlertCooldownMs = 2000;
+
+    /// <summary>啟用的關鍵字在輸出中出現（UI thread 觸發），供分頁標警示。</summary>
+    public event Action<string>? KeywordAlert;
+
     public TerminalView(TerminalProfile profile)
     {
         SetStyle(ControlStyles.AllPaintingInWmPaint | ControlStyles.UserPaint
@@ -33,6 +67,9 @@ public sealed class TerminalView : UserControl
         BackColor = Color.FromArgb(18, 18, 22);
         ImeMode = ImeMode.NoControl;   // 容器控制項預設關 IME，這裡明確開啟讓使用者可切中文
         _font = new Font(profile.FontFamily, profile.FontSize);
+        _fontBold = new Font(_font, FontStyle.Bold);
+        _fontUnderline = new Font(_font, FontStyle.Underline);
+        _fontBoldUnderline = new Font(_font, FontStyle.Bold | FontStyle.Underline);
         using (var g = CreateGraphics())
         {
             var sz = TextRenderer.MeasureText(g, "W", _font, Size.Empty, TextFormatFlags.NoPadding);
@@ -42,28 +79,51 @@ public sealed class TerminalView : UserControl
         _buf = new ScreenBuffer(profile.Cols, profile.Rows,
             Color.FromArgb(220, 220, 220), BackColor, profile.ScrollbackLines);
         _parser = new AnsiParser(_buf);
+        _parser.Response += bytes => SendData?.Invoke(bytes);   // DSR/DA 查詢回覆（如 ESC[6n 游標位置）
+
+        // 右側深色垂直捲軸：拖曳即捲動 scrollback。內容寬度會扣掉捲軸寬，故文字不會被蓋住。
+        _vscroll = new DarkScrollBar { Dock = DockStyle.Right, SmallChange = 1, Minimum = 0, Maximum = 0 };
+        _vscroll.Scroll += OnVScroll;
+        Controls.Add(_vscroll);
     }
 
     /// <summary>餵入遠端資料（須在 UI thread 呼叫）。</summary>
     public void Feed(byte[] data)
     {
+        DetectKeywords(data);
+        int before = _buf.ScrollbackCount;
         _parser.Feed(data);
-        _scrollOffset = 0;          // 新輸出貼底
+        // 已貼底才跟隨新輸出；使用者往回看歷史時，補償 scrollback 增量讓畫面停在原處，
+        // 不會每來一筆輸出就被拉回底部。
+        if (_scrollOffset > 0)
+            _scrollOffset = Math.Min(_scrollOffset + (_buf.ScrollbackCount - before), _buf.ScrollbackCount);
+        UpdateScrollBar();
         Invalidate();
     }
 
+    private int ContentWidth => Math.Max(_cellW, ClientSize.Width - (_vscroll?.Width ?? 0));
     private int VisibleRows => Math.Max(1, ClientSize.Height / _cellH);
-    private int VisibleCols => Math.Max(1, ClientSize.Width / _cellW);
+    private int VisibleCols => Math.Max(1, ContentWidth / _cellW);
 
     // ── resize → 通知 PTY ────────────────────────────────────
     protected override void OnSizeChanged(EventArgs e)
     {
         base.OnSizeChanged(e);
+
+        // 視窗最小化、或分頁/分割切換的瞬間，ClientSize 會變成 0/極小。此時若把退化尺寸
+        // （會被算成 1×1）送給 PTY，ConPTY 下的全螢幕 TUI（如 Kiro CLI）會誤以為終端機只剩
+        // 1×1 而停止重繪、輸入也像「卡住」。直接忽略這種尺寸，還原後再以正常尺寸重繪即可。
+        if (ClientSize.Width < _cellW || ClientSize.Height < _cellH) return;
+        if (FindForm() is { WindowState: FormWindowState.Minimized }) return;
+
+        PositionSearchPanel();
+
         int cols = VisibleCols, rows = VisibleRows;
         if (cols == _lastCols && rows == _lastRows) return;
         _lastCols = cols; _lastRows = rows;
         _buf.Resize(cols, rows);
         Resized?.Invoke(cols, rows);
+        UpdateScrollBar();
         Invalidate();
     }
 
@@ -76,6 +136,8 @@ public sealed class TerminalView : UserControl
         int top = _buf.ScrollbackCount - _scrollOffset;   // 視窗第一列的絕對 index
         if (top < 0) top = 0;
 
+        CollectMarks(top, rows);
+
         for (int vr = 0; vr < rows; vr++)
         {
             int abs = top + vr;
@@ -99,36 +161,48 @@ public sealed class TerminalView : UserControl
             if ((cell.Attr & CellAttr.Wide) != 0)
             {
                 var wr = new Rectangle(c * _cellW, y, _cellW * 2, _cellH);
-                using (var bb = new SolidBrush(bg)) g.FillRectangle(bb, wr);
+                FillRect(g, wr, bg);
                 DrawRun(g, cell.Ch == '\0' ? " " : cell.Ch.ToString(), cell.Attr, wr, fg);
                 c++;
                 continue;
             }
 
-            // 合併同屬性連續的窄字
+            // 合併同色同字型的連續窄字（每個 cell 的顏色只解析一次）
+            const CellAttr FontAttrs = CellAttr.Bold | CellAttr.Underline;
             int start = c;
-            var sb = new StringBuilder();
+            _runSb.Clear();
+            _runSb.Append(cell.Ch == '\0' ? ' ' : cell.Ch);
+            c++;
             while (c < line.Length)
             {
                 var cur = line[c];
                 if ((cur.Attr & (CellAttr.Wide | CellAttr.WideTrail)) != 0) break;
                 ResolveColors(cur, out var f2, out var b2, abs, c);
-                if (f2 != fg || b2 != bg || (cur.Attr & CellAttr.Bold) != (cell.Attr & CellAttr.Bold)) break;
+                if (f2 != fg || b2 != bg || (cur.Attr & FontAttrs) != (cell.Attr & FontAttrs)) break;
-                sb.Append(cur.Ch == '\0' ? ' ' : cur.Ch);
+                _runSb.Append(cur.Ch == '\0' ? ' ' : cur.Ch);
                 c++;
             }
             var rect = new Rectangle(start * _cellW, y, (c - start) * _cellW, _cellH);
-            using (var bb = new SolidBrush(bg)) g.FillRectangle(bb, rect);
+            FillRect(g, rect, bg);
-            DrawRun(g, sb.ToString(), cell.Attr, rect, fg);
+            DrawRun(g, _runSb.ToString(), cell.Attr, rect, fg);
         }
     }
 
+    private void FillRect(Graphics g, Rectangle rect, Color bg)
+    {
+        _fill.Color = bg;
+        g.FillRectangle(_fill, rect);
+    }
+
+    private Font FontFor(CellAttr attr)
+    {
+        bool bold = (attr & CellAttr.Bold) != 0, ul = (attr & CellAttr.Underline) != 0;
+        return bold ? (ul ? _fontBoldUnderline : _fontBold) : (ul ? _fontUnderline : _font);
+    }
+
     private void DrawRun(Graphics g, string text, CellAttr attr, Rectangle rect, Color fg)
     {
-        var style = (attr & CellAttr.Bold) != 0 ? FontStyle.Bold : FontStyle.Regular;
+        TextRenderer.DrawText(g, text, FontFor(attr), rect, fg,
-        if ((attr & CellAttr.Underline) != 0) style |= FontStyle.Underline;
-        using var fnt = style == FontStyle.Regular ? _font : new Font(_font, style);
-        TextRenderer.DrawText(g, text, fnt, rect, fg,
             TextFormatFlags.NoPadding | TextFormatFlags.NoPrefix | TextFormatFlags.Left);
     }
 
@@ -137,6 +211,27 @@ public sealed class TerminalView : UserControl
         fg = cell.Fg.A == 0 ? _buf.DefaultFg : cell.Fg;
         bg = cell.Bg.A == 0 ? _buf.DefaultBg : cell.Bg;
         if ((cell.Attr & CellAttr.Inverse) != 0) (fg, bg) = (bg, fg);
+
+        // 標記優先序：目前搜尋命中 > 其他搜尋命中 > 關鍵字（選取反白最後蓋上）
+        if (_rowMarks.TryGetValue(abs, out var marks))
+        {
+            var best = MarkKind.Keyword; bool hit = false;
+            foreach (var (c0, len, kind) in marks)
+            {
+                if (col < c0 || col >= c0 + len) continue;
+                if (!hit || kind > best) { best = kind; hit = true; }
+            }
+            if (hit)
+            {
+                switch (best)
+                {
+                    case MarkKind.SearchCurrent: bg = Color.FromArgb(215, 160, 40); fg = Color.Black; break;
+                    case MarkKind.Search: bg = Color.FromArgb(120, 100, 25); break;
+                    case MarkKind.Keyword: bg = Color.FromArgb(150, 45, 45); break;
+                }
+            }
+        }
+
         if (_hasSel && InSelection(abs, col)) (fg, bg) = (bg, Color.FromArgb(70, 90, 140));
     }
 
@@ -157,6 +252,9 @@ public sealed class TerminalView : UserControl
     {
         if (e.Control && e.KeyCode == Keys.C && _hasSel) { CopySelection(); e.Handled = e.SuppressKeyPress = true; return; }
         if ((e.Control && e.KeyCode == Keys.V) || (e.Shift && e.KeyCode == Keys.Insert)) { Paste(); e.Handled = e.SuppressKeyPress = true; return; }
+        if (e.Control && e.KeyCode == Keys.F) { OpenSearch(); e.Handled = e.SuppressKeyPress = true; return; }
+        if (e.KeyCode == Keys.F3 && _searchPanel is { Visible: true }) { StepMatch(e.Shift ? +1 : -1); e.Handled = e.SuppressKeyPress = true; return; }
+        if (e.KeyCode == Keys.Escape && _searchPanel is { Visible: true }) { CloseSearch(); e.Handled = e.SuppressKeyPress = true; return; }
 
         var bytes = TerminalInput.Map(e, _parser.AppCursorKeys);
         if (bytes != null) { SendData?.Invoke(bytes); e.Handled = e.SuppressKeyPress = true; }
@@ -165,10 +263,7 @@ public sealed class TerminalView : UserControl
 
     protected override void OnKeyPress(KeyPressEventArgs e)
     {
-        if (!char.IsControl(e.KeyChar) || e.KeyChar is '\r' or '\t' or '\b' or '\x1b')
+        // \r,\t,\b,\x1b 已由 OnKeyDown 送出，這裡只送一般可列印字元與 Ctrl 組合碼
-        {
-            // \r,\t,\b,\x1b 已由 OnKeyDown 送出，這裡只送一般可列印字元與 Ctrl 組合碼
-        }
         if (e.KeyChar >= ' ' && e.KeyChar != '\x7f')
             SendData?.Invoke(Encoding.UTF8.GetBytes(e.KeyChar.ToString()));
         else if (char.IsControl(e.KeyChar) && e.KeyChar is not ('\r' or '\t' or '\b' or '\x1b'))
@@ -179,11 +274,57 @@ public sealed class TerminalView : UserControl
     // ── 滑鼠：scrollback / 選取 / 貼上 ───────────────────────
     protected override void OnMouseWheel(MouseEventArgs e)
     {
-        int delta = e.Delta / 120 * 3;
+        int notches = e.Delta / 120;
-        _scrollOffset = Math.Clamp(_scrollOffset + delta, 0, _buf.ScrollbackCount);
+        // alt screen（vim / htop 等全螢幕 TUI）沒有 scrollback：慣例是把滾輪轉成
+        // 上下方向鍵送給對方，讓應用程式自己捲動。
+        if (_buf.AltActive)
+        {
+            var seq = TerminalInput.WheelArrows(notches, _parser.AppCursorKeys);
+            if (seq != null) SendData?.Invoke(seq);
+            return;
+        }
+        _scrollOffset = Math.Clamp(_scrollOffset + notches * 3, 0, _buf.ScrollbackCount);
+        UpdateScrollBar();
         Invalidate();
     }
 
+    // ── 垂直捲軸 ─────────────────────────────────────────────
+    private void OnVScroll(object? sender, EventArgs e)
+    {
+        if (_suppressScroll) return;
+        // 捲軸值 = 視窗第一列的絕對 index；_scrollOffset = 距底部的列數。
+        _scrollOffset = Math.Clamp(_buf.ScrollbackCount - _vscroll.Value, 0, _buf.ScrollbackCount);
+        Invalidate();
+    }
+
+    /// <summary>依目前 scrollback / 捲動位置同步捲軸的範圍與滑塊位置。</summary>
+    private void UpdateScrollBar()
+    {
+        if (_vscroll is null) return;
+        _suppressScroll = true;
+        try
+        {
+            int visible = VisibleRows;
+            int total = _buf.TotalRows;
+            if (_buf.ScrollbackCount <= 0)
+            {
+                _vscroll.Enabled = false;
+                _vscroll.LargeChange = 1;
+                _vscroll.Maximum = 0;
+                _vscroll.Value = 0;
+                return;
+            }
+            _vscroll.Enabled = true;
+            // 先設 LargeChange/Maximum 再設 Value，避免 Value 超出可達範圍被夾掉。
+            _vscroll.LargeChange = Math.Max(1, visible);
+            _vscroll.Maximum = Math.Max(0, total - 1);
+            int top = _buf.ScrollbackCount - _scrollOffset;          // 視窗第一列絕對 index
+            int maxValue = Math.Max(0, _vscroll.Maximum - _vscroll.LargeChange + 1);
+            _vscroll.Value = Math.Clamp(top, 0, maxValue);
+        }
+        finally { _suppressScroll = false; }
+    }
+
     protected override void OnMouseDown(MouseEventArgs e)
     {
         Focus();
@@ -195,7 +336,8 @@ public sealed class TerminalView : UserControl
         }
         else if (e.Button == MouseButtons.Right)
         {
-            if (_hasSel) CopySelection(); else Paste();
+            if (_hasSel) { CopySelection(); _hasSel = false; Invalidate(); }   // 複製後清掉反白，讓 user 知道已動作
+            else Paste();
         }
     }
 
@@ -257,12 +399,258 @@ public sealed class TerminalView : UserControl
     {
         try
         {
-            if (Clipboard.ContainsText())
+            if (!Clipboard.ContainsText()) return;
-                SendData?.Invoke(Encoding.UTF8.GetBytes(Clipboard.GetText().Replace("\r\n", "\r")));
+            // 換行統一成 CR：剪貼簿多為 \r\n，也處理單獨的 \n。
+            var text = Clipboard.GetText().Replace("\r\n", "\r").Replace('\n', '\r');
+
+            // 應用程式啟用 bracketed paste（PSReadLine / Kiro CLI 等）時，以 ESC[200~ … ESC[201~
+            // 包夾整段貼上內容，讓對方視為「單次貼上」而非逐行 Enter 立即送出；
+            // 未啟用時才退回原本逐字送出（一般 shell 的預期行為）。
+            var data = _parser.BracketedPaste
+                ? Encoding.UTF8.GetBytes("\x1b[200~" + text + "\x1b[201~")
+                : Encoding.UTF8.GetBytes(text);
+            SendData?.Invoke(data);
         }
         catch { }
     }
 
+    // ── 搜尋（Ctrl+F）─────────────────────────────────────────
+    private void OpenSearch()
+    {
+        EnsureSearchUi();
+        _searchPanel!.Visible = true;
+        PositionSearchPanel();
+        _searchBox.SelectAll();
+        _searchBox.Focus();
+        if (_searchBox.Text.Length > 0) RunSearch();
+    }
+
+    private void CloseSearch()
+    {
+        if (_searchPanel == null) return;
+        _searchPanel.Visible = false;
+        _matches.Clear();
+        _matchIdx = -1;
+        Focus();
+        Invalidate();
+    }
+
+    private void EnsureSearchUi()
+    {
+        if (_searchPanel != null) return;
+
+        var back = Color.FromArgb(32, 32, 38);
+        _searchPanel = new Panel { Size = new Size(268, 30), BackColor = back, Visible = false };
+        _searchPanel.Paint += (_, pe) =>
+        {
+            using var pen = new Pen(Color.FromArgb(58, 58, 66));
+            pe.Graphics.DrawRectangle(pen, 0, 0, _searchPanel.Width - 1, _searchPanel.Height - 1);
+        };
+
+        _searchBox = new TextBox
+        {
+            Bounds = new Rectangle(6, 5, 130, 20), BorderStyle = BorderStyle.None,
+            BackColor = back, ForeColor = Color.FromArgb(222, 222, 226), Font = new Font("Segoe UI", 9.5f)
+        };
+        _searchBox.TextChanged += (_, _) => RunSearch();
+        _searchBox.KeyDown += (_, e) =>
+        {
+            if (e.KeyCode == Keys.Enter || e.KeyCode == Keys.F3)
+            { StepMatch(e.Shift ? +1 : -1); e.Handled = e.SuppressKeyPress = true; }   // Enter 往上找（較舊），Shift 往下
+            else if (e.KeyCode == Keys.Escape)
+            { CloseSearch(); e.Handled = e.SuppressKeyPress = true; }
+        };
+
+        _searchCount = new Label
+        {
+            Bounds = new Rectangle(138, 7, 56, 16), Text = "",
+            ForeColor = Color.FromArgb(150, 150, 158), BackColor = back,
+            Font = new Font("Segoe UI", 8.5f), TextAlign = ContentAlignment.MiddleRight
+        };
+
+        Button MakeBtn(string text, int x, Action onClick)
+        {
+            var b = new Button
+            {
+                Bounds = new Rectangle(x, 4, 22, 22), Text = text, FlatStyle = FlatStyle.Flat,
+                ForeColor = Color.FromArgb(180, 180, 188), BackColor = back,
+                Font = new Font("Segoe UI", 8.5f), TabStop = false, Cursor = Cursors.Hand
+            };
+            b.FlatAppearance.BorderSize = 0;
+            b.FlatAppearance.MouseOverBackColor = Color.FromArgb(60, 60, 70);
+            b.Click += (_, _) => { onClick(); _searchBox.Focus(); };
+            return b;
+        }
+        var up = MakeBtn("▲", 196, () => StepMatch(-1));     // 往上（較舊）
+        var down = MakeBtn("▼", 218, () => StepMatch(+1));   // 往下（較新）
+        var close = MakeBtn("✕", 240, CloseSearch);
+
+        _searchPanel.Controls.AddRange(new Control[] { _searchBox, _searchCount, up, down, close });
+        Controls.Add(_searchPanel);
+        _searchPanel.BringToFront();
+    }
+
+    private void PositionSearchPanel()
+    {
+        if (_searchPanel == null) return;
+        _searchPanel.Location = new Point(Math.Max(0, ContentWidth - _searchPanel.Width - 8), 6);
+    }
+
+    /// <summary>重掃整個 buffer（scrollback + 畫面）建立命中清單，並跳到最靠近底部的命中。</summary>
+    private void RunSearch()
+    {
+        _matches.Clear();
+        _matchIdx = -1;
+        string q = _searchBox.Text;
+        if (q.Length > 0)
+        {
+            long dropped = _buf.DroppedLines;
+            for (int abs = 0; abs < _buf.TotalRows; abs++)
+            {
+                BuildLineText(_buf.LineAt(abs), _lineSb, _lineColMap);
+                string s = _lineSb.ToString();
+                int at = 0;
+                while (s.Length >= q.Length && (at = s.IndexOf(q, at, StringComparison.OrdinalIgnoreCase)) >= 0)
+                {
+                    int colStart = _lineColMap[at];
+                    int colEnd = at + q.Length < _lineColMap.Count
+                        ? _lineColMap[at + q.Length]
+                        : _buf.LineAt(abs).Length;
+                    _matches.Add((dropped + abs, colStart, Math.Max(1, colEnd - colStart)));
+                    at++;
+                }
+            }
+            if (_matches.Count > 0) { _matchIdx = _matches.Count - 1; ScrollToMatch(); }
+        }
+        UpdateSearchCount();
+        Invalidate();
+    }
+
+    /// <summary>dir = -1 往上（較舊）、+1 往下（較新），循環。</summary>
+    private void StepMatch(int dir)
+    {
+        if (_matches.Count == 0) { RunSearch(); if (_matches.Count == 0) return; }
+        else
+        {
+            _matchIdx = (_matchIdx + dir + _matches.Count) % _matches.Count;
+            ScrollToMatch();
+        }
+        UpdateSearchCount();
+        Invalidate();
+    }
+
+    private void ScrollToMatch()
+    {
+        if (_matchIdx < 0 || _matchIdx >= _matches.Count) return;
+        int abs = (int)(_matches[_matchIdx].line - _buf.DroppedLines);
+        if (abs < 0) return;   // 該行已被 scrollback 丟棄
+        int top = Math.Max(0, abs - VisibleRows / 2);
+        _scrollOffset = Math.Clamp(_buf.ScrollbackCount - top, 0, _buf.ScrollbackCount);
+        UpdateScrollBar();
+    }
+
+    private void UpdateSearchCount() =>
+        _searchCount.Text = _matches.Count == 0
+            ? (_searchBox.Text.Length > 0 ? "0" : "")
+            : $"{_matchIdx + 1}/{_matches.Count}";
+
+    // ── 高亮標記收集（每次重繪對可見行執行）──────────────────
+    private void CollectMarks(int top, int rows)
+    {
+        _rowMarks.Clear();
+
+        // 關鍵字（Settings → Highlight）：只掃可見行，成本固定
+        var settings = AppSettings.Instance;
+        bool kwOn = settings.KeywordHighlightEnabled && settings.KeywordRules.Count > 0;
+
+        if (kwOn)
+        {
+            for (int vr = 0; vr < rows; vr++)
+            {
+                int abs = top + vr;
+                if (abs >= _buf.TotalRows) break;
+                BuildLineText(_buf.LineAt(abs), _lineSb, _lineColMap);
+                string s = _lineSb.ToString();
+                foreach (var rule in settings.KeywordRules)
+                {
+                    if (!rule.Enabled || rule.Text.Length == 0) continue;
+                    int at = 0;
+                    while (s.Length >= rule.Text.Length &&
+                           (at = s.IndexOf(rule.Text, at, StringComparison.OrdinalIgnoreCase)) >= 0)
+                    {
+                        int colStart = _lineColMap[at];
+                        int colEnd = at + rule.Text.Length < _lineColMap.Count
+                            ? _lineColMap[at + rule.Text.Length]
+                            : _buf.LineAt(abs).Length;
+                        AddMark(abs, colStart, Math.Max(1, colEnd - colStart), MarkKind.Keyword);
+                        at++;
+                    }
+                }
+            }
+        }
+
+        // 搜尋命中（RunSearch 已算好，換算回目前 abs）
+        if (_matches.Count > 0)
+        {
+            long dropped = _buf.DroppedLines;
+            for (int i = 0; i < _matches.Count; i++)
+            {
+                int abs = (int)(_matches[i].line - dropped);
+                if (abs < top || abs >= top + rows) continue;
+                AddMark(abs, _matches[i].col, _matches[i].len,
+                    i == _matchIdx ? MarkKind.SearchCurrent : MarkKind.Search);
+            }
+        }
+    }
+
+    private void AddMark(int abs, int col, int len, MarkKind kind)
+    {
+        if (!_rowMarks.TryGetValue(abs, out var list)) _rowMarks[abs] = list = new();
+        list.Add((col, len, kind));
+    }
+
+    /// <summary>把一行 cell 轉成緊湊字串（略過 WideTrail），並記錄字元 index → 欄位 col 的對應。</summary>
+    private static void BuildLineText(Cell[] line, StringBuilder sb, List<int> colMap)
+    {
+        sb.Clear();
+        colMap.Clear();
+        for (int c = 0; c < line.Length; c++)
+        {
+            var cell = line[c];
+            if ((cell.Attr & CellAttr.WideTrail) != 0) continue;
+            sb.Append(cell.Ch == '\0' ? ' ' : cell.Ch);
+            colMap.Add(c);
+        }
+    }
+
+    // ── 關鍵字警示（Feed 路徑偵測，供分頁標紅點）──────────────
+    private void DetectKeywords(byte[] data)
+    {
+        var settings = AppSettings.Instance;
+        if (!settings.KeywordHighlightEnabled || settings.KeywordRules.Count == 0 || KeywordAlert == null)
+        { _alertCarry = ""; return; }
+
+        var chars = new char[data.Length];
+        int n = _alertDec.GetChars(data, 0, data.Length, chars, 0);
+        if (n == 0) return;
+
+        string text = _alertCarry + AnsiStrip.Replace(new string(chars, 0, n), "");
+        int maxKw = 1;
+        foreach (var rule in settings.KeywordRules)
+        {
+            if (!rule.Enabled || rule.Text.Length == 0) continue;
+            maxKw = Math.Max(maxKw, rule.Text.Length);
+            if (text.IndexOf(rule.Text, StringComparison.OrdinalIgnoreCase) < 0) continue;
+            long now = Environment.TickCount64;
+            if (_alertLastFired.TryGetValue(rule.Text, out var last) && now - last < AlertCooldownMs) continue;
+            _alertLastFired[rule.Text] = now;
+            KeywordAlert.Invoke(rule.Text);
+        }
+        // 保留尾巴（最長關鍵字 - 1），跨 chunk 的關鍵字下一輪才接得上
+        int keep = maxKw - 1;
+        _alertCarry = text.Length <= keep ? text : text[^keep..];
+    }
+
     // ── IME（中文 / 日文 / 韓文輸入）─────────────────────────
     // 自繪控制項預設不處理 IME 組字，故攔截 WM_IME_COMPOSITION 取「結果字串」直接送出 UTF-8。
     private const int WM_IME_STARTCOMPOSITION = 0x010D;
@@ -332,6 +720,19 @@ public sealed class TerminalView : UserControl
         finally { ImmReleaseContext(Handle, hImc); }
     }
 
+    protected override void Dispose(bool disposing)
+    {
+        if (disposing)
+        {
+            _fill.Dispose();
+            _fontBold.Dispose();
+            _fontUnderline.Dispose();
+            _fontBoldUnderline.Dispose();
+            _font.Dispose();
+        }
+        base.Dispose(disposing);
+    }
+
     [StructLayout(LayoutKind.Sequential)] private struct POINT { public int x, y; }
     [StructLayout(LayoutKind.Sequential)] private struct RECT { public int left, top, right, bottom; }
     [StructLayout(LayoutKind.Sequential)] private struct COMPOSITIONFORM { public int dwStyle; public POINT ptCurrentPos; public RECT rcArea; }

tools/scripts/test-power_cycle_SVOS.ttl

@@ -28,7 +28,7 @@ while 1
     wait "ServiceOS login:"
     sendln "admin"
 
-    wait prompt_SVOS               ; 登入後第一個就緒提示（此處無指令輸出，安全）
+    wait prompt_SVOS
     sendln "version"
     wait prompt_SVOS
     sendln "help"