CRT/storebound
1
0
Fork 0
Code Issues Pull requests Releases 1 Packages 1 Activity Actions

Windows: MCP entries start through cmd /c npx or bun cli/index.ts (npx.cmd and the sh launcher cannot be spawned, pitfall 94); desktop download streams with progress and fails after 60 s without data (pitfall 95); getting-started Windows note

Browse source
This commit is contained in:
CRTkafa 2026-10-21 22:21:49 +08:00
parent e5dffb5533
commit 0ac3cd02b0
6 changed files with 77 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
skills/store-pitfalls/SKILL.md
View file

@ -1148,3 +1148,21 @@ that fails without the fix (see CONTRIBUTING.md).
`cli/shots/lib.ts`) and exits 1 if any file failed to load while rendering; `shots check` and `validate` raise a
`frame-missing` error for every render whose report entry has failed loads (`cli/shots/report.ts`,
`tests/shots-missing-frames.test.ts`).
## 94. The MCP server never starts on Windows (`npx` as the stdio command)
- **Symptom:** the agent shows the `storebound` MCP server as "failed" / "connection closed" on Windows; the same
entry works on macOS and Linux. An old entry pinned to an old version (`storebound@0.8.2`) also hides new tools.
- **Cause:** on Windows `npx` is `npx.cmd`, which an MCP client cannot spawn directly as a stdio command; the
`bin/storebound` launcher is a /bin/sh script and cannot be spawned either.
- **Do:** use `{"command": "cmd", "args": ["/c", "npx", "-y", "storebound@<version>", "mcp"]}`, or re-run
`storebound install --agent <agent>`, which writes that form (or `bun <toolchain>/cli/index.ts mcp`) on Windows. Keep the version current.
- **Guard:** `winWrap` / `mcpCommand` in `cli/install.ts`, `tests/wave1.test.ts`.
## 95. `storebound desktop` stayed on "downloading ..." forever
- **Symptom:** `npx storebound desktop` printed `downloading storebound_<v>_x64-setup-unsigned.exe (37.0 MB)` and
then nothing, for many minutes.
- **Cause:** the installer was not in the CDN cache yet (`cf-cache-status: MISS`) and the origin sent no bytes; the
CLI read the whole body at once, with no progress and no timeout.
- **Do:** run the command again later; after a release, warm the CDN cache by fetching every installer once.
- **Guard:** `download` in `cli/desktop.ts` reads in chunks, prints progress every 10 % and fails after 60 s without
data (`tests/desktop-dist.test.ts`).