testing-windows-desktop — скилл для Claude Code: тесты на Windows
Скилл testing-windows-desktop для Claude Code запускает E2E-тестирование десктопного приложения pi-gui на Windows. Проверяет запуск сервера, выбор папок и встроенный терминал.
MIT ★ 364 обновлён 2026-11-17
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a claude-codeЧто делает testing-windows-desktop
Скилл выполняет сквозную проверку Electron-клиента pi-gui в окружении Windows. Он запускает приложение командой pnpm --filter @lancer/desktop dev, отслеживает появление сообщений о старте Electron и доступность dev-сервера на http://localhost:5173. При проверке нативного проводника Windows скилл обходит сбои автоматического ввода путей через буфер обмена (Set-Clipboard), сохраняя двоеточия и заглавные буквы.
Встроенный терминал node-pty в живом интерфейсе блокируется без активной сессии, для создания которой требуется настроенный LLM-провайдер. Без внешних ключей скилл запускает headless-тест Playwright в фоновом режиме через хелпер launchDesktop(userDataDir, { testMode: "background" }).
Команды в тестовых сценариях ориентированы на cmd.exe. Для валидации терминала используется echo, поскольку POSIX-утилиты printf и pwd в стандартной оболочке Windows не работают.
Какие задачи решает
- протестировать Electron-приложение pi-gui на платформе Windows
- проверить запуск dev-сервера без ошибок
spawn pnpm ENOENT - обойти потерю букв и двоеточий в системном диалоге выбора папок
- выполнить E2E-тесты терминала node-pty без API-ключа модели
Примеры запросов агенту
- Проверь запуск десктопного приложения pi-gui на Windows через Playwright
- Протестируй встроенный терминал node-pty в фоновом тестовом режиме
- Проверь диалог выбора папок в Windows-сборке @lancer/desktop
Как установить testing-windows-desktop
1Через Skills CLI (Vercel)
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a claude-code2Вручную: положить файлы
~/.claude/skills/testing-windows-desktop/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/testing-windows-desktop/
1Через Skills CLI (Vercel)
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a codex2Вручную: положить файлы
.agents/skills/testing-windows-desktop/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a cursor2Вручную: положить файлы
.cursor/skills/testing-windows-desktop/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install raylee-ai/lancer .agents/skills/testing-windows-desktop2Вручную: положить файлы
.github/skills/testing-windows-desktop/SKILL.md1Через Skills CLI (Vercel)
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a gemini-cli2Командой платформы
gemini skills install https://github.com/raylee-ai/lancer --path .agents/skills/testing-windows-desktopВручную: положить файлы
.devin/skills/testing-windows-desktop/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о testing-windows-desktop
Как установить testing-windows-desktop в Claude Code?
Выполните команду npx skills add raylee-ai/lancer --skill testing-windows-desktop -a claude-code.
Что делает скилл testing-windows-desktop?
Он проверяет совместимость интерфейса Electron с Windows: тестирует запуск рендерера, открытие проводника и выполнение команд в терминале node-pty.
Нужен ли API-ключ для работы testing-windows-desktop?
Для запуска приложения, навигации и headless-тестов Playwright ключи не нужны. Ключ LLM-провайдера понадобится только при проверке сессии терминала напрямую через графический интерфейс.
Исходный текст
SKILL.md · MIT
---
name: testing-windows-desktop
description: End-to-end test the pi-gui Electron desktop app on Windows. Use when verifying Windows compatibility (dev launcher, PATH, folder picker, integrated terminal / node-pty) or any apps/desktop change on Windows.
---
# Testing the pi-gui desktop app on Windows
## Setup
- Ensure pnpm is available: `corepack enable` then `corepack prepare pnpm@<version from package.json> --activate`.
- Install: `pnpm install` (repo root).
- Launch the app for GUI testing: `pnpm --filter @lancer/desktop dev`. Optionally set `PI_APP_USER_DATA_DIR` to an isolated temp dir.
- A working launch prints `starting electron app...` and the renderer dev server (`http://localhost:5173`) and must NOT print `spawn pnpm ENOENT`.
## What renders where
- Empty state: sidebar (New thread / Threads / Skills / Extensions / Settings) + "Open a folder to start".
- Navigation (Settings / Skills / Threads) is a good cheap proof the renderer is interactive.
## Integrated terminal (node-pty / ConPTY) — IMPORTANT gotcha
- The Terminal item in the Open side panel menu is disabled until there is an **active session**: `terminalAvailable={Boolean(selectedSessionKey)}` in `apps/desktop/src/app/App.tsx`.
- Creating a session through the live UI requires a **connected provider/model**. Without provider credentials you CANNOT reach the terminal via the GUI ("No models available" blocks send).
- Workaround that needs no credentials: run a **headless Playwright spec in background test mode**. Use helpers from `apps/desktop/tests/helpers/electron-app.ts`: `launchDesktop(userDataDir, { initialWorkspaces, testMode: "background" })` -> `createNamedThread(window, ...)` -> open Terminal from the Open side panel menu (or press Ctrl+J) -> type a command -> assert `.xterm-rows` text.
- Use a **cross-platform command**: `echo <marker>` works in both `cmd.exe` (Windows default shell via `defaultShellForPlatform()`) and POSIX shells. The existing `tests/core/integrated-terminal.spec.ts` uses `printf`/`pwd`, which do NOT exist in `cmd.exe` — that lane runs on Linux and macOS CI only, so don't expect it to pass as-is on Windows.
- Run a single spec: `pnpm --filter @lancer/desktop run test:e2e:runner -- apps/desktop/tests/core/<spec>.spec.ts`. Delete any temporary spec you add after the run.
## Native Windows folder picker
- "Open first folder" opens the real Windows folder dialog (itself a Windows-compat proof).
- Computer-use `type` action may DROP uppercase letters and `:` in the dialog's path field (e.g. `C:\Users\Administrator` becomes `\sers\dministrator`). Workaround: put the path on the clipboard (`Set-Clipboard -Value "<path>"`) and `Ctrl+V` into the Folder field, then Select Folder.
## Cosmetic (not functional) macOS-centric labels on Windows
- Settings shortcut hints may show `Cmd+…` and the integrated-terminal shell field placeholder may read `/bin/zsh`. Display-only; the actual default shell resolves to `cmd.exe`.
## Reporting
- Record GUI interactions with annotations (setup / test_start / assertion). Do not record shell-only runs.
- Mark the live-UI terminal test `untested` (not failed) when blocked by missing provider credentials, and note the headless spec result separately.
## Devin Secrets Needed
- None required for launch / navigation / folder picker / headless terminal test.
- A provider API key (e.g. an LLM provider configured under Settings > Providers) is required only to create a session through the **live UI** and thus exercise the terminal through the GUI.
© raylee-ai · MIT · raylee-ai/lancer