update

shelllet · Dec 9, 2024 · 3287cd8 · 3287cd8
1 parent 5737940
commit 3287cd8
Show file tree

Hide file tree

Showing 18 changed files with 217 additions and 19 deletions.
diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md
@@ -1,4 +1,15 @@
-# [0.40.1](https://github.com/shelllet/winui/compare/main...dev) (2024-11-06)
+# [0.41.0](https://github.com/shelllet/winui/compare/main...dev) (2024-12-14)
+
+### Changed：
+1. 修复一些问题。
+2. 添加内存读写动作：[ReadMemory](./actions/system/ReadMemory.md)、[WriteMemory](./actions/system/WriteMemory.md)、`DLL`注入：[AttachProcess](./actions/system/AttachProcess.md)。
+
+### Note
+
+1. 使用管理员权限运行 *winui++*, 无法显示 *动作* 的拖动效果（已知问题）。
+2. 64位下载(x64)：https://bitbucket.org/winui-release/version/downloads/winui0.41.0-setup.x64.exe
+
+## [0.40.1](https://github.com/shelllet/winui/compare/main...dev) (2024-11-06)
 
 ### Changed：
 1. 修复动作参数数字无法输入问题。

diff --git a/docx/_sidebar.md b/docx/_sidebar.md
@@ -35,6 +35,9 @@
       - [输出文本](./actions/system/OutputString.md)
       - [创建对象](./actions/system/CreateObject.md)
       - [调用方法](./actions/system/CallMethod.md)
+      - [读内存](./actions/system/ReadMemory.md)
+      - [写内存](./actions/system/WriteMemory.md)
+      - [附加进程](./actions/system/AttachProcess.md)
     - 异步操作
       - [定时器](./actions/async/WorkTimer.md)
       - [定时任务](./actions/async/WorkTask.md)
@@ -73,6 +76,7 @@
       - [监听鼠标](./actions/mouse/ListenMouse.md)
       - [偏移移动](./actions/mouse/MoveOffset.md)
       - [点击*网格](./actions/mouse/CellClick.md)
+      - [移动*网格](./actions/mouse/CellMove.md)
       - [滚动鼠标](./actions/mouse/WheelMouse.md)
     - 窗口
       - [查找窗口](./actions/window/FindWindow.md)
@@ -260,6 +264,7 @@
       - [颜色](./actions/type/TypeColor.md)
       - [模型](./actions/type/TypeModel.md)
       - [相机](./actions/type/TypeCamera.md)
+      - [指针](./actions/type/TypePtr.md)
   - 内置类型
     - [Boolean](./types/Boolean.md)
     - [Number](./types/Number.md)
@@ -269,22 +274,24 @@
     - [Rect](./types/Rect.md)
     - [Scalar](./types/Scalar.md)
     - [Color](./types/Color.md)
+    - [Bytes](./types/Bytes.md)
     - [RotatedRect](./types/RotatedRect.md)
     - [DetectionResult](./types/DetectionResult.md)
     - [ClassificationResult](./types/ClassificationResult.md)
     - [RecognitionResult](./types/RecognitionResult.md)
     - [File](./types/File.md)
-    - [图像](./types/Image.md)
+    - [Image](./types/Image.md)
     - [Size](./types/Size.md)
     - [Url](./types/Url.md)
     - [Wnd](./types/Wnd.md)
     - [ModelSession](./types/ModelSession.md)
     - [WebDriver](./types/WebDriver.md)
     - [Timer](./types/Timer.md)
-    - [线程](./types/Thread.md)
-    - [键盘](./types/Keyboard.md)
-    - [主机地址](./types/HostAddress.md)
-    - [元组](./types/Tuple.md)
+    - [Thread](./types/Thread.md)
+    - [Keyboard](./types/Keyboard.md)
+    - [HostAddress](./types/HostAddress.md)
+    - [Tuple](./types/Tuple.md)
+    - [Ptr](./types/Ptr.md)
   - 枚举类型
     - [Colors](./enums/Colors.md)
     - [Directions](./enums/Directions.md)

diff --git a/docx/actions/algorithm/FilterVertex.md b/docx/actions/algorithm/FilterVertex.md
@@ -26,3 +26,8 @@
 ## 其它
 
 示例：https://github.com/shelllet/WinUi/blob/main/algorithm/FilterVertex.simple
+
+
+<iframe type="text/html" height="640px" src="https://www.youtube.com/embed/GmHh7nh0IIA" frameborder="0"></iframe>
+
+<iframe src="//player.bilibili.com/player.html?bvid=BV1y8D5YjEeN&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
diff --git a/docx/actions/algorithm/RandomNumber.md b/docx/actions/algorithm/RandomNumber.md
@@ -30,4 +30,9 @@ import random
 random.randint(1, 100)
 
 ````
+
+<iframe type="text/html" height="640px" src="https://www.youtube.com/embed/NyjylgNUUfI" frameborder="0"></iframe>
+
+<iframe src="//player.bilibili.com/player.html?bvid=BV13mD9YMEck&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
 !> 该动作被执行之后就会生成确定的随机数。所有引用该动作的运行参数，都会使用相同的随机数。
diff --git a/docx/actions/algorithm/RandomPoint.md b/docx/actions/algorithm/RandomPoint.md
@@ -23,5 +23,8 @@
 
 示例：https://github.com/shelllet/WinUi/blob/main/algorithm/RandomPoint.simple
 
+<iframe type="text/html" height="640px" src="https://www.youtube.com/embed/eQcM_83P-0E" frameborder="0"></iframe>
+
+<iframe src="//player.bilibili.com/player.html?bvid=BV1HKm1YWEys&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
 
 !> 该动作被执行之后就会生成确定的随机坐标。其他所有引用该动作的运行参数,都会使用相同的随机坐标。
diff --git a/docx/actions/mouse/CellClick.md b/docx/actions/mouse/CellClick.md
@@ -15,10 +15,16 @@
 >
 * 行数
 > 风格行数
+
 * 列数
 > 网格列数
+
 * 半径
 > 以单元格中心为圆心，该参数为半径，动态计算最终的目标位置。该参数不要超过单元格长宽中的最小值。
+
+* 停顿
+> 移动至下个单元格的停顿时间。
+
 * 点击键
 > 鼠标键，参考：[MouseButtons](./enums/MouseButtons.md)
 
@@ -31,6 +37,6 @@
 
 * 流程：https://github.com/shelllet/WinUi/blob/main/mouse/CellClick.simple
 
-<!-- <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/LBktoepioXw" frameborder="0"></iframe>
+<iframe type="text/html" height="640px" src="https://www.youtube.com/embed/XZEoeA6loWg" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1NF411k7Un&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe> -->
+<iframe src="//player.bilibili.com/player.html?bvid=BV1WEDQYJE4q&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
diff --git a/docx/actions/mouse/CellMove.md b/docx/actions/mouse/CellMove.md
@@ -0,0 +1,36 @@
+# 移动 * 网格 
+在桌面虚拟一个网格，依次移动鼠标至网格中的每个单元格，并调用自定义的子流程。需要配合 [移动鼠标](./actions/mouse/MovePointer.md)动作，移动鼠标至网格左上角第一个单格中心位置。
+
+![CellMove](./images/12.png ':size=90%')
+
+## 子流程
+> 支持，当前鼠标位置传入子流程。
+
+
+## 运行参数
+
+* 单元格宽度
+> 
+* 单元格高度
+>
+* 行数
+> 风格行数
+
+* 列数
+> 网格列数
+
+* 半径
+> 以单元格中心为圆心，该参数为半径，动态计算最终的目标位置。该参数不要超过单元格长宽中的最小值。
+
+
+## 输出
+
+>   无    
+
+## 资源
+
+* 流程：https://github.com/shelllet/WinUi/blob/main/mouse/CellMove.simple
+
+<!-- <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/LBktoepioXw" frameborder="0"></iframe>
+
+<iframe src="//player.bilibili.com/player.html?bvid=BV1NF411k7Un&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe> -->
diff --git a/docx/actions/mouse/images/12.png b/docx/actions/mouse/images/12.png
diff --git a/docx/actions/system/AttachProcess.md b/docx/actions/system/AttachProcess.md
@@ -0,0 +1,30 @@
+# 代码注入
+
+创建一个进程，在进程启动的时候附加一个动态链接库。这个动作可以把动态库加载到进程的运行空间，也可以称作`DLL`注入。
+
+![AttachProcess](./images/19.png ':size=90%')
+
+## 权限
+> 无要求
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+
+* 进程
+> 进程的路径，`Windows` 系统同名进程可以有多个，可以用进程全路径区分。
+
+* 动态库
+> 要附加的动态链接库。注意适配`32`位或者`64`位可执行程序。
+
+## 输出
+
+>    无
+
+
+## 资源
+
+* 示例流程：https://github.com/shelllet/WinUi/blob/main/system/AttachProcess.simple
+
diff --git a/docx/actions/system/ReadMemory.md b/docx/actions/system/ReadMemory.md
@@ -0,0 +1,31 @@
+# 读取内存 
+
+读取指定进程地址范围内的数据。
+
+![ReadMemory](./images/18.png ':size=90%')
+
+## 权限
+> 无要求
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+* 进程
+> 进程的路径，`Windows` 系统同名进程可以有多个，可以用进程全路径来区分。
+
+* 地址
+> 用户空间的内存地址。
+
+* 长度
+> 读取的数据长度。
+
+## 输出
+
+>   内存数据，参考：[字节序列](./types/Bytes.md)。
+
+## 资源
+
+* 示例流程：https://github.com/shelllet/WinUi/blob/main/system/ReadMemory.simple
+
diff --git a/docx/actions/system/Wait.md b/docx/actions/system/Wait.md
@@ -19,16 +19,6 @@
 
 >    无
 
-## 脚本调用
-
-```python
-import simple
-
-w = simple.WaitRunner(3) # sleep 3s
-# w.duration = 3
-w.run()
-```
-
 ## 资源
 
 * 示例流程：https://github.com/shelllet/WinUi/blob/main/system/Wait.simple

diff --git a/docx/actions/system/WriteMemory.md b/docx/actions/system/WriteMemory.md
@@ -0,0 +1,33 @@
+# 写内存
+
+在进程指定的内存地址处写入数据。
+
+![WriteMemory](./images/17.png ':size=90%')
+
+## 权限
+> 无要求
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+
+* 进程
+> 进程的路径，`Windows` 系统同名进程可以有多个，可以用进程全路径区分。
+
+
+* 地址
+> 用户空间的内存地址。
+
+* 数据
+> 写入的数据。如果写入字节序列，请使用：[Bytes](./types/Bytes.md)，创建字节序列。
+
+## 输出
+
+>    无
+
+
+## 资源
+
+* 示例流程：https://github.com/shelllet/WinUi/blob/main/system/Wait.simple
diff --git a/docx/actions/system/images/17.png b/docx/actions/system/images/17.png
diff --git a/docx/actions/system/images/18.png b/docx/actions/system/images/18.png
diff --git a/docx/actions/system/images/19.png b/docx/actions/system/images/19.png
diff --git a/docx/actions/type/TypePtr.md b/docx/actions/type/TypePtr.md
@@ -0,0 +1,29 @@
+# Ptr 
+定义一个 *Ptr* 类型，用来表示内存地址，也可称为指针。
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 值
+
+> 使用字符串或者十六进制官字行串表示一个内存地址，例如：`0x014B30A8`。
+
+
+## 输出
+
+> 指针    
+
+
+## 脚本调用
+
+```python
+import simple;
+
+ptr = simple.Ptr(0x014B30A8)
+
+```
+
+## 示例
diff --git a/docx/enums/MouseButtons.md b/docx/enums/MouseButtons.md
@@ -1 +1,10 @@
-# MouseButtons
+# MouseButtons
+
+* Left
+> 鼠标左键
+* Middle
+> 鼠标中键
+* Right
+> 鼠标右键
+* XButton
+> 鼠标侧键
diff --git a/docx/types/Bytes.md b/docx/types/Bytes.md
@@ -0,0 +1,3 @@
+# Bytes
+
+Class `Bytes`. 字节序列。