代码质量:
- 新增 .prettierrc + eslint-plugin-prettier,全量格式化所有 TSX/TS/CSS 文件
- npm scripts 新增 format / format:check / lint:fix
Logo 重设计:
- SVG logo 从简单星月改为望远镜+轨道+三角架+星光,favicon 同步更新
Library 服务端分页与多维筛选:
- LibraryQueryParams 支持 q(全局搜索)/status(下载状态)/doctype/author/year/journal/sort_by
- API 返回 {items, total},默认每页 12 条
- 前端新增筛选面板:搜索栏、状态下拉、文献类型、排序、分页控件
Agent 工具输出可视化:
- 新增 SpecialToolRenderers.tsx:query_target 天体参数卡片(含 SIMBAD/VizieR 链接)、search_papers
文献列表(内嵌下载/阅读/星系跳转按钮)
- 系统内部工具(compress_context 等)无错误时自动隐藏,减少时间线噪音
- ToolCallCard 与 Reader/Citation 打通:可在工具输出中直接打开文献或跳转引用星系
.agent 目录统一:
- memory/tool-results/trajectories/images 全部归入 library/.agent/ 子目录
PDF 加载修复:
- BilingualViewer 改用 fetch → blob:// URL 加载 PDF,绕过 iframe SameSite Cookie 限制
|
||
|---|---|---|
| .. | ||
| public | ||
| scratch | ||
| src | ||
| .gitignore | ||
| .prettierrc | ||
| 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。