Asfmq
3f1935678b
**后端架构**
- 抽取翻译服务中内嵌的 LLM HTTP 调用为独立的 LlmClient /
EmbeddingClient（src/clients/llm.rs），翻译模块改为委托调用，消除
对 reqwest/serde 的直接耦合
- Config 新增 EMBEDDING_API_KEY/EMBEDDING_API_BASE/EMBEDDING_MODEL
三项配置，默认 fallback 至 LLM 对应值，补齐向量嵌入基础设施
**下载策略优化**
- arXiv 直连下载失败后自动回退至 ADS 网关 PUB_PDF→EPRINT_PDF→CrossRef
多级通道，替换此前单路径策略；批量同步同步应用此逻辑
- PDF/HTML 任一方成功时，失败方的 path 字段不再存储 "error:" 报错字符串，
改为置 NULL，防止日志污染数据
**前端交互增强**
- 侧边栏支持折叠/展开：收起为仅图标模式(w-16)，展开恢复完整模式(w-64)；
收起后点击 Logo 展开，含流畅 cubic-bezier 过渡动画
- 阅读面板新增 PDF 内嵌预览：已下载 PDF 时可通过 iframe 切换查看
/api/files 下的本地文献
- reader/citation 面板未选文献时展示带图标的空状态引导页，替代空白页
- 文献详情面板改为固定高度弹性布局(h-[460px])，各区块按比例分配避免
内容挤压；期刊名过长截断+悬停tooltip；关键词无数据显式占位
- 全局移除 emoji Unicode，统一替换为 lucide-react 图标组件，
消除跨平台字体渲染差异
**反爬检测精细化**
- 按响应长度分层：>150KB 跳过检测（完整文献），<5KB 才扫描通用 HTTP
错误关键字，杜绝长文献误触 Cloudflare/503 模式匹配
- 新增 Radware Bot Manager、ShieldSquare WAF 特征识别
**健壮性**
- Obscura 下载校验失败后自动清理硬盘残留坏文件
- 健康检查工具：文献已有有效 HTML 但 PDF 字段为旧报错时自动判定可修复
- 上传接口 body limit 提升至 100MB，新增 /api/files 静态文件服务路由
- StandardPaper 新增 has_pdf/has_html 字段区分格式级下载状态
|
||
|---|---|---|
| .. | ||
| 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 | ||
| 前端开发规范-React篇.md | ||
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)
- 本模块的详细前端开发约定，请参阅本目录下的 前端开发规范-React篇.md。