🚀 极简科研智能 Agent (My Research Agent)

一个专为科研工作者打造的、开箱即用的本地 AI 智能助手，帮助您自动检索、分析和管理最新的学术文献。

🌟 核心工程亮点 (Core Features)

• 极致轻量，绿色便携: 零环境依赖，放弃传统 CGO，底层使用纯 Go SQLite，数据安全不丢失。
• 动态 RAG 记忆引擎 (防 Token 爆炸):
  • 显式标杆: 支持随时向知识库投喂经典文献。内置原生 BibTeX 解析器， 0 Token 消耗极速批量导入。
  • 隐式偏好: 阅读后可对论文打分 (1-5分)。
  • 动态召回: 废弃粗暴的全量上下文堆叠。通过精准注入高分文献，解决"大模型幻觉"。
• 并发感知与零结果自愈:
  • Goroutine 并发: 嗅探论文的 GitHub 链接后，利用 Go 协程高并发请求 GitHub API，瞬时获取真实 Star 数与最近更新时间。
  • 断网重试与宽泛自愈: 内置指数退避网络重试;当要求过于苛刻导致 arXiv 搜不到论文时，Agent 会自动修改检索词扩大范围，进行二次自救搜索。
• 云/本地全文深度解读 (防截断幻觉):
  • 输入 arXiv 链接或本地 PDF 绝对路径，获取"毒舌审稿"报告。
  • 智能首尾切片算法: 抛弃暴力字数截断防超Token。Go 引擎智能保留 Introduction、Method 和 Conclusion 章节，节省 Token 同时确保大模型不脑补、不幻觉。

📦 快速开始

运行(有Go环境)

go run ./cmd/agent

运行(无Go环境)

1. 下载对应操作系统的二进制文件：这里
   • Windows: agent.exe
   • macOS: agent
   • Linux: agent
2. 解压到指定目录
3. 运行可执行文件(Windows双击 agent.exe, Linux 和 macOS 直接运行 ./agent)

首次配置

首次运行时，程序会引导您：

1. 输入研究方向
2. 设置核心关键词
3. 配置输出语言和文风
4. 输入大模型 API Key

(💡进阶提示: 如网络无法访问 arXiv，请提前开启代理)

🎯 使用指南

主菜单功能

==========================================
科研 Agent 主菜单
1. 开始今日文献检索
2. 智能批量导入参考文献 (支持输入 .bib 文件路径或者直接粘贴)
3. 全文深度解读 (输入 PDF 文件路径)
4. 重新设置研究方向
5. 修改 API Key / 切换大模型
6. 导出我的高分文献库 (CSV Excel)
0. 退出程序 
===========================================

功能使用说明

1. 开始今日文献检索

• 输入您的检索要求（如："只要2026年的"）
• 系统会自动从 arXiv 检索最新论文
• 大模型会对论文进行评估和筛选
• 生成详细的科研日报

2. 智能批量导入参考文献

• 输入本地 BibTeX 文件路径，或直接粘贴文献文本
• 系统会自动解析并提取核心特征
• 将文献信息存入知识图谱

3. 全文深度解读

• 输入本地 PDF 文件路径
• 系统会提取文本并进行深度分析
• 生成专业的解读报告

4. 重新设置研究方向

• 清除现有配置，重新初始化研究方向

5. 修改 API Key / 切换大模型

• 更新 API Key 或修改大模型配置

6. 导出我的高分文献库

• 将评分≥4的文献导出为 CSV 格式
• 文件保存在 reports 目录

📁 项目结构

research-agent/
├── cmd/
│   └── agent/           # 主程序入口
├── internal/
│   ├── agent/           # Agent 核心实现
│   ├── config/          # 配置管理
│   ├── db/              # 数据库操作
│   ├── models/          # 数据模型
│   ├── skills/          # 技能系统
│   ├── ui/              # 用户界面
│   └── utils/           # 工具函数
├── llm/                 # 大模型客户端
├── reports/             # 生成的报告
├── data/                # 数据库文件
├── config.json          # 配置文件
├── go.mod
└── go.sum

🔧 配置说明

配置文件 config.json 包含以下字段：

{
  "api_key": "替换自己的KEY",
  "base_url": "https://api.deepseek.com/chat/completions",
  "model": "deepseek-chat",
  "temperature": 0.7,
  "max_tokens": 8192,
  "timeout": 120
}

• APIKey：大模型 API 密钥
• BaseURL：API 基础地址
• Model：使用的模型名称

🤝 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目！

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

• arXiv - 提供学术论文数据
• GitHub - 代码托管平台
• 各种开源库的贡献者

---

让科研更智能，让创新更高效！ 🎓