AstroResearch/dashboard
Asfmq f6df9d8136 feat: Agent 思考模式前端可控、子代理全链路持久化、权限系统、工具 ID 追踪体系、前端面板与文档架构重构
- 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 等变量说明
2026-06-18 01:21:02 +08:00
..
public feat: 重构 PDF/文献检索同步机制、升级引力图交互与控制台 UI 样式 2026-06-10 17:29:07 +08:00
src feat: Agent 思考模式前端可控、子代理全链路持久化、权限系统、工具 ID 追踪体系、前端面板与文档架构重构 2026-06-18 01:21:02 +08:00
.gitignore feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
eslint.config.js feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
index.html feat: 手动上传绕防爬、下载错误诊断与健康检查工具;模块化重构 API 与批量同步 2026-06-11 22:56:36 +08:00
package-lock.json feat: RAG 文献问答、天体目标识别、解析器模块化与批量管线扩展 2026-06-15 13:25:18 +08:00
package.json feat: RAG 文献问答、天体目标识别、解析器模块化与批量管线扩展 2026-06-15 13:25:18 +08:00
README.md refactor!: 模块化拆分 src 结构,新增批量同步服务、查询解析器及前端分页/高级检索功能 2026-06-09 10:29:24 +08:00
tsconfig.app.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
tsconfig.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
tsconfig.node.json feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
vite.config.ts feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00
前端开发规范-React篇.md feat: 初始化 AstroResearch 核心系统代码及重构技术文档 2026-06-08 17:23:27 +08:00

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)