scense/README.md

scense 游戏展示模块（元景 W-08）

功能

游戏列表入口 / 点击开始玩（初始化 W-10 世界运行态进入）/ 暂停 / 继续 / 结束结算 / 重新开始 / 分数结果展示 / 分享链接进入 / 玩中交互（点选移动实体触发脚本逻辑）/ 退出保存进度。

数据表

表	作用	关键字段
game_session	游戏会话	status(created/playing/paused/ended), score, level, elapsed_ms, progress_json, share_token
game_result	游戏结果	session_id, score, duration_ms, level, result_json

会话状态机

• 开始玩：无会话→playing；已有 playing/paused→恢复 playing（续玩）
• playing ⇄ paused（pause/resume）
• playing/paused → ended（end 唯一结算出口，写 game_result）
• 任意状态 → playing（restart 重置分数/关卡）
• save 保存进度快照（不改变状态）

API 端点（wwwroot/game/api/*.dspy，全部 logined）

文件	功能	功能点
game_list.dspy	游戏列表 + 历史会话/结果	W-08a
game_start.dspy	开始玩（进入运行态）	W-08b
game_pause.dspy	暂停	W-08c
game_resume.dspy	继续	W-08d
game_end.dspy	结束结算（写 game_result）	W-08e/g
game_restart.dspy	重新开始（重置）	W-08f
game_share.dspy	生成/解析分享链接	W-08h
game_save.dspy	保存进度快照	W-08j

前端

• game/index.ui — bricks 游戏列表入口页
• game/game_play.html — 全屏游戏页（canvas + HUD + 结算面板 + 交互），验收入口
• game/game.js — 游戏交互（开始/暂停/继续/结束/重开/分享/保存/点选实体）
• game/game_list.js — 列表页渲染

依赖

• W-10 runtime（runtime.js RuntimeEngine，前端运行态，服务端辅助可选）
• world 模块（游戏世界来源，防御式降级独立模式）
• sqlor / ahserver / ServerEnv

集成

1. app/sage.py: from scense.init import load_scense + load_scense() in init()
2. build.sh 安装循环添加 scense
3. scripts/load_path.py 注册 RBAC 路径（禁通配符）
4. global_menu.ui 添加菜单项 {{entire_url('/scense/game/index.ui')}}
5. 部署目标 /d/scense/scense_app：模块 wwwroot 软链接 + pip install -e