@hupu-tech/shaper 0.2.13 → 0.2.15
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 +8 -4
- package/dist/auth/auth.d.ts +1 -0
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +11 -2
- package/dist/cloud/service-build.d.ts +1 -0
- package/dist/dev-runner.js +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -1
- package/dist/platform/api.d.ts +2 -0
- package/dist/project/create.d.ts +4 -10
- package/dist/project/templates.d.ts +20 -0
- package/dist/shared-HGIM4QT3.js +22 -0
- package/dist/{shared-5R34PBDM.js → shared-YWISH7Y2.js} +4 -4
- package/package.json +1 -1
- package/skills/core/hupu-business/references/runtime.md +3 -4
- package/skills/core/shaper-backend/references/deployment.md +3 -3
- package/skills/core/shaper-backend/references/node-server.md +4 -4
- package/skills/core/shaper-development/SKILL.md +3 -2
- package/skills/core/shaper-development/references/materials.md +14 -0
- package/skills/core/shaper-development/references/project-setup.md +6 -5
- 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/templates/leaderboard/README.md +1 -1
- package/templates/leaderboard/cloud/functions/api/cloud.json +2 -1
- package/templates/leaderboard/cloud/functions/api/leaderboard.cjs +1 -1
- package/templates/leaderboard/cloud/gateway/routes.json +5 -3
- package/templates/leaderboard/docs/integration.md +1 -1
- package/templates/leaderboard/src/main.js +1 -1
- package/templates/offline-game/README.md +1 -1
- package/templates/offline-game/docs/integration.md +1 -1
- package/templates/offline-game/index.html +12 -1
- package/templates/offline-game/src/game.js +38 -7
- package/templates/offline-game/src/main.js +60 -12
- package/templates/offline-game/src/style.css +69 -1
- package/templates/offline-game/test/game.test.js +24 -6
- package/templates/server/README.md +26 -0
- package/templates/server/backend/README.md +5 -0
- package/templates/{cloud-service → server/backend}/cloud.json +4 -8
- package/templates/{cloud-service → server/backend}/package-lock.json +2 -2
- package/templates/server/backend/package.json +18 -0
- package/templates/server/backend/release.json +9 -0
- package/templates/server/backend/server.cjs +30 -0
- package/templates/server/frontend/service.js +14 -0
- package/dist/shared-2WDEQ3AQ.js +0 -19
- package/templates/cloud-service/README.md +0 -7
- package/templates/cloud-service/migrations/202610250001_init.sql +0 -5
- package/templates/cloud-service/migrations/202610250002_events.sql +0 -8
- package/templates/cloud-service/release.json +0 -11
- package/templates/cloud-service/server.cjs +0 -37
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
import{a as z,b as a,c as j,d as J,e as I,f as S}from"./shared-BKIED5AA.js";import{realpath as
|
|
2
|
-
`),await e.auth.wait(m.flowId)}v=await e.project(w)}return await X(n),c||await Y(n,w,e.auth.server),{root:n,name:v.name,appId:w,status:"connected",alreadyInitialized:!!c}}finally{await o()}}async function Q(e){let t=new Set([".git",".shaper",".shaper.lock",".DS_Store",".gitignore","AGENTS.md","CLAUDE.md","README.md","docs","node_modules","dist"]);async function r(n,i=!1){for(let o of await
|
|
1
|
+
import{a as z,b as a,c as j,d as J,e as I,f as S}from"./shared-BKIED5AA.js";import{realpath as T,mkdir as M,readdir as G,readFile as _,writeFile as at,lstat as P,appendFile as st}from"node:fs/promises";import{resolve as x,join as h,relative as b,sep as k,isAbsolute as W}from"node:path";import{randomUUID as ct}from"node:crypto";import{spawn as pt}from"node:child_process";import dt from"adm-zip";import{z as f}from"zod";import K from"proper-lockfile";var ut=f.object({schemaVersion:f.literal(1),devCommand:f.string().min(1).max(500),buildCommand:f.string().min(1).max(500),outputDir:f.string().min(1),workingDirectory:f.string().min(1).default("."),devUrl:f.string().default("http://127.0.0.1:{port}")}).passthrough(),lt=f.object({schemaVersion:f.literal(1),appId:f.string().min(1).max(200),server:f.string().url()}).strict();async function E(e){if(!e||!W(e))throw new a("WORKSPACE_REQUIRED","\u8BF7\u6307\u5B9A\u5DE5\u7A0B\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002");return T(x(e))}async function D(e,t){return _(h(e,t),"utf8").catch(r=>{if(r.code!=="ENOENT")throw r})}async function B(e){let t=new Set;for(let r of[".shaper/project.json","shaper.config.json","shaper.project.json",".shaper/config.json","activity.json"]){let n=await D(e,r);if(n===void 0)continue;let i=JSON.parse(n);for(let o of[i?.appId,i?.applicationId,r==="activity.json"?i?.activityId:void 0])typeof o=="string"&&o&&t.add(o)}return t}function H(e,t){if(e.size>1||t&&[...e].some(r=>r!==t))throw new a("APP_ID_CONFLICT","\u539F\u9879\u76EE\u5E94\u7528 ID \u4E0E\u76EE\u6807\u4E0D\u4E00\u81F4\uFF1B\u5DF2\u505C\u6B62\uFF0C\u4E0D\u4F1A\u521B\u5EFA\u6216\u5207\u6362\u5E94\u7528\u3002")}async function N(e,t){let r=await D(e,"activity.json"),n=r===void 0?void 0:JSON.parse(r)?.activityId,i=await D(e,"AGENTS.md"),o=await D(e,"skills/act-cloudbase/SKILL.md");if(!(n===void 0&&!i?.includes("<!-- COLORBOX:START -->")&&o===void 0))throw H(await B(e),t),new a("LEGACY_PROJECT_UPGRADE_REQUIRED","\u8FD9\u662F\u65E7\u7248\u9879\u76EE\uFF0C\u8BF7\u7EE7\u7EED\u4F7F\u7528\u539F\u6709\u6280\u80FD\u548C\u5F00\u53D1\u65B9\u5F0F\u3002\u65B0\u7248\u5DE5\u5177\u672A\u4FEE\u6539\u6B64\u9879\u76EE\uFF0C\u5F53\u524D\u6682\u4E0D\u652F\u6301\u81EA\u52A8\u5347\u7EA7\u3002")}async function O(e){let t=h(e,".shaper");if(await M(t,{recursive:!0,mode:448}),(await P(t)).isSymbolicLink())throw new a("UNSAFE_WORKSPACE",".shaper \u4E0D\u80FD\u662F\u7B26\u53F7\u94FE\u63A5\u3002");return t}async function R(e){return await N(e),ut.parse(await S(h(e,"shaper.config.json")))}async function C(e,t){await N(e);let r=lt.parse(await S(h(e,".shaper","project.json")));if(r.server!==t)throw new a("SERVER_MISMATCH","\u6B64\u5DE5\u7A0B\u7ED1\u5B9A\u7684 Shaper \u670D\u52A1\u4E0E\u5F53\u524D\u767B\u5F55\u670D\u52A1\u4E0D\u540C\u3002\u8BF7\u663E\u5F0F\u5207\u6362\u670D\u52A1\u6216\u91CD\u65B0\u5173\u8054\u3002");return r}async function Y(e,t,r){let n=await O(e);await I(h(n,"project.json"),{schemaVersion:1,appId:t,server:r})}async function Ut(e,t,r={}){if(r.template)throw new a("USE_CREATE","init \u53EA\u5173\u8054\u5E94\u7528\u3002\u9700\u6C42\u660E\u786E\u540E\u4F7F\u7528 shaper create --type \u521B\u5EFA\u5DE5\u7A0B\u3002");if(!t||!W(t))throw new a("WORKSPACE_REQUIRED","\u8BF7\u6307\u5B9A\u5DE5\u7A0B\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002");await M(t,{recursive:!0});let n=await E(t);await N(n,r.appId);let i=await O(n),o=await K.lock(i,{retries:0});try{let c;try{c=await C(n,e.auth.server)}catch(l){if(l.code!=="ENOENT")throw l}if(c&&r.appId&&r.appId!==c.appId)throw new a("ALREADY_LINKED",`\u5F53\u524D\u76EE\u5F55\u5C5E\u4E8E ${c.appId}\uFF0C\u4E0E\u63D0\u793A\u8BCD\u4E2D\u7684 ${r.appId} \u4E0D\u4E00\u81F4\u3002\u8BF7\u56DE\u5230\u539F\u5E94\u7528\u7EE7\u7EED\uFF0C\u6216\u6362\u4E00\u4E2A\u7A7A\u76EE\u5F55\uFF1Binit \u4E0D\u4F1A\u8986\u76D6\u7ED1\u5B9A\u3002`);let u=await B(n),p=c?.appId??r.appId??[...u][0];H(u,p);let d=h(i,"init.json"),s=c?void 0:await S(d).catch(l=>{if(l.code!=="ENOENT")throw l});if(!c&&s&&(!s.appId||s.server!==e.auth.server||p&&p!==s.appId))throw new a("INIT_CONFLICT","\u5B58\u5728\u672A\u5B8C\u6210\u7684\u521D\u59CB\u5316\uFF0C\u8BF7\u6838\u5BF9 .shaper/init.json \u4E2D\u7684\u539F\u5E94\u7528\u548C\u670D\u52A1\uFF0C\u4E0D\u8981\u53E6\u5EFA\u5E94\u7528\u3002");if(!p&&!s&&await Q(n))throw new a("APP_REQUIRED","\u5DF2\u6709\u9879\u76EE\u5C1A\u672A\u8BC6\u522B\u5230\u5E94\u7528 ID\u3002\u8BF7\u5148\u786E\u8BA4\u539F\u5E94\u7528\uFF0C\u518D\u4F7F\u7528 init --app\uFF1B\u65B0\u4F5C\u54C1\u8BF7\u4ECE\u7F51\u9875\u5F00\u59CB\u521B\u4F5C\u5E76\u643A\u5E26\u9884\u5206\u914D ID\u3002");let w=p??s?.appId??`app_${ct().replaceAll("-","").slice(0,10)}`;!s&&!c&&(s={appId:w,server:e.auth.server},await I(d,s));let v;try{v=await e.project(w)}catch(l){if(!(l instanceof a)||!["AUTH_REQUIRED","INVALID_TOKEN","PROJECT_NOT_AUTHORIZED","INSUFFICIENT_SCOPE","NOT_FOUND"].includes(l.code))throw l;let m=await e.auth.start({appId:w,...r.name?{applicationName:r.name}:{},initialize:!c&&u.size===0,reauthorize:!0});if(m.status==="pending"){if(!r.waitForAuthorization)return{root:n,appId:w,...m,status:"awaiting_confirmation",next:"\u5728\u6D4F\u89C8\u5668\u5B8C\u6210\u767B\u5F55\u548C\u521B\u5EFA/\u5173\u8054\u786E\u8BA4\uFF0C\u6388\u6743\u5B8C\u6210\u540E\u4F7F\u7528\u540C\u4E00\u76EE\u5F55\u548C\u53C2\u6570\u91CD\u8BD5 init\u3002"};process.stderr.write(`\u8BF7\u5728\u6D4F\u89C8\u5668\u786E\u8BA4\u521B\u5EFA\u6216\u5173\u8054\u5E94\u7528\uFF1A${m.authorizationUrl}
|
|
2
|
+
`),await e.auth.wait(m.flowId)}v=await e.project(w)}return await X(n),c||await Y(n,w,e.auth.server),{root:n,name:v.name,appId:w,status:"connected",alreadyInitialized:!!c}}finally{await o()}}async function Q(e){let t=new Set([".git",".shaper",".shaper.lock",".DS_Store",".gitignore","AGENTS.md","CLAUDE.md","README.md","docs","templates","node_modules","dist"]);async function r(n,i=!1){for(let o of await G(n,{withFileTypes:!0}))if(!(i&&t.has(o.name))&&(!o.isDirectory()||await r(h(n,o.name))))return!0;return!1}return r(e,!0)}async function Lt(e){await N(e);try{let t=await R(e);return await U(e,t),{status:"configured",config:t}}catch(t){if(t.code!=="ENOENT"&&!(t instanceof f.ZodError))throw t;return{status:await Q(e)?"configuration_required":"not_created"}}}async function U(e,t){let r=await Z(e,t.workingDirectory);if(!(await P(r)).isDirectory())throw new a("INVALID_WORKING_DIRECTORY","workingDirectory \u5FC5\u987B\u662F\u5DE5\u7A0B\u5185\u90E8\u76EE\u5F55\u3002");return r}async function Vt(e,t,r){let n=await E(t);await N(n,r);let i=await K.lock(await O(n),{retries:0});try{let o=await e.project(r);return await Y(n,o.appId,e.auth.server),await X(n),{root:n,appId:o.appId,name:o.name}}finally{await i()}}async function X(e){let t=h(e,".gitignore"),r=await _(t,"utf8").catch(s=>{if(s.code==="ENOENT")return"";throw s}),i=["/.shaper/","/.shaper.lock/","/node_modules/","/dist/","/credentials.json",".env",".env.*","!.env.example"].filter(s=>!r.split(`
|
|
3
3
|
`).includes(s));i.length&&await st(t,`
|
|
4
4
|
# Shaper local state and generated files
|
|
5
5
|
${i.join(`
|
|
6
6
|
`)}
|
|
7
7
|
`);let o=h(e,"AGENTS.md"),c=await _(o,"utf8").catch(s=>{if(s.code==="ENOENT")return"";throw s}),u="<!-- shaper:project -->",p=`
|
|
8
8
|
${u}
|
|
9
|
-
Read docs/product.md for goals and rules, docs/design.md for experience and implementation decisions, and docs/validation.md for actual evidence when these files exist. Use the globally installed shaper-development skill for local development and shaper-release for web delivery. For Hupu login/share use hupu-business; for functions or databases use shaper-backend. Pass this project's absolute path to project tools. init connects the application only. After the user describes their goal, use shaper_create with an
|
|
9
|
+
Read docs/product.md for goals and rules, docs/design.md for experience and implementation decisions, and docs/validation.md for actual evidence when these files exist. Use the globally installed shaper-development skill for local development and shaper-release for web delivery. For Hupu login/share use hupu-business; for functions or databases use shaper-backend. Pass this project's absolute path to project tools. init connects the application only. After the user describes their goal, use shaper_create with type h5/react/phaser to create an empty project. Existing projects keep their stack. For service or feature references, use shaper_template_add; it only extracts into templates/<name>. Read its README and integrate selected code into the actual project before validating. Template extraction is not integration or deployment. Do not choose a template during setup without a creative goal. Read shaper.config.json when present for commands and query shaper_status for live identity. Web publishing belongs to Shaper; cloud functions are deployed separately.
|
|
10
10
|
|
|
11
11
|
\u9762\u5411\u521B\u4F5C\u8005\u8BF4\u660E\u5DF2\u80FD\u4F53\u9A8C\u4EC0\u4E48\uFF0C\u518D\u7ED9\u5F53\u524D\u6700\u76F8\u5173\u7684\u4E0B\u4E00\u6B65\uFF1B\u6280\u672F\u68C0\u67E5\u548C\u547D\u4EE4\u7531 AI \u6267\u884C\uFF0C\u7EC6\u8282\u5728\u7528\u6237\u8BE2\u95EE\u6216\u6392\u67E5\u65F6\u5C55\u5F00\u3002\u9700\u8981\u7528\u6237\u64CD\u4F5C\u65F6\u7ED9\u51FA\u5B9E\u9645\u5165\u53E3\uFF0C\u8BF4\u660E\u786E\u8BA4\u5BF9\u8C61\u548C\u540E\u7EED\u52A8\u4F5C\uFF1B\u6309\u5F00\u53D1\u3001\u540E\u7AEF\u6216\u53D1\u5E03\u6280\u80FD\u7684\u7528\u6237\u5F15\u5BFC\u8854\u63A5\uFF0C\u4E0D\u8981\u6C42\u7528\u6237\u7406\u89E3\u6280\u80FD\u540D\u6216\u5185\u90E8\u72B6\u6001\u3002\u5F15\u5BFC\u4E0D\u6269\u5927\u4EFB\u52A1\u6388\u6743\uFF1B\u521B\u5EFA\u5E94\u7528\u3001\u5F00\u901A\u4E91\u670D\u52A1\u548C\u63D0\u4EA4\u5BA1\u6838\u4ECD\u987B\u5BF9\u5E94\u7684\u7F51\u9875\u786E\u8BA4\u3002
|
|
12
12
|
<!-- /shaper:project -->
|
|
13
|
-
`,d=c.includes(u)?c.replace(/<!-- shaper:project -->[\s\S]*?<!-- \/shaper:project -->\n?/,p.trimStart()):c+p;d!==c&&await at(o,d)}async function wt(e,t){await new Promise((r,n)=>{let i=pt(e,{cwd:t,shell:!0,stdio:["ignore","pipe","pipe"]});i.stdout.on("data",o=>process.stderr.write(o)),i.stderr.on("data",o=>process.stderr.write(o)),i.once("error",n),i.once("exit",o=>o===0?r():n(new a("COMMAND_FAILED",`\u5DE5\u7A0B\u547D\u4EE4\u9000\u51FA\u7801\uFF1A${o??"signal"}`)))})}async function Ft(e){let t=await E(e),r=await R(t);await wt(r.buildCommand,await U(t,r));let n=await Z(t,r.outputDir);return await _(h(n,"index.html")),{root:t,output:n}}async function Z(e,t){let r=await
|
|
13
|
+
`,d=c.includes(u)?c.replace(/<!-- shaper:project -->[\s\S]*?<!-- \/shaper:project -->\n?/,p.trimStart()):c+p;d!==c&&await at(o,d)}async function wt(e,t){await new Promise((r,n)=>{let i=pt(e,{cwd:t,shell:!0,stdio:["ignore","pipe","pipe"]});i.stdout.on("data",o=>process.stderr.write(o)),i.stderr.on("data",o=>process.stderr.write(o)),i.once("error",n),i.once("exit",o=>o===0?r():n(new a("COMMAND_FAILED",`\u5DE5\u7A0B\u547D\u4EE4\u9000\u51FA\u7801\uFF1A${o??"signal"}`)))})}async function Ft(e){let t=await E(e),r=await R(t);await wt(r.buildCommand,await U(t,r));let n=await Z(t,r.outputDir);return await _(h(n,"index.html")),{root:t,output:n}}async function Z(e,t){let r=await T(x(e,t)),n=b(e,r);if(n===".."||n.startsWith(`..${k}`)||x(e,n)!==r)throw new a("INVALID_OUTPUT","\u8F93\u51FA\u76EE\u5F55\u5FC5\u987B\u4F4D\u4E8E\u5DE5\u7A0B\u5185\u90E8\u3002");return r}async function $t(e,t={files:300,bytes:200*1024*1024}){let r=await T(e),n=new dt,i=0,o=0;async function c(u){for(let p of(await G(u,{withFileTypes:!0})).sort((d,s)=>d.name.localeCompare(s.name))){if(/^(\.git|\.shaper|node_modules|\.DS_Store)$/.test(p.name))continue;if(/^(\.env(?:\..*)?|credentials\.json|.*\.(pem|key))$/i.test(p.name))throw new a("SECRET_FILE_IN_PACKAGE",`\u8F93\u51FA\u76EE\u5F55\u5305\u542B\u654F\u611F\u914D\u7F6E\u6587\u4EF6\uFF1A${p.name}`);let d=h(u,p.name);if(p.isSymbolicLink())throw new a("SYMLINK_IN_PACKAGE",`\u4EA4\u4ED8\u5185\u5BB9\u4E2D\u4E0D\u5141\u8BB8\u7B26\u53F7\u94FE\u63A5\uFF1A${p.name}`);if(p.isDirectory()){await c(d);continue}if(!p.isFile())throw new a("INVALID_PACKAGE_FILE","\u4EA4\u4ED8\u76EE\u5F55\u5305\u542B\u975E\u5E38\u89C4\u6587\u4EF6\u3002");let s=await P(d);if(i+=s.size,o++,o>t.files||i>t.bytes)throw new a("PACKAGE_TOO_LARGE","\u4EA4\u4ED8\u5305\u8D85\u8FC7\u6587\u4EF6\u6570\u6216\u5927\u5C0F\u9650\u5236\u3002");n.addFile(b(r,d).split(k).join("/"),await _(d))}}await c(r);for(let u of n.getEntries())u.header.time=new Date(2e3,0,1);return{content:n.toBuffer(),files:o,bytes:i}}async function zt(e){let t=await E(e),r=await R(t),n=[];await U(t,r);let i=x(t,r.outputDir),o=b(t,i);return(o===".."||o.startsWith(`..${k}`))&&n.push("outputDir \u8D85\u51FA\u5DE5\u7A0B\u76EE\u5F55"),{root:t,passed:n.length===0,findings:n,checks:["project configuration","command directory","output path"],notRun:["application behavior","build","cloud connectivity"]}}import{createHash as et}from"node:crypto";import{join as q}from"node:path";import{mkdir as ft,readFile as ht}from"node:fs/promises";import{z as g}from"zod";var L=8*1024*1024,mt=10080*60*1e3,gt=g.object({protocol:g.literal(1),version:g.string().regex(/^[a-f0-9]{64}$/),sha256:g.string().regex(/^[a-f0-9]{64}$/),payload:g.string().max(L)}).strict(),Et=g.object({shell:g.string().min(1),head:g.string(),body:g.string(),sdk:g.string().min(1)}).strict();function tt(e){let t=gt.parse(e),r=et("sha256").update(t.payload).digest("hex");if(r!==t.sha256||r!==t.version)throw new a("PREVIEW_RUNTIME_INTEGRITY","\u9884\u89C8\u8FD0\u884C\u73AF\u5883\u6821\u9A8C\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002");let n=Et.parse(JSON.parse(t.payload));if(!n.shell.includes("__SHAPER_PREVIEW_ENTRY__"))throw new a("PREVIEW_RUNTIME_INVALID","\u9884\u89C8\u8FD0\u884C\u73AF\u5883\u4E0D\u517C\u5BB9\uFF0C\u8BF7\u66F4\u65B0 Shaper\u3002");return{envelope:t,content:n}}async function rt(e){let t=J(e),r=q(j(),"preview-runtime",et("sha256").update(t).digest("hex")),n=q(r,"current.json"),i;try{i=await fetch(`${t}/api/v1/preview-runtime`,{redirect:"error",signal:AbortSignal.timeout(8e3)})}catch{}if(!i||i.status>=500)try{let p=await ht(n);if(p.length>L)throw new Error("Oversized cache");let d=JSON.parse(p.toString()),s=Date.now()-Date.parse(d.fetchedAt);if(!Number.isFinite(s)||s<0||s>mt)throw new Error("Expired cache");return{...tt(d.envelope),source:"cache"}}catch{throw new a("PREVIEW_RUNTIME_UNAVAILABLE","\u65E0\u6CD5\u52A0\u8F7D\u9884\u89C8\u8FD0\u884C\u73AF\u5883\uFF0C\u4E14\u6CA1\u6709\u6709\u6548\u7F13\u5B58\u3002\u8BF7\u68C0\u67E5\u7F51\u7EDC\u540E\u91CD\u8BD5\uFF1B\u4E0D\u4F1A\u542F\u52A8\u65E0\u58F3\u9884\u89C8\u3002")}if(!i.ok)throw await i.body?.cancel(),new a("PREVIEW_RUNTIME_UNAVAILABLE","\u670D\u52A1\u6682\u4E0D\u652F\u6301\u6B64\u9884\u89C8\u8FD0\u884C\u73AF\u5883\uFF0C\u8BF7\u786E\u8BA4 Shaper \u670D\u52A1\u5DF2\u66F4\u65B0\u3002");let o=[],c=0;for await(let p of i.body){if(c+=p.length,c>L)throw new a("PREVIEW_RUNTIME_INVALID","\u9884\u89C8\u8FD0\u884C\u73AF\u5883\u8D85\u8FC7\u5927\u5C0F\u9650\u5236\u3002");o.push(p)}let u;try{u=tt(JSON.parse(Buffer.concat(o).toString()))}catch{throw new a("PREVIEW_RUNTIME_INVALID","\u9884\u89C8\u8FD0\u884C\u73AF\u5883\u6821\u9A8C\u5931\u8D25\u6216\u7248\u672C\u4E0D\u517C\u5BB9\uFF0C\u8BF7\u66F4\u65B0 Shaper \u540E\u91CD\u8BD5\u3002")}return await ft(r,{recursive:!0,mode:448}),await I(n,{fetchedAt:new Date().toISOString(),envelope:u.envelope}),{...u,source:"network"}}import{createHash as yt,randomUUID as It}from"node:crypto";import{open as St,mkdir as At,readFile as vt,rm as nt}from"node:fs/promises";import{join as A}from"node:path";import{spawn as _t}from"node:child_process";import{z as y}from"zod";import Nt from"proper-lockfile";var Rt=y.object({id:y.string(),root:y.string(),controlUrl:y.string().url(),token:y.string(),url:y.string().url(),startedAt:y.string(),runtimeVersion:y.string().optional()}).strict();function F(e){return A(j(),"sessions",yt("sha256").update(e).digest("hex"))}async function $(e){let t=Rt.parse(await S(A(F(e),"session.json")));if(t.root!==e||new URL(t.controlUrl).hostname!=="127.0.0.1")throw new a("INVALID_DEV_SESSION","\u672C\u5730\u5F00\u53D1\u4F1A\u8BDD\u8BB0\u5F55\u4E0D\u6B63\u786E\u3002");return t}async function V(e){let t=await E(e),r;try{r=await $(t)}catch(n){if(n.code==="ENOENT")return{running:!1,root:t};throw n}try{let n=await fetch(`${r.controlUrl}/status`,{headers:{Authorization:`Bearer ${r.token}`},redirect:"error",signal:AbortSignal.timeout(1500)}),i=await n.json();if(!n.ok||i.id!==r.id)throw new Error("Session mismatch");return{root:t,running:i.running,ready:i.ready,url:r.url,sessionId:r.id}}catch{return{root:t,running:!1,url:r.url,sessionId:r.id}}}async function oe(e){let t=await E(e);await R(t);let r=F(t);await At(r,{recursive:!0,mode:448});let n=await Nt.lock(r,{retries:0});try{let i=await V(t);if(i.running){if((await $(t)).runtimeVersion)return i;await it(t)}let o=await S(A(t,".shaper","project.json")),c=await C(t,o.server),u=await rt(c.server),p=It(),d=A(r,`runtime-${p}.json`);await I(d,{envelope:u.envelope,appId:c.appId,source:u.source});let s=await St(A(r,"dev.log"),"w",384),w=_t(process.execPath,[A(z,"dist","dev-runner.js"),t,p],{cwd:t,detached:!0,stdio:["ignore",s.fd,s.fd],windowsHide:!0});try{await new Promise((l,m)=>{w.once("spawn",l),w.once("error",m)})}catch(l){throw await nt(d,{force:!0}),l}finally{await s.close()}w.unref();let v=!1;w.once("exit",()=>{v=!0});for(let l=0;l<120;l++){if(await new Promise(ot=>setTimeout(ot,250)),v)throw await nt(d,{force:!0}),new a("DEV_START_FAILED","\u9884\u89C8\u542F\u52A8\u5931\u8D25\uFF0C\u8BF7\u67E5\u770B shaper logs\u3002");let m=await V(t);if(m.running&&m.ready)return m}throw await it(t),new a("DEV_NOT_READY","\u5F00\u53D1\u670D\u52A1\u672A\u5728 30 \u79D2\u5185\u5C31\u7EEA\uFF0C\u8BF7\u67E5\u770B shaper logs\u3002\u5DF2\u505C\u6B62\u672C\u6B21\u4F1A\u8BDD\u3002")}finally{await n()}}async function it(e){let t=await E(e);if(!(await V(t)).running)return{stopped:!0,alreadyStopped:!0};let n=await $(t);if(!(await fetch(`${n.controlUrl}/stop`,{method:"POST",headers:{Authorization:`Bearer ${n.token}`},redirect:"error",signal:AbortSignal.timeout(1e4)})).ok)throw new a("DEV_STOP_FAILED","\u5F00\u53D1\u4F1A\u8BDD\u672A\u80FD\u505C\u6B62\u3002");for(let o=0;o<30;o++){await new Promise(c=>setTimeout(c,200));try{await fetch(`${n.controlUrl}/status`,{headers:{Authorization:`Bearer ${n.token}`},redirect:"error",signal:AbortSignal.timeout(500)})}catch{return{stopped:!0,sessionId:n.id}}}throw new a("DEV_STOP_PENDING","\u505C\u6B62\u8BF7\u6C42\u5DF2\u53D1\u9001\uFF0C\u4F46\u4F1A\u8BDD\u4ECD\u672A\u9000\u51FA\uFF0C\u8BF7\u68C0\u67E5\u65E5\u5FD7\u3002")}async function ae(e){let t=await E(e);try{let r=await vt(A(F(t),"dev.log"),"utf8");return{root:t,log:r.slice(-16e3)}}catch(r){if(r.code==="ENOENT")return{root:t,log:"",message:"\u5C1A\u65E0\u672C\u5730\u8FD0\u884C\u65E5\u5FD7"};throw r}}export{E as a,N as b,O as c,R as d,C as e,Ut as f,Q as g,Lt as h,U as i,Vt as j,wt as k,Ft as l,Z as m,$t as n,zt as o,tt as p,F as q,V as r,oe as s,it as t,ae as u};
|
package/package.json
CHANGED
|
@@ -44,15 +44,14 @@ const user = await hupu.user();
|
|
|
44
44
|
|
|
45
45
|
```js
|
|
46
46
|
const response = await window.ShaperAI.cloud.request({
|
|
47
|
-
path: '/api/
|
|
48
|
-
method: 'POST'
|
|
49
|
-
data: { score: 100, submissionId }
|
|
47
|
+
path: '/api/me',
|
|
48
|
+
method: 'POST'
|
|
50
49
|
});
|
|
51
50
|
```
|
|
52
51
|
|
|
53
52
|
只传 path、method、data;支持 GET/POST/PUT/PATCH/DELETE/HEAD。路由的 public/user 决定是否登录。SDK 验证真实虎扑玩家、换取当前应用会话并请求网关;后端从 user.puid 判断归属,不信任 body.puid。预览访问凭证由壳管理,业务不读取或复制。
|
|
54
53
|
|
|
55
|
-
先确认 cloud status
|
|
54
|
+
先确认 cloud status 就绪、后端和网关部署成功,再在实际虎扑容器验证公开列表和当前用户身份。涉及业务数据库时另行验证迁移与读写;玩家云存档走独立能力。普通浏览器没有玩家登录态时给出登录提示,不使用开发者 Token 或调试账号冒充真实玩家。检查 statusCode 和业务 code/message/data;失败的写请求先确认结果,不自动重发。日志不记录 Token。
|
|
56
55
|
|
|
57
56
|
若返回 CLOUD_NOT_CONFIGURED,说明平台壳尚未接入新版能力,应升级平台 SDK/运行配置;不能自行拼接服务地址或回退旧鉴权。此次测试7已在开发环境验证,正式环境上线状态仍需核对。
|
|
58
57
|
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
|
|
9
9
|
1. 用 `hupu_cloud_status` 查询云资源。已就绪则复用;未开通时调用 `hupu_cloud_create` 发起网页确认,展示返回的 confirmationUrl,等待用户亲自确认。已有 Token 或对话同意不能替代网页确认;Agent 不代点确认,也不直接调用确认接口。不因部署失败而自动创建资源。
|
|
10
10
|
2. 有数据库变更时,先执行迁移并确认 succeeded;无变更则跳过。
|
|
11
|
-
3. 用 `hupu_cloud_deploy` 部署。默认构建 cloud/functions/
|
|
12
|
-
4.
|
|
11
|
+
3. 用 `hupu_cloud_deploy` 部署。默认构建 cloud/functions/activity 并组合网关声明;旧 functions/api 布局继续支持。已有制品可传 manifestFile 与 bundleFile,两者成对且与 directory 互斥。
|
|
12
|
+
4. 函数 cloud.json 必须声明 name。同一应用环境内同名更新,不同名新增;目录名不决定身份。多个函数分别传 directory 部署;网关每条路由通过 function 指向声明名称,不能让不同函数占用同一路径。核对 status.functions 中目标名称的部署结果,再验证实际接口。
|
|
13
13
|
|
|
14
14
|
CLI 对应 `shaper cloud create`、`shaper cloud deploy`、`shaper cloud status`。源码目录、生成文件和 SDK 用法由后端实现参考定义;这里不重复维护模板。
|
|
15
15
|
|
|
@@ -17,7 +17,7 @@ CLI 对应 `shaper cloud create`、`shaper cloud deploy`、`shaper cloud status`
|
|
|
17
17
|
|
|
18
18
|
写操作默认等待结果。queued/running 或 pending 表示仍未确认完成;通过 status 的 operations / recentOperations 按原 operationId 查询,不重发写入或换键重试。failed 时说明实际错误;结果未知时先核对原任务。
|
|
19
19
|
|
|
20
|
-
开通以资源 ready
|
|
20
|
+
开通以资源 ready 为准;部署核对 status.functions 中目标函数的 digest 与该次操作的 result.digest,再验证公开接口和登录接口。记录版本、操作状态和接口验证范围,不把受理成功当作上线成功。
|
|
21
21
|
|
|
22
22
|
## 当前边界
|
|
23
23
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
先按用户操作定义请求、响应、身份前提和失败行为。业务使用普通 Node HTTP 服务;Express 等框架由项目选择,SDK 只负责玩家鉴权与 PostgreSQL 访问。
|
|
4
4
|
|
|
5
5
|
```text
|
|
6
|
-
cloud/functions/
|
|
6
|
+
cloud/functions/activity/
|
|
7
7
|
server.cjs # HTTP 启动入口,可拆分路由和业务模块
|
|
8
8
|
cloud.json # manifest v2、SDK 精确版本、运行参数
|
|
9
9
|
package.json # 依赖与 hupuCloud.entry
|
|
@@ -35,10 +35,10 @@ process.once('SIGTERM', () => server.close(() => cloud.close()));
|
|
|
35
35
|
|
|
36
36
|
每个进程复用一个 client,每次请求单独取得 user;私有接口必须调用 requireUser。按可信 user.puid 限制数据归属,不能采用 body.puid。可匿名接口用 getUser;无凭据返回 null,无效凭据仍报错。运行绑定由平台注入,源码不包含厂商密钥或数据库密码。
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
函数 cloud.json 的 name 是部署身份,目录重命名不改变身份;代码摘要仅代表版本。网关每条声明用 function 指向该名称,构建时只选择当前函数的路由。它不映射 JavaScript 处理函数。新增接口同步声明路径和方法,服务端仍须鉴权。腾讯托管网关负责 CORS 响应,避免重复添加跨域头。
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
需要服务参考时执行 `shaper template add server`,或调用 `shaper_template_add` 并传 name=server。模板只提取到 `templates/server/`,先读其中 README.md,再检查并融合现有前后端、路由和数据库;不要整目录覆盖或直接部署模板。`shaper cloud create` 独立开通远程资源,须用户网页确认;融合后再迁移、部署。函数目录执行 npm ci,新增依赖后提交锁文件。部署将 SDK 和业务依赖打包,产物在 .shaper/cloud-build/<digest>。旧 handler 项目需显式升级为 HTTP 服务,不能直接换 SDK 版本。
|
|
41
41
|
|
|
42
42
|
前端使用 ShaperAI.cloud.request({ path, method, data }),完整玩家接入见 hupu-business。迁移、后端部署和网页预览分别验证;真实登录和云端读写通过才算链路完成。当前已完成腾讯云新版真机验证,阿里云仍待验证。
|
|
43
43
|
|
|
44
|
-
需要排行榜时,调用
|
|
44
|
+
需要排行榜时,调用 shaper_template_list 找到 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
|
-
|
|
21
|
+
接入完成且需求尚未明确时,引导用户描述想法,暂不选择工程类型。无工程时使用 `shaper_create(workspace, type)`(CLI:`shaper create --type react`)创建可运行工程并安装依赖;已有工程保留原技术栈。功能参考通过 shaper_template_add 获取,读说明后融合。not_created 是待创作状态;configuration_required 才需要检查已有工程并补配置。
|
|
21
22
|
|
|
22
23
|
用 Agent 自带的文件工具编写项目。`shaper_dev_start` 返回就绪 URL 后,在浏览器检查用户实际会用的交互、控制台错误和窄屏布局。开发日志用 `shaper_dev_logs`。停止服务用 `shaper_dev_stop`;状态查询不会重启服务。
|
|
23
24
|
|
|
@@ -29,7 +30,7 @@ description: 检查新旧 Shaper 项目的归属,初始化或关联应用,
|
|
|
29
30
|
|
|
30
31
|
## 复用完整项目模板
|
|
31
32
|
|
|
32
|
-
需要排行榜或离线养成时,调用 `
|
|
33
|
+
需要排行榜或离线养成时,调用 `shaper_template_list` 查看功能模板,调用 `shaper_template_add(workspace, name)` 提取到 templates/<name>,先读 README 和 docs/integration.md。检查现有身份、积分、存档与路由,再增量融合并验证原业务;提取不代表已接入。后端迁移与部署交由 shaper-backend。
|
|
33
34
|
|
|
34
35
|
## 用户引导
|
|
35
36
|
|
|
@@ -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、摘要和本地状态文件仅供工具使用。
|
|
@@ -34,12 +34,13 @@
|
|
|
34
34
|
- 接入完成条件:应用存在、权限正确、绑定已保存。没有源码无需构建,接入后按用户需求继续;没有需求则引导描述想法。
|
|
35
35
|
- 后续工程创建、上传和提审使用同一个 App ID,不再从网页新建应用。
|
|
36
36
|
|
|
37
|
-
##
|
|
37
|
+
## 工程创建与功能参考
|
|
38
38
|
|
|
39
|
-
-
|
|
40
|
-
- create
|
|
41
|
-
-
|
|
42
|
-
-
|
|
39
|
+
- 无工程且需求明确时,调用 `shaper_create(workspace, type)`,CLI 为 `shaper create --type react`。h5 用于轻量页面,react 用于复杂交互,phaser 用于实时游戏;AI 按需求选择。
|
|
40
|
+
- create 在工程目录生成源码、配置并安装依赖,保留绑定与产品文档;已有业务代码时停止。中断重试同类型;跳过安装返回 dependencies_required,安装后继续验证。
|
|
41
|
+
- 功能参考使用 `shaper_template_add(workspace, name)`,CLI 为 `shaper template add server`。只提取到 templates/<name>,返回 template_ready 和说明路径,不安装依赖或部署。
|
|
42
|
+
- AI 读说明,检查现有工程,再融合代码、依赖和迁移。多个模板可共存,重复获取保留修改;冲突不覆盖。
|
|
43
|
+
- 正式工程完成后执行 shaper_check、shaper_build 和受管预览,检查交互后给试玩入口。
|
|
43
44
|
|
|
44
45
|
## 工程配置
|
|
45
46
|
|
|
@@ -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_template_list 查找 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 原型迁移和固定阶段审批。
|
|
@@ -14,7 +14,7 @@ function registerLeaderboard(app, cloud) {
|
|
|
14
14
|
next(e);
|
|
15
15
|
}
|
|
16
16
|
});
|
|
17
|
-
app.post("/api/leaderboard", async (req, res, next) => {
|
|
17
|
+
app.post("/api/leaderboard/scores", async (req, res, next) => {
|
|
18
18
|
try {
|
|
19
19
|
const user = await cloud.auth.requireUser({
|
|
20
20
|
authorization: req.get("authorization"),
|
|
@@ -4,12 +4,14 @@
|
|
|
4
4
|
{
|
|
5
5
|
"method": "GET",
|
|
6
6
|
"path": "/api/leaderboard",
|
|
7
|
-
"access": "public"
|
|
7
|
+
"access": "public",
|
|
8
|
+
"function": "ranking"
|
|
8
9
|
},
|
|
9
10
|
{
|
|
10
11
|
"method": "POST",
|
|
11
|
-
"path": "/api/scores",
|
|
12
|
-
"access": "user"
|
|
12
|
+
"path": "/api/leaderboard/scores",
|
|
13
|
+
"access": "user",
|
|
14
|
+
"function": "ranking"
|
|
13
15
|
}
|
|
14
16
|
]
|
|
15
17
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 集成排行榜
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
先通过 `shaper template add leaderboard` 获取参考。空工程先用 `shaper create --type h5`(或其他合适类型)创建工程;已有工程保留技术栈。按以下步骤融合,在正式工程中安装依赖和验证。
|
|
4
4
|
|
|
5
5
|
1. 检查已有身份、积分表、成绩产生逻辑和主服务。已有用户/积分能力优先复用;不要复制本模板创建第二套 puid 或分数。
|
|
6
6
|
2. 参考 cloud/functions/api/leaderboard.cjs,把路由接到现有 Express app;其他框架保持原框架,移植相同身份和SQL规则。SDK 客户端在服务中复用,入口只启动一次。
|
|
@@ -44,7 +44,7 @@ document.querySelector("#submit").onsubmit = async (e) => {
|
|
|
44
44
|
try {
|
|
45
45
|
const form = new FormData(e.target);
|
|
46
46
|
const result = await request({
|
|
47
|
-
path: "/api/leaderboard",
|
|
47
|
+
path: "/api/leaderboard/scores",
|
|
48
48
|
method: "POST",
|
|
49
49
|
data: {
|
|
50
50
|
displayName: form.get("displayName"),
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 集成离线养成
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
先通过 `shaper template add offline-game` 获取参考。空工程先用 `shaper create --type h5`(或其他合适类型)创建工程;已有工程保留技术栈。按以下步骤融合,在正式工程中安装依赖和验证。
|
|
4
4
|
|
|
5
5
|
1. 先找现有资源余额、升级规则、计时和存档模块;已有能力直接复用,不新建第二套余额。
|
|
6
6
|
2. 参考 src/game.js 的 settle/upgrade,映射到现有字段和经济规则。存档 key 用项目自己的名称;已有存档增加版本迁移,不清空。
|
|
@@ -1 +1,12 @@
|
|
|
1
|
-
<!doctype html
|
|
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" />
|
|
6
|
+
<title>离线小花园</title>
|
|
7
|
+
</head>
|
|
8
|
+
<body>
|
|
9
|
+
<div id="app"></div>
|
|
10
|
+
<script type="module" src="/src/main.js"></script>
|
|
11
|
+
</body>
|
|
12
|
+
</html>
|
|
@@ -1,11 +1,42 @@
|
|
|
1
1
|
export const MAX_OFFLINE_SECONDS = 8 * 60 * 60;
|
|
2
|
-
export const STORAGE_KEY =
|
|
3
|
-
export function fresh(now = Date.now()) {
|
|
2
|
+
export const STORAGE_KEY = "shaper-offline-garden-v1";
|
|
3
|
+
export function fresh(now = Date.now()) {
|
|
4
|
+
return { version: 1, coins: 0, level: 1, lastSeen: now };
|
|
5
|
+
}
|
|
4
6
|
export function restore(raw, now = Date.now()) {
|
|
5
|
-
|
|
7
|
+
try {
|
|
8
|
+
const s = JSON.parse(raw);
|
|
9
|
+
if (
|
|
10
|
+
s.version !== 1 ||
|
|
11
|
+
!Number.isFinite(s.coins) ||
|
|
12
|
+
s.coins < 0 ||
|
|
13
|
+
s.coins > 1e12 ||
|
|
14
|
+
!Number.isInteger(s.level) ||
|
|
15
|
+
s.level < 1 ||
|
|
16
|
+
s.level > 50 ||
|
|
17
|
+
!Number.isFinite(s.lastSeen) ||
|
|
18
|
+
s.lastSeen < 0
|
|
19
|
+
)
|
|
20
|
+
return fresh(now);
|
|
21
|
+
return { version: 1, coins: s.coins, level: s.level, lastSeen: s.lastSeen };
|
|
22
|
+
} catch {
|
|
23
|
+
return fresh(now);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
export function settle(state, now = Date.now()) {
|
|
27
|
+
const seconds = Math.min(
|
|
28
|
+
MAX_OFFLINE_SECONDS,
|
|
29
|
+
Math.max(0, Math.floor((now - state.lastSeen) / 1000)),
|
|
30
|
+
);
|
|
31
|
+
return {
|
|
32
|
+
...state,
|
|
33
|
+
coins: Math.min(1e12, state.coins + seconds * state.level),
|
|
34
|
+
lastSeen: Math.max(state.lastSeen, now),
|
|
35
|
+
};
|
|
6
36
|
}
|
|
7
|
-
export function
|
|
8
|
-
|
|
9
|
-
|
|
37
|
+
export function upgrade(state) {
|
|
38
|
+
const cost = state.level * 20;
|
|
39
|
+
return state.level < 50 && state.coins >= cost
|
|
40
|
+
? { ...state, coins: state.coins - cost, level: state.level + 1 }
|
|
41
|
+
: state;
|
|
10
42
|
}
|
|
11
|
-
export function upgrade(state) { const cost=state.level*20; return state.level<50&&state.coins>=cost?{...state,coins:state.coins-cost,level:state.level+1}:state; }
|
|
@@ -1,12 +1,60 @@
|
|
|
1
|
-
import
|
|
2
|
-
import {fresh,restore,settle,upgrade,STORAGE_KEY} from
|
|
3
|
-
document.querySelector(
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
1
|
+
import "./style.css";
|
|
2
|
+
import { fresh, restore, settle, upgrade, STORAGE_KEY } from "./game.js";
|
|
3
|
+
document.querySelector("#app").innerHTML =
|
|
4
|
+
`<main><small>SHAPER · OFFLINE GARDEN</small><h1>离开一会儿,<br>花园也在生长。</h1><p>收集阳光、升级花园,下次回来领取离线收益。</p><section><p>我的阳光</p><strong id="coins"></strong><p id="level"></p><button id="collect">收集阳光 +1</button><button id="upgrade">升级花园</button><p id="message" role="status"></p></section><p>离线最多累计 8 小时。本地存档保存在当前浏览器,清理浏览器数据后会丢失。</p></main>`;
|
|
5
|
+
let state = fresh(),
|
|
6
|
+
storageOK = true;
|
|
7
|
+
try {
|
|
8
|
+
state = restore(localStorage.getItem(STORAGE_KEY));
|
|
9
|
+
} catch {
|
|
10
|
+
storageOK = false;
|
|
11
|
+
}
|
|
12
|
+
const before = state.coins;
|
|
13
|
+
state = settle(state);
|
|
14
|
+
let message =
|
|
15
|
+
state.coins > before
|
|
16
|
+
? `欢迎回来,收获 ${Math.floor(state.coins - before)} 点阳光。`
|
|
17
|
+
: "每秒自动收获阳光,也可以手动收集。";
|
|
18
|
+
function save() {
|
|
19
|
+
try {
|
|
20
|
+
localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
|
|
21
|
+
} catch {
|
|
22
|
+
storageOK = false;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
function render() {
|
|
26
|
+
document.querySelector("#coins").textContent = Math.floor(state.coins);
|
|
27
|
+
document.querySelector("#level").textContent =
|
|
28
|
+
`花园等级 ${state.level} · 每秒 ${state.level} 点阳光`;
|
|
29
|
+
const button = document.querySelector("#upgrade");
|
|
30
|
+
button.textContent =
|
|
31
|
+
state.level === 50 ? "已满级" : `升级 · ${state.level * 20} 阳光`;
|
|
32
|
+
button.disabled = state.level === 50 || state.coins < state.level * 20;
|
|
33
|
+
document.querySelector("#message").textContent = storageOK
|
|
34
|
+
? message
|
|
35
|
+
: "浏览器无法保存进度,本次可以试玩,关闭后可能丢失。";
|
|
36
|
+
}
|
|
37
|
+
function tick() {
|
|
38
|
+
state = settle(state);
|
|
39
|
+
save();
|
|
40
|
+
render();
|
|
41
|
+
}
|
|
42
|
+
document.querySelector("#collect").onclick = () => {
|
|
43
|
+
state = settle(state);
|
|
44
|
+
state.coins = Math.min(1e12, state.coins + 1);
|
|
45
|
+
save();
|
|
46
|
+
render();
|
|
47
|
+
};
|
|
48
|
+
document.querySelector("#upgrade").onclick = () => {
|
|
49
|
+
state = upgrade(settle(state));
|
|
50
|
+
save();
|
|
51
|
+
render();
|
|
52
|
+
};
|
|
53
|
+
setInterval(tick, 1000);
|
|
54
|
+
document.addEventListener("visibilitychange", tick);
|
|
55
|
+
window.addEventListener("pagehide", () => {
|
|
56
|
+
state = settle(state);
|
|
57
|
+
save();
|
|
58
|
+
});
|
|
59
|
+
save();
|
|
60
|
+
render();
|