Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

[Bug] step update fails on Windows with "release archive does not contain the Step binary"

Fermée Adaptée aux débutants
#269 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
78/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
typescript
Domaine
cli

Piste de recherche

Lisez packages/coding-agent/src/step/local-update.ts, en vous concentrant sur findArchiveRoot et sur la manière dont le programme de mise à jour recherche le binaire Step dans les archives extraites. Reproduisez le problème avec la structure ZIP Windows plate décrite dans l’issue, puis vérifiez que step update trouve step.exe tandis que l’archive Unix avec son répertoire conteneur fonctionne toujours. Le travail est terminé lorsque la mise à jour automatique de Windows s’effectue correctement.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

What happened?

step update always fails on Windows, after the download and checksum
verification have already succeeded:

$ step --version
0.1.4
$ step update
Step update failed: release archive does not contain the Step binary

Impact: Windows users cannot self-update at all — every release from 0.1.2
through 0.1.5 fails the same way — and have to reinstall manually every
time there is a new version.

Root cause: the two platforms ship different archive layouts. The Windows
step-*-windows-x64.zip is flat (step.exe at the archive root), while the
Unix step-*-linux-x64.tar.gz is wrapped in a top-level step/ directory.
findArchiveRoot in packages/coding-agent/src/step/local-update.ts assumes
the wrapped layout and picks the first subdirectory it sees — which is docs
on Windows — so the search for step.exe is confined to docs/ and never
finds it.

Steps to reproduce
  1. Install the native Windows build (0.1.2 / 0.1.3 / 0.1.4 all affected).
  2. Run step update.
  3. Observe the failure above. Fresh installs via install.ps1 are fine —
    only the self-update path breaks.
Image
Expected behavior

step update completes successfully on Windows, same as on Unix.

Version

0.1.4 (Windows 11 x64, native install; update target resolved from
latest.json is 0.1.5)

Langage dominant
TypeScript
Étoiles
1k
Forks
65
Merge moyen
1 j 3 h
PR mergées (30 j)
71

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de stepfun-ai/Step-Code

Toutes les issues de stepfun-ai/Step-Code

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.