Asfmq
f6df9d8136
- AgentConfig/LlmClient 新增 enable_thinking 参数，前端 SSE 请求传递 thinking 开关，仅千问/DashScope 时启用 - 完善权限系统，支持细粒度的权限控制和用户权限申请 - delegate_research 工具重命名为 subagent，SubAgentTool/SubAgentRunner 重构 - 子代理消息（system/user/assistant/tool）持久化到 agent_messages 表，带 agent_name 标识 - 子代理活动日志（工具调用列表+思考摘要）注入返回结果，Hooks 获得正确 session_id 和 subagent_name - LLM 工具调用 ID 回退生成 UUID（llm.rs），ToolCall/ToolResult SSE 事件增加 id/tool_call_id 双字段 - ToolContext 扩展 session_id/sse_tx/enable_thinking 字段，executor 统一注入而非构造函数传参 - agent_messages 新增 metadata+raw_json 列，agent_sessions 暴露 summary 字段 - 删除文件级 transcript 快照（compact.rs），改为依赖 DB 持久化 - ResearchAgentPanel 重写：TimelineItem 类型替代 StreamStep，支持会话历史回放 - 新增 AgentMetricsPanel/AskUserQuestionCard/AuditLogViewer 三个前端组件，types.ts 完整类型定义 - docs/architecture/ 分层重组：概览/核心模块/核心工作流 + agent/ 子目录 11 篇专题文档 - docs/api.md 补充 RAG/Target/Agent 接口，docs/development.md 新建开发指南 - .env.example 完全重写，补充 FALLBACK_MODEL 等变量说明
2.6 KiB
2.6 KiB
AstroResearch Architecture / 架构设计
AstroResearch 是一个集成了天文学文献检索、多通道下载（含防爬绕过与手动上传）、下载错误诊断、结构化解析、中英学术对比翻译、引文星系图谱以及馆藏健康度诊断的天文科研辅助系统。
1. 整体架构 (Overall Architecture)
AstroResearch 采用 C/S (Client-Server) 架构，由前端 React 单页应用和后端 Axum HTTP 服务构成，核心流程及层级如下：
graph TD
subgraph Frontend ["React 前端 (Port 5173 / 8000)"]
UI[仪表盘 UI / ReaderPanel]
Canvas[引文 Canvas 拓扑图]
API_Client[Axum API 客户端]
CustomSelect[CustomSelect 可复用组件]
end
subgraph Backend ["Rust Axum 后端 (Port 8000)"]
Router[Axum 路由与中间件]
subgraph API ["API 层 (模块化)"]
Helpers[helpers.rs 格式转换与数据库工具]
Papers[papers.rs 文献检索/下载/上传/解析/翻译/引文/导出]
Notes[notes.rs 笔记 CRUD]
Sync[sync.rs 批量同步控制]
end
subgraph Services ["服务层"]
Batch[batch/ 批量同步引擎]
BatchMeta[batch/meta.rs 元数据采集]
BatchAsset[batch/asset.rs 资源处理]
Parser[parser.rs HTML/PDF 解析]
Downloader[download.rs 多通道下载器]
Translator[translation.rs LLM 翻译器]
Logging[logging.rs 日志系统]
end
DB[("SQLite / astro_research.db")]
end
subgraph External [外部第三方服务]
ADS[NASA ADS API]
arXiv[arXiv Atom XML API]
MinerU[MinerU PDF 解析服务]
QiniuCDN[七牛云对象存储 CDN]
LLM[LLM API]
end
UI -->|用户操作| API_Client
API_Client -->|RESTful APIs| Router
Router --> API
Papers -->|查询/保存元数据| DB
Papers -->|文献下载| Downloader
Papers -->|文件上传| Papers
Papers -->|正文解析| Parser
Papers -->|学术翻译| Translator
Sync -->|批量操作| Batch
BatchMeta -->|元数据同步| ADS
BatchMeta -->|元数据同步| arXiv
BatchAsset -->|批量文件下载| Downloader
BatchAsset -->|批量正文解析| Parser
BatchAsset -->|批量翻译| Translator
Batch -->|写库记录| DB
Downloader -->|代理请求| ADS
Downloader -->|直连或 ar5iv| arXiv
Parser -->|图文降级解析| MinerU
Parser -->|托管插图| QiniuCDN
Translator -->|天文术语翻译| LLM
Canvas -->|引文网络请求| Papers