---
description: aiclient 项目总览与通用约定
alwaysApply: true
---

# aiclient 项目约定

## 技术栈

- **桌面壳**：Tauri 2（Rust），单例、无边框、可拖动标题栏
- **前端**：Vue 3 + Vite 6，**纯 JavaScript**（不使用 TypeScript）
- **UI**：Tailwind CSS v4（`@tailwindcss/vite`）+ PrimeVue 4（Aura 深色预设）
- **状态/路由**：Pinia + Vue Router

## 目录结构

```
src/                 # Vue 前端
  main.js            # 入口：插件与全局组件注册
  App.vue            # 布局：标题栏 + router-view
  styles/main.css    # Tailwind + 科技感主题令牌
  router/            # 路由与守卫
  stores/            # Pinia（auth 等）
  views/             # 页面
  components/        # 可复用组件
src-tauri/           # Tauri Rust 与配置
```

## 常用命令

- `npm run dev` — 仅前端（端口 1420）
- `npm run tauri dev` — 桌面开发
- `npm run build` / `npm run tauri build` — 构建（前端无 `tsc` 步骤）

## 通用原则

- 用户界面文案默认使用简体中文