engine-* npm dist-tags are unmaintained: engine-2.0 on Toolkit points to an incompatible alpha.0

Abierto
#3,121 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
48/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
github-actions, node.js, typescript
Área
devops, release

Línea de trabajo

Start by reading the issue’s account of galacean/publish, especially src/main.ts (getPublishTag) and dist/index.js, then inspect the engine repository’s release workflow and how it publishes the listed packages. Decide how engine-* tags should be maintained and ensure the compatible version is discoverable; verify with npm view @galacean/engine-toolkit dist-tags and the corresponding XR package. Done means the tag points to a compatible version or is explicitly removed, with an ongoing ownership or automation mechanism.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

问题

@galacean/engine-toolkit 与 @galacean/engine-toolkit-xr 的 engine-2.0 npm dist-tag 指向 2.0.0-alpha.0,该版本与 Engine 2.0.0-alpha.43+ 不兼容(subShaders.forEach is not a function)。可用版本是 2.0.0-alpha.2,但它只挂在 alpha tag 上。

更根本的问题:engine-* 这条 tag 线没有任何自动化在维护,只能人工设置一次,之后无人推进。1.x 时代因为同 minor 兼容性掩盖了滞后,2.0 alpha 线上滞后直接等于不可用。

现状(实时读取 npm registry)

包 engine-2.0 engine-1.6 alpha latest
@galacean/engine-toolkit 2.0.0-alpha.0 1.6.0 2.0.0-alpha.2 1.6.0
@galacean/engine-toolkit-xr 2.0.0-alpha.0 1.6.0 2.0.0-alpha.2 1.6.0
@galacean/engine-spine 4.2.8 4.2.5 4.2.1-alpha.0 4.2.8

根因

galacean/publish 的 npm dist-tag 由版本号正则推导,只产出一个 tag:

// src/main.ts getPublishTag()
const match = version.match(/-(.*?)(\.|\-)/)
return match ? match[1] : 'latest'    // 2.0.0-alpha.2 -> alpha ; 1.6.0 -> latest

specific_tag 在 dist/index.js 中只作用于 CDN 上传路径段:

const tagOrVersion = specific_tag ? specific_tag : version

因此该 action 既不会创建也不会推进 engine-* tag,它只写 alpha / beta / latest / experimental。engine-* 只能人工 npm dist-tag add,且没有 owner 跟进后续版本。

时间线支持这个判断:

git tag 时间 run 结论
v2.0.0-alpha.0 2026-03-17 success ← engine-2.0 停在这一次
v2.0.0-alpha.1 2026-05-15 failure
v2.0.0-alpha.2 2026-05-18 failure(step Release current monorepo)

alpha.2 的 run 虽然红,但 npm publish 实际已完成:2.0.0-alpha.2 存在于 registry,且 11 个子包全部齐全,说明 pnpm publish -r 跑完了;失败发生在其后的 CDN 上传阶段。也就是说"CI 红 + 包已发"这个状态,让 tag 没有推进这件事没有被察觉。

补充:spine 的 engine-2.0 恰好等于其最新版 4.2.8,说明这条 tag 线并非从未被维护,而是维护到某次就停了。

影响

  • 任何按 engine-2.0 tag 消费 Toolkit / Toolkit XR 的路径都会拿到与 Engine 2.0 alpha 不兼容的版本。
  • galacean/engine#3120 通过显式 pin 绕开了它,但 tag 本身仍是坏源——属于绕过而非修复。
  • 每条新的引擎线都会复现同样的风险。

建议

  1. 止血:把 @galacean/engine-toolkit 与 -xr 的 engine-2.0 指向 2.0.0-alpha.2;或明确废弃该 tag 线并公告。
  2. 收敛为唯一真相:engine-* tag 与显式 pin 目前是两个可以互相矛盾的版本来源。二选一——要么让发布流程自动推进 engine-* tag,要么删掉这条 tag 线、消费侧统一用 pin。
  3. 加门禁:发布产物前断言所 pin 的版本可在 registry 解析,避免 tag / pin 腐烂后静默通过。
  4. (可选)修 alpha.1 / alpha.2 run 中 CDN 上传失败的原因,让"CI 红"重新等价于"没发布成功"。

验收

  • npm view @galacean/engine-toolkit dist-tags 中 engine-2.0 指向一个与当前 Engine 2.0 alpha 兼容的版本,或该 tag 已被明确移除。
  • 存在一条自动或明确 owner 的机制,使 engine-* tag 不会再无限期滞后。

来源:galacean/engine#3120 发布链路核实。

Lenguaje dominante
TypeScript
Estrellas
5.9k
Forks
413
Merge medio
16 h 17 min
PR fusionados (30 d)
41

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de galacean/engine

Todos los issues de galacean/engine

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.