- Added new features - Fixed some issues

# 新功能 ## 無頭瀏覽器請求 fetch 方法現可模擬無頭瀏覽器發起的請求，提供更精確的網頁互動與 Cookie 處理。 Request / Response 增強 新增 handleRedirect 屬性以控制重定向行為。 舊的 shouldAllowRedirect 屬性已廢棄。 新增 Response.cookies 屬性，可獲取響應返回的 Cookie 列表。 ## 背景網路會話 新增支援背景下載與上傳的 API： - BackgroundURLSession - URLSessionDownloadTask - URLSessionUploadTask ## 背景運行保持器 新增 BackgroundKeeper，可請求後台執行權限，讓任務在 App 進入背景後繼續運行。 ## AVPlayer 中繼資料存取 新增 loadCommonMetadata() 與 loadMetadata() 方法，並新增 AVMetadataItem 類，可讀取目前播放資源的詳細中繼資料。 ## 剪貼簿 API 新增 Pasteboard API，用於讀寫剪貼簿內容，舊的 Clipboard API 已廢棄。 ## 手勢系統 新增完整手勢 API 與修飾符： 視圖修飾符：gesture、highPriorityGesture、simultaneousGesture、defersSystemGestures、lineSpacing。 手勢 API：Gesture、DragGesture、LongPressGesture、MagnifyGesture、RotateGesture、TapGesture。 ## UIImage 工具方法 新增： 實例方法：toJPEGBase64String()、toPNGBase64String()、toJPEGData()、toPNGData()。 靜態方法：fromBase64String()，可由 Base64 字串生成圖像。 ## 小工具系統更新 小工具分為： User Widgets：已完成開發的正式小工具。 Test Widgets：開發中測試用小工具。 兩者相互獨立刷新。 新增 Widget.reloadUserWidgets() 與 Widget.reloadTestWidgets() 方法。 ## ControlWidget 增強 新增 Button 控件，可打開 App 並執行指定腳本。 自定義鍵盤環境 現在可在 CustomKeyboard 環境中使用 Safari API。 --- # 改進 知識庫導入 修復從外部資料夾導入文件失敗的問題。 小工具渲染 修復本地圖片顯示異常。 文字文件打開 修復點擊文字文件重複打開編輯器的問題。 --- # 修復 ## 健康資料 API 修復 Health.queryStatistics 和 Health.queryStatisticsCollection 無法正確讀取數據。 修復 HealthStatistics 類在傳入 source 參數時未返回正確數值的問題。 ## 小工具執行（iOS 26） 修復在 iOS 26 上點擊小工具執行腳本會觸發兩次的問題。 ## 退出腳本後未關閉視窗 修復 Script.exit() 後 Safari、DocumentPicker、Photos、QuickLook 等未自動關閉的問題。

# 新功能 **知識庫** 您現在可以透過選擇整個目錄，一次匯入多個檔案。 **助手工具** 新增內建的查詢知識庫工具，讓助手在執行任務時能搜尋相關知識庫內容。 **控制中心小工具（iOS 18+）** 新增 ControlWidget，可將按鈕與切換控制項放入控制中心，並指定腳本來處理其邏輯。 **自訂鍵盤** 新增 CustomKeyboard API，可用來建立並顯示自訂鍵盤介面、處理輸入事件，並以程式方式插入文字。 **藍牙 API** 新增 BluetoothCentralManager 和 BluetoothPeripheralManager API。可打造完整的藍牙體驗，包括掃描、連線、讀寫 GATT 特徵、訂閱通知、廣播，以及提供自訂服務與特徵。 **新增 layoutPriority 檢視修飾符** 新增對 `layoutPriority` 檢視修飾符的支援，讓開發者能控制在版面限制下，同層檢視之間的空間分配方式。此行為與 SwiftUI 的 `layoutPriority(_:)` 一致。 **新增 modifiers 屬性與 ViewModifiers 系統** 新增 `modifiers` 屬性、`ViewModifiers` 類別以及 `modifiers()` 輔助函式，支援流暢且可鏈式的檢視修飾符應用。 此系統支援重複套用相同類型的修飾符（例如多次呼叫 `padding()` 或 `background()`），並確保修飾符會依鏈式順序準確套用，忠實呈現 SwiftUI 的行為。 **SVG 繪圖支援** 新增 SVG 繪圖元件，可順暢地顯示向量圖形。 **自訂字型** 現在支援使用系統或第三方 App 安裝的字型。 --- # 改進 **Request API** `RequestInit` / `Request` 新增 `allowInsecureRequest` 欄位，用於控制是否允許非安全的請求。 **定位 API** `Location.requestCurrent` 現在預設會回傳快取中的定位資料（若有的話）。 新增可選參數 `options.forceRequest`，可強制取得最新的定位資訊。 **開發者伺服器** 開發伺服器現在會記住並記錄上次連線的位址，以加快重新連線速度。 **儲存功能強化** `set`、`get`、`contains`、`remove`、`setData` 和 `getData` 現在皆支援可選參數 `options.shared`，可使用共享儲存區，在所有腳本間存取資料，更方便進行跨腳本整合。 --- # 錯誤修正 **助手工具呼叫** 修正助手在呼叫工具時，可能錯誤解析工具參數的問題，提升工具執行的穩定性。 **Photos API** 修正透過下滑方式關閉 `Photos.pickPhotos` 視窗時，不會正確結束 promise 的問題。 **HealthKit 權限** 修正請求 Health 權限時未觸發授權對話框的問題。 **腳本進階設定** 修正於進階設定頁面重新命名腳本時，儲存後可能導致重新整理失敗的錯誤。 --- # 變更 **API 提供者** 已移除 `Pollinations.AI` API 提供者。

新功能 - 本地知識庫（iOS 18+） 添加本地知識庫以增強 Assistant 的 RAG（檢索增強生成）能力。 - Chat 預設 建立包含預定義 Assistant 工具、規則和關聯知識庫的預設，以便更快進行客製化對話。 - Spotlight 整合 可直接在 Spotlight 中搜尋並啟動腳本。 - 檔案應用整合 可從檔案應用中使用 Scripting 開啟 .js、.jsx、.tsx 和 .json 檔案。 - 腳本中繼資料 script.json 現在支援 version、description、localizedNames、localizedDescriptions、author、contributors 等欄位。 Script 模組也新增 metadata 屬性來儲存這些資訊。 - 翻譯 API（iOS 18+） 新增 Translation 和 translationHost API，用於建構多語言工作流程。 - 通知 Notification.schedule 新增 tapAction 參數： - runScript：點擊時執行腳本 - openURL：點擊時開啟指定 URL（舊的 avoidRunningCurrentScriptOnTapped 選項已廢棄） - 小工具互動選項 小工具設定現在支援在「互動時」選擇 --開啟 URL--，點擊小工具即可跳轉至 URL。 - Storage API 新增 keys() 和 clear() 方法。 Storage 操作現在僅作用於當前腳本，避免不同腳本間的 key 衝突。 系統會自動遷移 key，開發者無需手動處理。 - 小工具中的 SSH 小工具中現已支援使用 SSH 功能。 改進 - 優化了 Assistant 的互動體驗，使對話更加流暢。 - 優化了腳本匯入，腳本會自動編譯並在編輯器中開啟。 - 編輯器新增內容選單操作：刪除全部、複製全部。 - Request API：新增 shouldAllowRedirect 處理函數。 - Data API：新增 compressed() 和 decompressed() 方法。 - OpenAI 請求現在使用新的 Response API。 修復 - 修復了 Widget.preview 切換主題時文字顏色不變的問題。 - 修正了 safeAreaInset API 的拼寫錯誤。 - 修復了在腳本群組中重新命名腳本可能導致腳本消失的問題。 - 修復了多個 API 的錯誤，提升了穩定性。

新API - 統一腳本格式：腳本現在以.scripting擴展名導出。輕觸任何.scripting文件會自動啟動Scripting並導入腳本。 - 擴展SSH功能：新的API，包括SSHClient和SFTPClient，支持安全的遠程連接和文件傳輸。 - 更新提醒API：Reminder類添加了dueDateComponents屬性，棄用dueDate和dueDateIncludesTime。 助手增強 - 優化了大語言模型響應的文本渲染性能，提供更流暢、更響應的輸出。 - 新的OpenRouter API提供者，現在您可以在輸入API密鑰後查看可用模型並快速添加它們。 BUG修復 - 修復了導入遠程腳本和更新遠程資源配置的問題。 - 修復了Reminder.dueDate返回null的問題，並添加了dueDateComponents屬性到Reminder。之前的dueDate和dueDateIncludesTime屬性已被棄用。

# 新功能 ## 遠端腳本導入 - 直接從 GitHub 程式碼庫或任何遠端伺服器匯入腳本，輕鬆共享。 ## 增強 Data API - Data.size 屬性用於檢索 Data 物件的位元組長度。 - Data.append() 和 Data.slice() 方法用於更靈活的二進位操作。 # 效能與最佳化 - 優化 OpenAI API 請求。 - 減少即時活動和視窗小部件的記憶體佔用。 - 視窗小部件不再在視窗小部件環境中自動編譯腳本。 # 使用者體驗改進 - 助手互動已簡化，反應速度更快、更直覺。 - 重新啟動應用程式時，應用程式現在會恢復到上次查看的「主頁」標籤頁，以便您可以從上次中斷的地方繼續操作。 # API 更新 ## WebViewController.evaluateJavaScript - 現在需要在腳本中使用 return 來傳回值。 - 返回 Promise，以便您可以直接處理非同步結果。 ## WebViewController.addMessageHandler - 現在返回一個 Promise，該 Promise 在處理程序成功註冊後解析。 # 錯誤修復 - 修正了在小部件預覽頁面上切換主題時文字無法正確更新的問題。

修復了無法連接帶有埠號的自定 API 提供者基礎 URL 的問題。 優化了程式碼編輯器，顯示更多註解資訊，並修復了開啟空白編輯器時自動插入空格的問題。

助手體驗優化 - 支持將本地文件或網頁內容提取為純文本，並隨消息一併發送 - 在助手輸出框中，可直接選擇並運行腳本，執行結果會附加在對話中 - 自訂 API 提供商交互升級：輸入 Base URL 和 API Key 後，可一鍵獲取並展示所有可用模型 新增 API 支援 - OAuth2 模組：輕鬆實現完整的 OAuth2 鑑權流程 - createOAuthCallbackURLScheme：Script 類新增該方法，可與 OAuth2 模組配合使用，簡化回調 URL Scheme 配置 - MessageUI 模組：調用系統消息界面，快速觸發短信或郵件發送 - Crypto 模組：全面升級，新增 MD5、SHA1、SHA256、SHA384、SHA512、HMAC‑MD5、HMAC‑SHA1、HMAC‑SHA224、HMAC‑SHA256、HMAC‑SHA384、HMAC‑SHA512，以及 AES‑GCM 加密/解密等多種算法（原 MD5 模組已廢棄） - Data 類擴展：新增 toHexString 與 fromHexString 方法，方便在十六進位字串與二進位資料之間互轉 Share Extension 優化 - 在 iOS 分享面板中保存腳本後，可選擇是否立即打開 Scripting 應用 - 若選擇打開，應用會自動刷新並載入剛剛保存的腳本 iOS 17 相容性改進 - 修復部分圖標在 iOS 17 下無法顯示的問題 - 解決腳本頁面在 app 啟動後出現空白頁面的異常情況

升級 HealthKit 整合 新增 Health API，用於存取 iOS HealthKit 資料 提供常見健康任務的內建範例腳本： 步數統計：顯示今日步數的小組件腳本 記錄體重：用於記錄體重的頁面工具和智慧助手 讀取基本身體資料：用於獲取身高、出生日期、性別等資訊的智慧助手 讀取體重：用於檢索歷史體重記錄的智慧助手 記錄飲食攝入：用於記錄每日飲食的智慧助手 讀取飲食記錄：用於查詢飲食攝入歷史的智慧助手 智慧通知 正確配置時效性通知，確保重要提醒絕不會被靜音 圖表元件增強 擴充 Charts API，新增屬性以實現更靈活、更豐富的視覺化

通知系統增強 新增 CalendarNotificationTrigger、LocationNotificationTrigger 和 TimeIntervalNotificationTrigger，支援更靈活強大的通知觸發條件。原本 Notification.schedule 方法中的 triggerTime 與 repeatsType 參數已棄用，請改用統一的 trigger 參數。 新增 DateComponents 工具類，簡化日曆型通知觸發器的建立。 Notification.getAllPendings 現在會返回 NotificationRequest 實例陣列，方便檢視排程中的通知。 Notification.getAllDelivereds 現在返回的 NotificationInfo 實例新增 request 屬性，原本的欄位已棄用，請改由 request 取得相關資訊。 小工具改進與預覽支援 新增 widgetBackground 視圖修飾符，支援 iOS 18+ Tinted 模式下的背景樣式。 新增 Widget.preview 方法，可於 index.tsx 中使用，方便實現小工具的即時預覽與自訂設定頁面。 文件更新 補充了多項 API 文件，例如 Charts 模組的屬性說明與使用範例。

新增 widgetAccentable 和 widgetAccentedRenderingMode 視圖修飾符，以支援 iOS 18+ 的 Tinted 模式 Image 元件新增 DynamicImageSource，可根據系統的淺色與深色模式切換顯示不同圖片 優化了文件選擇器與照片選擇器的互動體驗 修復多個錯誤，提升穩定性與效能

- Assistant.requestStructuredData 現在支援選擇 API 提供者與模型 - 新增設定，可配置 Assistant 在單次回覆中呼叫的工具是並行還是串行執行 - Assistant 訊息現在支援 HTML 與 Mermaid 圖表的豐富渲染 - 新增多個視圖修飾符：scrollTargetLayout、scrollTargetBehavior、scrollContentBackground、truncationMode、allowsTightening、flipsForRightToLeftLayoutDirection、containerRelativeFrame、safeAreaPadding - Notification 模組新增方法以正確管理當前腳本的通知 - 修正部分通知方法未如預期運作的問題 - 優化互動體驗，修復多個可能導致崩潰的錯誤

新增功能 * 拖放支援 新增 `onDropContent` 視圖修飾符，使腳本可以接收來自其他應用程式拖入的檔案。 * 漸層工具優化 引入新的漸層工具類，使與漸層相關的程式碼更易讀、更易維護。 * 檔案寫入增強 新增 `FileManager.appendText` 和 `FileManager.appendData` 方法，支援將文字或二進位資料追加寫入現有檔案。 * 全新 AbortController API 使用現代的 `AbortController` 和 `AbortSignal` API 取代舊有的 `CancelToken` 類別，以提供更完善的取消操作處理。 * 快捷指令增強 新增「執行 TypeScript 程式碼」和「執行音訊播放腳本」兩個快捷指令。透過「執行腳本」快捷指令執行的腳本現在可與 Live Activity 和音訊播放 API 互動。 改進內容 * 文件更新 新增視圖修飾符的詳細文件，幫助開發者更好地理解並使用佈局與樣式功能。 * 記憶體最佳化 優化在 Widget 和 AppIntent 中執行腳本時的記憶體使用，提高效能。

助手功能優化 - 修復 Assistant 同時呼叫多個工具時可能失敗的問題，提升多工具執行穩定性 - 優化聊天介面樣式與互動流程，提升使用體驗 - 整合 pollinations.ai 免費 API（支援 deepseek 與 deepseek-reasoner 模型），特別感謝 pollinations.ai 的支持 腳本管理與相容性 - 優化腳本分組操作，提高分組管理效率 - Dev Server 頁面新增腳本搜尋功能，方便快速查找與編輯腳本 - 修復 iPad 上腳本頁面顯示問題，確保跨裝置介面一致性 平台事件與 PDF 支援 - 支援 scenePhase 應用程式生命週期事件，可偵測前後台狀態變化 - 新增 PDFDocument 和 PDFPage API，用於建立、讀取與操作 PDF 文件 圖表與通知增強 - ChartMarkProps 新增 foregroundStyleBy、symbolBy、symbolSizeBy、positionBy、lineStyleBy 等屬性，支援更豐富的圖表樣式 - Notification.schedule 新增 avoidRunningCurrentScriptWhenTapped 參數，可控制點擊通知時是否執行當前腳本

助手功能改進 * 支援在單一回覆中呼叫多個工具 * 支援預覽 HTML 與 Mermaid 圖表，渲染區塊級 LaTeX 公式 * 臨時編輯器可在聊天中直接執行 TS/JS 程式碼 * 聊天視窗佈局與互動體驗優化 * 新增快速插入常用指令的提示模板 系統新 API * Vision API：從影像中擷取文字或掃描文件成文字 * Crypto API：存取常見加密函數 工作區強化 * 支援腳本分組，更好地管理 * 支援外接鍵盤與 macOS 的快捷鍵 穩定性與效能 * 文件書籤管理頁面互動優化 * NavigationLink 效能提升，修正視圖修飾符繼承問題 * 修正在特定系統版本中呼叫 `new CalendarEvent()` 時的當機問題 * 多項錯誤修復與效能提升

Fixed an issue that caused the app to crash on iOS 18.4

- Added Custom Role Mode for the Assistant: You can now define custom roles for the AI, not just limited to code generation. - Assistant tools can now be mentioned directly in the input box for quicker access. - All scripts are now saved in the "scripts" folder under Documents for better organization. - Fixed an issue where file bookmarks were not working properly. - Corrected various documentation errors.

- Assistant Tool 現在改為使用腳本，可透過 Assistant 建立 - 可從其他 App（如瀏覽器）直接儲存腳本到 Scripting - 小工具預覽頁面現在支援互動並能即時更新介面 - `Script.run` 新增 URL Scheme API 與 `singleMode` 參數支援 - `StrokeStyle` 現在支援設定 `lineWidth`、`lineCap` 和 `lineJoin` - 新增 Wake Lock API，可防止裝置在執行期間進入睡眠 - 修復 macOS 無法解析捷徑參數的問題及其他小錯誤

Fixed the bug causing the app to crash.

New APIs to Empower Your Scripts - Contact API added — access, edit, and delete contacts directly from your script - Mail API added — launch the email composer view within your script - FileManager now supports mimeType and destinationOfSymbolicLink APIs to fetch file MIME types and resolve symbolic links Enhanced UI Features - Added AngularGradient and MeshGradient (iOS 18+) for more advanced and colorful UI designs - New redacted / unredacted view modifiers — easily apply redaction effects for sensitive data Smarter, More Customizable AI - Support for Custom Assistant Rules — define your own AI behaviors - Support for adding Custom AI API Providers — integrate your preferred AI services beyond built-in options Improved Local Development Experience - Development Server now supports QR code connection and manual address input, making it easier to connect and debug Bug Fixes & Performance Improvements - Fixed some typos in the Weather API - Improved Assistant rendering performance for a smoother experience

- Fixed an issue where the chat window may crash.

- Optimized overall performance for a smoother experience. - Fixed an issue where the chat window might jitter when the assistant outputs streaming response. - Resolved an issue where extra slashes in file or directory Mentions prevented content from being sent correctly. - Fixed an issue where the editor did not automatically switch to the corresponding file when using file-writing tools. - Addressed a crash issue on iPad when calling `Dialog.actionSheet`.

- Assistant Overhaul - Custom Assistant Tools - Local Development Server - New API Additions - Bug Fixes & Improvements

- Added functionality for task completion through conversations with large AI models.

- The Widget.present now supports passing a second parameter to control when the widget should be refreshed. - New APIs such as AnimatedImage, AnimatedFrames, AnimatedGif, and swingAnimation have been added for displaying widget animations. - Added new properties to the Chart. - Optimized the notifications settings page. - Added language setting options.