---
description: aiclient_ui 前端项目约定
alwaysApply: true
---

# aiclient_ui 项目约定

## 职责

本仓库仅包含 **Vue 3 前端**，不含 Tauri / Rust。桌面壳在同级目录 `../aiclient`。

## 技术栈

- Vue 3 + Vite 6，**纯 JavaScript**
- Tailwind CSS v4 + PrimeVue 4
- Pinia + Vue Router
- `@tauri-apps/api`：在 Tauri 窗口内调用桌面能力

## 常用命令

- `npm run dev` — http://localhost:1420
- `npm run build` — 输出 `dist/`（本地预览）
- `npm run build:deploy` — 部署到服务器静态目录（桌面端 Release 加载此地址）

## API

- 基址：`VITE_API_BASE_URL`（见 `.env.example`）
- 开发代理：`vite.config.js` 将 `/api` 代理到 `http://127.0.0.1:8001`
- 响应信封 `ApiResponse` 约定见 aiclient 或 pythonbackend 规则

## 通用原则

- 界面文案默认简体中文