Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

クローズ 初心者向け
#269 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
typescript
領域
cli

調査の方向性

packages/coding-agent/src/step/local-update.tsを読み、findArchiveRootと、アップデーターが展開済みアーカイブからStepバイナリを検索する方法に注目してください。Issueに記載されているWindowsのフラットなZIP構成で再現し、step updateがstep.exeを見つけ、Unixのラップされたアーカイブも引き続き機能することを確認してください。Windowsの自己更新が正常に完了すれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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)

主要言語
TypeScript
スター
1k
フォーク
65
平均マージ
1日 5時間
マージ済み PR(30日)
62

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

stepfun-ai/Step-Code のほかの issue

stepfun-ai/Step-Code の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。