feat

.kilocode/rules-architect/AGENTS.md

@@ -0,0 +1,25 @@
+# Architect Mode Rules (Non-Obvious Only)
+
+## Architecture Overview
+- Vue 3 SPA with dynamic route loading from server
+- Pinia stores: `app`, `user`, `tab-bar` (see [`src/store/`](src/store/))
+- Two-layer route guard: user login check + permission check
+
+## Dynamic Route System
+- Server menu fetched in [`app store`](src/store/modules/app/index.ts) via `fetchServerMenuConfig()`
+- Routes registered dynamically in [`permission.ts`](src/router/guard/permission.ts)
+- Uses `isMenuLoading`/`isMenuLoaded` flags to prevent duplicate loads
+
+## API Architecture
+- Two axios instances for different auth patterns:
+  - [`request.ts`](src/api/request.ts): Workspace header + custom token format
+  - [`interceptor.ts`](src/api/interceptor.ts): Bearer token + code 20000 validation
+- Choose based on backend API requirements
+
+## State Management
+- [`SafeStorage`](src/utils/safeStorage.ts) required for all localStorage access
+- Supports TTL expiry and type-safe keys via enum
+
+## Component Patterns
+- Global components registered in [`components/index.ts`](src/components/index.ts)
+- ECharts modules manually imported for bundle size optimization

.kilocode/rules-ask/AGENTS.md

@@ -0,0 +1,19 @@
+# Ask Mode Rules (Non-Obvious Only)
+
+## Project Structure
+- Vue 3 + Arco Design admin template with Pinia state management
+- Vite config files located in `config/` directory (not root)
+
+## Key Directories
+- `src/api/` - API layer with two axios instances
+- `src/views/ops/` - Main business modules (kb, netarch, asset, etc.)
+- `src/router/guard/` - Route guards including dynamic menu loading
+- `src/store/modules/app/` - App store with server menu fetching
+
+## Documentation References
+- Arco Design Vue: https://arco.design/vue
+- Vue Flow (for topology): https://vueflow.dev/
+
+## API Patterns
+- Use [`request.ts`](src/api/request.ts) for workspace-aware requests
+- Use [`interceptor.ts`](src/api/interceptor.ts) for standard Bearer token auth

.kilocode/rules-code/AGENTS.md

@@ -0,0 +1,13 @@
+# Code Mode Rules (Non-Obvious Only)
+
+## API Layer
+- Two axios instances exist: [`request.ts`](src/api/request.ts) (custom with workspace header) and [`interceptor.ts`](src/api/interceptor.ts) (global with Bearer token). Choose based on whether you need workspace support.
+
+## Storage
+- Always use [`SafeStorage`](src/utils/safeStorage.ts) with `AppStorageKey` enum - never use localStorage directly. Supports TTL via third parameter.
+
+## useRequest Hook
+- [`useRequest()`](src/hooks/request.ts) invokes API immediately - does NOT work in async functions. Pass params via `.bind(null, params)` pattern.
+
+## Dynamic Routes
+- Routes loaded from server in [`permission.ts`](src/router/guard/permission.ts) using `isMenuLoading`/`isMenuLoaded` flags. Don't modify these flags manually.

.kilocode/rules-debug/AGENTS.md

@@ -0,0 +1,17 @@
+# Debug Mode Rules (Non-Obvious Only)
+
+## API Response Codes
+- [`interceptor.ts`](src/api/interceptor.ts) expects `code: 20000` for success. Other codes trigger error messages.
+- Token expiry codes: 50008, 50012, 50014 trigger logout modal.
+
+## Token Storage
+- Tokens stored via [`SafeStorage`](src/utils/safeStorage.ts) with key `AppStorageKey.TOKEN`.
+- Token expiry redirects to `/auth/login` (not `/login`).
+
+## Route Loading Issues
+- If routes not loading, check `isMenuLoading`/`isMenuLoaded` flags in [`permission.ts`](src/router/guard/permission.ts).
+- Server menu fetched via [`fetchServerMenuConfig()`](src/store/modules/app/index.ts).
+
+## Environment
+- Dev config: `.env.development`, Prod config: `.env.production`
+- API base URL: `VITE_API_BASE_URL`, Workspace: `VITE_APP_WORKSPACE`