Asfmq
e13fa2ad40
- src/ 按 clients/services/api 分层，Config 提升至 crate 根 - 新增 batch_sync.rs（双源并行收割）、query_parser.rs（多平台检索式转换） - build.rs 自动触发前端 npm install & build - SearchPanel 支持分页/排序/每页条数/高级检索构建器，前端加入搜索缓存 - 新增 SyncPanel 替换 SettingsPanel；新增 live_search 集成测试
47 lines
1.6 KiB
Markdown
47 lines
1.6 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/features/sync/`：批量同步面板，支持后台元数据大批量采集、过滤及文献资源批量下载/解析流水线任务管理。
|
|
- `src/types.ts`：全局 TypeScript 静态类型定义。
|
|
|
|
---
|
|
|
|
## 3. 生产构建 (Build)
|
|
|
|
若需打包生成生产环境静态文件：
|
|
```bash
|
|
npm run build
|
|
```
|
|
打包文件将输出至当前目录下的 `dist/`，后端 Axum 在编译时会直接将其静态托管。
|
|
|
|
---
|
|
|
|
## 4. 开发规范 (Coding Standards)
|
|
- 本模块的详细前端开发约定，请参阅本目录下的 [前端开发规范-React篇.md](前端开发规范-React篇.md)。
|