菜单
Sets up and runs Fantasia Archive locally using Yarn, Node.js 22.22 or newer, and Quasar Electron mode. Use when installing dependencies, choosing dev vs production build commands, or when the user mentions environment setup, CLI, or first run.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Runs and extends Fantasia Archive tests: Vitest unit tests vs Playwright component and E2E tests, including rebuild-before-Playwright rules and file naming. Use when writing tests, debugging CI, or when the user mentions Vitest, Playwright, component tests, or e2e.
Per-tab editState on opened workspace documents: preview (read-only) vs edit (inputs). Use when adding DocumentWorkspacePage fields, tab session state, or opened_documents snapshot columns.
Maintains the English in-app changelog at i18n/en-US/documents/changeLog.md in strict sync with package.json version, without any automatic version bumping. Changelog text must be user- or release-relevant only—never internal QA, Git meta (commits/pushes), or “updated changelog”. Prefer editing the log in the same commit as the work, before push. Use after substantive app, UX, or user-facing docs changes, or when the user asks for release notes.
Default post-edit verification for Fantasia Archive agents: ESLint on touched paths, full vue-tsc, stylelint on touched styles, and yarn vitest run only on specs connected to the edit batch. Full yarn testbatch:verify is reserved for final cleanup, git commit, and explicit user requests. Use after substantive code edits before reporting work done.
Works on Fantasia Archive Electron main process: app lifecycle, window management, platform tweaks, native integrations, and ipcMain registration (register*Ipc + electron-ipc-bridge channel names). Use when editing electron-main.ts, src-electron/mainScripts/, or main-side tests.
Extends or fixes renderer-facing Electron APIs exposed through the preload script and contextBridge. Use when adding IPC-like surface area, typing window.faContentBridgeAPIs, editing src-electron/contentBridgeAPIs, or extending shared IPC channel names in electron-ipc-bridge.ts.
| name | fantasia-dev-setup |
| description | Sets up and runs Fantasia Archive locally using Yarn, Node.js 22.22 or newer, and Quasar Electron mode. Use when installing dependencies, choosing dev vs production build commands, or when the user mentions environment setup, CLI, or first run. |
yarn@1.22.19)package.json engines.node >=22.22.0)yarn global add @quasar/cli.github/workflows/verify.yml — yarn testbatch:verify only; Storybook VRT local onlyyarn
DnD libs (vue-draggable-plus, quasar-ui-q-draggable-table) in package.json; boot q-draggable-table. Policy: fantasia-drag-drop.
quasar dev -m electron
(yarn quasar:dev:electron). Electron + Storybook together: yarn app:dev.
Post-implementation agent gates (dev-electron-compile-check.mdc): (1) dev scoped gate (fantasia-dev-scoped-verify), (2) yarn quasar:dev:electron 20s compile smoke — separate terminals; kill agent-spawned dev after pass. Full yarn testbatch:verify only at final cleanup, commit, or explicit user request.
Postinstall skipped → missing node_modules/electron/dist.
rm -rf node_modules/electron # PowerShell: Remove-Item -Recurse -Force node_modules/electron
yarn install
# or: node node_modules/electron/install.js
Harmless stderr; main process filters specific lines.
Native addon must match Electron ABI.
yarn rebuild:native
Close quasar dev first on Windows file locks. If still fails: remove node_modules/better-sqlite3, yarn install (scripts enabled), yarn rebuild:native again.
Required for packaged behavior + before Playwright:
quasar build -m electron
(yarn quasar:build:electron = quasar build -m electron --publish never).
Quieter: yarn quasar:build:electron:summarized — log in test-results/quasar-build-electron-last.log.
Playwright userData: TEST_ENV components/e2e → %APPDATA%/fantasia-archive/playwright-user-data. Serial suites reset in test.beforeAll only — see fantasia-testing.
| Goal | Command |
|---|---|
| Dev scoped gate (agents) | fantasia-dev-scoped-verify |
| Full quality gate | yarn testbatch:verify |
| Full project gate | yarn testbatch:ensure:nochange |
| Refresh Storybook VRT | yarn testbatch:ensure:change |
| ESLint | yarn lint:eslint |
| TypeScript | yarn lint:typescript |
| Stylelint | yarn lint:stylelint |
| Unit tests | yarn test:unit |
| Component tests | yarn test:components (after prod build) |
| E2E | yarn test:e2e (after prod build) |
Storybook: yarn --cwd .storybook-workspace install after root yarn.
See eslint-typescript.mdc, fantasia-dev-scoped-verify, fantasia-testing. Yarn 1.x: yarn check ≠ quality gate — full yarn testbatch:verify at commit; dev scoped gate while iterating.
Shared types → types/. See types-folder.mdc.