# pbl_scense_ext 模块技能（自动生成骨架 + 人工补充）

## 定位
scense/scense_game 前端覆盖层与页面注册（M9）

## 挂载
`from pbl_scense_ext.init import load_pbl_scense_ext` → `load_pbl_scense_ext()`（应用 app/pbls.py init() 中按序调用）

## 数据表（3 张）
- `pbl_session_member`：会话成员（复用 world_session，不污染基表）
- `pbl_playtest_feedback`：Playtest 反馈/反思（reflection 走证据链外的轻量表）
- `pbl_ui_page_registry`：前端覆盖层页面注册（12 页面 + 时延预算）

## 契约接口（4 个，路径 `/pbl_scense_ext/api/<name>.dspy`）
- `pbl_session_context_get`
- `pbl_page_registry_list`
- `pbl_playtest_feedback_save`
- `pbl_overlay_bootstrap`

## 陷阱
- 库名一律 `ServerEnv().get_module_dbname('pbl_scense_ext')`，禁止硬编码 DBNAME。
- sqlor 只有 `C/U/D/R/I/sqlExe`；查询走 pbl_common.api 的 q_all/q_one（已适配）。
- 所有读写强制带 `tenant_id`（pbl_common.api.tenant_id()），缺失即 fail-closed 报错。
- 新增契约需同步三处：api.py 定义 + __init__.py 导出 + init.py env 注册 + scripts/load_path.py 路径。