Asfmq
85b6429c30
核心架构变更：
1. Agent 多模式系统替代 Coordinator
- 移除 src/agent/coordinator/（Coordinator Agent/Worker/Tools，946 行）
- 新建 src/agent/modes/：声明式模式抽象（AgentMode/ModeConfig/ToolSet）
- 三种内置模式：
- default：通用科研助手，零覆盖保持现有行为
- deep-research：16 步、启用思考、research 权限、系统性调研
- literature-reader：白名单工具、只读沙箱、结构化阅读
- ModeRegistry + ModeConfig 预设 + ToolSet 过滤 + 身份/原则覆盖
- AgentRuntime::with_mode() 统一入口，模式持久化到 session.mode 字段
- GET /api/chat/modes 提供模式列表给前端选择器
2. 视觉模型与图片分析
- 新增 analyze_image 工具（340 行）：本地/URL 图片 → 视觉模型流式分析
- LlmClient::analyze_image_stream()：SSE 增量实时推送
- 配置：LLM_VISION_MODEL / LLM_VISION_API_KEY / LLM_VISION_API_BASE
- 前端：粘贴/选择图片附件，重试时复用文件路径
- Service 层移除 /chat/rag 和 /chat/figure 端点，统一走 Agent SSE
- Body limit 提升至 100MB 适配大图上传
3. LLM 三级能力分层
- Tier 1 (Core) → Tier 2 (Medium) → Tier 3 (Fast)，级联回退
- medium_llm / fast_llm / vision_llm 注入 AppState
- 资产批量翻译 → Medium LLM + Semaphore(3) 并发控制
- 记忆提取/上下文压缩子代理 → Fast LLM
- SubAgentRunner::with_llm_client() 支持注入专用 LLM
4. 数据库与性能优化
- SQLite 启用 WAL + busy_timeout(10s) 处理并发写入
- RAG ingest：DELETE 合并为原子语句 + 批量事务写入
- Meta sync：save_paper_to_db_tx() 事务化批量插入
- 翻译词典：first_words HashSet 预过滤 + next_valid_index 跳跃优化
- read_file 不截断输出 + skip_persist 防止级联磁盘持久化
5. 工具系统增强
- ToolContext 增加 tool_call_id + max_output_chars
- ToolOutput 增加 skip_persist 标记
- TextDelta SSE 携带可选 tool_call_id 支持工具的流式输出
- ChatMessage::text() 辅助方法
|
||
|---|---|---|
| .. | ||
| 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。