update

docx/CHANGELOG.md

@@ -1,11 +1,12 @@
-# [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx)
+# [0.31](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx)
 
 ### Changed：
 
 1. *工作线程* 动作支持选择是否立即运行。
 2. *监听鼠标* 动作支持鼠标侧键。
 3. *For*（循环）动作名称变更为 *ForEach*（迭代）动作，功能不变。
-4. *IterParam*（迭代参数）动作名称变更为 *IterValue*（迭代数据）动作，并支持默认数据参数，功能不变。
+4. *IterParam*（迭代参数）动作名称变更为 *IterValue*（迭代数据）动作，并支持设置默认参数，功能不变。
+5. 增加 *StandardPath*（标准路径）动作，用来表示系统常用路径。
 
 ### Deprecated:
 

docx/_sidebar.md

@@ -117,11 +117,11 @@
       - [键盘/鼠标宏重放](./actions/media/PlayRecord.md)
       - [相机图像](./actions/media/VideoFrame.md)
     - 网络
-      - [下载](./actions/network/HttpDownload.md)
+      - [文件下载](./actions/network/HttpDownload.md)
       - [视频下载](./actions/network/YoutubeDownload.md)
-      - [Head](./actions/network/HttpHead.md)
-      - [Get](./actions/network/HttpGet.md)
-      - [Post](./actions/network/HttpPost.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)

docx/actions/filesystem/StandardPath.md

@@ -0,0 +1,26 @@
+# 标准路径 
+此操作包含在本地文件系统上查询标准路径位置的功能，例如特定于用户目录或系统范围的配置目录等常见任务。
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 类型
+
+> 参考：[KnownFolder](../enums/KnownFolder.md)
+
+## 输出
+
+> 路径，参考：[Path](../types/Path.md)。    
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 资源

docx/actions/method/SubString.md

@@ -0,0 +1,32 @@
+# 字符串提取 
+根据特定的方法，可以获取部分字符串。
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 数据
+
+> 字符串
+
+* 位置
+> 起始位置，如果是 *正值* 从左边开始，如果是 *负值*，从右边开始。
+
+* 长度
+> 提取的长度。
+
+## 输出
+
+> 部分字符串，参考：[String](../types/String.md)。    
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 资源

docx/actions/network/HttpDownload.md

@@ -1,4 +1,4 @@
-# 下载 
+# 文件下载 
 通过 *http/https* 协议下载网络文件。
 
 ![HttpDownload](./images/01.png ':size=90%')

docx/actions/network/HttpGet.md

@@ -1,19 +1,23 @@
-# Get 
-发送基于 *HTTP* 的*Get* 请求
+# GET 请求
+用于向服务器请求指定的资源，HTTP GET 请求应该只接收数据而不改变服务器的状态。
 
 ## 子流程
 > 不支持
 
 
 ## 运行参数
 
-* Url：网址
-
+* 网址
+> 可以在网址中直接包含查询字符串，如：`/test/demo.html?name1=value1&name2=value2`。
+* 标头
+> 在 HTTP GET 请求中传递 HTTP 标头，例如：`Accept: application/json`
 
+* 参数
+> 查询字符串（名称/值对），在 GET 请求的 URL 中发送：`/test/demo.html?name1=value1&name2=value2`，可选项。
 
 ## 输出
 
-
+> GET 方法返回的内容，参考字符串类型：[String](../types/String.md)    
 
 
 ## 脚本调用
@@ -23,4 +27,4 @@ import simple;
 
 ```
 
-## 示例
+## 资源

docx/actions/network/HttpHead.md

@@ -1,18 +1,17 @@
-# Head 
-发送基于 *HTTP* 的*Head* 请求
-
+# HEAD 请求
+使用 HTTP HEAD 方法从服务器请求 HTTP 标头，就像使用 HTTP GET 方法请求文档一样。HTTP HEAD 和 GET 请求之间的唯一区别是，对于 HTTP HEAD，服务器仅返回标头而不返回正文。
 ## 子流程
 > 不支持
 
 
 ## 运行参数
 
-* Url：网址
+* 网址
 
 
 ## 输出
 
-
+> 输出 *HEAD* 方法的返回内容，参考类型：[String](../types/String.md)     
 
 
 ## 脚本调用

docx/actions/network/HttpPost.md

@@ -1,19 +1,33 @@
 # Post 
-发送基于 *HTTP* 的*Post* 请求
+将数据通过 POST 方法发送至服务器用以创建/更新资源，请求主体的类型由 Content-Type 标头指示。该动作使用 超文本传输协议（HTTP/1.1）。
+
+例如：
+
+* application/x-www-form-urlencoded
+  > 这是默认的 Content-Type，键和值被编码在由 分隔的键值元组中 '&'，'='键和值之间有一个。非字母数字值使用百分比编码进行转义。
+* multipart/form-data
+  > 每个值都作为数据块（正文部分）发送，并用用户代理定义的分隔符（边界）分隔每个部分。
+
+* text/plain
+  > 消息体没有规定的格式，服务器需要进行相应的处理。
 
 ## 子流程
 > 不支持
 
 
 ## 运行参数
 
-* Url：网址
-* ContentType：数据类型
-* Content：数据
+* 网址
+> 
+* 数据类型
+>  Content-Type 如：`application/json`,要将 JSON 数据发布到服务器。
+* 数据
+> 如果  Content-Type 设置为`application/json`， 请求正文中提供 JSON 数据
+
 
 ## 输出
 
-
+> 请求返回的数据，字符串类型，参考：[String](../types/String.md)    
 
 
 ## 脚本调用
@@ -23,4 +37,7 @@ import simple;
 
 ```
 
-## 示例
+## 资源
+
+
+!>  [Python 3 HTTP/1.1 Server](https://gist.github.com/andystanton/2ec0dca0bf6de90c2000025319f63e2d)

docx/actions/network/YoutubeDownload.md

@@ -1,18 +1,25 @@
 # 视频下载 
-目前只支持 *Youtube* 视频下载，需要能访问 *Youtube* 的网络。
+只支持 *Youtube* 视频下载，中国用户需要能访问 *Youtube* 的代理网络。
 
 ## 子流程
 > 不支持
 
 
 ## 运行参数
 
-* Url：链接
-* Output：输出目录
+* 网址
+> 视频链接
+* 音频
+> 在预览环境时，只输出音频资源。
 
+* 标签
+> 下载的视频*itag*, 可以参考：[YouTube video stream format codes](https://gist.github.com/sidneys/7095afe4da4ae58694d128b1034e01e2)， 也可以通过动作预览，获取 *itag*。
+* 输出
 
-## 输出
+> 下载的视频保存的文件夹。
 
+## 输出
+> 下载的视频路径，参考：[Path](../types/Path.md)
     
 
 
@@ -23,4 +30,4 @@ import simple;
 
 ```
 
-## 示例
+## 资源

docx/actions/type/TypeDict.md

@@ -0,0 +1,22 @@
+# 字典 
+定义一个 `Dict`（字典） 类型。
+
+## 子流程
+> 支持
+
+## 运行参数
+
+
+## 输出
+
+> [`Dict`](./types/Dict.md)   
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 示例

docx/actions/type/TypeTuple.md

@@ -0,0 +1,27 @@
+# 字典 
+定义一个 `Tuple`（元组） 类型。
+
+## 子流程
+> 支持
+
+## 运行参数
+
+* 名称
+> 元组的第 1 个元素。
+
+* 数据
+> 元组的第 2 个元素。
+
+## 输出
+
+> [`Tuple`](./types/Tuple.md)   
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 示例

docx/enums/KnownFolder.md

@@ -0,0 +1,8 @@
+# KnownFolder
+
+* Downloads
+> 下载
+* Documents
+> 我的文档
+* LocalAppData
+> 

docx/types/Dict.md

@@ -0,0 +1 @@
+# Dict

docx/types/Tuple.md

@@ -0,0 +1 @@
+# Tuple