poco-ai/Agentero

项目介绍

Agentero 针对的是传统文献工具与 AI 工具之间的断层：论文在 Zotero、笔记在 Obsidian、与模型的推理留在网页对话框里，需要时只能手动复制粘贴；同时，排版良好的 PDF 对模型并不友好，双栏、跨页表格和公式容易解析出错。

桌面端把 PDF 阅读与批注、结构化内容提取和 Markdown 笔记放在一起。阅读器支持大纲导航、高亮批注与全文检索，并能把论文中的公式、算法伪代码和表格转成 Markdown 与 LaTeX。内置编辑器支持 [[双链]]、/ 快捷指令和 LaTeX 实时渲染，笔记与文献原生关联。翻译支持划词、按页对照和全文三种模式，可使用内置通道或配置自己的 API Key。

Agent 协作方式

项目通过 ACP（Agent Client Protocol）连接本地运行的 Agent，可对接 Claude Code、OpenCode、Codex 或本地模型，不绑定厂商，上下文保留在本地。它同时可作为 MCP Server 运行，让 ChatGPT Web、Claude Desktop 等外部客户端检索本地文献库。另有内置 CLI，用于脚本化批量导入、元数据提取和写笔记。

文献发现方面，软件内可浏览 Cool Papers 与魔搭社区并一键归档，支持学术 RSS，基于本地库内容推荐每日 arXiv 论文，也能解析参考文献列表批量入库。

快速使用

从官网或 GitHub Releases 下载 macOS、Windows、Linux 的预编译安装包。macOS 也可以用 Homebrew：

brew tap poco-ai/agentero
brew install --cask agentero

Linux 需要 Ubuntu 22.04+ 及 webkit2gtk 4.1，完整依赖见安装文档。CLI 是单独的 Homebrew formula：

brew tap poco-ai/agentero
brew install agentero
agentero --help

README 覆盖了桌面端和 CLI 的安装，但没有给出完整的首次使用流程（导入论文、批注、再向 Agent 提问），后续步骤需要查阅在线文档。

使用约束

运行需要桌面环境，Linux 用户要满足 WebKit 依赖。Agent 功能依赖本地运行的 ACP 兼容 Agent，外部 MCP 客户端是独立产品。远程访问通过 SSH 隧道完成，多设备同步需要 S3 兼容存储桶。文献与笔记以 PDF、Markdown 标准文件保存在本地文件夹中，不使用私有数据库；可一键导入 Zotero 书库并保留标签、笔记与附件，支持导出 BibTeX/BibLaTeX。项目采用 MIT 协议，第三方组件清单单独列出。

HotRepo 点评

在 2026-11-08 的 TypeScript 日榜中，Agentero 位列第 13，当天新增 175 Star，累计 1,951 Star、124 Fork。目前只有这一条快照记录，只能说明单日情况，不足以判断走势。项目的功能落点比较具体——结构化提取、ACP Agent、MCP Server、Zotero 导入和纯文件存储——对于已经在用本地 Agent、希望把文献库当作共享上下文层的科研人员，这些设计有清晰的对应关系。

项目源码与说明