FAQ 与证据边界
本页与版本基线配套,回答固定模板及模块的采用问题,不提供全组合运行通过结论。模板基线为 be4326b5b47794328accc120b6e250497af37191;实际包与消费者情况以各自精确版本和回执为准。
模板能读、能生成,是否已采用成功?
生成器输出 generated-review-artifact,保留完整 client/config 源和回执;它不取证包解析、配置导出、Unity 冷导入或玩法运行。真实采用还需要接收项目和同次请求的实际证据,资源可读也不等于获准使用。完整请求结构与失败接手见新项目指南。T2
选 minimal 是否会得到最小项目?
不会据 Profile 自动裁剪。catalog 当前为 catalog-only,生成请求没有 Profile 字段。模板仍按现有 DefaultGameModuleFactory 和 TemplateGameplayModeFactory 登记运行;裁剪前应隔离场景、prefab、生成代码和 asmdef 引用。相关归属见架构扩展。T3
readiness 写 closed,为什么还需要验收?
closed 记录声明入口、规则、UI、失败路径和 gate 存在。该文件没有提供当前消费者 job 的执行结果;它也不证明产品 SDK、包获取或资源使用授权。Ad、Analytics、GM、Ranking、Shop 声明为 external-required,不能统称业务闭环已完成。T3 T4
Static 绿灯是否证明模板启动、APK 或消费者组合通过?
固定 README 明确该模板仓库 CI 所有场景只做 Static;运行时、NewProject、APK、产品回归、Airtest 的通过需独立外部流程证据。TEMPLATE_FULL_VALIDATION=1 不会增加该仓 CI 阶段。没有对应回执就保留缺口;消费者采用自己的仓库验证规则,本页不对所有项目施加统一执行环境限制。交付结果如何分别记录见发布与升级。T1 T2
framework 2.8.45 能否直接替换模板的 2.8.38?
现有材料不能确认。模板 manifest 锁 2.8.38,已读框架源声明 2.8.45;缺两版本 API/editor/runtime diff、CHANGELOG 和发布产物映射。不要把 2.8.45 的接口文档倒推为 2.8.38 保证,详见版本基线和框架配置/资源API。
为什么 Feature 1.0.0 不能替代主包 1.1.0 / 1.1.1?
它们是不同产物身份。Feature 的 package.json 位于 DevTools 模块路径,模板 manifest 依赖 libgameplay 主包。当前材料缺 module-dashboard source-to-dist、module-manager 导入和实际安装映射;不能由相近名称推定独立 Feature 已被主包或模板自动消费。版本号不能替代包内容和来源回执。
Energy 本地命令创建成功是否代表支付到账?
不能。TryCreateFreeAdCommand() / TryCreatePaidCommand() 使用调用者提供的快照;真实支付、广告和服务器权威结果由产品 gateway/provider 决定。具体输入、计数、同步返回与异步完成及刷新边界见Energy 指南。模板自身 EnergyModel 与独立 Feature 的模型也应区分。
SpellIndicator 显示了范围,是否已经命中或结算?
不能。产品负责战斗规则、镜头坐标转换和服务器结算。固定 Controller 的 IsWithinEffectiveArea 恒为 true,Show/UpdatePosition 不自动 clamp;消费者需要显式计算所需约束位置后显示。接口、首次显示顺序及释放边界见SpellIndicator 指南,不能由 activeSelf 或几何显示推定实际命中。
配置导出失败应该提供什么?
提供实际固定 config 源、有效 Luban 配置/工具版本、导出入口和参数、源表及语言输入、导出物摘要、客户端资源/程序集引用和对应 job。仅有 scripts/verify.sh 或说明文字不是导出链可用证据。config 的缺口目前来自固定模板指南的调查记录,本文没有该仓原文件的独立复核,不能给出已核实修复命令。T2
模板生成超时后能否重跑同目标?
模板生成器拒绝已有输出。publish 阶段失败可标记 publication-outcome-unknown;先读目标及现存回执,核对 input/content 摘要,再接受现存成果或提交关联原请求的新请求和新目标。不要把返回失败或超时自动当作没有产生输出。其他工具的重试应遵循其各自结果确认机制,不能套用覆盖重跑。T2
没有内网权限或资源许可时如何阅读?
下列固定来源是内部定位链接,需要原仓网络和账号权限,不是公开下载入口。正文保留了主要字段和步骤;包 registry 使用 owner 为消费者提供的地址。资源可读不授予生产使用或再分发权限,本文不包含飞书正文或美术资产。当前版本、安装、运行和权利未确认的项可明确保留,不能编造成功声明。
固定来源
以下是内部固定来源,需要原仓内网和账号权限,公网读者不能保证可访问。链接保留仓库身份、完整 SHA 和相对路径供定位,不授予访问或资源转用权限;正文已独立说明所需字段与使用边界。