@hupu-tech/shaper 0.2.10 → 0.2.12

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.
@@ -9,14 +9,14 @@ cloud/functions/api/
9
9
  handlers.cjs # 可继续拆分为业务 modules,再从此入口导出 handlers
10
10
  cloud.json # 精确 SDK 版本与运行参数
11
11
  package.json # 精确依赖和 hupuCloud 构建设置
12
- vendor/ # Toolkit 分发的 SDK 包,应随源码提交
12
+ package-lock.json # 锁定 SDK 与业务依赖
13
13
  README.md # 当前模板的操作步骤
14
14
  ```
15
15
 
16
16
  网关在 `cloud/gateway/routes.json`,迁移在 `cloud/database/migrations/`;路由只维护一份。旧 `functions/api` 的合并 manifest 与 migrations 继续支持,不自动搬迁。
17
17
 
18
18
  ```js
19
- const { defineHandlers } = require('@hupu/cloud-server');
19
+ const { defineHandlers } = require('@hupu-tech/shaper-cloud');
20
20
  exports.handlers = defineHandlers({
21
21
  me: async ({ user, db }) => ({
22
22
  rows: (await db.query('SELECT score FROM progress WHERE puid=$1', [user.puid])).rows,
@@ -30,6 +30,6 @@ exports.handlers = defineHandlers({
30
30
 
31
31
  按工具包 `templates/cloud-service` 准备源码和 SDK 依赖,并按上述目录分离运行配置、网关和迁移,不覆盖已有工程。包中 `initCloudService(workspace)` 是本地模板辅助函数,不是云资源创建动作。
32
32
 
33
- 之后修改 cloud/functions/api 中的源码和声明,再执行 deploy。构建目录位于 `.shaper/cloud-build/<digest>`,不是源码目录。Toolkit 内置 SDK 包可支持未发布 registry 的开发流程;安装业务第三方依赖时使用函数目录的 package.json,提交锁文件。
33
+ 之后修改 cloud/functions/api 中的源码和声明,再执行 deploy。构建目录位于 `.shaper/cloud-build/<digest>`,不是源码目录。SDK 使用精确 npm 版本;在函数目录执行 npm ci,增加业务依赖时 npm install 并提交锁文件。
34
34
 
35
35
  默认模板的进度和排行榜是教学业务;正式应用需替换展示资料和计分逻辑。SDK 统一的是 Node HTTP、用户上下文和 PostgreSQL 协议访问;当前只有 CloudBase 适配器完成,支持情况由工具内部检查,开发者无需选择厂商或规格。
@@ -11,11 +11,13 @@ description: 检查新旧 Shaper 项目的归属,初始化或关联应用,
11
11
 
12
12
  ## 按当前任务执行
13
13
 
14
- - **新建、接入源码、识别旧下载包或补配置**:先读[项目接入](references/project-setup.md),完成归属检查后再调用 init。保留已有源码、构建方式和应用 ID。
14
+ - **新建、接入源码、识别旧下载包或补配置**:先读[项目接入](references/project-setup.md),完成归属检查后再调用 init;init 只关联应用,不生成工程。保留已有源码、构建方式和应用 ID。
15
15
  - **授权不足、账号冲突或等待确认**:读[账号与授权](references/authentication.md)。新项目创建确认由 init 发起,不单独对预分配 ID 登录。
16
16
  - **已有工程继续开发**:直接编辑和验证,按下方流程执行。
17
17
 
18
- ## 继续开发
18
+ ## 开始创作与继续开发
19
+
20
+ 接入完成且需求尚未明确时,引导用户描述想法,暂不选模板。需求已明确且尚无工程时,由 AI 根据交互特点选择 h5、react 或 phaser,调用 `shaper_create(workspace, template)`(CLI:`shaper create --template react`),再实现需求;不要让用户选择技术栈。已有源码沿用原工程,不调用 create 覆盖。`project.engineering.status: not_created` 是正常待创作状态;configuration_required 才需要检查已有工程并补配置。
19
21
 
20
22
  用 Agent 自带的文件工具编写项目。`shaper_dev_start` 返回就绪 URL 后,在浏览器检查用户实际会用的交互、控制台错误和窄屏布局。开发日志用 `shaper_dev_logs`。停止服务用 `shaper_dev_stop`;状态查询不会重启服务。
21
23
 
@@ -28,12 +28,18 @@
28
28
  - `AUTH_IN_PROGRESS`:先完成返回的 flowId 对应授权,再重试,不发起并行登录。
29
29
 
30
30
 
31
- - 新目录:调用 `shaper_init(workspace, name, template, appId?)`。根据需求选择 h5、react 或 phaser;指定已有应用时必须传 `appId`。
32
- - 普通外部源码(非旧版下载包):使用已确定的应用 ID 初始化;新作品使用网页预分配 ID。保留原目录、包管理器和构建方式,不强制搬入 src 或换成 Vite。核对并补齐缺失配置,不覆盖已有文档或用户配置。返回 `configuration_required` 表示已关联但工程配置待补齐,按下面规则继续,不当作完成。
33
- - 中断或失败:检查已有绑定和原请求状态后继续;保留已创建应用的 ID,不删除状态、换名字或改目录来重新创建。不确定原创建结果时先核实。
34
- - 完成条件:`shaper_status` 确认绑定目标及权限,`shaper_check` 检查配置,再构建验证。需要运行验证时启动本地预览;分别说明已验证和未验证项。失败则报告“已关联,但构建/预览待修复”,不宣称完整接入成功。
35
- - 返回应用名称、关联结果和可验证的应用入口。后续上传使用同一应用,不能再引导用户从网页新建另一个应用。
36
-
31
+ - 新目录:调用 `shaper_init(workspace, name?, appId?)`,只完成应用接入。返回 connected 表示绑定已保存,不表示源码已生成或可以试玩。
32
+ - 普通外部源码(非旧版下载包):使用已确定的应用 ID 接入,保留原目录、包管理器和构建方式。工程配置在开始开发时检查,不因缺少配置重复 init 或新建应用。
33
+ - 中断或失败:保留原 App ID,查询原授权和应用后继续。不要删除状态、换名字或改目录重新创建。
34
+ - 接入完成条件:应用存在、权限正确、绑定已保存。没有源码无需构建,接入后按用户需求继续;没有需求则引导描述想法。
35
+ - 后续工程创建、上传和提审使用同一个 App ID,不再从网页新建应用。
36
+
37
+ ## 按需求创建工程
38
+
39
+ - 需求明确且尚无业务工程时,使用 `shaper_create(workspace, template)`。轻量页面可选 h5,复杂页面交互可选 react,实时游戏可选 phaser;依据实际需求,不按“游戏”一词强制选引擎。CLI 为 `shaper create --template react`,默认当前目录。
40
+ - create 只写本地模板并安装依赖,不登录、不创建应用、不改绑定。已有工程直接沿用;文件冲突时由 AI 检查,不能删除源码或用户文档强行重建。
41
+ - 同目录同模板重试会恢复原创建;完成后再次执行不覆盖代码。安装失败先排查后重试同一命令;不要换模板或删除记录。显式跳过安装时返回 dependencies_required,仍需安装依赖后验证。
42
+ - 生成后实现需求,执行 shaper_check、shaper_build 和受管预览,检查实际交互后给出试玩入口。not_created 表示还没建立工程,不是接入失败。
37
43
 
38
44
  ## 工程配置
39
45
 
@@ -5,7 +5,7 @@ description: 细化并实现游戏玩法、最小可玩原型、场景与资源
5
5
 
6
6
  # 游戏制作
7
7
 
8
- 读 docs/product.md 的目标与规则、docs/design.md 的体验及现有游戏代码。已有引擎沿用;需要创建或接入工程时先按 shaper-development 完成归属与授权检查;新 2D 游戏可用 shaper_init 的 phaser 模板,页面式玩法可用 React,不默认混用引擎。
8
+ 读 docs/product.md 的目标与规则、docs/design.md 的体验及现有游戏代码。已有引擎沿用;需要创建或接入工程时先按 shaper-development 完成归属与授权检查;已有明确玩法且尚无工程的新 2D 游戏可用 shaper_create 的 phaser 模板,页面式玩法可用 React,不默认混用引擎。
9
9
 
10
10
  1. 明确核心循环、输入、反馈、胜负和重玩条件,先做一条可玩的完整循环;不先建设通用游戏框架。
11
11
  2. 场景负责生命周期和编排;计分、胜负、成长规则与引擎对象分离。资源 key/路径集中管理,加载失败能解释和恢复。
@@ -5,7 +5,7 @@
5
5
  - `handlers.cjs`:业务代码,使用 `defineHandlers({ handler: async ({request,user,db}) => ... })`。
6
6
  - `cloud.json`:SDK 精确版本、Node 运行参数、路由和 public/user 访问规则。
7
7
  - `migrations/`:版本化 PostgreSQL 迁移;已应用文件不能修改,变更另加新版本。
8
- - `vendor/`:随 Toolkit 分发的官方 SDK 包;跟随源码提交,不含凭证。`npm install --ignore-scripts` 可获得编辑器补全;默认示例构建不需要先安装 SDK。
8
+ - `package-lock.json`:锁定 SDK 与业务依赖;在函数目录执行 `npm ci`。SDK 从公共 npm 安装,版本必须与 cloud.json 一致。
9
9
 
10
10
  从开发者工程根目录操作(目录不是 functions/api 时替换路径):
11
11
 
@@ -24,7 +24,7 @@
24
24
  }
25
25
  ],
26
26
  "serverSdk": {
27
- "name": "@hupu/cloud-server",
27
+ "name": "@hupu-tech/shaper-cloud",
28
28
  "version": "0.1.0"
29
29
  }
30
30
  }
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
 
3
- const { defineHandlers } = require("@hupu/cloud-server");
3
+ const { defineHandlers } = require("@hupu-tech/shaper-cloud");
4
4
 
5
5
  exports.handlers = defineHandlers({
6
6
  // public 路由没有 user。示例仅使用测试账号,正式榜单应返回展示名而非 PUID。
@@ -0,0 +1,183 @@
1
+ {
2
+ "name": "hupu-cloud-progress-acceptance",
3
+ "lockfileVersion": 3,
4
+ "requires": true,
5
+ "packages": {
6
+ "": {
7
+ "name": "hupu-cloud-progress-acceptance",
8
+ "dependencies": {
9
+ "@hupu-tech/shaper-cloud": "0.1.0"
10
+ },
11
+ "version": "0.1.0"
12
+ },
13
+ "node_modules/@hupu-tech/shaper-cloud": {
14
+ "version": "0.1.0",
15
+ "resolved": "https://registry.npmjs.org/@hupu-tech/shaper-cloud/-/shaper-cloud-0.1.0.tgz",
16
+ "integrity": "sha512-YUs7gtQPTBy3jLacuSGko/w0Kv/uR5QIsmGs0pRbBeueYKr1u/qkAT34mwdeINMc3I87F41uiA4x5R9tkWbFSA==",
17
+ "license": "UNLICENSED",
18
+ "dependencies": {
19
+ "pg": "8.16.3",
20
+ "zod": "4.6.7"
21
+ },
22
+ "engines": {
23
+ "node": ">=20"
24
+ }
25
+ },
26
+ "node_modules/pg": {
27
+ "version": "8.16.3",
28
+ "resolved": "https://registry.npmjs.org/pg/-/pg-8.16.3.tgz",
29
+ "integrity": "sha512-enxc1h0jA/aq5oSDMvqyW3q89ra6XIIDZgCX9vkMrnz5DFTw/Ny3Li2lFQ+pt3L6MCgm/5o2o8HW9hiJji+xvw==",
30
+ "license": "MIT",
31
+ "dependencies": {
32
+ "pg-connection-string": "^2.9.1",
33
+ "pg-pool": "^3.10.1",
34
+ "pg-protocol": "^1.10.3",
35
+ "pg-types": "2.2.0",
36
+ "pgpass": "1.0.5"
37
+ },
38
+ "engines": {
39
+ "node": ">= 16.0.0"
40
+ },
41
+ "optionalDependencies": {
42
+ "pg-cloudflare": "^1.2.7"
43
+ },
44
+ "peerDependencies": {
45
+ "pg-native": ">=3.0.1"
46
+ },
47
+ "peerDependenciesMeta": {
48
+ "pg-native": {
49
+ "optional": true
50
+ }
51
+ }
52
+ },
53
+ "node_modules/pg-cloudflare": {
54
+ "version": "1.4.1",
55
+ "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.4.1.tgz",
56
+ "integrity": "sha512-6PQbsFWZcp9EmJEwy5cGQ2La+AMWpP46lgbb8X+U/XsHIUweYDNCpeuKck5RxL2MdVFi7krbbEi5nX4Zh7JhrQ==",
57
+ "license": "MIT",
58
+ "optional": true
59
+ },
60
+ "node_modules/pg-connection-string": {
61
+ "version": "2.14.1",
62
+ "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.14.1.tgz",
63
+ "integrity": "sha512-qR3kGNPBLpCNtz0evbKA0Y/MRFXwSSdT+pTJvYp/bXTcReZbvX1kzF0IyTc1QnxqF7AZbOeBhNL8R5mYQZV/MA==",
64
+ "license": "MIT"
65
+ },
66
+ "node_modules/pg-int8": {
67
+ "version": "1.0.1",
68
+ "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz",
69
+ "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==",
70
+ "license": "ISC",
71
+ "engines": {
72
+ "node": ">=4.0.0"
73
+ }
74
+ },
75
+ "node_modules/pg-pool": {
76
+ "version": "3.14.0",
77
+ "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.14.0.tgz",
78
+ "integrity": "sha512-gKtPkFdQPU3DksooVLi9LsjZxrsBUZIpa+7aVx+LV5pNh0KzP4Zleud2po+ConrxbuXGBJ6Hfer6hdgpIBpBaw==",
79
+ "license": "MIT",
80
+ "peerDependencies": {
81
+ "pg": ">=8.0"
82
+ }
83
+ },
84
+ "node_modules/pg-protocol": {
85
+ "version": "1.16.1",
86
+ "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.16.1.tgz",
87
+ "integrity": "sha512-p9VOFMiHB/ZbJATetbg+99PxssTVSQRnyuPSQ67mN1+1KBOjZaZ83ZQzltnxPhJwSsC3nwVjJ10DVJlerbFzLg==",
88
+ "license": "MIT"
89
+ },
90
+ "node_modules/pg-types": {
91
+ "version": "2.2.0",
92
+ "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz",
93
+ "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==",
94
+ "license": "MIT",
95
+ "dependencies": {
96
+ "pg-int8": "1.0.1",
97
+ "postgres-array": "~2.0.0",
98
+ "postgres-bytea": "~1.0.0",
99
+ "postgres-date": "~1.0.4",
100
+ "postgres-interval": "^1.1.0"
101
+ },
102
+ "engines": {
103
+ "node": ">=4"
104
+ }
105
+ },
106
+ "node_modules/pgpass": {
107
+ "version": "1.0.5",
108
+ "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz",
109
+ "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==",
110
+ "license": "MIT",
111
+ "dependencies": {
112
+ "split2": "^4.1.0"
113
+ }
114
+ },
115
+ "node_modules/postgres-array": {
116
+ "version": "2.0.0",
117
+ "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz",
118
+ "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==",
119
+ "license": "MIT",
120
+ "engines": {
121
+ "node": ">=4"
122
+ }
123
+ },
124
+ "node_modules/postgres-bytea": {
125
+ "version": "1.0.1",
126
+ "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz",
127
+ "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==",
128
+ "license": "MIT",
129
+ "engines": {
130
+ "node": ">=0.10.0"
131
+ }
132
+ },
133
+ "node_modules/postgres-date": {
134
+ "version": "1.0.7",
135
+ "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz",
136
+ "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==",
137
+ "license": "MIT",
138
+ "engines": {
139
+ "node": ">=0.10.0"
140
+ }
141
+ },
142
+ "node_modules/postgres-interval": {
143
+ "version": "1.2.0",
144
+ "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz",
145
+ "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==",
146
+ "license": "MIT",
147
+ "dependencies": {
148
+ "xtend": "^4.0.0"
149
+ },
150
+ "engines": {
151
+ "node": ">=0.10.0"
152
+ }
153
+ },
154
+ "node_modules/split2": {
155
+ "version": "4.2.0",
156
+ "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
157
+ "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
158
+ "license": "ISC",
159
+ "engines": {
160
+ "node": ">= 10.x"
161
+ }
162
+ },
163
+ "node_modules/xtend": {
164
+ "version": "4.0.2",
165
+ "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
166
+ "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
167
+ "license": "MIT",
168
+ "engines": {
169
+ "node": ">=0.4"
170
+ }
171
+ },
172
+ "node_modules/zod": {
173
+ "version": "4.6.7",
174
+ "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
175
+ "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
176
+ "license": "MIT",
177
+ "funding": {
178
+ "url": "https://github.com/sponsors/colinhacks"
179
+ }
180
+ }
181
+ },
182
+ "version": "0.1.0"
183
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "@hupu-tech/shaper-cloud",
3
+ "version": "0.1.0",
4
+ "templateHashes": {
5
+ "handlers.cjs": "0df550d329a5e0745a7c2325c899d873eee80ecc2b18bff9a9e1601ce678c756",
6
+ "cloud.json": "ca01772eb4803e87e489d62a01f8950056b8f1022a85b5f472bd71471cd12620",
7
+ "package-lock.json": "5eff90863995f5e9949f98101fe2c221ede1b56c0a46c69eb919fcc197e54028",
8
+ "migrations/202610250001_init.sql": "38f9a69e1f0f4967e20d1f07c02e2d0b719ddb284ddee7b3136a0dc016766797",
9
+ "migrations/202610250002_events.sql": "bb9a198a7babe4040cf09c7c29def25f4d7bcbeaf1dcad4a396b3778251dd19b"
10
+ }
11
+ }