Skip to content
poco-aiPublic

About

Unified research workspace for humans & agents — PDF Q&A with citations, Vault, writing. 为人与 Agent 协作的科研工作台;补齐 Zotero 时代的人机上下文断点。

Topics

Resources

Contributing

Stars

2.7k stars

Watchers

2 watching

Forks

Latest commit

 

History

4,676 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agentero

用来找论文、做笔记和跟 Agent 一起读文献的科研工作台

论文、笔记和对话记录保存在本地。读 PDF 时,可以把选中的原文、图表或笔记发给 Agent 一起分析。

中文 | English

stars release license website docs

poco-ai%2FAgentero | Trendshift poco-ai%2FAgentero | Trendshift

如果本项目对你有帮助,请在右上角给个 star 吧!

Give me a star


背景与设计初衷

很多人用 Zotero 整理论文。它的文献管理功能成熟,也有丰富的插件。

开始用 Agent 一起读论文时,麻烦往往出在几个工具之间。

  • 来回复制资料。 论文放在 Zotero,笔记写在 Obsidian,讨论留在网页对话里。想请 Agent 对照原文和之前的笔记,经常得在几个应用间复制粘贴。
  • PDF 里的结构容易读错。 双栏的阅读顺序、跨页表格和公式都可能解析错。转成 Markdown 和 LaTeX 后,模型更容易读到这些结构。
  • 常用功能要分别配置。 用 AI 读论文、翻译全文、同步笔记,往往要装几个插件,升级后还要检查能不能继续用。
  • 搜到一批论文后,还要逐篇保存。 用 Deep Research 或自动化工具找论文很快,但把结果加进自己的论文库常常还得手动操作。

可以继续用 Zotero 整理文献,在 Agentero 里做需要结合原文、笔记和对话的工作。让 Agent 先筛摘要、查论文信息、提取图表和公式、梳理引用或整理要点,自己回到原文细读,判断证据能支持什么结论。


核心功能

1. 结构化阅读与笔记系统

  • 读 PDF 和做批注。 用目录跳到指定章节,按整页或页宽显示 PDF,也可以划词、高亮、写批注或搜索全文。
  • 提取图表和公式。 把公式、算法伪代码和表格解析成 Agent 能读取的 Markdown 和 LaTeX。
  • 写能跳回原文的笔记。 在可视化 Markdown 编辑器里,通过 [[双链]] 关联笔记和论文,输入 / 查找插入命令,也可以实时预览 LaTeX 公式。
  • 翻译选区、单页或全文。 可以并排看原文和译文。用内置翻译服务,也可以配置自己的 API Key(BYOK)。

PDF 阅读与 Agent 伴读
左栏读原文、做批注,右栏把选中的内容交给 Agent 提问。

划词翻译与笔记联动
在 PDF 上划词翻译,顺手把读到的要点记进 Markdown 笔记。


2. 开放的 Agent 协议与自动化接口

  • 用 ACP 连接 Agent。 通过 Agent Client Protocol 使用本机上的 Claude Code、OpenCode、Codex 等 Agent,也可以用支持本地模型的 Agent。发送消息时,问题和选入的材料会交给所选 Agent,数据处理方式取决于它的配置。
  • 通过 MCP 访问文献库。 开启内置的 Model Context Protocol 服务后,可以让 ChatGPT Web、Claude Desktop 等支持 MCP 的客户端查询知识库。不同客户端有各自的连接方式。
  • 用 CLI 批量处理文献。 在终端或脚本里导入论文、提取元数据或写入笔记。

内置 MCP 连接
开启 MCP 后,可以把本地文献库接到支持 MCP 的客户端。


3. 学术雷达与文献发现

  • 浏览新论文。 在应用内浏览 Cool Papers 和魔搭社区的论文,或添加 RSS 订阅。看到感兴趣的论文,可以存到自己的库里。
  • 看每天的 arXiv 推荐。 arXiv Daily 参照库里论文的摘要,为当天的新论文排序。
  • 顺着引用找论文。 从解析出的参考文献里批量选论文入库,可以补齐出版商元数据,也能反过来查有哪些新论文引用了库里的文章。

Cool Papers 集成
应用内直接浏览 Cool Papers 热门论文并一键导入本地知识库


4. 兼容 Zotero 生态与本地透明存储

  • 从 Zotero 迁移和收集论文。 可以选要导入的条目和附件,保留已有标签和笔记,也可以用 Zotero 浏览器扩展保存网页上的论文。支持导出 BibTeX / BibLaTeX。
  • 文件可以直接打开。 论文和笔记以 PDF 和 Markdown 保存在知识库文件夹里,用其他工具也能读。论文库的结构化元数据保存在 .agentero/catalog.sqlite。
  • 同步或打开远程库。 可以用 S3 兼容的存储服务同步多台电脑上的知识库,也可以通过 SSH 打开服务器上的知识库。

界面与功能预览

点击展开:查看更多界面截图(RSS 订阅、技能扩展、Agent 配置、S3 云同步、主题风格)

1. 学术 RSS 订阅

订阅常看的学术博客和实验室主页,在应用里查看更新。

RSS 订阅

2. Agent 技能(Skill)扩展

浏览并安装社区提供的 Skill,用来精读论文或辅助写作。

Skill 扩展

3. Agent 与连接配置

在同一个设置页管理、升级和切换通过 ACP 连接的 Agent。

Agent 设置

4. S3 兼容云存储同步

给几台电脑接上同一个 S3 兼容存储,就可以同步知识库。

S3 同步设置

5. 多套界面主题

可以选浅色或深色主题、调整配色,也可以跟随系统外观。

主题配置


快速开始

桌面客户端安装 (macOS / Windows / Linux)

从 官网 agentero.app 或 GitHub Releases 下载与你的电脑匹配的安装包。

macOS (Homebrew)

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

Linux 用户须知:系统环境要求 Ubuntu 22.04+(依赖 webkit2gtk 4.1),详细依赖说明请参考 安装文档。


命令行工具 (CLI)

想在终端或脚本里管理文献,可以用 Homebrew 安装命令行工具。

brew tap poco-ai/agentero
brew install agentero

# 查看常用命令与参数
agentero --help

在更多地方使用 Agentero

  • DeepSeek Harness (dsh) 插件:在 DeepSeek Harness 中也能直接使用 Agentero 的文献库、笔记与 PDF 阅读器。执行 dsh plugin --profile web add @poco-ai/agentero-dsh 安装,详见 agentero-dsh-plugin。

致谢与社区

用户交流群

Agentero 用户群二维码
扫码加入微信群:使用心得、问题反馈与版本预告。二维码 7 天内有效,过期请在 Issue 留言。

如果 Agentero 对你的日常学术研究有所帮助,欢迎在 GitHub 上为本项目点亮一个 ⭐ Star。

感谢所有贡献者!

contributors img Made with contrib.rocks

Star History

Star History Chart

开源许可证

本项目基于 MIT License 协议开源。第三方组件与许可证清单见 .github/THIRD_PARTY_NOTICES.md。

About

Unified research workspace for humans & agents — PDF Q&A with citations, Vault, writing. 为人与 Agent 协作的科研工作台;补齐 Zotero 时代的人机上下文断点。

Topics

Resources

Contributing

Stars

2.7k stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages