Lotuszn / piggyhand-fish

# 咸鱼小猪手 (PiggyHand Fish)
LSPosed(Xposed) 模块 —— 闲鱼 App 任务自动化引擎。注入闲鱼进程后，通过闲鱼自有 mtop 协议栈直调接口，无需电脑、无需抓包改机，打开闲鱼即可自动完成每日任务领取奖励。
> 包名：`com.piggyhand.fish` · 适用闲鱼 7.25.31 · 仅供学习研究协议机制使用
## 功能
- **任务链自动化**：拉取任务列表 → 逐个触发 → 领奖，全流程协议直调（queryolivertasklist / uploadolivertasktrigger / getolivertaskbenefit）
- **浏览任务纯协议完成**：nextfresh 拉推荐商品池，逐个上报 implId，不真的打开商品页
- **每日签到** `coin.signin`、**擦亮宝贝** `item.polish` v2.0、**小店日福利** `startup.shop.daily.benefit`
- **寻宝投注链**：lottery feeds → bet → AWARD → claim
- **4 小时间隔自动跑批**：检测到闲鱼启动时，距上次跑完超过设定间隔即自动开始（无需手动触发）
- **规则引擎**：JSON 配置驱动的通用 hook 规则（return_true / invoke / log），改配置不用重新编译
- **侦察模式**：正则扫描目标 APK 类名，全类方法挂日志钩子，用于逆向定位
- **广告 SDK 预设钩子**：穿山甲 / 优量汇 / 快手激励视频回调一键挂日志
- **报告通道**：通知 BigText + 本地 Socket(127.0.0.1:27715) + 广播 + 落盘文件四级回传
## 原理
不碰 mtopsdk，直接借闲鱼自己的协议栈发送请求：
 [code] 
发送器实现类为 `com.taobao.android.remoteobject.easy.MtopLauncher`。响应统一由全局 `MtopFinishEvent` 构造器 hook 捕获落盘。
## 构建
无 Gradle 依赖的手动编译链（javac → d8 → aapt2 → apksigner）：
 [code] 
产物：`RewardHook.apk`（约 292K）。仓库内 `app/build.gradle` 等为 Gradle 骨架，供 Android Studio 用户自行接入（需将 stub 替换为 `libxposed-api` 或 XposedBridge.jar 依赖）。
## 安装使用
1. 安装 APK，在 LSPosed 管理器启用「咸鱼小猪手」，作用域勾选「闲鱼」
2. 强停闲鱼后重新打开，模块随闲鱼进程注入
3. 打开模块 App 配置开关（跑批间隔默认 4 小时）
4. 手动触发（可选，PC 连接时）：
 [code] 
## 协议接口清单
模块内已验证可直调的 mtop 接口（均经闲鱼自有协议栈发送，SUCCESS）：
| 接口 | 版本 | 用途 |
|------|------|------|
| mtop.taobao.idle.task.queryolivertasklist | 2.0 | 拉任务列表（sceneId=496） |
| mtop.taobao.idle.task.uploadolivertasktrigger | 1.0 | 触发任务 |
| mtop.taobao.idle.task.getolivertaskbenefit | 1.0 | 领取任务奖励 |
| mtop.taobao.idlehome.idle.coin.nextfresh | 1.0 | 推荐商品池（浏览任务） |
| mtop.taobao.idle.coin.signin | 1.0 | 每日签到 |
| mtop.taobao.idle.item.polish | 2.0 | 擦亮宝贝（type=originaljson） |
| mtop.taobao.idle.startup.shop.daily.benefit | 1.0 | 小店日福利 |
| mtop.taobao.idle.coin.lottery.feeds / bet | 1.0 | 寻宝投注链 |
## 项目结构
 [code] 
## 免责声明
本项目仅供学习研究 Android 逆向工程与 Xposed 框架机制，请勿用于任何商业用途或违反平台服务条款的场景。使用本模块产生的一切后果由使用者自行承担。项目与闲鱼/阿里巴巴无任何关联。
## 开源协议
本项目以 **GNU Affero General Public License v3.0（AGPL-3.0）** 开源。你可以自由使用、修改、分发本项目，但任何基于本项目的二次分发（包括网络服务形式提供）必须同样以 AGPL-3.0 开源并保留版权声明。完整协议文本见 LICENSE。