@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,291 @@
1
+ <!doctype html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <script type="application/json" id="shaper-skill-usage">
5
+ {
6
+ "skills": [
7
+ "hupu-cloud-auth",
8
+ "hupu-cloud-request",
9
+ "user-feedback"
10
+ ]
11
+ }
12
+ </script>
13
+ <meta charset="UTF-8" />
14
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
15
+ <title>积分排行榜</title>
16
+ <style>
17
+ :root {
18
+ color: #3d3d3d;
19
+ background: #f4f7f8;
20
+ font-family:
21
+ 'PingFang SC',
22
+ -apple-system,
23
+ BlinkMacSystemFont,
24
+ 'Segoe UI',
25
+ Roboto,
26
+ Helvetica,
27
+ Arial,
28
+ sans-serif;
29
+ font-variant-numeric: tabular-nums;
30
+ }
31
+
32
+ * {
33
+ box-sizing: border-box;
34
+ }
35
+
36
+ body {
37
+ min-width: 320px;
38
+ min-height: 100vh;
39
+ margin: 0;
40
+ background: #f4f7f8;
41
+ }
42
+
43
+ main {
44
+ width: min(100%, 390px);
45
+ min-height: 100vh;
46
+ padding: 34px 16px 24px;
47
+ margin: 0 auto;
48
+ background: #ffffff;
49
+ }
50
+
51
+ header {
52
+ padding-bottom: 15px;
53
+ border-bottom: 1px solid #edf3f4;
54
+ }
55
+
56
+ h1 {
57
+ margin: 0;
58
+ color: #1a1f26;
59
+ font-size: 20px;
60
+ font-weight: 600;
61
+ line-height: 1.35;
62
+ }
63
+
64
+ .live-status {
65
+ display: block;
66
+ margin-top: 5px;
67
+ color: #4a8b8f;
68
+ font-size: 11px;
69
+ line-height: 1.4;
70
+ }
71
+
72
+ .my-rank {
73
+ display: grid;
74
+ gap: 3px;
75
+ padding: 15px 0 14px;
76
+ border-bottom: 1px solid #edf3f4;
77
+ }
78
+
79
+ .my-rank-label {
80
+ color: #6f7e8c;
81
+ font-size: 12px;
82
+ line-height: 1.4;
83
+ }
84
+
85
+ .my-rank-value {
86
+ color: #1a1f26;
87
+ font-size: 20px;
88
+ font-weight: 600;
89
+ line-height: 1.35;
90
+ }
91
+
92
+ .leaderboard {
93
+ padding-top: 1px;
94
+ border-top: 1px solid #d8e3e8;
95
+ }
96
+
97
+ .load-status {
98
+ padding: 22px 0;
99
+ color: #6f7e8c;
100
+ font-size: 12px;
101
+ text-align: center;
102
+ }
103
+
104
+ .leaderboard-row {
105
+ display: grid;
106
+ grid-template-columns: 24px 32px minmax(0, 1fr) auto;
107
+ min-height: 58px;
108
+ align-items: center;
109
+ column-gap: 8px;
110
+ border-bottom: 1px solid #edf3f4;
111
+ }
112
+
113
+ .leaderboard-row.current-user {
114
+ padding: 0 8px;
115
+ margin: 0 -8px;
116
+ background: #f0f7f7;
117
+ border-bottom-color: #d5e8e8;
118
+ }
119
+
120
+ .rank {
121
+ display: grid;
122
+ min-width: 24px;
123
+ place-items: center;
124
+ color: #6f7e8c;
125
+ font-size: 12px;
126
+ line-height: 1;
127
+ }
128
+
129
+ .rank.top-one {
130
+ color: #b27a2c;
131
+ }
132
+
133
+ .rank.top-two {
134
+ color: #778692;
135
+ }
136
+
137
+ .rank.top-three {
138
+ color: #9b633e;
139
+ }
140
+
141
+ .avatar {
142
+ display: grid;
143
+ width: 32px;
144
+ height: 32px;
145
+ place-items: center;
146
+ color: #ffffff;
147
+ font-size: 12px;
148
+ background: #78aeb0;
149
+ border-radius: 50%;
150
+ }
151
+
152
+ .current-user .avatar {
153
+ background: #4a8b8f;
154
+ }
155
+
156
+ .name {
157
+ min-width: 0;
158
+ overflow: hidden;
159
+ color: #3d3d3d;
160
+ font-size: 13px;
161
+ line-height: 1.4;
162
+ text-overflow: ellipsis;
163
+ white-space: nowrap;
164
+ }
165
+
166
+ .me {
167
+ display: inline-block;
168
+ padding: 1px 4px;
169
+ margin-left: 5px;
170
+ color: #4a8b8f;
171
+ font-size: 10px;
172
+ line-height: 1.2;
173
+ background: #dceeee;
174
+ }
175
+
176
+ .score {
177
+ color: #1a1f26;
178
+ font-size: 13px;
179
+ font-weight: 600;
180
+ line-height: 1.35;
181
+ }
182
+
183
+ @media (min-width: 480px) {
184
+ body {
185
+ display: grid;
186
+ place-items: center;
187
+ padding: 24px;
188
+ }
189
+
190
+ main {
191
+ min-height: 640px;
192
+ border: 1px solid #d8e3e8;
193
+ }
194
+ }
195
+ </style>
196
+ </head>
197
+ <body>
198
+ <main>
199
+ <header>
200
+ <h1>积分排行榜</h1>
201
+ <span class="live-status">实时榜单</span>
202
+ </header>
203
+
204
+ <section class="my-rank" aria-label="我的排名">
205
+ <span class="my-rank-label">我的排名</span>
206
+ <strong class="my-rank-value" id="my-rank-value">正在加载</strong>
207
+ </section>
208
+
209
+ <section class="leaderboard" aria-label="积分排行榜列表" id="leaderboard-list">
210
+ <div class="load-status" id="load-status">正在加载榜单...</div>
211
+ </section>
212
+ </main>
213
+
214
+ <script>
215
+ window.ACTIVITY_API_BASE = "";
216
+ window.ACTIVITY_ENV_ID = "";
217
+
218
+ const rankValue = document.getElementById("my-rank-value");
219
+ const leaderboardList = document.getElementById("leaderboard-list");
220
+ const loadStatus = document.getElementById("load-status");
221
+
222
+ function showStatus(message) {
223
+ loadStatus.textContent = message;
224
+ }
225
+
226
+ function initials(name) {
227
+ return String(name || "虎").trim().slice(0, 1) || "虎";
228
+ }
229
+
230
+ function renderLeaderboard(entries) {
231
+ if (!entries.length) {
232
+ showStatus("暂时还没有成绩");
233
+ return;
234
+ }
235
+ leaderboardList.innerHTML = entries.map((entry) => {
236
+ const rankClass = entry.rank === 1 ? "top-one" : entry.rank === 2 ? "top-two" : entry.rank === 3 ? "top-three" : "";
237
+ const currentClass = entry.isCurrent ? " current-user" : "";
238
+ const currentLabel = entry.isCurrent ? '<span class="me">我</span>' : "";
239
+ return `<div class="leaderboard-row${currentClass}">
240
+ <span class="rank ${rankClass}">${entry.rank}</span>
241
+ <span class="avatar" aria-hidden="true">${initials(entry.displayName)}</span>
242
+ <span class="name">${escapeHtml(entry.displayName)}${currentLabel}</span>
243
+ <span class="score">${Number(entry.score).toLocaleString("zh-CN")}</span>
244
+ </div>`;
245
+ }).join("");
246
+ }
247
+
248
+ function escapeHtml(value) {
249
+ return String(value).replace(/[&<>'"]/g, (char) => ({
250
+ "&": "&amp;", "<": "&lt;", ">": "&gt;", "'": "&#39;", '"': "&quot;"
251
+ }[char]));
252
+ }
253
+
254
+ async function request(path, options = {}) {
255
+ if (!window.ACTIVITY_API_BASE || !window.ACTIVITY_ENV_ID || !window.ShaperAI?.cloud) {
256
+ throw new Error("榜单服务暂未配置");
257
+ }
258
+ const response = await window.ShaperAI.cloud.request({
259
+ url: window.ACTIVITY_API_BASE + path,
260
+ method: options.method || "GET",
261
+ data: options.data,
262
+ envId: window.ACTIVITY_ENV_ID,
263
+ auth: true
264
+ });
265
+ if (response.statusCode === 401) throw new Error("请先登录");
266
+ if (response.statusCode !== 200 || response.code !== 0) {
267
+ throw new Error(response.message || "榜单加载失败");
268
+ }
269
+ return response.data;
270
+ }
271
+
272
+ async function loadLeaderboard() {
273
+ try {
274
+ const auth = await window.ShaperAI.cloud.auth({ envId: window.ACTIVITY_ENV_ID });
275
+ if (!auth || auth.code !== 200) throw new Error(auth?.message || "请先登录");
276
+ const [entries, mine] = await Promise.all([
277
+ request("/leaderboard"),
278
+ request("/leaderboard/me")
279
+ ]);
280
+ renderLeaderboard(Array.isArray(entries) ? entries : []);
281
+ rankValue.textContent = mine ? `第 ${mine.rank} 名` : "暂未上榜";
282
+ } catch (error) {
283
+ rankValue.textContent = "暂不可用";
284
+ showStatus(error.message || "榜单加载失败");
285
+ }
286
+ }
287
+
288
+ loadLeaderboard();
289
+ </script>
290
+ </body>
291
+ </html>
@@ -0,0 +1,54 @@
1
+ -- Reuse the platform demo table as the activity leaderboard.
2
+ alter table public.demo_items rename to leaderboard_entries;
3
+ truncate table public.leaderboard_entries;
4
+
5
+ alter table public.leaderboard_entries
6
+ alter column puid set not null,
7
+ add column if not exists score integer not null default 0,
8
+ add column if not exists display_name text not null default 'Hupu User',
9
+ add column if not exists updated_at timestamptz not null default now();
10
+
11
+ create unique index if not exists leaderboard_entries_puid_uidx
12
+ on public.leaderboard_entries (puid);
13
+ create index if not exists leaderboard_entries_score_idx
14
+ on public.leaderboard_entries (score desc, updated_at asc, id asc);
15
+
16
+ alter table public.leaderboard_entries disable row level security;
17
+
18
+ create or replace function public.submit_leaderboard_score(
19
+ p_puid text,
20
+ p_display_name text,
21
+ p_score integer
22
+ )
23
+ returns public.leaderboard_entries
24
+ language plpgsql
25
+ security definer
26
+ set search_path = public
27
+ as $$
28
+ declare
29
+ result public.leaderboard_entries;
30
+ begin
31
+ insert into public.leaderboard_entries (puid, display_name, score, created_at, updated_at)
32
+ values (p_puid, p_display_name, p_score, now(), now())
33
+ on conflict (puid) do update
34
+ set display_name = excluded.display_name,
35
+ score = excluded.score,
36
+ updated_at = now()
37
+ where public.leaderboard_entries.score < excluded.score
38
+ returning * into result;
39
+
40
+ if result.id is null then
41
+ select * into result
42
+ from public.leaderboard_entries
43
+ where puid = p_puid;
44
+ end if;
45
+ return result;
46
+ end;
47
+ $$;
48
+
49
+ grant all on table public.leaderboard_entries to public;
50
+ grant usage on schema public to anon, authenticated, service_role, public;
51
+ grant select on table public.leaderboard_entries to anon, authenticated, service_role, public;
52
+ grant insert, update, delete on table public.leaderboard_entries to authenticated, service_role, public;
53
+ grant execute on function public.submit_leaderboard_score(text, text, integer)
54
+ to public, anon, authenticated, service_role;
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: hupu-lottery-draw
3
+ description: 使用活动数据存储和 OSS 文件上传创建可运行的抽卡 H5 页面;适用于“实现一个抽卡功能”“做抽卡/扭蛋/卡池页面”等请求,不用于仅展示静态卡片、离线随机示例或现金博彩/提现玩法。
4
+ metadata:
5
+ required-skills:
6
+ - act-cloudbase
7
+ - hupu-cloud-request
8
+ - hupu-oss-upload-file
9
+ ---
10
+
11
+ # 抽卡功能模版
12
+
13
+ 当用户提出“实现一个抽卡功能”或同义需求时,生成真实可运行的移动端原生 H5,而不是 UI 草图。页面应展示卡池、稀有度、概率和剩余次数,允许用户在服务端确认后抽卡,并提供用户主动上传抽卡结果图/头像等可选素材。默认面向活动积分或免费次数,不实现现金下注、提现或可兑换现金的博彩机制。
14
+
15
+ ## 必须使用的能力
16
+
17
+ - `act-cloudbase`:在预置的 `activity_api` 和 `demo_items` 基线上改造 PostgreSQL 表、事务 RPC、云函数和 `/api` 网关,保存卡池配置、卡片库存、用户次数与抽卡明细。
18
+ - `hupu-cloud-request`:通过 `window.ShaperAI.cloud.request` 访问公开和抽卡接口。
19
+ - `hupu-oss-upload-file`:只在用户主动选择文件后调用 `window.ShaperAI.oss.uploadFile`,把返回的 HTTPS CDN 地址作为可选 `proofUrl` 传给抽卡接口。
20
+
21
+ ## 实施顺序
22
+
23
+ 1. 先阅读 `example/migrations/20260828220000_create_draw.sql` 和 `example/README.md`,在 `act-cloudbase` 预置的 `activity_api` / `demo_items` 基线上改造,保留环境、权限、CORS 和迁移留档约定。
24
+ 2. 复制 `example/index.html` 到活动的 `h5/index.html`,替换活动 ID、卡池 ID、标题和网关地址。页面必须是单一原生 HTML/CSS/JS,可双击打开,不引入 Vue、React、Vite 或运行时打包器。
25
+ 3. 公开读取卡池配置和最近公开结果,以及次数、记录和抽卡动作,都使用 `window.ShaperAI.cloud.request`;由服务端从网关注入的上下文识别请求用户并校验业务参数。禁止页面直接 `fetch`、拼接 Bearer、提交用户身份字段或从 URL 接受用户身份。
26
+ 4. 抽卡按钮在请求期间禁用并采用 `idle -> drawing -> success/error` 状态。请求只提交 `{ poolId, drawCount, proofUrl? }`;服务端从网关注入的 `x-cloudbase-context` 读取用户,校验活动时间、次数、批量上限、卡池白名单与 `X-Request-Id` 幂等键,再以事务原子扣减库存并写入明细。
27
+ 5. 页面必须覆盖加载中、空卡池、网络失败、活动未开始/已结束、次数不足、库存不足和重复请求状态。错误优先展示服务端 `message`,不得用本地随机结果伪造线上成功。
28
+ 6. 概率展示必须来自服务端配置并明确“仅供展示”;稀有度与保底规则用业务语言说明。服务端使用数据库事务内的安全随机源,返回 `drawId`、卡片信息、剩余次数和保底进度,避免返回内部随机种子。
29
+ 7. 上传素材只在用户点击文件选择后执行:限制图片 MIME(JPEG/PNG/WebP)和 10MB 大小,调用 `window.ShaperAI.oss.uploadFile({ file, filename })`,检查 `downloadUrl` 是绝对 `https://` URL 后才把它用于抽卡请求。上传失败不能继续抽卡,也不能自动重试或伪造成功。
30
+ 8. 交付前按 `act-cloudbase` 完成迁移、函数、网关和接口冒烟;真实接入完成后,在工作区根目录运行 `node skills/runbook/scripts/scan-skill-usage.mjs`,让 `h5/index.html` 的技能使用声明与实际 SDK 调用一致。
31
+
32
+ ## 示例目录
33
+
34
+ `example/` 是可直接参考的最小完整实现,不是第二套独立能力:
35
+
36
+ - `example/index.html`:原生移动端抽卡页面,包含公开卡池、次数/记录、单抽/十连、上传素材和完整状态处理。
37
+ - `example/cloudfunctions/activity_api/`:固定 `activity_api` HTTP 云函数示例,提供 `/health`、`/pool`、`/draw/quota`、`/draw/results` 和 `/draw`。
38
+ - `example/migrations/20260828220000_create_draw.sql`:复用 `demo_items` 作为卡池配置,并创建卡片、用户额度、抽卡会话和明细表;事务 RPC 负责加权抽取、库存扣减和幂等。
39
+
40
+ 复制示例时,先替换页面中的活动环境配置,再根据实际奖品和次数规则调整种子数据;不要把示例中的演示结果或环境占位符作为生产回退。
41
+
42
+ ## 抽卡规则
43
+
44
+ - 默认单抽/十连的 `drawCount` 范围是 1 到 10,服务端再次校验,不接受前端传入的用户 ID、库存或随机结果。
45
+ - 概率按卡片 `weight` / 卡池总权重计算,仅供展示;库存耗尽的卡片不参与抽取。所有扣减和明细写入在同一事务中完成。
46
+ - `X-Request-Id` 必须是 RFC4122 UUID;同一用户、卡池和请求 ID重试时返回原抽卡会话,不重复扣次数或库存。
47
+ - 默认每个用户拥有卡池配置的免费次数;同分/保底等业务规则需要在页面和服务端同时说明,不能只在前端实现。
48
+ - 公开接口不返回用户身份和私密明细;涉及用户数据的接口只从 `x-cloudbase-context` 获取请求上下文。
49
+
50
+ 完成后应留下活动的 `h5/index.html`、迁移 SQL、`activity_api` 云函数改造记录和活动 manifest,并说明真实网关 URL、概率来源、次数限制、幂等策略及异常降级行为。`example/` 中的文件用于参考,不应直接作为活动线上资源发布。
@@ -0,0 +1,21 @@
1
+ # Draw Example
2
+
3
+ This directory is the reference implementation for the `hupu-lottery-draw` skill. It is a standalone, mobile-first H5 with a CloudBase HTTP Function and PostgreSQL migration.
4
+
5
+ ## Contents
6
+
7
+ - `index.html`: native HTML/CSS/JS card-pool page. It uses public `GET /api/pool`, authenticated quota/history reads, authenticated draw requests, and optional user-selected image uploads through `window.ShaperAI.oss.uploadFile`.
8
+ - `cloudfunctions/activity_api/`: one HTTP function listening on port `9000`, with `/health`, `/pool`, `/draw/quota`, `/draw/results`, and `POST /draw` routes.
9
+ - `migrations/20260828220000_create_draw.sql`: renames the platform `demo_items` baseline to `draw_pools`, creates prize, quota, session, and draw-record tables, seeds a pool, and installs the transactional `perform_draw` RPC.
10
+
11
+ ## API contract
12
+
13
+ - `GET /api/health`: public health check.
14
+ - `GET /api/pool?poolId=default`: public pool configuration, display odds, available prizes, and a bounded list of recent public results. No user identity is accepted.
15
+ - `GET /api/draw/quota?poolId=default`: authenticated current-user remaining count and pity progress. The user ID comes from `x-cloudbase-context`.
16
+ - `GET /api/draw/results?poolId=default`: authenticated current-user draw records, capped at 50 rows.
17
+ - `POST /api/draw`: authenticated body `{ "poolId": "default", "drawCount": 1, "proofUrl": "https://..." }`. The function validates a count from 1 to 10 and the optional HTTPS proof URL. `X-Request-Id` is an RFC4122 UUID used for idempotency.
18
+
19
+ The `perform_draw` RPC locks the pool and user quota, checks activity dates and available attempts, selects a prize using the configured weight (or the pity prize at the threshold), decrements stock and quota, and inserts all records in one transaction. A repeated request ID returns the original session without drawing again. The browser never supplies a PUID, inventory, or result.
20
+
21
+ Before deploying an adapted example, replace `ACTIVITY_API_BASE`, `ACTIVITY_ENV_ID`, and `ACTIVITY_POOL_ID` with values from the actual activity and gateway. Read the gateway URL from `queryGateway`, then run health, CORS preflight, unauthenticated pool, authenticated quota/history, successful draw, insufficient-count, exhausted-stock, and duplicate-request smoke tests. Keep `example/` as a reference rather than publishing it directly.
@@ -0,0 +1,142 @@
1
+ const http = require("http");
2
+ const zlib = require("zlib");
3
+ const crypto = require("crypto");
4
+ const tcb = require("@cloudbase/node-sdk");
5
+
6
+ const app = tcb.init({
7
+ env: process.env.CLOUDBASE_ENV_ID || process.env.TCB_ENV,
8
+ accessKey: process.env.COLORBOX__ACCESS_KEY
9
+ });
10
+ const rdb = app.rdb({ database: "public" });
11
+ const DEFAULT_POOL_ID = process.env.DRAW_POOL_ID || "default";
12
+ const MAX_BODY_BYTES = 64 * 1024;
13
+ const MAX_DRAW_COUNT = 10;
14
+
15
+ function apiPath(req) {
16
+ const pathname = new URL(req.url, "http://localhost").pathname || "/";
17
+ return pathname.replace(/^\/api(?=\/|$)/, "") || "/";
18
+ }
19
+
20
+ function queryRows(result) {
21
+ if (!result) return [];
22
+ if (Array.isArray(result)) return result;
23
+ if (Array.isArray(result.data)) return result.data;
24
+ if (Array.isArray(result.rows)) return result.rows;
25
+ return [];
26
+ }
27
+
28
+ function readPuid(req) {
29
+ const raw = req.headers["x-cloudbase-context"];
30
+ if (!raw) { const error = new Error("请先登录"); error.statusCode = 401; throw error; }
31
+ let buffer = Buffer.from(String(raw).trim(), "base64");
32
+ if (buffer.length >= 2 && buffer[0] === 0x1f && buffer[1] === 0x8b) buffer = zlib.gunzipSync(buffer);
33
+ let context;
34
+ try { context = JSON.parse(buffer.toString("utf8")); } catch (_) { const error = new Error("登录状态无效"); error.statusCode = 401; throw error; }
35
+ const puid = context.customUserId || context.userId || context.uid;
36
+ if (!puid) { const error = new Error("请先登录"); error.statusCode = 401; throw error; }
37
+ return String(puid);
38
+ }
39
+
40
+ function readRequestId(req) {
41
+ const value = String(req.headers["x-request-id"] || "").trim();
42
+ if (value && !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)) {
43
+ const error = new Error("请求 ID 格式不正确");
44
+ error.statusCode = 400;
45
+ throw error;
46
+ }
47
+ if (value) return value;
48
+ return crypto.randomUUID();
49
+ }
50
+
51
+ function getJsonBody(req) {
52
+ return new Promise((resolve, reject) => {
53
+ let size = 0; const chunks = [];
54
+ req.on("data", (chunk) => { size += chunk.length; if (size > MAX_BODY_BYTES) { const error = new Error("请求内容过大"); error.statusCode = 413; reject(error); return; } chunks.push(chunk); });
55
+ req.on("end", () => { if (!chunks.length) return resolve({}); try { resolve(JSON.parse(Buffer.concat(chunks).toString("utf8"))); } catch (_) { const error = new Error("请求格式不正确"); error.statusCode = 400; reject(error); } });
56
+ req.on("error", reject);
57
+ });
58
+ }
59
+
60
+ function sendJson(res, statusCode, payload) {
61
+ res.writeHead(statusCode, {
62
+ "Access-Control-Allow-Origin": process.env.ALLOWED_ORIGIN || "*",
63
+ "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
64
+ "Access-Control-Allow-Headers": "Content-Type, Authorization, X-Request-Id, X-CloudBase-Context",
65
+ "Content-Type": "application/json; charset=utf-8"
66
+ });
67
+ res.end(JSON.stringify(payload));
68
+ }
69
+
70
+ async function getRdbServiceToken() {
71
+ const credential = await app.auth().getClientCredential();
72
+ if (typeof credential === "string" && credential.trim()) return credential.trim();
73
+ if (credential && typeof credential.access_token === "string" && credential.access_token.trim()) return credential.access_token.trim();
74
+ if (process.env.COLORBOX__ACCESS_KEY) return process.env.COLORBOX__ACCESS_KEY;
75
+ throw new Error("数据库服务凭据不可用");
76
+ }
77
+
78
+ async function drawRpc(puid, poolId, drawCount, proofUrl, requestId) {
79
+ const envId = process.env.CLOUDBASE_ENV_ID || process.env.TCB_ENV;
80
+ const token = await getRdbServiceToken();
81
+ const response = await fetch(`https://${envId}.api.tcloudbasegateway.com/v1/rdb/rest/rpc/perform_draw`, {
82
+ method: "POST",
83
+ headers: { "Authorization": `Bearer ${token}`, "X-Db-Instance": "default", "Accept-Profile": "public", "Content-Profile": "public", "Content-Type": "application/json" },
84
+ body: JSON.stringify({ p_puid: puid, p_pool_id: poolId, p_draw_count: drawCount, p_proof_url: proofUrl || "", p_request_id: requestId })
85
+ });
86
+ const raw = await response.text(); let data = raw; try { data = raw ? JSON.parse(raw) : null; } catch (_) { /* keep raw for logs */ }
87
+ if (!response.ok) {
88
+ console.error("[Draw RPC Error]", response.status, data);
89
+ const rpcMessage = data && typeof data.message === "string" ? data.message : "抽卡暂时无法完成";
90
+ const error = new Error(rpcMessage);
91
+ error.statusCode = response.status >= 400 && response.status < 500 ? response.status : 500;
92
+ throw error;
93
+ }
94
+ return queryRows(data);
95
+ }
96
+
97
+ function mapPrize(row) {
98
+ return { drawId: row.draw_id || row.id, prizeCode: row.prize_code, prizeName: row.prize_name, rarity: row.rarity, description: row.description || "", createdAt: row.created_at };
99
+ }
100
+
101
+ async function handle(req, res) {
102
+ if (req.method === "OPTIONS") return sendJson(res, 204, null);
103
+ const path = apiPath(req); const url = new URL(req.url, "http://localhost");
104
+ try {
105
+ if (req.method === "GET" && path === "/health") return sendJson(res, 200, { code: 0, message: "ok", data: null });
106
+ if (req.method === "GET" && path === "/pool") {
107
+ const poolId = url.searchParams.get("poolId") || DEFAULT_POOL_ID;
108
+ const pools = queryRows(await rdb.from("draw_pools").select("pool_id, title, description, cover_url, starts_at, ends_at, draw_limit, pity_threshold, status").eq("pool_id", poolId).limit(1));
109
+ if (!pools.length) { const error = new Error("卡池不存在"); error.statusCode = 404; throw error; }
110
+ const pool = pools[0];
111
+ const prizes = queryRows(await rdb.from("draw_prizes").select("prize_code, prize_name, rarity, description, weight, remaining_count").eq("pool_id", poolId).eq("status", "active").order("id", { ascending: true }).limit(100));
112
+ const totalWeight = prizes.reduce((sum, item) => sum + Math.max(0, Number(item.weight) || 0), 0);
113
+ const recent = queryRows(await rdb.from("draw_records").select("prize_name, rarity, created_at").eq("pool_id", poolId).order("created_at", { ascending: false }).limit(20));
114
+ return sendJson(res, 200, { code: 0, message: "success", data: { poolId: pool.pool_id, title: pool.title, description: pool.description, coverUrl: pool.cover_url || null, startsAt: pool.starts_at, endsAt: pool.ends_at, drawLimit: Number(pool.draw_limit), pityThreshold: Number(pool.pity_threshold), prizes: prizes.map((item) => ({ code: item.prize_code, name: item.prize_name, rarity: item.rarity, description: item.description, weight: Number(item.weight), remainingCount: Number(item.remaining_count), odds: totalWeight ? Number(item.weight) / totalWeight : 0 })), recentResults: recent.map((item) => ({ prizeName: item.prize_name, rarity: item.rarity, createdAt: item.created_at })) } });
115
+ }
116
+ if (req.method === "GET" && path === "/draw/quota") {
117
+ const puid = readPuid(req); const poolId = url.searchParams.get("poolId") || DEFAULT_POOL_ID;
118
+ const rows = queryRows(await rdb.from("draw_user_quota").select("remaining_count, total_count, pity_count, updated_at").eq("pool_id", poolId).eq("puid", puid).limit(1));
119
+ const row = rows[0];
120
+ if (row) return sendJson(res, 200, { code: 0, message: "success", data: { remainingCount: Number(row.remaining_count), totalCount: Number(row.total_count), pityCount: Number(row.pity_count), updatedAt: row.updated_at } });
121
+ const pools = queryRows(await rdb.from("draw_pools").select("draw_limit").eq("pool_id", poolId).limit(1));
122
+ const initialCount = pools.length ? Number(pools[0].draw_limit || 0) : 0;
123
+ return sendJson(res, 200, { code: 0, message: "success", data: { remainingCount: initialCount, totalCount: initialCount, pityCount: 0 } });
124
+ }
125
+ if (req.method === "GET" && path === "/draw/results") {
126
+ const puid = readPuid(req); const poolId = url.searchParams.get("poolId") || DEFAULT_POOL_ID;
127
+ const rows = queryRows(await rdb.from("draw_records").select("id, prize_code, prize_name, rarity, description, created_at").eq("pool_id", poolId).eq("puid", puid).order("created_at", { ascending: false }).limit(50));
128
+ return sendJson(res, 200, { code: 0, message: "success", data: rows.map(mapPrize) });
129
+ }
130
+ if (req.method === "POST" && path === "/draw") {
131
+ const puid = readPuid(req); const body = await getJsonBody(req); const poolId = typeof body.poolId === "string" && body.poolId.trim() ? body.poolId.trim().slice(0, 64) : DEFAULT_POOL_ID; const drawCount = Number(body.drawCount);
132
+ if (!Number.isSafeInteger(drawCount) || drawCount < 1 || drawCount > MAX_DRAW_COUNT) { const error = new Error("抽卡次数必须是 1 到 10"); error.statusCode = 400; throw error; }
133
+ const proofUrl = typeof body.proofUrl === "string" && body.proofUrl.trim() ? body.proofUrl.trim().slice(0, 2048) : "";
134
+ if (proofUrl && !/^https:\/\/[^\s]+$/i.test(proofUrl)) { const error = new Error("素材地址无效"); error.statusCode = 400; throw error; }
135
+ const rows = await drawRpc(puid, poolId, drawCount, proofUrl, readRequestId(req));
136
+ const draws = rows.map(mapPrize); const last = rows[0] || {}; return sendJson(res, 200, { code: 0, message: "success", data: { sessionId: last.session_id || null, draws, remainingCount: last.remaining_count == null ? null : Number(last.remaining_count), pityProgress: last.pity_count == null ? null : Number(last.pity_count) } });
137
+ }
138
+ return sendJson(res, 404, { code: 404, message: "not found", data: null });
139
+ } catch (error) { console.error("[Draw API Error]", error); const statusCode = error.statusCode || 500; return sendJson(res, statusCode, { code: statusCode, message: statusCode >= 500 ? "服务暂时不可用" : error.message, data: null }); }
140
+ }
141
+
142
+ http.createServer(handle).listen(process.env.PORT || 9000);
@@ -0,0 +1,9 @@
1
+ {
2
+ "name": "activity_api",
3
+ "version": "1.0.0",
4
+ "description": "CloudBase draw activity API",
5
+ "main": "index.js",
6
+ "scripts": { "start": "node index.js" },
7
+ "engines": { "node": ">=18.15" },
8
+ "dependencies": { "@cloudbase/node-sdk": "^3.16.0" }
9
+ }
@@ -0,0 +1,3 @@
1
+ #!/bin/bash
2
+ export PORT=9000
3
+ exec node index.js