@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.
- package/CHANGELOG.md +12 -0
- package/README.md +5 -8
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +1 -1
- package/dist/cloud/service-build.d.ts +3 -3
- package/dist/dev-runner.js +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -1
- package/dist/project/create.d.ts +16 -0
- package/dist/project/workspace.d.ts +21 -23
- package/dist/shared-5R34PBDM.js +13 -0
- package/dist/shared-APGA5MU5.js +19 -0
- package/package.json +1 -3
- package/skills/core/shaper-backend/references/node-server.md +3 -3
- package/skills/core/shaper-development/SKILL.md +4 -2
- package/skills/core/shaper-development/references/project-setup.md +12 -6
- package/skills/core/shaper-game-development/SKILL.md +1 -1
- package/templates/cloud-service/README.md +1 -1
- package/templates/cloud-service/cloud.json +1 -1
- package/templates/cloud-service/handlers.cjs +1 -1
- package/templates/cloud-service/package-lock.json +183 -0
- package/templates/cloud-service/release.json +11 -0
- package/templates/h5/package-lock.json +40 -40
- package/templates/phaser/package-lock.json +70 -70
- package/templates/react/package-lock.json +74 -74
- package/dist/shared-IULNVFIC.js +0 -14
- package/dist/shared-NK6IGQD2.js +0 -19
- package/vendor/cloud-server/hupu-cloud-server-0.1.0.tgz +0 -0
- package/vendor/cloud-server/release.json +0 -12
|
@@ -9,14 +9,14 @@ cloud/functions/api/
|
|
|
9
9
|
handlers.cjs # 可继续拆分为业务 modules,再从此入口导出 handlers
|
|
10
10
|
cloud.json # 精确 SDK 版本与运行参数
|
|
11
11
|
package.json # 精确依赖和 hupuCloud 构建设置
|
|
12
|
-
|
|
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
|
|
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>`,不是源码目录。
|
|
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
|
|
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
|
|
32
|
-
- 普通外部源码(非旧版下载包):使用已确定的应用 ID
|
|
33
|
-
-
|
|
34
|
-
-
|
|
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
|
|
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
|
-
- `
|
|
8
|
+
- `package-lock.json`:锁定 SDK 与业务依赖;在函数目录执行 `npm ci`。SDK 从公共 npm 安装,版本必须与 cloud.json 一致。
|
|
9
9
|
|
|
10
10
|
从开发者工程根目录操作(目录不是 functions/api 时替换路径):
|
|
11
11
|
|
|
@@ -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
|
+
}
|