一个仓库放多个互不干扰的 Python 脚本:共享一套运行时与命令入口,各自独立的代码、依赖分组、配置和资源。 目前包含:雷电模拟器(LDPlayer)批量自动化。
mise install # 按 mise.toml 装好 python 3.13 + uv
mise run setup # 创建 .venv 并安装依赖(= uv sync --extra ld)
mise run ld:check # 自检:加载依赖与配置,不做任何点击环境由 mise 管理(固定 Python 3.13),依赖由 uv 管理(
pyproject.toml+uv.lock)。 不再需要手动pip install,也不再依赖系统里的全局 Python。
| 内容 | 位置 | 由谁决定 |
|---|---|---|
| mise 本体 | D:\Program\mise\bin\mise.exe |
安装时选择 |
| mise 安装的运行时(python / uv / node / pnpm) | D:\Program\mise\installs\ |
MISE_DATA_DIR |
| mise 下载缓存 | D:\Program\mise\cache\ |
MISE_CACHE_DIR |
| uv 包缓存(wheel/sdist) | D:\Program\mise\cache\uv |
UV_CACHE_DIR |
| pip 包缓存 | D:\Program\mise\cache\pip |
PIP_CACHE_DIR |
| 本项目虚拟环境 | <仓库>\.venv |
项目内 |
| 系统 Python / 用户级包 | ❌ 不使用 | — |
以上四个 MISE_* / UV_* / PIP_* 变量都是用户级环境变量,改完需要重开终端或 IDE 才生效(已打开的窗口继承的是旧环境)。
双保险:部分程序(如某些 IDE/助手)是由旧进程派生的,重启也拿不到新的环境变量。因此额外在 C 盘建立了三个目录联接(junction),物理指向 D 盘:
| 联接路径 | 真实位置 |
|---|---|
%LOCALAPPDATA%\mise |
D:\Program\mise |
%LOCALAPPDATA%\uv |
D:\Program\mise\cache\uv |
%LOCALAPPDATA%\pip |
D:\Program\mise\cache\pip |
这样即便某个进程完全读不到环境变量、mise 退回默认目录,写进去的文件实际仍落在 D 盘(sys.executable 可能显示 C 盘路径,os.path.realpath() 会显示 D 盘真实路径)。
pyScript/
├── pyproject.toml 依赖登记处:基础依赖 + 按脚本分组的 optional-dependencies
├── uv.lock 锁定文件(必须提交)
├── mise.toml 运行时版本 + 所有命令入口(mise run <task>)
├── kit/ 跨脚本公共库:只放与业务无关的能力
│ ├── paths.py 仓库/脚本目录定位
│ ├── config.py JSON 配置读写
│ └── log.py 统一日志
├── tools/ 一个子目录 = 一个脚本(只放代码与资源)
│ ├── ld_emulator/ 雷电模拟器批量自动化
│ │ ├── __main__.py 入口:python -m tools.ld_emulator <动作>
│ │ ├── emulator.py 业务动作(create/start/backup/restore/...)
│ │ ├── common.py 键鼠 / 模板匹配 / 进程封装
│ │ ├── data.py 按钮名 → 图片文件名 映射
│ │ ├── backends/ 外部接口封装:ldconsole.py(官方命令行)
│ │ ├── adapters/ 可替换的底层库:screen(mss) / hotkey(pynput) / dialog(tkinter)
│ │ └── assets/image/ 模板图片(common/ 与 emulator/)
│ └── wb_reward/ WorkBuddy 积分签到(计划任务驱动)
│ ├── __main__.py 入口:python -m tools.wb_reward <动作>
│ └── runner.py 调用 workbuddy-reward-helper,含重试/互斥/日志轮转
├── config/ 所有脚本的配置集中在这里(详见 config/README.md)
│ ├── README.md 新电脑怎么配(先看这个)
│ ├── ld_emulator.json 雷电自动化的公共配置
│ └── wb_reward.json 积分签到的超时/重试/日志上限
│ └── *.local.json 本机私有覆盖(gitignore 忽略,不入库)
├── logs/ 所有脚本的运行日志,按脚本名分子目录(不入库)
│ └── wb_reward/ scheduler.log(执行过程)+ result.log(结果摘要)
├── scripts/
│ ├── new_tool.py 新脚本脚手架
│ └── release.sh 推送到 gitee / github
├── tests/
│ └── legacy/ 历史手工脚本(不参与 pytest)
├── docs/ 方案、规范与审查文档
├── script/ Windows 双击用的 bat
└── cache.txt 生成物(gitignore 忽略)
python scripts/new_tool.py my_tool # 生成 tools/my_tool/ 骨架然后三步:
- 登记依赖:在
pyproject.toml的[project.optional-dependencies]加分组(能复用已有组就别新建):[project.optional-dependencies] mytool = ["requests>=2.32"]
- 加命令入口:在
mise.toml里加 task:[tasks."my:run"] run = "uv run --extra mytool python -m tools.my_tool"
- 运行:
mise run my:run,或临时uv run --extra mytool python -m tools.my_tool。
详细规范见 docs/项目结构规范.md。
通过屏幕模板匹配(OpenCV)+ 鼠标模拟(pyautogui)操作 雷电多开器:批量创建/启动、批量设置分辨率与内存、批量安装 APK、开关同步、应用权限设置、备份/还原。
| 命令 | 说明 |
|---|---|
mise run ld:create |
批量创建 → 配置 → 启动 → 装包 → 同步 → 权限 → 关同步 |
mise run ld:start |
启动所有已停止的模拟器 |
mise run ld:info |
列出全部实例(index / 状态 / 分辨率 / 标题),只读 |
mise run ld:create-txt |
按配置生成 cache.txt |
mise run ld:backup |
按 ID 范围备份 |
mise run ld:restore |
按 ID 范围还原 |
mise run ld:quit-all |
关闭全部模拟器 |
mise run ld:check |
自检(只加载依赖与配置,不点击) |
mise run ld:gui |
强制走旧的纯图像 GUI 流程(回滚用) |
等价的底层写法:uv run --extra ld python -m tools.ld_emulator <动作> [--backend gui]
| 后端 | 覆盖范围 | 说明 |
|---|---|---|
cli(默认) |
11 个动作中的 10 个 | 走雷电官方 ldconsole.exe:新建、改分辨率/内存、启动、装包、备份/还原、排列窗口、关闭、查状态 |
gui |
全部动作 | 重构前的图像匹配 + 点击,遇到问题可一键回滚 |
无论哪种后端,同步器开关和模拟器内应用权限都只能走 GUI(ldconsole 没有对应命令),所以 pyautogui 仍然保留,但调用范围已从 22 处收敛到兜底分支。
npm run create_ld / serve_ld / create_txt 仍可用(已改为转发到 mise)。Windows 双击:script/创建雷电.bat、script/启动雷电.bat。
所有配置都在仓库根
config/下,新机器只需看这一个目录:见config/README.md。 机器私有路径不写进公共配置。emulator_path/backup_path/emulator_install_path三项默认为空, 本机真实值请填进config/ld_emulator.local.json(已 gitignore,不会被提交)。 新机器:cp config/ld_emulator.local.example.json config/ld_emulator.local.json后按需修改;留空则走自动探测。
| 字段 | 说明 |
|---|---|
backend |
cli(默认,ldconsole 优先)/ gui(纯图像点击,回滚用) |
emulator_name_prefix |
新建实例的名称前缀,默认 雷电-(编号拼在后面,如 雷电-248) |
emulator_resolution |
新建/修改实例的分辨率 宽,高,dpi,如 1080,1920,480;留空则不修改 |
emulator_memory |
实例内存 MB(256/512/1024/2048/4096);null 表示不修改 |
emulator_path |
雷电多开器可执行文件路径;留空=自动探测(LDPLAYER_DIR → PATH → 常见目录) |
emulator_process_name |
进程名 |
emulator_end_id |
创建起点(0=从 雷电-1 开始)。运行进度自动记在 config/ld_emulator.local.json,不回写这里 |
batch_start_num |
批量创建/启动数量 |
backup_start_id / backup_end_id |
备份/还原的 ID 范围 |
backup_path |
备份目录;留空则备份时报「未配置」而不是静默失败 |
emulator_apk |
批量安装的 APK 列表 |
emulator_install_path |
APK 所在目录;留空则装包时报「未配置」 |
image_path |
模板图片根目录(现为 assets/image/,相对脚本目录) |
emulator_coord_info_map |
坐标与布局参数(分辨率/DPI 变化时需重新核对) |
三个路径字段都支持 ~、%LOCALAPPDATA%、$HOME 展开,相对路径按 tools/ld_emulator/ 解析。
也可以不建 local 文件,直接 set LDPLAYER_DIR=D:\leidian\LDPlayer9 让 CLI 后端自己找。
- GUI 自动化:运行后会自动操作鼠标键盘,期间请勿抢占鼠标。
- 两种中断方式:把鼠标移到屏幕左上角(
pyautogui.FAILSAFE),或按 F8。 - 分辨率/DPI 敏感:模板匹配与固定坐标都依赖当前 1920×1080 @100% 的显示设置,换机器前先核对
emulator_coord_info_map。
调用 workbuddy-reward-helper skill 完成签到 / 旅行 / 成长计划,由 Windows 计划任务驱动,WorkBuddy 客户端不开也能跑。细节见 tools/wb_reward/README.md。
| 命令 | 说明 |
|---|---|
mise run wb:all |
签到 + 旅行(默认动作) |
mise run wb:checkin / wb:travel / wb:growth |
单项执行 |
mise run wb:health |
登录态健康检查(token 有效期 + 只读探活) |
mise run wb:status |
只读探活 |
10 个时间点(健康 07:45;签到 09:00/13:00/20:00;旅行 08:15/12:30/16:45/21:00;成长 10:00/19:30)由 script/setup_wb_tasks.ps1 注册,动作指向 .venv\Scripts\pythonw.exe -m tools.wb_reward <动作>,无控制台窗口。
| 文档 | 内容 |
|---|---|
docs/项目结构规范.md |
多脚本仓库的目录/依赖/命名/入口规范 |
docs/依赖重构清单.md |
依赖兼容性评估、风险清单、分阶段改造 |
docs/替代库选型建议.md |
用 ldconsole/ADB 替代 GUI 点击的选型方案 |
docs/项目代码审查报告.md |
逻辑与健壮性问题清单 |