46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
# AstroResearch Dashboard / 前端仪表盘控制台
|
|
|
|
本模块是 AstroResearch 的前端部分，基于 **React (TypeScript) + Vite + Tailwind CSS** 构建。
|
|
|
|
---
|
|
|
|
## 1. 本地开发与调试 (Setup & Dev)
|
|
|
|
### 1.1 安装依赖
|
|
确保已安装 Node.js (v18+)，在当前目录下运行：
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 1.2 启动开发服务器
|
|
```bash
|
|
npm run dev
|
|
```
|
|
开发服务器将默认运行在 `http://localhost:5173`。Vite 已配置了对 `http://localhost:8000` (后端) 的代理转发，跨域请求会自动路由。
|
|
|
|
---
|
|
|
|
## 2. 核心功能及文件结构 (Core Modules)
|
|
|
|
- `src/components/layout/`：侧边栏与基本布局组件。
|
|
- `src/components/CitationGalaxyCanvas.tsx`：自研的 Canvas 力导向引文星系图渲染器。
|
|
- `src/features/search/`：统一检索面板，支持跨源搜索与收藏。
|
|
- `src/features/library/`：馆藏管理卡片，提供下载状态实时监测及重新下载操作。
|
|
- `src/features/reader/`：左右对齐的双分栏阅读器，内置划词高亮笔记及 LLM 重新翻译触发。
|
|
- `src/types.ts`：全局 TypeScript 静态类型定义。
|
|
|
|
---
|
|
|
|
## 3. 生产构建 (Build)
|
|
|
|
若需打包生成生产环境静态文件：
|
|
```bash
|
|
npm run build
|
|
```
|
|
打包文件将输出至当前目录下的 `dist/`，后端 Axum 在编译时会直接将其静态托管。
|
|
|
|
---
|
|
|
|
## 4. 开发规范 (Coding Standards)
|
|
- 本模块的详细前端开发约定，请参阅本目录下的 [前端开发规范-React篇.md](前端开发规范-React篇.md)。
|