添加上传和下载文件夹

front/AGENTS.md

@@ -0,0 +1,37 @@
+# Frontend AGENTS
+
+This directory is a Vite + React + TypeScript frontend. Follow the current split between pages, shared state/helpers, auth context, and reusable UI.
+
+## Frontend layout
+
+- `src/pages`: route-level screens and page-scoped state modules.
+- `src/lib`: API helpers, cache helpers, schedule utilities, shared types, and test files.
+- `src/auth`: authentication context/provider.
+- `src/components/layout`: page shell/layout components.
+- `src/components/ui`: reusable UI primitives.
+- `src/index.css`: global styles.
+
+## Real frontend commands
+
+Run these from `front/`:
+
+- `npm run dev`
+- `npm run build`
+- `npm run preview`
+- `npm run clean`
+- `npm run lint`
+- `npm run test`
+
+Important:
+
+- `npm run lint` is the current TypeScript check because it runs `tsc --noEmit`.
+- There is no separate ESLint script.
+- There is no separate `typecheck` script beyond `npm run lint`.
+
+## Frontend rules
+
+- Keep route behavior in `src/pages` and shared non-UI logic in `src/lib`.
+- Add or update tests next to the state/helper module they exercise, following the existing `*.test.ts` pattern.
+- Preserve the current Vite alias usage: `@/*` resolves from the `front/` directory root.
+- If a change depends on backend API behavior, verify the proxy expectations in `vite.config.ts` before hardcoding URLs.
+- Use the existing `npm run build`, `npm run test`, and `npm run lint` commands for validation; do not invent a separate frontend verification command.