AstroResearch/dashboard
Asfmq cd6af4f995 feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式
- [后端/PDF解析] 重构 MinerU PDF 解析流程:引入预签名两阶段直传机制,解决大文件 API 传输限制问题;支持轮询机制与本地 images 备用目录存储。
- [后端/同步与下载] 新增经典 ADS SCAN 扫描件 PDF 和 ADS_PDF 直接通道的下载逻辑;新增常用同步检索配置的持久化存储与去重管理 API。
- [后端/日志] 重构日志系统,支持控制台 pretty 输出与每日滚动文件日志(使用上海 +08:00 时区),引入 HTTP 路由请求链路追踪。
- [前端/引力图] 升级引用星系图 canvas 交互:支持平移拖拽与滚轮缩放,添加引力圈轨道装饰及未导入文献的半透明视觉区分。
- [前端/控制台] 统一重构为扁平高对比度浅色纯中文控制台样式;重新设计文献详情弹窗与状态进度条。
- [数据库] 新增 papers 表的 doctype 字段及 sync_queries 检索配置表。
2026-06-10 17:29:07 +08:00
..
public feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式 2026-06-10 17:29:07 +08:00
src feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式 2026-06-10 17:29:07 +08:00
.gitignore feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
eslint.config.js feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
index.html feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
package-lock.json feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式 2026-06-10 17:29:07 +08:00
package.json feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式 2026-06-10 17:29:07 +08:00
README.md refactor!: 模块化拆分 src 结构,新增批量同步服务、查询解析器及前端分页/高级检索功能 2026-06-09 10:29:24 +08:00
tsconfig.app.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
tsconfig.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
tsconfig.node.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
vite.config.ts feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
前端开发规范-React篇.md feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00

AstroResearch Dashboard / 前端仪表盘控制台

本模块是 AstroResearch 的前端部分,基于 React (TypeScript) + Vite + Tailwind CSS 构建。


1. 本地开发与调试 (Setup & Dev)

1.1 安装依赖

确保已安装 Node.js (v18+),在当前目录下运行:

npm install

1.2 启动开发服务器

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)

若需打包生成生产环境静态文件:

npm run build

打包文件将输出至当前目录下的 dist/,后端 Axum 在编译时会直接将其静态托管。


4. 开发规范 (Coding Standards)