Merge branch 'dev' of https://github.com/shelllet/winui into dev

merge from 0.48.1

Author: shelllet

docx/CHANGELOG.md

@@ -1,4 +1,64 @@
-# [0.47.0](https://github.com/shelllet/winui/compare/main...dev) (2025-09-22)
+# [0.48.1](https://github.com/shelllet/winui/compare/main...dev) (2025-11-26)
+
+### Changed：
+1. 鼠标键盘的模拟支持驱动模式，参考[工作流设置](./introduction/setting/workflow.md)。
+
+### Note
+
+1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`（未来版本中优化）。
+3. 下载（安装包）：https://winui.net/_media/simple/小友+0.48.1-setup.x64.exe
+
+
+## [0.48](https://github.com/shelllet/winui/compare/main...dev) (2025-11-11)
+
+### Changed：
+1. [查找窗口](./actions/window/FindWindow.md) 支持从多个相同标题或类名的窗口中选择需要处理的窗口。
+2. [窗口截图](./actions/media/CaptureWindow.md), 添加参数支持仅截图窗口。
+2. 修复搜索动作时，输入特殊字符崩溃问题。
+3. 支持插件功能
+4. 网络相关动作支持`QUIC`协议
+5. 添加[发送输入](./actions/network/SendInput.md)，和[接收输入](./actions/network/ReceiveInput.md) 两个动作，可以同步多台电脑鼠标键盘操作。
+
+### Note
+
+1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`（未来版本中优化）。
+3. 下载（安装包）：https://winui.net/_media/simple/小友+0.48.0-setup.x64.exe
+
+
+## [0.47.2](https://github.com/shelllet/winui/compare/main...dev) (2025-10-13)
+
+### Changed：
+1. 修复管理员权限运行时，文件保存打开窗口无法弹出问题。
+2. 优化快捷 *添加动作* 弹框功能。
+3. 修复管理员权限运行时，无法拖放动作的问题。
+4. 修复[键盘/鼠标宏重放](./actions/media/PlayRecord.md) 执行时无法退出流程问题。
+5. 修复模拟鼠标点击在手游客户端有时无作用问题。
+6. [窗口截图](./actions/media/CaptureWindow.md) 动作增加一个参数，方便仅保存窗口图像。
+
+### Note
+
+1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`。
+3. 下载（安装包）：https://winui.net/_media/simple/小友+0.47.2-setup.x64.exe
+
+
+## [0.47.1](https://github.com/shelllet/winui/compare/main...dev) (2025-10-09)
+
+### Changed：
+1. 修复打开低版本创建的档案时，复制、粘贴动作出现的错误。
+2. 修复 [打开浏览器](./actions/web/WebOpen.md) 动作的错误。
+3. 开启用户相关界面功能（实验性）。
+
+### Note
+
+1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`。
+3. 下载（安装包）：https://winui.net/_media/simple/小友+0.47.1-setup.x64.exe
+
+
+## [0.47.0](https://github.com/shelllet/winui/compare/main...dev) (2025-09-22)
 
 ### Changed：
 1. 优化文字识别动作，文字识别结果已经更改为从上至下的顺序。
@@ -7,13 +67,14 @@
 4. 关机动作更新为 [SuspendSystem](./actions/system/SuspendSystem.md)， 并且支持休眠。
 5. 支持运行当前的工作流。
 6. [退出流程] 动作更名，参考： [退出流程](./actions/control/Exit.md)。
-7. 增加 [域名查询](./actions/control/DomainQuery.md) 动作， 用于操持流程不退出。
+7. 增加 [域名查询](./actions/network/DomainQuery.md) 动作。
 
 ### Note
 
 1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
-2。该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`。
-3. 64位下载(x64)：邀请你加入群组:小友+ http://yun.139.com/m/#/invitation?type=1&msgId=1227933999795726207
+2. 该版本由于内置了一些文字处理相关的模型，安装包大小已经超过 `300M`。
+3. 下载（压缩包，解压覆盖本地文件）：https://winui.net/_media/simple/小友+0.47.0.zip
+4. 下载（安装包）：https://winui.net/_media/simple/小友+0.47.0-setup.x64.exe
 
 ## [0.46.0](https://github.com/shelllet/winui/compare/main...dev) (2025-07-22)
 
@@ -27,7 +88,7 @@
 ### Note
 
 1. 使用管理员权限运行 *小友+*, 无法显示 *动作* 的拖动效果（已知问题）。
-2. 64位下载(x64)：邀请你加入群组:小友+ http://yun.139.com/m/#/invitation?type=1&msgId=1227933999795726207
+2. 64位下载(x64)：https://winui.net/_media/simple/小友+0.46.0-setup.x64.exe
 
 ## [0.45.0](https://github.com/shelllet/winui/compare/main...dev) (2025-06-13)
 

docx/README.md

@@ -36,13 +36,4 @@ _小友+_ 绝对不会嵌入任何广告、捆绑任何软件。也不会像国
 
 - 软件下载：[https://winui.net/](./CHANGELOG.md)
 
-- Youtube视频教学: [https://www.youtube.com/playlist?list=UULFs1P87PQvBDJAuJfkKRLqMQ](https://www.youtube.com/playlist?list=UULFs1P87PQvBDJAuJfkKRLqMQ)
-- Bilibili 站视频教学：[https://space.bilibili.com/652005178/channel/collectiondetail?sid=84951](https://space.bilibili.com/652005178/channel/collectiondetail?sid=84951)
-
 - 如果你有 *Discord*, 加入 [Discord](https://discord.gg/b4MeYbJrfk) 讨论。
-
-<div style="text-align:center;">
-
-![共享群](./introduction/images/qrcode.jpg)
-
-</div>

docx/_sidebar.md

@@ -1,13 +1,15 @@
 - [小友+](/)
   - [使用需知](./introduction/README.md)
   - 软件安装
-      - [直接安装](./introduction/installation/installed_by_exe.md)
-      - [微软商店安装](./introduction/installation/installed_by_msix.md)
-      - 安装问题
-        - [新安装无法启动](./introduction/installation/question/quest1.md)
-        - [覆盖安装无法启动](./introduction/installation/question/quest2.md)
-      - 设置
-        - [动作分组隐藏](./introduction/installation/setting/action_group_setting.md)
+    - [直接安装](./introduction/installation/installed_by_exe.md)
+    - [微软商店安装](./introduction/installation/installed_by_msix.md)
+    - 安装问题
+      - [新安装无法启动](./introduction/installation/question/quest1.md)
+      - [覆盖安装无法启动](./introduction/installation/question/quest2.md)
+  - 设置
+    - [动作分组隐藏](./introduction/setting/action_group_setting.md)
+    - [工作流设置](./introduction/setting/workflow.md)
+
   - 流程介绍
     - [项目属性](./introduction/workflow/property.md)
     - [使用逻辑](./introduction/workflow/logic.md)
@@ -175,7 +177,8 @@
       - [数据接收](./actions/network/NetworkReceive.md)
       - [服务连接](./actions/network/NetworkConnect.md)
       - [域名查询](./actions/network/DomainQuery.md)
-
+      - [发送输入](./actions/network/SendInput.md)
+      - [接收输入](./actions/network/ReceiveInput.md)
     - 统计分析
       - [加载文档](./actions/pandas/LoadDocument.md)
       - [查询](./actions/pandas/DataFrameQuery.md)

docx/actions/media/CaptureWindow.md

@@ -11,13 +11,20 @@
 * 窗口
 > 需要截图的窗口。如果为 *空* ，选择当前激活的前置窗口。
 
+* 索引
+> 如果不为空，则对应查找到的多个相同标题或类名的窗口的索引。
+
 * 坐标
 > 要选择的 *ROI* 区域左上角位置，默认值 `（0， 0）`。*ROI* 区域之外，图像将置为黑色，该参数不影响输出图像尺寸。
 * 尺寸
 > 要选择的 *ROI* 区域的长宽。*ROI* 区域之外，图像将置为黑色，该参数不影响输出图像尺寸。
+
+* 仅窗口
+> 如果选择`True`，仅截取窗口图像，否则截取全屏幕图像（窗口外区域填充黑色）。 
+
 ## 输出
 
-> 图像，参考：[`Image`](./types/Image.md)，图像尺寸为窗口所在屏幕的尺寸。
+> 图像，参考：[`Image`](./types/Image.md)。
 
 
 ## 资源
@@ -26,9 +33,10 @@
 
 
 
-
-
 ## Changed
 
 * 0.45
 > 运行参数*中心坐标* 改为 *左上角坐标*。
+
+* 0.48
+> 添加 *仅窗口* 参数。

docx/actions/network/ReceiveInput.md

@@ -0,0 +1,33 @@
+# 接收输入 
+接收网络上的鼠标键盘事件。
+
+![NetworkReceive](./images/12.png ':size=90%')
+
+## 子流程
+> 不支持
+
+## 运行参数
+
+* 主机
+
+>    如果协议是 `TCP`, *IP* 必须为远程 *IP*, `UDP` 可以是远程 *IP*, 或者 `0.0.0.0` 接收广播数据, 端口必须为有效的端口，需要和发送端一致。
+
+* 偏移坐标
+> 如果置为窗口，接收端会自动把窗口坐标映射为全局坐标。如果输入坐标， 接收端接收坐标时加上该坐标的值。
+* 协议
+> 支持 `UDP` 和 `TCP` 协议，建议使用 `UDP` 协议，提高鼠标键盘的传输速度。注意：发送和接收端的协议必须相同。
+
+## 输出 
+
+> 无
+
+
+## 资源
+
+
+示例： https://github.com/shelllet/WinUi/blob/main/network/send_receive_input.simple
+
+
+
+
+

docx/actions/network/SendInput.md

@@ -0,0 +1,31 @@
+# 发送输入 
+通过网络，发送鼠标键盘事件。
+
+![SendInput](./images/11.png ':size=90%')
+
+## 子流程
+> 不支持
+
+## 运行参数
+
+* 主机
+>  *IP* 必须为本机*IP*, 端口为有有效的端口，比如：4433，该参数是主机地址，如果是`UDP`协议，*IP*： `0.0.0.0` 可以向局域网广播，鼠标键盘事件。
+
+* 偏移坐标
+> 如果置为窗口，发送端会自动把全局坐标映射为窗口坐标。如果输入坐标， 发送端在发送坐标时加上该坐标的值。
+
+* 协议
+> 支持 `UDP` 和 `TCP` 协议，建议使用 `UDP` 协议，提高鼠标键盘数据的传输效率。注意：发送和接收端的协议必须相同。
+
+## 输出
+
+> 无
+
+### 其它
+
+示例： https://github.com/shelllet/WinUi/blob/main/network/send_receive_input.simple
+
+
+
+
+

docx/actions/network/images/11.png

@@ -30,6 +30,12 @@
 * 流程：https://github.com/shelllet/WinUi/blob/main/web/openurl.simple
 
 
+## 注意事項
+
+  * 在 Windows 上使用 Selenium 讓 Chrome 載入預設的用戶資料目錄（User Data Directory）可以保留你的登錄狀態、瀏覽歷史、書籤和擴展程序等。但是新版的Chrome浏览器似乎不支持默认的用户配置。仍然会报出来「DevToolsActivePort」的错误。
+  * **不要同時運行兩個 Chrome 實例：** 你不能在同一個時間，同時運行一個手動打開的 Chrome 瀏覽器和你用 Selenium 腳本啟動的、且使用相同用戶資料目錄的 Chrome 實例。這會導致「DevToolsActivePort」錯誤。
+  * **路徑中的斜槓：** 在 Python 中，Windows 的路徑可以使用雙反斜槓 `\\` 或單正斜槓 `/`。在 Java 中，則需要使用雙反斜槓 `\\` 來作為轉義字元。
+  * **不同作業系統的路徑：** 上述路徑是針對 Windows 10/11 的。如果你在 macOS 或 Linux 上，路徑會不同。你可以同樣使用 `chrome://version/` 來找到對應的正確路徑。
 
 ## 驱动
 

docx/actions/network/images/12.png

@@ -13,6 +13,9 @@
 * 父窗口
 > 默认为空，如果不为空，查找相应的子窗口，不为空，则查找当前系统所有的顶层窗口。可借助 *Spy++* 来辅助操作。
 
+* 索引
+> 如果不为空，则对应查找到的多个相同标题或类名的窗口的索引。
+
 * 标题
 > 窗口标题，支持 [通配符匹配](./introduction/workflow/wildcard.md)。
 
@@ -31,8 +34,11 @@
 
 
 
+!> [Windows下的程序及热键监视神器——Spy++](https://zhuanlan.zhihu.com/p/355878952)
 
+!> 附件: [spy++](https://gitlab.com/junwu/winui/-/raw/main/tools/spyxx.zip)
 
-!> [Windows下的程序及热键监视神器——Spy++](https://zhuanlan.zhihu.com/p/355878952)
+## Changed
 
-!> 附件: [spy++](https://gitlab.com/junwu/winui/-/raw/main/tools/spyxx.zip)
+* 0.48
+> 增加 *索引* 参数。