init

2026-06-30 15:02:20 +08:00
commit 3948b5a48a
306 changed files with 77275 additions and 0 deletions
@@ -0,0 +1,44 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+### Project Overview
+
+LocalMiniDrama (本地短剧助手) — an AI-powered local short drama creation tool. Single product, three sub-projects sharing one repo (no monorepo tooling).
+
+### Services
+
+| Service | Directory | Port | Start Command |
+|---------|-----------|------|---------------|
+| Backend (Express + SQLite) | `backend-node/` | 5679 | `npm run dev` |
+| Frontend (Vite + Vue 3) | `frontweb/` | 3013 | `npm run dev` |
+
+Frontend proxies `/api` and `/static` to backend via Vite config.
+
+### Running Tests
+
+```bash
+# Backend tests (Node.js built-in test runner)
+cd backend-node && node --test test/*.test.js
+
+# Frontend tests (ESM, Node.js built-in test runner)
+cd frontweb && node --test test/*.test.js
+```
+
+No ESLint or other lint tool is configured in this codebase.
+
+### Building
+
+```bash
+cd frontweb && npm run build
+```
+
+### Key Development Notes
+
+- Pure JavaScript (no TypeScript) throughout.
+- Backend uses `node --watch` for hot reloading in dev mode (`npm run dev`).
+- Database is SQLite (embedded via `better-sqlite3`), auto-created in `backend-node/data/`.
+- Migrations run automatically on backend startup (`ensureColumns()`); explicit `npm run migrate` only needed for first-time setup or after adding new migration SQL files.
+- Config file at `backend-node/configs/config.yaml` already exists in the repo — no need to copy from example.
+- AI content generation requires external API keys (configured via the app's "AI 配置" page), but the app fully functions without them for development/testing purposes.
+- The backend also serves the built frontend from `frontweb/dist/` at port 5679 when the dist folder exists; during development, use the Vite dev server at port 3013 instead.