@hupu-tech/shaper 0.0.0-stage → 0.2.3

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 (82) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/LICENSE +3 -0
  3. package/README.md +98 -2
  4. package/dist/api.d.ts +29 -0
  5. package/dist/auth.d.ts +80 -0
  6. package/dist/cli.js +14 -0
  7. package/dist/cloud-service.d.ts +55 -0
  8. package/dist/cloud.d.ts +71 -0
  9. package/dist/config.d.ts +21 -0
  10. package/dist/core.d.ts +17 -0
  11. package/dist/credentials.d.ts +23 -0
  12. package/dist/dev-runner.js +1 -0
  13. package/dist/dev.d.ts +66 -0
  14. package/dist/index.d.ts +9 -0
  15. package/dist/index.js +1 -0
  16. package/dist/legacy-cloud.d.ts +25 -0
  17. package/dist/runtime.d.ts +54 -0
  18. package/dist/runtime.js +1 -0
  19. package/dist/shared-2ZNSJXPO.js +15 -0
  20. package/dist/shared-BTZI42QW.js +17 -0
  21. package/dist/workspace.d.ts +84 -0
  22. package/package.json +73 -4
  23. package/skills/compat/hupu-cloud/SKILL.md +8 -0
  24. package/skills/core/hupu-business/SKILL.md +14 -0
  25. package/skills/core/hupu-business/references/runtime.md +55 -0
  26. package/skills/core/shaper-backend/SKILL.md +35 -0
  27. package/skills/core/shaper-backend/references/legacy.md +41 -0
  28. package/skills/core/shaper-backend/references/node-server.md +44 -0
  29. package/skills/core/shaper-design/SKILL.md +16 -0
  30. package/skills/core/shaper-development/SKILL.md +54 -0
  31. package/skills/core/shaper-game-development/SKILL.md +16 -0
  32. package/skills/core/shaper-product/SKILL.md +17 -0
  33. package/skills/core/shaper-product/references/ecosystem.md +10 -0
  34. package/skills/core/shaper-release/SKILL.md +17 -0
  35. package/skills/game/shaper-idle-game/SKILL.md +16 -0
  36. package/skills/manifest.json +18 -0
  37. package/templates/cloud-service/README.md +32 -0
  38. package/templates/cloud-service/cloud.json +30 -0
  39. package/templates/cloud-service/handlers.cjs +46 -0
  40. package/templates/cloud-service/migrations/202610250001_init.sql +5 -0
  41. package/templates/cloud-service/migrations/202610250002_events.sql +8 -0
  42. package/templates/h5/docs/design.md +3 -0
  43. package/templates/h5/docs/product.md +3 -0
  44. package/templates/h5/docs/validation.md +3 -0
  45. package/templates/h5/index.html +24 -0
  46. package/templates/h5/package-lock.json +828 -0
  47. package/templates/h5/package.json +15 -0
  48. package/templates/h5/public/.gitkeep +0 -0
  49. package/templates/h5/shaper.config.json +7 -0
  50. package/templates/h5/src/main.js +7 -0
  51. package/templates/h5/src/style.css +21 -0
  52. package/templates/h5/vite.config.js +4 -0
  53. package/templates/phaser/docs/design.md +3 -0
  54. package/templates/phaser/docs/product.md +3 -0
  55. package/templates/phaser/docs/validation.md +3 -0
  56. package/templates/phaser/index.html +2 -0
  57. package/templates/phaser/package-lock.json +1287 -0
  58. package/templates/phaser/package.json +19 -0
  59. package/templates/phaser/public/.gitkeep +0 -0
  60. package/templates/phaser/shaper.config.json +7 -0
  61. package/templates/phaser/src/game/create-game.ts +5 -0
  62. package/templates/phaser/src/game/rules/scoring.ts +2 -0
  63. package/templates/phaser/src/game/scenes/PlayScene.ts +15 -0
  64. package/templates/phaser/src/main.ts +4 -0
  65. package/templates/phaser/src/styles.css +1 -0
  66. package/templates/phaser/tsconfig.json +21 -0
  67. package/templates/phaser/vite.config.ts +4 -0
  68. package/templates/react/docs/design.md +3 -0
  69. package/templates/react/docs/product.md +3 -0
  70. package/templates/react/docs/validation.md +3 -0
  71. package/templates/react/index.html +2 -0
  72. package/templates/react/package-lock.json +1329 -0
  73. package/templates/react/package.json +22 -0
  74. package/templates/react/public/.gitkeep +0 -0
  75. package/templates/react/shaper.config.json +7 -0
  76. package/templates/react/src/app/App.tsx +5 -0
  77. package/templates/react/src/app/styles.css +1 -0
  78. package/templates/react/src/main.tsx +6 -0
  79. package/templates/react/tsconfig.json +21 -0
  80. package/templates/react/vite.config.ts +4 -0
  81. package/vendor/cloud-server/hupu-cloud-server-0.1.0.tgz +0 -0
  82. package/vendor/cloud-server/release.json +12 -0
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: shaper-development
3
+ description: 检查新旧 Shaper 项目的归属,初始化或关联应用,继续开发及排查本地预览。用于 Shaper 工程开发;网页交付使用 shaper-release,云资源使用 shaper-backend。
4
+ ---
5
+
6
+ # Shaper 本地开发
7
+
8
+ 工具全局安装,代码属于普通本地项目。初始化前先检查归属;网页提示词里的 App ID 只是期望接入的目标,不是覆盖本地绑定的授权。
9
+
10
+ ## 初始化前检查
11
+
12
+ 1. 确定用户要操作的绝对目录,调用 `shaper_status`。MCP 启动目录不能代替项目目录。目录不存在时先确认路径与新建意图;不要为执行状态查询提前创建工程。
13
+ 2. 用文件工具读取 `.shaper/project.json`(若存在)、项目说明和明确的旧应用配置,核对原 App ID 与服务地址。不要把 SDK 示例、依赖或测试数据中的 ID 当作项目身份;避免读取或输出凭据。
14
+ 3. 检查是否有源码,以及 `package.json`、锁文件、原构建配置和 `shaper.config.json`。记录真实启动命令、构建命令、产物目录。没有新规范配置不代表空项目;构建方式不明时先调查或询问。
15
+ 4. 按下表确定目标。目标和权限明确前,保持工程文件与绑定不变。
16
+
17
+ | 检查结果 | 下一步 |
18
+ | --- | --- |
19
+ | 已有绑定,无指定目标或目标相同 | 验证原应用权限,直接继续开发;仅确需补缺时再调用 init |
20
+ | 本地绑定或明确旧 App ID 与网页目标不同 | 展示两个应用的名称和 ID,停止初始化;引导进入原应用,不自动更换绑定 |
21
+ | 找到明确旧 App ID,目标一致或未指定 | 验证原应用后显式传 `appId` 接入,不创建应用 |
22
+ | 空目录,已指定目标 | 使用 `appId` 初始化;若尚未创建,浏览器确认创建并授权 |
23
+ | 空目录,明确要求新作品 | init 保存预分配 ID,经浏览器确认创建并授权后初始化 |
24
+ | 已有源码,归属无法确定或多个候选 | 询问“继续哪个已有应用,还是将这份代码作为新应用”;网页参数本身不能代替确认 |
25
+
26
+ 空目录且明确新建作品时可省略 `appId`,工具会持久化预分配 ID。已有源码必须先确定目标;无法确定时请用户选择原应用或从网页开始新的作品,再携带网页 ID。普通初始化不执行 `shaper_link`;用户明确要求更换关联时,先核对原应用、目标和影响。
27
+ ## 授权与接入
28
+
29
+ - 登录由同一台电脑、同一服务下的所有项目和 Agent 共用,不按聊天重新登录。调用 `shaper_auth_start` 后,`status: complete` 表示已复用登录;仅在 `pending` 时展示网页链接并使用 `flowId` 查询 `shaper_auth_status`。
30
+ - 已有应用缺少授权:调用 `shaper_auth_start(appId: 应用ID)`;需要手动补充其他范围时传 `reauthorize: true`。网页确认会追加权限,已有应用权限保留。拒绝或超时不清除原登录。
31
+ - 项目始终按传入绝对目录的 `.shaper/project.json` 定位,不能使用最近操作的应用或 MCP 启动目录兜底。`binding.authorized: false` 时先处理对应权限错误,不重新创建应用。
32
+ - 网页账号与本机账号不一致时,切回原账号。只有用户明确要求切换全局账号时才执行 `shaper_logout` 再登录;退出会影响当前服务的全部本地项目。
33
+
34
+ 目标确定后直接调用 init,由工具检查授权和应用存在性。预分配 ID 尚不是应用,不单独对它执行 `shaper_auth_start`:
35
+
36
+ - 返回 `awaiting_confirmation`:展示 `authorizationUrl`,用 `flowId` 查询 `shaper_auth_status`。登录和创建/关联确认在同一浏览器流程完成;完成后用原目录、原参数再次 init。拒绝、失败或超时保持原状态,不改 ID 重试。CLI init 会等待浏览器回调后继续。
37
+ - `AUTH_IN_PROGRESS`:先完成返回的 flowId 对应授权,再重试,不发起并行登录。
38
+
39
+
40
+ - 新目录:调用 `shaper_init(workspace, name, template, appId?)`。根据需求选择 h5、react 或 phaser;指定已有应用时必须传 `appId`。
41
+ - 旧工程:使用已确定的应用 ID 初始化;新作品使用网页预分配 ID。保留原目录、包管理器和构建方式,不强制搬入 src 或换成 Vite。核对并补齐缺失配置,不覆盖已有文档或用户配置。当前工具可能生成默认构建命令,接入后必须与预先识别的原工程命令核对并调整。
42
+ - 中断或失败:检查已有绑定和原请求状态后继续;保留已创建应用的 ID,不删除状态、换名字或改目录来重新创建。不确定原创建结果时先核实。
43
+ - 完成条件:`shaper_status` 确认绑定目标及权限,`shaper_check` 检查配置,再构建验证。需要运行验证时启动本地预览;分别说明已验证和未验证项。失败则报告“已关联,但构建/预览待修复”,不宣称完整接入成功。
44
+ - 返回应用名称、关联结果和可验证的应用入口。后续上传使用同一应用,不能再引导用户从网页新建另一个应用。
45
+
46
+ ## 继续开发
47
+
48
+ 用 Agent 自带的文件工具编写项目。`shaper_dev_start` 返回就绪 URL 后,在浏览器检查用户实际会用的交互、控制台错误和窄屏布局。开发日志用 `shaper_dev_logs`。停止服务用 `shaper_dev_stop`;状态查询不会重启服务。
49
+
50
+ 项目绑定位于 `.shaper/project.json`,仅包含服务 origin 和应用 ID,默认忽略提交。可提交 `shaper.config.json` 和依赖锁文件。授权存放在用户配置目录的 credentials 文件中,由工具管理;不要读取、展示、复制这些凭证到对话或工程。技能和工程中不放 token、云密钥或复制来的登录态。
51
+
52
+ `shaper_check` 只检查配置。交付前执行 `shaper_build`,同时完成浏览器行为检查。报告构建、页面行为和真实虎扑容器能力分别验证到了哪一步。普通浏览器没有虎扑桥接时,界面应解释不可用,不能伪造已登录。
53
+
54
+ 新官方模板统一维护 docs/product.md、docs/design.md 和 docs/validation.md;旧工程只补缺失文档,不搬迁或覆盖源码。React 按业务组织组件,状态靠近使用者;异步操作具有失败反馈与重复提交保护。不默认添加路由、全局状态或大型 UI 库。
@@ -0,0 +1,16 @@
1
+ ---
2
+ name: shaper-game-development
3
+ description: 细化并实现游戏玩法、最小可玩原型、场景与资源,进行试玩和调优;适用于独立游戏或活动中的游戏环节。
4
+ ---
5
+
6
+ # 游戏制作
7
+
8
+ 读 docs/product.md 的目标与规则、docs/design.md 的体验及现有游戏代码。已有引擎沿用;需要创建或接入工程时先按 shaper-development 完成归属与授权检查;新 2D 游戏可用 shaper_init 的 phaser 模板,页面式玩法可用 React,不默认混用引擎。
9
+
10
+ 1. 明确核心循环、输入、反馈、胜负和重玩条件,先做一条可玩的完整循环;不先建设通用游戏框架。
11
+ 2. 场景负责生命周期和编排;计分、胜负、成长规则与引擎对象分离。资源 key/路径集中管理,加载失败能解释和恢复。
12
+ 3. 清理离开场景时的事件与计时器;重玩和热更新不重复创建实例。明确切后台是否计时,手动暂停不得被自动恢复覆盖;声音由用户手势开启。
13
+ 4. 试玩检查输入响应、边界、失败与重玩、不同屏幕、持续运行;按实际设备记录帧率或卡顿依据。根据观察调整节奏和反馈,不凭截图宣称好玩。
14
+ 5. 更新 docs/design.md 的玩法实现与取舍、docs/validation.md 的实际试玩结论及未验证项。
15
+
16
+ 离线成长、自动产出或离线结算可使用独立的 shaper-idle-game 技能(未安装时按需求补充,不阻断普通游戏)。奖励、排行榜等可信状态需要 shaper-backend;壳身份和分享由 hupu-business 接入。工程和预览复用 shaper-development,网页交付由 shaper-release 处理。
@@ -0,0 +1,17 @@
1
+ ---
2
+ name: shaper-product
3
+ description: 规划 Shaper 产品的目标、用户流程、业务规则和一期范围,定义可检查的验收条件;不代替体验设计或代码实现。
4
+ ---
5
+
6
+ # 产品规划
7
+
8
+ 先读现有 docs/product.md;从用户当前目标补充信息,不从模板推导业务。小修改只更新受影响规则。
9
+
10
+ 1. 明确为谁解决什么问题、用户从哪里进入、如何完成主要目标。活动与游戏可组合,不按类型强迫二选一。
11
+ 2. 写清主流程、必要分支、数据归属与完成条件。参与资格、奖励、次数、排行榜只有需求需要时才设计;缺失且影响实现的规则才询问用户。
12
+ 3. 区分本期、后续与不做;每项本期能力给出可观察的验收条件。记录假设,不把假设标为已确认。
13
+ 4. 将结果维护在 docs/product.md。已有约定优先复用;不另外生成重复 PRD 或任务系统。
14
+
15
+ 涉及虎扑生态时读取 [能力用途](references/ecosystem.md)。承诺能力前查询当前应用实际支持情况;无法核实时写明限制。体验实现交给 shaper-design,网页/游戏/后端按实际任务组合对应技能,不自动启动完整流程。
16
+
17
+ 完成时说明目标、主流程、范围和未确定的关键规则;纯产品请求以方案结束,不自行创建应用或部署。
@@ -0,0 +1,10 @@
1
+ # 生态能力用途
2
+
3
+ | 能力 | 产品用途 | 前提与实现职责 |
4
+ | --- | --- | --- |
5
+ | 玩家身份 | 保存个人进度、区分用户数据 | hupu-business 接入真实玩家会话;shaper-backend 校验数据归属。普通浏览器不保证壳能力可用 |
6
+ | 分享 | 用户主动传播当前内容 | hupu-business 核对当前 SDK 和容器支持;分享成功不等于被其他人打开 |
7
+ | 后台与数据库 | 多人共享状态、跨设备保存、可信规则 | shaper-backend 核对云权限、资源及费用;客户端结果不能直接成为奖励依据 |
8
+ | 预览与提审 | 试用并交付版本 | shaper-release;上传、提审、上线是不同状态 |
9
+
10
+ 社区发帖、消息、分发推荐和奖励发放不在已确认接入范围。需要时先核实接口与权限,不按生态归属臆造能力。
@@ -0,0 +1,17 @@
1
+ ---
2
+ name: shaper-release
3
+ description: 将 Shaper 网页工程构建、上传预览并提交发布审核,检查交付结果。云函数部署由 shaper-backend 处理。
4
+ ---
5
+
6
+ # Shaper 网页交付
7
+
8
+ 调用 `shaper_status(workspace)` 确认当前账号、服务和应用绑定。已有用户明确要求部署或提交审核时直接完成已授权流程。
9
+
10
+ 1. 用 `shaper_web_deploy` 构建并上传网页代码。它复用 Shaper 版本、内容校验和预览服务。检查操作 `status`、校验结果、`versionId` 与预览信息;上传成功并不代表应用已发布。
11
+ 2. 打开返回的预览地址验证页面。需要虎扑登录或分享时,在实际 Shaper/虎扑容器中检查对应能力;本地浏览器检查作为独立证据。
12
+ 3. 用户要求发布时,调用 `shaper_web_publish`,提供 `versionId` 和说明;可选工程内的 `coverPath`(PNG/JPEG/WebP,最大 2 MiB)。工具保存资料并打开浏览器确认页。用户可在那里补封面、修改应用资料并点击提交审核。
13
+ 4. 返回的 operation succeeded 只表示确认页已准备好;`result.status: awaiting_confirmation` 和 `submitted: false` 表示尚未提审。展示确认链接,等待用户在浏览器操作;再调用 `shaper_status(workspace)` 查询 `project.binding.versions` 中同一版本的状态,只有 submitted/in_review/security_review 才报告“已提交审核”,published 才报告“已发布”。取消或关闭页面不会提交,也不需要新建应用或上传另一个版本。
14
+
15
+ 网络超时、`running` 或 `uncertain` 时,由平台核对原请求记录。不要为了绕过未确认结果重复创建应用或提交。`uncertain` 需要根据服务端记录核对,不能把它当作失败后自动重发。
16
+
17
+ 云函数、数据库和存储属于虎扑云;网页仍走本技能的 Shaper 交付流程。交付包包含构建产物,排除凭证、`.env` 和本地绑定。构建配置决定包内文件,不通过上传整个源仓库绕过构建。
@@ -0,0 +1,16 @@
1
+ ---
2
+ name: shaper-idle-game
3
+ description: 设计与实现离线养成、自动产出和离线收益结算;处理时钟、存档兼容和数值增长,不负责通用工程初始化。
4
+ ---
5
+
6
+ # 离线养成
7
+
8
+ 这是可独立安装的专业技能,不要求所有游戏加载。读取项目已有玩法规则、存档结构与验证记录。
9
+
10
+ - 明确资源产出、消耗、上限与成长节奏;先写可解释的小规模数值模型,不擅自增加付费、签到或排行榜。
11
+ - 将在线累计和离线结算统一为可重复计算的规则。结算以已提交的时间点为基准,成功保存后推进时间点;处理时钟倒退、超长离线和重复恢复,不允许重复领取。
12
+ - 本地时间与存档不可信。纯离线单机可接受可修改存档;涉及奖品或共享经济时由后端权威时间和事务结算,不能靠前端限制防作弊。
13
+ - 存档包含版本,迁移保留原数据直至新版本保存成功;损坏或不可识别版本提供明确恢复方式,不静默清空。
14
+ - 检查零收益、上限、时间回拨、长时间离线、刷新与重复恢复;将实际结果写入 docs/validation.md。未验证的平台存储和后台生命周期明确列出。
15
+
16
+ 完成时给出规则、可运行结算、存档兼容策略及边界验证结果。
@@ -0,0 +1,18 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "default": [
4
+ "core/hupu-business",
5
+ "core/shaper-backend",
6
+ "core/shaper-design",
7
+ "core/shaper-development",
8
+ "core/shaper-game-development",
9
+ "core/shaper-product",
10
+ "core/shaper-release"
11
+ ],
12
+ "optional": [
13
+ "game/shaper-idle-game"
14
+ ],
15
+ "compatibility": [
16
+ "compat/hupu-cloud"
17
+ ]
18
+ }
@@ -0,0 +1,32 @@
1
+ # Node 后台服务
2
+
3
+ 此目录是该应用一个 HTTP 后台服务的源码,可包含多个路由。持续修改这里,再重新构建发布;无需重复开通云资源。当前一个应用管理一份活动 HTTP 发布,新目录不会自动变成第二个独立服务。
4
+
5
+ - `handlers.cjs`:业务代码,使用 `defineHandlers({ handler: async ({request,user,db}) => ... })`。
6
+ - `cloud.json`:SDK 精确版本、Node 运行参数、路由和 public/user 访问规则。
7
+ - `migrations/`:版本化 PostgreSQL 迁移;已应用文件不能修改,变更另加新版本。
8
+ - `vendor/`:随 Toolkit 分发的官方 SDK 包;跟随源码提交,不含凭证。`npm install --ignore-scripts` 可获得编辑器补全;默认示例构建不需要先安装 SDK。
9
+
10
+ 从开发者工程根目录操作(目录不是 functions/api 时替换路径):
11
+
12
+ ```sh
13
+ shaper cloud enable
14
+ shaper cloud status # 确认 ready 后继续
15
+ shaper cloud db migrate --version 202610250001_init --file functions/api/migrations/202610250001_init.sql
16
+ # 确认上一迁移已生效后继续
17
+ shaper cloud db migrate --version 202610250002_events --file functions/api/migrations/202610250002_events.sql
18
+ # 确认迁移已生效后部署
19
+ shaper cloud deploy --directory functions/api
20
+ ```
21
+
22
+ 以后修改 handlers/cloud.json,直接再次 deploy;新增表字段先迁移。build 和 deploy 自动构建 CommonJS、打包第三方纯 JS 依赖,并外置平台 SDK。它们不执行任意 npm build 脚本,也不自动运行数据库迁移。增加第三方依赖后在本目录安装,提交锁文件;动态依赖、原生二进制及额外资源文件不属于这版单 bundle 部署契约。
23
+
24
+ 鉴权在云厂商网关执行。user 路由中的 `user.puid` 可信;public 路由没有 user。业务不读取身份头、Token、PG 环境变量,不创建连接池。Java 控制面绑定应用资源,Hupu 不代理业务 HTTP 或 SQL。
25
+
26
+ `db.query(sql, values)` 使用参数化 SQL。`db.transaction(async tx => {...})` 内必须 await 全部操作;真实 PG 事务固定一个连接,失败回滚,不自动重试、不支持嵌套。数据归属、业务角色、分数校验仍由业务实现;SDK 不会自动加用户过滤或 RLS。
27
+
28
+ 初始示例包含排行榜和个人进度,仅用于演示:公开榜单返回测试 PUID,正式业务应改成展示资料;自报分数不具备防作弊能力。重复 submissionId 返回 409 且整笔回滚;未提供时使用请求 ID,因此网络重试不保证去重。
29
+
30
+ cloud.json 是路由声明的源文件,修改后通过 cloud deploy 随服务发布。需要检查或复用制品时,可单独执行 cloud build functions/api。
31
+
32
+ 异步返回 queued/running 仅表示受理或执行中。开通以 cloud status 的 ready 为准;发布以当前 release.digest 和接口验证为准。迁移暂未提供独立完成查询,未收到 succeeded 时需由平台确认已生效后再执行依赖变更。失败恢复本轮不提供。
@@ -0,0 +1,30 @@
1
+ {
2
+ "version": 1,
3
+ "runtime": "nodejs20",
4
+ "memoryMB": 256,
5
+ "timeoutSeconds": 15,
6
+ "routes": [
7
+ {
8
+ "method": "GET",
9
+ "path": "/api/leaderboard",
10
+ "access": "public",
11
+ "handler": "leaderboard"
12
+ },
13
+ {
14
+ "method": "GET",
15
+ "path": "/api/me",
16
+ "access": "user",
17
+ "handler": "me"
18
+ },
19
+ {
20
+ "method": "POST",
21
+ "path": "/api/progress",
22
+ "access": "user",
23
+ "handler": "progress"
24
+ }
25
+ ],
26
+ "serverSdk": {
27
+ "name": "@hupu/cloud-server",
28
+ "version": "0.1.0"
29
+ }
30
+ }
@@ -0,0 +1,46 @@
1
+ "use strict";
2
+
3
+ const { defineHandlers } = require("@hupu/cloud-server");
4
+
5
+ exports.handlers = defineHandlers({
6
+ // public 路由没有 user。示例仅使用测试账号,正式榜单应返回展示名而非 PUID。
7
+ leaderboard: async ({ db }) => ({
8
+ rows: (await db.query("SELECT puid,score FROM progress ORDER BY score DESC,puid LIMIT 10")).rows,
9
+ }),
10
+
11
+ me: async ({ user, db }) => ({
12
+ puid: user.puid,
13
+ rows: (await db.query("SELECT score FROM progress WHERE puid=$1", [user.puid])).rows,
14
+ }),
15
+
16
+ progress: async ({ request, requestId, user, db }) => {
17
+ let input;
18
+ try { input = await request.json(); } catch {
19
+ return Response.json({ code: "INVALID_JSON" }, { status: 400 });
20
+ }
21
+ if (!input || !Number.isSafeInteger(input.score) || input.score < 0 || input.score > 1000000) {
22
+ return Response.json({ code: "INVALID_SCORE" }, { status: 400 });
23
+ }
24
+ const submissionId = input.submissionId ?? requestId;
25
+ if (typeof submissionId !== "string" || !/^[a-zA-Z0-9_-]{1,64}$/.test(submissionId)) {
26
+ return Response.json({ code: "INVALID_SUBMISSION_ID" }, { status: 400 });
27
+ }
28
+ try {
29
+ // 两次写入在同一 PG 事务;业务归属始终来自网关身份,不读取 body.puid。
30
+ return await db.transaction(async tx => {
31
+ const result = await tx.query(
32
+ "INSERT INTO progress(puid,score) VALUES($1,$2) ON CONFLICT(puid) DO UPDATE SET score=excluded.score RETURNING puid,score",
33
+ [user.puid, input.score],
34
+ );
35
+ await tx.query(
36
+ "INSERT INTO progress_events(puid,submission_id,score) VALUES($1,$2,$3)",
37
+ [user.puid, submissionId, input.score],
38
+ );
39
+ return { progress: result.rows[0] };
40
+ });
41
+ } catch (error) {
42
+ if (error.code === "23505") return Response.json({ code: "DUPLICATE_SUBMISSION" }, { status: 409 });
43
+ throw error; // SDK 统一脱敏,不能将数据库异常正文返回客户端。
44
+ }
45
+ },
46
+ });
@@ -0,0 +1,5 @@
1
+ CREATE TABLE progress (
2
+ puid text PRIMARY KEY,
3
+ score integer NOT NULL CHECK (score >= 0 AND score <= 1000000),
4
+ created_at timestamptz NOT NULL DEFAULT now()
5
+ );
@@ -0,0 +1,8 @@
1
+ -- 单独的增量迁移,不能修改已经发布的 init.sql 校验和。
2
+ CREATE TABLE progress_events (
3
+ puid text NOT NULL,
4
+ submission_id text NOT NULL,
5
+ score integer NOT NULL CHECK (score >= 0 AND score <= 1000000),
6
+ created_at timestamptz NOT NULL DEFAULT now(),
7
+ PRIMARY KEY (puid, submission_id)
8
+ );
@@ -0,0 +1,3 @@
1
+ # 设计
2
+
3
+ 记录交互、视觉、技术结构及重要取舍。云能力按需增加,不默认开通。
@@ -0,0 +1,3 @@
1
+ # 产品
2
+
3
+ 记录用户目标、主流程、规则与本期完成条件。当前仅初始化工程,具体需求待明确。
@@ -0,0 +1,3 @@
1
+ # 验证
2
+
3
+ 尚未执行业务验证。实现后记录实际命令、页面行为、运行环境与未验证项;构建成功不代表业务已验证。
@@ -0,0 +1,24 @@
1
+ <!doctype html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <meta name="theme-color" content="#173b35" />
7
+ <title>我的 Shaper 应用</title>
8
+ </head>
9
+ <body>
10
+ <main>
11
+ <header><span class="brand">SHAPER</span><span class="tag">你的下一个想法,从这里开始</span></header>
12
+ <section>
13
+ <p class="eyebrow">HELLO, CREATOR</p>
14
+ <h1>把想法<br />变成可以玩的作品。</h1>
15
+ <p class="intro">这是你的应用起点。修改本地代码,立即预览,再通过 Shaper 交付给用户。</p>
16
+ <button id="play" type="button">点亮灵感 <span aria-hidden="true">↗</span></button>
17
+ <p id="status" role="status" aria-live="polite">已经准备好了。</p>
18
+ </section>
19
+ <aside aria-hidden="true"><div class="orb"><span>MAKE<br />SOMETHING<br /><em>YOURS.</em></span></div></aside>
20
+ <footer>本地开发 · Shaper 发布 · 按需接入虎扑服务</footer>
21
+ </main>
22
+ <script type="module" src="/src/main.js"></script>
23
+ </body>
24
+ </html>