Imported from zh30/lucy (
AGENTS.md). Install upstream withnpx skills add zh30/lucy. Copyright stays with the author.
Lucy — Agent Notes
Stack
- Vite + React 19 + TypeScript
- Three.js / @react-three/fiber + postprocessing
- MediaPipe Tasks Vision (Hands) via CDN WASM/model
- Zustand for
timeValue/timeSpeed - Deploy: Cloudflare Worker static assets (primary custom domain) + Pages mirror
Commands
pnpm install
pnpm assets:generate
pnpm dev
pnpm test
pnpm build
pnpm deploy # Worker → lucy.zhanghe.dev
# Pages mirror:
pnpm exec wrangler pages deploy dist --project-name=lucyProduction
- https://lucy.zhanghe.dev (Worker custom domain)
- https://lucy.nanhetech.workers.dev
- https://lucy-45k.pages.dev
Control model (Mode B)
- Gesture writes only
timeSpeed/ intensity / palmNdc tick(dt)integratestimeValue- Timeline drag uses
setTimeAbsolute - See
src/core/gesture/gestureMapper.ts+ tests
Privacy
- Camera local-only; privacy banner before getUserMedia
- CSP + Permissions-Policy in
public/_headers/ Worker response headers