poco-ai/Agentero

Agentero – 人机协作的一站式研究工作站

简介

• Agentero 是一款桌面应用程序（macOS、Windows、Linux），让研究人员能够阅读 PDF、做 Markdown 笔记，并与本地 AI 智能体交互，同时所有数据都保存在用户机器的普通文件中。
• 它基于两个开放协议构建：
  • ACP（智能体客户端协议） – 让任何本地运行的 LLM（Claude、OpenAI、Codex 等）充当“研究助手”。
  • MCP（模型上下文协议） – 将本地论文库作为外部 AI 客户端（例如，ChatGPT 网页版、Claude Desktop）的上下文源。

存在原因

• 传统工具（Zotero、Obsidian、基于 Web 的聊天窗口）将论文、笔记和 LLM 交互隔离在不同的“孤岛”中，迫使用户进行复制粘贴。
• 由于多栏布局、表格和 LaTeX 公式，PDF 对模型来说难以解析。
• Agentero 弥合了这一差距：它从 PDF 中提取结构化的 Markdown/LaTeX，并让附加的智能体立即可用这些内容。

核心功能

1. 结构化阅读与笔记
   • PDF 阅读器，支持大纲导航、流畅文本选择、高亮和全文搜索。
   • 自动将公式、伪代码和表格提取为清晰的 Markdown/LaTeX。
   • 所见即所得 Markdown 编辑器，支持双向链接（[[link]]）、斜杠命令和实时 LaTeX 渲染。
   • 内置翻译模式（词级、逐页、全文），可使用自定义 API 密钥。
2. 开放智能体集成
   • 通过 ACP 协议连接任何本地 LLM；无供应商锁定。
   • 运行 MCP 服务器，以便外部 AI 客户端可以查询本地库以获取上下文。
   • 无头 CLI（agentero）用于脚本化批量导入、元数据提取和笔记生成。
3. 学术雷达与论文发现
   • 集成浏览 Cool Papers 和 ModelScope 社区订阅源；一键导入。
   • 支持实验室、博客和预印本服务器的 RSS 订阅。
   • 基于用户现有收藏的每日 arXiv 推荐。
   • 自动解析参考文献列表、批量获取引用的 PDF 以及跟踪引用图。
4. Zotero 兼容性与透明的本地存储
   • 一键将整个 Zotero 库（标签、笔记、附件）迁移到 Agentero 的文件夹结构中。
   • 所有数据都存储为普通 PDF 和 Markdown 文件；没有隐藏数据库。
   • 可选同步到任何兼容 S3 的存储桶或通过 SSH 隧道进行远程访问。

典型工作流程

1. 导入论文（直接从 Zotero、Cool Papers、RSS 或手动上传）。
2. 阅读 PDF，选择一段文字，并要求附加的智能体解释、总结或生成笔记。
3. 智能体在结构化的 Markdown/LaTeX 上下文上工作，减少幻觉。
4. 将生成的笔记与论文一起保存；使用 [[双链]] 链接以便轻松导航。
5. 使用 CLI 或 ACP 自动化批量任务（例如，夜间 arXiv 抓取、批量元数据更新）。

入门指南

• 桌面客户端：从网站（agentero.app）或 GitHub Releases 下载安装程序。macOS 用户也可以通过 Homebrew（brew tap poco-ai/agentero && brew install --cask agentero）安装。Linux 需要 Ubuntu 22.04+ 和 webkit2gtk 4.1。
• CLI：brew tap poco-ai/agentero && brew install agentero；然后运行 agentero --help 查看命令。

许可证

• 根据 MIT 许可证开源。

可能受益的人群

• 已经使用 Zotero/Obsidian 并希望与 LLM 助手建立更紧密循环的研究人员。
• 需要可复制、基于文件且可在设备之间同步的知识库的团队。
• 构建自定义 AI 智能体且需要标准协议（ACP/MCP）来访问本地论文语料库的开发人员。

---

以上所有细节均直接取自仓库的 README。