docs: WaHappy 开发文档

孤儿分支，只含 docs/。内容包括：
- 项目总览 / 主脚本编写指南 / 日志指南
- 上传成绩开发文档 / UpsertUserAll 踩坑清单（28 条）
- 真机 Hook 对照报告 / 实跑验证记录
- 购买功能票流程（含被服务端拒绝的排查过程）
  · 扫码登录协议技术规范

docs/samples/UpsertUserAll_实跑元信息.json

@@ -0,0 +1,46 @@
+{
+  "user_id": 12345678,
+  "login": {
+    "loginId": 7693120247791879616,
+    "loginDateTime": 1791222938,
+    "lastLoginDate": "2026-10-05 17:53:49",
+    "loginCount": 184,
+    "consecutiveLoginCount": 3,
+    "token": "HcXOwSdDwBSEPzngjdfp"
+  },
+  "auth_date_time": 1791194138,
+  "snapshot_summary": {
+    "userData": 1,
+    "userExtend": 1,
+    "userOption": 1,
+    "userCharacterList": 312,
+    "userMapList": 104,
+    "userLoginBonusList": 38,
+    "userRatingList": 1,
+    "userItemList": 1070,
+    "userMusicDetailList": 1037,
+    "userCourseList": 16,
+    "userChargeList": 3,
+    "userFavoriteList": 5,
+    "userActivityList": 1,
+    "userMissionDataList": 6,
+    "userIntimateList": 2,
+    "userFavoritemusicList": 27,
+    "userKaleidxScopeList": 7,
+    "userGhost": 15
+  },
+  "snapshot_failed": [],
+  "preview": {
+    "userName": "☆Ａｓｔｒａｌ☆",
+    "playerRating": 15000,
+    "isLogin": false,
+    "banState": 0,
+    "errorId": 0,
+    "lastLoginDate": "1970-01-01 00:00:00",
+    "lastPlayDate": "1970-01-01 00:00:00",
+    "totalAwake": 184,
+    "iconId": 559501,
+    "frameId": 0
+  },
+  "qr_run_at": "2026-10-05 17:53"
+}