Asfmq
c5fd5b0d66
后端: - 权限系统重写: 全局→按 Session 隔离, 新增规则查询 API - 安全加固: 登录 IP 限流, Token 仅存 Cookie, bibcode 白名单校验 - SSE 超时保护, 异步 I/O 迁移, 10+ 处静默 DB 错误改为显式日志 - ar5iv 下标解析修复, parse_paper_row 去重, 优雅关闭 前端: - useSyncScroll 重写: 段落 ID 映射修复中英错位 - 全局竞态修复 (active 标志), libraryRef 闭包过期修复 - ErrorBoundary + vitest 测试基础设施 - Logo 组件提取, CustomSelect 泛型化, TabId 类型统一 - ReaderPanel 自动视图模式, AIAssistantPanel 状态批处理 |
||
|---|---|---|
| .. | ||
| public | ||
| src | ||
| .gitignore | ||
| eslint.config.js | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
| vitest.config.ts | ||
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/pages/：页面级大组件视图（如统一检索、馆藏管理、对照阅读、引文星系、批量同步、智能科研、系统设置）。src/components/：通用与专有 UI 组件（如力导向引文星系图、文献阅读器子组件、流水线任务终端等）。src/hooks/：抽取出的全局共享及业务数据逻辑 Hooks（如useLibrary、useReaderState、useSyncState等）。src/types/：全局 TypeScript 静态类型定义（types/index.ts）。
3. 生产构建 (Build)
若需打包生成生产环境静态文件：
npm run build
打包文件将输出至当前目录下的 dist/，后端 Axum 在编译时会直接将其静态托管。
4. 开发规范 (Coding Standards)
- 本模块的详细前端开发约定，请参阅本目录下的 前端开发规范-React篇.md。