@hupu-tech/shaper 0.2.11 → 0.2.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (189) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +6 -0
  3. package/dist/cli.js +2 -2
  4. package/dist/cloud/client.d.ts +1 -2
  5. package/dist/cloud/service-build.d.ts +5 -7
  6. package/dist/index.js +1 -1
  7. package/dist/project/create.d.ts +9 -3
  8. package/dist/project/delivery.d.ts +5 -5
  9. package/dist/runtime.d.ts +2 -1
  10. package/dist/runtime.js +1 -1
  11. package/dist/shared-2WDEQ3AQ.js +19 -0
  12. package/package.json +1 -3
  13. package/skills/business/SKILL.md +158 -0
  14. package/skills/business/activity/README.md +14 -0
  15. package/skills/business/activity/hupu-leaderboard-template/SKILL.md +52 -0
  16. package/skills/business/activity/hupu-leaderboard-template/example/README.md +20 -0
  17. package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/.cloudignore +3 -0
  18. package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/index.js +218 -0
  19. package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/package.json +15 -0
  20. package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
  21. package/skills/business/activity/hupu-leaderboard-template/example/index.html +291 -0
  22. package/skills/business/activity/hupu-leaderboard-template/example/migrations/20260828210000_create_leaderboard.sql +54 -0
  23. package/skills/business/activity/hupu-lottery-draw/SKILL.md +50 -0
  24. package/skills/business/activity/hupu-lottery-draw/example/README.md +21 -0
  25. package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/.cloudignore +3 -0
  26. package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/index.js +142 -0
  27. package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/package.json +9 -0
  28. package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
  29. package/skills/business/activity/hupu-lottery-draw/example/index.html +178 -0
  30. package/skills/business/activity/hupu-lottery-draw/example/migrations/20260828220000_create_draw.sql +193 -0
  31. package/skills/business/activity/hupu-pk-voting/SKILL.md +54 -0
  32. package/skills/business/activity/hupu-pk-voting/example/README.md +44 -0
  33. package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/.cloudignore +3 -0
  34. package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/index.js +370 -0
  35. package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/package.json +15 -0
  36. package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/scf_bootstrap +2 -0
  37. package/skills/business/activity/hupu-pk-voting/example/index.html +729 -0
  38. package/skills/business/activity/hupu-pk-voting/example/migrations/20260828220000_create_pk_vote.sql +168 -0
  39. package/skills/business/activity/hupu-request-activity-execute-vote-task/SKILL.md +77 -0
  40. package/skills/business/activity/hupu-request-activity-get-vote-detail/SKILL.md +84 -0
  41. package/skills/business/activity/hupu-request-activity-get-vote-task-list/SKILL.md +86 -0
  42. package/skills/business/activity/hupu-request-activity-list-by-biz-keys/SKILL.md +153 -0
  43. package/skills/business/activity/hupu-request-activity-report-vote-task/SKILL.md +58 -0
  44. package/skills/business/activity/hupu-request-activity-submit-vote/SKILL.md +58 -0
  45. package/skills/business/activity/hupu-vote-task/SKILL.md +47 -0
  46. package/skills/business/community/README.md +13 -0
  47. package/skills/business/community/hupu-request-bbs-detail/SKILL.md +197 -0
  48. package/skills/business/community/hupu-request-bbs-get-tag-thread-list/SKILL.md +257 -0
  49. package/skills/business/community/hupu-request-bbs-get-topic-threads/SKILL.md +159 -0
  50. package/skills/business/community/hupu-request-bbs-gets-thread-post-list/SKILL.md +124 -0
  51. package/skills/business/community/hupu-request-bbs-open-post-editor/SKILL.md +75 -0
  52. package/skills/business/community/hupu-request-bbs-reply-post/SKILL.md +59 -0
  53. package/skills/business/community/hupu-score-add-score/SKILL.md +57 -0
  54. package/skills/business/community/hupu-score-get-item-detail/SKILL.md +173 -0
  55. package/skills/business/community/hupu-score-get-score/SKILL.md +263 -0
  56. package/skills/business/quality/README.md +7 -0
  57. package/skills/business/quality/hupu-security-check-audit/SKILL.md +39 -0
  58. package/skills/business/quality/hupu-wasm-compression/SKILL.md +69 -0
  59. package/skills/business/quality/hupu-wasm-compression/agents/openai.yaml +4 -0
  60. package/skills/business/quality/hupu-wasm-compression/tool/checks.mjs +90 -0
  61. package/skills/business/quality/hupu-wasm-compression/tool/compress-worker.mjs +40 -0
  62. package/skills/business/quality/hupu-wasm-compression/tool/public/app.js +84 -0
  63. package/skills/business/quality/hupu-wasm-compression/tool/public/index.html +80 -0
  64. package/skills/business/quality/hupu-wasm-compression/tool/public/style.css +3 -0
  65. package/skills/business/quality/hupu-wasm-compression/tool/server.mjs +126 -0
  66. package/skills/business/quality/hupu-web-security-audit/SKILL.md +45 -0
  67. package/skills/business/quality/hupu-web-security-audit/agents/openai.yaml +4 -0
  68. package/skills/business/rewards/README.md +13 -0
  69. package/skills/business/rewards/hupu-vacoin/SKILL.md +70 -0
  70. package/skills/business/rewards/hupu-vacoin-consume-coins/SKILL.md +47 -0
  71. package/skills/business/rewards/hupu-vacoin-get-coin-overview/SKILL.md +52 -0
  72. package/skills/business/rewards/hupu-vacoin-get-session-coins/SKILL.md +44 -0
  73. package/skills/business/rewards/hupu-vacoin-reset-session-id/SKILL.md +39 -0
  74. package/skills/business/rewards/hupu-vatask/SKILL.md +63 -0
  75. package/skills/business/rewards/hupu-vatask-complete-reward-video/SKILL.md +43 -0
  76. package/skills/business/rewards/hupu-vatask-consume-activity-chance/SKILL.md +48 -0
  77. package/skills/business/rewards/hupu-vatask-get-activity-task-state/SKILL.md +49 -0
  78. package/skills/business/runtime/README.md +13 -0
  79. package/skills/business/runtime/hupu-add-to-desktop/SKILL.md +51 -0
  80. package/skills/business/runtime/hupu-close-webview/SKILL.md +48 -0
  81. package/skills/business/runtime/hupu-cloud-auth/SKILL.md +43 -0
  82. package/skills/business/runtime/hupu-cloud-request/SKILL.md +56 -0
  83. package/skills/business/runtime/hupu-fullscreen-safe-top/SKILL.md +33 -0
  84. package/skills/business/runtime/hupu-navigate-to/SKILL.md +45 -0
  85. package/skills/business/runtime/hupu-request/SKILL.md +67 -0
  86. package/skills/business/runtime/hupu-seer-chat/SKILL.md +183 -0
  87. package/skills/business/runtime/hupu-track-report/SKILL.md +71 -0
  88. package/skills/business/sharing/README.md +7 -0
  89. package/skills/business/sharing/hupu-oss-upload-file/SKILL.md +40 -0
  90. package/skills/business/sharing/hupu-result-poster-posting/SKILL.md +37 -0
  91. package/skills/business/sharing/hupu-result-poster-posting/example/README.md +14 -0
  92. package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/.cloudignore +3 -0
  93. package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/index.js +187 -0
  94. package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/package.json +15 -0
  95. package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
  96. package/skills/business/sharing/hupu-result-poster-posting/example/index.html +256 -0
  97. package/skills/business/sharing/hupu-result-poster-posting/example/migrations/20260828213000_create_result_poster_results.sql +60 -0
  98. package/skills/business/sharing/hupu-result-poster-posting/references/api-contract.md +46 -0
  99. package/skills/business/sharing/hupu-social-share/SKILL.md +27 -0
  100. package/skills/business/sports/README.md +27 -0
  101. package/skills/business/sports/hupu-request-basketball-player-info/SKILL.md +131 -0
  102. package/skills/business/sports/hupu-request-basketball-single-match/SKILL.md +158 -0
  103. package/skills/business/sports/hupu-request-basketball-team-info/SKILL.md +96 -0
  104. package/skills/business/sports/hupu-request-basketball-team-player-list/SKILL.md +108 -0
  105. package/skills/business/sports/hupu-request-basketball-team-salary-info/SKILL.md +85 -0
  106. package/skills/business/sports/hupu-request-football-coach-info/SKILL.md +76 -0
  107. package/skills/business/sports/hupu-request-football-live-room-news-list/SKILL.md +85 -0
  108. package/skills/business/sports/hupu-request-football-match-info/SKILL.md +126 -0
  109. package/skills/business/sports/hupu-request-football-player-info/SKILL.md +82 -0
  110. package/skills/business/sports/hupu-request-football-team-info/SKILL.md +83 -0
  111. package/skills/business/sports/hupu-request-football-team-player-season-stats/SKILL.md +73 -0
  112. package/skills/business/sports/hupu-request-football-team-season-year/SKILL.md +68 -0
  113. package/skills/business/sports/hupu-request-kog-playbyplay/SKILL.md +77 -0
  114. package/skills/business/sports/hupu-request-live-tab-info-list/SKILL.md +85 -0
  115. package/skills/business/sports/hupu-request-live-tab-list/SKILL.md +66 -0
  116. package/skills/business/sports/hupu-request-lol-playbyplay/SKILL.md +77 -0
  117. package/skills/business/sports/hupu-request-match-get-tab-detail-schedule-list/SKILL.md +113 -0
  118. package/skills/business/sports/hupu-request-match-query-all-diagram-info-by-id/SKILL.md +79 -0
  119. package/skills/business/sports/hupu-request-match-query-match-stats-by-match-info/SKILL.md +85 -0
  120. package/skills/business/sports/hupu-request-news-news-common-list/SKILL.md +90 -0
  121. package/skills/business/sports/hupu-request-news-player-news-list/SKILL.md +79 -0
  122. package/skills/business/sports/hupu-request-news-subject-news/SKILL.md +89 -0
  123. package/skills/business/sports/hupu-request-news-team-news-list/SKILL.md +76 -0
  124. package/skills/business/storage/README.md +9 -0
  125. package/skills/business/storage/hupu-cloud-save/SKILL.md +129 -0
  126. package/skills/business/storage/hupu-cloud-save/references/legacy-migration.md +111 -0
  127. package/skills/business/storage/hupu-cloud-save-load/SKILL.md +41 -0
  128. package/skills/business/storage/hupu-cloud-save-save/SKILL.md +45 -0
  129. package/skills/business/storage/hupu-storage-get-value/SKILL.md +26 -0
  130. package/skills/business/storage/hupu-storage-set-value/SKILL.md +42 -0
  131. package/skills/business/user/README.md +6 -0
  132. package/skills/business/user/hupu-auth-get-user-info/SKILL.md +47 -0
  133. package/skills/business/user/hupu-game-auth/SKILL.md +46 -0
  134. package/skills/core/hupu-business/SKILL.md +1 -1
  135. package/skills/core/hupu-business/references/runtime.md +17 -11
  136. package/skills/core/shaper-backend/SKILL.md +1 -1
  137. package/skills/core/shaper-backend/references/database.md +2 -2
  138. package/skills/core/shaper-backend/references/legacy.md +1 -1
  139. package/skills/core/shaper-backend/references/node-server.md +29 -20
  140. package/skills/core/shaper-development/SKILL.md +5 -1
  141. package/skills/core/shaper-development/references/project-setup.md +1 -1
  142. package/skills/core/shaper-game-development/SKILL.md +1 -1
  143. package/skills/core/shaper-release/SKILL.md +1 -1
  144. package/templates/cloud-service/README.md +4 -30
  145. package/templates/cloud-service/cloud.json +6 -9
  146. package/templates/cloud-service/package-lock.json +1090 -0
  147. package/templates/cloud-service/release.json +11 -0
  148. package/templates/cloud-service/server.cjs +37 -0
  149. package/templates/h5/package-lock.json +40 -40
  150. package/templates/leaderboard/README.md +3 -0
  151. package/templates/leaderboard/cloud/database/migrations/202611130001_leaderboard.sql +6 -0
  152. package/templates/leaderboard/cloud/functions/api/cloud.json +10 -0
  153. package/templates/leaderboard/cloud/functions/api/leaderboard.cjs +49 -0
  154. package/templates/leaderboard/cloud/functions/api/package-lock.json +1093 -0
  155. package/templates/leaderboard/cloud/functions/api/package.json +19 -0
  156. package/templates/leaderboard/cloud/functions/api/server.cjs +25 -0
  157. package/templates/leaderboard/cloud/gateway/routes.json +15 -0
  158. package/templates/leaderboard/docs/design.md +1 -0
  159. package/templates/leaderboard/docs/integration.md +12 -0
  160. package/templates/leaderboard/docs/product.md +1 -0
  161. package/templates/leaderboard/docs/validation.md +1 -0
  162. package/templates/leaderboard/index.html +12 -0
  163. package/templates/leaderboard/package-lock.json +828 -0
  164. package/templates/leaderboard/package.json +17 -0
  165. package/templates/leaderboard/public/.gitkeep +1 -0
  166. package/templates/leaderboard/shaper.config.json +7 -0
  167. package/templates/leaderboard/src/main.js +67 -0
  168. package/templates/leaderboard/src/style.css +69 -0
  169. package/templates/leaderboard/test/leaderboard.test.cjs +93 -0
  170. package/templates/offline-game/README.md +3 -0
  171. package/templates/offline-game/docs/design.md +1 -0
  172. package/templates/offline-game/docs/integration.md +10 -0
  173. package/templates/offline-game/docs/product.md +1 -0
  174. package/templates/offline-game/docs/validation.md +1 -0
  175. package/templates/offline-game/index.html +1 -0
  176. package/templates/offline-game/package-lock.json +828 -0
  177. package/templates/offline-game/package.json +16 -0
  178. package/templates/offline-game/public/.gitkeep +1 -0
  179. package/templates/offline-game/shaper.config.json +7 -0
  180. package/templates/offline-game/src/game.js +11 -0
  181. package/templates/offline-game/src/main.js +12 -0
  182. package/templates/offline-game/src/style.css +1 -0
  183. package/templates/offline-game/test/game.test.js +7 -0
  184. package/templates/phaser/package-lock.json +70 -70
  185. package/templates/react/package-lock.json +74 -74
  186. package/dist/shared-F5CQJEWB.js +0 -19
  187. package/templates/cloud-service/handlers.cjs +0 -46
  188. package/vendor/cloud-server/hupu-cloud-server-0.1.0.tgz +0 -0
  189. package/vendor/cloud-server/release.json +0 -12
@@ -0,0 +1,76 @@
1
+ ---
2
+ name: hupu-request-football-coach-info
3
+ description: 查看球队主教练的基本资料,包括头像、年龄、国籍、所属球队与常用阵型,用于教练卡片展示。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.coachInfo(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.request.football.coachInfo({ teamId }) 调用,严禁直接拼凑网络接口 URL。
13
+ - teamId 对应接口参数 newId;type 固定为 team;无需传 oldId。
14
+ - 优先从返回数据读取 name、avatar、teamName、formation、nation、encycl 相关展示字段。
15
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
16
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
17
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
18
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
19
+ - 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
20
+
21
+ # Parameters
22
+
23
+ | 参数名 | 类型 | 是否必填 | 说明 |
24
+ | --- | --- | --- | --- |
25
+ | teamId | string | 是 | 球队唯一 ID(接口 newId),例如 "655" |
26
+
27
+ # Returns
28
+
29
+ - Type: `Promise<Response>`
30
+
31
+ ### Response Properties
32
+
33
+ | 属性名 | 类型 | 是否必填 | 说明 |
34
+ | --- | --- | --- | --- |
35
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
36
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
37
+ | data | object | 否 | 成功时返回的数据载荷 |
38
+ | data.id | string | 否 | 教练 ID |
39
+ | data.name | string | 否 | 教练中文名,例如 安多尼·伊劳拉 |
40
+ | data.newsTag | string | 否 | 资讯标签名,例如 安多尼-伊劳拉 |
41
+ | data.oldId | string | 否 | 教练旧 ID |
42
+ | data.enName | string | 否 | 教练英文名,例如 Andoni Iraola |
43
+ | data.avatar | string | 否 | 教练头像 URL |
44
+ | data.teamId | number | 否 | 所属球队 ID |
45
+ | data.teamLogo | string | 否 | 所属球队队徽 URL |
46
+ | data.teamName | string | 否 | 所属球队名称,例如 利物浦 |
47
+ | data.age | number | 否 | 年龄 |
48
+ | data.nation | string | 否 | 国籍,例如 西班牙 |
49
+ | data.nationLogo | string | 否 | 国旗图片 URL |
50
+ | data.headerDayBg | string | 否 | 日间头部背景色,例如 #CC2929 |
51
+ | data.headerNightBg | string | 否 | 夜间头部背景色 |
52
+ | data.headerColor | string | 否 | 头部文字颜色,例如 white |
53
+ | data.formation | string | 否 | 常用阵型,例如 4-2-3-1 |
54
+ | data.describe | string / null | 否 | 教练简介,可能为 null |
55
+ | data.session | string / null | 否 | 执教场次相关信息,可能为 null |
56
+ | data.rate | string / number / null | 否 | 评分/胜率相关信息,可能为 null |
57
+
58
+ # Examples
59
+
60
+ ```javascript
61
+ window.ShaperAI.request.football.coachInfo({ teamId: "655" }).then(res => { if (res.code === 200) { console.log(res.data.name, res.data.formation, res.data.teamName); } })
62
+ ```
63
+
64
+ # Frontend Request Guard
65
+
66
+ | 策略 | 默认值 |
67
+ | --- | --- |
68
+ | 同请求在途合并窗口 | 不启用(0ms) |
69
+ | GET 缓存 TTL | 不启用(0ms) |
70
+ | 请求超时 | 8000ms |
71
+ | 单能力最大并发 | 不限制 |
72
+ | 单能力分钟调用上限 | 不限制 |
73
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
74
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
75
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
76
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: hupu-request-football-live-room-news-list
3
+ description: 获取比赛直播间的图文资讯流,包括标题、封面与互动数据,用于直播间资讯 Tab 展示。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.liveRoomNewsList(params)`
9
+
10
+ # Constraints
11
+
12
+ - 业务渲染列表从 res.data.result 读取,分页游标使用上一页 data.result 最后一项的 nid。
13
+ - 必须根据返回的 code 判断是否成功;code 等于 200 后再读取 data.result。
14
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
15
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
16
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
17
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
18
+
19
+ # Parameters
20
+
21
+ | 参数名 | 类型 | 是否必填 | 说明 |
22
+ | --- | --- | --- | --- |
23
+ | matchId | string | 是 | 比赛唯一 ID,例如 "3512534" |
24
+ | newsId | string | 否 | 分页游标,取上一页 data.result 数组最后一项的 nid;首页不传或传 "0" |
25
+ | matchType | string | 否 | 赛事类型/业务分类,默认 football;部分通用赛事可传 common_match |
26
+
27
+ # Returns
28
+
29
+ - Type: `Promise<Response>`
30
+
31
+ ### Response Properties
32
+
33
+ | 属性名 | 类型 | 是否必填 | 说明 |
34
+ | --- | --- | --- | --- |
35
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
36
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
37
+ | data | object | 否 | 成功时返回的数据载荷 |
38
+ | data.errorCode | string | 否 | 业务错误码;成功时通常为空字符串 |
39
+ | data.errorMsg | string | 否 | 业务错误信息;成功时通常为空字符串 |
40
+ | data.result | array | 否 | 足球直播间资讯 Tab 列表 |
41
+ | data.result[].nid | string | 否 | 资讯/新闻唯一 ID,分页时可取列表最后一项的该字段作为 newsId |
42
+ | data.result[].tid | string | 否 | 关联帖子/话题 ID |
43
+ | data.result[].type | string | 否 | 内容展示类型,如 IMG_TEXT、IMAGE_TOP_TEXT_BOTTOM、VIDEO |
44
+ | data.result[].title | string | 否 | 资讯标题 |
45
+ | data.result[].img | string | 否 | 封面图 URL |
46
+ | data.result[].replies | number | 否 | 回复数 |
47
+ | data.result[].lights | number | 否 | 亮评/点亮数 |
48
+ | data.result[].link | string | 否 | 资讯跳转链接,如 kanqiu://bbs/topic/{tid} |
49
+ | data.result[].linkType | string / null | 否 | 链接类型,可能为 null |
50
+ | data.result[].badge | array | 否 | 角标列表,可能为空数组 |
51
+ | data.result[].badge[] | object | 否 | 角标项 |
52
+ | data.result[].publishTime | string | 否 | 发布时间,格式如 "2026-07-21 11:55:43" |
53
+ | data.result[].addTime | number | 否 | 添加/发布时间戳,单位秒 |
54
+ | data.result[].oldNewsId | string / null | 否 | 旧版新闻 ID,可能为 null |
55
+ | data.result[].top | boolean | 否 | 是否置顶 |
56
+ | data.result[].pv | number / string / null | 否 | 浏览量/PV,可能为 null |
57
+ | data.result[].gifList | array / null | 否 | 动图列表,可能为 null |
58
+ | data.result[].gifList[] | object | 否 | 动图项 |
59
+ | data.result[].read | string | 否 | 已读标识,通常与 nid 相同 |
60
+ | data.result[].showComment | number | 否 | 是否展示评论,1 表示展示,0 表示不展示 |
61
+ | data.success | boolean | 否 | 业务是否成功 |
62
+ | data.traceId | string / null | 否 | 链路追踪 ID,可能为 null |
63
+ | data.hostName | string | 否 | 服务节点主机名 |
64
+ | data.msg | string | 否 | 返回消息,成功时可能为空字符串 |
65
+ | data.status | number | 否 | 业务状态码,200 表示成功 |
66
+
67
+ # Examples
68
+
69
+ ```javascript
70
+ window.ShaperAI.request.football.liveRoomNewsList({ matchId: "3512534" }).then(res => { if (res.code === 200) { console.log(res.data.result); } })
71
+ ```
72
+
73
+ # Frontend Request Guard
74
+
75
+ | 策略 | 默认值 |
76
+ | --- | --- |
77
+ | 同请求在途合并窗口 | 不启用(0ms) |
78
+ | GET 缓存 TTL | 不启用(0ms) |
79
+ | 请求超时 | 8000ms |
80
+ | 单能力最大并发 | 不限制 |
81
+ | 单能力分钟调用上限 | 不限制 |
82
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
83
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
84
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
85
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,126 @@
1
+ ---
2
+ name: hupu-request-football-match-info
3
+ description: 获取足球比赛的实时赛况,包括对阵双方、队徽、比分和比赛状态,用于展示比赛结果与进展。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.matchInfo(params)`
9
+
10
+ # Constraints
11
+
12
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
13
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
14
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
15
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
16
+ - 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
17
+
18
+ # Parameters
19
+
20
+ | 参数名 | 类型 | 是否必填 | 说明 |
21
+ | --- | --- | --- | --- |
22
+ | matchId | string | 是 | 比赛唯一ID,例如 "3512534" |
23
+
24
+ # Returns
25
+
26
+ - Type: `Promise<Response>`
27
+
28
+ ### Response Properties
29
+
30
+ | 属性名 | 类型 | 是否必填 | 说明 |
31
+ | --- | --- | --- | --- |
32
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
33
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
34
+ | data | object | 否 | 成功时返回的数据载荷 |
35
+ | data.date | string | 否 | 比赛日期时间(如 "2026-07-10 04:00:00") |
36
+ | data.matchId | number | 否 | 比赛唯一ID |
37
+ | data.oldMatchId | number | 否 | 旧比赛ID(可能为 null) |
38
+ | data.competitionName | string | 否 | 赛事名称(如 世界杯) |
39
+ | data.competitionShortName | string | 否 | 赛事简称(如 世界杯) |
40
+ | data.gdcLid | string | 否 | GDC 联赛ID |
41
+ | data.league | boolean | 否 | 是否为联赛 |
42
+ | data.stageName | string | 否 | 阶段名称(如 1/4决赛) |
43
+ | data.round | number | 否 | 轮次 |
44
+ | data.homeLogo | string | 否 | 主队队徽图片 URL |
45
+ | data.homeTeamId | number | 否 | 主队ID |
46
+ | data.oldHomeTeamId | number | 否 | 旧主队ID |
47
+ | data.homeTeamName | string | 否 | 主队名称(如 法国) |
48
+ | data.homeTeamShortNameEn | string | 否 | 主队英文简称(如 France) |
49
+ | data.homeScore | number | 否 | 主队比分 |
50
+ | data.homeOutScore | number | 否 | 主队常规时间外比分(加时/点球) |
51
+ | data.awayLogo | string | 否 | 客队队徽图片 URL |
52
+ | data.awayTeamId | number | 否 | 客队ID |
53
+ | data.oldAwayTeamId | number | 否 | 旧客队ID |
54
+ | data.awayTeamName | string | 否 | 客队名称(如 摩洛哥) |
55
+ | data.awayTeamShortNameEn | string | 否 | 客队英文简称(如 Morocco) |
56
+ | data.awayScore | number | 否 | 客队比分 |
57
+ | data.awayOutScore | number | 否 | 客队常规时间外比分(加时/点球) |
58
+ | data.win | string | 否 | 胜负标识 |
59
+ | data.matchResult | string | 否 | 比赛结果(如 HOME_TEAM 主队胜) |
60
+ | data.status | string | 否 | 比赛状态标识(如 END, LIVE 等) |
61
+ | data.statusDesc | string | 否 | 比赛状态描述(如 已结束、未开始) |
62
+ | data.thirdPCStatus | string | 否 | 第三方比赛状态(如 COMPLETED) |
63
+ | data.matchPeriod | string | 否 | 比赛阶段(如 SECOND_HALF 下半场) |
64
+ | data.periodBeginTime | number | 否 | 当前阶段开始时间(秒时间戳) |
65
+ | data.stageBeginTime | number | 否 | 阶段开始时间(秒时间戳) |
66
+ | data.periodBeginTimeStr | string | 否 | 阶段时间描述(如 "已结束 16851'") |
67
+ | data.venueDTO | object | 否 | 比赛场馆信息 |
68
+ | data.venueDTO.venueId | number | 否 | 场馆ID |
69
+ | data.venueDTO.name | string | 否 | 场馆名称 |
70
+ | data.venueDTO.enName | string | 否 | 场馆英文名称 |
71
+ | data.refereeDTO | object | 否 | 主裁判信息 |
72
+ | data.refereeDTO.refereeId | number | 否 | 裁判ID |
73
+ | data.refereeDTO.name | string | 否 | 裁判姓名 |
74
+ | data.matchDesc | string | 否 | 比赛描述(如 "世界杯 1/4决赛") |
75
+ | data.dateDesc | string | 否 | 比赛时间描述(如 "07月10日 04:00") |
76
+ | data.twoRoundsDesc | string | 否 | 两回合赛制描述 |
77
+ | data.matchTvList | array | 否 | 电视转播列表(可能为 null) |
78
+ | data.isShowMatchTv | number | 否 | 是否展示电视转播(0/1) |
79
+ | data.pollTimeSeconds | number | 否 | 轮询间隔(秒) |
80
+ | data.competitionBg | string | 否 | 赛事背景图 URL |
81
+ | data.matchLiveUrl | string | 否 | 直播间跳转链接 |
82
+ | data.matchVideo | object | 否 | 比赛视频信息(可能为 null) |
83
+ | data.minMatchStatus | object | 否 | 小状态(细分比赛状态) |
84
+ | data.minMatchStatus.id | number | 否 | 状态ID |
85
+ | data.minMatchStatus.txt | string | 否 | 状态文案 |
86
+ | data.minMatchStatus.desc | string | 否 | 状态描述 |
87
+ | data.minMatchStatus.used | number | 否 | 使用标识 |
88
+ | data.bigMatchStatus | object | 否 | 大状态(粗分比赛状态) |
89
+ | data.bigMatchStatus.id | number | 否 | 状态ID |
90
+ | data.bigMatchStatus.txt | string | 否 | 状态文案 |
91
+ | data.bigMatchStatus.desc | string | 否 | 状态描述 |
92
+ | data.bigMatchStatus.used | number | 否 | 使用标识 |
93
+ | data.index | number | 否 | 索引(可能为 null) |
94
+ | data.openTeamPage | number | 否 | 是否开启球队主页(0/1) |
95
+ | data.pv | string | 否 | 评分/浏览量文案(如 "19.5万评分") |
96
+ | data.supportLiveActivity | boolean | 否 | 是否支持灵动岛实时活动 |
97
+ | data.iosliveActivityCode | string | 否 | iOS 实时活动编码(可能为 null) |
98
+ | data.homeTeamPenalty | number | 否 | 主队点球数 |
99
+ | data.awayTeamPenalty | number | 否 | 客队点球数 |
100
+ | data.homeTeamScore | number | 否 | 主队得分 |
101
+ | data.awayTeamScore | number | 否 | 客队得分 |
102
+ | data.homeTeamLogo | string | 否 | 主队队徽图片 URL |
103
+ | data.awayTeamLogo | string | 否 | 客队队徽图片 URL |
104
+ | data.draw | boolean | 否 | 是否平局 |
105
+ | data.homeWin | boolean | 否 | 主队是否获胜 |
106
+ | data.awayWin | boolean | 否 | 客队是否获胜 |
107
+
108
+ # Examples
109
+
110
+ ```javascript
111
+ window.ShaperAI.request.football.matchInfo({ matchId: "3512534" }).then(res => { if (res.code === 200) { console.log(res.data.homeTeamName + " vs " + res.data.awayTeamName); } })
112
+ ```
113
+
114
+ # Frontend Request Guard
115
+
116
+ | 策略 | 默认值 |
117
+ | --- | --- |
118
+ | 同请求在途合并窗口 | 不启用(0ms) |
119
+ | GET 缓存 TTL | 不启用(0ms) |
120
+ | 请求超时 | 8000ms |
121
+ | 单能力最大并发 | 不限制 |
122
+ | 单能力分钟调用上限 | 不限制 |
123
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
124
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
125
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
126
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,82 @@
1
+ ---
2
+ name: hupu-request-football-player-info
3
+ description: 查看足球球员的基础资料,包括年龄、位置、国籍、俱乐部与身价,用于球员卡片展示。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.playerInfo(params)`
9
+
10
+ # Constraints
11
+
12
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
13
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
14
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
15
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
16
+ - 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
17
+
18
+ # Parameters
19
+
20
+ | 参数名 | 类型 | 是否必填 | 说明 |
21
+ | --- | --- | --- | --- |
22
+ | playerId | string | 是 | 球员唯一ID,例如 "84899" |
23
+
24
+ # Returns
25
+
26
+ - Type: `Promise<Response>`
27
+
28
+ ### Response Properties
29
+
30
+ | 属性名 | 类型 | 是否必填 | 说明 |
31
+ | --- | --- | --- | --- |
32
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
33
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
34
+ | data | object | 否 | 成功时返回的数据载荷 |
35
+ | data.type | string | 否 | 资料类型(如 "player") |
36
+ | data.newId | string | 否 | 球员新ID |
37
+ | data.oldId | string | 否 | 球员旧ID |
38
+ | data.teamId | string | 否 | 所属俱乐部ID |
39
+ | data.teamLogo | string | 否 | 俱乐部队徽图片 URL |
40
+ | data.teamName | string | 否 | 俱乐部名称(如 曼城) |
41
+ | data.playerId | string | 否 | 球员唯一ID |
42
+ | data.name | string | 否 | 球员中文名(如 哈兰德) |
43
+ | data.enName | string | 否 | 球员英文名(如 E. B. Håland) |
44
+ | data.newsTag | string | 否 | 资讯标签名(如 埃林-布朗特-哈兰德) |
45
+ | data.avatar | string | 否 | 球员头像图片 URL |
46
+ | data.worth | number | 否 | 球员身价数值 |
47
+ | data.currency | string | 否 | 身价货币单位(如 欧元) |
48
+ | data.headerDayBg | string | 否 | 日间头图背景色(如 #5C95C5) |
49
+ | data.headerNightBg | string | 否 | 夜间头图背景色(如 #5C95C5) |
50
+ | data.headerColor | string | 否 | 头图文字颜色(如 white) |
51
+ | data.foot | string | 否 | 惯用脚(如 左脚) |
52
+ | data.position | string | 否 | 场上位置(如 前锋) |
53
+ | data.age | string | 否 | 年龄(字符串,如 "26") |
54
+ | data.height | number | 否 | 身高(厘米) |
55
+ | data.weight | number | 否 | 体重(公斤) |
56
+ | data.birthday | string | 否 | 生日(如 "2000.07.21") |
57
+ | data.birthdaySeconds | number | 否 | 生日时间戳(秒) |
58
+ | data.nationality | string | 否 | 国籍(如 挪威) |
59
+ | data.nationLogo | string | 否 | 国旗图片 URL |
60
+ | data.shirtNumber | string | 否 | 球衣号码(字符串,如 "9") |
61
+ | data.isGoalKeeper | boolean | 否 | 是否为守门员 |
62
+ | data.encyclItemId | string | 否 | 百科条目ID |
63
+
64
+ # Examples
65
+
66
+ ```javascript
67
+ window.ShaperAI.request.football.playerInfo({ playerId: "84899" }).then(res => { if (res.code === 200) { console.log(res.data.name, res.data.teamName, res.data.position); } })
68
+ ```
69
+
70
+ # Frontend Request Guard
71
+
72
+ | 策略 | 默认值 |
73
+ | --- | --- |
74
+ | 同请求在途合并窗口 | 不启用(0ms) |
75
+ | GET 缓存 TTL | 不启用(0ms) |
76
+ | 请求超时 | 8000ms |
77
+ | 单能力最大并发 | 不限制 |
78
+ | 单能力分钟调用上限 | 不限制 |
79
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
80
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
81
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
82
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,83 @@
1
+ ---
2
+ name: hupu-request-football-team-info
3
+ description: 获取球队主页的基础资料,包括队名、队徽、身价、主场与专区入口,用于搭建球队主题页。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.teamInfo(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.request.football.teamInfo({ teamId }) 调用,严禁直接拼凑网络接口 URL。
13
+ - teamId 对应接口参数 newId;type 固定为 team。
14
+ - 优先从返回数据读取 name、logo、worth、arena、encyclItemId、prefectureName 等字段。
15
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
16
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
17
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
18
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
19
+ - 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
20
+
21
+ # Parameters
22
+
23
+ | 参数名 | 类型 | 是否必填 | 说明 |
24
+ | --- | --- | --- | --- |
25
+ | teamId | string | 是 | 球队唯一 ID(接口 newId),例如 "910" |
26
+
27
+ # Returns
28
+
29
+ - Type: `Promise<Response>`
30
+
31
+ ### Response Properties
32
+
33
+ | 属性名 | 类型 | 是否必填 | 说明 |
34
+ | --- | --- | --- | --- |
35
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
36
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
37
+ | data | object | 否 | 成功时返回的数据载荷 |
38
+ | data.type | string | 否 | 资料类型,固定为 team |
39
+ | data.newId | string | 否 | 球队新 ID |
40
+ | data.oldId | string | 否 | 球队旧 ID |
41
+ | data.teamId | string | 否 | 球队 ID,通常与 newId 相同 |
42
+ | data.name | string | 否 | 球队中文名,例如 阿森纳 |
43
+ | data.enName | string | 否 | 球队英文名,例如 Arsenal |
44
+ | data.logo | string | 否 | 队徽图片 URL |
45
+ | data.worth | number | 否 | 球队身价数值 |
46
+ | data.currency | string | 否 | 身价货币单位,例如 欧元 |
47
+ | data.prefectureId | number | 否 | 专区 ID |
48
+ | data.prefectureName | string | 否 | 专区名称,例如 阿森纳专区 |
49
+ | data.prefectureJrNumber | number | 否 | 专区关注/JRS 人数 |
50
+ | data.prefectureLogo | string | 否 | 专区 Logo URL |
51
+ | data.headerDayBg | string | 否 | 日间头部背景色,例如 #CC2929 |
52
+ | data.headerNightBg | string | 否 | 夜间头部背景色 |
53
+ | data.headerColor | string | 否 | 头部文字颜色,例如 white |
54
+ | data.headerImg | string / null | 否 | 头部背景图,可能为 null |
55
+ | data.address | string | 否 | 球队所在地,例如 英格兰 伦敦 |
56
+ | data.officialWeb | string | 否 | 官网地址 |
57
+ | data.arena | string | 否 | 主场球馆名称 |
58
+ | data.capacity | number | 否 | 主场容量 |
59
+ | data.year | number | 否 | 建队年份 |
60
+ | data.isNational | boolean | 否 | 是否国家队 |
61
+ | data.fifaRank | number / null | 否 | FIFA 排名,可能为 null |
62
+ | data.isFollowTeam | boolean | 否 | 当前用户是否已关注该球队 |
63
+ | data.encyclItemId | number | 否 | 关联评分百科对象 ID |
64
+
65
+ # Examples
66
+
67
+ ```javascript
68
+ window.ShaperAI.request.football.teamInfo({ teamId: "910" }).then(res => { if (res.code === 200) { console.log(res.data.name, res.data.logo, res.data.worth); } })
69
+ ```
70
+
71
+ # Frontend Request Guard
72
+
73
+ | 策略 | 默认值 |
74
+ | --- | --- |
75
+ | 同请求在途合并窗口 | 不启用(0ms) |
76
+ | GET 缓存 TTL | 不启用(0ms) |
77
+ | 请求超时 | 8000ms |
78
+ | 单能力最大并发 | 不限制 |
79
+ | 单能力分钟调用上限 | 不限制 |
80
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
81
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
82
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
83
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,73 @@
1
+ ---
2
+ name: hupu-request-football-team-player-season-stats
3
+ description: 按赛季查看球队阵容球员的技术统计,用于赛季球员数据展示。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.teamPlayerSeasonStats(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.request.football.teamPlayerSeasonStats({ teamId, seasonId }) 调用,严禁直接拼凑网络接口 URL。
13
+ - teamId 对应接口参数 newId;seasonId 必填,应从 teamSeasonYear 的 competitions 中选择;无需传 oldId。
14
+ - 建议先调用 request.football.teamSeasonYear 获取赛季与联赛列表,再把选中的 seasonId 传入本能力。
15
+ - 成功时 data 为球员数组;可按 position / isGoalkeeper 分组展示,并从 stats 中按 groupName 聚合进攻/防守等数据。
16
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
17
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
18
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
19
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
20
+
21
+ # Parameters
22
+
23
+ | 参数名 | 类型 | 是否必填 | 说明 |
24
+ | --- | --- | --- | --- |
25
+ | teamId | string | 是 | 球队唯一 ID(接口 newId),例如 "655" |
26
+ | seasonId | string | 是 | 赛季联赛 ID,来自 request.football.teamSeasonYear 返回的 competitions[].seasonId,例如 "54032" |
27
+
28
+ # Returns
29
+
30
+ - Type: `Promise<Response>`
31
+
32
+ ### Response Properties
33
+
34
+ | 属性名 | 类型 | 是否必填 | 说明 |
35
+ | --- | --- | --- | --- |
36
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
37
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
38
+ | data | array | 否 | 球队该赛季阵容球员及统计列表 |
39
+ | data[].playerId | number | 否 | 球员 ID |
40
+ | data[].gdcId | number / null | 否 | GDC ID,可能为 null |
41
+ | data[].name | string | 否 | 球员中文名 |
42
+ | data[].avatar | string | 否 | 球员头像 URL |
43
+ | data[].position | string | 否 | 场上位置,例如 前锋、中场、后卫、守门员 |
44
+ | data[].isGoalkeeper | boolean | 否 | 是否守门员 |
45
+ | data[].age | number | 否 | 年龄 |
46
+ | data[].number | string / number / null | 否 | 球衣号码,可能为 null |
47
+ | data[].country | string | 否 | 国籍 |
48
+ | data[].stats | array | 否 | 该球员在指定赛季的统计项列表 |
49
+ | data[].stats[].statsId | number | 否 | 统计项 ID,例如 1 表示进球 |
50
+ | data[].stats[].name | string | 否 | 统计项名称,例如 进球、助攻、出场时间 |
51
+ | data[].stats[].group | number | 否 | 统计分组 ID,例如 40 进攻、41 防守、42 组织、43 纪律、44 守门员 |
52
+ | data[].stats[].groupName | string | 否 | 统计分组名称,例如 进攻、防守、组织、纪律、守门员 |
53
+ | data[].stats[].value | string | 否 | 统计值文案,例如 10、40.35%、1938' |
54
+
55
+ # Examples
56
+
57
+ ```javascript
58
+ window.ShaperAI.request.football.teamSeasonYear({ teamId: "655" }).then(yearRes => { const seasonId = yearRes.data?.[1]?.competitions?.[0]?.seasonId; return window.ShaperAI.request.football.teamPlayerSeasonStats({ teamId: "655", seasonId }); }).then(res => { if (res.code === 200) { console.log(res.data?.[0]?.name, res.data?.[0]?.stats); } })
59
+ ```
60
+
61
+ # Frontend Request Guard
62
+
63
+ | 策略 | 默认值 |
64
+ | --- | --- |
65
+ | 同请求在途合并窗口 | 不启用(0ms) |
66
+ | GET 缓存 TTL | 不启用(0ms) |
67
+ | 请求超时 | 8000ms |
68
+ | 单能力最大并发 | 不限制 |
69
+ | 单能力分钟调用上限 | 不限制 |
70
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
71
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
72
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
73
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,68 @@
1
+ ---
2
+ name: hupu-request-football-team-season-year
3
+ description: 查看球队各赛季的年度列表及参与的联赛/杯赛,用于赛季切换与赛事入口。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.request.football.teamSeasonYear(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.request.football.teamSeasonYear({ teamId }) 调用,严禁直接拼凑网络接口 URL。
13
+ - teamId 对应接口参数 newId;type 固定为 team。
14
+ - 成功时 data 为赛季数组;优先用 data[0] 作为当前/最新赛季,从其 competitions 读取联赛与 seasonId。
15
+ - 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
16
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
17
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
18
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
19
+
20
+ # Parameters
21
+
22
+ | 参数名 | 类型 | 是否必填 | 说明 |
23
+ | --- | --- | --- | --- |
24
+ | teamId | string | 是 | 球队唯一 ID(接口 newId),例如 "655" |
25
+
26
+ # Returns
27
+
28
+ - Type: `Promise<Response>`
29
+
30
+ ### Response Properties
31
+
32
+ | 属性名 | 类型 | 是否必填 | 说明 |
33
+ | --- | --- | --- | --- |
34
+ | code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
35
+ | message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
36
+ | data | array | 否 | 球队各赛季年度及关联联赛列表 |
37
+ | data[].name | string | 否 | 赛季短名,例如 25/26 |
38
+ | data[].fullName | string | 否 | 赛季全名,例如 2025-2026 |
39
+ | data[].year | object | 否 | 赛季年份信息 |
40
+ | data[].year.start | string | 否 | 开始年份,例如 2025 |
41
+ | data[].year.end | string | 否 | 结束年份,例如 2026 |
42
+ | data[].year.fullYearName | string | 否 | 短年份名,例如 25/26 |
43
+ | data[].year.realFullYearName | string | 否 | 完整年份名,例如 2025-2026 |
44
+ | data[].competitions | array | 否 | 该赛季关联的赛事列表 |
45
+ | data[].competitions[].competitionId | number | 否 | 赛事 ID,例如 81 |
46
+ | data[].competitions[].competitionName | string | 否 | 赛事名称,例如 英超、欧冠、足总杯 |
47
+ | data[].competitions[].seasonId | number | 否 | 该赛事在对应赛季的 seasonId |
48
+ | data[].competitions[].competitionType | string | 否 | 赛事类型,例如 LEAGUE、INTERCONTINENTAL_CUP、DOMESTIC_CUP、UNKNOWN |
49
+
50
+ # Examples
51
+
52
+ ```javascript
53
+ window.ShaperAI.request.football.teamSeasonYear({ teamId: "655" }).then(res => { if (res.code === 200) { console.log(res.data?.[0]?.fullName, res.data?.[0]?.competitions); } })
54
+ ```
55
+
56
+ # Frontend Request Guard
57
+
58
+ | 策略 | 默认值 |
59
+ | --- | --- |
60
+ | 同请求在途合并窗口 | 不启用(0ms) |
61
+ | GET 缓存 TTL | 不启用(0ms) |
62
+ | 请求超时 | 8000ms |
63
+ | 单能力最大并发 | 不限制 |
64
+ | 单能力分钟调用上限 | 不限制 |
65
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
66
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
67
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
68
+ | 自动分页建议上限 | 5 页 |