八年级四班 / 开发者平台
Developer Console

开发者平台 · 概览

站点结构、地理闯关「双人 PK」接口文档、在线调试台与服务健康状态。全站托管在 Cloudflare,静态资源走 Pages,对战接口走独立 Worker。

发布网页 →
接口服务
检测中…
pk.hm84.de5.net
响应延迟
—
每 30 秒自动检测
边缘区域
—
Cloudflare 全球节点
平台版本
v1.4
2026 · 11 更新
01

成果网站

大家用开发者平台发布的网页,点卡片即可打开

02

我的账户

管理你的 ID、邮箱和登录设备

请先登录账户
03

发布我的网页

上传 HTML 或 ZIP,云端解析后生成独立网址

📤
点击选择 或 拖入文件
支持单个 .html / .htm,或 .zip 压缩包(内含 index.html 作为首页,可含多个页面/图片/JS/CSS)
单文件 ≤ 10MB,整站 ≤ 20MB
🔒 发布网页需要先登录账户。每个网页归属你的账号,只有你能更新或删除。
✅ 发布成功
打开
把这个网址发给别人即可访问。支持在电脑、手机、平板等任何联网设备上打开。

更新 / 删除我的网站

用登录账户管理自己的网站:重新上传文件即更新,或删除整个网站。

04

使用指导 · 零基础也能做网站

不用懂代码,把需求告诉 AI,几分钟拥有一个能分享的网址

1

先想清楚要什么

一句话说清:做什么主题、给谁看、要哪些板块。比如「做一个班级读书分享网页,有书名、简介、推荐理由,清新风格」。

2

让 AI 生成网页

把下面这段提示词发给任意 AI(WorkBuddy / 星火 / 豆包等),把括号内容换成你的需求。AI 会给你一个 index.html 文件。

3

保存成文件

把 AI 回复里的代码整段复制,粘贴到记事本,保存为 index.html(编码选 UTF-8)。有多个页面或图片就一起放进一个 .zip。

4

上传拿网址

回到本页顶部「发布我的网页」,把文件拖进去,点「发布到云端」,几秒后就能得到一条可以发给任何人的网址。

复制这段提示词发给 AI,就能生成网页
请帮我做一个网页,并教我把它部署到网上,要求如下:
主题:【这里写你的网页主题,例如:班级读书分享】
用途:【给谁看,例如:八年级四班同学和家长】
板块:【要有哪些内容,例如:首页、书名列表、推荐理由、留言区】
风格:【例如:清新简约 / 科技感 / 暖色卡片】
账号:【自己定一个至少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. 提醒我:账号密码要记牢,以后更新或删除这个网站都要先登录;发布过的网站会出现在首页「成果网站」画廊里,所有人都能看到。
小提示:提示词里把【账号】【密码】换成你自己定的,AI 会连注册登录和部署步骤一起教你。如果 AI 给的代码里有多段(比如单独的 CSS、JS 文件),让它「全部合并到一个 HTML 文件里」重新生成。上传时 ZIP 包里必须有一个 index.html 作为首页。生成后的网址在手机、平板、电脑上都能打开。
05

PK 接口文档

Base URL https://pk.hm84.de5.net/api/pk

Method

POST · JSON

统一 application/json,字段 action 决定操作。

Auth

房间令牌

create / join 下发 token,后续请求带 room + side + token。

Transport

HTTP + WS

CORS 全开;/api/pk/ws 推送状态,HTTP 轮询作兜底。

action参数(除 action 外)返回说明
ping—{ok,now}连通性探测,不计任何状态
createname, questions[], config{ok,room,side:"host",token,state}建房。题目由房主本地下发,答案索引不上屏
joinroom, name{ok,room,side:"guest",token,state}入房;同名重试按幂等处理
matchname{ok,matched,room?,token?,state?}随机匹配一个等待中的房间
pollroom,side,token{ok,state}拉取最新状态;同时刷新"在线"心跳
answerroom,side,token, qIndex, optionIndex{ok,correct,state}提交作答;服务端判分,重复提交幂等
nextroom,side,token{ok,state}房主推进下一题(兜底,正常由服务端自动推进)
resetroom,side,token, questions[], config{ok,state}房主重开一局,比分与拔河归零
leaveroom,side,token{ok,left}离场;对局中离场会让对手直接获胜

state 字段

客户端按 seq 单调递增去重

字段类型含义
phasestringwaiting 等对手 → playing 对局中 → finished 已结束
seqnumber状态版本号,每次变更 +1,旧状态直接丢弃
qIndex / qTotalnumber当前题号(从 0 开始)与总题数
questionobject{province,type,options},不含 answerIndex
revealedboolean本题是否已揭晓;揭晓后 answerIndex 才有值
questionWinnerstring|nullhost / guest / null(无人答对)
host / guestobject{name,score,answered,online};guest 未加入时为 null
tugnumber拔河位置:host 答对 -1,guest 答对 +1
advanceAtnumber揭晓后的推进时间戳(毫秒),未揭晓为 0
winnerstring|nullhost / guest / draw,仅 finished 时有值

对局规则

服务端权威,客户端只负责渲染

30s

单题上限

对方不答、掉线、页面被关,到点自动揭晓"本题无人答对"并进入下一题。

3s

揭晓停留

显示正确答案与本题胜负,3 秒后自动推进,期间不阻塞新状态推送。

15s

心跳阈值

对手超过 15 秒没有任何请求即视为掉线,已作答一方 2 秒后直接放行。

+10

计分

答对 +10 分;先答对者立即揭晓,双方都答错也会揭晓。

±10

提前终结

拔河领先到 10 格立即结束;否则答完全部题目后按拔河判定。

400 / 401 / 409 / 410

错误码

参数错 / 令牌失效 / 房间已满或已结束 / 房主久未活动房间失效。

WebSocket

服务端状态一变就推,断线自动回落轮询

wss://pk.hm84.de5.net/api/pk/ws?room=ABC123&side=guest&token=xxxx

// 下行消息
{"type":"state","room":"ABC123","state":{ ...与 poll 返回的 state 完全一致... }}
06

快速开始

三步接入:建房 → 分享房间号 → 作答与轮询

# 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":""}'

题目、答案索引都由客户端生成后再交给服务端保管,服务端只在 revealed 之后下发 answerIndex,避免被抓包看答案。

07

在线调试

真实请求 pk.hm84.de5.net,响应原样返回

create 会向服务端注册一个真实房间并占用内存,调试完可让它自然过期(30 分钟),不要在高峰期连续点。

响应 等待请求
调整左侧参数,点“发送请求”。{\n  "action": "ping"\n}
站点技术文档与运维(点击展开)
08

站点概览

谁在跑、跑在哪、入口有哪些

Hosting

Cloudflare Pages

项目 class84,纯静态直传部署,无构建步骤。

Domain

两个域名

hm84.de5.net · hm84.xhwu.cc.cd

API

Durable Object

Worker class84-pk-core,自定义域 pk.hm84.de5.net。

State

每房间强一致

一个房间 = 一个 DO 实例,状态与定时器都在实例内,不依赖轮询唤醒。

09

路由与文件

部署包里有什么,请求会被谁接住

路径类型说明
/HTML首页:数据驾驶舱、今日课表、班级公告、地理专区
/tools.html回落命中兜底重写,返回首页内容(历史路径)
/work.html回落同上,锚点 #dashboard / #notices 仍可用
/games/china-geo-gameHTML地理闯关:学习地图、通关、拼图、双人 PK(无扩展名,靠 _headers 指定 text/html)
/dev/HTML本页:开发者平台
/dev/pk-api.jsonJSONPK 接口的机器可读描述,可用于生成客户端或 SDK
/assets/css/platform.cssCSS全站设计系统(含深 / 浅两套色板变量)
/_redirects规则/* /index.html 200:未知路径全部回落首页
/_headers规则为无扩展名页面指定 Content-Type: text/html

注意:因为存在 /* → /index.html 的兜底重写,新增页面必须真实落地为文件,否则任何拼错的地址都会返回首页(状态码 200),调试时不要靠状态码判断"页面存在"。

10

架构

两条独立链路:静态资源与对战接口

浏览器 client
页面 / 脚本 / WebSocket
Cloudflare Pages static
class84 · hm84.de5.net
Worker edge
class84-pk-core · /api/pk
Durable Object state
每房间一个 · alarm 定时器 · WebSocket
为什么用 DO

强一致

房间状态只有一份副本,两个玩家的读写落在同一实例,不会出现跨机房读到旧状态。

为什么用 alarm

不靠客户端催

揭晓与推进由服务端定时器驱动,客户端掉线、关页面都不会让对局停住。

为什么单独域名

可独立回滚

接口与站点分开部署,升级对战时不必重新上传 300 KB 的游戏页面。

11

更新日志

只记影响调用方的变更

2026-11-18

开发者平台上线

  • 新增 /dev/:接口文档、在线调试、服务状态、路由与部署说明
  • 新增 /dev/pk-api.json:PK 接口的机器可读描述
2026-11-16

在线双人 PK 修复:答完第一题不再卡死

  • 对战状态从 Pages Function + KV 迁到「每房间一个 Durable Object」,消除跨机房读到旧状态
  • 新增单题 30 秒上限、对手 15 秒心跳判定、揭晓后自动推进,均由服务端 alarm 驱动
  • 客户端接口地址切到 pk.hm84.de5.net,并补充“对手掉线”状态提示
2026-09-23

站点上线

  • Cloudflare Pages 托管,绑定 hm84.de5.net
12

部署与运维

静态站点直传,接口单独发布

# 站点(静态资源整包直传,会替换整站内容)
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 名称、房间令牌一律不进仓库、不进页面;这里只描述可公开的调用方式。

登录账户

登录后才能发布和管理自己的网页