engine-* npm dist-tags are unmaintained: engine-2.0 on Toolkit points to an incompatible alpha.0
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
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.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 发布链路核实。
- 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
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di galacean/engine
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 52/100
I maintainer di solito rispondono entro 1 giorno
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
I maintainer di solito rispondono entro 1 giorno
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di galacean/engine
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
e2e-failure ready-to-code
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
I maintainer di solito rispondono entro 1 giorno
-
area: plugins documentation good first issue
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
CatVinci-Studio/Textus#727 ·
I maintainer di solito rispondono entro 1 giorno