- 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。 手势类型：Gesture、DragGesture、LongPressGesture、MagnifyGesture、RotateGesture、TapGesture。 手势与布局行为更加接近原生 SwiftUI。 ## 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 渲染组件，可无缝显示矢量图形。 自定义字体 现在支持使用系统或第三方应用安装的字体。 --- # 改进 请求 API RequestInit / Request 新增 allowInsecureRequest 字段，用于控制是否允许不安全的请求。 定位 API Location.requestCurrent 现在默认返回缓存的位置数据（如果可用）。 新增可选参数 options.forceRequest，用于始终获取最新位置。 开发者服务器 开发者服务器现在会记住并记录上次连接的地址，以加快重新连接速度。 存储增强 set、get、contains、remove、setData 和 getData 现在支持可选参数 options.shared，用于跨脚本访问共享存储，方便实现跨脚本功能。 --- # 修复 助手工具调用 修复了助手在调用工具时可能错误解析参数的问题，提高了工具执行的可靠性。 照片 API 修复了通过下滑手势关闭 Photos.pickPhotos 窗口时不会正确结束 promise 的问题。 健康数据权限 修复了请求 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 的错误，提升了稳定性。

新功能 - 统一脚本格式：脚本现在以.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 现在返回带有新 request 属性的 NotificationInfo 实例。原有的字段已废弃，请通过 request 属性访问。 小组件改进与预览支持 新增 widgetBackground 视图修饰符，支持 iOS 18+ 的 Tinted 模式下小组件的背景样式设置。 新增 Widget.preview 方法，可在 index.tsx 中调用，便于实现小组件的实时预览，适合用于自定义配置页面。 文档更新 补充了多个模块的文档内容，例如完善了 Charts 相关 API 的说明和示例。

新增 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 接口和 `singleMode` 参数支持 - `StrokeStyle` 现在支持设置 `lineWidth`、`lineCap` 和 `lineJoin` - 新增 Wake Lock API，防止设备在脚本运行时进入睡眠 - 修复 macOS 中无法解析 Shortcuts 参数的问题及其他小错误

修复导致app崩溃的bug

新增实用 API，扩展脚本能力 - 新增 Contact API，你的脚本现在可以访问、修改和删除通讯录联系人 - 新增 Mail API，可直接在脚本中唤起发送邮件视图 - FileManager 新增 mimeType 和 destinationOfSymbolicLink API，获取文件 MIME 类型和符号链接指向 UI 功能增强，体验更丰富 - 新增 AngularGradient 和 MeshGradient (iOS 18+) 样式，让你的界面更炫酷 - 新增 redacted / unredacted 视图修饰符，轻松实现数据脱敏效果 AI 功能全面升级，自定义更灵活 - 支持自定义 Assistant Rule，让你的 AI 行为更符合你的需求 - 支持添加自定义 AI API Provider，接入更多你想用的 AI 服务商 本地开发体验优化 - 本地开发服务新增 扫码连接 和 手动输入服务地址连接，连接更便捷 修复与性能优化 - 修复了 Weather API 中的部分拼写错误 - 优化了 Assistant 智能助手 的渲染性能，体验更流畅

- 修复智能助手会话中导致程序崩溃的BUG

- 提升了整体性能，提供更流畅的体验。 - 解决了智能助手在输出流式信息时，对话窗口滚动可能出现的抖动问题。 - 修复了在 Mention 文件或目录时，额外的斜杠导致 Mention 内容未正确发送的问题。 - 解决了使用写入文件等工具时，编辑器未自动切换到对应文件的问题。 - 修复了在 iPad 上调用 `Dialog.actionSheet` 可能导致崩溃的问题。

- 智能助手重构，全新体验 - 新增自定义智能助手工具 - 新增本地开发服务 - 新增 天气等API - Bug 修复与优化

- 新增与AI大模型对话完成任务的功能

- Widget.present新增支持传递第二个参数以控制什么时候刷新小组件 - 新增 AnimatedImage、AnimatedFrames、AnimatedGif、swingAnimation等API用于展示小组件动画 - 为Chart添加一些属性 - 优化通知设置页面 - 新增设置语言