# AstroResearch Architecture / 架构设计

AstroResearch 是一个集成了天文学文献检索、多通道下载（含防爬绕过与手动上传）、下载错误诊断、结构化解析、中英学术对比翻译、引文星系图谱以及馆藏健康度诊断的天文科研辅助系统。

> **本文档已拆分为模块化子文档。** 以下为索引导航。各子文档位于 `docs/architecture/` 目录下。

---

## 主架构

| 文档 | 内容 |
|:---|:---|
| [overview](architecture/overview.md) | 整体架构 — C/S 架构总览、Mermaid 图、各层级说明 |
| [core-workflows](architecture/core-workflows.md) | 核心工作流 — 文献下载流程、手动上传流程、文献解析流程、智能对照翻译流程 |
| [core-modules](architecture/core-modules.md) | 核心模块说明 — API 层、服务层、客户端层、独立工具、前端核心组件 |

---

## 智能体系统架构

| 文档 | 内容 |
|:---|:---|
| [Agent 概览](architecture/agent/overview.md) | Agent 整体架构 + ReAct 运行循环（完整生命周期时序图、并行工具执行模型） |
| [System Prompt](architecture/agent/system-prompt.md) | 系统提示词组装 — 模块化 Section 拼装、Anthropic Prompt Cache 优化策略 |
| [上下文管理](architecture/agent/context.md) | 四层压缩策略（Snip/Micro/Auto/Aggressive）、Token 预算管理、压缩熔断器 |
| [工具系统](architecture/agent/tools.md) | AgentTool Trait 设计、ToolRegistry 注册流程、19 个工具的域组织 |
| [Skills 系统](architecture/agent/skills.md) | 两层加载架构、SKILL.md 格式规范、热重载机制 |
| [Hooks 系统](architecture/agent/hooks.md) | 9 种生命周期事件、4 个内置 Hook 实现 |
| [记忆系统](architecture/agent/memory.md) | 文件系统持久化、`save_memory` 工具、Jaccard 去重、指数衰减、自动提取 |
| [子代理系统](architecture/agent/subagent.md) | 上下文隔离子代理、`delegate_research` 工具、进度透传 |
| [多 Agent 团队](architecture/agent/team.md) | 基于文件 inbox 的轻量级多 Agent 协作、Teammate 生命周期 |
| [任务看板与持久化](architecture/agent/tasks.md) | DAG 任务依赖、审计日志、轨迹导出 |
| [环境变量参考](architecture/agent/env-vars.md) | Agent 调参环境变量、Token 预算配置、相关文档链接 |

---

## 其他文档

| 文档 | 内容 |
|:---|:---|
| [API 文档](api.md) | 全部 REST API 端点说明 |
| [数据库设计](database.md) | SQLite 表结构与迁移 |
| [开发指南](development.md) | 开发环境搭建与工作流 |
| [部署指南](deployment.md) | 生产环境部署配置 |
| [故障排除](troubleshooting.md) | 常见问题诊断与修复 |