Yuzora v0.1.0-beta.1

新增與改善

• 新增實驗性的 Companion（手機遠端控制），預設關閉，需到「設定 → Companion」開啟。已配對的手機可以檢視 HERDR Agent、瀏覽 Spaces，並唯讀查看 Git 的狀態、歷史與 diff；桌面授予操作權限後，手機才能送出輸入。Agent 等待輸入或完成時，手機可收到 Web Push 通知（需先加入主畫面；通知內容不含終端機輸出）。
• Yuzora 內建 Tailscale 節點，這台電腦不必安裝 Tailscale App；手機需要安裝 Tailscale 並登入同一個帳號。使用前要在 tailnet 啟用 HTTPS 憑證，節點名稱與 tailnet 名稱會公開記錄在 Certificate Transparency log。
• 手機以 QR code 配對，兩邊核對確認碼後註冊 passkey，之後每次連線都要通過 passkey。操作權限由桌面逐一授予（15 分鐘、1 小時或 8 小時），手機端還要再用 passkey 確認；可隨時撤銷單一裝置。啟用期限可選 1 小時、8 小時或直到結束 Yuzora。
• 手機的輸入與接管會在桌面顯示通知並記錄到 Logs；HERDR 終端機的輸入寫入現在有時限，對方不再讀取時會中止並提示，不再無限等待。
• 隨附 HERDR 升級到 0.9.5。
• 從系統開啟檔案與資料夾：在 Finder 以「打開方式」選擇 Yuzora、把檔案或資料夾拖到 Dock 圖示、用 open -a Yuzora，或在其他平台以命令列參數啟動，都會直接在 Yuzora 開啟。檔案會開成分頁；資料夾會切換到根目錄相同的本機 Space，沒有的話會建立新的 Space。Yuzora 已在執行時再次開啟也會送到同一個視窗，工作區信任提示與未儲存變更的確認照常出現。Windows 上第二次啟動會交給已在執行的 Yuzora。
• macOS：Yuzora 會出現在文字、圖片與資料夾的「打開方式」清單中；.rs、.go、.jsx、.kt、.vue、.svelte、.scss、.lock、.env 這九種沒有其他 App 認領的副檔名，會以 Yuzora 作為預設開啟程式，其他檔案類型的預設 App 不變。
• 編輯器可以直接預覽 PDF：.pdf 分頁不再顯示二進位提示，改為可捲動的 PDF 檢視器，本機與 SSH 工作區都能用。支援縮放（按鈕、Ctrl／⌘＋滾輪、符合寬度）與跳頁，縮放、窗格大小改變或檔案被外部改寫時會保留目前閱讀位置。
• 切換工作面時保留各自的狀態：HERDR 終端機與 Browser 切走再回來不會重新載入，頁面維持原樣；Markdown 文件／原始碼、PDF、檔案等的捲動位置與縮放，以及編輯器的復原歷史，在切換分頁、Space 或工作區後都會保留。
• macOS 的 ⌘Z／⇧⌘Z 現在會復原與重做編輯器內容（過去連縮排都無法復原）；搜尋框、取代欄位與 Markdown 文件編輯器則維持系統原生的復原。
• HERDR 無法連上某個 Session（例如以系統管理員身分執行的 Windows server）時，會顯示「無法連線」並附上 HERDR 回報的原因，不再誤判成「已停止」，也不再提示用 herdr session attach 啟動；這類 Session 不提供啟動、停止或刪除已儲存版面，以免誤刪仍在執行的 Session。
• 新增可自訂的 ⌘／Ctrl＋Shift＋F 快捷鍵，開啟命令面板搜尋工作區檔案內容；輸入框提示也改成「搜尋檔案內容、執行命令…」。若你已經把這組按鍵綁給其他功能，原本的設定會保留，新的預設則自動空出。
• Browser：在網址列輸入網址但載入失敗時，會顯示「無法載入 …」，不再靜默退回上一頁；輸入本機或 UNC 路徑會說明原因，不再嘗試開成 https:///…；點擊網址列仍會全選，即使焦點剛才在網頁內。
• Git：push、pull、fetch 與背景自動 fetch 後，Git Log 會原地更新已載入的範圍，origin/* 標籤不再過期，選取的 commit、詳情與已載入的頁數也不會被重置。
• 資料庫查詢結果的列號會跨頁連續，並依位數自動加寬。
• Agent 的 Attention 通知改為顯示 Agent 或分頁名稱，不再是 pane ID；以資料夾建立 Space 時，會記住離開的 Space，回去時還原原本的分頁。
• 刪除檔案的確認視窗現在顯示相對路徑，並說明刪除後無法復原。

效能

• 切換回 HERDR 終端機與 Browser 不再重新建立畫面；終端機的滑鼠 hover 狀態只在實際有 hover 時才重繪整個畫面；背景分頁的終端機大量輸出時不再在背景暫存與處理，切回時直接顯示最新畫面。
• 程序資源取樣（狀態列與資源用量）的 CPU 大幅降低，閒置時單次取樣由約 7.5 ms 降到約 0.06 ms。
• 登入 shell 環境變數探測、SQLite 分頁查詢等路徑也一併減少不必要的工作。

修正

• 編輯器與檔案：
  • 關閉分割群組時，若其中有只存在該群組的未儲存內容，會先詢問儲存或捨棄，不再直接遺失。
  • 本機儲存改為先寫入暫存檔再替換，儲存中途失敗不會留下被截斷的原檔。
  • 檔名含反斜線的 POSIX 檔案，刪除、重新命名與複製不再作用到錯誤的檔案；重新命名、刪除、貼上與拖放遇到非同步完成時，不再覆蓋較新的內容或作用到被取代的工作區。
  • 圖片被外部改寫後會重新載入，也可在背景分頁按 ↻；「縮放至適合」不再把大圖放大到超出視窗。
  • 「以外部程式開啟」改走工作區授權，不再一律失敗，失敗時也會顯示原因；程式與指令碼為了安全不會被外部開啟，仍可在檔案管理員中顯示。
  • 外部變更衝突視窗與合併工具不再以過期的讀取結果覆寫較新的內容；macOS 上檔案樹右鍵後的鍵盤複製貼上也能正確作用在選取的項目。
  • 檔案樹中已收合的資料夾，在檔案變動後會重新列出；編輯 .git/info/exclude 後，檔名搜尋會立即套用新的排除規則。
• Git：
  • 取消暫存已暫存的重新命名不再留下半套索引狀態；暫存也不再誤報錯誤。
  • 強制 Push 的 lease 針對你看到的遠端 commit，而不是自動 fetch 後的追蹤分支；不會強推一個分支從未整合過的 commit。
  • 合併工具遇到非 UTF-8、帶 BOM 的 UTF-16 或符號連結衝突時會拒絕處理，不再改寫成 UTF-8 或透過連結寫入；CRLF 檔案的片段套用位置也已修正。
  • 上游分支已刪除時不再被自動改寫追蹤設定或推到錯誤的遠端分支；分支名稱與 heads／remotes 命名空間相同時，Tracked 標籤與遠端選擇不再錯亂；Git 根目錄路徑尾端有空白時，不再作用到相似名稱的另一個 repo。
  • 排隊中的同 repo 寫入不再佔滿全部執行名額而拖慢其他讀取與其他 repo；結束 Yuzora 時不再有 Git 作業在清理後才啟動。
  • 狀態列在非 repo 資料夾或載入中不再顯示 main；合併工具標題列避開 macOS 紅綠燈按鈕。
  • Stash 套用鎖定完整的 commit，在其他 Git 工具同時改動 stash 清單時不會套用到別筆。
• 資料庫：
  • 「執行目前語句」在游標位於結尾註解時，不再誤執行下一句；PostgreSQL 的 dollar-quoted 字串內含分號時不再被錯誤拆開。
  • 交易狀態（開啟中的交易）依連線追蹤，SQLite 與 MSSQL 中斷後正確清除；MSSQL 回傳多個結果集時會報錯，不再與第一個結果集混在一起。
  • 多筆表格編輯具原子性，失敗時不會留下部分更新；SQLite 產生欄位不再被當成可編輯；欄位快取在表格清單重新載入後會更新。
  • 結果排序在混合型別、無限值與含毫秒的時間戳時順序正確；查詢歷史不再被截斷後仍被當成完整 SQL 重播，MSSQL 批次重播不再把後面的語句併進前一段。
  • 取消查詢、結果頁切換與斷線的各種競態已修正，連線中斷時儲存格編輯會顯示結果而不是消失；在儲存格編輯器按 ⌘／Ctrl＋A 只會選取儲存格文字。
• SSH／SFTP：
  • 金鑰需要密碼時，會詢問 passphrase；開啟 SFTP 或中斷連線不再互相卡住；SFTP 底層連線停止後可自動恢復。
  • 多檔上傳時的覆寫確認不再互相取消；下載、重新命名在選好目的地或父資料夾後，不會受之後的導覽影響；下載完成後本機面板會刷新；雙擊資料夾只會進入一層，不再連進下一層子資料夾；本機與遠端的「回上一層」按鈕也有不同的名稱。
  • SSH 連線完成時不再覆蓋你較晚的主機選擇。
• HERDR 與終端機：
  • 結束 Yuzora 或釋放終端機連線時，不會因其他程序持有管線而無限等待（約 1.5 秒內完成）；原生 client 關閉後不會留下殭屍程序。
  • 終端機的連結只會在本機存在對應檔案時才開啟，遠端 pane 輸出的路徑不再被當成本機檔案；滑過 UNC 路徑也不再主動探測網路主機。
  • 事件觸發的快照更新不再被正在進行的更新丟棄，已結束 pane 的 Attention 不會復活；Session 重新連線或伺服器版本改變後會重新協商相容性；HERDR 啟動失敗後可以重試。
  • 新增 Space 時使用建立當下選定的 Session，不再被中途的自動切換改掉；Agent 切換器、最近使用順序與還原後循環不再選到已移除或錯誤的 Agent；快速連點 pane 切回原焦點時不再被忽略。
  • 原生 Session 畫面的輸入在 pane 與外掛尚未就緒時不會被吞掉；中文輸入法標點在原生對話中不再遺失；終端機貼上與複製的順序、重新連線時的貼上目標都已修正。
  • 字型載入前後或螢幕縮放（DPR）改變時，終端機會重新量測與適配；Agent 完成通知不再沿用先前的已讀狀態，延後的通知會遵守最新的通知偏好。
• 搜尋與設定：
  • 檔案內容搜尋在大小寫不同的非 ASCII 字元、單檔超過 500 筆比對、空白範圍的「下一個」與預覽反白上，結果與位置都已修正；搜尋被拒絕時不再卡在載入狀態。
  • 快捷鍵衝突檢查在 macOS 上能區分 Command 與 Control；Browser 分頁快捷鍵與目前工作面一致；窄視窗中兩個左側欄快捷鍵會互斥，不會同時擠壓畫面。
  • 命令面板關閉後焦點會回到原處；「設定」的搜尋框不再跳出自動填入建議；記錄設定以原子方式寫入，寫入失敗不再讓重啟後回到預設值，Logs 的來源選單會包含後來才出現的來源。
• 啟動與安全：
  • 啟動時，若 shell 設定檔啟動的背景程序一直持有輸出管線，Yuzora 不再卡住無法啟動。
  • 未受信任的工作區，檔案監看不再執行該 repo 設定的 Git 指令；授予或撤銷信任會立即生效。
  • Browser 開啟的外部網頁，不再讀得到你已授權工作區中的檔案內容。
  • macOS 上「在檔案管理員顯示」對 .app 等套件改為在上層資料夾中選取，不再啟動它；「設定 → 安全性」的「同步外部變更」與「確認具破壞性的 git 操作」原本切換無效，現在標示為固定開啟。
  • 更新安裝失敗後按「重試」時，若有未儲存的文件會顯示提示，不再沒有反應。

已知限制

• macOS Beta 沒有 Developer ID 發行者身分、notarization 或 Gatekeeper 信任，首次開啟時可能被警告或阻擋；只應從 Yuzora 官方 GitHub Pre-release 下載。
• Companion 為實驗性功能：尚未在真實的 iPhone、Android 與 Windows／Linux 桌面上完成驗收。
• 啟用 Companion 等同授予這台電腦帳號遠端 shell 權限，請只在信任的 tailnet 上、於需要的期間內啟用。
• Companion 只在 Yuzora 執行且已啟用期間運作；節點名稱改變後，已配對的手機必須重新配對。
• 設定與疑難排解見 docs/operations.md。
• 從系統開啟檔案：.ts 與 .mts 不會出現在 macOS 的「打開方式」清單，因為系統把它們視為影片格式（MPEG-2 Transport Stream）；Windows 檔案總管的右鍵選單與 Finder 資料夾的「服務」項目尚未提供。從 Dock 拖放尚未實機驗證，Windows 與 Linux 的開檔整合僅通過編譯。
• PDF 預覽暫不支援選取文字、搜尋、連結與表單；未內嵌的標準字型會改用系統字型；各頁尺寸差異很大時，還原的捲動位置可能在頁面量測完成前稍有偏移。
• Browser 載入失敗提示：新 Browser 工作階段的第一次導覽沒有上一頁可比對，不會偵測失敗；Windows（WebView2）不回報載入狀態，不顯示失敗提示；Linux 會顯示 WebKitGTK 自己的錯誤頁，提示很少出現。
• 強制 Push 需要明確的推送目標與分支的 reflog，缺少時會拒絕而不是退回無保護的強推；原子儲存會讓檔案換成新的 inode，硬連結會被拆開，mode 與 owner 以外的延伸屬性不會帶過去。
• MSSQL 仍以每個 ; 切分批次，DECLARE @x …; SELECT @x; 會遺失變數；同一批次內的 BEGIN … COMMIT 在後續 COMMIT 出錯前，交易旗標會一直保留。
• 即時 HERDR 與 Companion 的 Windows、Linux 行為，以及 macOS 以外的程序管線與持有者相關修正，目前只通過 CI 編譯與單元測試，尚未實機驗證；自己用管理員權限執行 HERDR server 時，Yuzora 只能顯示「無法連線」，不會自動處理。
• 編輯器的「復原到存檔內容」後，未儲存圓點仍會保留；Markdown 文件編輯器的復原歷史不會跨分頁保留。

Yuzora v0.0.19

新增與改善

• 「HERDR 工具」重新設計為「HERDR 動作」：開啟後先問「你想做什麼？」，以任務卡列出開隔離分支（Worktree）、啟動 Agent、傳訊息給 Agent、搬移 Pane、管理 Session 與開啟完整 Session 畫面，每張卡進入單一目的的表單；暫時無法使用的動作會直接寫出原因（例如 Session 尚未連線、HERDR 版本不支援、沒有 Pane 或 Agent）。頂端固定顯示「作用於：主機 › Session」。啟動 Agent 時名稱會自動產生，參數與送出按鍵收進「進階」。所有動作也可從 ⌘K 命令面板執行（輸入「HERDR」），並與側欄選取的 Session 一致；Pane 右鍵會依是否已有 Agent 提供「啟動 Agent」或「傳訊息給 Agent」。通知開關移到「設定 → HERDR」。
• 從 Finder／檔案總管把檔案拖到側邊欄檔案樹，會複製到游標下的資料夾（落在檔案上則複製到該檔案所在的資料夾，落在空白處則複製到工作區根目錄），拖曳時會標示目標資料夾；同名檔案自動改名。本機與 WSL 工作區都支援，WSL 需要同版本的 Yuzora helper。檔案樹空白處也能按 ⌘／Ctrl＋V 把 Finder 複製的檔案貼到根目錄。SSH 工作區暫不支援匯入，拖放到檔案樹時仍在編輯器開啟。
• Claude Code 等 Agent 在 HERDR 終端機以 fullscreen 模式執行時，滑鼠移動也會轉送給程式，hover 效果可正常顯示（需要 HERDR 0.9.3 以上；遠端需搭配同版本的 Yuzora helper）。

效能

• Git：被 .gitignore 忽略的目錄（例如 target/、dist/）在建置時大量寫入，不再觸發 Git 狀態重新整理，Git 狀態也更新得更快；檔案監看佇列加大，建置期間不再因佇列溢出而整個工作區重新掃描。
• HERDR：閒置時的 Session 清單改用 12 秒快取，背景 herdr 子程序由每分鐘約 15 次降到約 5 次；終端機輸出的 frame 處理量約為原本 2 倍；Session 快照處理時間減少約三分之一；某個 Agent 狀態改變時，其他終端機分頁不再跟著重繪；不同 Session 的能力檢查不再互相等待。
• 切換編輯群組時，側邊欄檔案樹不再整棵重新繪製（1,000 個檔案時 CPU 約減少四分之三）。
• 輸入文字時，快捷鍵判斷只在按鍵組合相符後才檢查對話框狀態，畫面元素很多時的輸入 CPU 約減少 90%。
• Browser 預覽含多個 iframe 時，未變動的狀態不再反覆傳送（64 個 iframe 時 CPU 約減少 89%）。
• 閒置時的檔案監看與狀態列資源取樣幾乎不再消耗 CPU；macOS 啟動時讀取登入 shell 環境變數由約 54 ms 縮短到約 11 ms。
• 終端機切換分頁時的輸出佇列、全文搜尋、資料庫大量查詢結果、Git 狀態解析與遠端 helper 連線的 CPU 用量也一併降低；開過大量不支援語法標示的檔案類型後，不再累積快取項目。

修正

• Claude Code 的吉祥物 Clawd 與其他方塊字元（U+2580–U+259F）在 HERDR 終端機中不再破碎或出現縫隙：這些字元改由 Yuzora 依格子大小直接繪製，不再依賴字型。
• HERDR 快照更新進行中又收到新事件時，會在完成後立即補一次更新，不必等到下一個事件或 12 秒後的定期同步。
• 部分對話框（例如「加入 Herdr Session」）的文字不再模糊：對話框改用版面置中，內容高度帶小數時不會再落在半個像素上。

已知限制

• Claude Code 在預設（非 fullscreen）模式下不會開啟滑鼠回報，任何終端機都無法點擊 Clawd；需要在 Claude Code 中執行 /tui fullscreen。
• 在 Yuzora 以外啟動或停止的 HERDR Session，最多約 16 秒後才會反映在側欄；在 Yuzora 內操作則立即更新。
• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。

Yuzora v0.0.18

新增與改善

• 加入遠端 HERDR Session 改用 HERDR 原生的 machines：「加入 Session」新增 Machines 分頁，可從 Yuzora 新增已儲存的 SSH 主機（在內嵌終端執行官方設定流程）、查看狀態、重新命名、停用與移除；遠端 Session 的即時畫面在官方 client 中開啟，側欄 Agents 也會列出各主機上的 Agent 狀態。原本透過 Yuzora SSH 連線加入遠端 HERDR 的方式標示為舊路徑，可一鍵轉成 HERDR machine。需要 HERDR 0.9.2 以上。
• 設定 → HERDR：錯誤改為可讀的說明，並保留可複製的診斷內容；切換本機來源後可立即重新啟動 Yuzora；自訂路徑失效時可一鍵改回隨附版本。
• HERDR 終端機的點擊、拖曳與雙擊會轉送給啟用滑鼠回報的程式（例如 Claude Code、vim 的 mouse=a、lazygit）；一般 shell 仍是本機選取。按住 Shift 可強制本機選取，⌘／Ctrl＋點擊開啟連結。需要 HERDR client 0.9.2 以上；遠端（SSH／WSL）需搭配同版本的 Yuzora helper。
• 側欄 Agents 檢視重新設計：每個 Agent 的標題下方以標籤依序顯示所屬資料夾與 Git 分支（資料夾套用自訂專案名稱，linked worktree 顯示主 repo；非 Git 資料夾只顯示資料夾），取代 v0.0.17 起只顯示分支的小字；Agent 切換器的副標題也一致。
• 智慧簽出現在也能處理被未追蹤檔案擋下的簽出（目標分支追蹤了同一路徑）：只暫存擋路的檔案，切換後把你的版本寫回，在 Git 面板顯示為修改；目標分支已 commit 的版本仍可取回。其他未追蹤檔案與建置產物不受影響。
• Windows 只發行 MSI 安裝檔：下載頁與 README 改為 Yuzora-windows-x64.msi。從 NSIS（.exe）版本更新到本版後，Yuzora 首次啟動會移除 NSIS 留下的解除安裝項目與重複捷徑，「新增或移除程式」只剩一個 Yuzora，設定與資料都會保留。
• 設定 → 外觀新增「背景」：可跟隨主題色、改用自訂漸層（類似 Arc：在色板上拖曳最多 3 個色點並調整強度，提供 8 組內建漸層與最多 12 組自訂色盤，也能從圖片擷取主色生成漸層），或直接以圖片作為背景（可調整圖片強度；圖片縮小後保存在本機，不修改原檔）。預設仍跟隨主題色，既有外觀不變。
• 新增「玻璃視窗」：開啟後模糊的桌面會從視窗背景透出，側欄與中間區域改為半透明，並可調整背景不透明度；編輯器文字與終端機內容維持不透明。macOS 使用系統 under-window 材質；Windows 需 Windows 11 22H2 以上（Acrylic），較舊的 Windows 與 Linux 不顯示此選項。
• 檔案、Browser 與 HERDR 終端機分頁可以拖曳調整順序，檔案與終端機分頁也能拖到另一個編輯群組；資料庫查詢結果的欄位可以拖曳調整順序。
• 從 Finder／檔案總管把檔案拖到 HERDR 終端機時，會貼上加好跳脫的路徑，方便把截圖或檔案交給 Claude Code 等 agent。WSL Session 會轉成 /mnt/… 路徑；遠端 Session 不支援本機檔案，會顯示提示。拖到終端機以外的位置時，仍在編輯器開啟。
• 檔案樹支援拖曳：拖到終端機貼上路徑、拖到編輯群組開啟檔案、拖進資料夾搬移（會先確認；SFTP 工作區不支援搬移）。
• HERDR 終端機分割後，可以拖曳 pane 的標題列互換位置（需要 HERDR 支援 pane.swap）。

修正

• Windows：「已安裝」來源只會選用 herdr.exe，不再誤選同名的指令碼；自訂路徑貼上時帶的引號或前後空白會自動去除，且須為 .exe。
• WSL 開關改由 Yuzora 後端保存並強制，關閉時不會再探索或連線 WSL，已開啟的 WSL 連線也會立即中止。
• Windows 更新安裝時只會停止 Yuzora 隨附的 HERDR；自行安裝的 HERDR 只會在確認視窗中列出，其中的 Session 不會被中止。
• 從 HERDR pane 內啟動 Yuzora（例如在 pane 裡執行 tauri dev 或 open）時，Yuzora 的 HERDR 連線不再誤連到外層 pane 所屬的 server，會使用設定中選定的 Session。
• 關閉 WSL 時，正在連線中的 WSL 主機不會在關閉後完成連線並被加入。
• Machines 分頁中重新命名、啟用／停用或移除失敗時，除了錯誤說明，也可展開「診斷」查看 HERDR 回報的原因。
• Windows 上以 SSH／SFTP 首次連線並接受主機金鑰時，不再以「無法同步 known_hosts 暫存檔」中止連線，主機金鑰會正確保存。
• Windows 上保存主機金鑰時，若防毒或索引程式短暫鎖住剛寫入的暫存檔，會稍候重試，不再偶爾讓連線在驗證前中止。
• 檔案內容搜尋在不分大小寫時，不再漏掉大小寫等價的非 ASCII 字元（例如搜尋 Σ 時的 ς），符合位置的欄位也以原文計算，結果預覽中的反白也與實際符合的文字一致。
• PostgreSQL 連線未指定資料庫時，若 postgres 資料庫不存在、沒有連線權限或不接受連線，會改用與使用者同名的資料庫列出可選資料庫；兩者都無法連線時，錯誤訊息會列出每次嘗試並提示指定資料庫。
• 外部變更衝突視窗開著時，若檔案變成二進位、過大或無法讀取，會改為對應的提示畫面，不再以先前讀到的舊內容提供「採用磁碟版本」或「解決並儲存」；檔案恢復成可比對的文字時會自動回到比對畫面。
• Stash 對話框套用、取回或刪除 stash 時，若清單載入後 stash 編號已被其他 Git 工具改變，會中止操作並重新載入清單，不再作用到別的 stash。
• 淺色主題下，終端機以白色輸出的文字（例如 PowerShell 的參數、路徑與數字）不再幾乎看不見；PowerShell 選取文字的反白也維持可讀。
• Kitty graphics：放置圖片時若未設定 C=1，游標會依規格移到圖片右側，後續文字不再與圖片重疊；HERDR 官方 client 一律帶 C=1，畫面不受影響。
• 編輯區分頁與資料庫結果欄位的拖曳在 macOS 與 Windows 上一直無法放下：Tauri 的檔案拖放層攔下了網頁的 HTML5 拖放，現已全面改用 pointer 事件。
• 終端機貼上的內容若夾帶拆開的 bracketed paste 結束標記，原本移除一次後會重組成新的標記，導致貼上提早結束、後面的文字被當成按鍵送出；現在會重複移除直到不再出現。

已知限制

• 從側欄開啟 machine 上的 Agent 時，官方 client 無法自動選定該主機，需要在官方側欄手動切換；machine 上的 Agent 不顯示分支。
• 在啟用滑鼠回報的程式（例如 lazygit、vim 的 mouse=a）中點擊或拖曳時，HERDR 終端機也會同時顯示本機選取的反白：HERDR 不會告知 Yuzora 程式是否開啟滑鼠回報，無法只在一般 shell 保留本機選取。反白不影響程式收到的操作；需要複製時按住 Shift 選取。
• Windows 不支援 machine 的「重新連線」（HERDR 官方限制），請使用 ssh-agent 管理金鑰。
• 智慧簽出遇到目錄與檔案互相衝突（例如未追蹤檔案的路徑在目標分支是資料夾）時仍無法處理，會把檔案放回原處並顯示原本的錯誤。
• 含控制字元的檔名，以及 Windows 上含 $、反引號、"、%、! 或智慧引號的檔名，無法安全跳脫，所以不會貼到終端機。

安裝說明

• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。
• Windows Authenticode 尚未啟用，安裝或首次開啟時仍可能出現 SmartScreen 提示。
• 固定下載連結 Yuzora-windows-x64-setup.exe 自本版起停止更新（舊版本的資產不變），請改用 Yuzora-windows-x64.msi。

Yuzora v0.0.17

新增與改善

• Git 衝突解決：衝突對話框可對檔案「接受 Yours／接受 Theirs」或開啟三窗格合併工具，逐段套用左右變更、一鍵套用非衝突段落並自動解決簡單衝突；merge／rebase／cherry-pick／revert 可在橫幅繼續、中止或跳過。仍有衝突標記的檔案不會被標記為已解決。
• Git 常用操作：分支右鍵可合併到目前分支、rebase、重新命名與刪除（未合併時另詢問強制刪除）；commit 可 Revert、復原最後一個 commit 或重設到指定 commit（Soft／Mixed／Hard）；新增 Stash 對話框、Pull（rebase）、Push（含 tags）與強制 Push（with lease）。
• 智慧簽出：簽出分支、遠端分支、tag 或 commit 時若會覆寫本機變更，可選擇「智慧簽出」，先暫存變更、切換後自動還原；還原有衝突時開啟衝突對話框，變更保留在 stash。Pull、合併與 rebase 會自動暫存並還原本機變更。
• 多資料夾 Git：開啟本身不是 Git repo 的資料夾時，會遞迴列出子資料夾中的 repo（略過 node_modules 等常見目錄），可在 Git 面板切換。
• 檔案樹支援剪下／複製／貼上／製作副本（右鍵或 ⌘C／⌘X／⌘V／⌘D，Windows／Linux 為 Ctrl），並與 Finder／檔案總管互通：複製的檔案可貼到 Finder／檔案總管，從 Finder／檔案總管複製的檔案與資料夾也可貼進工作區。名稱重複時自動命名為「… copy」。
• 刪除檔案或資料夾超過片刻時，右下角顯示進度與數量；本機刪除可取消。大型資料夾（例如 node_modules）不再刪到一半停止。
• 終端機拖曳選取超出畫面上下緣時會自動捲動，可選取並複製畫面外的內容。
• 終端機以滑鼠滾輪捲動時，右側捲軸更即時地跟上目前位置。
• 隨附 HERDR 由 0.9.1 升級至 0.9.3（private protocol 22 不變），並保留對 0.9.0、0.9.1 server 的混版相容。0.9.2 起的 Kitty 與 escape-key 行為變更仍需實機驗收。
• Markdown 文件模式切換檔案後保留游標、選取與捲動位置；切換到已連線的 Session 不再重新初始化，降低卡頓。
• 設定 → 編輯器新增「Markdown 預設顯示」，可選擇開啟 Markdown 檔案時預設為文件預覽或原始碼；手動切換過的檔案保留各自的選擇。
• Markdown 程式碼區塊新增複製按鈕：在文件模式、分割預覽與唯讀預覽中，滑鼠移到區塊上即可複製純文字。

修正

• macOS 中文輸入法（注音、拼音）在終端機輸入標點時，不再需要按兩次才出現，也不會重複輸入空白。
• Git push 在分支尚無上游時自動設定上游；Pull 遇到分岔時預設合併而非直接失敗（仍尊重已設定的策略）。同時進行的 Git 操作不再因「忙碌」而失敗，讀取不會被寫入操作卡住；錯誤訊息保留 git 的關鍵行。
• Git Log 的「簽出」commit 改為 detached HEAD，不再必定失敗；重新命名或刪除分支後 Log 立即更新分支標籤。
• Windows SSH 主機上的遠端 Git 操作不再在偵測後全部失敗（先前會回報 repository 不符）；Windows SSH 主機的檔名搜尋也不再總是回傳不完整的結果。
• 在 WSL 或 SSH 遠端開啟不是 Git 儲存庫的資料夾時，Git 面板不再顯示 untrustedWorkspace 原始錯誤，會照常列出子儲存庫；尚未信任的儲存庫改為顯示「信任 workspace…」按鈕，信任後自動重新偵測。
• 全螢幕 TUI（例如 Claude Code、Codex）在原生終端中可用滑鼠滾輪捲動。
• 以 Alt+1～9 或側欄切換到位於分割窗格中的 Agent 時，會選取該 Agent 的窗格並可直接輸入，不再固定選取該分頁的第一個窗格。
• Markdown 預覽中過長的程式碼行改為自動換行，不再讓整份文件出現水平捲動。
• 遠端終端同時開啟過多時改為排隊並自動重試，重試耗盡後提供手動重新連線，終端不再永久失效。
• 刪除確認按鈕改為「刪除」，不再顯示「繼續」。
• Windows 安裝更新不再因 HERDR 佔用檔案而失敗：確認視窗會列出目前使用的 HERDR 版本、路徑與執行中程序數，並警告所有 Session 進度將遺失；確認後先終止該 HERDR 程序再安裝。確認視窗改為依內容調整的精簡尺寸。

已知限制

• 智慧簽出只處理會被覆寫的已追蹤檔案；未追蹤檔案擋住簽出時仍顯示 git 原始錯誤。git 2.24–2.26 的合併與 Pull（merge 模式）不支援自動暫存。
• 遠端工作區無法從 Finder／檔案總管匯入檔案；純 SFTP 工作區不支援複製與搬移。SSH／SFTP 刪除不顯示進度、無法取消，單次仍有項目與時間上限。
• 多資料夾 Git 只監看目前選取的 repo。
• 唯讀 Markdown 預覽中超過約 32,000 字元的單一程式碼區塊會分段顯示，不提供複製按鈕。

安裝說明

• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。
• Windows Authenticode 尚未啟用，安裝或首次開啟時仍可能出現 SmartScreen 提示。

Yuzora v0.0.16

新增與改善

• 新增 HERDR 工具：Worktree 建立／開啟／移除、pane 跨分頁與 Space 搬移、Agent 啟動／提示／等待／重新命名／按鍵，以及 Integration 與 Session 生命週期管理；另可查看 Agent 狀態說明與 Plugin 記錄。
• 新增 Plugin 安裝、啟停、action 與 pane 管理；「開啟 Herdr 視窗」以完整官方 Session 畫面承接原生彈窗、歷史搜尋、鍵盤 Copy mode 與 Kitty 圖片，關閉畫面保留執行中的工作。
• Agent 完成或需要輸入時提供 toast，以及選配的系統通知與聲音；抑制歷史狀態、已讀項目與前景 pane 的重複通知。
• 新增 Windows x86_64 SSH host helper、named-pipe 路由、原生路徑與 ConPTY payload；Host artifacts 擴充為五個 target。實際 Windows SSH 與完整 Session 視覺驗收仍需在對應環境完成。
• 重整資料庫工作台：連線後選擇 PostgreSQL／MSSQL 資料庫，分離資料瀏覽與可調整高度的 SQL 工作區；保留 SQLite、PostgreSQL 與 MSSQL 引擎。
• 資料表預覽支援雙擊或鍵盤編輯純量欄位。以完整主鍵和原始欄位值比對後儲存，保留 64-bit 整數／decimal 精度；沒有主鍵的結果、任意 SQL 查詢、binary 與既有 JSON 值維持唯讀。
• 資料表右鍵可開啟結構編輯器，預覽並套用資料表改名、欄位改名與新增允許 NULL 的欄位。
• 資料列採虛擬化顯示，獨立結果 cursor 平行釋放；減少 Agent 清單的重複掃描，連線完成或移除時清除過期狀態。
• 檔案樹單擊以預覽分頁開啟檔案（名稱斜體），下次單擊會取代它；雙擊檔案或分頁、編輯內容或釘選後轉為一般分頁。
• 側邊欄 Space 與分支列的操作按鈕改為滑鼠移入時才出現在列內；點 Space 會開啟上次使用的分支，沒有紀錄時開啟第一個分支。
• 新增快捷鍵：⌘⇧E（Windows／Linux 為 Ctrl+Shift+E）切換 Spaces／Agents 檢視；Alt+1…9 跳到對應 Agent；macOS ⌥Tab／⌥⇧Tab（Windows／Linux 為 Alt+` ／Alt+Shift+` ）依最近使用順序切換 Agent，放開 Alt 確定。可在「設定 → 鍵盤」修改。
• 重新設計「加入 Herdr Session」對話框：左側選擇來源，右側依主機列出 Session，可用方向鍵選擇、Enter 或雙擊載入，並標示目前使用中與已停止的 Session。
• 移除 Agent Inspector；點選 Agent 直接開啟它的終端機。
• Herdr 操作在短時間內重用 Session 清單與連線驗證，減少每次操作額外啟動的程序；Windows 本機連線等待回應的間隔也縮短。

修正

• SSH 密碼驗證支援伺服器的 keyboard-interactive 密碼提示，保留 OTP／換密碼保護與認證逾時。
• 修正新 Git repo 尚無第一筆 commit 時無法取消暫存的問題，保留工作檔與暫存後的修改。
• Git 分支選單的忙碌與操作提示使用中性色，真正錯誤才顯示紅色。
• Git Graph 主旨與 refs 自適應可用空間；作者／日期在窄視窗及多分支水平捲動時保持可見。
• 大型文件搜尋移至可取消的背景 Worker；關閉搜尋、變更文件或卸載編輯器時清除 Worker、計時器與文件快取。
• 搜尋按鈕完整套用目前主題，避免淺色漸層遮住深色模式的按鈕文字。
• 關閉 Space 成功後同步卸載所屬終端頁面，釋放串流及版面重試；取消或關閉失敗時保留頁面。
• Spaces／Agents 保留來源順序，不再因狀態變更而重新排序。
• 修正 macOS 與 Windows 的 Herdr 終端機捲動跟不上、停手後畫面仍繼續捲動的問題；改用與 WSL 相同的捲動方式。
• Windows／Linux 的 Ctrl+K 等 App 快捷鍵在終端機聚焦時也能使用。
• 終端機被其他視窗取得控制後，改為顯示提示與「重新連線」按鈕，不再停在「串流已關閉」。

安裝說明

• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。
• Windows Authenticode 尚未啟用，安裝或首次開啟時仍可能出現 SmartScreen 提示。

Yuzora v0.0.15

新增

• 可自訂第 1～9 個頁籤與前後頁籤快捷鍵，支援釘選頁籤、分割區、編輯器、終端機與內建 Browser。
• HTML／HTM 檔案可透過檔案樹、頁籤及編輯器右鍵「在此預覽」，支援本機、WSL 與 SSH 工作區；預覽已儲存內容並在存檔後更新。
• Browser 可選取頁面元素，複製來源、selector、HTML、文字、尺寸與關鍵樣式，方便提供給 AI 修改。

改善與修正

• 隨附 HERDR 升級至 0.9.1，保留與 0.9.0 的相容性；升級不主動停止既有 Session。
• 改善終端機在字級調整、分割 pane 與尺寸變更時的內容錯位、閃爍及短暫收縮。
• 修正 Windows 調整終端機字級後，字元間距過大或整行擠在左側的問題。
• 切回應用程式及建立終端機完成命名或取消後，恢復目前 Terminal 的輸入焦點，保留其他輸入欄位與對話框的焦點。
• 新工作區的信任對話框關閉後，恢復原 Terminal 的輸入焦點。
• 修正 Browser 頁籤遮住其他未儲存檔案的關閉確認對話框。
• Git 操作成功與後續狀態刷新失敗分開回報，忙碌時僅重試讀取，避免重複執行提取或分支操作。
• 修正 WSL Windows 磁碟上的檔案已儲存卻顯示失敗的情況，並保留衝突與更新後未儲存內容的提示。

使用與安裝說明

• HTML 預覽只讀取已儲存檔案；專案開發伺服器仍由使用者管理。元素複製僅輸出文字，支援同源 iframe 與 open shadow DOM；跨來源 iframe 只選取框架本身，不擷取密碼及即時表單值。
• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。
• Windows Authenticode 尚未啟用，安裝或首次開啟時仍可能出現 SmartScreen 提示。

Yuzora v0.0.14

修正

• 升級 Yuzora 後自動同步 WSL／SSH 的主機輔助程式並刷新各 Session 的功能資訊，修正舊輔助程式導致 Spaces 拖曳與上移／下移停用；保留既有 HERDR 工作與來源設定。
• 改善 WSL HERDR 終端機捲動與快速連續滾輪操作，避免影響 Agent 輸入；切換或關閉連線時丟棄尚未處理的捲動操作。
• 捲軸僅在該 HERDR session 支援完整捲動資訊時啟用。
• pane scroll metadata 暫時不可用時回退至相容的 terminal scroll，避免 0.8.2 以上 runtime 的滑輪操作中斷。
• HERDR 終端輸入傳送失敗時自動重新連線同一個 Session，避免連線失效後永久停在輸入暫停狀態。
• HERDR 終端機複製會整理段落前後的多餘空白，保留 Markdown、程式碼、清單、表格及圖形排版；依安裝系統使用 LF 或 CRLF，Windows 上的 WSL 亦使用 CRLF。大型選取改在背景排版，連續複製保留最後一次結果。
• WSL HERDR Space 拖曳排序在 WebView 無法取得 pointer capture 時仍能完成，並以列位置 fallback 判定放置目標。

新增

• 在支援排序的 HERDR Session 中，可拖曳 Space 或使用右鍵選單的上移／下移調整順序，並依 runtime 能力移動完整 worktree 群組。

改善

• Spaces／Agents 切換改為分頁樣式，並保留上次選擇。
• 合併高頻捲動請求並在背景同步捲軸範圍，避免快速捲動塞滿主機請求佇列。

安裝說明

• macOS App 僅支援 Apple Silicon，未使用 Apple Developer ID 簽章或公證；首次開啟仍可能出現 Gatekeeper 提示。
• Windows Authenticode 尚未啟用，安裝或首次開啟時仍可能出現 SmartScreen 提示。

Yuzora v0.0.13

Fixed

• Map WSL /mnt/<drive>/... paths to native Windows drive paths when revealing files and folders in Explorer.

這裡只記錄使用者可以直接感受到的改變，不包含 commit、檔案名稱或內部實作細節。

Yuzora v0.0.12

修正

• 更新檢查會依 Stable／Preview 頻道讀取對應的簽章發布資訊，並相容於尚未提供新原生更新命令的舊版本。
• WSL 資料夾開啟改用 Explorer 路徑 fallback，確保可在 Windows 檔案總管中開啟。

Yuzora v0.0.11

修正

• macOS App bundle 改為完整 ad-hoc signing，避免下載後因資源封存不完整而被 Gatekeeper 顯示為已損毀。
• Windows 更新確認視窗會明確提示先關閉 HERDR，避免安裝程式因 herdr.exe 被鎖定而失敗。