From 6573bcf1c4bb2be691b069d843c13dee8262b070 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8C=83?= Date: Mon, 18 Dec 2023 17:44:42 +0800 Subject: [PATCH] update --- .github/workflows/static.yml | 6 ++- docx/CHANGELOG.md | 4 +- docx/_sidebar.md | 18 +++++---- .../control/{ForEach.md => Iterate.md} | 4 +- docx/actions/control/Param.md | 29 +++++++++++++++ docx/actions/control/ParamGet.md | 29 --------------- docx/actions/network/NetworkConnect.md | 35 ++++++++++++++++++ docx/actions/network/NetworkListen.md | 34 +++++++++++++++++ docx/actions/network/NetworkReceive.md | 32 ++++++++++++++++ docx/actions/network/NetworkSend.md | 33 +++++++++++++++++ docx/actions/network/TcpConnect.md | 37 ------------------- docx/actions/network/TcpListen.md | 33 ----------------- docx/actions/network/TcpReceive.md | 31 ---------------- docx/actions/network/TcpSend.md | 33 ----------------- .../{YoutubeDownload.md => VideoDownload.md} | 11 ++++-- docx/types/HostAddress.md | 3 ++ docx/types/SocketAddress.md | 3 -- docx/types/TCPServer.md | 1 + docx/types/TCPSocket.md | 1 + docx/types/UDPSocket.md | 1 + 20 files changed, 195 insertions(+), 183 deletions(-) rename docx/actions/control/{ForEach.md => Iterate.md} (65%) create mode 100644 docx/actions/control/Param.md delete mode 100644 docx/actions/control/ParamGet.md create mode 100644 docx/actions/network/NetworkConnect.md create mode 100644 docx/actions/network/NetworkListen.md create mode 100644 docx/actions/network/NetworkReceive.md create mode 100644 docx/actions/network/NetworkSend.md delete mode 100644 docx/actions/network/TcpConnect.md delete mode 100644 docx/actions/network/TcpListen.md delete mode 100644 docx/actions/network/TcpReceive.md delete mode 100644 docx/actions/network/TcpSend.md rename docx/actions/network/{YoutubeDownload.md => VideoDownload.md} (61%) create mode 100644 docx/types/HostAddress.md delete mode 100644 docx/types/SocketAddress.md create mode 100644 docx/types/TCPServer.md create mode 100644 docx/types/TCPSocket.md create mode 100644 docx/types/UDPSocket.md diff --git a/.github/workflows/static.yml b/.github/workflows/static.yml index 4d2a058..af6cfae 100644 --- a/.github/workflows/static.yml +++ b/.github/workflows/static.yml @@ -44,6 +44,10 @@ jobs: pwd mkdir -p /var/www cp -Rf ./docx/* /var/www - wget -P /var/www/_media/simple/ --content-disposition https://winui.net/simple/v3/download + + if ! [-f /var/www/_media/winui++${{ vars.VERSION }}-setup.x64.exe]; then + curl -L --create-dirs -o winui++${{ vars.VERSION }}-setup.x64.exe --output-dir /var/www/_media https://winui.net/simple/v3/download + fi sudo chown -R caddy:caddy /var/www/_media + shell: bash diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md index cb25917..895b3ca 100644 --- a/docx/CHANGELOG.md +++ b/docx/CHANGELOG.md @@ -4,8 +4,8 @@ 1. *工作线程* 动作支持选择是否立即运行。 2. *监听鼠标* 动作支持鼠标侧键。 -3. *For*（循环）动作名称变更为 *ForEach*（迭代）动作，功能不变。 -4. *IterParam*（迭代参数）动作名称变更为 *ParamGet*（参数获取）动作，并支持设置默认参数，功能不变。 +3. *For*（循环）动作名称变更为 *Iterate*（迭代）动作，功能不变。 +4. *IterParam*（迭代参数）动作名称变更为 *Param*（参数）动作，并支持设置默认参数，功能不变。 5. 增加 *StandardPath*（标准路径）动作，用来表示系统常用路径。 ### Deprecated: diff --git a/docx/_sidebar.md b/docx/_sidebar.md index 033b94b..52a7407 100644 --- a/docx/_sidebar.md +++ b/docx/_sidebar.md @@ -35,7 +35,7 @@ - [状态切换](./actions/async/WorkReset.md) - [等待事件](./actions/async/WhenEvent.md) - [异步等待](./actions/async/WorkWait.md) - - 文件 + - 文件系统 - [读取文件](./actions/filesystem/FileRead.md) - [文件写入](./actions/filesystem/FileWrite.md) - [按行读取](./actions/filesystem/ReadLines.md) @@ -44,6 +44,7 @@ - [搜索文件](./actions/filesystem/FileQuery.md) - [遍历文件](./actions/filesystem/DirectoryIterator.md) - [文件复制](./actions/filesystem/CopyFile.md) + - [标准路径](./actions/filesystem/StandardPath.md) - 键盘 - [发送按键](./actions/keyboard/SendKey.md) - [发送文本](./actions/keyboard/SendText.md) @@ -118,14 +119,14 @@ - [相机图像](./actions/media/VideoFrame.md) - 网络 - [文件下载](./actions/network/HttpDownload.md) - - [视频下载](./actions/network/YoutubeDownload.md) + - [视频下载](./actions/network/VideoDownload.md) - [HEAD 请求](./actions/network/HttpHead.md) - [GET 请求](./actions/network/HttpGet.md) - [POST 请求](./actions/network/HttpPost.md) - - [商品监听](./actions/network/TcpListen.md) - - [数据发送](./actions/network/TcpSend.md) - - [数据接收](./actions/network/TcpReceive.md) - - [服务连接](./actions/network/TcpConnect.md) + - [网络服务](./actions/network/NetworkListen.md) + - [网络发送](./actions/network/NetworkSend.md) + - [网络接收](./actions/network/NetworkReceive.md) + - [服务连接](./actions/network/NetworkConnect.md) - 统计分析 - [文档](./actions/xml/XmlLoadDocument.md) - [获取节点](./actions/xml/XmlGetNodeList.md) @@ -135,7 +136,7 @@ - [保存](./actions/xml/XmlSaveDocument.md) - [读取 Json](./actions/json/ReadJson.md) - 逻辑 - - [迭代](./actions/control/ForEach.md) + - [迭代](./actions/control/Iterate.md) - [判断](./actions/control/If.md) - [判空](./actions/control/IsEmpty.md) - [调用](./actions/control/Invoke.md) @@ -150,7 +151,7 @@ - [算术运行](./actions/control/ArithmeticCalculate.md) - [逻辑运算](./actions/control/LogicalOperator.md) - [关系运算](./actions/control/RelationalOperator.md) - - [参数获取](./actions/control/ParamGet.md) + - [参数](./actions/control/Param.md) - 算法 - [分割字符串](./actions/algorithm/SplitString.md) - [非零像素点](./actions/algorithm/FindNonZero.md) @@ -258,6 +259,7 @@ - [Timer](./types/Timer.md) - [Thread](./types/Thread.md) - [Keyboard](./types/Keyboard.md) + - [主机地址](./types/HostAddress.md) - 枚举类型 - [ThresholdTypes](./enums/ThresholdTypes.md) - [Directions](./enums/Directions.md) diff --git a/docx/actions/control/ForEach.md b/docx/actions/control/Iterate.md similarity index 65% rename from docx/actions/control/ForEach.md rename to docx/actions/control/Iterate.md index 9fbbbf8..9719aad 100644 --- a/docx/actions/control/ForEach.md +++ b/docx/actions/control/Iterate.md @@ -1,5 +1,5 @@ -# 循环 -循环，主要用来迭代容器 +# 迭代 +用来迭代相应的列表数据，遍历列表的每一个元素，也可称为*循环*。 ![action](./images/2022-11-17_184608.png ':size=90%') diff --git a/docx/actions/control/Param.md b/docx/actions/control/Param.md new file mode 100644 index 0000000..b97d47d --- /dev/null +++ b/docx/actions/control/Param.md @@ -0,0 +1,29 @@ +# 参数 +用于获取由父动作传入子动作的数据。例如，在迭代动作的子动作中添加该动作，便可获取被迭代的每个元素值。 + +![Param](./images/2022-11-17_184608.png ':size=90%') + +## 子流程 + +> 不支持 + +## 运行参数 + + + + +## 输出 + +> 无 + + +## 脚本调用 + +```python +import simple + + +``` + +## 示例 + diff --git a/docx/actions/control/ParamGet.md b/docx/actions/control/ParamGet.md deleted file mode 100644 index 286eb9e..0000000 --- a/docx/actions/control/ParamGet.md +++ /dev/null @@ -1,29 +0,0 @@ -# 参数获取 -通常做为子动作，其值由相应的父动作传入。例如在返回列表的子动作中添加该动作，则列表的每个元素都会传递给该动作。 - -![action](./images/2022-11-17_184608.png ':size=90%') - -## 子流程 - -> 不支持 - -## 运行参数 - - - - -## 输出 - -> 无 - - -## 脚本调用 - -```python -import simple - - -``` - -## 示例 - diff --git a/docx/actions/network/NetworkConnect.md b/docx/actions/network/NetworkConnect.md new file mode 100644 index 0000000..ac925ac --- /dev/null +++ b/docx/actions/network/NetworkConnect.md @@ -0,0 +1,35 @@ +# 服务连接 +连接网络服务端。 + +* *UDP* 是无连接协议，因此 基于*UDP* 协议的网络，可以直接发送或者接收数据。 + +![NetworkConnect](./images/07.png ':size=90%') + +## 子流程 +> 不支持 + +## 运行参数 + + +* 主机 +> 服务器地址，通常包含 *IP* 和端口。参考：[HostAddress](../types/HostAddress.md) + +* 类型 +> 网络协议。 + +## 输出 +> 套接字，可用于读取或者发送数据，*UDP*协议，参考：[UDPSocket](../types/UDPSocket.md)。*TCP*协议，参考：[TCPSocket](../types/TCPSocket.md)。 + +## 脚本调用 + +```python +import simple; + +``` + +### 示例 + +*TCP*示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple +*UDP* 示例： https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple + + diff --git a/docx/actions/network/NetworkListen.md b/docx/actions/network/NetworkListen.md new file mode 100644 index 0000000..f16762e --- /dev/null +++ b/docx/actions/network/NetworkListen.md @@ -0,0 +1,34 @@ +# 网络服务 +创建一个网络服务端。 + +* *UDP* 是无连接协议，因此 基于*UDP* 协议的网络，直接发送或者接收数据即可，无需监听端口。 + +![NetworkListen](./images/01.png ':size=90%') + +## 子动作 +> 不支持，客户端连接的 *套接字* 会传入子流程中。如果是 *UDP*, 传递参数：[UDPSocket](../types/UDPSocket.md)。如果是*TCP*, 传递参数： [TCPSocket](../types/TCPSocket.md) + +## 运行参数 + + +* 端口 +> 监听的主机地址，通常包含 *IP* 地址和端口，*IP* 地址可空。参考：[HostAddress](../types/HostAddress.md) +* 类型 +> 网络协议，支持 *TCP* 或者 *UDP* 协议。 + +## 输出 + +> 如果是 *TCP* 协议，返回[TcpServer](../types/TcpServer.md) ，如果是*UDP*协议，返回 [UDPSocket](../types/UDPSocket.md)。 + +### 脚本调用 + +```python +import simple; + +``` + +### 资源 + +*TCP*示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple +*UDP* 示例： https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple + diff --git a/docx/actions/network/NetworkReceive.md b/docx/actions/network/NetworkReceive.md new file mode 100644 index 0000000..5fe35f3 --- /dev/null +++ b/docx/actions/network/NetworkReceive.md @@ -0,0 +1,32 @@ +# 数据接收 +接收网络数据。 + +![NetworkReceive](./images/05.png ':size=90%') + +## 子流程 +> 不支持 + +## 运行参数 + +* 主机 + +> 如果是 *TCP* 协议，该参数类型为：[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议，该参数是主机地址，参考：[主机地址](../types/HostAddress.md)或者 [UDPSocket](../types/UDPSocket.md) + + +## 输出 + +> 收到的数据，参考：[字符串](../types/String.md)。 + + +## 脚本调用 + +```python +import simple; + +``` + +## 示例 + +*TCP*示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple +*UDP* 示例： https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple + diff --git a/docx/actions/network/NetworkSend.md b/docx/actions/network/NetworkSend.md new file mode 100644 index 0000000..7efd44d --- /dev/null +++ b/docx/actions/network/NetworkSend.md @@ -0,0 +1,33 @@ +# 数据发送 +通过网络，发送数据。 + +![NetworkSend](./images/03.png ':size=90%') + +## 子流程 +> 不支持 + +## 运行参数 + +* 主机 +>> 如果是 *TCP* 协议，该参数类型为：[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议，该参数是主机地址，参考：[主机地址](../types/HostAddress.md)或者 [UDPSocket](../types/UDPSocket.md) + +* 数据 +> 发送的数据。该数据会被序列化成[字符串](../types/String.md)发送。 + +## 输出 + +> 如果是 *TCP* 协议，该动作返回：[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议，该动作返回： [UDPSocket](../types/UDPSocket.md) + +### 脚本调用 + +```python +import simple; + +``` + +### 示例 + +*TCP*示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple +*UDP* 示例： https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple + + diff --git a/docx/actions/network/TcpConnect.md b/docx/actions/network/TcpConnect.md deleted file mode 100644 index 48b305b..0000000 --- a/docx/actions/network/TcpConnect.md +++ /dev/null @@ -1,37 +0,0 @@ -# 服务连接 -连接网络服务端。 - -* *UDP* 是无连接协议，因此 基于*UDP* 协议的网络，直接发送或者接收数据即可，无需连接服务。 - -![action](./images/07.png ':size=90%') - -## 子流程 -> 不支持 - -## 运行参数 - - -* 主机 -> 服务器 IP 地址。 - -* 端口 -> 远程端口 - -* 类型 -> 网络协议，`TCP`。 - -## 输出 -> 套接字，可用于读取或者发送数据，参考：[Socket](../types/Socket.md)。 - -## 脚本调用 - -```python -import simple; - -``` - -### 示例 - -示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple - - diff --git a/docx/actions/network/TcpListen.md b/docx/actions/network/TcpListen.md deleted file mode 100644 index d344841..0000000 --- a/docx/actions/network/TcpListen.md +++ /dev/null @@ -1,33 +0,0 @@ -# 端口监听 -创建一个网络服务端。 - -* *UDP* 是无连接协议，因此 基于*UDP* 协议的网络，直接发送或者接收数据即可，无需监听端口。 - -![TcpListen](./images/01.png ':size=90%') - -## 子动作 -> 不支持，客户端连接的 *套接字*会传入子流程中。 - -## 运行参数 - - -* 端口 -> 监听的本地端口 -* 类型 -> 网络协议，支持 `TCP`协议。 - -## 输出 - -> 参考[IOContext](../types/IOContext.md)。 - -### 脚本调用 - -```python -import simple; - -``` - -### 资源 - -示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple - diff --git a/docx/actions/network/TcpReceive.md b/docx/actions/network/TcpReceive.md deleted file mode 100644 index bdcb993..0000000 --- a/docx/actions/network/TcpReceive.md +++ /dev/null @@ -1,31 +0,0 @@ -# 数据接收 -接收网络数据。 - -![action](./images/05.png ':size=90%') - -## 子流程 -> 不支持 - -## 运行参数 - -* 主机 - -> 如果是 *TCP* 协议， 参考 [`TcpListen`(监听)](../actions/network/TcpListen.md) 动作的子动作获取, 或者由[`TcpConnect`(连接)](../actions/network/TcpConnect.md)动作获取。如果是*UDP* 协议，该参数是主机地址，参考：[主机地址](../types/ScocketAddress.md)。 - - -## 输出 - -> 收到的数据，参考：[字符串](../types/String.md)。 - - -## 脚本调用 - -```python -import simple; - -``` - -## 示例 - -示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple - diff --git a/docx/actions/network/TcpSend.md b/docx/actions/network/TcpSend.md deleted file mode 100644 index 558c9c3..0000000 --- a/docx/actions/network/TcpSend.md +++ /dev/null @@ -1,33 +0,0 @@ -# 数据发送 -通过网络，发送数据。 - -![action](./images/03.png ':size=90%') - -## 子流程 -> 不支持 - -## 运行参数 - - - -* 主机 ->> 如果是 *TCP* 协议， 参考 [`TcpListen`(监听)](../actions/network/TcpListen.md) 动作的子动作获取, 或者由[`TcpConnect`(连接)](../actions/network/TcpConnect.md)动作获取。如果是*UDP* 协议，该参数是主机地址，参考：[主机地址](../types/ScocketAddress.md)。 - -* 数据 -> 发送的数据。该数据会被序列化成[字符串](../types/String.md)发送。 - -## 输出 - -> 无 - -### 脚本调用 - -```python -import simple; - -``` - -### 示例 - -示例： https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple - diff --git a/docx/actions/network/YoutubeDownload.md b/docx/actions/network/VideoDownload.md similarity index 61% rename from docx/actions/network/YoutubeDownload.md rename to docx/actions/network/VideoDownload.md index 72c4993..865800a 100644 --- a/docx/actions/network/YoutubeDownload.md +++ b/docx/actions/network/VideoDownload.md @@ -1,5 +1,5 @@ # 视频下载 -只支持 *Youtube* 视频下载，中国用户需要能访问 *Youtube* 的代理网络。 +通过提供想要下载视频的 *URL* ，下载相应的视频文件。 ## 子流程 > 不支持 @@ -8,7 +8,7 @@ ## 运行参数 * 网址 -> 视频链接 +> 视频链接。 * 音频 > 在预览环境时，只输出音频资源。 @@ -19,7 +19,7 @@ > 下载的视频保存的文件夹。 ## 输出 -> 下载的视频路径，参考：[Path](../types/Path.md) +> 保存到本地的视频路径，参考：[Path](../types/Path.md) @@ -30,4 +30,7 @@ import simple; ``` -## 资源 \ No newline at end of file +## 资源 + + +!> 目前版本只支持 *Youtube*视频下载，中国用户需要能访问 *Youtube* 的代理网络。 \ No newline at end of file diff --git a/docx/types/HostAddress.md b/docx/types/HostAddress.md new file mode 100644 index 0000000..da81b91 --- /dev/null +++ b/docx/types/HostAddress.md @@ -0,0 +1,3 @@ +# HostAddress + +Class `HostAddress`， 代表 Internet（IP）端点/套接字地址。该地址可以属于IPv4或IPv6地址家族，由主机地址和端口号组成。 \ No newline at end of file diff --git a/docx/types/SocketAddress.md b/docx/types/SocketAddress.md deleted file mode 100644 index 76601f5..0000000 --- a/docx/types/SocketAddress.md +++ /dev/null @@ -1,3 +0,0 @@ -# SocketAddress - -Class `SocketAddress`， 代表 Internet（IP）端点/套接字地址。该地址可以属于IPv4或IPv6地址家族，由主机地址和端口号组成。 \ No newline at end of file diff --git a/docx/types/TCPServer.md b/docx/types/TCPServer.md new file mode 100644 index 0000000..63cce3e --- /dev/null +++ b/docx/types/TCPServer.md @@ -0,0 +1 @@ +# TCPServer \ No newline at end of file diff --git a/docx/types/TCPSocket.md b/docx/types/TCPSocket.md new file mode 100644 index 0000000..2f81abb --- /dev/null +++ b/docx/types/TCPSocket.md @@ -0,0 +1 @@ +# TCPSocket \ No newline at end of file diff --git a/docx/types/UDPSocket.md b/docx/types/UDPSocket.md new file mode 100644 index 0000000..88b74ef --- /dev/null +++ b/docx/types/UDPSocket.md @@ -0,0 +1 @@ +# UDPSocket \ No newline at end of file