# yys **Repository Path**: JiuSi-T/yys ## Basic Information - **Project Name**: yys - **Description**: 阴阳师自动化工具，开发的初衷是帮助痒痒鼠们解放用户双手，提升游戏养成效率 - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2026-03-17 - **Last Updated**: 2026-05-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 项目介绍 本项目是一款专为网易手游《阴阳师》开发的 PC 端自动化挂机工具，其核心定位在于通过技术手段解决游戏玩家在养成过程中面临的重复性操作痛点。项目开发的初衷是**解放用户双手，提升游戏养成效率**，通过连接安卓模拟器实现游戏内重复操作的自动执行，覆盖业原火爬塔、御魂刷图、狗粮升级、日常任务等全场景自动化操作，让玩家能够从机械性的重复劳动中解脱出来。 ⚖️ 使用声明 本软件仅供学习交流，禁止用于商业用途 - 演示安卓自动化测试技术原理 - 研究图像识别在游戏辅助领域的应用 - 个人本地设备调试与功能验证 使用本软件产生的一切后果由用户自行承担！ ![image-20260329000045831](./assets/image-20260329000045831.png) 欢迎使用本项目！详细使用方法请查看： 📖 [使用手册](./doc/使用手册.md) ## 使用协议 1. 软件性质 本软件为开源技术演示项目，用于展示ADB调试、计算机视觉识别等技术的综合应用。 2. 使用限制 - 仅供本地个人设备学习研究 - 不得用于商业盈利或代练服务 - 不得二次分发或修改后传播 3. 知识产权 本软件不修改游戏内存、不破解游戏协议、不拦截网络数据，仅通过模拟用户点击操作实现功能。 游戏版权归网易公司所有。 4. 免责条款 用户明确知悉： - 使用第三方辅助工具可能违反游戏用户协议 - 可能导致账号受到警告/限制/封禁等处罚 - 开发者不对任何后果承担责任 5. 合规承诺 如软件涉及的技术实现被认定为侵权，开发者承诺： - 立即下架相关功能 - 配合平台删除全部分发渠道 - 提供完整技术说明以协助界定责任 ## 架构 ### 架构设计 项目采用**前后端分离的桌面应用架构**，结合Wails框架实现Go后端与Vue3前端的无缝集成，同时引入Python作为自动化任务处理引擎。整体架构分为三层： ```mermaid graph TD A[Vue3 前端界面] --> B[Wails 运行时环境] C[Go 后端服务] --> B D[Python 自动化引擎] --> C B --> E[安卓模拟器/设备] subgraph 前端功能 A1[操作界面展示] A2[状态监控面板] A3[配置管理界面] end subgraph 后端功能 C1[进程管理] C2[前后端通信] C3[日志系统] end subgraph 自动化功能 D1[图像识别] D2[ADB 命令执行] D3[任务调度] end A --> A1 & A2 & A3 C --> C1 & C2 & C3 D --> D1 & D2 & D3 ``` ``` ┌─────────────────┐ ┌─────────────────┐ ┌──────────────────┐ │ Vue3 前端界面 │ │ Go 后端服务 │ │ Python 自动化引擎 │ │ │ │ │ │ │ │ - 操作界面展示 │ │ - 进程管理 │ │ - 图像识别 │ │ - 状态监控面板 │ │ - 前后端通信 │ │ - ADB 命令执行 │ │ - 配置管理界面 │ │ - 日志系统 │ │ - 任务调度 │ └─────────────────┘ └─────────────────┘ └───────────────────┘ │ │ │ ▼ ▼ ▼ ┌────────────────────────────────────────────────────────┐ │ Wails 运行时环境 │ │ │ │ - 前端资源打包与加载 │ │ - 跨语言调用桥接 │ │ - 系统API访问封装 │ └────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 安卓模拟器/设备 │ │ │ │ - 游戏界面渲染 │ │ - 输入事件响应 │ │ - 屏幕画面捕获 │ └─────────────────────────────────────────────────────────┘ ``` ### 技术架构 #### 前后端通信架构 ``` Vue3 前端 ──[Wails 桥接]─── Go 后端 ──[标准输入输出]─── Python 引擎 │ │ │ ▼ ▼ ▼ 事件驱动 进程管理 异步任务 ``` #### 自动化执行流程 ``` 用户操作 ──[前端]─── 任务配置 ──[Go 后端]─── 任务调度 ──[Python 引擎]─── ADB 命令 ──[模拟器]─── 游戏操作 │ │ │ │ ▼ ▼ ▼ ▼ 界面展示 状态监控 图像识别 屏幕反馈 ``` 优势： 1. **跨平台能力**：Wails框架支持Windows/macOS/Linux多平台编译，Python脚本和ADB工具也具备良好的跨平台兼容性 2. **性能优化**：Go语言提供高性能后端服务，Python专注于计算密集型任务，Vue3保证流畅的用户界面 3. **可扩展性**：模块化设计便于功能扩展，新增自动化任务只需添加对应的Python脚本和前端组件 4. **可维护性**：前后端分离架构降低代码耦合度，各模块职责清晰，便于团队协作开发 5. **安全性**：通过Wails沙箱环境限制前端权限，Python脚本运行在受控环境中，减少安全风险 ## 技术栈 | 分类 | 技术栈 | 占比 | | :----------- | :---------------------------------------- | :---- | | **前端** | Vue 3 + TypeScript | 26.2% | | **后端** | Go + Wails + Python | 57.6% | | **构建工具** | NSIS (Nullsoft Scriptable Install System) | 9.2% | | **其他** | 图像处理库、ADB 工具等 | 7.0% | ### 前端技术栈 1. **Vue 3**：采用组件化开发模式，结合 Composition API 实现高效的状态管理和逻辑复用 2. **TypeScript**：提供类型安全保障，提升代码可维护性和开发效率 3. **Wails**：作为 Go 语言的跨平台桌面应用开发框架，实现前端与后端的无缝通信 ### 后端技术栈 1. **Go 语言**：高性能后端服务开发，负责核心业务逻辑和系统调度 2. **Python**：主要用于图像处理、计算机视觉识别和自动化脚本 3. **ADB (Android Debug Bridge)** ：实现与安卓模拟器的通信，模拟用户操作 ### 技术实现 1. **自动化操作**：通过图像识别技术定位游戏界面元素，结合 ADB 模拟点击、滑动等操作 2. **跨平台支持**：Wails 框架支持 Windows/macOS/Linux 多平台编译，当前项目主要针对 Windows 优化 3. **模块化设计**：前后端分离架构，便于功能扩展和维护 ## 快速开始 本项目的打包与分发流程目前仅支持 Windows 平台，需依次完成虚拟环境配置、资源整合、可执行文件生成及安装程序打包四个核心步骤，以确保应用在不同环境中的一致性和可部署性。 环境要求： - Go 1.21+ - Node.js 15+ - Python 3.10+ - Wails 2.0+ ### 安装GO 确保您遵守官方的 [Go 安装说明](https://golang.org/doc/install#install)。 您还需要确保您的 `PATH` 环境变量包含您的 `~/go/bin` 目录路径。 重启终端并执行以下命令检查： - 检查 Go 是否安装正确： `go version` - 检查 "~/go/bin" 是否在您的 PATH 变量中： `echo $PATH | grep go/bin` ### 安装Node 从 [Node 下载页面](https://nodejs.org/en/download/) 下载 NPM。 最好使用最新版本，因为这是我们通常会测试的版本。 运行 `npm --version` 进行验证。 ### 安装Python [Python官网](https://www.python.org/)安装 - 检查 Python 是否安装正确： `Python --version` ### 安装 Wails 运行 `go install github.com/wailsapp/wails/v2/cmd/wails@latest` 安装 Wails CLI。 请检查您是否已安装 Go 1.18+ ``` go version ``` ### 系统检查 运行 wails doctor 将检查您是否安装了正确的依赖项。 如果没有，它会就缺少的内容提供建议以帮助纠正问题 如果您的系统报告缺少 `wails` 命令，请确保您已正确遵循 Go 安装指南。 通常，这意味着您的用户 home 目录中的 `go/bin` 目录不在 `PATH` 环境变量中。 通常情况下还需要关闭并重新打开任何已打开的命令提示符，以便安装程序对环境所做的更改反映在命令提示符中。 ### 打包 项目打包仅支持windows 依次执行如下命令（最终产物在项目根目录下build/bin目录下） ```python python3 -m venv .venv # 1.创建虚拟环境 .\.venv\Scripts\activate # 2.进入虚拟环境 pip install -r requirement.txt -i https://pypi.tuna.tsinghua.edu.cn/pypi/web/simple # 3.下载依赖 python build.py # 4.构建app ``` ## 常见问题 ### Q: 工具无法连接到模拟器怎么办？ A: 请检查： - 模拟器是否已开启ADB调试功能 - 工具配置的ADB端口是否与模拟器一致 - 是否有其他程序占用了ADB端口 ### Q: 图像识别准确率不高怎么办？ A: 可以尝试： - 调整模拟器分辨率为（1600x900） - 确保游戏界面语言为中文 - 更新图像识别模板库 ### Q: 使用工具会导致账号被封吗？ A: 本工具仅模拟正常用户操作，不会修改游戏内存或协议，但使用任何第三方辅助工具都存在一定风险，请谨慎使用。