"""Build a source-linked inventory from the retained APK decompilation, offline.""" import csv import json from pathlib import Path import re ROOT = Path(__file__).resolve().parents[1] NETWORK = ROOT / "analysis/as3/scripts/net/pixvi/myr/net" PURPOSES = { "hisAchiComplete": "领取成就奖励", "dailyCheck": "每日签到", "dailyGiftSign": "领取每日礼包/签到奖励", "dailyGiftUpdate": "更新每日礼包状态", "dailyLoopReward": "领取每日循环奖励", "getReward": "领取 VIP 奖励", "getWeekActivityReward": "领取周活动奖励", "queryWeekActivityInfo": "查询周活动状态", "alchemyComplete": "领取炼金成品", "alchemyOpen": "开启炼金槽", "alchemySpeed": "加速炼金", "alchemyStart": "开始炼金", "battleStart": "开始特殊战斗", "recordBattleResult": "记录特殊战斗结果", "finishHuntBoss": "结算世界 BOSS 挑战", "getBossRewardByDamage": "领取 BOSS 伤害奖励", "queryCurrentBoss": "查询当前世界 BOSS", "queryCurrentBossHp": "查询世界 BOSS 剩余生命", "startHuntBoss": "开始世界 BOSS 挑战", "monsterEntangleLevelUp": "提升羁绊等级", "monsterMakeEntangle": "建立魔物羁绊", "monsterResetEntangleSkill": "重置羁绊技能", "monsterSetEntangleSkill": "设置羁绊技能", "itemEquipUnfix": "卸下装备", "itemEquipUsed": "穿戴装备", "itemExchange": "兑换物品", "addTeam": "增加探索队伍", "cancelExplore": "取消探索", "finish": "完成并领取探索奖励", "start": "派出探索队伍", "gachaBuyTimeEgg": "购买时段扭蛋", "gachaGetEggs": "执行扭蛋抽取并返回蛋/附带奖励", "gachaTimeEgg": "执行时段扭蛋操作", "useGiftCode": "兑换礼包码", "itemSell": "出售物品", "itemUse": "使用物品", "mailBatchDel": "批量删除邮件", "mailGetReward": "领取邮件附件", "mailQuery": "查询邮件列表", "mailRead": "标记邮件已读", "guideUpdate": "更新引导进度", "keepAlive": "会话心跳", "masterCheckTiAdd": "检查体力恢复", "masterLevelUpdate": "更新角色等级状态", "masterNameUpdate": "修改角色名字", "masterQuery": "查询角色基础信息", "masterQueryDetail": "查询角色主快照(牧场、背包、队伍、任务等)", "queryMasterSecondDetail": "查询角色补充信息", "queryRoleAvatars": "查询可用头像", "updateMasterAvatar": "更换头像", "migrateIn": "执行角色迁入", "migrateOut": "执行角色迁出", "createMaster": "创建区服角色", "getArchiveInfo": "读取小游戏存档", "saveInfo": "保存小游戏存档", "gameOver": "结算小游戏", "gameStart": "开始小游戏", "getRecord": "查询小游戏记录", "monsterExchange": "交换魔物成长属性", "monsterIntensify": "消耗素材魔物强化目标魔物", "monsterLock": "锁定/解锁魔物", "monsterNameUpdate": "修改魔物名字", "monsterPotential": "处理魔物潜能", "monsterQualification": "重设/提升魔物资质", "monsterSell": "派遣/出售魔物", "monsterSendGift": "给魔物赠礼", "monsterTranster2Room": "转移魔物到牧场(保留原拼写)", "monsterUpStar": "提升魔物星级", "getPayGift": "领取充值积分礼包", "monsterPotentialLevelUpgrade": "提升魔物潜能等级", "monsterPotentialUpgrade": "提升魔物潜能阶段", "finishPVE": "结算 PVE 活动挑战", "getPVEWeekReward": "领取 PVE 周奖励", "queryPVEInfo": "查询 PVE 活动信息", "startPVE": "开始 PVE 活动挑战", "finishFarmEvent": "完成牧场随机事件", "getFarmEvent": "查询牧场随机事件", "queryRank": "查询排行榜", "roomCreateByKe": "用氪金建造牧场", "roomCreateByMoney": "用金币建造牧场", "roomUpgrade": "升级牧场", "shopItemBuy": "购买商店物品", "shopQuery": "查询商店商品", "monsterSetSkin": "设置魔物皮肤", "stackAddMonster": "向培育槽放入魔物蛋", "stackCheckProcess": "推进/检查培育成长阶段", "stackGrowthNumber": "增加培育槽属性加成次数", "stackOpen": "开启培育槽", "stackSpeedUp": "加速培育", "stackTransferMonster": "从培育槽收取魔物到牧场", "battleEnd": "提交普通关卡战斗数据并结算", "checkNextWeek": "检查循环关卡跨周更新", "getStageReward": "领取循环关卡阶段奖励", "stageStart": "进入指定关卡和难度", "queryGameConfig": "查询游戏配置", "queryGameNotice": "查询公告", "execute": "查询系统时间", "firstOpenGame": "上报首次启动", "taskComplete": "完成任务并领取奖励", "taskCompleteStep": "推进任务当前步骤", "taskLoopFlush": "刷新每日循环委托", "taskLoopReceive": "接取指定城市的循环委托", "taskReceive": "接取普通任务", "taskUpdate": "更新任务状态/解锁", "monsterPlaceBattleTeam": "将魔物加入战斗队伍", "monsterWithdrawBattleTeam": "从战斗队伍移除魔物", "userActive": "提交激活码", "userRegister": "客户端保留的游戏用户注册路径", "enterGame": "选择区服并进入游戏", "loginUser": "用渠道会话登录中心并取得区服/角色列表;另有开发模式调用", "userCertification": "提交游戏侧实名信息", "payApply": "申请支付交易号", "getPayReward": "查询/领取已支付订单奖励", "queryNoGetRewardPay": "查询未领取的支付订单", "getChargeReward": "领取时段充值奖励", "getChargeRewardList": "查询时段充值奖励列表", } GROUPS = {"NetAchi": "成就", "NetActi": "签到与活动", "NetAlchemy": "炼金", "NetBattle": "特殊战斗", "NetBoss": "世界 BOSS", "NetEntangle": "羁绊", "NetEquip": "装备", "NetExchange": "物品兑换", "NetExplore": "探索派遣", "NetGacha": "扭蛋", "NetItem": "物品与礼包码", "NetMail": "邮件", "NetMaster": "角色、体力与迁移", "NetMiniGame": "小游戏与存档", "NetMonster": "魔物管理", "NetPay": "支付订单", "NetPayPoint": "充值奖励", "NetPotential": "潜能", "NetPve": "PVE 活动", "NetRandomEvent": "牧场事件", "NetRank": "排行榜", "NetRoom": "牧场建造", "NetShop": "商店", "NetSkin": "皮肤", "NetStack": "培育室", "NetStage": "冒险关卡与结算", "NetSystem": "配置、公告与时间", "NetTask": "任务与委托", "NetTeam": "战斗编队", "NetUser": "登录、区服与实名"} def code_chars(text, start=0): i = start while i < len(text): if text[i] in "\"'": quote = text[i] i += 1 while i < len(text) and text[i] != quote: i += 2 if text[i] == "\\" else 1 elif text.startswith("//", i): i = text.find("\n", i) if i < 0: return continue elif text.startswith("/*", i): end = text.find("*/", i + 2) i = len(text) if end < 0 else end + 2 continue else: yield i, text[i] i += 1 def end_of(text, start): opening, closing = text[start], {"(": ")", "{": "}", "[": "]"}[text[start]] depth = 0 for i, char in code_chars(text, start): if char == opening: depth += 1 elif char == closing: depth -= 1 if depth == 0: return i raise ValueError("Unbalanced source") def split_top(text): start, depth, result = 0, 0, [] for index, char in code_chars(text): if char in "({[": depth += 1 elif char in ")}]": depth -= 1 elif char == "," and depth == 0: result.append(text[start:index].strip()) start = index + 1 return result + [text[start:].strip()] def functions(text, java=False): pattern = r"public\s+void\s+(\w+)\s*\(" if java else r"\bfunction\s+(\w+)\s*\(" result = {} for match in re.finditer(pattern, text): end_args = end_of(text, match.end() - 1) brace = text.index("{", end_args) end = end_of(text, brace) result[match[1]] = {"name": match[1], "signature": text[match.start():brace].strip(), "body": text[brace + 1:end], "offset": brace + 1, "line": text.count("\n", 0, match.start()) + 1} return result def request_fields(body, name): fields = {} for match in re.finditer(r"\b" + re.escape(name) + r"(?:\s*:\s*\w+)?\s*=\s*\{", body): start = match.end() - 1 for entry in split_top(body[start + 1:end_of(body, start)]): item = re.match(r'\s*["\']?(\w+)["\']?\s*:\s*(.*)', entry, re.S) if item: fields.setdefault(item[1], []).append(re.sub(r"\s+", " ", item[2]).strip()) for match in re.finditer(r"\b" + re.escape(name) + r"\.(\w+)\s*=\s*([^;]+);", body): fields.setdefault(match[1], []).append(re.sub(r"\s+", " ", match[2]).strip()) return {key: list(dict.fromkeys(values)) for key, values in fields.items()} def game_inventory(): endpoints = {} for path in sorted(NETWORK.glob("*.as")): text = path.read_text(encoding="utf-8") constants = {} for declaration in re.finditer(r'\b(?:const|var)\s+(\w+)\s*:\s*String\s*=\s*"([A-Za-z][\w-]*/[\w/-]+)"', text): endpoint = declaration[2] constants[declaration[1]] = endpoint row = endpoints.setdefault(endpoint, {"path": endpoint, "method": None, "purpose": PURPOSES[endpoint.rsplit("/", 1)[1]], "evidence": "静态客户端路径;是否找到调用见 calls", "calls": [], "declarations": []}) row["declarations"].append({"source": path.relative_to(ROOT).as_posix(), "class": path.stem, "constant": declaration[1], "line": text.count("\n", 0, declaration.start()) + 1}) methods = functions(text) for function in methods.values(): body = function["body"] for match in re.finditer(r'\.send\(', body): start = body.index("(", match.start()) args = split_top(body[start + 1:end_of(body, start)]) endpoint = args[0][1:-1] if args[0].startswith('"') and args[0].endswith('"') else constants.get(args[0]) if not endpoint: continue callback = methods.get(args[2]) if len(args) > 2 else None fields = request_fields(body[:match.start()], args[1]) if re.fullmatch(r"\w+", args[1]) else {} mode = args[5] if len(args) > 5 else "NetCenter.SERVER_MODE_NORMAL" mode = {"0": "NetCenter.SERVER_MODE_CENTER", "1": "NetCenter.SERVER_MODE_NORMAL", "2": "NetCenter.SERVER_MODE_PAY"}.get(mode, mode) line = text.count("\n", 0, function["offset"] + match.start()) + 1 response_fields = sorted(set(re.findall(r"\bre\.(\w+)", callback["body"]))) if callback else [] call = {"source": path.relative_to(ROOT).as_posix(), "line": line, "class": path.stem, "function": function["name"], "signature": function["signature"], "request_argument": args[1], "request_fields": fields, "callback": args[2] if len(args) > 2 else None, "callback_line": callback["line"] if callback else None, "callback_fields": response_fields, "response_forwarded": bool(callback and re.search(r"\w+\(re\)", callback["body"])), "server_mode": mode, "send_arguments": args} row = endpoints.setdefault(endpoint, {"path": endpoint, "method": "POST", "purpose": PURPOSES[endpoint.rsplit("/", 1)[1]], "evidence": "静态客户端调用;未进行官方实服调用验证", "calls": [], "declarations": []}) row["method"] = "POST" row["evidence"] = "静态客户端 send 调用;未进行官方实服调用验证" row["calls"].append(call) return sorted(endpoints.values(), key=lambda row: row["path"]) def sdk_inventory(): path = ROOT / "analysis/sdk_login/com.diyidan.game.network.UserNetwork2.java" text = path.read_text(encoding="utf-8") purposes = {"loginByPhone": "账号密码登录", "registerByPhone": "手机号注册", "visitorUpgrade": "游客升级手机号账号", "registerAsVisitor": "游客注册", "logout": "退出渠道会话", "loginByDydToken": "使用第一弹 Token 登录", "loginByDydPermanentToken": "使用永久 Token 获取会话", "verifyToken": "验证 Token", "generateToken": "生成指定有效期 Token", "forgetPassword": "短信验证后重设密码", "bindByDydToken": "通过 Token 绑定已有账号", "bindByPhone": "通过密码绑定已有账号", "verifyId": "渠道侧实名验证"} result = [] for function in functions(text, java=True).values(): for match in re.finditer(r"addRequestToQueue\(", function["body"]): start = function["body"].index("(", match.start()) args = split_top(function["body"][start + 1:end_of(function["body"], start)]) fields = re.findall(r'map\.put\("([^"\n]+)"', function["body"]) result.append({"method": {"0": "GET", "1": "POST", "2": "PUT", "3": "DELETE"}.get(args[0], args[0]), "url_expression": args[1], "function": function["name"], "purpose": purposes[function["name"]], "request_fields": fields, "source": path.relative_to(ROOT).as_posix(), "line": text.count("\n", 0, function["offset"] + match.start()) + 1, "evidence": "静态 SDK 调用;返回结构需对应响应验证"}) return result def source_link(call): path = call["source"].removeprefix("analysis/") return f"[{Path(path).name}:{call['line']}]({path}#L{call['line']})" def main(): rows, sdk = game_inventory(), sdk_inventory() baseline = {endpoint for entry in json.loads((ROOT / "analysis/endpoints.json").read_text(encoding="utf-8")) for endpoint in entry["endpoints"]} assert baseline <= {row["path"] for row in rows} inventory = {"artifact": "牧羊人之心_1.9.68.apk", "artifact_sha256": "01678ee3a8465d818d32cbbd94baa0d8253b04b4c57b70ebc5544ed341f1015d", "date": "2026-11-07", "game_endpoint_count": len(rows), "sdk_call_variants": len(sdk), "paths_with_calls": sum(bool(row["calls"]) for row in rows), "scope": "31 个 Net*.as 文件中的路径常量、字符串 send 调用及本类常量 send 调用,以及已导出的 UserNetwork2 SDK 类;不包含未导出 SDK 类、动态拼接和热更新代码", "runtime_observations": {"user_confirmed_success": ["SDK password login", "userServerService/loginUser", "userServerService/enterGame", "masterService/masterQueryDetail"], "other_endpoints": "仅静态代码证据;未进行官方实服操作验证"}, "game": rows, "sdk": sdk} target = ROOT / "analysis/API_INVENTORY.json" target.write_text(json.dumps(inventory, ensure_ascii=False, indent=2), encoding="utf-8") route_names = {"NetCenter.SERVER_MODE_CENTER": "登录中心", "NetCenter.SERVER_MODE_NORMAL": "选中游戏服", "NetCenter.SERVER_MODE_PAY": "区服支付服"} header = ["# 牧羊人之心客户端接口清单", "", "生成日期:2026-11-07。来源:用户提供的 1.9.68 APK 留存反编译代码。", "", f"发现 **{len(rows)} 个游戏侧路径**,其中 **{sum(bool(row['calls']) for row in rows)} 个找到实际 send 调用**;另列 **{len(sdk)} 种渠道 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`。", "- 派遣统一使用 `monsterIds` 数组:`MonsterCenter.sellAllStackMonsters` 的培育室路径也调用 `NetMonster.sellMonsters`。`NetStack.sellMonsters` 的单数 `monsterId` 是未找到调用点的旧包装;用户日志中它返回997,复数请求成功。", "- 喂养升级:`monsterIntensify`,目标 `targetId`,素材数组 `foods`。", "- 委托:`taskLoopFlush` → `taskLoopReceive` → `taskCompleteStep` → `taskComplete`。", "- 普通冒险:`stageStart` → 客户端实际战斗 → `battleEnd`。后者提交 `battleData`,包含伤害、击杀、时间、阵容等。", "- 客户端 `StageStartPanel.startSaodang/doSaodangBattle` 复用上述接口;普通关卡三个难度全部通关后开放。详见 `STAGES_DAILY.md`。服务端如何验证仍未知。", "", "## 游戏接口(按功能)", ""] csv_rows = [] for cls, group in GROUPS.items(): selected = [(row, call) for row in rows for call in (row["calls"] or row["declarations"]) if call["class"] == cls] if not selected: continue header += [f"### {group}({cls})", "", "| API | 用途 | 请求字段 | 回调读取字段 | 代码位置 |", "|---|---|---|---|---|"] for row, call in selected: if not row["calls"]: header.append(f"| `{row['path']}` | {row['purpose']}(仅常量,未找到 send 调用) | 未确认 | 未确认 | {source_link(call)} |") csv_rows.append([row["path"], row["purpose"] + "(仅常量,未找到 send 调用)", "未确认", "未确认", "未确认", call["constant"], f"{call['source']}:{call['line']}"]) continue fields = ", ".join(call["request_fields"]) or ("无显式业务字段" if call["request_argument"] in ("para", "{}") else call["request_argument"]) returns = ", ".join(call["callback_fields"]) or ("回调透传" if call["response_forwarded"] else "此回调未显式读取字段") purpose = row["purpose"] if call["function"] == "login": purpose = "客户端保留的开发模式登录(loginType=dev);辅助不使用此模式" route = route_names.get(call["server_mode"], call["server_mode"]) header.append(f"| `{row['path']}` | {purpose} | `{fields}` | `{returns}` | {source_link(call)} |") csv_rows.append([row["path"], purpose, route, fields, returns, call["function"], f"{call['source']}:{call['line']}"]) header.append("") header += ["## 第一弹渠道 SDK(已导出的 UserNetwork2 类)", "", "SDK 方法号对应 Volley 的 GET/POST/PUT/DELETE。共享 URL 的不同方法/参数分别列出。", "绑定调用额外含混淆常量 `d.p` 对应的字段,未在本清单猜测其原名。", "", "| 方法 | URL 表达式 | 用途 | 显式表单字段 | 代码位置 |", "|---|---|---|---|---|"] for row in sdk: header.append(f"| {row['method']} | `{row['url_expression']}` | {row['purpose']} | `{', '.join(row['request_fields']) or '无显式表单字段'}` | {source_link(row)} |") header += ["", "账号密码接口的 SDK 查询参数含 `versionCode`、`buildNumber`、`appChannel`,请求头有应用身份签名与设备字段。", "Token 校验类方法还涉及 SDK 自身的 Header/会话状态,不能把表内空表单理解为无需认证。", "", "## 范围和待确认项", "", "- 本清单检查 31 个网络类的字符串及常量请求。此前 `endpoints.json` 的 111 路径未覆盖 `pay-server/...` 前缀,本次补入 5 条。", "- `monsterService/monsterPotential` 只找到常量声明,未在此范围找到调用,不能视为已确认可用的 API。", "- `NetMonster.addPotential` 实际向 `monsterTranster2Room` 发送潜能参数;清单保留该反编译事实,不改写成猜测的路径。", "- 参数集合是静态分支的并集,不表示每次都必填。嵌套对象、服务端默认值、类型约束需要逐个联调。", "- 同一个接口可能被多个包装方法调用;CSV/JSON 保留这些变体,因此行数可能大于唯一接口数。", "- 未恢复服务端源代码、完整数据库结构、服务端验签/战斗校验规则。未对库存、支付等路径进行官方实服测试。", "- 动态拼接、其他未导出渠道 SDK、热更新资源或其他版本新增 API 不在当前静态覆盖范围。", ""] (ROOT / "analysis/API_INVENTORY.md").write_text("\n".join(header), encoding="utf-8") with (ROOT / "analysis/API_INVENTORY.csv").open("w", encoding="utf-8-sig", newline="") as stream: writer = csv.writer(stream) writer.writerow(["API", "用途", "路由", "请求字段", "回调读取字段", "调用方法", "来源"]) writer.writerows(csv_rows) print(f"Generated {len(rows)} game paths, {sum(len(row['calls']) for row in rows)} call sites, {len(sdk)} SDK variants") if __name__ == "__main__": main()