adbproxy 0.1.0__tar.gz

adbproxy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Forgo7ten
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

adbproxy-0.1.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: adbproxy
+Version: 0.1.0
+Summary: ADB smart-socket and device transport proxies
+Author: Forgo7ten
+License: MIT
+Project-URL: Homepage, https://github.com/Forgo7ten/adbproxy
+Project-URL: Repository, https://github.com/Forgo7ten/adbproxy
+Project-URL: Issues, https://github.com/Forgo7ten/adbproxy/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: zstandard>=0.25.0
+Provides-Extra: lz4
+Requires-Dist: lz4>=4.3.0; extra == "lz4"
+Provides-Extra: brotli
+Requires-Dist: brotli>=1.1.0; extra == "brotli"
+Provides-Extra: decompress
+Requires-Dist: adbproxy[brotli,lz4]; extra == "decompress"
+Dynamic: license-file
+
+# adbproxy
+
+在 ADB client 与 server / 设备之间插入透明代理，解析并记录 ADB 协议流量，同时保持原始字节原样转发。
+
+适用于调试 adb 命令、观察 shell / sync / install 等协议交互、抓取 push/pull 文件内容。
+
+## 功能
+
+- **server-proxy**：MITM 本机 `adb client ↔ adb server` 的 smart-socket 链路（默认监听 `5037`，真实 server 挪到 `5038`）
+- **device-proxy**：模拟网络 adbd，接受 transport 协议连接，再经系统 adb server 转发到真实设备
+- 解析并记录 shell、sync、install、stream 等协议事件
+- 可选落盘 sync / install 文件内容，以及 `--debug` 原始 hex
+- 观察 / 解码 / 抓包失败时 fail-open，不中断透明转发
+
+## 架构
+
+```mermaid
+flowchart LR
+  Client[adb client]
+  SP[server-proxy :5037]
+  Server[adb server :5038]
+  Dev[真实设备]
+
+  Client -->|smart socket| SP
+  SP -->|smart socket| Server
+  Server --> Dev
+
+  Client2[adb client]
+  ServerFront[adb server :5037]
+  DP[device-proxy :5566]
+  ServerBack[adb server :5037]
+  Dev2[真实设备]
+
+  Client2 -->|smart socket| ServerFront
+  ServerFront -->|transport| DP
+  DP -->|smart socket| ServerBack
+  ServerBack --> Dev2
+```
+
+## 环境要求
+
+- Python ≥ 3.10
+- [uv](https://docs.astral.sh/uv/)
+- 系统 `adb`（Android platform-tools）
+
+## 安装
+
+```bash
+git clone <repo-url>
+cd adbproxy   # 或你的本地目录名
+uv sync
+```
+
+也可从 PyPI：
+
+```bash
+pip install adbproxy
+# 可选：sync 解压依赖
+pip install "adbproxy[decompress]"
+
+# 临时运行
+uvx adbproxy server --help
+uvx adbproxy device --help
+```
+
+`uv sync` 会安装依赖，并根据 `pyproject.toml` 的 `[project.scripts]` 注册命令行入口：
+
+| 命令 | 对应模块 | 作用 |
+|------|----------|------|
+| `adbproxy` | `adbproxy.cli.main:main` | **推荐**统一入口：`server` / `device` 子命令 |
+| `adb-server-proxy` | `adbproxy.cli.server:main` | 兼容旧入口（等同 `adbproxy server`） |
+| `adb-device-proxy` | `adbproxy.cli.device:main` | 兼容旧入口（等同 `adbproxy device`） |
+
+推荐启动方式：
+
+```bash
+# 统一入口（推荐）
+uv run adbproxy server --help
+uv run adbproxy device --help
+uv run python -m adbproxy server --help
+uv run python -m adbproxy device --help
+
+# 兼容旧 console script / 模块路径
+uv run adb-server-proxy --help
+uv run adb-device-proxy --help
+uv run python -m adbproxy.cli.server --help
+uv run python -m adbproxy.cli.device --help
+```
+
+下文示例统一使用 `adbproxy server` / `adbproxy device`。
+
+## 使用
+
+### 1. server-proxy（MITM 本机 5037）
+
+启动前确认本机 `5038` 未被占用。代理会接管默认 `5037`，把真实 adb server 挪到 `5038`；退出时按所有权恢复。
+
+```bash
+uv run adbproxy server
+# 等价：
+#   uv run python -m adbproxy server
+#   uv run adb-server-proxy
+
+# 可选参数：
+#   --debug        将每段 recv 的原始 hex 落盘
+#   --no-capture   不落盘 sync/install 文件，仅打印摘要
+```
+
+另开终端正常使用 adb（默认走 5037，即经过代理）：
+
+```bash
+adb devices -l
+adb shell echo hello
+adb push local.apk /data/local/tmp/
+adb install local.apk
+```
+
+### 2. device-proxy（模拟网络 adbd）
+
+默认监听 `5566`，后端复用系统 `5037` adb server，把请求转发到指定真实设备。
+
+```bash
+uv run adbproxy device \
+  --listen 5566 \
+  --target serial:<设备序列号>
+
+# 等价：
+# uv run python -m adbproxy device \
+#   --listen 5566 \
+#   --target serial:<设备序列号>
+# uv run adb-device-proxy \
+#   --listen 5566 \
+#   --target serial:<设备序列号>
+```
+
+`--target` 支持：
+
+| 值 | 含义 |
+|----|------|
+| `usb` | 自动选择首个 USB 且状态为 `device` 的设备（默认） |
+| `serial:<s>` | 指定序列号 |
+| `net:<ip>:<port>` | 先 `adb connect` 到该网络设备 |
+
+常用参数：
+
+```text
+--listen PORT           监听端口，默认 5566
+--adb-server-port PORT  后端 adb server 端口，默认 5037
+--debug                 原始 hex 落盘
+--no-capture            禁用 sync/install 文件落盘
+--banner-type TYPE      CNXN banner 前缀，默认 device
+```
+
+另开终端连接并操作：
+
+```bash
+adb connect 127.0.0.1:5566
+adb -s 127.0.0.1:5566 get-state
+adb -s 127.0.0.1:5566 shell echo hello
+adb -s 127.0.0.1:5566 push local.apk /data/local/tmp/
+adb disconnect 127.0.0.1:5566
+```
+
+## 输出目录
+
+运行时在项目根目录生成（可用 `ADB_PROXY_OUT_DIR` 覆盖）：
+
+| 路径 | 内容 |
+|------|------|
+| `out/logs/` | 事件日志；加 `--debug` 时另有 debug hex 日志 |
+| `out/files/` | sync push/pull、install 流捕获（未加 `--no-capture` 时） |
+
+```bash
+export ADB_PROXY_OUT_DIR=/tmp/adbproxy-out
+# 写入 /tmp/adbproxy-out/logs 与 /tmp/adbproxy-out/files
+```
+
+## 测试
+
+### 准备
+
+真机动态矩阵（push / pull / install）依赖测试 APK。仓库不附带该文件，运行前请自行放置：
+
+```bash
+# 任意可安装的 APK 即可
+cp /path/to/your.apk tests/app.apk
+```
+
+`tests/app.apk` 已在 `tests/.gitignore` 中忽略，不会被提交。
+
+无设备的单元 / 静态测试不需要该文件。
+
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `ADB_PROXY_REAL_DEVICE=1` | 启用真机动态用例；未设置时相关用例自动 skip |
+| `ADB_SERIAL` | 指定真机序列号；省略时取首个 USB 且状态为 `device` 的设备 |
+| `ADB_PROXY_OUT_DIR` | 覆盖运行产物根目录（日志 / 抓包），默认项目根 `out/` |
+
+### 全部测试
+
+```bash
+# 无设备：单元 + 静态；动态用例自动 skip
+uv run python -B -m unittest discover -s tests -v
+
+# 含真实设备动态矩阵（需先放置 tests/app.apk）
+export ADB_PROXY_REAL_DEVICE=1
+export ADB_SERIAL=<可选，默认取首个 USB device>
+uv run python -B -m unittest discover -s tests -v
+```
+
+### 按文件运行
+
+```bash
+# 包布局与导入
+uv run python -B -m unittest tests.test_imports -v
+
+# 统一 CLI 分发
+uv run python -B -m unittest tests.test_cli_main -v
+
+# 协议 / lease / 观察逻辑单元测试
+uv run python -B -m unittest tests.test_protocols -v
+
+# 真机动态矩阵（server-proxy + device-proxy；需 tests/app.apk）
+export ADB_PROXY_REAL_DEVICE=1
+export ADB_SERIAL=<可选>
+uv run python -B -m unittest tests.test_dynamic_commands -v
+```
+
+## 说明
+
+- 代理是透明的：解析失败不会改写或阻断转发字节

adbproxy-0.1.0/README.md

@@ -0,0 +1,233 @@
+# adbproxy
+
+在 ADB client 与 server / 设备之间插入透明代理，解析并记录 ADB 协议流量，同时保持原始字节原样转发。
+
+适用于调试 adb 命令、观察 shell / sync / install 等协议交互、抓取 push/pull 文件内容。
+
+## 功能
+
+- **server-proxy**：MITM 本机 `adb client ↔ adb server` 的 smart-socket 链路（默认监听 `5037`，真实 server 挪到 `5038`）
+- **device-proxy**：模拟网络 adbd，接受 transport 协议连接，再经系统 adb server 转发到真实设备
+- 解析并记录 shell、sync、install、stream 等协议事件
+- 可选落盘 sync / install 文件内容，以及 `--debug` 原始 hex
+- 观察 / 解码 / 抓包失败时 fail-open，不中断透明转发
+
+## 架构
+
+```mermaid
+flowchart LR
+  Client[adb client]
+  SP[server-proxy :5037]
+  Server[adb server :5038]
+  Dev[真实设备]
+
+  Client -->|smart socket| SP
+  SP -->|smart socket| Server
+  Server --> Dev
+
+  Client2[adb client]
+  ServerFront[adb server :5037]
+  DP[device-proxy :5566]
+  ServerBack[adb server :5037]
+  Dev2[真实设备]
+
+  Client2 -->|smart socket| ServerFront
+  ServerFront -->|transport| DP
+  DP -->|smart socket| ServerBack
+  ServerBack --> Dev2
+```
+
+## 环境要求
+
+- Python ≥ 3.10
+- [uv](https://docs.astral.sh/uv/)
+- 系统 `adb`（Android platform-tools）
+
+## 安装
+
+```bash
+git clone <repo-url>
+cd adbproxy   # 或你的本地目录名
+uv sync
+```
+
+也可从 PyPI：
+
+```bash
+pip install adbproxy
+# 可选：sync 解压依赖
+pip install "adbproxy[decompress]"
+
+# 临时运行
+uvx adbproxy server --help
+uvx adbproxy device --help
+```
+
+`uv sync` 会安装依赖，并根据 `pyproject.toml` 的 `[project.scripts]` 注册命令行入口：
+
+| 命令 | 对应模块 | 作用 |
+|------|----------|------|
+| `adbproxy` | `adbproxy.cli.main:main` | **推荐**统一入口：`server` / `device` 子命令 |
+| `adb-server-proxy` | `adbproxy.cli.server:main` | 兼容旧入口（等同 `adbproxy server`） |
+| `adb-device-proxy` | `adbproxy.cli.device:main` | 兼容旧入口（等同 `adbproxy device`） |
+
+推荐启动方式：
+
+```bash
+# 统一入口（推荐）
+uv run adbproxy server --help
+uv run adbproxy device --help
+uv run python -m adbproxy server --help
+uv run python -m adbproxy device --help
+
+# 兼容旧 console script / 模块路径
+uv run adb-server-proxy --help
+uv run adb-device-proxy --help
+uv run python -m adbproxy.cli.server --help
+uv run python -m adbproxy.cli.device --help
+```
+
+下文示例统一使用 `adbproxy server` / `adbproxy device`。
+
+## 使用
+
+### 1. server-proxy（MITM 本机 5037）
+
+启动前确认本机 `5038` 未被占用。代理会接管默认 `5037`，把真实 adb server 挪到 `5038`；退出时按所有权恢复。
+
+```bash
+uv run adbproxy server
+# 等价：
+#   uv run python -m adbproxy server
+#   uv run adb-server-proxy
+
+# 可选参数：
+#   --debug        将每段 recv 的原始 hex 落盘
+#   --no-capture   不落盘 sync/install 文件，仅打印摘要
+```
+
+另开终端正常使用 adb（默认走 5037，即经过代理）：
+
+```bash
+adb devices -l
+adb shell echo hello
+adb push local.apk /data/local/tmp/
+adb install local.apk
+```
+
+### 2. device-proxy（模拟网络 adbd）
+
+默认监听 `5566`，后端复用系统 `5037` adb server，把请求转发到指定真实设备。
+
+```bash
+uv run adbproxy device \
+  --listen 5566 \
+  --target serial:<设备序列号>
+
+# 等价：
+# uv run python -m adbproxy device \
+#   --listen 5566 \
+#   --target serial:<设备序列号>
+# uv run adb-device-proxy \
+#   --listen 5566 \
+#   --target serial:<设备序列号>
+```
+
+`--target` 支持：
+
+| 值 | 含义 |
+|----|------|
+| `usb` | 自动选择首个 USB 且状态为 `device` 的设备（默认） |
+| `serial:<s>` | 指定序列号 |
+| `net:<ip>:<port>` | 先 `adb connect` 到该网络设备 |
+
+常用参数：
+
+```text
+--listen PORT           监听端口，默认 5566
+--adb-server-port PORT  后端 adb server 端口，默认 5037
+--debug                 原始 hex 落盘
+--no-capture            禁用 sync/install 文件落盘
+--banner-type TYPE      CNXN banner 前缀，默认 device
+```
+
+另开终端连接并操作：
+
+```bash
+adb connect 127.0.0.1:5566
+adb -s 127.0.0.1:5566 get-state
+adb -s 127.0.0.1:5566 shell echo hello
+adb -s 127.0.0.1:5566 push local.apk /data/local/tmp/
+adb disconnect 127.0.0.1:5566
+```
+
+## 输出目录
+
+运行时在项目根目录生成（可用 `ADB_PROXY_OUT_DIR` 覆盖）：
+
+| 路径 | 内容 |
+|------|------|
+| `out/logs/` | 事件日志；加 `--debug` 时另有 debug hex 日志 |
+| `out/files/` | sync push/pull、install 流捕获（未加 `--no-capture` 时） |
+
+```bash
+export ADB_PROXY_OUT_DIR=/tmp/adbproxy-out
+# 写入 /tmp/adbproxy-out/logs 与 /tmp/adbproxy-out/files
+```
+
+## 测试
+
+### 准备
+
+真机动态矩阵（push / pull / install）依赖测试 APK。仓库不附带该文件，运行前请自行放置：
+
+```bash
+# 任意可安装的 APK 即可
+cp /path/to/your.apk tests/app.apk
+```
+
+`tests/app.apk` 已在 `tests/.gitignore` 中忽略，不会被提交。
+
+无设备的单元 / 静态测试不需要该文件。
+
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `ADB_PROXY_REAL_DEVICE=1` | 启用真机动态用例；未设置时相关用例自动 skip |
+| `ADB_SERIAL` | 指定真机序列号；省略时取首个 USB 且状态为 `device` 的设备 |
+| `ADB_PROXY_OUT_DIR` | 覆盖运行产物根目录（日志 / 抓包），默认项目根 `out/` |
+
+### 全部测试
+
+```bash
+# 无设备：单元 + 静态；动态用例自动 skip
+uv run python -B -m unittest discover -s tests -v
+
+# 含真实设备动态矩阵（需先放置 tests/app.apk）
+export ADB_PROXY_REAL_DEVICE=1
+export ADB_SERIAL=<可选，默认取首个 USB device>
+uv run python -B -m unittest discover -s tests -v
+```
+
+### 按文件运行
+
+```bash
+# 包布局与导入
+uv run python -B -m unittest tests.test_imports -v
+
+# 统一 CLI 分发
+uv run python -B -m unittest tests.test_cli_main -v
+
+# 协议 / lease / 观察逻辑单元测试
+uv run python -B -m unittest tests.test_protocols -v
+
+# 真机动态矩阵（server-proxy + device-proxy；需 tests/app.apk）
+export ADB_PROXY_REAL_DEVICE=1
+export ADB_SERIAL=<可选>
+uv run python -B -m unittest tests.test_dynamic_commands -v
+```
+
+## 说明
+
+- 代理是透明的：解析失败不会改写或阻断转发字节

adbproxy-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "adbproxy"
+version = "0.1.0"
+description = "ADB smart-socket and device transport proxies"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Forgo7ten" }]
+dependencies = [
+    "zstandard>=0.25.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Forgo7ten/adbproxy"
+Repository = "https://github.com/Forgo7ten/adbproxy"
+Issues = "https://github.com/Forgo7ten/adbproxy/issues"
+
+[project.optional-dependencies]
+# sync push 可选解压：缺失时 observers/sync 降级为原始压缩字节捕获
+lz4 = ["lz4>=4.3.0"]
+brotli = ["brotli>=1.1.0"]
+decompress = ["adbproxy[lz4,brotli]"]
+
+[project.scripts]
+adbproxy = "adbproxy.cli.main:main"
+adb-server-proxy = "adbproxy.cli.server:main"
+adb-device-proxy = "adbproxy.cli.device:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

adbproxy-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

adbproxy-0.1.0/src/adbproxy/__init__.py

@@ -0,0 +1,2 @@
+"""ADB proxy implementations and protocol observers."""
+

adbproxy-0.1.0/src/adbproxy/__main__.py

@@ -0,0 +1,5 @@
+"""python -m adbproxy → 统一 CLI。"""
+
+from adbproxy.cli.main import main
+
+raise SystemExit(main())

adbproxy-0.1.0/src/adbproxy/cli/__init__.py

@@ -0,0 +1 @@
+"""代理程序命令行入口（统一 adbproxy 与兼容旧脚本）。"""

adbproxy-0.1.0/src/adbproxy/cli/device.py

@@ -0,0 +1,13 @@
+"""ADB 设备端代理命令行入口。"""
+
+import sys
+
+from adbproxy.device.app import ClientMock
+
+
+def main(argv=None):
+    ClientMock(sys.argv[1:] if argv is None else argv).serve()
+
+
+if __name__ == "__main__":
+    main()

adbproxy-0.1.0/src/adbproxy/cli/main.py

@@ -0,0 +1,60 @@
+"""统一 CLI：adbproxy server | device。
+
+不修改现有 cli/server.py、cli/device.py；通过临时改写 sys.argv
+再调用旧入口，保证子命令参数与直接运行旧脚本一致。
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+_TOP_HELP = """\
+usage: adbproxy {server,device} ...
+
+子命令:
+  server   client↔adb server smart-socket MITM（原 adb-server-proxy）
+  device   模拟网络 adbd / transport 转发（原 adb-device-proxy）
+
+示例:
+  adbproxy server --help
+  adbproxy device --listen 5566 --target usb
+  python -m adbproxy server --debug
+"""
+
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+
+    if not argv:
+        print(_TOP_HELP, file=sys.stderr)
+        return 2
+
+    if argv[0] in ("-h", "--help"):
+        print(_TOP_HELP)
+        return 0
+
+    cmd, rest = argv[0], argv[1:]
+    if cmd == "server":
+        from adbproxy.cli import server as sub
+    elif cmd == "device":
+        from adbproxy.cli import device as sub
+    else:
+        print(f"unknown command: {cmd}", file=sys.stderr)
+        print(_TOP_HELP, file=sys.stderr)
+        return 2
+
+    old_argv = sys.argv
+    try:
+        # 旧入口固定读 sys.argv[1:]；剥掉子命令名后再调用，避免把
+        # "server"/"device" 传给 AdbProxy / ClientMock 的 argparse。
+        sys.argv = [old_argv[0], *rest]
+        result = sub.main()
+    finally:
+        sys.argv = old_argv
+
+    return 0 if result is None else result
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

adbproxy-0.1.0/src/adbproxy/cli/server.py

@@ -0,0 +1,13 @@
+"""ADB 服务端代理命令行入口。"""
+
+import sys
+
+from adbproxy.server.app import AdbProxy
+
+
+def main():
+    AdbProxy(sys.argv[1:]).serve()
+
+
+if __name__ == "__main__":
+    main()

adbproxy-0.1.0/src/adbproxy/config.py

@@ -0,0 +1,39 @@
+import os
+import struct
+
+
+PROXY_PORT = 5037
+REAL_ADB_PORT = 5038
+# 源码布局：本文件在 src/adbproxy/config.py，项目根为 src 的上两级。
+# 运行产物统一落到 <project>/out/{logs,files}，可用 ADB_PROXY_OUT_DIR 覆盖 out 根目录。
+_SRC_DIR = os.path.dirname(os.path.abspath(__file__))
+_PROJECT_ROOT = os.path.dirname(os.path.dirname(_SRC_DIR))
+_OUT_ROOT = os.environ.get(
+    "ADB_PROXY_OUT_DIR", os.path.join(_PROJECT_ROOT, "out")
+)
+LOG_DIR = os.path.join(_OUT_ROOT, "logs")
+FILES_DIR = os.path.join(_OUT_ROOT, "files")
+IDLE_TIMEOUT = 0.15
+MAX_V2_BUF = 1 << 20  # 1 MiB，v2 半包重组缓冲上限
+MAX_CMD = 4096  # 单条命令累积上限
+SYNC_DATA_MAX = (
+    64 * 1024
+)  # 与 AOSP file_sync_protocol.h:146 一致，DATA 单块上限（校验用）
+MAX_SYNC_FILE = 256 * 1024 * 1024  # 单文件落盘上限 256 MiB，防磁盘失控
+# sync v2 定长 struct 大小（核对 file_sync_protocol.h，packed little-endian）
+# sync_stat_v2: id,error,dev,ino,mode,nlink,uid,gid,size,atime,mtime,ctime
+_STAT_V2_FMT = "<IIQQIIIIQqqq"
+_STAT_V2_SIZE = struct.calcsize(_STAT_V2_FMT)  # 72
+# sync_dent_v2: stat_v2 + namelen
+_DENT_V2_FMT = _STAT_V2_FMT + "I"
+_DENT_V2_SIZE = struct.calcsize(_DENT_V2_FMT)  # 76，后随 namelen 字节 name
+# sync_stat_v1: id,mode,size,mtime
+_STAT_V1_SIZE = struct.calcsize("<IIII")  # 16
+# sync_dent_v1: id,mode,size,mtime,namelen
+_DENT_V1_SIZE = struct.calcsize("<IIIII")  # 20，后随 namelen 字节 name
+_SEND_V2_SIZE = struct.calcsize("<III")  # sync_send_v2: id,mode,flags = 12
+_RECV_V2_SIZE = struct.calcsize("<II")  # sync_recv_v2: id,flags = 8
+
+DEFAULT_LISTEN_PORT = 5566
+DEFAULT_ADB_SERVER_PORT = 5037
+DEFAULT_BANNER_FEATURES = "shell_v2,sendrecv_v2"

adbproxy-0.1.0/src/adbproxy/device/__init__.py

@@ -0,0 +1 @@
+"""ADB server 到 daemon 的传输代理。"""