Repository navigation
v1.22.0
更新说明
本次发行版本为 v1.22.0。功能变更、兼容要求与能力边界见版本记录和中文项目首页。发布说明默认使用中文;命令、版本号与接口标识符保持原样。
本版变更
- 证据来源:报告 schema 1.3 增加逐次定位、来源和覆盖状态,保留旧
evidence_id;富化、线索、闭环和语料关系统一按用途准入,静态候选不作为运行时或归属证据。 - 资源预算:DEX 字符串逐条解码、多 DEX 轮转;支持可选解析器进程的时间、内存和输出限制,配置或执行失败不回退。未启用隔离时明确标为
not_enforced。 - 网页交接:新增
--evidence-handoff,接收 fxfetch 的文件哈希、HAR 定位、采集缺口和附件状态;原始报告与过滤投影分别保留。 - 探针采集:OkHttp 不重放请求正文,SQLCipher 不在业务连接导库,无代理轮不修改 TLS;分开记录安装、触发、丢弃、截断及基线对照结果。
- 运行时导入:端点和事件共用有界读取,保留来源、定位与疑点;修正 HTTP 秒级 / Frida 毫秒级时间处理,重试事件保留各自的 PID 与脚本身份。
- 调证富化:补充来源家族、时间语义、服务商角色和所需记录,不从 ASN、CDN 或承载关系推断 App 运营者。
- 验证范围:合成回归、离线跨仓库联调与 CI;未做真实 APK、设备、BLA 对照或在线富化验收,不保证探针对所有应用均无干扰。可选插件源码与版本未变,仍为 0.1.2。
- 行为变更:远程配置下载(
fetch_config_object/config-probe)不再读取HTTP(S)_PROXY/ALL_PROXY、.netrc、REQUESTS_CA_BUNDLE等环境配置,始终直连目标:经代理时实连 peer 是代理地址,连接层 DNS-rebinding 防护会失效。需经代理才能出网的环境下该阶段会以连接失败降级。 - 远程配置下载(
fetch_config_object/config-probe)的 SSRF 判据改为仅放行公网地址(is_global),与origin_check一致:此前放行的 100.64.0.0/10 共享地址段(如 Tailscale)、198.18.0.0/15 等非公网段,以及 IPv4-mapped、NAT64、6to4、Teredo 中内嵌的非公网 IPv4,预解析与实连 peer 两层均拒绝。 - CI 新增
pytest (ASC provider, locked)关:droidasc 按测试清单中的官方轮子 sha256 走 hash 校验安装,其余按plugins/fxapk-asc/requirements.lock安装,设FXAPK_REQUIRE_ASC_LIVE=1后 ASC 真跑测试缺件即失败、不再静默 skip。ASC 身份表(核心与 worker)与 REA 兼容修补的四个源码哈希改为对照官方发布物独立算出的字面量清单(PyPI 轮子与 npm 归档 integrity),REA 6.4.0 / 6.7.0 的目标文件原文作为夹具(MIT),在其上不替换哈希真跑修补。droidasc 的 revision 是上游 git commit,发布物内不含,仍只能人工核对。
安装包
核心 fxapk 1.22.0 提供 wheel 与源码归档,并由本流程发布到 PyPI。可选插件均为独立版本,仅通过本页附件分发,不发布到 PyPI:fxapk-android-ui 0.1.2(Android CLI 与 adb 自备)、fxapk-rea 0.1.2(默认关闭,需在进程环境显式设置 FXAPK_ENABLE_REA=1;trace 另装 [trace] extra)、fxapk-asc 0.1.2(fxapk dex 隔离 worker,macOS 上以 memory_limit_unavailable 拒绝执行)。核心要求 Python >=3.11,插件要求以其包元数据为准。
python -m pip install "fxapk==1.22.0"
python -m pip install ./fxapk_android_ui-0.1.2-py3-none-any.whl
python -m pip install ./fxapk_rea-0.1.2-py3-none-any.whl
python -m pip install ./fxapk_asc-0.1.2-py3-none-any.whl
fxapk --version
fxapk ui --help
fxapk dex --help以上命令在下载附件所在目录执行;仅安装需要的插件即可。REA 安装后保持关闭,
需明确启用时才为该进程设置 FXAPK_ENABLE_REA=1 并运行 fxapk rea --help。
trace 的可选依赖可通过
python -m pip install "./fxapk_rea-0.1.2-py3-none-any.whl[trace]" 安装。
插件不会自动启动浏览器、查询第三方或连接设备。
安装前用附件 SHA256SUMS.txt 核对全部归档。它们不是完整离线依赖包,安装可能下载声明依赖。许可见各归档内的 MIT 声明,第三方工具和依赖遵循各自许可。安卓 UI 指南。
来源与使用边界
本版标签对应提交 7134d436524c21acb5618ab1b05a3016d8c020bb。验证范围以该提交的 CI、版本契约和实际发布结果为准,不据流程成功宣称真机或服务商账户已验收。
设备操作与第三方查询须在对应授权内执行;安装插件不会自动为 auto/capture CLI 接入 UI 观察。截图、布局、报告与诊断可能含敏感原值,digest 的有限脱敏不保证这些材料可直接外发。账户额度和权限以实际来源回执为准。