Initialize local project and fix ranch growth synchronization

This commit is contained in:
AttilaNet
2026-11-07 22:14:49 +08:00
commit 657f5f33b5
1417 changed files with 202171 additions and 0 deletions
+349
View File
@@ -0,0 +1,349 @@
# 牧羊人之心客户端接口清单
生成日期:2026-11-07。来源:用户提供的 1.9.68 APK 留存反编译代码。
发现 **116 个游戏侧路径**,其中 **115 个找到实际 send 调用**;另列 **13 种渠道 SDK 调用方式**。
主体依据客户端静态证据,用途根据调用方法、参数和回调推定。账号验证、中心登录、进入区服和角色读取已由用户实测成功;其他接口未做官方实服验证。
## 阅读方式
- 表内请求字段不含统一注入的 `token`、`reqid`、`reqsid`;空字段表示包装方法没有显式业务字段。
- 返回字段是该方法回调直接读取的字段,不是完整响应 Schema。`回调透传` 表示把整个响应交给上层。
- `JSON` 文件保留每个调用位置、方法签名、参数表达式、回调字段与路由;CSV 可直接用 Excel 打开。
- 普通游戏接口是 POST,JSON 经 AES-ECB + PKCS7 + Base64 后作为请求体;支付调用有单独的路由/编码开关。
- 登录中心来自 APK 配置;进入区服后的地址来自官方返回的 `gameServerAddress`;支付地址来自 `payServerAddress`。
## 登录顺序与当前排查
1. `POST https://gameapi.diyidan.net/g0.3/users/reallogin`:发送渠道账号密码,取 SDK 用户会话。
2. `userServerService/loginUser`:发送 SDK 用户 ID/Token、渠道和平台,客户端读取 `playerInfo`、`servers`、`masterInfos`。
3. 用户选择返回的区服后,`userServerService/enterGame`:发送 `serverId`、设备信息和客户端计算的 `random`。
4. 对选中区服调用 `masterService/masterQueryDetail`,读取角色与牧场/背包/任务等状态。
签名日期必须跟随 `Paster.timestampFormat` 的实际实现:格式串 `yyMMdd` 中的 `yy` 被替换为四位 `Date.fullYear`,因此日期是八位 `yyyyMMdd`。
`channel` 与 `tjChannel` 不同:这份 APK 的渠道为 `DYD`,而 `assets/tjchannel.json` 中的追踪渠道为 `taptap`。
辅助已修正这两处进入参数,并在调试日志的“进入参数检查”中记录日期、规则和渠道,不记录签名原文或 Token。
旧版 `AccountCenter.as` 使用 `servers[].id`;内部 `ServerVo` 保存为 `serverId`;`masterInfos[].id` 是角色编号。
实际登录日志返回前两条完整区服(含 `id`),后两条是 `$.servers[0]` / `$.servers[1]` 的 `$ref` 引用。
辅助现已还原数组引用、按区服编号去重,并按 `masterInfos[].serverId` 关联角色名;本地整理不会再发请求。
调试窗口已记录进入解析器之前的解密响应,文件为 `local_state/ranch_helper/network_debug.jsonl`。
## 培育室和冒险的关键组合
- 看培育槽/背包:`masterQueryDetail`;刷新成长:`stackCheckProcess`;放蛋:`stackAddMonster`。
- 收取到牧场:`stackTransferMonster`,`datas` 内具体结构需结合调用者;派遣:`monsterSell`。
- 注意 `NetStack.sellMonsters` 发送 `monsterId` 数组,`NetMonster.sellMonsters` 发送 `monsterIds` 数组,不能混用包装层。
- 喂养升级:`monsterIntensify`,目标 `targetId`,素材数组 `foods`。
- 委托:`taskLoopFlush` → `taskLoopReceive` → `taskCompleteStep` → `taskComplete`。
- 普通冒险:`stageStart` → 客户端实际战斗 → `battleEnd`。后者提交 `battleData`,包含伤害、击杀、时间、阵容等。
- 本次范围未发现独立扫荡路径;战斗结算不是只发成功标志。服务端如何验证仍未知。
## 游戏接口(按功能)
### 成就(NetAchi)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `historyService/hisAchiComplete` | 领取成就奖励 | `achiTypeId` | `reward` | [NetAchi.as:27](as3/scripts/net/pixvi/myr/net/NetAchi.as#L27) |
### 签到与活动(NetActi)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `dailyCheckService/dailyCheck` | 每日签到 | `无显式业务字段` | `reward` | [NetActi.as:146](as3/scripts/net/pixvi/myr/net/NetActi.as#L146) |
| `dailyGiftService/dailyGiftSign` | 领取每日礼包/签到奖励 | `无显式业务字段` | `dailyGift, reward` | [NetActi.as:98](as3/scripts/net/pixvi/myr/net/NetActi.as#L98) |
| `dailyGiftService/dailyGiftUpdate` | 更新每日礼包状态 | `无显式业务字段` | `dailyGift, reward` | [NetActi.as:114](as3/scripts/net/pixvi/myr/net/NetActi.as#L114) |
| `dailyGiftService/dailyLoopReward` | 领取每日循环奖励 | `无显式业务字段` | `回调透传` | [NetActi.as:66](as3/scripts/net/pixvi/myr/net/NetActi.as#L66) |
| `vipService/getReward` | 领取 VIP 奖励 | `无显式业务字段` | `reward` | [NetActi.as:130](as3/scripts/net/pixvi/myr/net/NetActi.as#L130) |
| `weekActivityService/getWeekActivityReward` | 领取周活动奖励 | `无显式业务字段` | `回调透传` | [NetActi.as:50](as3/scripts/net/pixvi/myr/net/NetActi.as#L50) |
| `weekActivityService/queryWeekActivityInfo` | 查询周活动状态 | `无显式业务字段` | `回调透传` | [NetActi.as:82](as3/scripts/net/pixvi/myr/net/NetActi.as#L82) |
### 炼金(NetAlchemy)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `alchemyStackService/alchemyComplete` | 领取炼金成品 | `alchemyStackId` | `item` | [NetAlchemy.as:67](as3/scripts/net/pixvi/myr/net/NetAlchemy.as#L67) |
| `alchemyStackService/alchemyOpen` | 开启炼金槽 | `无显式业务字段` | `alchemyStack` | [NetAlchemy.as:83](as3/scripts/net/pixvi/myr/net/NetAlchemy.as#L83) |
| `alchemyStackService/alchemySpeed` | 加速炼金 | `stackId, num, itemId` | `endTime` | [NetAlchemy.as:108](as3/scripts/net/pixvi/myr/net/NetAlchemy.as#L108) |
| `alchemyStackService/alchemyStart` | 开始炼金 | `alChemyStackId, materialDic` | `cost, endTime` | [NetAlchemy.as:51](as3/scripts/net/pixvi/myr/net/NetAlchemy.as#L51) |
### 特殊战斗(NetBattle)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `battleService/battleStart` | 开始特殊战斗 | `battleType, stageTypeId, stageLevel, taskTypeId` | `此回调未显式读取字段` | [NetBattle.as:54](as3/scripts/net/pixvi/myr/net/NetBattle.as#L54) |
| `battleService/recordBattleResult` | 记录特殊战斗结果 | `stageId, cityId, result` | `此回调未显式读取字段` | [NetBattle.as:32](as3/scripts/net/pixvi/myr/net/NetBattle.as#L32) |
### 世界 BOSS(NetBoss)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `worldBossService/finishHuntBoss` | 结算世界 BOSS 挑战 | `bossId, damage, battleDataReq` | `回调透传` | [NetBoss.as:76](as3/scripts/net/pixvi/myr/net/NetBoss.as#L76) |
| `worldBossService/getBossRewardByDamage` | 领取 BOSS 伤害奖励 | `bossId` | `回调透传` | [NetBoss.as:92](as3/scripts/net/pixvi/myr/net/NetBoss.as#L92) |
| `worldBossService/queryCurrentBoss` | 查询当前世界 BOSS | `无显式业务字段` | `回调透传` | [NetBoss.as:43](as3/scripts/net/pixvi/myr/net/NetBoss.as#L43) |
| `worldBossService/queryCurrentBossHp` | 查询世界 BOSS 剩余生命 | `bossId` | `hp` | [NetBoss.as:108](as3/scripts/net/pixvi/myr/net/NetBoss.as#L108) |
| `worldBossService/startHuntBoss` | 开始世界 BOSS 挑战 | `bossId` | `回调透传` | [NetBoss.as:56](as3/scripts/net/pixvi/myr/net/NetBoss.as#L56) |
### 羁绊(NetEntangle)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterEntangleLevelUp` | 提升羁绊等级 | `monsterId` | `entangleLevel, unlockTask` | [NetEntangle.as:54](as3/scripts/net/pixvi/myr/net/NetEntangle.as#L54) |
| `monsterService/monsterMakeEntangle` | 建立魔物羁绊 | `monsterId` | `unlockTask` | [NetEntangle.as:38](as3/scripts/net/pixvi/myr/net/NetEntangle.as#L38) |
| `monsterService/monsterResetEntangleSkill` | 重置羁绊技能 | `monsterId` | `globalAdd, monAdd` | [NetEntangle.as:90](as3/scripts/net/pixvi/myr/net/NetEntangle.as#L90) |
| `monsterService/monsterSetEntangleSkill` | 设置羁绊技能 | `monsterId, entangleSkillLevel, entangleSkillType` | `globalAdd, monAdd` | [NetEntangle.as:74](as3/scripts/net/pixvi/myr/net/NetEntangle.as#L74) |
### 装备(NetEquip)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `itemService/itemEquipUnfix` | 卸下装备 | `monsterId, part` | `monAdd` | [NetEquip.as:52](as3/scripts/net/pixvi/myr/net/NetEquip.as#L52) |
| `itemService/itemEquipUsed` | 穿戴装备 | `monsterId, itemId` | `monAdd` | [NetEquip.as:33](as3/scripts/net/pixvi/myr/net/NetEquip.as#L33) |
### 物品兑换(NetExchange)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `itemService/itemExchange` | 兑换物品 | `exchangeId, exchangeNum` | `reward` | [NetExchange.as:36](as3/scripts/net/pixvi/myr/net/NetExchange.as#L36) |
### 探索派遣(NetExplore)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `exploreService/addTeam` | 增加探索队伍 | `无显式业务字段` | `exploreTeam` | [NetExplore.as:38](as3/scripts/net/pixvi/myr/net/NetExplore.as#L38) |
| `exploreService/cancelExplore` | 取消探索 | `exploreTeamId` | `回调透传` | [NetExplore.as:54](as3/scripts/net/pixvi/myr/net/NetExplore.as#L54) |
| `exploreService/finish` | 完成并领取探索奖励 | `exploreTeamId` | `monExp, rewardResult, unlockStage` | [NetExplore.as:90](as3/scripts/net/pixvi/myr/net/NetExplore.as#L90) |
| `exploreService/start` | 派出探索队伍 | `exploreTeamId, monsters, area` | `exploreTeam, startTime` | [NetExplore.as:74](as3/scripts/net/pixvi/myr/net/NetExplore.as#L74) |
### 扭蛋(NetGacha)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `gachaService/gachaBuyTimeEgg` | 购买时段扭蛋 | `timeEggId` | `回调透传` | [NetGacha.as:52](as3/scripts/net/pixvi/myr/net/NetGacha.as#L52) |
| `gachaService/gachaGetEggs` | 执行扭蛋抽取并返回蛋/附带奖励 | `id, num, voucherNum, traceInfo` | `eggs, getItem, getMoney` | [NetGacha.as:83](as3/scripts/net/pixvi/myr/net/NetGacha.as#L83) |
| `gachaService/gachaTimeEgg` | 执行时段扭蛋操作 | `无显式业务字段` | `回调透传` | [NetGacha.as:36](as3/scripts/net/pixvi/myr/net/NetGacha.as#L36) |
### 物品与礼包码(NetItem)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `giftService/useGiftCode` | 兑换礼包码 | `giftCode, masterId, serverId, isMail` | `resCode, resMsg, rewardResult` | [NetItem.as:91](as3/scripts/net/pixvi/myr/net/NetItem.as#L91) |
| `itemService/itemSell` | 出售物品 | `itemId, num` | `money` | [NetItem.as:46](as3/scripts/net/pixvi/myr/net/NetItem.as#L46) |
| `itemService/itemUse` | 使用物品 | `itemId, num` | `param, reward` | [NetItem.as:70](as3/scripts/net/pixvi/myr/net/NetItem.as#L70) |
### 邮件(NetMail)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `mailService/mailBatchDel` | 批量删除邮件 | `mailIds` | `datas` | [NetMail.as:69](as3/scripts/net/pixvi/myr/net/NetMail.as#L69) |
| `mailService/mailGetReward` | 领取邮件附件 | `mailId` | `回调透传` | [NetMail.as:86](as3/scripts/net/pixvi/myr/net/NetMail.as#L86) |
| `mailService/mailQuery` | 查询邮件列表 | `无显式业务字段` | `datas` | [NetMail.as:53](as3/scripts/net/pixvi/myr/net/NetMail.as#L53) |
| `mailService/mailRead` | 标记邮件已读 | `mailIds` | `此回调未显式读取字段` | [NetMail.as:38](as3/scripts/net/pixvi/myr/net/NetMail.as#L38) |
### 角色、体力与迁移(NetMaster)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `guideService/guideUpdate` | 更新引导进度 | `{
"tag":guide,
"isMain":isMain
}` | `level` | [NetMaster.as:235](as3/scripts/net/pixvi/myr/net/NetMaster.as#L235) |
| `heartBeatService/keepAlive` | 会话心跳 | `无显式业务字段` | `此回调未显式读取字段` | [NetMaster.as:113](as3/scripts/net/pixvi/myr/net/NetMaster.as#L113) |
| `masterService/masterCheckTiAdd` | 检查体力恢复 | `无显式业务字段` | `ti, timeTi` | [NetMaster.as:120](as3/scripts/net/pixvi/myr/net/NetMaster.as#L120) |
| `masterService/masterLevelUpdate` | 更新角色等级状态 | `无显式业务字段` | `level` | [NetMaster.as:221](as3/scripts/net/pixvi/myr/net/NetMaster.as#L221) |
| `masterService/masterNameUpdate` | 修改角色名字 | `newName` | `回调透传` | [NetMaster.as:280](as3/scripts/net/pixvi/myr/net/NetMaster.as#L280) |
| `masterService/masterQuery` | 查询角色基础信息 | `{"token":AccountCenter.getIns().userToken}` | `masterInfo` | [NetMaster.as:171](as3/scripts/net/pixvi/myr/net/NetMaster.as#L171) |
| `masterService/masterQueryDetail` | 查询角色主快照(牧场、背包、队伍、任务等) | `无显式业务字段` | `此回调未显式读取字段` | [NetMaster.as:186](as3/scripts/net/pixvi/myr/net/NetMaster.as#L186) |
| `masterService/queryMasterSecondDetail` | 查询角色补充信息 | `无显式业务字段` | `data, resCode` | [NetMaster.as:197](as3/scripts/net/pixvi/myr/net/NetMaster.as#L197) |
| `masterService/queryRoleAvatars` | 查询可用头像 | `无显式业务字段` | `avatars` | [NetMaster.as:264](as3/scripts/net/pixvi/myr/net/NetMaster.as#L264) |
| `masterService/updateMasterAvatar` | 更换头像 | `avatar` | `此回调未显式读取字段` | [NetMaster.as:249](as3/scripts/net/pixvi/myr/net/NetMaster.as#L249) |
| `migrateService/migrateIn` | 执行角色迁入 | `migrateCode, sdkUid, channel, platform` | `回调透传` | [NetMaster.as:99](as3/scripts/net/pixvi/myr/net/NetMaster.as#L99) |
| `migrateService/migrateOut` | 执行角色迁出 | `masterId` | `回调透传` | [NetMaster.as:78](as3/scripts/net/pixvi/myr/net/NetMaster.as#L78) |
| `userServerService/createMaster` | 创建区服角色 | `roleName, serverId, avatar, tjChannel, random` | `masterInfo, resCode` | [NetMaster.as:142](as3/scripts/net/pixvi/myr/net/NetMaster.as#L142) |
### 小游戏与存档(NetMiniGame)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `archiveInfoService/getArchiveInfo` | 读取小游戏存档 | `typeId` | `archiveInfo` | [NetMiniGame.as:67](as3/scripts/net/pixvi/myr/net/NetMiniGame.as#L67) |
| `archiveInfoService/saveInfo` | 保存小游戏存档 | `typeId, data, keyValue1, keyValue2, dataTime` | `回调透传` | [NetMiniGame.as:51](as3/scripts/net/pixvi/myr/net/NetMiniGame.as#L51) |
| `miniGameService/gameOver` | 结算小游戏 | `score` | `回调透传` | [NetMiniGame.as:97](as3/scripts/net/pixvi/myr/net/NetMiniGame.as#L97) |
| `miniGameService/gameStart` | 开始小游戏 | `type` | `此回调未显式读取字段` | [NetMiniGame.as:81](as3/scripts/net/pixvi/myr/net/NetMiniGame.as#L81) |
| `miniGameService/getRecord` | 查询小游戏记录 | `无显式业务字段` | `回调透传` | [NetMiniGame.as:113](as3/scripts/net/pixvi/myr/net/NetMiniGame.as#L113) |
### 魔物管理(NetMonster)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterExchange` | 交换魔物成长属性 | `monsterIdA, monsterIdB` | `此回调未显式读取字段` | [NetMonster.as:232](as3/scripts/net/pixvi/myr/net/NetMonster.as#L232) |
| `monsterService/monsterIntensify` | 消耗素材魔物强化目标魔物 | `targetId, foods` | `exp, level, tpExp, tpLevel` | [NetMonster.as:159](as3/scripts/net/pixvi/myr/net/NetMonster.as#L159) |
| `monsterService/monsterLock` | 锁定/解锁魔物 | `monsterId, lock` | `此回调未显式读取字段` | [NetMonster.as:251](as3/scripts/net/pixvi/myr/net/NetMonster.as#L251) |
| `monsterService/monsterNameUpdate` | 修改魔物名字 | `monsterId, name` | `此回调未显式读取字段` | [NetMonster.as:178](as3/scripts/net/pixvi/myr/net/NetMonster.as#L178) |
| `monsterService/monsterPotential` | 处理魔物潜能(仅常量,未找到 send 调用) | 未确认 | 未确认 | [NetMonster.as:20](as3/scripts/net/pixvi/myr/net/NetMonster.as#L20) |
| `monsterService/monsterQualification` | 重设/提升魔物资质 | `monId` | `回调透传` | [NetMonster.as:82](as3/scripts/net/pixvi/myr/net/NetMonster.as#L82) |
| `monsterService/monsterSell` | 派遣/出售魔物 | `monsterIds` | `money` | [NetMonster.as:194](as3/scripts/net/pixvi/myr/net/NetMonster.as#L194) |
| `monsterService/monsterSendGift` | 给魔物赠礼 | `monsterId, itemId` | `addFeel, feel, giftDate` | [NetMonster.as:140](as3/scripts/net/pixvi/myr/net/NetMonster.as#L140) |
| `monsterService/monsterTranster2Room` | 转移魔物到牧场(保留原拼写) | `monsterId, itemId, addType` | `此回调未显式读取字段` | [NetMonster.as:102](as3/scripts/net/pixvi/myr/net/NetMonster.as#L102) |
| `monsterService/monsterTranster2Room` | 转移魔物到牧场(保留原拼写) | `monsterId, roomId` | `此回调未显式读取字段` | [NetMonster.as:121](as3/scripts/net/pixvi/myr/net/NetMonster.as#L121) |
| `monsterService/monsterTranster2Room` | 转移魔物到牧场(保留原拼写) | `monsterId, roomId` | `此回调未显式读取字段` | [NetMonster.as:213](as3/scripts/net/pixvi/myr/net/NetMonster.as#L213) |
| `monsterService/monsterUpStar` | 提升魔物星级 | `monId` | `回调透传` | [NetMonster.as:66](as3/scripts/net/pixvi/myr/net/NetMonster.as#L66) |
### 支付订单(NetPay)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `pay-server/pay/getPayReward` | 查询/领取已支付订单奖励 | `tradeId, uid, outOrderNo, phoneModel, deviceId, osType, imei, tjChannel` | `payRwardResult, resCode, resMsg` | [NetPay.as:138](as3/scripts/net/pixvi/myr/net/NetPay.as#L138) |
| `pay-server/pay/payApply` | 申请支付交易号 | `rewardTypeId, masterId, serverId, money, payAccountName, channel, tjChannel, imei` | `extResponse, resCode, resMsg, tradeId` | [NetPay.as:63](as3/scripts/net/pixvi/myr/net/NetPay.as#L63) |
| `pay-server/pay/queryNoGetRewardPay` | 查询未领取的支付订单 | `masterId` | `notGetRewardOrderList` | [NetPay.as:167](as3/scripts/net/pixvi/myr/net/NetPay.as#L167) |
### 充值奖励(NetPayPoint)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `pay-server/timeRecharge/getChargeReward` | 领取时段充值奖励 | `masterId, chargeRewardId` | `reward` | [NetPayPoint.as:75](as3/scripts/net/pixvi/myr/net/NetPayPoint.as#L75) |
| `pay-server/timeRecharge/getChargeRewardList` | 查询时段充值奖励列表 | `masterId, startTime, endTime` | `回调透传` | [NetPayPoint.as:56](as3/scripts/net/pixvi/myr/net/NetPayPoint.as#L56) |
| `rechargeService/getPayGift` | 领取充值积分礼包 | `giftTypeId` | `reward` | [NetPayPoint.as:36](as3/scripts/net/pixvi/myr/net/NetPayPoint.as#L36) |
### 潜能(NetPotential)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterPotentialLevelUpgrade` | 提升魔物潜能等级 | `monId, itemIds` | `potentailLevel` | [NetPotential.as:54](as3/scripts/net/pixvi/myr/net/NetPotential.as#L54) |
| `monsterService/monsterPotentialUpgrade` | 提升魔物潜能阶段 | `traceInfo, monId, itemId, monsterAttr` | `pAtk, pDef, pDex, pHp` | [NetPotential.as:35](as3/scripts/net/pixvi/myr/net/NetPotential.as#L35) |
### PVE 活动(NetPve)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `pveService/finishPVE` | 结算 PVE 活动挑战 | `battleDataReq, pveAreaName` | `回调透传` | [NetPve.as:58](as3/scripts/net/pixvi/myr/net/NetPve.as#L58) |
| `pveService/getPVEWeekReward` | 领取 PVE 周奖励 | `pveAreaName` | `回调透传` | [NetPve.as:74](as3/scripts/net/pixvi/myr/net/NetPve.as#L74) |
| `pveService/queryPVEInfo` | 查询 PVE 活动信息 | `无显式业务字段` | `pveInfo` | [NetPve.as:90](as3/scripts/net/pixvi/myr/net/NetPve.as#L90) |
| `pveService/startPVE` | 开始 PVE 活动挑战 | `pveAreaName` | `回调透传` | [NetPve.as:39](as3/scripts/net/pixvi/myr/net/NetPve.as#L39) |
### 牧场事件(NetRandomEvent)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `gameEventService/finishFarmEvent` | 完成牧场随机事件 | `无显式业务字段` | `getTasks, result, unlockTasks` | [NetRandomEvent.as:46](as3/scripts/net/pixvi/myr/net/NetRandomEvent.as#L46) |
| `gameEventService/getFarmEvent` | 查询牧场随机事件 | `无显式业务字段` | `currentTime, masterEventTimer, triggerEvent, typeId` | [NetRandomEvent.as:30](as3/scripts/net/pixvi/myr/net/NetRandomEvent.as#L30) |
### 排行榜(NetRank)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `rankService/queryRank` | 查询排行榜 | `rankName` | `回调透传` | [NetRank.as:26](as3/scripts/net/pixvi/myr/net/NetRank.as#L26) |
### 牧场建造(NetRoom)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `roomService/roomCreateByKe` | 用氪金建造牧场 | `无显式业务字段` | `room` | [NetRoom.as:60](as3/scripts/net/pixvi/myr/net/NetRoom.as#L60) |
| `roomService/roomCreateByMoney` | 用金币建造牧场 | `无显式业务字段` | `room` | [NetRoom.as:56](as3/scripts/net/pixvi/myr/net/NetRoom.as#L56) |
| `roomService/roomUpgrade` | 升级牧场 | `roomId, targetTypeId, useVoucher` | `room` | [NetRoom.as:38](as3/scripts/net/pixvi/myr/net/NetRoom.as#L38) |
### 商店(NetShop)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `shopService/shopItemBuy` | 购买商店物品 | `shopId, shopType, num` | `costKe, costMoney, items` | [NetShop.as:41](as3/scripts/net/pixvi/myr/net/NetShop.as#L41) |
| `shopService/shopQuery` | 查询商店商品 | `无显式业务字段` | `keShopList, moneyShopList, shopBuyNum` | [NetShop.as:57](as3/scripts/net/pixvi/myr/net/NetShop.as#L57) |
### 皮肤(NetSkin)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterSetSkin` | 设置魔物皮肤 | `monsterId, skinType` | `回调透传` | [NetSkin.as:29](as3/scripts/net/pixvi/myr/net/NetSkin.as#L29) |
### 培育室(NetStack)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterSell` | 派遣/出售魔物 | `monsterId` | `money` | [NetStack.as:137](as3/scripts/net/pixvi/myr/net/NetStack.as#L137) |
| `stackService/stackAddMonster` | 向培育槽放入魔物蛋 | `eggs` | `monsters` | [NetStack.as:90](as3/scripts/net/pixvi/myr/net/NetStack.as#L90) |
| `stackService/stackCheckProcess` | 推进/检查培育成长阶段 | `无显式业务字段` | `allExp, datas, stackMonsterInfos` | [NetStack.as:121](as3/scripts/net/pixvi/myr/net/NetStack.as#L121) |
| `stackService/stackGrowthNumber` | 增加培育槽属性加成次数 | `stackId, name` | `回调透传` | [NetStack.as:55](as3/scripts/net/pixvi/myr/net/NetStack.as#L55) |
| `stackService/stackOpen` | 开启培育槽 | `openType, position` | `stack` | [NetStack.as:74](as3/scripts/net/pixvi/myr/net/NetStack.as#L74) |
| `stackService/stackSpeedUp` | 加速培育 | `monsterId, num` | `startTime` | [NetStack.as:162](as3/scripts/net/pixvi/myr/net/NetStack.as#L162) |
| `stackService/stackTransferMonster` | 从培育槽收取魔物到牧场 | `datas` | `此回调未显式读取字段` | [NetStack.as:106](as3/scripts/net/pixvi/myr/net/NetStack.as#L106) |
### 冒险关卡与结算(NetStage)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `battleService/battleEnd` | 提交普通关卡战斗数据并结算 | `battleData` | `costTi, lockStage, monsterExpInfos, reward, unlockStage` | [NetStage.as:89](as3/scripts/net/pixvi/myr/net/NetStage.as#L89) |
| `loopStageService/checkNextWeek` | 检查循环关卡跨周更新 | `无显式业务字段` | `回调透传` | [NetStage.as:54](as3/scripts/net/pixvi/myr/net/NetStage.as#L54) |
| `loopStageService/getStageReward` | 领取循环关卡阶段奖励 | `rewardId` | `回调透传` | [NetStage.as:38](as3/scripts/net/pixvi/myr/net/NetStage.as#L38) |
| `stageService/stageStart` | 进入指定关卡和难度 | `stageTypeId, stageLevel` | `stageEvent, triggerEvent` | [NetStage.as:73](as3/scripts/net/pixvi/myr/net/NetStage.as#L73) |
### 配置、公告与时间(NetSystem)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `gameService/queryGameConfig` | 查询游戏配置 | `无显式业务字段` | `config` | [NetSystem.as:115](as3/scripts/net/pixvi/myr/net/NetSystem.as#L115) |
| `gameService/queryGameNotice` | 查询公告 | `无显式业务字段` | `gameNotice` | [NetSystem.as:91](as3/scripts/net/pixvi/myr/net/NetSystem.as#L91) |
| `getSysCurTime/execute` | 查询系统时间 | `无显式业务字段` | `time` | [NetSystem.as:44](as3/scripts/net/pixvi/myr/net/NetSystem.as#L44) |
| `userServerService/firstOpenGame` | 上报首次启动 | `os, osType, phoneScreen, phoneFactory, phoneModel, channel, isp, network, deviceId, imei, tjChannel` | `此回调未显式读取字段` | [NetSystem.as:76](as3/scripts/net/pixvi/myr/net/NetSystem.as#L76) |
### 任务与委托(NetTask)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `taskService/taskComplete` | 完成任务并领取奖励 | `taskId, taskTypeId` | `nextTasks, reward, unlockStages, unlockTasks` | [NetTask.as:94](as3/scripts/net/pixvi/myr/net/NetTask.as#L94) |
| `taskService/taskCompleteStep` | 推进任务当前步骤 | `taskId, removeIds, taskTypeId, battleData` | `reward, stageReward` | [NetTask.as:70](as3/scripts/net/pixvi/myr/net/NetTask.as#L70) |
| `taskService/taskLoopFlush` | 刷新每日循环委托 | `无显式业务字段` | `loopTask` | [NetTask.as:110](as3/scripts/net/pixvi/myr/net/NetTask.as#L110) |
| `taskService/taskLoopReceive` | 接取指定城市的循环委托 | `taskTypeId, city` | `task` | [NetTask.as:129](as3/scripts/net/pixvi/myr/net/NetTask.as#L129) |
| `taskService/taskReceive` | 接取普通任务 | `taskTypeId` | `task` | [NetTask.as:46](as3/scripts/net/pixvi/myr/net/NetTask.as#L46) |
| `taskService/taskUpdate` | 更新任务状态/解锁 | `unlockTasks, receiveTasks, removeTasks` | `receiveTasks, unlockTasks` | [NetTask.as:149](as3/scripts/net/pixvi/myr/net/NetTask.as#L149) |
### 战斗编队(NetTeam)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `monsterService/monsterPlaceBattleTeam` | 将魔物加入战斗队伍 | `monsterId, battleTeamName, position` | `此回调未显式读取字段` | [NetTeam.as:34](as3/scripts/net/pixvi/myr/net/NetTeam.as#L34) |
| `monsterService/monsterWithdrawBattleTeam` | 从战斗队伍移除魔物 | `battleTeamName, position` | `此回调未显式读取字段` | [NetTeam.as:53](as3/scripts/net/pixvi/myr/net/NetTeam.as#L53) |
### 登录、区服与实名(NetUser)
| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |
|---|---|---|---|---|
| `userInfoService/userActive` | 提交激活码 | `activeCode` | `回调透传` | [NetUser.as:205](as3/scripts/net/pixvi/myr/net/NetUser.as#L205) |
| `userInfoService/userRegister` | 客户端保留的游戏用户注册路径 | `userName, passWord` | `回调透传` | [NetUser.as:104](as3/scripts/net/pixvi/myr/net/NetUser.as#L104) |
| `userServerService/enterGame` | 选择区服并进入游戏 | `serverId, deviceId, network, isp, imei, tjChannel, random, osType` | `回调透传` | [NetUser.as:140](as3/scripts/net/pixvi/myr/net/NetUser.as#L140) |
| `userServerService/loginUser` | 用渠道会话登录中心并取得区服/角色列表;另有开发模式调用 | `sdkUid, sdkToken, deviceId, channel, platform, loginType, imei, osType, tjChannel, network, isp` | `回调透传` | [NetUser.as:86](as3/scripts/net/pixvi/myr/net/NetUser.as#L86) |
| `userServerService/loginUser` | 客户端保留的开发模式登录(loginType=dev);辅助不使用此模式 | `channel, platform, loginType, password, sdkUid, network, isp, tjChannel` | `回调透传` | [NetUser.as:188](as3/scripts/net/pixvi/myr/net/NetUser.as#L188) |
| `userServerService/userCertification` | 提交游戏侧实名信息 | `userName, idCard` | `回调透传` | [NetUser.as:56](as3/scripts/net/pixvi/myr/net/NetUser.as#L56) |
## 第一弹渠道 SDK(已导出的 UserNetwork2 类)
SDK 方法号对应 Volley 的 GET/POST/PUT/DELETE。共享 URL 的不同方法/参数分别列出。
绑定调用额外含混淆常量 `d.p` 对应的字段,未在本清单猜测其原名。
| 方法 | URL 表达式 | 用途 | 显式表单字段 | 代码位置 |
|---|---|---|---|---|
| POST | `"https://gameapi.diyidan.net/g0.3/users/reallogin"` | 账号密码登录 | `account, password` | [com.diyidan.game.network.UserNetwork2.java:21](sdk_login/com.diyidan.game.network.UserNetwork2.java#L21) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/register"` | 手机号注册 | `nickName, mobile, password, smsCode, userSource` | [com.diyidan.game.network.UserNetwork2.java:36](sdk_login/com.diyidan.game.network.UserNetwork2.java#L36) |
| PUT | `"https://gameapi.diyidan.net/g0.3/users/register"` | 游客升级手机号账号 | `mobile, password, smsCode` | [com.diyidan.game.network.UserNetwork2.java:47](sdk_login/com.diyidan.game.network.UserNetwork2.java#L47) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/register"` | 游客注册 | `deviceId` | [com.diyidan.game.network.UserNetwork2.java:53](sdk_login/com.diyidan.game.network.UserNetwork2.java#L53) |
| DELETE | `"https://gameapi.diyidan.net/g0.3/users/reallogin"` | 退出渠道会话 | `无显式表单字段` | [com.diyidan.game.network.UserNetwork2.java:57](sdk_login/com.diyidan.game.network.UserNetwork2.java#L57) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/reallogin"` | 使用第一弹 Token 登录 | `token` | [com.diyidan.game.network.UserNetwork2.java:66](sdk_login/com.diyidan.game.network.UserNetwork2.java#L66) |
| GET | `"https://gameapi.diyidan.net/g0.3/users/realtoken"` | 使用永久 Token 获取会话 | `无显式表单字段` | [com.diyidan.game.network.UserNetwork2.java:73](sdk_login/com.diyidan.game.network.UserNetwork2.java#L73) |
| GET | `"https://gameapi.diyidan.net/g0.3/users/realtoken"` | 验证 Token | `无显式表单字段` | [com.diyidan.game.network.UserNetwork2.java:80](sdk_login/com.diyidan.game.network.UserNetwork2.java#L80) |
| GET | `"https://gameapi.diyidan.net/g0.3/users/realtoken?duration=" + j` | 生成指定有效期 Token | `无显式表单字段` | [com.diyidan.game.network.UserNetwork2.java:87](sdk_login/com.diyidan.game.network.UserNetwork2.java#L87) |
| PUT | `"https://gameapi.diyidan.net/g0.3/users/realforgetpass"` | 短信验证后重设密码 | `mobile, newPass, smsCode` | [com.diyidan.game.network.UserNetwork2.java:98](sdk_login/com.diyidan.game.network.UserNetwork2.java#L98) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/reallogin"` | 通过 Token 绑定已有账号 | `token` | [com.diyidan.game.network.UserNetwork2.java:108](sdk_login/com.diyidan.game.network.UserNetwork2.java#L108) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/reallogin"` | 通过密码绑定已有账号 | `account, password` | [com.diyidan.game.network.UserNetwork2.java:116](sdk_login/com.diyidan.game.network.UserNetwork2.java#L116) |
| POST | `"https://gameapi.diyidan.net/g0.3/users/real"` | 渠道侧实名验证 | `user_real_name, user_ID_card` | [com.diyidan.game.network.UserNetwork2.java:123](sdk_login/com.diyidan.game.network.UserNetwork2.java#L123) |
账号密码接口的 SDK 查询参数含 `versionCode`、`buildNumber`、`appChannel`,请求头有应用身份签名与设备字段。
Token 校验类方法还涉及 SDK 自身的 Header/会话状态,不能把表内空表单理解为无需认证。
## 范围和待确认项
- 本清单检查 31 个网络类的字符串及常量请求。此前 `endpoints.json` 的 111 路径未覆盖 `pay-server/...` 前缀,本次补入 5 条。
- `monsterService/monsterPotential` 只找到常量声明,未在此范围找到调用,不能视为已确认可用的 API。
- `NetMonster.addPotential` 实际向 `monsterTranster2Room` 发送潜能参数;清单保留该反编译事实,不改写成猜测的路径。
- 参数集合是静态分支的并集,不表示每次都必填。嵌套对象、服务端默认值、类型约束需要逐个联调。
- 同一个接口可能被多个包装方法调用;CSV/JSON 保留这些变体,因此行数可能大于唯一接口数。
- 未恢复服务端源代码、完整数据库结构、服务端验签/战斗校验规则。未对库存、支付等路径进行官方实服测试。
- 动态拼接、其他未导出渠道 SDK、热更新资源或其他版本新增 API 不在当前静态覆盖范围。