七麦数据

- Added new APIs related to Liquid Glass

- Fixed several bugs and stability issues

- 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，新增屬性以實現更靈活、更豐富的視覺化