@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,173 @@
1
+ ---
2
+ name: hupu-score-get-item-detail
3
+ description: 查看评分对象的完整资料,包括基础信息、评分数据、页面资源与相关梗内容,用于搭建百科详情页。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.score.getItemDetail(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.score.getItemDetail({ itemId }) 调用,严禁直接手写接口 URL 或自行拼接 bridge。
13
+ - 仅支持虎扑 App 环境(Native Bridge);纯 Web 环境不可用。
14
+ - itemId 必填,对应评分百科对象唯一 ID。
15
+ - 优先从 data.detail 读取名称、评分均值、是否可评分/可评论、封面图;从 data.pageResource 读取分享与跳转链接;从 data.topComponents / data.tabConfigs 读取页面模块配置。
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
+ | itemId | string | 是 | 评分百科对象 ID,例如 "382586"(也可传数字,会按字符串处理) |
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.detail | object | 否 | 评分对象详情主体 |
39
+ | data.detail.image | array | 否 | 封面图片 URL 列表 |
40
+ | data.detail.image[] | string | 否 | 数组元素 |
41
+ | data.detail.imageShape | string | 否 | 图片形状,例如 square |
42
+ | data.detail.imageSize | string | 否 | 图片尺寸标识,例如 pics_1x1 |
43
+ | data.detail.minScoreUserCountLimit | number | 否 | 展示评分所需的最小打分人数阈值 |
44
+ | data.detail.bizId | string | 否 | 业务对象 ID |
45
+ | data.detail.bizType | string | 否 | 业务类型,例如 encycl_item |
46
+ | data.detail.name | string | 否 | 对象名称 |
47
+ | data.detail.infoJson | object | 否 | 扩展信息 JSON,值多为字符串数组形式 |
48
+ | data.detail.scorePersonCount | number | 否 | 参与打分的人数 |
49
+ | data.detail.commentCount | number | 否 | 评论数 |
50
+ | data.detail.summedScorePersonCount | number | 否 | 累计打分人数 |
51
+ | data.detail.totalScore | number | 否 | 总分值 |
52
+ | data.detail.scoreAvg | number | 否 | 平均评分分值 |
53
+ | data.detail.scoreDistribution | object | 否 | 评分分布,键为分值,值为对应人数 |
54
+ | data.detail.scoreSummaryTrend | object / null | 否 | 评分汇总趋势,可能为 null |
55
+ | data.detail.scoreTabLocate | string / null | 否 | 评分 Tab 默认定位,可能为 null |
56
+ | data.detail.hottestComments | array | 否 | 最热评论文本列表 |
57
+ | data.detail.hottestComments[] | string | 否 | 数组元素 |
58
+ | data.detail.hotCommentModels | array | 否 | 热门评论模型列表 |
59
+ | data.detail.hotCommentModels[].commentUserId | number | 否 | 评论用户 ID |
60
+ | data.detail.hotCommentModels[].commentUserHeadImg | string | 否 | 评论用户头像 URL |
61
+ | data.detail.hotCommentModels[].commentUserName | string | 否 | 评论用户昵称 |
62
+ | data.detail.hotCommentModels[].commentContent | string | 否 | 评论内容 |
63
+ | data.detail.hotCommentModels[].commentId | string | 否 | 评论 ID |
64
+ | data.detail.hotCommentModels[].subjectId | string | 否 | 主题/帖子 ID |
65
+ | data.detail.hotCommentModels[].ancillaryContents | array | 否 | 评论附属内容 |
66
+ | data.detail.hotCommentModels[].ancillaryContents[] | object | 否 | 数组元素 |
67
+ | data.detail.hotCommentModels[].lightCount | number | 否 | 点亮/点赞数 |
68
+ | data.detail.hotCommentModels[].score | number | 否 | 该评论用户给出的评分 |
69
+ | data.detail.hotCommentModels[].parentCommentUserId | number / null | 否 | 父评论用户 ID,可能为 null |
70
+ | data.detail.hotCommentModels[].parentCommentUserName | string / null | 否 | 父评论用户昵称,可能为 null |
71
+ | data.detail.hotCommentModels[].parentCommentContent | string / null | 否 | 父评论内容,可能为 null |
72
+ | data.detail.hotCommentModels[].parentAncillaryContents | array / null | 否 | 父评论附属内容,可能为 null |
73
+ | data.detail.userScore | number | 否 | 当前登录用户打的分数,未打分为 0 |
74
+ | data.detail.status | number | 否 | 状态码 |
75
+ | data.detail.parentBizKeys | array | 否 | 父业务标识列表 |
76
+ | data.detail.parentBizKeys[] | string | 否 | 数组元素 |
77
+ | data.detail.canScore | boolean | 否 | 是否可评分 |
78
+ | data.detail.canComment | boolean | 否 | 是否可评论 |
79
+ | data.detail.showScore | boolean | 否 | 是否展示评分 |
80
+ | data.detail.exceedThreshold | boolean | 否 | 是否已超过评分展示阈值 |
81
+ | data.detail.bgColor | string | 否 | 背景色(十六进制) |
82
+ | data.detail.maskColor | string | 否 | 蒙层颜色(十六进制含透明度) |
83
+ | data.detail.scoreItemAttributes | object | 否 | 评分项属性配置 |
84
+ | data.detail.del | number | 否 | 是否删除,0 表示未删除 |
85
+ | data.detail.finalStatus | string | 否 | 最终审核状态,例如 PASS |
86
+ | data.detail.scoreItemNodeId | array | 否 | 评分项节点 ID 列表 |
87
+ | data.detail.scoreItemNodeId[] | number | 否 | 数组元素 |
88
+ | data.detail.createDt | string | 否 | 创建时间(ISO 时间字符串) |
89
+ | data.detail.uniqueItem | boolean | 否 | 是否唯一评分项 |
90
+ | data.detail.ipLocation | string | 否 | IP 归属地 |
91
+ | data.detail.publishTime | string | 否 | 发布时间 |
92
+ | data.detail.scoreColorDay | string | 否 | 日间模式评分颜色 |
93
+ | data.detail.scoreColorNight | string | 否 | 夜间模式评分颜色 |
94
+ | data.detail.scoreValueHighlight | boolean | 否 | 评分值是否高亮 |
95
+ | data.detail.relatedModelList | array | 否 | 关联模型列表 |
96
+ | data.detail.relatedModelList[] | object | 否 | 数组元素 |
97
+ | data.detail.bindTagThread | boolean | 否 | 是否绑定标签帖子 |
98
+ | data.detail.textLink | string / null | 否 | 文本链接,可能为 null |
99
+ | data.detail.itemId | number | 否 | 评分百科对象 ID |
100
+ | data.detail.itemType | string | 否 | 对象类型,例如 normal |
101
+ | data.detail.memeSubjectItem | array | 否 | 梗主题关联项 |
102
+ | data.detail.memeSubjectItem[] | object | 否 | 数组元素 |
103
+ | data.detail.hotStatements | array | 否 | 热门短评/观点列表 |
104
+ | data.detail.hotStatements[] | object | 否 | 数组元素 |
105
+ | data.detail.relatedInfo | object / null | 否 | 关联信息,可能为 null |
106
+ | data.pageResource | object | 否 | 页面资源与跳转链接配置 |
107
+ | data.pageResource.headerBgColorDay | string | 否 | 日间头部背景色 |
108
+ | data.pageResource.headerBgColorNight | string | 否 | 夜间头部背景色 |
109
+ | data.pageResource.titleColorDay | string | 否 | 日间标题颜色 |
110
+ | data.pageResource.titleColorNight | string | 否 | 夜间标题颜色 |
111
+ | data.pageResource.descColorDay | string | 否 | 日间描述颜色 |
112
+ | data.pageResource.descColorNight | string | 否 | 夜间描述颜色 |
113
+ | data.pageResource.pageCanShare | boolean | 否 | 页面是否可分享 |
114
+ | data.pageResource.commentCanShare | boolean | 否 | 评论是否可分享 |
115
+ | data.pageResource.showSearchButton | boolean | 否 | 是否展示搜索按钮 |
116
+ | data.pageResource.searchSchema | string / null | 否 | 搜索页跳转 schema,可能为 null |
117
+ | data.pageResource.shareUrl | string | 否 | 分享链接 |
118
+ | data.pageResource.scoreCommunityGuidelinesUrl | string | 否 | 评分社区公约链接 |
119
+ | data.pageResource.commentManagementUrl | string | 否 | 评论管理跳转 schema |
120
+ | data.pageResource.scoreEditUrl | string | 否 | 评分编辑跳转 schema |
121
+ | data.topComponents | array | 否 | 顶部组件列表(如梗列表 MEME_LIST) |
122
+ | data.topComponents[].id | string | 否 | 组件 ID,例如 MEME_LIST_0 |
123
+ | data.topComponents[].name | string | 否 | 组件名称,例如 梗列表 |
124
+ | data.topComponents[].index | number | 否 | 组件排序 |
125
+ | data.topComponents[].componentType | string | 否 | 组件类型,例如 MEME_LIST |
126
+ | data.topComponents[].config | object | 否 | 组件配置 |
127
+ | data.topComponents[].config.params | object | 否 | 组件请求参数,例如 itemId、pageSize |
128
+ | data.topComponents[].config.data | array | 否 | 组件数据列表 |
129
+ | data.topComponents[].config.data[].itemId | number | 否 | 梗对象 itemId |
130
+ | data.topComponents[].config.data[].bizType | string | 否 | 业务类型,例如 encycl_item |
131
+ | data.topComponents[].config.data[].bizId | string | 否 | 业务对象 ID |
132
+ | data.topComponents[].config.data[].name | string | 否 | 梗名称 |
133
+ | data.topComponents[].config.data[].desc | string | 否 | 梗描述文案 |
134
+ | data.topComponents[].config.data[].schema | string | 否 | 跳转 schema,例如 huputiyu://score/wiki?itemId=... |
135
+ | data.topComponents[].config.data[].hotCommentModels | array | 否 | 梗相关热评 |
136
+ | data.topComponents[].config.data[].hotCommentModels[] | object | 否 | 数组元素 |
137
+ | data.topComponents[].config.data[].image | array / null | 否 | 封面图列表,可能为 null |
138
+ | data.topComponents[].config.data[].image[] | string | 否 | 数组元素 |
139
+ | data.topComponents[].config.data[].videoDetail | object / null | 否 | 视频详情,可能为 null |
140
+ | data.topComponents[].config.hasMore | boolean | 否 | 是否还有更多 |
141
+ | data.topComponents[].config.moreDetailLink | string | 否 | 更多详情跳转 schema |
142
+ | data.topComponents[].config.addButton | object | 否 | 添加按钮配置 |
143
+ | data.topComponents[].config.addButton.addButtonTitle | string | 否 | 按钮文案 |
144
+ | data.topComponents[].config.addButton.addButtonLink | string | 否 | 按钮跳转链接 |
145
+ | data.tabConfigs | object | 否 | 页面 Tab 配置 |
146
+ | data.tabConfigs.showTab | boolean | 否 | 是否展示 Tab |
147
+ | data.tabConfigs.defaultTab | string | 否 | 默认选中的 Tab ID |
148
+ | data.tabConfigs.tabs | array | 否 | Tab 列表 |
149
+ | data.tabConfigs.tabs[].id | string | 否 | Tab ID |
150
+ | data.tabConfigs.tabs[].name | string | 否 | Tab 名称,例如 热议/赛程/资讯/讨论 |
151
+ | data.tabConfigs.tabs[].index | number | 否 | Tab 排序 |
152
+ | data.tabConfigs.tabs[].componentType | string | 否 | 组件类型,例如 DISCUSS_TAG、MATCH_SCHEDULE、NEWS、TAG_THREAD_LIST |
153
+ | data.tabConfigs.tabs[].config | object | 否 | Tab 组件配置与请求参数 |
154
+
155
+ # Examples
156
+
157
+ ```javascript
158
+ window.ShaperAI.score.getItemDetail({ itemId: "382586" }).then(res => { if (res.code === 200) { console.log(res.data.detail?.name, res.data.detail?.scoreAvg); } })
159
+ ```
160
+
161
+ # Frontend Request Guard
162
+
163
+ | 策略 | 默认值 |
164
+ | --- | --- |
165
+ | 同请求在途合并窗口 | 不启用(0ms) |
166
+ | GET 缓存 TTL | 不启用(0ms) |
167
+ | 请求超时 | 8000ms |
168
+ | 单能力最大并发 | 不限制 |
169
+ | 单能力分钟调用上限 | 不限制 |
170
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
171
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
172
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
173
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,263 @@
1
+ ---
2
+ name: hupu-score-get-score
3
+ description: 查看指定球员、装备等对象的平均评分和打分人数,便于在活动页展示该对象的打分情况。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.score.getScore(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须通过 window.ShaperAI.score.getScore(params) 接口,严禁直接拼凑网络接口 URL
13
+ - outBizType 和 outBizNo 均必填,且必须是合法的字符串标识
14
+ - 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
15
+ - 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
16
+ - SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
17
+
18
+ # Parameters
19
+
20
+ | 参数名 | 类型 | 是否必填 | 说明 |
21
+ | --- | --- | --- | --- |
22
+ | outBizType | string | 是 | 业务类型。常用可选值包括:nbaPlayer (NBA球员), cbaPlayer (CBA球员), equipment (运动装备), games (游戏), movie (电影影视), food (美食), school (高校) |
23
+ | outBizNo | string | 是 | 业务对象 ID,例如球员 ID |
24
+
25
+ # Returns
26
+
27
+ - Type: `Promise<Response>`
28
+
29
+ ### Response Properties
30
+
31
+ | 属性名 | 类型 | 是否必填 | 说明 |
32
+ | --- | --- | --- | --- |
33
+ | code | number | 否 | 业务状态码,1 表示成功 |
34
+ | type | string | 否 | 响应类型,例如 COMMON |
35
+ | msg | string | 否 | 提示信息,例如 "成功" |
36
+ | success | boolean | 否 | 是否请求成功 |
37
+ | data | object | 否 | 评分数据主体 |
38
+ | data.nodeId | number | 否 | 当前评分节点 ID |
39
+ | data.linkNodes | array | 否 | 关联节点/面包屑导航列表 |
40
+ | data.linkNodes[].nodeId | number | 否 | 节点 ID |
41
+ | data.linkNodes[].parentNodeId | number / null | 否 | 父节点 ID,可能为 null |
42
+ | data.linkNodes[].level | number | 否 | 节点层级 |
43
+ | data.linkNodes[].desc | string | 否 | 节点描述/名称 |
44
+ | data.linkNodes[].target | string | 否 | 跳转目标类型,例如 GROUP |
45
+ | data.linkNodes[].outBizKey | string / null | 否 | 外部业务标识,可能为 null |
46
+ | data.linkNodes[].schema | string | 否 | 跳转 schema 链接 |
47
+ | data.groupInfo | object | 否 | 所属榜单/分组信息 |
48
+ | data.groupInfo.groupId | number | 否 | 分组 ID |
49
+ | data.groupInfo.nodeId | number | 否 | 分组对应节点 ID |
50
+ | data.groupInfo.groupName | string | 否 | 分组名称 |
51
+ | data.groupInfo.jumpUrl | string | 否 | 分组跳转链接 |
52
+ | data.groupInfo.publishNum | number | 否 | 已发布数量 |
53
+ | data.groupInfo.recommendDesc | string | 否 | 推荐描述 |
54
+ | data.groupInfo.publishTime | string | 否 | 发布时间(格式化字符串,如 07-13) |
55
+ | data.groupInfo.publishTimeTs | number | 否 | 发布时间戳(毫秒) |
56
+ | data.groupInfo.creatorUser | number | 否 | 创建者用户 ID |
57
+ | data.detail | object | 否 | 评分对象详情 |
58
+ | data.detail.image | array | 否 | 封面图片 URL 列表 |
59
+ | data.detail.image[] | string | 否 | 数组元素 |
60
+ | data.detail.imageShape | string | 否 | 图片形状,例如 rectangle(矩形)、square(正方形) |
61
+ | data.detail.imageSize | string | 否 | 图片尺寸标识,例如 cover_87x122 |
62
+ | data.detail.minScoreUserCountLimit | number | 否 | 展示评分所需的最小打分人数阈值 |
63
+ | data.detail.bizId | string | 否 | 业务对象 ID |
64
+ | data.detail.bizType | string | 否 | 业务类型,例如 movie_movie |
65
+ | data.detail.name | string | 否 | 评分对象名称 |
66
+ | data.detail.infoJson | object | 否 | 扩展信息 JSON,值多为字符串数组形式 |
67
+ | data.detail.infoJson.machineCanScore | array | 否 | 是否允许机器评分 |
68
+ | data.detail.infoJson.machineCanScore[] | string | 否 | 数组元素 |
69
+ | data.detail.infoJson.scoreCountThreshold | array | 否 | 展示评分的人数阈值 |
70
+ | data.detail.infoJson.scoreCountThreshold[] | string | 否 | 数组元素 |
71
+ | data.detail.infoJson.canScore | array | 否 | 是否可评分 |
72
+ | data.detail.infoJson.canScore[] | string | 否 | 数组元素 |
73
+ | data.detail.infoJson.ipLocation | string | 否 | IP 归属地 |
74
+ | data.detail.infoJson.showScoreTrend | array | 否 | 是否展示评分趋势 |
75
+ | data.detail.infoJson.showScoreTrend[] | string | 否 | 数组元素 |
76
+ | data.detail.infoJson.show | array | 否 | 展示时间戳 |
77
+ | data.detail.infoJson.show[] | string | 否 | 数组元素 |
78
+ | data.detail.infoJson.link | array | 否 | 关联链接 |
79
+ | data.detail.infoJson.link[] | string | 否 | 数组元素 |
80
+ | data.detail.infoJson.showScore | array | 否 | 是否展示评分 |
81
+ | data.detail.infoJson.showScore[] | string | 否 | 数组元素 |
82
+ | data.detail.infoJson.selfCategory | string | 否 | 自身分类,例如 movie |
83
+ | data.detail.infoJson.commentAudioMax | array | 否 | 语音评论最大时长(秒) |
84
+ | data.detail.infoJson.commentAudioMax[] | string | 否 | 数组元素 |
85
+ | data.detail.infoJson.selfBizType | string | 否 | 自身业务类型 |
86
+ | data.detail.infoJson.selfBizId | number | 否 | 自身业务 ID |
87
+ | data.detail.infoJson.ugcBtnDesc | array | 否 | UGC 按钮文案 |
88
+ | data.detail.infoJson.ugcBtnDesc[] | string | 否 | 数组元素 |
89
+ | data.detail.infoJson.operationCanScore | array | 否 | 运营是否允许评分 |
90
+ | data.detail.infoJson.operationCanScore[] | string | 否 | 数组元素 |
91
+ | data.detail.infoJson.distributionControl | array | 否 | 分发控制配置(JSON 字符串) |
92
+ | data.detail.infoJson.distributionControl[] | string | 否 | 数组元素 |
93
+ | data.detail.infoJson.commentAudioMin | array | 否 | 语音评论最小时长(秒) |
94
+ | data.detail.infoJson.commentAudioMin[] | string | 否 | 数组元素 |
95
+ | data.detail.infoJson.allowUgc | array | 否 | 是否允许 UGC |
96
+ | data.detail.infoJson.allowUgc[] | boolean | 否 | 数组元素 |
97
+ | data.detail.infoJson.cover_87x122 | array | 否 | 87x122 尺寸封面图 |
98
+ | data.detail.infoJson.cover_87x122[] | string | 否 | 数组元素 |
99
+ | data.detail.infoJson.canComment | array | 否 | 是否可评论 |
100
+ | data.detail.infoJson.canComment[] | string | 否 | 数组元素 |
101
+ | data.detail.infoJson.selfName | string | 否 | 自身名称 |
102
+ | data.detail.infoJson.commentSupport | array | 否 | 支持的评论类型,例如 AUDIO |
103
+ | data.detail.infoJson.commentSupport[] | string | 否 | 数组元素 |
104
+ | data.detail.infoJson.desc | array | 否 | 描述信息,例如上映日期 |
105
+ | data.detail.infoJson.desc[] | string | 否 | 数组元素 |
106
+ | data.detail.scorePersonCount | number | 否 | 参与打分的人数 |
107
+ | data.detail.commentCount | number | 否 | 评论数 |
108
+ | data.detail.summedCommentCount | number | 否 | 累计评论数(含子项) |
109
+ | data.detail.summedScorePersonCount | number | 否 | 累计打分人数(含子项) |
110
+ | data.detail.totalScore | number | 否 | 总分值 |
111
+ | data.detail.scoreAvg | number | 否 | 平均评分分值(0 - 10) |
112
+ | data.detail.scoreDistribution | object | 否 | 评分分布,键为分值,值为对应人数 |
113
+ | data.detail.scoreSummaryTrend | object / null | 否 | 评分汇总趋势,可能为 null |
114
+ | data.detail.scoreTabLocate | string | 否 | 评分 Tab 默认定位,例如 scoreDistribution |
115
+ | data.detail.hottestComments | array | 否 | 最热评论文本列表 |
116
+ | data.detail.hottestComments[] | string | 否 | 数组元素 |
117
+ | data.detail.hotCommentModels | array | 否 | 热门评论模型列表 |
118
+ | data.detail.hotCommentModels[].commentUserId | number | 否 | 评论用户 ID |
119
+ | data.detail.hotCommentModels[].commentUserHeadImg | string | 否 | 评论用户头像 URL |
120
+ | data.detail.hotCommentModels[].commentUserName | string | 否 | 评论用户昵称 |
121
+ | data.detail.hotCommentModels[].commentContent | string | 否 | 评论内容 |
122
+ | data.detail.hotCommentModels[].commentId | string | 否 | 评论 ID |
123
+ | data.detail.hotCommentModels[].subjectId | string | 否 | 主题/帖子 ID |
124
+ | data.detail.hotCommentModels[].ancillaryContents | array / null | 否 | 评论附属内容(图片/音频等) |
125
+ | data.detail.hotCommentModels[].ancillaryContents[].commentContentId | string | 否 | 附属内容 ID |
126
+ | data.detail.hotCommentModels[].ancillaryContents[].commentContent | string | 否 | 附属内容 URL |
127
+ | data.detail.hotCommentModels[].ancillaryContents[].commentContentType | string | 否 | 附属内容类型,例如 IMAGE、AUDIO |
128
+ | data.detail.hotCommentModels[].ancillaryContents[].durationInSec | number / null | 否 | 时长(秒),音频有效,否则为 null |
129
+ | data.detail.hotCommentModels[].lightCount | number | 否 | 点亮/点赞数 |
130
+ | data.detail.hotCommentModels[].score | number | 否 | 该评论用户给出的评分 |
131
+ | data.detail.hotCommentModels[].parentCommentUserId | number / null | 否 | 父评论用户 ID,可能为 null |
132
+ | data.detail.hotCommentModels[].parentCommentUserName | string / null | 否 | 父评论用户昵称,可能为 null |
133
+ | data.detail.hotCommentModels[].parentCommentContent | string / null | 否 | 父评论内容,可能为 null |
134
+ | data.detail.hotCommentModels[].parentAncillaryContents | array / null | 否 | 父评论附属内容,可能为 null |
135
+ | data.detail.tagCategoryList | array / null | 否 | 标签分类列表,可能为 null |
136
+ | data.detail.userScore | number | 否 | 当前登录用户打的分数,未打分为 0 |
137
+ | data.detail.userScoreAvg | number / null | 否 | 当前用户平均评分,可能为 null |
138
+ | data.detail.status | number | 否 | 状态码 |
139
+ | data.detail.items | array / null | 否 | 子评分项列表,可能为 null |
140
+ | data.detail.parentBizKeys | array | 否 | 父业务标识列表 |
141
+ | data.detail.parentBizKeys[] | string | 否 | 数组元素 |
142
+ | data.detail.mostChosenTags | array / null | 否 | 最常选择的标签,可能为 null |
143
+ | data.detail.canScore | boolean | 否 | 是否可评分 |
144
+ | data.detail.canComment | boolean | 否 | 是否可评论 |
145
+ | data.detail.bgColor | string | 否 | 背景色(十六进制) |
146
+ | data.detail.maskColor | string | 否 | 蒙层颜色(十六进制含透明度) |
147
+ | data.detail.scoreItemAttributes | object | 否 | 评分项属性配置,值多为字符串数组形式 |
148
+ | data.detail.scoreItemAttributes.machineCanScore | array | 否 | 是否允许机器评分 |
149
+ | data.detail.scoreItemAttributes.machineCanScore[] | string | 否 | 数组元素 |
150
+ | data.detail.scoreItemAttributes.scoreCountThreshold | array | 否 | 展示评分的人数阈值 |
151
+ | data.detail.scoreItemAttributes.scoreCountThreshold[] | string | 否 | 数组元素 |
152
+ | data.detail.scoreItemAttributes.canScore | array | 否 | 是否可评分 |
153
+ | data.detail.scoreItemAttributes.canScore[] | string | 否 | 数组元素 |
154
+ | data.detail.scoreItemAttributes.showScoreTrend | array | 否 | 是否展示评分趋势 |
155
+ | data.detail.scoreItemAttributes.showScoreTrend[] | string | 否 | 数组元素 |
156
+ | data.detail.scoreItemAttributes.showScore | array | 否 | 是否展示评分 |
157
+ | data.detail.scoreItemAttributes.showScore[] | string | 否 | 数组元素 |
158
+ | data.detail.scoreItemAttributes.commentAudioMax | array | 否 | 语音评论最大时长(秒) |
159
+ | data.detail.scoreItemAttributes.commentAudioMax[] | string | 否 | 数组元素 |
160
+ | data.detail.scoreItemAttributes.ugcBtnDesc | array | 否 | UGC 按钮文案 |
161
+ | data.detail.scoreItemAttributes.ugcBtnDesc[] | string | 否 | 数组元素 |
162
+ | data.detail.scoreItemAttributes.operationCanScore | array | 否 | 运营是否允许评分 |
163
+ | data.detail.scoreItemAttributes.operationCanScore[] | string | 否 | 数组元素 |
164
+ | data.detail.scoreItemAttributes.distributionControl | array | 否 | 分发控制配置(JSON 字符串) |
165
+ | data.detail.scoreItemAttributes.distributionControl[] | string | 否 | 数组元素 |
166
+ | data.detail.scoreItemAttributes.commentAudioMin | array | 否 | 语音评论最小时长(秒) |
167
+ | data.detail.scoreItemAttributes.commentAudioMin[] | string | 否 | 数组元素 |
168
+ | data.detail.scoreItemAttributes.allowUgc | array | 否 | 是否允许 UGC |
169
+ | data.detail.scoreItemAttributes.allowUgc[] | string | 否 | 数组元素 |
170
+ | data.detail.scoreItemAttributes.canComment | array | 否 | 是否可评论 |
171
+ | data.detail.scoreItemAttributes.canComment[] | string | 否 | 数组元素 |
172
+ | data.detail.scoreItemAttributes.commentSupport | array | 否 | 支持的评论类型 |
173
+ | data.detail.scoreItemAttributes.commentSupport[] | string | 否 | 数组元素 |
174
+ | data.detail.del | number | 否 | 是否删除,0 表示未删除 |
175
+ | data.detail.finalStatus | string | 否 | 最终审核状态,例如 PASS |
176
+ | data.detail.specialStyle | object / null | 否 | 特殊样式配置,可能为 null |
177
+ | data.detail.creatorId | number / null | 否 | 创建者 ID,可能为 null |
178
+ | data.detail.creatorName | string / null | 否 | 创建者名称,可能为 null |
179
+ | data.detail.creatorAvatar | string / null | 否 | 创建者头像,可能为 null |
180
+ | data.detail.bgImage | string / null | 否 | 背景图,可能为 null |
181
+ | data.detail.shareBgImage | string / null | 否 | 分享背景图,可能为 null |
182
+ | data.detail.scoreItemNodeId | array | 否 | 评分项节点 ID 列表 |
183
+ | data.detail.scoreItemNodeId[] | number | 否 | 数组元素 |
184
+ | data.detail.createDt | string | 否 | 创建时间(ISO 时间字符串) |
185
+ | data.detail.permissions | array | 否 | 权限列表 |
186
+ | data.detail.permissions[] | string | 否 | 数组元素 |
187
+ | data.detail.allowUgc | boolean | 否 | 是否允许 UGC 添加评分对象 |
188
+ | data.detail.ugcBtnDesc | string | 否 | UGC 按钮文案,例如"添加评分对象" |
189
+ | data.detail.scoreResources | object | 否 | 评分资源配置 |
190
+ | data.detail.visible | boolean / null | 否 | 是否可见,可能为 null |
191
+ | data.detail.videoDetail | object / null | 否 | 视频详情,可能为 null |
192
+ | data.detail.parentBizKey | string / null | 否 | 父业务标识,可能为 null |
193
+ | data.detail.typeMapping | object / null | 否 | 类型映射,可能为 null |
194
+ | data.detail.uniqueItem | boolean | 否 | 是否唯一评分项 |
195
+ | data.detail.ipLocation | string | 否 | IP 归属地 |
196
+ | data.detail.publishTime | string | 否 | 发布时间(格式化字符串,如 06-23) |
197
+ | data.detail.scoreColorDay | string | 否 | 日间模式评分颜色(十六进制) |
198
+ | data.detail.scoreColorNight | string | 否 | 夜间模式评分颜色(十六进制) |
199
+ | data.detail.scoreValueHighlight | boolean | 否 | 评分值是否高亮 |
200
+ | data.detail.relatedModelList | array | 否 | 关联模型列表 |
201
+ | data.detail.relatedModelList[] | object | 否 | 数组元素 |
202
+ | data.detail.poiBizKey | string / null | 否 | POI 业务标识,可能为 null |
203
+ | data.detail.shareBizKey | string / null | 否 | 分享业务标识,可能为 null |
204
+ | data.detail.distance | number / null | 否 | 距离,可能为 null |
205
+ | data.detail.bindTagThread | boolean | 否 | 是否绑定标签帖子 |
206
+ | data.detail.textLink | string / null | 否 | 文本链接,可能为 null |
207
+ | data.detail.itemId | number | 否 | 评分项 ID |
208
+ | data.detail.itemType | string | 否 | 评分项类型,例如 normal |
209
+ | data.detail.showScore | boolean | 否 | 是否展示评分 |
210
+ | data.detail.resourceMark | string / null | 否 | 资源标记,可能为 null |
211
+ | data.detail.resourceDetail | object / null | 否 | 资源详情,可能为 null |
212
+ | data.detail.resourceConfig | object / null | 否 | 资源配置,可能为 null |
213
+ | data.detail.commentConfig | object | 否 | 评论配置 |
214
+ | data.detail.commentConfig.commentAudioSupport | boolean | 否 | 是否支持语音评论 |
215
+ | data.detail.commentConfig.commentAudioMax | number | 否 | 语音评论最大时长(秒) |
216
+ | data.detail.commentConfig.commentAudioMin | number | 否 | 语音评论最小时长(秒) |
217
+ | data.detail.hotStatements | array | 否 | 热门短评/观点列表 |
218
+ | data.detail.hotStatements[] | object | 否 | 数组元素 |
219
+ | data.detail.deepTalk | object | 否 | AI 深度聊天(问 AI)配置 |
220
+ | data.detail.deepTalk.needShow | boolean | 否 | 是否展示入口 |
221
+ | data.detail.deepTalk.iconDay | string | 否 | 日间模式图标 URL |
222
+ | data.detail.deepTalk.iconNight | string | 否 | 夜间模式图标 URL |
223
+ | data.detail.deepTalk.iconName | string | 否 | 入口名称,例如"问AI" |
224
+ | data.detail.deepTalk.guideName | string / null | 否 | 引导文案,可能为 null |
225
+ | data.detail.deepTalk.guideNameSubtitle | string / null | 否 | 引导副标题 |
226
+ | data.detail.deepTalk.guideOutTime | number | 否 | 引导消失时间(秒) |
227
+ | data.detail.deepTalk.guideStayTime | number | 否 | 引导停留时间(秒) |
228
+ | data.detail.deepTalk.replyAiShow | boolean | 否 | 回复中是否展示 AI 入口 |
229
+ | data.detail.deepTalk.replyGuideName | string / null | 否 | 回复引导文案,可能为 null |
230
+ | data.parent | object / null | 否 | 父节点信息,可能为 null |
231
+ | data.hasSubNodes | boolean | 否 | 是否存在子节点 |
232
+ | data.subNodes | array / null | 否 | 子节点列表,可能为 null |
233
+ | data.pageResource | object | 否 | 页面资源与跳转链接配置 |
234
+ | data.pageResource.showSearchButton | boolean | 否 | 是否展示搜索按钮 |
235
+ | data.pageResource.searchSchema | string | 否 | 搜索页跳转 schema |
236
+ | data.pageResource.shareUrl | string | 否 | 分享链接 |
237
+ | data.pageResource.scoreCommunityGuidelinesUrl | string | 否 | 评分社区公约链接 |
238
+ | data.pageResource.scoreEditUrl | string | 否 | 评分编辑跳转 schema |
239
+ | data.pageResource.scoreItemSupplementUrl | string | 否 | 评分对象补充跳转 schema |
240
+ | data.pageResource.commentManagementUrl | string | 否 | 评论管理跳转 schema |
241
+ | data.pageResource.uniqueItemSearchSchema | string / null | 否 | 唯一评分项搜索 schema,可能为 null |
242
+ | data.location | object / null | 否 | 定位信息,可能为 null |
243
+ | data.showTabs | boolean | 否 | 是否展示 Tab 切换 |
244
+
245
+ # Examples
246
+
247
+ ```javascript
248
+ window.ShaperAI.score.getScore({ outBizType: "nbaPlayer", outBizNo: "12345" })
249
+ ```
250
+
251
+ # Frontend Request Guard
252
+
253
+ | 策略 | 默认值 |
254
+ | --- | --- |
255
+ | 同请求在途合并窗口 | 不启用(0ms) |
256
+ | GET 缓存 TTL | 不启用(0ms) |
257
+ | 请求超时 | 8000ms |
258
+ | 单能力最大并发 | 不限制 |
259
+ | 单能力分钟调用上限 | 不限制 |
260
+ | 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
261
+ | 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
262
+ | 连续失败熔断 | 3 次失败后熔断 30000ms |
263
+ | 自动分页建议上限 | 5 页 |
@@ -0,0 +1,7 @@
1
+ # 检查与优化
2
+
3
+ 安全检查、WASM 压缩。本目录仅分类,技能内容暂不重构。
4
+
5
+ - [hupu-security-check-audit](hupu-security-check-audit/SKILL.md)
6
+ - [hupu-wasm-compression](hupu-wasm-compression/SKILL.md)
7
+ - [hupu-web-security-audit](hupu-web-security-audit/SKILL.md)
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: hupu-security-check-audit
3
+ description: 在用户提交文本内容或触发图片生成前,调用风控接口进行敏感内容安全检测。支持敏感词检测,自动识别未登录状态并统一返回 code、message 与 data 结构。
4
+ ---
5
+
6
+ # Usage
7
+
8
+ - JS Path: `window.ShaperAI.security.checkAudit(params)`
9
+
10
+ # Constraints
11
+
12
+ - 必须且只能通过 window.ShaperAI.security.checkAudit(content) 接口进行敏感词检测,严禁直接手写原始风控接口 URL
13
+ - 未登录时,返回 { code: 401, message: "用户未登录", data: null };前端应及时拦截提交并提示用户登录
14
+ - 校验正常请求成功时,返回 { code: 200, message: "success", data: boolean },其中 data 为 true 代表安全通过,data 为 false 代表包含敏感内容需予以拦截提示
15
+ - 接口异常或网络超时等系统级错误时,返回 { code: 500, message: "请求失败", data: null },需做好友好兜底提示
16
+
17
+ # Parameters
18
+
19
+ | 参数名 | 类型 | 是否必填 | 说明 |
20
+ | --- | --- | --- | --- |
21
+ | content | string | 是 | 待检测的文本内容字符串 |
22
+
23
+ # Returns
24
+
25
+ - Type: `Promise<Response>`
26
+
27
+ ### Response Properties
28
+
29
+ | 属性名 | 类型 | 是否必填 | 说明 |
30
+ | --- | --- | --- | --- |
31
+ | code | number | 是 | 状态码:200 成功,401 未登录,500 异常 |
32
+ | message | string | 是 | 提示信息 |
33
+ | data | boolean | 否 | 是否安全通过,true 表示安全,false 表示包含敏感拦截 |
34
+
35
+ # Examples
36
+
37
+ ```javascript
38
+ window.ShaperAI.security.checkAudit("测试文本").then(res => { if (res.code === 200 && res.data === true) { console.log("通过"); } })
39
+ ```
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: hupu-wasm-compression
3
+ description: 用户需要压缩 .wasm、减小WebAssembly 文件的下载体积,或反馈 WASM 文件太大、已确认下载瓶颈来自 .wasm 资源时,主动提示可使用 WASM 压缩工具;按需启动附带的 Node 网页,上传文件并比较 Brotli、gzip、zstd,下载结果、验证流式加载。不用于普通 WASM 编程、运行内存优化或压缩其他数据的算法库选型。
4
+ ---
5
+
6
+ # WASM 压缩工具
7
+
8
+ 帮助用户发现和使用附带的本地网页工具。支持压缩 WASM 文件,不需要源码。压缩发生在 Node 中,页面负责上传、对比和下载。
9
+
10
+ ## 何时提示用户
11
+
12
+ 当用户明确提出“压缩 wasm”“这个wasm 太大”“减少 wasm 下载体积”,或已确认下载瓶颈来自 `.wasm` 资源时,主动提示:
13
+
14
+ > 可以使用 WASM 压缩工具:上传现成的 .wasm,比较 Brotli、gzip、zstd 的压缩体积和耗时,再下载压缩文件。无需源码,不附带内置文件,也不设文件大小上限。在线使用时,服务器需要配置对应的 Content-Encoding。
15
+
16
+ 提示一次即可,根据用户任务调整措辞。若用户已明确要求使用工具、打开页面或执行压缩,直接继续启动步骤。若只是分析加载性能,先简短提示可用工具并继续原任务,不擅自开启服务或改写业务加载代码。
17
+
18
+ 仅仅出现 WebAssembly、WASM API、编译报错、运行内存或 ZIP 需求时,不推荐本工具。传输压缩减少网络字节,不能承诺降低还原后的模块体积、编译开销或运行内存。
19
+
20
+ ## 使用工具
21
+
22
+ 所有下列路径都相对于本 `SKILL.md` 所在目录,不依赖 Agent 的工作目录,也不使用某位开发者机器上的绝对路径。
23
+
24
+ 1. 检查 `node --version`,使用 Node.js 24 或更新版本。可执行以下命令检查 Zstd API:
25
+
26
+ ```bash
27
+ node -e "if (typeof require('node:zlib').zstdCompressSync !== 'function') process.exit(1)"
28
+ ```
29
+
30
+ 2. 用 Agent 的后台进程工具启动服务,保留进程句柄以便停止。`<skill-dir>` 替换为实际已安装的 skill 目录:
31
+
32
+ ```bash
33
+ node "<skill-dir>/tool/server.mjs"
34
+ ```
35
+
36
+ 默认监听 `127.0.0.1:8787`,终端会打印实际地址。端口占用时,不结束未知进程;改用一个空闲端口启动,例如:
37
+
38
+ ```bash
39
+ PORT=8788 node "<skill-dir>/tool/server.mjs"
40
+ ```
41
+
42
+ 3. 启动成功后打开或提供终端打印的本地 URL。先确认服务可访问,再说明已经启动。不把 `127.0.0.1` 当成远程用户机器的地址;运行环境无法将页面提供给用户时,给出用户本机的启动命令。
43
+ 4. 用户在页面选择或拖入自己的 `.wasm`,勾选算法,选择快速档或最小体积档,点击“开始压缩对比”。不添加内置样本或人为文件大小上限。每个产物会在 Node 回解并进行原始字节与 SHA-256 校验。
44
+ 5. 用户可下载 `.br` / `.gz` / `.zst`,导出 JSON 测量报告,或点击“验证流式加载”。验证使用浏览器原生 Content-Encoding 解码和 `WebAssembly.compileStreaming`,只编译,不实例化或执行用户模块。不为验证而补写 imports 或伪造JS 胶水。
45
+ 6. 用户要求关闭时,只停止自己启动的服务。若工具仍供用户操作,保持运行并告知访问地址。
46
+
47
+ 没有终端权限或完整附件时,准确说明不能在当前环境直接启动,提供取得完整 SDK 包后的路径 `dist/skills/hupu-wasm-compression/tool/server.mjs` 和 Node 启动方式;不要发明公网工具 URL 或 `window.ShaperAI.wasm.*` API。能力市场当前只复制提示词,不能据此声称附件已安装或服务已运行。
48
+
49
+ ## 结果与部署说明
50
+
51
+ - 优先用 Brotli 做静态预压缩,gzip 作为回退;具体体积以本次文件的实测结果为准。最小体积档使用 br 11 / gzip 9 / zstd 19,快速档使用 br 5 / gzip 6 / zstd 3。
52
+ - 上传和压缩只在启动服务的机器上处理。当前实现整份缓冲文件、worker 输入和结果;不设应用层大小上限,实际容量受可用内存和 Node 限制。
53
+ - 演示服务串行运行压缩任务,最多保留 6 个任务、保留 30 分钟,单任务超时 120 秒;重启服务会清空结果。不要把这些限制说成无限吞吐或生产级服务。
54
+ - 下载接口返回压缩原始字节,不带 Content-Encoding;用于浏览器加载的接口才返回 `Content-Type: application/wasm`、对应 `Content-Encoding` 和 `Vary: Accept-Encoding`。正式部署需由用户服务器/CDN 配置这些响应头。
55
+ - 浏览器能否解码 zstd 与 Node 能否生成 zstd 是独立问题。验证失败时如实展示原因,必要时使用 gzip 或自动协商,不保证所有浏览器支持。
56
+ - 这是开发者本地工具,不嵌入活动 H5,不向线上业务页添加 localhost 请求,不改变 SDK 全局对象或业务网络约定。
57
+
58
+ ## 附件与检查
59
+
60
+ - `tool/server.mjs`:本地 HTTP 服务、上传、任务管理、文件下载和编码协商。
61
+ - `tool/compress-worker.mjs`:Node zlib 三种算法及无损回解校验。
62
+ - `tool/public/`:上传操作页面。
63
+ - `tool/checks.mjs`:无需二进制附件的集成检查;使用运行时生成的 WASM 数据。
64
+
65
+ ```bash
66
+ node --test "<skill-dir>/tool/checks.mjs"
67
+ ```
68
+
69
+ 触发示例:“wasm 有 80 MB,能不能压小一点?”应提示工具;“打开 WASM 压缩页面,我要上传文件”应启动工具;“解释 WebAssembly.Memory.grow”应继续解释内存 API,不推荐本工具。
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "WASM 文件压缩"
3
+ short_description: "提示并启动本地 WASM 压缩网页,比较 Brotli、gzip、zstd 并下载结果"
4
+ default_prompt: "使用 $hupu-wasm-compression 帮我压缩 WASM 文件,启动本地上传页面并说明如何下载和部署压缩结果。"