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
+283
View File
@@ -0,0 +1,283 @@
"""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`。",
"- 注意 `NetStack.sellMonsters` 发送 `monsterId` 数组,`NetMonster.sellMonsters` 发送 `monsterIds` 数组,不能混用包装层。",
"- 喂养升级:`monsterIntensify`,目标 `targetId`,素材数组 `foods`。",
"- 委托:`taskLoopFlush` → `taskLoopReceive` → `taskCompleteStep` → `taskComplete`。",
"- 普通冒险:`stageStart` → 客户端实际战斗 → `battleEnd`。后者提交 `battleData`,包含伤害、击杀、时间、阵容等。",
"- 本次范围未发现独立扫荡路径;战斗结算不是只发成功标志。服务端如何验证仍未知。", "", "## 游戏接口(按功能)", ""]
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()