# 五款 Demo 合作讨论包 · 部署说明

1. 解压 ZIP。把包含 `index.html`、`play.html`、`catalog.json`、`art/`、`demos/` 的**整套文件**上传到同一个静态网站目录，保持相对结构。
2. 打开该目录的 HTTP/HTTPS 地址。支持网站根目录，也支持 `/review/collection/` 等多层子目录；目录地址末尾应有 `/`。不要用 `file://`，不要只上传入口 HTML。
3. 不需要 Node、数据库或业务后端运行游戏。服务器需正确提供 `.js/.mjs` 为 JavaScript、`.wasm` 为 WebAssembly MIME；不要把资源 404 全部重写成首页 HTML。
4. 入口 → 任意卡片 → 说明 → 进入 Demo。顶部可返回目录、重新查看说明、独立打开或全屏（浏览器支持时）。独立页面用浏览器返回回到入口；这是兼容性备用入口，不自动迁移未保存的局。
5. `proposal.html` 是合作总方案，可在浏览器打印为 PDF；`PRODUCT_PROPOSAL.md` 是同源文本。`release-manifest.json` 记录构建、版本和逐文件 SHA-256；许可见 `THIRD_PARTY_NOTICES.txt`。

## 更新与缓存

从源码仓库运行统一打包命令，得到新版本目录与 ZIP。推荐先上传完整的新版本目录，验收五个入口后再把对外链接切到新目录；不要在有人试玩时先删旧资源再覆盖。保留上一版本便于回退。

入口、catalog、普通命名的展示 JS/CSS 和清单应使用短缓存或 `Cache-Control: no-cache`；游戏带 Hash 的资源可长缓存。平台若有 CDN，要更新入口缓存。当前无 Service Worker。

## 试玩与访问边界

- 本包是合作讨论原型，不是正式产品验收。人物线索当前R3技术验收通过，但13关仍为内部候选，人类难度与真机证据待补；上传网站不改变内容审核状态。
- 候选美术包装尚未制作；人物线索已有十题材文本关，仍使用程序化占位图。入口插图是机制示意，不是游戏截图。无联网账号、远程统计、广告或支付。
- 游戏存档由各自原逻辑处理。箭头、人物线索、齿轮使用本地存储；归线与骰子未提供跨刷新续局。清浏览器数据、换设备或域名会影响存档；同源不同版本可能共享游戏存档，不应同时在多个窗口改同一局。
- 无登录或访问控制，知道网址即可访问。页面 `noindex` 仅请求搜索引擎不索引，不是权限保护；保密分享请在托管层设置访问控制。服务提供方可能记录访问日志，本包本身不主动上传游戏行为。
- 允许同源 iframe 运行；托管层不要设置会禁止同源嵌入的策略。设置 CSP 时需允许本地模块、游戏 Worker 与原有样式；不要未经测试加入严格 CSP。独立打开可用于排查嵌入限制。
- 当前生产 QA 的设备/范围见源码仓库 `showcase/STATUS.md`，不把模拟触控当真机，也不把自动清关当玩家理解。

本说明只交付部署方法；本轮未上传任何外部网站。发布者仍需确定域名、托管权限、保密范围，以及对素材/第三方许可的最终使用审核。