Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#269 1 comentario 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
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
typescript
Área
cli

Línea de trabajo

Lee packages/coding-agent/src/step/local-update.ts y céntrate en findArchiveRoot y en cómo el actualizador busca el binario de Step en los archivos extraídos. Reproduce el problema con la estructura ZIP plana de Windows descrita en el issue y luego verifica que step update encuentre step.exe mientras el archivo Unix con directorio contenedor siga funcionando. Se considera terminado cuando la actualización automática de Windows se complete correctamente.

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

Descripción

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)

Lenguaje dominante
TypeScript
Estrellas
1k
Forks
65
Merge medio
1 d 3 h
PR fusionados (30 d)
70

Preparar el entorno

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 stepfun-ai/Step-Code

Todos los issues de stepfun-ai/Step-Code

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.