Repository navigation
Releases
Pelican Engine 2.0.0
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 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.9.0
Pelican Engine 1.9.0
- 启动 HTML 自带可见加载界面、失败重试和首帧状态;新增 engineStartup/onEngineStartup 供第三方 UI 订阅。下载按无进度截止,模块和解码错误与 GPU 超时分开,模型与纹理并发准备。
- 追踪按实际视觉变化更新,不再因仿真 tick 推进而重新捕获静态场景;受验证的几何、遍历和运动数据使用持久增量打包,发光面面积缓存独立于发光强度。
- 动态发光和灯光通过有界、裁剪的重投影历史保留细节;不兼容材质、纹理、模式和内容仍使历史失效。首命中直接光按全部技术评估并同步 MIS 概率,减少多灯选择方差。
- PATH 保持原生分辨率,画质优先默认 4 采样/8 反弹;HYBRID 使用光栅首命中与独立的 2 采样/4 反弹预算。没有自动降低分辨率或删减场景;作者显式设置继续生效。曝光调整不再清除线性累积历史。
- 新增 pelican diagnose 与纯数据 diagnoseRendering,输出帧处理、历史、上传和重复资产的原因与修复建议;pelican assets 分页查询真实资产和 GLB 材质槽。补齐中文动态画质/性能任务发现、startup-feedback 与 npm-geometry 完整配方。
- README 明确硬件光追仅为原生后端未来计划;浏览器版仍是 WebGPU 软件 BVH,不宣称使用 RT Core,也不宣称全面超过 Three.js 或完成移动端验收。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.9.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:ee758672d21419f34e8b544ea8c4f663fe2aa764。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.8.0
Pelican Engine 1.8.0
- 默认渲染改为高档 path,启用时域与空间降噪、每帧2采样、8次反弹;medium/preview 为 hybrid,low 为关闭追踪降噪的 raster。realtime 现在别名高档,capture 保留4采样/12反弹的未滤波路径追踪。现有显式 render 配置继续有效。
- 启动可用明确的 quality=high/medium/low URL 选择;默认 path 需要实际 WebGPU,WebGL2 不静默降级,显式 low 可使用光栅后端。单独切换 raster 时,未指定 denoise 则关闭该追踪功能。
- 启动选档与作者默认值分离,换启动档不会错误改变存档兼容契约;恢复仍保存当时的渲染设置并重新验证实际后端,失败保留旧世界。
- 新增 RenderService.prepare/preparation 与 pelican prepare-render,在帧边界准备管线/场景资源,不切档、不推进玩法;状态可查询、失败可重试,内容/视口/设备重建失效。缓存保留可能继续占用显存,不承诺预热零停顿。
- 正常游戏不再初始化无用的历史 M0 GPU 追踪侧车;预热和两种追踪模式复用现有受管管线。
- 优化动态几何:仅对受验证来源和稳定身份顺序复用索引,BVH 重拟合只重算变化叶子及祖先;运动历史复用稳定顺序与上一渲染版本。外部数据、稀疏/重复顺序、拓扑与非有限值保留校验。
- 优化非透射场景的介质扫描、材质 UV 通道验证、紧凑遍历打包和按32位精确位模式比较的脏上传;无降分辨率、无删除模型或以软件结果替代真实 GPU。
- 新增完整 render-quality npm 配方和真实安装包高模/动画/移动镜头/1080p 探针,覆盖准备、三档切换、存档和资源生命周期。高/中/低是画质选择,不保证所有场景都按同一顺序耗时,也不以短测宣称达到固定帧率或3A上限。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.8.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:56f5707a30cc33340c8544b13f6d6b1bc01f6dfa。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.7.0
Pelican Engine 1.7.0
- 补齐任务发现覆盖:精选任务之外,全部现有能力从同一能力元数据派生入口;正确关联实例组合、具体传输适配、动态资源和画质预设。紧凑入口标记目录截断,匹配不冒充整句需求全部支持。
defineGameRuntime<State, Dependencies>支持 setup 返回类型化、每实例独立的临时依赖,系统直接接收,无需全局变量或将第三方对象塞进 JSON;保留保存校验、清理契约和旧用法。- 新增
loadRuntimeBytes,与 JSON 共用流式字节预算、超时与取消;新增完整 npm-component 和 dynamic-texture 配方,演示真实 npm 往返、浏览器资源、PNG 解码尺寸预算和受管纹理保存恢复。 - 统一编译报告与浏览器的迭代兼容策略,不再仅因组件 schema 相同就错误承诺资产/版本/声明可保留状态。
- 修复独立 npm AI 试验暴露的程序化几何启动失败:声明结构与数值分开验证,容忍极小跨运行时浮点尾数差异,仍拒绝结构、ID、离散整数和明显数值漂移,不修改作者网格。
- 启动失败保留脱敏的底层错误码和针对性修复建议;明确画布 pointer 注入不等于 DOM 按钮点击。
- 新增从原始 CLI 日志派生作者评测指标的工具,区分首次检查、首次浏览器结果、重检与修复、命令耗时与任务总耗时。画质对比增加明确热态时间预算及实际超预算报告,不作全引擎画质上限断言。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.7.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:ad84a27864f2533e25b00253bf037096ddcc8ece。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.6.0
Pelican Engine 1.6.0
- 新增任务级发现:完整中英文目标定位能力、精确方法、配方与验证步骤;未知任务、API 和能力查询提供同源导航候选,不把未匹配伪称为不支持或已支持。
- 新增
defineGameRuntime,系统声明一次、每实例 JSON 状态与完整保存 hooks 自动组合;新增scope.cleanup可提前幂等释放,原有 runtime/own/listen/defer 保持兼容。 - 新增标准
createWorkerAdapter/createWebSocketAdapter,复用有界队列、协议校验与 owned/borrowed;新增loadRuntimeJSON的流式字节预算、超时、取消与作者校验。 - 新增完整
third-person(移动、跳跃、跟随、存读档)和dynamic-resources配方,现有 Worker/WebSocket 配方改用具体适配器,npm 算法与低级扩展协议仍可自由组合。 - dev 对声明兼容的逻辑改动事务式替换实例并恢复完整状态;失败保留旧实例,不兼容改动明确要求重启。新增
pelican reload [--restart],不伪称任意资产/schema 可无损热更新。 - 默认 studio IBL(可关闭或由作者环境替代)、4096 投影阴影图、设备支持的各向异性过滤;
renderQuality提供 realtime/preview/capture。默认追踪预算提高为 2 samples/frame、8 bounces;预览/捕获需 WebGPU,光栅不使用追踪预算。显式作者设置保留。 - 同步 npm AI 入口、能力、配方和方法索引,清除图形/动画/过场指南中的过期编译期限制。历史版本记录不是当前开发约束。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.6.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:799763b0195bdddf3fdb17c1fb50a1d7bd1e2e8f。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.5.0
Pelican Engine 1.5.0
- 新增
createRuntimeAdapter:普通 Worker、WebSocket 或 npm 客户端通过自己的 send/subscribe/decode 接入,不强制通信协议或内置玩法模型。 - 明确 owned/borrowed 端点身份、跨实例/编译 SDK 副本的所有权检查、有界消息队列、同步消费、故障诊断及提前释放。外部对象和消息不自动进入存档/确定性回放。
GameRuntimeScope.own(resource, release)支持不带 dispose() 的原生或第三方对象;scope.listen随实例管理 EventTarget 监听,支持提前注销、once 和取消。- 修复标准模块 Worker 编译链路:保留分包和相对 URL、独立类型检查、源映射及依赖/产物指纹,避免主模块通过但 Worker 文件丢失。
- 新增完整
external-adaptersnpm 配方:真实 Worker 计算、可选 WebSocket、受管渲染缓冲更新和版本化作者状态,恢复时隔离旧 Worker 请求。 - 普通 JSON 的非函数 then 字段不再被误认成异步结果;检测不会执行 then getter。
- 能力目录、AI 起步和扩展指南补齐外部适配路径,清除后端指南中与现行测试规则冲突的历史授权说明。保留 GPU/物理/场景/保存恢复检查,不开放私有对象捷径。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.5.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:0e06001a061b450689919819c4b9343af99d994b。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.4.1
Pelican Engine 1.4.1
- 精简 README:保留鹈鹕标识,移除渲染实图、多余徽章、长代码和表格,聚焦核心优势、快速开始与 AI 起步。
- npm 首页沿用同一份精简文案;详细用法保留在开发与扩展指南,不改变引擎功能。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.4.1
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:1bde25c99428b2baa643df925d57f7cb7dce64f2。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.4.0
Pelican Engine 1.4.0
- 重做 README 项目门面:保留鹈鹕标识,增加实际渲染预览、npm/CI 徽章、能力概览、可编译的 TypeScript 内容组合示例和扩展导航。npm 首页从同一 README 派生。
- 明确普通 TypeScript、游戏自有 npm 组件和自定义模块是正式创作方式;内置玩法服务可选,浏览器依赖使用每实例生命周期与显式保存协议。
- 新增
pelican guide [--goal <中英文关键词>],返回当前版本的紧凑工作流、依赖/状态/扩展规则和来源一致的能力、配方与方法查询入口。 capabilities增加可选摘要、分页和 nextOffset;保留原完整响应兼容。新建游戏与 npm 包的 AGENTS、llms.txt 同步引导低成本查询,不将一次空搜索当作能力缺失。- 主线发布在三平台 CI、npm OIDC 发布和注册表字节核验之后自动同步 GitHub Release;版本标签绑定明确源提交,拒绝移动既有标签。
- 增加冷启动上下文、能力摘要/分页、README 实编译、npm 安装和 Release 同步回归。上述工具增强不代表模型已训练掌握引擎或所有冷启动任务一次成功。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.4.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:9972a4f88ef36d96c451ae57cdcd45b927c9f0b4。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.3.0
Pelican Engine 1.3.0
-
实时音频回归按实测 AudioContext 时钟检查淡出包络,并加入延迟采样;不把操作系统定时器准时执行作为通过前提。
-
修复 Windows 跨盘游戏的共享 runtime 源映射;仅允许选定引擎根内的稳定路径。API 索引统一换行,避免跨平台查询签名差异。
-
恢复鹈鹕图标与 README 项目展示,npm 包同样提供图标、价值说明和独立游戏开发入口。
-
发光面使用 alias sampling 与三角形索引 PDF,显式灯光不再重复扫描整张发光三角形表;缓存静态发光元数据。
-
保留不可变提取几何的私有 provenance,减少重复验证;缓存几何打包与身份,按脏块更新 GPU 数据,保持外部输入和失败恢复检查。
-
新增每实例 runtime.create、就绪状态、own/defer 生命周期、版本化状态 hooks,接入 Host 快照、恢复、回放与失败回滚;检查构建和浏览器定义漂移。
-
新增 BufferGeometryInput、normal/roughness/metalness/AO/emissive 贴图与 normalScale;新增 API v1 受管渲染扩展组合。
-
物理后端改为异步加载,支持 auto/required/disabled 计划;保留空世界查询及明确的需求冲突诊断。
-
CLI 支持常见 --help/-h 与 --version/-v 入口,保持 JSON 协议。
-
补全能力目录和中英文别名;API 支持成员检索、精确 Type.member、相关性排序及 total/truncated。新增多文件 runtime 和受管渲染配方、llms.txt 与依赖接入指南。
-
增加跨平台生成目录清理工具、同资产 npm 渲染对比与独立 AI 作者评测记录器。运行输出不提交源码仓库。
-
浏览器场景切换与读档等待异步作者实例就绪;Windows 构建目录重命名对短暂共享锁进行有界重试,保留失败恢复路径。
-
自动化工具默认使用完整无界面 Chromium,保持实际 GPU;就绪检查不依赖 RAF 或桌面焦点,增加无焦点/禁用 RAF 的实际安装包复跑。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.3.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:d2ccc29ccd369a2485a1e6520018d8a653a8d7bf。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。
Pelican Engine 1.2.0
Pelican Engine 1.2.0
- 游戏开发统一使用 npm;仓库只供引擎贡献者,当前树不再保存历史证据、阶段任务、旧源码 ZIP 发布工具和重复生成文档。
- 新建 npm 项目使用普通 TypeScript 内容构建,支持循环、类、闭包和正常项目依赖;原有静态模式保留兼容。可信内容在独立进程执行,提供截止时间和结构化失败。
- doctor/setup 使用 Node 跨平台能力,浏览器参数按系统选择,移除 PowerShell bootstrap 与脚本依赖;CI 覆盖 Windows、Linux、macOS,检查完成后发布实际测试的 tarball。
- 修复相对引擎路径在 macOS
/var别名及不同深度目录别名下的解析,保留路径身份检查;剪贴板自动化使用系统主修饰键。 - 静态模块缓存仅在 Windows 忽略路径大小写;普通内容跟踪 workspace 依赖、声明及包 exports 的变化。
- 开发和生产默认隐藏技术 HUD,使用
?diagnostics=1显式开启,避免遮挡游戏界面和截图。 - 修复 POSIX 下 npm exec 开发服务停止后遗留子进程与管道,安装回归等待进程树完全关闭。
- npm 包仅附带游戏作者需要的指南与机器契约;注册表传播等待延长,传播失败不触发盲目重复发布。
使用 npm 开发游戏
npm --prefix . install --save-dev --save-exact pelican-engine@1.2.0
npx pelican dev无需克隆引擎仓库。普通 TypeScript、游戏自有 npm 依赖与自定义模块可自由组合;私有 GPU/Three.js/WASM 对象不构成稳定插件协议。
源提交:463718a01742f8785ec9b2353bf2e62de2e5d3b2。分发以已核验的 npm tarball 为准;GitHub 自动源码归档面向引擎贡献者,不是游戏安装入口。