Repository navigation
Pelican Engine 2.0.0
兼容性与迁移
- 默认渲染和 renderQuality()/realtime 改为 raster;显式 high/path、medium/hybrid 和 capture 继续保留,追踪仍要求真实 WebGPU。光栅是默认选项,不代表降低资产、分辨率、IBL 或阴影质量。
- CLI 保留原 JSON 信封和 --json 兼容参数;退出码统一为 0 成功、1 用法错误、2 检查/断言失败、3 环境问题。取消与超时归为环境问题;依赖所有失败均为 1 的脚本需要调整。开发态连续事件按 JSON Lines 输出。
- 升级游戏时安装精确版本 pelican-engine@2.0.0,先运行 pelican migrate 查看版本锁迁移,再显式 migrate --apply --from 1.9.0,重新 check、verify 和 build。migrate 只调整项目锁,不自动迁移存档或证明运行兼容。
- 跨版本存档仍遵守引擎版本、作者默认值和资源契约;不静默把旧 path 存档改成 raster,不兼容恢复保留当前世界。渲染子快照仅对新增可选 AO 字段提供兼容填充,不代表旧完整存档可以跨主版本直接恢复。
AI 作者闭环
- 新增 guide --compact 的受限体积项目摘要、任务目录分页与精确续查;保留完整查询,游戏 AGENTS 路由从同一任务元数据生成。未知查询返回导航候选,不推断为功能不支持。
- inspect 支持摘要和字段选择,区分不可用与截断;diagnose 使用精简资产身份,修复分页丢失 compiledIR 导致重复资产检查失效。内存已知量不冒充总显存。
- 从命令协议生成本地 HTTP 参考;显式不兼容版本稳定拒绝,旧请求兼容,保留 loopback/Host/Origin 与生产禁用边界。
- capture --facts 提供最终显示像素亮度分布、暗像素/饱和比例和显示动态范围,附色彩空间、阈值与证据哈希;不把暗画面直接判错。未指定截图模式时尊重作者设置。
- pelican verify 提供独立 headless 项目冒烟和 13 条共享配方验收;模型材质槽/动画与真实交互音频配方附小型 CC0 资产、SHA-256 和安全复制。CI 与作者复用同一验收实现。
- 作者评测扩为 14 个固定任务,分开记录首次 check 与完整验收、重试、查询体积、命令和 batch 操作成本;无宿主 token 或外部 AI 记录时保留未知,不宣称达标。
- 增加显式开启的有界开发态系统/受管写入追踪与受控截图容差基线;不追踪任意 JS 赋值、不承诺跨设备逐像素一致。
光栅画质
- 保留原生 DPR、studio IBL、4096 阴影和设备各向异性过滤;WebGPU 内置光栅增加全分辨率 32 样本 GTAO 与深度/法线约束过滤,仅调制间接光。固定空间采样避免依赖运动历史。
- rasterAmbientOcclusion:false 可关闭新增效果;WebGL2 使用标准 PBR 光栅,启用自定义后处理时由作者管理呈现。生命周期覆盖场景替换、相机变化、设备恢复和销毁。
- 屏幕空间遮蔽不等于离屏全局光照、真实反射或硬件 RT,不据此宣称所有场景达到 AAA。浏览器版依然是软件 BVH;硬件光追仍为未来原生后端计划。
验证边界
- 发布候选在 Windows/Node 24、真实 NVIDIA WebGPU 上执行类型、单元、npm 安装、13 条配方、40 项浏览器组合及 GPU 部署冒烟;三平台发布检查由 CI 执行并保留真实结果。
- 新的外部 AI 宿主评测、移动端实机和未开启的专项 opt-in 测试不算作已通过;首次完整成功率与 token 目标仍待验证。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@2.0.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:040dd2cda39e200930bf6254d5482aa585fbd2c7。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。