# auto-dog-execute
**Repository Path**: zozero/auto-dog-execute
## Basic Information
- **Project Name**: auto-dog-execute
- **Description**: 自动化小犬的四足和眼睛，它是执行端
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-04-03
- **Last Updated**: 2024-05-02
## Categories & Tags
**Categories**: Uncategorized
**Tags**: 自动化, 中文编程
## README
自动化小犬——执行端
你的手机模拟器是你的狗子，现在请让你狗子变得成熟吧！
## 功能
- 这是自动化小犬的执行端，你可以点击[这里](https://github.com/zozero/auto-dog)，前往自动化小犬用户界面。
- 它实现了对各种行为的执行，也实现了对寻找到骨头（坐标）的方法，项目核心。
- 它拥有强有力的四肢，并且它已经经过多次更新。
- 希望它能够对你生活有所帮助。
## 安装
### 方法一
这是最简单的方法，你只需要点击[百度网盘](https://pan.baidu.com/s/15aH6DApb4kxGmXWBqEEwXQ?pwd=r83e)下载`自动化小犬完整版.zip`文件就可以直接使用。
解压后双击运行`接入口.exe`，然后在双击运行`自动化小犬.exe`，最后打开你的模拟器。
由于打包限制，使得训练人工智能模型时只能使用单个gpu，并且多线程也被限制了。所以如果想要更快的训练那最好使用源码部署运行。
### 方法二
下载源代码
```bash
$ git clone https://github.com/zozero/auto-dog-execute.git
```
进入目录
```bash
$ cd auto-dog-execute
```
点击[这里](https://github.com/zozero/auto-dog-execute/releases)下载已经打包的exe文件。
将下载好的`auto-dog-execute-windows.exe`文件复制到`auto-dog-execute`目录中，然后双击运行。默认是本地的地址：`127.0.0.1:8888`。
下载列表中还有一个`auto-dog-execute-windows-unpack.zip`是未压缩版，启动速度会快上不少。
##### 额外
你可以打开cmd命令行，这样你可以添加两个参数，例如：`接入口.exe 127.0.0.1 8866`，其中第一个参数`127.0.0.1`是启动地址，第二个`8866`是端口。它们用空格隔开。
### 方法三
首先前往这里下载[python conda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/windows.html)，直接下载这个版本Anaconda Distribution installer for Windows
然后前往这里[下载编辑器](https://www.jetbrains.com/pycharm/download/?section=windows)，网页下面有社区版的下载地址，我们下载的是社区版，它已经足够用了。
下载源代码
```bash
$ git clone https://github.com/zozero/auto-dog-execute.git
```
安装依赖
```bash
$ cd auto-dog-execute
```
```bash
$ pip install -r requirements.txt
```
运行
```bash
$ uvicorn 接入口:快捷应用程序接口 --reload --port 8888
```
### 打包
打包成一个文件`pyinstaller --onefile 接入口.py`。
打包成多个文件`pyinstaller 打包.spec`。
打包出来的文件再`dist`目录下，它们需要复制到有`接入口.py`文件的目录下使用。
## 视频教程
[](https://www.bilibili.com/video/BV1jx4y1v7is/?vd_source=94eb18e525a1fa647feaa8beb70f4ba2 "视频 小犬")
## 文件说明
### 项目文件屋
里面存放了各个项目的文件。
每一个项目下面都有任务间、图片间、方法间、步骤间四个文件夹。
### 核心对象屋
里面包含了整个项目的精华内容。内容就不详细说明，有需要可以自行看看。
这里就不得不提一下[计算机可视化开源库（opencv）](https://docs.opencv.org/4.5.5/index.html)。很强大。
### [接入口.py](%BD%D3%C8%EB%BF%DA.py)
这个文件才是项目的入口。
拉到文件最下面，直接运行它。
当然你也可以使用unvicorn的命令来运行。
```bash
$ uvicorn 接入口:快捷应用程序接口 --reload --port 8888
```
## 代码说明
关于你只看一次（yolo）版本8，我直接使用了源码，由于项目需要经常性修改标签目录，而源码无法及时更新标签目录（有一些触发条件），可能导致训练时标签出错。
具体的修改地址是[utils.py](ultralytics/data/utils.py#L304-L307)
## 分享
你可以分享你的项目，你只需要复制`项目文件屋`目录的文件夹，整个目录复制到你的好友电脑里面，在放置到`项目文件屋`里面，就可以正常使用了。
## 注意
该项目只适合个人使用，因为它没有做任何权限管理，切勿将其暴露在公网当中，尽可能在局域网内使用它。
如果非要这么做，请务必在路由器管理界面中指定来源的ip地址或者媒体存取控制位址（mac地址），这样可以直接避免未知来源的电脑访问到你的程序。（请搜索“端口转发”相关的知识。）
如果你使用的是手机，最好找一台没有任何个人信息和财产的无用手机。
当前使用安卓开发者工具的截图速度很慢，这可能导致你无法在一些需要较快操作的测试中使用该项目。
## 赞助
## 许可证
许可证是特别的，你几乎可以无条件使用这个开源库。你可以在这里[查看](许可证)许可证。