HTML5 重写:6 款游戏 + 用户系统 + 全局设置 + 5 轮迭代重构
- 新增 web/ 纯音频 HTML5 平台:共享引擎(手势/WebAudio 三层/设置/震动)、 Node 零依赖服务器(静态 + 注册登录 + 进度存档 API) - 游戏:剑与声(RPG 新作)、声命线、暗室(重设计)、音序回响(重设计)、 节拍行者(跟随领奏重构)、盲航(同向闪避重构);声东击西删除 - 全局功能:男声/女声双套 TTS 资产、三档语速、BGM 音量三档、 震动反馈语言(10 种震型)、服务器进度同步 - 资产:899 ogg + 899 m4a(Qwen3-TTS 双性别语音、Stable Audio 3 音效、 Mureka BGM 4+3 首),终检零缺失 - 文档:docs/design/ 13 篇设计审查文档、docs/audio/ 资产管线、 web/server/README.md API 文档
This commit is contained in:
@@ -0,0 +1,93 @@
|
||||
# SoundGame Web 服务器(web/server/server.js)
|
||||
|
||||
Node 零依赖(仅用内置模块)的静态文件 + 用户系统 API 服务器。
|
||||
|
||||
## 启动
|
||||
|
||||
```bash
|
||||
# 推荐:用项目自带 node
|
||||
tools/node/bin/node web/server/server.js
|
||||
|
||||
# 或用封装脚本(打印局域网地址)
|
||||
bash web/serve.sh
|
||||
|
||||
# 自定义端口(默认 8000)
|
||||
PORT=8001 tools/node/bin/node web/server/server.js
|
||||
```
|
||||
|
||||
- 静态根目录:`web/`(`/` 即游戏大厅 `index.html`)
|
||||
- 数据目录:`web/server/data/`(首次启动自动创建)
|
||||
|
||||
## ⚠ 安全说明
|
||||
|
||||
这是**家庭局域网玩具级认证**,请勿暴露到公网:
|
||||
|
||||
- PIN 以**明文**存储在 `data/users.json`;
|
||||
- token 永不过期,明文存于 `data/sessions.json`;
|
||||
- HTTP 明文传输,无 TLS、无防爆破、无速率限制。
|
||||
|
||||
用途仅限于同一 WiFi 下的家庭成员各自存档。要公网部署请换正经认证方案。
|
||||
|
||||
## API
|
||||
|
||||
所有 API 请求/响应均为 JSON(`Content-Type: application/json`)。
|
||||
错误响应统一为 `{ "error": "描述" }` + 相应 HTTP 状态码。
|
||||
|
||||
### POST /api/register
|
||||
|
||||
注册新用户。
|
||||
|
||||
- 请求:`{ "username": "ming", "pin": "1234" }`
|
||||
- `username`:1~24 位字母/数字/中文/`_`/`-`
|
||||
- `pin`:4~6 位数字
|
||||
- 成功:`201 { "ok": true, "username": "ming" }`
|
||||
- 失败:`400`(格式非法)/ `409 { "error": "用户名已被注册" }`
|
||||
|
||||
### POST /api/login
|
||||
|
||||
登录,返回 token。
|
||||
|
||||
- 请求:`{ "username": "ming", "pin": "1234" }`
|
||||
- 成功:`200 { "ok": true, "token": "<48 位随机 hex>", "username": "ming" }`
|
||||
- 失败:`401 { "error": "用户名或 PIN 错误" }`
|
||||
|
||||
token 存内存并落盘 `data/sessions.json`(服务器重启后会话仍有效)。
|
||||
|
||||
### GET /api/progress?game=xxx
|
||||
|
||||
读取某游戏的进度数据。
|
||||
|
||||
- 请求头:`Authorization: Bearer <token>`
|
||||
- 成功:`200 { "game": "escape", "data": { ... } }`(无存档时 `data` 为 `null`)
|
||||
- 失败:`401`(token 缺失/无效)/ `400`(缺少 game 参数)
|
||||
|
||||
### PUT /api/progress
|
||||
|
||||
写入某游戏的进度数据(覆盖该 game 键)。
|
||||
|
||||
- 请求头:`Authorization: Bearer <token>`
|
||||
- 请求:`{ "game": "escape", "data": { "summary": "已逃脱 2 次 / 最快 3:25", ... } }`
|
||||
- `game`:1~32 位字母/数字/`_`/`-`;大厅约定用 `_settings` 存用户设置
|
||||
- `data`:任意 JSON 值;大厅卡片会展示 `data.summary` 字符串(若存在)
|
||||
- 成功:`200 { "ok": true, "game": "escape" }`
|
||||
- 失败:`401` / `400`
|
||||
|
||||
## 数据格式
|
||||
|
||||
```
|
||||
web/server/data/
|
||||
├── users.json { "<username>": "<pin>" }
|
||||
├── sessions.json { "<token>": "<username>" }
|
||||
└── <username>.json { "<game>": <data>, ... } 一用户一文件
|
||||
```
|
||||
|
||||
所有写入按文件串行排队(Promise 链),tmp + rename 原子落盘,并发请求不会写坏文件。
|
||||
|
||||
## 静态服务
|
||||
|
||||
- MIME:`.ogg audio/ogg`、`.m4a audio/mp4`、`.js text/javascript`、
|
||||
`.html text/html`、`.png image/png`、`.json application/json` 等;
|
||||
- 目录自动解析 `index.html`;
|
||||
- 支持简化版 HTTP Range(单段 `bytes=start-end` / `start-` / `-suffix`),
|
||||
返回 206 + `Content-Range`,供音频元素拖动进度;
|
||||
- 路径穿越防护:请求路径限制在 `web/` 内。
|
||||
Reference in New Issue
Block a user