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

Aperta
#3,121 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
48/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
github-actions, node.js, typescript
Ambito
devops, release

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

问题

@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 发布链路核实。

Lingua principale
TypeScript
Stelle
5.9k
Fork
413
Merge medio
16h 17m
PR unite (30g)
41

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di galacean/engine

Tutte le issue di galacean/engine

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.