engine-* npm dist-tags are unmaintained: engine-2.0 on Toolkit points to an incompatible alpha.0
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
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.0tag 消费 Toolkit / Toolkit XR 的路径都会拿到与 Engine 2.0 alpha 不兼容的版本。 - galacean/engine#3120 通过显式 pin 绕开了它,但 tag 本身仍是坏源——属于绕过而非修复。
- 每条新的引擎线都会复现同样的风险。
建议
- 止血:把
@galacean/engine-toolkit与-xr的engine-2.0指向2.0.0-alpha.2;或明确废弃该 tag 线并公告。 - 收敛为唯一真相:
engine-*tag 与显式 pin 目前是两个可以互相矛盾的版本来源。二选一——要么让发布流程自动推进engine-*tag,要么删掉这条 tag 线、消费侧统一用 pin。 - 加门禁:发布产物前断言所 pin 的版本可在 registry 解析,避免 tag / pin 腐烂后静默通过。
- (可选)修
alpha.1/alpha.2run 中 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
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de galacean/engine
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
Los mantenedores suelen responder en 1 día
-
Dificultad 4/5 3-5 días Aptitud para principiantes 52/100
Los mantenedores suelen responder en 1 día
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipPosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abierto
Dificultad 5/5 Más de una semana Aptitud para principiantes 20/100
Los mantenedores suelen responder en 1 día
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinPosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abiertoenhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 42/100
Los mantenedores suelen responder en 1 día
Todos los issues de galacean/engine
Issues similares
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
elastic/kibana#306401 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
agentes-chat/agentes-chat#927 ·
Los mantenedores suelen responder en 1 día
-
[Bug]: Webapp workspace fails to render in Safari — "Can't find variable: requestIdleCallback"Abiertocomp/desktop P2 type/bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
NousResearch/hermes-agent#157702 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Los mantenedores suelen responder en 1 día
-
e2e-failure ready-to-code
Dificultad 1/5 Menos de una hora Aptitud para principiantes 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 comentario ·
Los mantenedores suelen responder en 1 día