开发者平台 · 概览
站点结构、地理闯关「双人 PK」接口文档、在线调试台与服务健康状态。全站托管在 Cloudflare,静态资源走 Pages,对战接口走独立 Worker。
成果网站
大家用开发者平台发布的网页,点卡片即可打开
我的账户
管理你的 ID、邮箱和登录设备
发布我的网页
上传 HTML 或 ZIP,云端解析后生成独立网址
使用指导 · 零基础也能做网站
不用懂代码,把需求告诉 AI,几分钟拥有一个能分享的网址
先想清楚要什么
一句话说清:做什么主题、给谁看、要哪些板块。比如「做一个班级读书分享网页,有书名、简介、推荐理由,清新风格」。
让 AI 生成网页
把下面这段提示词发给任意 AI(WorkBuddy / 星火 / 豆包等),把括号内容换成你的需求。AI 会给你一个 index.html 文件。
保存成文件
把 AI 回复里的代码整段复制,粘贴到记事本,保存为 index.html(编码选 UTF-8)。有多个页面或图片就一起放进一个 .zip。
上传拿网址
回到本页顶部「发布我的网页」,把文件拖进去,点「发布到云端」,几秒后就能得到一条可以发给任何人的网址。
请帮我做一个网页,并教我把它部署到网上,要求如下: 主题:【这里写你的网页主题,例如:班级读书分享】 用途:【给谁看,例如:八年级四班同学和家长】 板块:【要有哪些内容,例如:首页、书名列表、推荐理由、留言区】 风格:【例如:清新简约 / 科技感 / 暖色卡片】 账号:【自己定一个至少3位的英文账号,例如:xiaoming】 密码:【自己定一个至少6位的密码,例如:abc123456,务必记牢】 网页要求: 1. 生成一个完整的 index.html 文件,HTML/CSS/JS 全部写在同一个文件里,不要拆分成多个文件。 2. 不要引用任何外部图片、字体、CDN 链接,确保离线也能正常显示(需要插图就用 CSS 或 emoji)。 3. 页面自适应手机和电脑,中文正常显示(meta charset 用 utf-8)。 4. 直接输出完整代码,不要解释,我要复制保存成 index.html。 部署要求(请在生成代码后,另起一段用大白话告诉我怎么操作): 5. 打开 https://hm84.de5.net/dev/ 这个开发者页面。 6. 把 index.html 拖进「发布我的网页」上传区。 7. 第一次用要点右上角「登录 / 注册」→ 切到注册 → 填上面我给的【账号】和【密码】创建账户(以后登录也用这套)。 8. 把 index.html 拖进「发布我的网页」上传区,网址后缀填一个好记的英文(如 my-book)。 9. 点「发布到云端」,拿到形如 https://dev.hm84.de5.net/s/后缀/ 的网址,这就是我的网站,发给别人就能打开。 10. 提醒我:账号密码要记牢,以后更新或删除这个网站都要先登录;发布过的网站会出现在首页「成果网站」画廊里,所有人都能看到。
PK 接口文档
Base URL https://pk.hm84.de5.net/api/pk
POST · JSON
统一 application/json,字段 action 决定操作。
房间令牌
create / join 下发 token,后续请求带 room + side + token。
HTTP + WS
CORS 全开;/api/pk/ws 推送状态,HTTP 轮询作兜底。
| action | 参数(除 action 外) | 返回 | 说明 |
|---|---|---|---|
| ping | — | {ok,now} | 连通性探测,不计任何状态 |
| create | name, questions[], config | {ok,room,side:"host",token,state} | 建房。题目由房主本地下发,答案索引不上屏 |
| join | room, name | {ok,room,side:"guest",token,state} | 入房;同名重试按幂等处理 |
| match | name | {ok,matched,room?,token?,state?} | 随机匹配一个等待中的房间 |
| poll | room,side,token | {ok,state} | 拉取最新状态;同时刷新"在线"心跳 |
| answer | room,side,token, qIndex, optionIndex | {ok,correct,state} | 提交作答;服务端判分,重复提交幂等 |
| next | room,side,token | {ok,state} | 房主推进下一题(兜底,正常由服务端自动推进) |
| reset | room,side,token, questions[], config | {ok,state} | 房主重开一局,比分与拔河归零 |
| leave | room,side,token | {ok,left} | 离场;对局中离场会让对手直接获胜 |
state 字段
客户端按 seq 单调递增去重
| 字段 | 类型 | 含义 |
|---|---|---|
| phase | string | waiting 等对手 → playing 对局中 → finished 已结束 |
| seq | number | 状态版本号,每次变更 +1,旧状态直接丢弃 |
| qIndex / qTotal | number | 当前题号(从 0 开始)与总题数 |
| question | object | {province,type,options},不含 answerIndex |
| revealed | boolean | 本题是否已揭晓;揭晓后 answerIndex 才有值 |
| questionWinner | string|null | host / guest / null(无人答对) |
| host / guest | object | {name,score,answered,online};guest 未加入时为 null |
| tug | number | 拔河位置:host 答对 -1,guest 答对 +1 |
| advanceAt | number | 揭晓后的推进时间戳(毫秒),未揭晓为 0 |
| winner | string|null | host / guest / draw,仅 finished 时有值 |
对局规则
服务端权威,客户端只负责渲染
单题上限
对方不答、掉线、页面被关,到点自动揭晓"本题无人答对"并进入下一题。
揭晓停留
显示正确答案与本题胜负,3 秒后自动推进,期间不阻塞新状态推送。
心跳阈值
对手超过 15 秒没有任何请求即视为掉线,已作答一方 2 秒后直接放行。
计分
答对 +10 分;先答对者立即揭晓,双方都答错也会揭晓。
提前终结
拔河领先到 10 格立即结束;否则答完全部题目后按拔河判定。
错误码
参数错 / 令牌失效 / 房间已满或已结束 / 房主久未活动房间失效。
WebSocket
服务端状态一变就推,断线自动回落轮询
wss://pk.hm84.de5.net/api/pk/ws?room=ABC123&side=guest&token=xxxx
// 下行消息
{"type":"state","room":"ABC123","state":{ ...与 poll 返回的 state 完全一致... }}
快速开始
三步接入:建房 → 分享房间号 → 作答与轮询
# 1) 建房(题目由客户端生成,含 answerIndex)
curl -s -X POST https://pk.hm84.de5.net/api/pk \
-H 'Content-Type: application/json' \
-d '{"action":"create","name":"甲","questions":[{"province":"湖北省","type":3,"options":["南宁","西安","广州","武汉"],"answerIndex":3}],"config":{"questionType":3,"mapType":"full"}}'
# 2) 对手加入后,用 token 作答
curl -s -X POST https://pk.hm84.de5.net/api/pk \
-H 'Content-Type: application/json' \
-d '{"action":"answer","room":"ABC123","side":"host","token":"","qIndex":0,"optionIndex":3}'
# 3) 轮询最新状态(建议 400ms 一次,WS 可用时降到 3s)
curl -s -X POST https://pk.hm84.de5.net/api/pk \
-H 'Content-Type: application/json' \
-d '{"action":"poll","room":"ABC123","side":"host","token":""}'
// 建房
const r = await fetch('https://pk.hm84.de5.net/api/pk', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ action: 'create', name: '甲', questions, config: { questionType: 3, mapType: 'full' } })
}).then(r => r.json());
// r.room / r.token,把房间号发给对手
// 作答
await fetch('https://pk.hm84.de5.net/api/pk', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ action: 'answer', room: r.room, side: 'host', token: r.token, qIndex: 0, optionIndex: 3 })
});
// 状态推送:连上就不要再高频轮询
const ws = new WebSocket(`wss://pk.hm84.de5.net/api/pk/ws?room=${r.room}&side=host&token=${r.token}`);
ws.onmessage = e => {
const { state } = JSON.parse(e.data);
if (state.seq <= lastSeq) return; // 用 seq 去重
lastSeq = state.seq;
render(state); // 只重画变化的部分
};
题目、答案索引都由客户端生成后再交给服务端保管,服务端只在 revealed 之后下发 answerIndex,避免被抓包看答案。
在线调试
真实请求 pk.hm84.de5.net,响应原样返回
调整左侧参数,点“发送请求”。{\n "action": "ping"\n}
站点技术文档与运维(点击展开)
站点概览
谁在跑、跑在哪、入口有哪些
Cloudflare Pages
项目 class84,纯静态直传部署,无构建步骤。
两个域名
hm84.de5.net · hm84.xhwu.cc.cd
Durable Object
Worker class84-pk-core,自定义域 pk.hm84.de5.net。
每房间强一致
一个房间 = 一个 DO 实例,状态与定时器都在实例内,不依赖轮询唤醒。
路由与文件
部署包里有什么,请求会被谁接住
| 路径 | 类型 | 说明 |
|---|---|---|
| / | HTML | 首页:数据驾驶舱、今日课表、班级公告、地理专区 |
| /tools.html | 回落 | 命中兜底重写,返回首页内容(历史路径) |
| /work.html | 回落 | 同上,锚点 #dashboard / #notices 仍可用 |
| /games/china-geo-game | HTML | 地理闯关:学习地图、通关、拼图、双人 PK(无扩展名,靠 _headers 指定 text/html) |
| /dev/ | HTML | 本页:开发者平台 |
| /dev/pk-api.json | JSON | PK 接口的机器可读描述,可用于生成客户端或 SDK |
| /assets/css/platform.css | CSS | 全站设计系统(含深 / 浅两套色板变量) |
| /_redirects | 规则 | /* /index.html 200:未知路径全部回落首页 |
| /_headers | 规则 | 为无扩展名页面指定 Content-Type: text/html |
注意:因为存在 /* → /index.html 的兜底重写,新增页面必须真实落地为文件,否则任何拼错的地址都会返回首页(状态码 200),调试时不要靠状态码判断"页面存在"。
架构
两条独立链路:静态资源与对战接口
强一致
房间状态只有一份副本,两个玩家的读写落在同一实例,不会出现跨机房读到旧状态。
不靠客户端催
揭晓与推进由服务端定时器驱动,客户端掉线、关页面都不会让对局停住。
可独立回滚
接口与站点分开部署,升级对战时不必重新上传 300 KB 的游戏页面。
更新日志
只记影响调用方的变更
开发者平台上线
- 新增
/dev/:接口文档、在线调试、服务状态、路由与部署说明 - 新增
/dev/pk-api.json:PK 接口的机器可读描述
在线双人 PK 修复:答完第一题不再卡死
- 对战状态从 Pages Function + KV 迁到「每房间一个 Durable Object」,消除跨机房读到旧状态
- 新增单题 30 秒上限、对手 15 秒心跳判定、揭晓后自动推进,均由服务端 alarm 驱动
- 客户端接口地址切到
pk.hm84.de5.net,并补充“对手掉线”状态提示
站点上线
- Cloudflare Pages 托管,绑定
hm84.de5.net
部署与运维
静态站点直传,接口单独发布
# 站点(静态资源整包直传,会替换整站内容) wrangler pages deploy . --project-name=class84 --branch=main
# 对战接口(Worker + Durable Object) wrangler deploy --config wrangler.toml
别漏文件
Pages 每次部署都是全量快照,目录里少一个文件,线上就少一个文件。
保留历史部署
任何一次部署都可用上一次的部署 ID 回滚,接口与站点互不影响。
0 秒缓存 + 重验证
页面 max-age=0, must-revalidate,改动刷新即生效。
凭证、KV 名称、房间令牌一律不进仓库、不进页面;这里只描述可公开的调用方式。
