# 千手揽月

**Repository Path**: jidongding/QshouLyue

## Basic Information

- **Project Name**: 千手揽月
- **Description**: 【千手揽月】意为上千双手去做一些壮丽的事情，实为单人单电脑可自动手动控制千台手机去执行任务。简单，节能，快速，安全，稳定，精准，便利，这些并不是梦想，而是已经实现，相比同行业已经做到最好。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://space.bilibili.com/651338118
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 1
- **Created**: 2025-12-05
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: scrcpy投屏, 远程投屏, 游戏脚本, 群控真机, python脚本

## README

# 简介



【千手揽月】意为上千双手去做一些壮丽的事情，实为单人单电脑可自动手动控制千台手机去执行任务。应用场景为游戏工作室（MMORPG大型网游，棋牌游戏），纯竞技游戏不参与。



# 架构

scrcpy拥有最强的眼和手，python拥有最强的大脑，把scrcpy和python组装起来就是机器人再加一个web服务器来提供远程服务就是【千手揽月】



# 安全

无法律风险，因为用的是图文色识别

无封号风险，因为真人接口和模拟真人

执行动作使用的是真人接口，非root，非无障碍，非adb，是scrcpyServer，而scrcpyServer使用的是真人接口。

如果app厂商给您要权限，当你授权之后，提示不能开启开发者模式，这个问题也不要担心，因为手机是您自己的，您的权限大于app厂商的权限，您有很多办法可以绕过，千手揽月也集成了这方面的操作。



# 节能

手动自动中控三大模块共用缓冲区，传统方式，投屏软件是某一人开发，自动框架是某一人开发，中控是某一人开发，这三个人互相不认识，没有配合，谁开发都新开辟一条路线，就像北京到上海，三个人开三个车去，而【千手揽月】是三个人开一个车，所以能节省硬件资源消耗。节能很重要，它可以减少您设备购买的费用和电费的支出，最重要的是它还能保证您程序不出现崩溃现象。



# 简单

千手揽月做的是减法，一切非必要增加您学习成本的东西全部排除掉，不会让您看见，用最原始，简单，容易理解和人们习惯性的方式来解决问题。



千手揽月设计特征1，绿色0污染

手机端：不需要安装任何app，也没有任何弹窗需要您给授权，就像手机不存在一样。

电脑端：下载解压双击即可使用，右键点击删除就能彻底删除干净。



千手揽月设计特征2，用最低学习成本来解决问题

手动：甚至不用学习，仅凭自己的本能就能完成控制。

自动：眼睛只有4个接口，手只有6个接口，而大脑，只会用到python的if，循环，函数，变量，逻辑表达式，只用这几个就够了。



# 稳定

有些框架长时间运行，在脚本没有错误的情况程序也会崩溃，原因是手机是ARM框架(以省电为目的)加上干的活太多导致资源不够用崩溃。而【千手揽月】将传统使用手机算力的方式，改为了使用电脑算力(x64框架高性能)加上电脑本来就空闲着。这就像一个成年人和一个小孩同时工作，传统方式是小孩干的活太多，而大人在空闲着，【千手揽月】将小孩的大部工作交给了大人来做，这样更合理。



# 便利

三大模块，自动，手动，中控全部支持远程控制。远程使用的好处是，不管你有多少台设备，只需要一台电脑就能全部控制，无需远程桌面，就像从baidu.com切换到qq.com一样简单。



# 精准

图色识别使用的是最原始的算法，所以现在和以后都不存在比最原始算法精准的方案，而ocr识别使用的是rapidOcr(优化后的paddleOcr)是当前精准+节能最好方案。



# 快速

开发速度快：是因为用人们习惯的方式解决问题，不搞创新，尊重您以前的经验，来到我这里积累的经验到其他地方也继续使用。

执行速度快：是因为核心代码全部是用C语言二进制来执行的，此为执行速度最快的方案。





# 注意

不能跨分辨率和dpi，最好开发时用什么型号手机执行时也用相同型号的，现在很多可以跨分辨率DPI的算法，我都帮您试过了，太费资源而且不可靠，如果您不信，您可以试一下网易的airtest，干粗活可以，细活干不了的，当然它主要做测试用的，而游戏的自动完成任务并且出现意外情况能自我修复属于细活，所以最终采用了原始的算法。





# 软件截屏



常用界面gif



![输入图片说明](self/gif.gif)



选择脚本并顺序执行



![输入图片说明](self/%E8%84%9A%E6%9C%AC%E9%80%89%E6%8B%A9.png)



远程投屏



![输入图片说明](self/%E8%BF%9C%E7%A8%8B%E6%8A%95%E5%B1%8F.jpg)



本地投屏



![输入图片说明](self/%E6%9C%AC%E5%9C%B0%E6%8A%95%E5%B1%8F.jpg)



自带代码编写工具



![输入图片说明](self/%E8%87%AA%E5%B8%A6%E8%84%9A%E6%9C%AC%E7%BC%96%E8%BE%91.png)



图色坐标工具



![输入图片说明](self/%E5%9B%BE%E8%89%B2%E5%9D%90%E6%A0%87%E5%B7%A5%E5%85%B7.png)



脚本文档



![输入图片说明](self/%E5%9C%A8%E7%BA%BF%E6%96%87%E6%A1%A3.png)



使用notepad next进行脚本编写



![输入图片说明](self/notepad%20next%E5%BC%80%E5%8F%91%E6%96%97%E5%9C%B0%E4%B8%BB%E8%AE%B0%E7%89%8C%E5%99%A8.png)



指针系统：如果自己不想写脚本，那么您只需要一个工程id，指向哪个工程就可以执行哪个工程代码，不需下载安装等繁琐步骤。



![输入图片说明](self/%E6%8C%87%E9%92%88%E7%B3%BB%E7%BB%9F.png)



# 费用

一台电脑控制两台手机是永久免费使用的，如果想一台电脑控制超过两台手机是收费的，一般一台电脑能控制50个手机，授权50个手机一年的费用是100元，如果您电脑配置高能控制100个手机，一年费用是120元。交钱一定要注意，要先拿到卡密激活之后再给钱。



# 更新



（1）：每次更新要清理浏览器缓存，浏览器缓存默认保留30天， 否则后端更新前端没有更新会出现程序错误。

（2）：如果框架里面没有自己重要的东西，直接删除，再下载就可以，这种方式最简单

（3）：如果框架里面有自己的东西，把下载下来的文件覆盖原来的文件即可，但这种方式可能会残留一些没用的文件，最好的方式是，将原来self目录和env/proj/db/work目录直接复制到新的项目中。



# 诚邀原始合伙人

https://env-00jxh1ahkbe6-static.normal.cloudstatic.cn/other/team.html



# 资源导航

https://env-00jxh1ahkbe6-static.normal.cloudstatic.cn/other/123.html