@hupu-tech/shaper 0.2.12 → 0.2.14
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.
- package/CHANGELOG.md +12 -0
- package/README.md +6 -0
- package/dist/auth/auth.d.ts +1 -0
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +0 -1
- package/dist/cloud/service-build.d.ts +2 -4
- package/dist/index.js +1 -1
- package/dist/platform/api.d.ts +2 -0
- package/dist/project/create.d.ts +9 -3
- package/dist/project/delivery.d.ts +5 -5
- package/dist/runtime.d.ts +2 -1
- package/dist/runtime.js +1 -1
- package/dist/shared-UKIFY6QO.js +19 -0
- package/package.json +1 -1
- package/skills/business/SKILL.md +158 -0
- package/skills/business/activity/README.md +14 -0
- package/skills/business/activity/hupu-leaderboard-template/SKILL.md +52 -0
- package/skills/business/activity/hupu-leaderboard-template/example/README.md +20 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/index.js +218 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/index.html +291 -0
- package/skills/business/activity/hupu-leaderboard-template/example/migrations/20260828210000_create_leaderboard.sql +54 -0
- package/skills/business/activity/hupu-lottery-draw/SKILL.md +50 -0
- package/skills/business/activity/hupu-lottery-draw/example/README.md +21 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/index.js +142 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/package.json +9 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/index.html +178 -0
- package/skills/business/activity/hupu-lottery-draw/example/migrations/20260828220000_create_draw.sql +193 -0
- package/skills/business/activity/hupu-pk-voting/SKILL.md +54 -0
- package/skills/business/activity/hupu-pk-voting/example/README.md +44 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/index.js +370 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/scf_bootstrap +2 -0
- package/skills/business/activity/hupu-pk-voting/example/index.html +729 -0
- package/skills/business/activity/hupu-pk-voting/example/migrations/20260828220000_create_pk_vote.sql +168 -0
- package/skills/business/activity/hupu-request-activity-execute-vote-task/SKILL.md +77 -0
- package/skills/business/activity/hupu-request-activity-get-vote-detail/SKILL.md +84 -0
- package/skills/business/activity/hupu-request-activity-get-vote-task-list/SKILL.md +86 -0
- package/skills/business/activity/hupu-request-activity-list-by-biz-keys/SKILL.md +153 -0
- package/skills/business/activity/hupu-request-activity-report-vote-task/SKILL.md +58 -0
- package/skills/business/activity/hupu-request-activity-submit-vote/SKILL.md +58 -0
- package/skills/business/activity/hupu-vote-task/SKILL.md +47 -0
- package/skills/business/community/README.md +13 -0
- package/skills/business/community/hupu-request-bbs-detail/SKILL.md +197 -0
- package/skills/business/community/hupu-request-bbs-get-tag-thread-list/SKILL.md +257 -0
- package/skills/business/community/hupu-request-bbs-get-topic-threads/SKILL.md +159 -0
- package/skills/business/community/hupu-request-bbs-gets-thread-post-list/SKILL.md +124 -0
- package/skills/business/community/hupu-request-bbs-open-post-editor/SKILL.md +75 -0
- package/skills/business/community/hupu-request-bbs-reply-post/SKILL.md +59 -0
- package/skills/business/community/hupu-score-add-score/SKILL.md +57 -0
- package/skills/business/community/hupu-score-get-item-detail/SKILL.md +173 -0
- package/skills/business/community/hupu-score-get-score/SKILL.md +263 -0
- package/skills/business/quality/README.md +7 -0
- package/skills/business/quality/hupu-security-check-audit/SKILL.md +39 -0
- package/skills/business/quality/hupu-wasm-compression/SKILL.md +69 -0
- package/skills/business/quality/hupu-wasm-compression/agents/openai.yaml +4 -0
- package/skills/business/quality/hupu-wasm-compression/tool/checks.mjs +90 -0
- package/skills/business/quality/hupu-wasm-compression/tool/compress-worker.mjs +40 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/app.js +84 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/index.html +80 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/style.css +3 -0
- package/skills/business/quality/hupu-wasm-compression/tool/server.mjs +126 -0
- package/skills/business/quality/hupu-web-security-audit/SKILL.md +45 -0
- package/skills/business/quality/hupu-web-security-audit/agents/openai.yaml +4 -0
- package/skills/business/rewards/README.md +13 -0
- package/skills/business/rewards/hupu-vacoin/SKILL.md +70 -0
- package/skills/business/rewards/hupu-vacoin-consume-coins/SKILL.md +47 -0
- package/skills/business/rewards/hupu-vacoin-get-coin-overview/SKILL.md +52 -0
- package/skills/business/rewards/hupu-vacoin-get-session-coins/SKILL.md +44 -0
- package/skills/business/rewards/hupu-vacoin-reset-session-id/SKILL.md +39 -0
- package/skills/business/rewards/hupu-vatask/SKILL.md +63 -0
- package/skills/business/rewards/hupu-vatask-complete-reward-video/SKILL.md +43 -0
- package/skills/business/rewards/hupu-vatask-consume-activity-chance/SKILL.md +48 -0
- package/skills/business/rewards/hupu-vatask-get-activity-task-state/SKILL.md +49 -0
- package/skills/business/runtime/README.md +13 -0
- package/skills/business/runtime/hupu-add-to-desktop/SKILL.md +51 -0
- package/skills/business/runtime/hupu-close-webview/SKILL.md +48 -0
- package/skills/business/runtime/hupu-cloud-auth/SKILL.md +43 -0
- package/skills/business/runtime/hupu-cloud-request/SKILL.md +56 -0
- package/skills/business/runtime/hupu-fullscreen-safe-top/SKILL.md +33 -0
- package/skills/business/runtime/hupu-navigate-to/SKILL.md +45 -0
- package/skills/business/runtime/hupu-request/SKILL.md +67 -0
- package/skills/business/runtime/hupu-seer-chat/SKILL.md +183 -0
- package/skills/business/runtime/hupu-track-report/SKILL.md +71 -0
- package/skills/business/sharing/README.md +7 -0
- package/skills/business/sharing/hupu-oss-upload-file/SKILL.md +40 -0
- package/skills/business/sharing/hupu-result-poster-posting/SKILL.md +37 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/README.md +14 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/index.js +187 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/index.html +256 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/migrations/20260828213000_create_result_poster_results.sql +60 -0
- package/skills/business/sharing/hupu-result-poster-posting/references/api-contract.md +46 -0
- package/skills/business/sharing/hupu-social-share/SKILL.md +27 -0
- package/skills/business/sports/README.md +27 -0
- package/skills/business/sports/hupu-request-basketball-player-info/SKILL.md +131 -0
- package/skills/business/sports/hupu-request-basketball-single-match/SKILL.md +158 -0
- package/skills/business/sports/hupu-request-basketball-team-info/SKILL.md +96 -0
- package/skills/business/sports/hupu-request-basketball-team-player-list/SKILL.md +108 -0
- package/skills/business/sports/hupu-request-basketball-team-salary-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-coach-info/SKILL.md +76 -0
- package/skills/business/sports/hupu-request-football-live-room-news-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-match-info/SKILL.md +126 -0
- package/skills/business/sports/hupu-request-football-player-info/SKILL.md +82 -0
- package/skills/business/sports/hupu-request-football-team-info/SKILL.md +83 -0
- package/skills/business/sports/hupu-request-football-team-player-season-stats/SKILL.md +73 -0
- package/skills/business/sports/hupu-request-football-team-season-year/SKILL.md +68 -0
- package/skills/business/sports/hupu-request-kog-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-live-tab-info-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-live-tab-list/SKILL.md +66 -0
- package/skills/business/sports/hupu-request-lol-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-match-get-tab-detail-schedule-list/SKILL.md +113 -0
- package/skills/business/sports/hupu-request-match-query-all-diagram-info-by-id/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-match-query-match-stats-by-match-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-news-news-common-list/SKILL.md +90 -0
- package/skills/business/sports/hupu-request-news-player-news-list/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-news-subject-news/SKILL.md +89 -0
- package/skills/business/sports/hupu-request-news-team-news-list/SKILL.md +76 -0
- package/skills/business/storage/README.md +9 -0
- package/skills/business/storage/hupu-cloud-save/SKILL.md +129 -0
- package/skills/business/storage/hupu-cloud-save/references/legacy-migration.md +111 -0
- package/skills/business/storage/hupu-cloud-save-load/SKILL.md +41 -0
- package/skills/business/storage/hupu-cloud-save-save/SKILL.md +45 -0
- package/skills/business/storage/hupu-storage-get-value/SKILL.md +26 -0
- package/skills/business/storage/hupu-storage-set-value/SKILL.md +42 -0
- package/skills/business/user/README.md +6 -0
- package/skills/business/user/hupu-auth-get-user-info/SKILL.md +47 -0
- package/skills/business/user/hupu-game-auth/SKILL.md +46 -0
- package/skills/core/hupu-business/SKILL.md +1 -1
- package/skills/core/hupu-business/references/runtime.md +17 -11
- package/skills/core/shaper-backend/SKILL.md +1 -1
- package/skills/core/shaper-backend/references/database.md +2 -2
- package/skills/core/shaper-backend/references/legacy.md +1 -1
- package/skills/core/shaper-backend/references/node-server.md +29 -20
- package/skills/core/shaper-development/SKILL.md +6 -1
- package/skills/core/shaper-development/references/materials.md +14 -0
- package/skills/core/shaper-development/references/project-setup.md +1 -1
- package/skills/core/shaper-game-development/SKILL.md +16 -9
- package/skills/core/shaper-game-development/references/implementation.md +13 -0
- package/skills/core/shaper-game-development/references/iteration.md +11 -0
- package/skills/core/shaper-game-development/references/playable-loop.md +12 -0
- package/skills/core/shaper-game-development/references/playtest.md +18 -0
- package/skills/core/shaper-game-development/references/sources.md +6 -0
- package/skills/core/shaper-release/SKILL.md +1 -1
- package/templates/cloud-service/README.md +4 -30
- package/templates/cloud-service/cloud.json +5 -8
- package/templates/cloud-service/package-lock.json +922 -15
- package/templates/cloud-service/release.json +4 -4
- package/templates/cloud-service/server.cjs +37 -0
- package/templates/leaderboard/README.md +3 -0
- package/templates/leaderboard/cloud/database/migrations/202611130001_leaderboard.sql +6 -0
- package/templates/leaderboard/cloud/functions/api/cloud.json +10 -0
- package/templates/leaderboard/cloud/functions/api/leaderboard.cjs +49 -0
- package/templates/leaderboard/cloud/functions/api/package-lock.json +1093 -0
- package/templates/leaderboard/cloud/functions/api/package.json +19 -0
- package/templates/leaderboard/cloud/functions/api/server.cjs +25 -0
- package/templates/leaderboard/cloud/gateway/routes.json +15 -0
- package/templates/leaderboard/docs/design.md +1 -0
- package/templates/leaderboard/docs/integration.md +12 -0
- package/templates/leaderboard/docs/product.md +1 -0
- package/templates/leaderboard/docs/validation.md +1 -0
- package/templates/leaderboard/index.html +12 -0
- package/templates/leaderboard/package-lock.json +828 -0
- package/templates/leaderboard/package.json +17 -0
- package/templates/leaderboard/public/.gitkeep +1 -0
- package/templates/leaderboard/shaper.config.json +7 -0
- package/templates/leaderboard/src/main.js +67 -0
- package/templates/leaderboard/src/style.css +69 -0
- package/templates/leaderboard/test/leaderboard.test.cjs +93 -0
- package/templates/offline-game/README.md +3 -0
- package/templates/offline-game/docs/design.md +1 -0
- package/templates/offline-game/docs/integration.md +10 -0
- package/templates/offline-game/docs/product.md +1 -0
- package/templates/offline-game/docs/validation.md +1 -0
- package/templates/offline-game/index.html +12 -0
- package/templates/offline-game/package-lock.json +828 -0
- package/templates/offline-game/package.json +16 -0
- package/templates/offline-game/public/.gitkeep +1 -0
- package/templates/offline-game/shaper.config.json +7 -0
- package/templates/offline-game/src/game.js +42 -0
- package/templates/offline-game/src/main.js +60 -0
- package/templates/offline-game/src/style.css +69 -0
- package/templates/offline-game/test/game.test.js +25 -0
- package/dist/shared-APGA5MU5.js +0 -19
- package/templates/cloud-service/handlers.cjs +0 -46
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-cloud-save-save
|
|
3
|
+
description: 将用户进度、草稿、选择或个人设置保存到指定云存档位;编号为 1–5,同编号完整覆盖。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.cloudSave.save(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 新接入首选 save/load;已有 getValue/setValue 应用可继续使用原接口,不强制迁移。决定切换时不能只替换方法名,应先处理旧 key 数据;用法与迁移见 hupu-cloud-save/SKILL.md
|
|
13
|
+
- 结合游戏或应用实际功能选择保存时机,接入云存档不代表需要自动保存;无恢复需求不保存,点击保存、确认步骤、完成关卡或检查点已足够时只按这些节点保存;仅长篇草稿、持续创作或需保护中途进度等功能按需启用持续自动保存,不扩展到其他功能,用户未确认的编辑不自动覆盖约定手动保存的正式存档
|
|
14
|
+
- 固定存档编号用途,读写使用相同编号;建议最多使用三个存档位,一起保存和恢复的小字段放同一对象,仅保存时机或加载需求独立时才拆分;同编号完整替换,不合并对象字段,共用对象提交完整有效快照,多个存档位保存不保证一起成功
|
|
15
|
+
- 按白名单只存无法可靠重建的用户内容、进度、选择和设置;已有数据优先存稳定 ID 及必要关系或顺序,详情恢复时重新获取,名称不能替代稳定 ID;必要正文完整保留。数据取舍与场景示例见 hupu-cloud-save/SKILL.md
|
|
16
|
+
- 不存整个 state/store、接口响应、派生值、静态配置、临时 UI 状态、日志、资源二进制或 Base64;资源成功上传后只存可恢复引用,历史限定范围,不保存 token、密码、Cookie
|
|
17
|
+
- 只在必需字段变化时保存,提交前序列化一次并复用;同一用户/应用/活动/存档位可跳过与上次成功值相同的内容,失败不更新成功记录,成功后更新或失效读取缓存;不在输入、渲染或逐帧回调中反复序列化和深拷贝
|
|
18
|
+
- 仅在启用持续自动保存时合并连续变化,同一存档位至少间隔 3 秒并按可接受的进度损失设最长等待;不是每 3 秒定时保存,无变化不写,仅按节点保存无需这套调度。手动保存防重复,手动或明确业务节点不必等待该间隔;同一存档位不重叠写,旧请求成功不能清掉新变化,不只依赖关闭时保存
|
|
19
|
+
- 已启用自动保存且需要恢复时,成功读取、解析和校验前暂停自动写回;普通手动保存不要求先读。卸载或切换用户/应用/活动/存档位时清理定时器、监听、缓存及待写任务,忽略旧结果
|
|
20
|
+
- 只有 code === 200 才提示已保存;失败提示并保留内容,暂停该失败操作的自动提交,不由定时器或队列立即重发、不无限重试。413 先去冗余,仍超限不能截断必要内容;2MiB 是 UTF-8 字节上限而非目标,验证体积、请求次数和序列化耗时
|
|
21
|
+
- 超时或网络中断不代表云端未写入,底层请求可能仍在执行;暂停自动写并保留提交快照及新编辑,不立即发起可能被旧请求覆盖的新写入。没有删除接口,清空需按业务约定保存空状态,空字符串不等于无存档;重置及提交后清理须处理旧待写和在途请求,不能清掉新编辑。细则见 hupu-cloud-save/SKILL.md
|
|
22
|
+
|
|
23
|
+
# Parameters
|
|
24
|
+
|
|
25
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| slot | integer | 是 | 存档编号,只接受 1–5 的整数;固定用途,建议每个应用最多使用三个存档位 |
|
|
28
|
+
| value | string | 是 | 恢复必需的数据字符串;对象按需 JSON.stringify,最多 2MiB UTF-8 bytes |
|
|
29
|
+
|
|
30
|
+
# Returns
|
|
31
|
+
|
|
32
|
+
- Type: `Promise<Response>`
|
|
33
|
+
|
|
34
|
+
### Response Properties
|
|
35
|
+
|
|
36
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
37
|
+
| --- | --- | --- | --- |
|
|
38
|
+
| code | number | 是 | 成功为 200,失败时为错误码 |
|
|
39
|
+
| message | string | 是 | 结果说明 |
|
|
40
|
+
|
|
41
|
+
# Examples
|
|
42
|
+
|
|
43
|
+
```javascript
|
|
44
|
+
window.ShaperAI.cloudSave.save({ slot: 1, value: JSON.stringify({ levelId: 3 }) }).then(res => { if (res.code !== 200) throw new Error(res.message || "保存失败"); console.log("保存成功"); }).catch(error => console.warn(error.message));
|
|
45
|
+
```
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-storage-get-value
|
|
3
|
+
description: 读取当前活动页在本地或 App 容器内已经存储的状态数据。支持项目隔离及读取合并。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.storage.getValue(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 本地存档、草稿、单机进度允许直接通过 window.localStorage.getItem 读取,不要当成违规或强行改写
|
|
13
|
+
- 需要按项目隔离读取时使用 ShaperAI.storage.getValue
|
|
14
|
+
- 当读取的键尚未存储时,接口返回 null,前台页面需要做好对应的空值兜底
|
|
15
|
+
|
|
16
|
+
# Parameters
|
|
17
|
+
|
|
18
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
19
|
+
| --- | --- | --- | --- |
|
|
20
|
+
| key | string | 否 | 待读取的数据键名称,如果不传则返回当前项目下存储的所有键值对 |
|
|
21
|
+
|
|
22
|
+
# Examples
|
|
23
|
+
|
|
24
|
+
```javascript
|
|
25
|
+
window.ShaperAI.storage.getValue("userLevel").then(val => { console.log(val); })
|
|
26
|
+
```
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-storage-set-value
|
|
3
|
+
description: 为当前活动页在本地或 App 容器内安全存储指定的键值数据。支持项目隔离及多端自动同步。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.storage.setValue(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 本地存档、草稿、单机进度允许直接使用 window.localStorage 或 window.sessionStorage,不要当成违规或强行改写
|
|
13
|
+
- 需要 App 容器同步或按项目隔离时使用 ShaperAI.storage.setValue
|
|
14
|
+
- 使用 ShaperAI.storage 时,单次写入的数据大小不得超过 200KB
|
|
15
|
+
- 使用 ShaperAI.storage 时,数据必须传入普通对象键值对格式
|
|
16
|
+
- 禁止用本地存储冒充多人后端,禁止明文存储令牌或身份凭证
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| data | object | 是 | 需要存储的键值对对象数据,如 { score: 10 } |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| ok | boolean | 是 | 是否成功发起写入 |
|
|
33
|
+
| key | string | 否 | 写入的主键标识 |
|
|
34
|
+
| keys | array | 否 | 所有写入的键标识列表 |
|
|
35
|
+
| keys[] | string | 否 | 数组元素 |
|
|
36
|
+
| size | number | 否 | 本次写入数据的大小,单位字节 |
|
|
37
|
+
|
|
38
|
+
# Examples
|
|
39
|
+
|
|
40
|
+
```javascript
|
|
41
|
+
window.ShaperAI.storage.setValue({ userLevel: 5 })
|
|
42
|
+
```
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-auth-get-user-info
|
|
3
|
+
description: 获取当前登录用户的基本资料(包含用户唯一标识 PUID、头像、昵称及客户端布局信息)。可用于登录态校验、页面个性化定制与特权判定。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.auth.getUserInfo()`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须使用 window.ShaperAI.auth.getUserInfo() 接口进行异步调取
|
|
13
|
+
- 若当前用户未登录,接口返回的 data 可能为 null,业务端需做好未登录状态的引导(如去登录)
|
|
14
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
15
|
+
|
|
16
|
+
# Parameters
|
|
17
|
+
|
|
18
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
19
|
+
| --- | --- | --- | --- |
|
|
20
|
+
|
|
21
|
+
# Returns
|
|
22
|
+
|
|
23
|
+
- Type: `Promise<Response>`
|
|
24
|
+
|
|
25
|
+
### Response Properties
|
|
26
|
+
|
|
27
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
28
|
+
| --- | --- | --- | --- |
|
|
29
|
+
| code | number | 是 | 状态码,成功为 200 |
|
|
30
|
+
| message | string | 是 | 提示信息 |
|
|
31
|
+
| data | object | 否 | |
|
|
32
|
+
| data.islogin | number | 否 | 是否登录:1 为已登录,0 为未登录/游客 |
|
|
33
|
+
| data.puid | string | 否 | 用户唯一 ID(未登录为 null) |
|
|
34
|
+
| data.nickname | string | 否 | 用户昵称(未登录为 null) |
|
|
35
|
+
| data.avatar | string | 否 | 用户头像 URL 链接地址 |
|
|
36
|
+
| data.userHeadUrl | string | 否 | 用户头像 URL 链接地址(同 avatar) |
|
|
37
|
+
| data.platform | string | 否 | 当前客户端平台:iOS / Android |
|
|
38
|
+
| data.night | number | 否 | 是否为夜间模式:1 为是,0 为否 |
|
|
39
|
+
| data.statusbar_hight | number | 否 | 状态栏高度(单位 px),用于顶部自定义标题栏避让刘海 |
|
|
40
|
+
| data.titlebar_hight | number | 否 | 标题栏高度(单位 px) |
|
|
41
|
+
| data.bottomSafeHeight | number | 否 | 底部安全区高度(单位 px,如 iPhone 全面屏通常为 34px) |
|
|
42
|
+
|
|
43
|
+
# Examples
|
|
44
|
+
|
|
45
|
+
```javascript
|
|
46
|
+
window.ShaperAI.auth.getUserInfo().then(res => { if (res.code === 200 && res.data) { console.log("当前登录用户:", res.data.nickname); } else { console.log("当前未登录"); } });
|
|
47
|
+
```
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-game-auth
|
|
3
|
+
description: 使用当前登录态获取目标应用的短期游戏令牌。默认使用当前页面所属应用,也可显式传入其他 appId。游戏地址由游戏自身配置。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.game.auth(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 页面通过 window.ShaperAI.game.auth 获取连接凭证;无需接触签发地址、CloudBase 环境或验签密钥
|
|
13
|
+
- appId 指向目标游戏所属应用,格式为 app_xxxxx;不能从 CloudBase envId 推导
|
|
14
|
+
- 令牌交给 Colyseus 客户端的 client.auth.token,不放入 URL、消息或 join options
|
|
15
|
+
- 每次准备入房时获取新凭证;重连使用 Colyseus reconnectionToken
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| appId | string | 否 | 目标游戏所属应用 ID;省略时使用当前页面的 appId |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码,成功为 200 |
|
|
33
|
+
| message | string | 是 | 提示信息 |
|
|
34
|
+
| data | object | 否 | |
|
|
35
|
+
| data.token | string | 否 | 短期 Game Token |
|
|
36
|
+
| data.expiresAt | number | 否 | 令牌过期时间,毫秒时间戳 |
|
|
37
|
+
|
|
38
|
+
# Examples
|
|
39
|
+
|
|
40
|
+
```javascript
|
|
41
|
+
const res = await window.ShaperAI.game.auth(); if (res.code === 200) console.log(res.data.token);
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
```javascript
|
|
45
|
+
const res = await window.ShaperAI.game.auth({ appId: "app_1234567890" });
|
|
46
|
+
```
|
|
@@ -5,7 +5,7 @@ description: 在 Shaper 网页中接入虎扑用户资料、分享和 cloud.requ
|
|
|
5
5
|
|
|
6
6
|
# 虎扑业务接入
|
|
7
7
|
|
|
8
|
-
页面使用 Shaper 容器提供的 `window.
|
|
8
|
+
页面使用 Shaper 容器提供的 `window.ShaperAI`。开发者 CLI 的 OAuth 只管理项目,不是应用用户登录。新工具保持既有虎扑桥接协议;不要套用 Maker 的 SDK 名称或注入方式。
|
|
9
9
|
|
|
10
10
|
用户资料、分享和云业务请求的具体调用见 [references/runtime.md](references/runtime.md)。需要这些能力时读取该文档;玩家认证复用已有 SDK 的 cloud.request 内部逻辑。
|
|
11
11
|
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# 既有虎扑桥接
|
|
2
2
|
|
|
3
|
-
Shaper 发布壳提供 `window.
|
|
3
|
+
Shaper 发布壳提供 `window.ShaperAI`。不额外从第三方 CDN 装一份替代 SDK。
|
|
4
4
|
|
|
5
5
|
读取当前用户:
|
|
6
6
|
|
|
7
7
|
```js
|
|
8
|
-
const result = await window.
|
|
8
|
+
const result = await window.ShaperAI.auth.getUserInfo();
|
|
9
9
|
const signedIn = result.code === 200 && (
|
|
10
10
|
result.data?.islogin === 1 ||
|
|
11
11
|
result.data?.islogin === '1' ||
|
|
@@ -18,7 +18,7 @@ const signedIn = result.code === 200 && (
|
|
|
18
18
|
用户点击分享按钮时:
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
|
-
const result = await window.
|
|
21
|
+
const result = await window.ShaperAI.social.share({
|
|
22
22
|
title: '我的作品',
|
|
23
23
|
link: publishedHttpsUrl,
|
|
24
24
|
text: '一起来玩',
|
|
@@ -38,18 +38,24 @@ const user = await hupu.user();
|
|
|
38
38
|
|
|
39
39
|
`available()` 读取桥接可用性,`user()` 返回 `signedIn` 和展示资料,`share()` 保留宿主结果。它不保存用户凭证,不自动引入云管理 SDK。包未发布阶段,应使用交付的本地 npm 包;不要假设公共 registry 中已存在此版本。
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
## 新版应用云请求
|
|
42
|
+
|
|
43
|
+
使用壳提供的当前应用,不填写环境 ID、网关地址或 Token:
|
|
42
44
|
|
|
43
45
|
```js
|
|
44
|
-
const response = await window.
|
|
45
|
-
|
|
46
|
+
const response = await window.ShaperAI.cloud.request({
|
|
47
|
+
path: '/api/progress',
|
|
46
48
|
method: 'POST',
|
|
47
|
-
data: {
|
|
48
|
-
envId,
|
|
49
|
-
auth: true
|
|
49
|
+
data: { score: 100, submissionId }
|
|
50
50
|
});
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
只传 path、method、data;支持 GET/POST/PUT/PATCH/DELETE/HEAD。路由的 public/user 决定是否登录。SDK 验证真实虎扑玩家、换取当前应用会话并请求网关;后端从 user.puid 判断归属,不信任 body.puid。预览访问凭证由壳管理,业务不读取或复制。
|
|
54
|
+
|
|
55
|
+
先确认 cloud status 就绪、数据库迁移成功、后端和网关部署成功,再在实际虎扑容器验证保存与回读。普通浏览器没有玩家登录态时给出登录提示,不使用开发者 Token 或调试账号冒充真实玩家。检查 statusCode 和业务 code/message/data;失败的写请求先确认结果,不自动重发。日志不记录 Token。
|
|
56
|
+
|
|
57
|
+
若返回 CLOUD_NOT_CONFIGURED,说明平台壳尚未接入新版能力,应升级平台 SDK/运行配置;不能自行拼接服务地址或回退旧鉴权。此次测试7已在开发环境验证,正式环境上线状态仍需核对。
|
|
58
|
+
|
|
59
|
+
## 已有旧云调用
|
|
54
60
|
|
|
55
|
-
|
|
61
|
+
旧项目继续使用已有 url/envId/auth 参数,不与 path 混用。新旧会话独立;不要为了兼容新后台而将旧云 Token 附加到新地址。旧项目升级遵循 shaper-development,不在业务调用中自动迁移。
|
|
@@ -7,7 +7,7 @@ description: 设计和实现 Shaper 后端接口、数据模型、身份权限
|
|
|
7
7
|
|
|
8
8
|
先读项目 docs/product.md、docs/design.md 和已有后端,确定本次需要接口、数据变更还是部署。没有共享状态或权威判定需求时,先评估是否需要后台。
|
|
9
9
|
|
|
10
|
-
旧版下载包(activity.json.activityId
|
|
10
|
+
旧版下载包(activity.json.activityId、旧版生成指导块或 act-cloudbase 技能)继续原项目流程,本技能停止新版接入;LEGACY_PROJECT_UPGRADE_REQUIRED 不能通过删除标识、link 或旧脚本绕过。升级策略见 shaper-development。
|
|
11
11
|
|
|
12
12
|
## 执行顺序
|
|
13
13
|
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
## 设计与读写
|
|
4
4
|
|
|
5
5
|
- 明确数据所有者、唯一约束、索引和生命周期。次数、余额、奖励等约束由数据库事务和约束共同保证。
|
|
6
|
-
- 使用 `db.query(sql, values)` 参数化查询;按可信 user 限定数据归属,SDK 不自动实现行级授权。
|
|
7
|
-
- 多次写入使用 `await db.transaction(async tx => { ... })
|
|
6
|
+
- 使用 `cloud.db.query(sql, values)` 参数化查询;按可信 user 限定数据归属,SDK 不自动实现行级授权。
|
|
7
|
+
- 多次写入使用 `await cloud.db.transaction(async tx => { ... })`,回调内用 tx.query 并 await 所有操作。业务事务出错整体回滚,不支持嵌套事务或回调结束后继续使用 tx。
|
|
8
8
|
- 按业务定义幂等键,区分未提交、已提交和结果未知,重试不能重复扣减或发奖。
|
|
9
9
|
|
|
10
10
|
## 结构变更
|
|
@@ -22,7 +22,7 @@ exports.main = async (event) => ({ ok: true, message: event.message ?? 'Hello Hu
|
|
|
22
22
|
|
|
23
23
|
部署返回 `deploying` 后,用 `hupu_legacy_cloud_functions` 检查函数状态,直到 `ready`,再执行 `hupu_legacy_cloud_function_invoke` 验证真实返回,并查询 `hupu_legacy_cloud_function_logs` 排查错误。函数部署、调用、日志三项分别记录结果。
|
|
24
24
|
|
|
25
|
-
函数运行环境和日志由虎扑云部署流程自动配置。当前事件函数管理接口不等于浏览器运行时 API;网页访问已有 HTTP 业务接口时,使用 `hupu-business` 中的 `
|
|
25
|
+
函数运行环境和日志由虎扑云部署流程自动配置。当前事件函数管理接口不等于浏览器运行时 API;网页访问已有 HTTP 业务接口时,使用 `hupu-business` 中的 `ShaperAI.cloud.request`,由 SDK 内部处理玩家认证。HTTP 函数与路由配置目前沿用旧部署入口;管理凭证始终留在开发工具和服务端。
|
|
26
26
|
|
|
27
27
|
## 数据库
|
|
28
28
|
|
|
@@ -1,35 +1,44 @@
|
|
|
1
1
|
# 后端实现与路由
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
源码由开发者工程管理:
|
|
3
|
+
先按用户操作定义请求、响应、身份前提和失败行为。业务使用普通 Node HTTP 服务;Express 等框架由项目选择,SDK 只负责玩家鉴权与 PostgreSQL 访问。
|
|
6
4
|
|
|
7
5
|
```text
|
|
8
6
|
cloud/functions/api/
|
|
9
|
-
|
|
10
|
-
cloud.json
|
|
11
|
-
package.json
|
|
12
|
-
package-lock.json
|
|
13
|
-
|
|
7
|
+
server.cjs # HTTP 启动入口,可拆分路由和业务模块
|
|
8
|
+
cloud.json # manifest v2、SDK 精确版本、运行参数
|
|
9
|
+
package.json # 依赖与 hupuCloud.entry
|
|
10
|
+
package-lock.json
|
|
11
|
+
cloud/gateway/routes.json # 暴露路径、方法、登录要求
|
|
12
|
+
cloud/database/migrations/ # 独立 SQL 迁移
|
|
14
13
|
```
|
|
15
14
|
|
|
16
|
-
网关在 `cloud/gateway/routes.json`,迁移在 `cloud/database/migrations/`;路由只维护一份。旧 `functions/api` 的合并 manifest 与 migrations 继续支持,不自动搬迁。
|
|
17
|
-
|
|
18
15
|
```js
|
|
19
|
-
const
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
16
|
+
const express = require('express');
|
|
17
|
+
const { createClient, ShaperCloudError } = require('@hupu-tech/shaper-cloud');
|
|
18
|
+
const app = express();
|
|
19
|
+
const cloud = createClient();
|
|
20
|
+
app.use(express.json({ limit: '64kb' }));
|
|
21
|
+
app.get('/api/me', async (req, res, next) => {
|
|
22
|
+
try {
|
|
23
|
+
const user = await cloud.auth.requireUser({ authorization: req.headers.authorization });
|
|
24
|
+
const result = await cloud.db.query('SELECT score FROM progress WHERE puid=$1', [user.puid]);
|
|
25
|
+
res.json({ rows: result.rows });
|
|
26
|
+
} catch (error) { next(error); }
|
|
27
|
+
});
|
|
28
|
+
app.use((error, req, res, next) => {
|
|
29
|
+
if (error instanceof ShaperCloudError) return res.status(error.status).json({ code: error.code, message: error.publicMessage });
|
|
30
|
+
res.status(500).json({ code: 'INTERNAL_ERROR' });
|
|
24
31
|
});
|
|
32
|
+
const server = app.listen(Number(process.env.PORT || 9000), '0.0.0.0');
|
|
33
|
+
process.once('SIGTERM', () => server.close(() => cloud.close()));
|
|
25
34
|
```
|
|
26
35
|
|
|
27
|
-
|
|
36
|
+
每个进程复用一个 client,每次请求单独取得 user;私有接口必须调用 requireUser。按可信 user.puid 限制数据归属,不能采用 body.puid。可匿名接口用 getUser;无凭据返回 null,无效凭据仍报错。运行绑定由平台注入,源码不包含厂商密钥或数据库密码。
|
|
28
37
|
|
|
29
|
-
|
|
38
|
+
业务路由在 HTTP 服务中;网关声明只描述暴露范围,不映射 JS 函数。新增接口同步声明路径和方法,服务端仍须鉴权。腾讯托管网关负责 CORS 响应,避免重复添加跨域头。
|
|
30
39
|
|
|
31
|
-
按工具包
|
|
40
|
+
按工具包 templates/cloud-service 初始化本地源码;已有工程保留代码。函数目录执行 npm ci,新增依赖后提交锁文件。部署将 SDK 和业务依赖打包,产物在 .shaper/cloud-build/<digest>。旧 handler 项目需显式升级为 HTTP 服务,不能直接换 SDK 版本。
|
|
32
41
|
|
|
33
|
-
|
|
42
|
+
前端使用 ShaperAI.cloud.request({ path, method, data }),完整玩家接入见 hupu-business。迁移、后端部署和网页预览分别验证;真实登录和云端读写通过才算链路完成。当前已完成腾讯云新版真机验证,阿里云仍待验证。
|
|
34
43
|
|
|
35
|
-
|
|
44
|
+
需要排行榜时,调用 shaper_templates 找到 leaderboard 项目,先读 docs/integration.md,再参考其前后端与迁移。已有项目复用原身份、积分和服务入口,按业务融合;模板的自报成绩示例不作为可信奖励计分。
|
|
@@ -13,11 +13,12 @@ description: 检查新旧 Shaper 项目的归属,初始化或关联应用,
|
|
|
13
13
|
|
|
14
14
|
- **新建、接入源码、识别旧下载包或补配置**:先读[项目接入](references/project-setup.md),完成归属检查后再调用 init;init 只关联应用,不生成工程。保留已有源码、构建方式和应用 ID。
|
|
15
15
|
- **授权不足、账号冲突或等待确认**:读[账号与授权](references/authentication.md)。新项目创建确认由 init 发起,不单独对预分配 ID 登录。
|
|
16
|
+
- **使用、上传或管理我的素材**:读[素材库](references/materials.md)。素材属于账号,无需初始化应用。
|
|
16
17
|
- **已有工程继续开发**:直接编辑和验证,按下方流程执行。
|
|
17
18
|
|
|
18
19
|
## 开始创作与继续开发
|
|
19
20
|
|
|
20
|
-
接入完成且需求尚未明确时,引导用户描述想法,暂不选模板。需求已明确且尚无工程时,由 AI
|
|
21
|
+
接入完成且需求尚未明确时,引导用户描述想法,暂不选模板。需求已明确且尚无工程时,由 AI 根据交互特点选择工程模板,调用 `shaper_create(workspace, template)`(CLI:`shaper create --template react`),再实现需求;不要让用户选择技术栈。已有源码沿用原工程,不调用 create 覆盖。`project.engineering.status: not_created` 是正常待创作状态;configuration_required 才需要检查已有工程并补配置。
|
|
21
22
|
|
|
22
23
|
用 Agent 自带的文件工具编写项目。`shaper_dev_start` 返回就绪 URL 后,在浏览器检查用户实际会用的交互、控制台错误和窄屏布局。开发日志用 `shaper_dev_logs`。停止服务用 `shaper_dev_stop`;状态查询不会重启服务。
|
|
23
24
|
|
|
@@ -27,6 +28,10 @@ description: 检查新旧 Shaper 项目的归属,初始化或关联应用,
|
|
|
27
28
|
|
|
28
29
|
新官方模板统一维护 docs/product.md、docs/design.md 和 docs/validation.md;已接入新版的工程只补缺失文档,不搬迁或覆盖源码。React 按业务组织组件,状态靠近使用者;异步操作具有失败反馈与重复提交保护。不默认添加路由、全局状态或大型 UI 库。
|
|
29
30
|
|
|
31
|
+
## 复用完整项目模板
|
|
32
|
+
|
|
33
|
+
需要排行榜或离线养成时,调用 `shaper_templates`(CLI:`shaper templates`),读取对应目录的 `docs/integration.md`。每个模板包含自己的前端、所需后端、数据库与说明。新空工程可用 `leaderboard` 或 `offline-game` 创建;已有工程先检查现有身份、积分、存档与路由,再按说明增量融合并验证原业务,模板目录只读。后端迁移与部署交由 shaper-backend。
|
|
34
|
+
|
|
30
35
|
## 用户引导
|
|
31
36
|
|
|
32
37
|
- 接入完成先说明可以开始创作,引导用户直接描述想法;仅确需重启客户端时给出重启步骤。版本、App ID、配置和检查明细用于排查,不作为默认完成报告。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# 我的素材
|
|
2
|
+
|
|
3
|
+
素材属于当前账号,不需要 App ID。先确认用户要上传或使用的具体内容。
|
|
4
|
+
|
|
5
|
+
- 查询使用 `materials_search`,当前只搜索指定目录,未指定时是根目录。沿返回的文件夹进入查询,不宣称搜过全库;公共素材尚未开放。
|
|
6
|
+
- 权限不足时,通过 `shaper_auth_start(materials="read")` 或 `materials="write"` 按需补充,复用已有登录。
|
|
7
|
+
- 下载使用实际素材标识和 `materials_download`,目标在用户指定工作目录内,已有文件不覆盖。
|
|
8
|
+
- 上传调用 `materials_upload(workspace, files, folderId)`,只选择用户明确要求的文件。提供返回的网页确认链接,等待用户本人确认,不能代替点击或通过其他接口绕过。确认后用相同参数再次调用,续传同一批文件。
|
|
9
|
+
- 删除先查询素材,使用实际标识 调用 `materials_delete`。本人在网页确认后才执行;只支持明确文件,不递归删除目录。
|
|
10
|
+
- 查询使用 `materials_status(operationId)`。approved 是等待本地上传,succeeded 才是完成。partial 仅处理失败项;uncertain 查询原操作并核对素材库,不新建批次重复上传或删除。
|
|
11
|
+
- 文件或目标变化、取消或过期后,说明需要重新确认,再使用新的 requestKey 发起。网络错误保留原 requestKey。
|
|
12
|
+
- 重命名使用 `materials_rename(id, newName)`,沿用素材服务的同目录重名检查。出现 uncertain 时保留 requestKey 并核对列表,避免重复写入。
|
|
13
|
+
|
|
14
|
+
简短说明下一步:“请确认这 3 个文件的上传,完成后回复继续。”完成时说明实际成功数量,图片在结果页可预览。Token、摘要和本地状态文件仅供工具使用。
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
|
|
48
48
|
## 旧版下载项目
|
|
49
49
|
|
|
50
|
-
发现 activity.json 的 activityId、AGENTS.md
|
|
50
|
+
发现 activity.json 的 activityId、AGENTS.md 的旧版生成标记或 skills/act-cloudbase 时,保留原下载技能及原开发方式,停止新版初始化、开发和交付流程。目录名不是判定依据;已写入 .shaper 绑定不代表升级完成。
|
|
51
51
|
|
|
52
52
|
工具返回 LEGACY_PROJECT_UPGRADE_REQUIRED 时说明:这是旧版项目,仍可按原方式开发。不要删除标识、改用 link、覆盖指导或运行旧脚本来绕过新版限制。
|
|
53
53
|
|
|
@@ -1,18 +1,25 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: shaper-game-development
|
|
3
|
-
description:
|
|
3
|
+
description: 实现游戏可玩循环、场景与资源,检查试玩并根据反馈调优;适用于新游戏、活动中的游戏环节及已有游戏迭代。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 游戏制作
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
先读已有 docs/product.md、docs/design.md 和游戏代码,判断当前是新玩法、实现、排错还是调优。小改动直接进入对应阶段,已有信息不重复询问。
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
2. 场景负责生命周期和编排;计分、胜负、成长规则与引擎对象分离。资源 key/路径集中管理,加载失败能解释和恢复。
|
|
12
|
-
3. 清理离开场景时的事件与计时器;重玩和热更新不重复创建实例。明确切后台是否计时,手动暂停不得被自动恢复覆盖;声音由用户手势开启。
|
|
13
|
-
4. 试玩检查输入响应、边界、失败与重玩、不同屏幕、持续运行;按实际设备记录帧率或卡顿依据。根据观察调整节奏和反馈,不凭截图宣称好玩。
|
|
14
|
-
5. 更新 docs/design.md 的玩法实现与取舍、docs/validation.md 的实际试玩结论及未验证项。
|
|
10
|
+
## 按当前任务推进
|
|
15
11
|
|
|
16
|
-
|
|
12
|
+
1. 新玩法或核心循环不清楚:读 [可玩循环](references/playable-loop.md),明确第一分钟、目标、挑战和本期范围。产品规则维护在 docs/product.md;体验方向由 shaper-design 承接。
|
|
13
|
+
2. 创建或修改游戏代码:读 [实现](references/implementation.md)。新工程通过 shaper-development 完成接入和模板创建;已有工程沿用技术栈,在标准工程内做可玩版本。
|
|
14
|
+
3. 首次交付或改动后:读 [试玩检查](references/playtest.md),实际操作受影响流程,将结果与未验证项写入 docs/validation.md。
|
|
15
|
+
4. 用户反馈操作、节奏、难度或内容问题:读 [迭代调优](references/iteration.md),保留已认可的体验,修改后再次试玩。
|
|
17
16
|
|
|
18
|
-
|
|
17
|
+
交付给出可打开的试玩入口、操作方法及实际完成情况,邀请用户反馈一个最值得观察的体验问题。没有实际试玩就明确说明,不能把构建通过等同于好玩。用户希望分享或发布时转入 shaper-release。
|
|
18
|
+
|
|
19
|
+
## 按需协作
|
|
20
|
+
|
|
21
|
+
- 离线成长、自动产出、离线结算使用 shaper-idle-game;未安装时按需求补充。代码参考通过 shaper_templates 查找 offline-game/docs/integration.md,已有工程融合现有状态和存档,空工程才用 create。
|
|
22
|
+
- 可信奖励、排行榜及共享数据由 shaper-backend 处理;虎扑身份和分享由 hupu-business 接入。按需使用,平台授权仍走既有流程。
|
|
23
|
+
- 工程、预览和构建复用 shaper-development;产品、体验及验证仍维护现有三份文档,不建立另一套 GDD、角色体系或任务看板。
|
|
24
|
+
|
|
25
|
+
方法来源及适配边界见 [来源说明](references/sources.md),仅追溯来源时读取。
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# 游戏实现
|
|
2
|
+
|
|
3
|
+
用于制作首版或修改游戏代码。先检查已有入口、引擎、场景、资源与存档,按现有结构增量实现。
|
|
4
|
+
|
|
5
|
+
- 需求明确后再选模板;新 2D 实时玩法可用 Phaser,页面式玩法可用 React,已有工程沿用原栈。模板创建交给 shaper-development,不新建独立 HTML 原型再搬回工程。
|
|
6
|
+
- 先贯通一条可玩的循环,再补充本期内容。场景管理生命周期和编排;计分、胜负、成长与结算规则尽量独立于引擎对象,便于验证。
|
|
7
|
+
- 将常调的速度、冷却、难度、奖励等数值集中在现有配置模块;记录单位、含义与合理边界。简单项目使用普通模块即可,不默认建设编辑器、调参面板或通用框架。
|
|
8
|
+
- 操作反馈要对应结果:输入是否接受、命中或失败原因、分数或资源变化、下一步能做什么。反馈强度与玩法节奏一致;画面细节按 shaper-design 的依据实现。
|
|
9
|
+
- 资源 key 与路径集中维护,使用符合方向且来源可追溯的素材。缺失资源提供可理解的恢复方式;占位素材明确标注,交付前检查角色、背景与 HUD 是否协调。
|
|
10
|
+
- 退出场景清理监听器、计时器和实例;重玩、热更新不重复注册。明确暂停、切后台的计时规则,手动暂停不被自动恢复覆盖;声音由用户手势开启。
|
|
11
|
+
- 存档沿用已有格式和版本迁移;涉及离线收益时读取专项技能。涉及真实奖励与多人共享状态时由后端验证,前端成绩不是可信依据。
|
|
12
|
+
|
|
13
|
+
完成标准:本期主循环已可运行,关键规则能独立检查,暂停/重玩/资源失败有明确行为。将实现取舍更新到 docs/design.md,随后按试玩检查验证。
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# 迭代调优
|
|
2
|
+
|
|
3
|
+
用于试玩后的反馈、体验问题和内容扩展。先读现有规则、用户已认可的体验及未提交改动,保留用户自行修改的代码。
|
|
4
|
+
|
|
5
|
+
1. 把反馈转为可观察问题:“难”可能是操作不响应、目标不清楚、惩罚过重或数值过高;先复现或查看证据。歧义影响改法时只问一个关键体验问题。
|
|
6
|
+
2. 根据原因修改:操作问题检查输入与反馈;节奏问题调整间隔和变化;无聊时检查目标、选择与挑战是否单一,而非只提高速度。新增机制应符合用户目标和本期范围。
|
|
7
|
+
3. 使用集中配置调整参数,说明调整前后希望发生的体验变化。已有好评部分保持稳定;会推翻用户明确约束时先说明冲突并确认,普通修复直接执行。
|
|
8
|
+
4. 按用户本次请求完成改动,不顺带重做工程或增加外围系统。同步变化的产品规则和设计取舍,避免代码与文档出现两套玩法。
|
|
9
|
+
5. 重跑受影响流程,条件允许时用相同场景或固定随机种子比较。提供更新后的试玩入口、主要变化和仍待用户体验确认的部分。
|
|
10
|
+
|
|
11
|
+
完成标准:反馈对应的改动可观察,原有关键流程仍可用,技术检查与用户主观评价分别记录。回退使用项目已有版本管理且保留用户改动;不擅自提交、推送或发布。
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# 可玩循环
|
|
2
|
+
|
|
3
|
+
用于新玩法、模糊需求或核心体验调整。已有规则足够时直接实现,不重新做需求访谈。
|
|
4
|
+
|
|
5
|
+
1. 从用户原话和现有产品文档提取:玩家做什么、想达成什么、有什么挑战、操作后如何获得反馈。保留明确的风格偏好、必须保留和明确不做的内容。
|
|
6
|
+
2. 只有会改变核心玩法的缺口才询问,合并为一轮简短问题,用体验语言和可理解的选项。技术栈由 AI 根据现有工程和需求选择。用户让 AI 决定时采用合理默认并说明;方向完全模糊时给两三个一句话玩法供选择。
|
|
7
|
+
3. 写清第一分钟:进入看到什么 → 如何开始操作 → 首次有效反馈 → 第一个挑战 → 完成、失败或继续。养成等无终局玩法,以一次收获或升级作为可验证闭环,不强加胜负。
|
|
8
|
+
4. 将目标、规则、本期范围和完成条件简短写入 docs/product.md;视觉与操作体验写入 docs/design.md。已明确授权制作且无关键歧义时继续开发,不新增固定审批关卡。
|
|
9
|
+
|
|
10
|
+
首版只覆盖一条完整循环:能进入、能操作、能看懂结果、能继续或重玩。示例:投篮首版先做瞄准、出手、命中反馈、计分和重玩;排行榜、奖品、多个场馆只有需求需要才加入。
|
|
11
|
+
|
|
12
|
+
完成标准:能用几句话解释玩法,能列出一次实际操作的预期结果,明确首版暂不包含什么。用户只要求产品方案时到此结束。
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# 试玩检查
|
|
2
|
+
|
|
3
|
+
首次交付检查主循环;小修改检查受影响路径及相邻回归。使用实际可用的浏览器或设备工具操作游戏,不只读源码和截图。
|
|
4
|
+
|
|
5
|
+
| 检查 | 观察依据 |
|
|
6
|
+
| --- | --- |
|
|
7
|
+
| 启动与资源 | 实际打开入口,无白屏、阻断性报错和关键资源缺失 |
|
|
8
|
+
| 输入与反馈 | 实际点击、触摸或按键,能观察到对应状态变化;目标设备为手机时检查触摸行为 |
|
|
9
|
+
| 核心循环 | 至少走完一次开始、主要操作、结果、继续或重玩;覆盖玩法存在的失败分支 |
|
|
10
|
+
| 画面与理解 | 查看实际截图,检查目标屏幕的遮挡、越界、文字可读性、HUD 和结果提示 |
|
|
11
|
+
| 生命周期 | 重玩不加速或重复计分;按玩法检查暂停、切后台恢复和存档读取 |
|
|
12
|
+
| 稳定性 | 实际持续运行并记录时长;有性能要求时记录设备和测量依据,不猜测帧率 |
|
|
13
|
+
|
|
14
|
+
把本期要求逐项标为已验证、失败或未验证,并给出实际结果。缺少浏览器、真机或身份条件时写清限制,不能将未执行项目标为通过。联机玩法的本地运行不能证明真实网络体验。
|
|
15
|
+
|
|
16
|
+
修复阻断问题后重跑相关路径。自动化可以验证操作和规则,但不能证明游戏好玩;难度与节奏需要用户试玩反馈。
|
|
17
|
+
|
|
18
|
+
docs/validation.md 只记录本次版本、设备/环境、操作、预期与实际、必要截图位置和未验证项。交付用产品语言提供试玩链接和操作说明,再指出一个需要反馈的问题,例如“试一局,看看出手是否跟手”。不要把完整测试日志作为用户的下一步。
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# 方法来源
|
|
2
|
+
|
|
3
|
+
参考 Donchitos/Claude-Code-Game-Studios,2026-11-13 查阅,来源快照 abc0de79d6ceb0b5d7aa693945849b3937afbe6a(MIT):
|
|
4
|
+
https://github.com/Donchitos/Claude-Code-Game-Studios/tree/abc0de79d6ceb0b5d7aa693945849b3937afbe6a
|
|
5
|
+
|
|
6
|
+
参考范围为 .claude/skills/prototype 中的简短玩法方案、首版制作、自检与反馈迭代方法。Shaper 重新编写指导,使用现有 product/design/validation 文档、标准工程、平台预览与授权链路。没有复制或执行上游脚本、hooks、Agent 配置或示例素材,也不引入工作室角色编排、独立 HTML 原型迁移和固定阶段审批。
|
|
@@ -7,7 +7,7 @@ description: 将 Shaper 网页工程构建、上传预览并提交发布审核
|
|
|
7
7
|
|
|
8
8
|
调用 `shaper_status(workspace)` 确认当前账号、服务和应用绑定。已有用户明确要求部署或提交审核时直接完成已授权流程。
|
|
9
9
|
|
|
10
|
-
旧版下载包(activity.json.activityId
|
|
10
|
+
旧版下载包(activity.json.activityId、旧版生成指导块或 act-cloudbase 技能)继续原项目流程,本技能停止新版接入;LEGACY_PROJECT_UPGRADE_REQUIRED 不能通过删除标识、link 或旧脚本绕过。升级策略见 shaper-development。
|
|
11
11
|
|
|
12
12
|
1. 用 `shaper_web_deploy` 构建并上传网页代码。它复用 Shaper 版本、内容校验和预览服务。检查操作 `status`、校验结果、`versionId` 与预览信息;上传成功并不代表应用已发布。
|
|
13
13
|
2. 展示 `result.preview.previewUrl`、`expiresAt` 和二维码;MCP 同时返回二维码图片,CLI 返回 `qrCodePath`。打开云端预览地址验证页面,手机扫描该二维码;本机回环链接不用于手机分享。链接过期、预览生成失败或仅需查看已有版本时,用 `shaper_web_preview(workspace, versionId)` 获取或刷新;省略版本只复用该工程最近一次已确认交付,不选择其他应用或新建版本。若已安装工具缺少此能力,明确提示升级 Toolkit/插件,不用重新上传代替刷新。需要虎扑登录或分享时,在实际 Shaper/虎扑容器中检查对应能力;本地浏览器检查作为独立证据。
|
|
@@ -1,33 +1,7 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 应用后端
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`server.cjs` 是普通 Express 服务;从 `@hupu-tech/shaper-cloud` 导入 `createClient`,使用 `cloud.auth.requireUser` 校验玩家、`cloud.db` 访问 PostgreSQL。按 `PORT` 启动服务。
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
- `cloud.json`:SDK 精确版本、Node 运行参数、路由和 public/user 访问规则。
|
|
7
|
-
- `migrations/`:版本化 PostgreSQL 迁移;已应用文件不能修改,变更另加新版本。
|
|
8
|
-
- `package-lock.json`:锁定 SDK 与业务依赖;在函数目录执行 `npm ci`。SDK 从公共 npm 安装,版本必须与 cloud.json 一致。
|
|
5
|
+
业务路由在服务代码中;网关声明只限制公开路径、方法和登录要求,不映射处理函数。私有接口必须在服务代码中校验身份并按 `user.puid` 限制数据归属。
|
|
9
6
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
```sh
|
|
13
|
-
# 获得用户对当前应用开通的明确同意后:
|
|
14
|
-
shaper cloud create
|
|
15
|
-
shaper cloud status # 确认 ready 后继续
|
|
16
|
-
shaper cloud db migrate --version 202610250001_init --file functions/api/migrations/202610250001_init.sql
|
|
17
|
-
# 确认上一迁移已生效后继续
|
|
18
|
-
shaper cloud db migrate --version 202610250002_events --file functions/api/migrations/202610250002_events.sql
|
|
19
|
-
# 确认迁移已生效后部署
|
|
20
|
-
shaper cloud deploy --directory functions/api
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
以后修改 handlers/cloud.json,直接再次 deploy;新增表字段先迁移。deploy 自动构建 CommonJS、打包第三方纯 JS 依赖,并外置平台 SDK。它不执行任意 npm build 脚本,也不自动运行数据库迁移。增加第三方依赖后在本目录安装,提交锁文件;动态依赖、原生二进制及额外资源文件不属于这版单 bundle 部署契约。
|
|
24
|
-
|
|
25
|
-
鉴权在云厂商网关执行。user 路由中的 `user.puid` 可信;public 路由没有 user。业务不读取身份头、Token、PG 环境变量,不创建连接池。Node 控制面绑定应用资源,Hupu 不代理业务 HTTP 或 SQL。
|
|
26
|
-
|
|
27
|
-
`db.query(sql, values)` 使用参数化 SQL。`db.transaction(async tx => {...})` 内必须 await 全部操作;真实 PG 事务固定一个连接,失败回滚,不自动重试、不支持嵌套。数据归属、业务角色、分数校验仍由业务实现;SDK 不会自动加用户过滤或 RLS。
|
|
28
|
-
|
|
29
|
-
初始示例包含排行榜和个人进度,仅用于演示:公开榜单返回测试 PUID,正式业务应改成展示资料;自报分数不具备防作弊能力。重复 submissionId 返回 409 且整笔回滚;未提供时使用请求 ID,因此网络重试不保证去重。
|
|
30
|
-
|
|
31
|
-
cloud.json 是路由声明的源文件,修改后通过 cloud deploy 随服务发布。构建由 deploy 自动完成。
|
|
32
|
-
|
|
33
|
-
异步返回 queued/running 仅表示受理或执行中。开通以 cloud status 的 ready 为准;发布以当前 release.digest 和接口验证为准。写操作自动等待结果;仍在处理中时通过 cloud status 查看未完成和最近操作,迁移 succeeded 后才执行依赖变更。结果未知时不重复提交。
|
|
7
|
+
在函数目录执行 npm ci。新增依赖后提交锁文件;部署会打包 SDK 和业务依赖。数据库结构变更先迁移成功,再部署服务。运行绑定由平台注入,凭据不写入源码。
|