BookSnap:我用 Python + ADB 写了一个自动截图「整本书」的小工具

1. 在电脑上建立与手机的连接 → ADB2. 让手机截图并传回电脑 → adb shell screencap + adb pull3. 让手机翻到下一页 → adb shell input keyevent / swipe4. 循环执行，直到截完 → Python 循环 + 延时控制5. 判断是否截到了最后一页 → 图片相似度去重

python booksnap.py devices# 查看已连接设备python booksnap.py capture# 开始自动截图

# config.yamladb: page_action: swipe# 可选 key 或 swipe keyevent: KEYCODE_PAGE_DOWN# 按键翻页 swipe: [900, 1000, 100, 1000, 300]# 从右往左滑动

def images_are_similar(filepath1, filepath2, threshold=0.95): ”””判断两张图片是否相似（缩略图灰度对比，带容错）””” thumb_size = (128, 128) pixel_tolerance = 10 img1 = Image.open(filepath1).convert(”L”).resize(thumb_size) img2 = Image.open(filepath2).convert(”L”).resize(thumb_size) pixels1 = list(img1.getdata()) pixels2 = list(img2.getdata()) total = len(pixels1) same = sum(1 for p1, p2 in zip(pixels1, pixels2) if abs(p1 - p2) <= pixel_tolerance) similarity = same / total return similarity >= threshold

booksnap/├── booksnap.py# 主程序├── config.yaml# 配置文件└── pyproject.toml# 依赖与项目元信息

”””BookSnap - 通过 ADB 自动翻页截图整本图书”””import subprocessimport sysimport timefrom pathlib import Pathimport clickimport yamlfrom PIL import Imagedef load_config(config_path: str) -> dict: with open(config_path, ”r”, encoding=”utf-8”) as f: return yaml.safe_load(f)def run_adb(*args) -> subprocess.CompletedProcess: ”””执行 adb 命令””” return subprocess.run([”adb”, *args], capture_output=True, text=True)def check_adb() -> None: ”””检查 adb 是否可用””” try: result = subprocess.run([”adb”, ”version”], capture_output=True, text=True) if result.returncode != 0: click.secho(”❌ adb 不可用，请确认已安装 Android SDK Platform Tools”, fg=”red”) sys.exit(1) except FileNotFoundError: click.secho(”❌ 未找到 adb 命令，请安装 Android SDK Platform Tools 并添加到 PATH”, fg=”red”) sys.exit(1)def check_device() -> str: ”””检查是否有设备连接，返回设备 ID””” result = run_adb(”devices”) lines = result.stdout.strip().split(”\n”)[1:] devices = [l.split(”\t”)[0] for l in lines if l.strip() and ”\tdevice” in l] if not devices: click.secho(”❌ 未检测到已连接的安卓设备，请通过 USB 连接并开启 USB 调试”, fg=”red”) sys.exit(1) return devices[0]# ... 图片相似度函数 images_are_similar ...@click.group()def cli(): ”””BookSnap - 通过 ADB 自动翻页截图整本图书””” pass@cli.command()def devices(): ”””列出已连接的安卓设备””” check_adb() result = run_adb(”devices”) click.echo(result.stdout) lines = result.stdout.strip().split(”\n”)[1:] devices_list = [l.split(”\t”)[0] for l in lines if l.strip() and ”\tdevice” in l] if devices_list: click.secho(f”\n✅ 已就绪，共 {len(devices_list)} 台设备”, fg=”green”) else: click.secho(”\n❌ 未检测到设备”, fg=”red”)@cli.command()@click.option(”--out”, ”-o”, default=”./output”, help=”截图输出目录”)@click.option(”--config”, ”-c”, ”config_path”, default=”config.yaml”, help=”配置文件路径”)@click.option(”--start”, ”-s”, default=1, help=”起始页码”)@click.option(”--action”, ”-a”, default=None, help=”翻页方式: key 或 swipe (覆盖配置文件)”)def capture(out, config_path, start, action): ”””开始截图整本图书””” check_adb() check_device() cfg = load_config(config_path) adb_cfg = cfg[”adb”] page_action = action or adb_cfg[”page_action”] keyevent = adb_cfg[”keyevent”] swipe_params = adb_cfg[”swipe”] remote_path = adb_cfg[”remote_path”] page_delay = adb_cfg[”page_delay”] max_pages = adb_cfg[”max_pages”] same_page_stop = adb_cfg[”same_page_stop”] similarity_threshold = adb_cfg.get(”similarity_threshold”, 0.95) out_dir = Path(out) out_dir.mkdir(parents=True, exist_ok=True) click.secho(f”📖 开始截图 ({page_action} 翻页, 最多 {max_pages} 页)”, fg=”cyan”) click.secho(f”📁 输出目录: {out_dir.resolve()}\n”, fg=”cyan”) prev_file = None same_count = 0 success_count = 0 try: for i in range(start, start + max_pages): local_file = out_dir / f”page_{i:04d}.png”# 1. 截图到设备 run_adb(”shell”, ”screencap”, ”-p”, remote_path)# 2. 下载到本地 result = run_adb(”pull”, remote_path, str(local_file)) if result.returncode != 0 or not local_file.exists(): click.secho(f” ⚠ 第 {i} 页截图失败，跳过”, fg=”yellow”) continue# 3. 去重检查 if prev_file is not None and images_are_similar( str(prev_file), str(local_file), threshold=similarity_threshold ): same_count += 1 if same_count >= same_page_stop: click.secho(f”\n🛑 连续 {same_page_stop} 页相似度 > 95%，已到达最后一页，自动停止”, fg=”yellow”) local_file.unlink(missing_ok=True) break else: same_count = 0 prev_file = local_file success_count += 1 file_size = local_file.stat().st_size click.echo(f” ✅ 第 {i} 页 → {local_file.name} ({file_size:,} bytes)”)# 4. 翻页 if page_action == ”key”: run_adb(”shell”, ”input”, ”keyevent”, keyevent) elif page_action == ”swipe”: x1, y1, x2, y2, duration = swipe_params run_adb(”shell”, ”input”, ”swipe”, str(x1), str(y1), str(x2), str(y2), str(duration)) else: click.secho(f”❌ 不支持的翻页方式: {page_action}”, fg=”red”) sys.exit(1) time.sleep(page_delay) except KeyboardInterrupt: click.secho(”\n\n⚠ 用户中断”, fg=”yellow”) finally: run_adb(”shell”, ”rm”, ”-f”, remote_path) click.secho(f”\n🎉 完成! 共截图 {success_count} 页”, fg=”green”)if __name__ == ”__main__”: cli()

adb: page_action: swipe keyevent: KEYCODE_PAGE_DOWN swipe: [900, 1000, 100, 1000, 300] remote_path: /sdcard/booksnap_page.png page_delay: 0.5 max_pages: 800 same_page_stop: 3 similarity_threshold: 0.95

[project]name = ”booksnap”version = ”0.1.0”description = ”通过 ADB 控制安卓设备，自动翻页截图整本图书”requires-python = ”>=3.11”dependencies = [ ”click>=8.0”, ”pyyaml>=6.0”, ”pillow>=10.0”,][project.scripts]booksnap = ”booksnap:cli”

uv sync# 或 pip install -e .python booksnap.py capture