К основному содержанию
скилл CX Codex

testing-windows-desktop — скилл для Claude Code: тесты на Windows

Скилл testing-windows-desktop для Claude Code запускает E2E-тестирование десктопного приложения pi-gui на Windows. Проверяет запуск сервера, выбор папок и встроенный терминал.

MIT ★ 364 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add raylee-ai/lancer --skill testing-windows-desktop -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/testing-windows-desktop/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/testing-windows-desktop/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
windows-desktop-e2e affaan-m Скилл windows-desktop-e2e для Claude Code помогает писать и отлаживать E2E-тесты нативных Windows-приложений через pywinauto и Windows UI Automation, включая WPF, WinForms, Win32 и Qt. CX Codex +1 6 400установок windows-git-bash-testing JosiahSiegel Скилл windows-git-bash-testing разбирает падения тестов Vitest, Playwright и MSW, которые случаются только на Windows и в Git Bash: пути, снимки, браузеры. CX Codex +1 164установок windows-release DuskBotAI Скилл windows-release для Claude Code собирает и проверяет Windows-инсталлятор NSIS и portable-архив проекта. CX Codex +1 ★ 567звёзд репо Anode background Windows desktop skulitom MCP-сервер Anode background Windows desktop для Claude Code создаёт скрытый рабочий стол Windows для UI-автоматизации. Агент кликает и делает скриншоты в отдельной сессии, не забирая мышь. CX Codex +1 ★ 14звёзд репо skillshare-windows-utm runkids Скилл skillshare-windows-utm проверяет работу skillshare на гостевой Windows в UTM: собирает коммит в devcontainer, передаёт бинарники в виртуалку и запускает E2E-тесты путей и симлинков. CX Codex +1 ★ 3 269звёзд репо frontend-testing-best-practices sergiodxa Скилл frontend-testing-best-practices для Claude Code задаёт 6 правил тестирования фронтенда: вместо изолированных юнит-тестов компонентов — сквозные E2E-тесты в Playwright. CX Codex +1 2 300установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой