clean

CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 角色与规则
+
+你是一个游戏开发 Agent，协助在本工程中开发 HTML 游戏/应用。
+
+- **始终用中文回复**
+- **只能**新增、修改、删除 `src/` 目录内的文件，严禁修改根目录配置文件
+
+## Commands
+
+```sh
+pnpm dev        # start dev server
+pnpm build      # tsc type-check + vite build
+pnpm lint       # biome check --write ./src
+pnpm preview    # preview production build
+```
+
+No test runner is configured.
+
+## Architecture
+
+This is a React 19 + Vite SPA boilerplate for building games/apps on the [Mujian (幕间)](https://mujian.ai) platform.
+
+**Startup flow:**
+`main.tsx` imports `@mujian/js-sdk/lite` (which injects `window.$mujian_lite`), then renders `ReactRouterProvider`. On mount, `RouterProvider.tsx` calls `useGlobalStore().init(window.$mujian_lite)`, which resolves the OpenAPI `apiKey` and `baseURL` from the SDK and stores them in the zustand global store.
+
+**LLM calls:**
+`src/utils/llm.ts` exports `useMujianOpenAPI` — a hook that reads credentials from the global store and calls the Mujian OpenAPI (OpenAI-compatible) at `https://openapi.mujian.ai/v1/chat/completions` with streaming SSE. Default model is `deepseek-v3.2`. For local dev, set `VITE_MUJIAN_API_KEY` in `.env` to bypass SDK credential injection.
+
+**Key conventions:**
+- Path alias `@` maps to `./src`
+- Styling via TailwindCSS v4 (Vite plugin, no config file needed); use `cn()` from `src/utils/cn.ts` for conditional classes
+- State management with zustand; global SDK state lives in `src/store/global.tsx`
+- Routes are defined in `src/providers/RouterProvider.tsx`
+
+## Preferred libraries
+
+Already installed; use these over alternatives:
+- `react-router` — routing
+- `zustand` — state management
+- `axios` — HTTP requests and SSE
+- `dayjs` — dates
+- `localforage` — persistent storage
+- `react-icons` — icons
+- `motion` — animations
+- `lodash-es` — utilities
+
+## Mujian 参考文档
+
+- OpenAPI 接入说明：https://docs.mujian.ai/creator/openapi/introduction.md
+- OpenAPI 接口定义：https://docs.mujian.ai/creator/openapi/endpoints.md
+- SDK 文档：https://docs.mujian.ai/creator/sdk/introduction.html