From 3e9e375d4997e229cd824fb963d9307b454d9559 Mon Sep 17 00:00:00 2001 From: ETWen Date: Thu, 16 Jul 2026 13:46:29 +0800 Subject: [PATCH] docs: add v0.7.2 release notes (and bump version to 0.7.2) Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01MKF7C75bhA4ArQhyMpnsxU --- CLAUDE.md | 2 ++ docs/release-notes/v0.7.2.md | 39 ++++++++++++++++++++++++++++++++++++ src/ETTerms/ETTerms.csproj | 2 +- 3 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 docs/release-notes/v0.7.2.md diff --git a/CLAUDE.md b/CLAUDE.md index aa71b0d..2a849b8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,6 +10,8 @@ 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）、**Phase 10 ✅（v0.6.0）內建 AI Assistant**（見下）。打包待指示。 +**v0.7.2：** **高 DPI（125%/150%）全面修正** —— 字型以點數指定會隨 DPI 放大、寫死像素不會，導致 user 機器（筆電常見 125%/150%）上 SessionPage 的 Log/Script/Stop 被截字、150% 時工具列 AI Chat 被裁、Quick Connect 對話框疊字。**根因**：`MainForm` 的 `AutoScaleMode.Dpi` 只在 Form 初始化當下對「已存在」的控制項縮放一次，本專案 UI 幾乎全是執行期才 new 的（SessionPage 開分頁才建），完全吃不到（實測 125% 下 sidebar 250px 原封不動）。**作法**：(1) `Theme.cs` 加 `Dpi()` 擴充（`px × DeviceDpi/96`，同 `ActivityRail.ItemSize` 的既有做法），全 app ~70 處裸像素尺寸（sidebar/工具列/tab 列/Settings 輸入框/表格/Ctrl+F 搜尋列/DarkScrollBar 寬）全部包上；(2) 會換字的按鈕（⏺ Log↔Logging、⏺ Log All↔Logging All）改 `TextRenderer.MeasureText` 量最長字串取寬（`SessionPage.BarButtonWidth`）／AutoSize；(3) 多行說明 Label 改 `AutoSize = true` 不再固定框；(4) 絕對座標對話框（`Dialogs/`）在 `DarkDialog` 基底加 `ApplyDpiScale()`（建構子最後 `Control.Scale(DeviceDpi/96f)` 一次縮放全樹）；(5) `MainForm` 改 `AutoScaleMode.None` + `ClientSize/MinimumSize` 手動 `Dpi()`（明確自己管，避免未來 .NET 行為改變造成雙重縮放）。⚠️ **新增 UI 的鐵則：任何寫死像素尺寸都要 `this.Dpi(n)`，100% 看起來正常不代表對（`Dpi()` 在 96 DPI 是恆等）**。已知限制：執行中改系統縮放需重啟。通用規範已沉淀到 `create-architecture` skill 的「WinApp DPI Scaling Pattern」。 + **v0.7.1：** 新增 TTL 指令 **`sendlnretry '文字' '確認關鍵字' [最多送出次數]`**（`TTLInterpreter.SendLnRetry` + `WaitConfirm`）——送出後等確認關鍵字，沒等到就**重送**；次數省略 = 無限重送，命中 `result=1`、用完次數 `result=0` 且**繼續執行**（不中止腳本）。**動機**：裝置開機、console 剛被 shell 接手的瞬間會丟棄輸入（tty 重開 / termios flush），`sendln` 送出的整行無聲消失（裝置不回顯、不執行），後面的 `wait` 就永遠卡住；這是機率性的，`pause` 只能調機率、無法根治（實測 45 輪 power-cycle 中 3 輪中招，且**中招時間點與成功時完全重疊**）。**為何需要新指令而非用 `wait` 重試**：單字串 `wait` 逾時是 throw 中止腳本（刻意設計，見下方「注意事項」），TeraTerm 的 `wait`→`if result = 0 then goto retry` 重送寫法在 ETTerms 寫不出來。**語意**：每次送出前清空 `_recv`（確保比對到的是這次送出的回應）；命中只消費到**第一次**出現處，後續輸出留給接下來的 `wait`；刻意**不套 `SettleAndConsume` 的 settle**（關鍵字出現本身就證明裝置收到了）；每次等待逾時 `timeout`/`mtimeout` 有設就用設定值、**沒設預設 3 秒**（此處 0=無限等於永不重送，故不沿用 `wait` 的 0=無限）。⚠️ 確認關鍵字要挑「命令真的有跑」的輸出，**不要挑指令回顯**——tty echo 由核心產生，不保證命令被 shell 讀走。文件：[docs/ttl-script-reference.md](docs/ttl-script-reference.md#送出並確認sendlnretry)。 **v0.7.0：** **AI Chat 改用 WebView2 渲染**（真氣泡 + Markdown + thinking 動畫泡）。訊息區從 RichTextBox 換成 `WebView2`：user 右泡 / AI 左泡、AI 回覆走 **Markdig** markdown→HTML（程式碼區塊/表格/清單）、送出後顯示會動的 thinking「…」泡（`AgentHost.Status "thinking"` → `showThinking()`，收到 `AssistantText` 時 `hideThinking()` 再加 AI 泡）。HTML 模板全內嵌於 `Ai/ChatHtml.cs`（`NavigateToString`,無外部依賴）,C# 經 `ExecuteScriptAsync` 呼叫 JS 函式;WebView2 async 初始化,就緒前的呼叫先入 `_pending` 佇列、`NavigationCompleted` 後 flush。使用者資料夾 `%LocalAppData%\ETTerms\WebView2`（避開 Program Files 唯讀）。底部控制列（輸入框/模型下拉/Send）仍 WinForms。新增 NuGet `Microsoft.Web.WebView2` + `Markdig`;依賴 WebView2 Runtime（Win11 內建,缺時 hint 顯示錯誤）。⚠️ **publish 要確認 WebView2 native（`runtimes/win-x64/native/WebView2Loader.dll`）有進產物**。**工具呼叫上限可設定**（`AppSettings.AiMaxToolRounds`,Settings → AI Assistant,`AgentHost` 建構子傳入）：**0 = 無上限**（自動化長跑;每輪燒 token,聊天視窗 Send 鈕在執行中變 **Stop**,經 `CancellationToken` 中止）,預設 30。 diff --git a/docs/release-notes/v0.7.2.md b/docs/release-notes/v0.7.2.md new file mode 100644 index 0000000..a170677 --- /dev/null +++ b/docs/release-notes/v0.7.2.md @@ -0,0 +1,39 @@ +# v0.7.2 — The whole UI now scales correctly at 125% / 150% display scaling + +## 🐛 Bug fixes + +**Buttons and panels no longer get clipped at Windows display scaling above 100%** +* Fixed: on machines set to 125% or 150% scaling (most laptops), text grew with the scale but + many controls didn't — the **Log / Script / Stop** buttons on each session tab were truncated + or hidden, the **✨ AI Chat** toolbar button lost its bottom edge at 150%, and dialogs like + **Quick Connect** could clip or overlap their fields. +* Every fixed pixel size in the app now converts to your actual display scale, the same way + text always did: the sidebar, toolbars, tab strips, all Settings inputs and tables, the PDU + status grid, the AI chat pane, dialogs, the Ctrl+F search bar — even the scrollbar width. +* Buttons that change their text (like **⏺ Log → ⏺ Logging**) now size themselves from the + actual rendered text width, so they can never truncate again at any scale. +* At 100% scaling nothing changes — the conversion is exact there, so existing setups look + identical to before. + +**Known limitation** +* If you change the Windows display scaling while ETTerms is running, restart the app to + re-layout at the new scale. + +## 📦 Downloads + +Two builds are produced: + +| Build | Needs .NET 8 Desktop Runtime? | Notes | +|-------|-------------------------------|-------| +| **Standard** (`ETTerms_v0.7.2`) | ✅ Yes | Smaller; for machines that already have the runtime | +| **Portable** (`ETTerms_v0.7.2_portable`) | ❌ No | Runtime bundled — unzip and run, no install / admin needed | + +Run `ETTerms v0.7.2.exe`. + +## 🔗 Links +* TTL reference: + [docs/ttl-script-reference.md](https://github.com/ETWen/ETTerms/blob/main/docs/ttl-script-reference.md) +* Architecture: + [ARCHITECTURE.md](https://github.com/ETWen/ETTerms/blob/main/ARCHITECTURE.md) + +**Full changelog:** [v0.7.1...v0.7.2](https://github.com/ETWen/ETTerms/compare/v0.7.1...v0.7.2) diff --git a/src/ETTerms/ETTerms.csproj b/src/ETTerms/ETTerms.csproj index 58f18ca..7365535 100644 --- a/src/ETTerms/ETTerms.csproj +++ b/src/ETTerms/ETTerms.csproj @@ -10,7 +10,7 @@ ETTerms - 0.7.1 + 0.7.2 ETTerms ETTerms Project