中文 | English

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

Context is everything。

如果说今天的模型是 $f$，越来越聪明，也越来越像。同一个 $f$，决定输出 $y$ 的，是输入 $x$，也就是 context。

但科研的 context 今天是碎裂的：PDF 和高亮批注可能在 Zotero 里，笔记在 Obsidian 里，你和 AI 的讨论、提问、方案留在对话框里。三者互不相通，再聪明的 Agent 也只能读到碎片。

所以我们做了 Agentero，旨在构建 Agent 友好、Agent 原生的文献管理方式，探索人与 Agent 在文献管理中的协作方式。

Agentero 是一个 Agent 时代的本地优先科研工作台，让输入、处理、输出三个环节都有 AI 参与。它不锁定具体 Agent 或模型——通过 ACP 接上你自己的本地 Agent（BYOA），工作上下文留在本地 Vault。

功能

• Agent 原生体验
  • 通过 ACP 连接本机 Agent，Agentero 不锁定具体 Agent 或模型，工作上下文留在本地 Vault
  • 支持快速安装、配置、卸载 Agent
  • 支持划词对话、论文导入与 Skill 导入，让 Agent 参与检索、阅读与整理工作流
  • 内置 CLI，支持导入论文、获取论文metadata、写入笔记、高亮等操作
  • 内置 MCP，可以链接 ChatGPT web 等
• 衔接 Zotero 生态：兼容 Zotero 生态的导入方式，支持从标识符、链接或浏览器插件保存论文。一键导入 Zotero 书库，保留标签、笔记和附件。随时导出 BibTeX / BibLaTeX，衔接 LaTeX 写作流程
• 论文导入
  • 支持软件内浏览 Cool Papers 网站并导入文献
  • 支持魔搭网站导入文献
  • 支持 RSS 订阅
  • 支持根据已有文献库推荐arXiv今日文献
  • 支持搜索论文名字导入
  • 支持 Zotero 浏览器插件导入文献
• 文献管理
  • 支持获取库中文献的出版商，支持一键查找引用库中文献的新文献
  • 解析论文的参考文献，并支持一键导入
  • 论文标签、筛选
  • 快速跳转对应 arXiv、alphaXiv 链接
• 文献阅读与记录
  • 所见即所得的Markdown笔记编辑
  • Markdown 双链语法与 / 快捷提示语法
  • 支持一键翻译、按页翻译、划词翻译，支持多种免费 API 以及 BYOK 的 API 翻译服务
  • 支持页码导航、适应宽/整页、大纲、⌘F 查找、平滑划词、高亮、批注、提问与翻译
  • 解析论文中的图、表、公式与算法，并结合上下文理解
• 云同步：支持 S3 兼容的云同步服务。
• 远程访问：通过 SSH 隧道浏览远程知识库，数据保留在用户自己的服务器上。
• 多系统兼容：Mac、Windows、Linux，快捷键与常用软件保持对齐，不改变使用习惯。
• 多种主题风格： 支持多种主题风格，满足不同用户需求。

界面预览

_{在应用内浏览 Cool Papers 并一键导入文献}

_{分屏阅读 PDF，右侧 Agent 随时总结、提问与翻译}

_{划词翻译、按页翻译，结合 Markdown 笔记整理要点}

_{订阅 RSS 源，追踪最新论文与博客动态}

_{浏览并安装社区 Skill，扩展 Agent 的论文阅读与写作能力}

_{通过 ACP 连接本机 Agent，安装、升级与切换默认 Agent}

_{内置 MCP，可将 Agentero 能力接入 ChatGPT 等外部客户端}

_{配置 S3 兼容存储，实现 Vault 云同步}

_{多种配色主题，支持跟随系统与界面缩放}

Quick Start

桌面应用

前往 Agentero 或 Releases 下载。

Linux 需 Ubuntu 22.04+（webkit2gtk 4.1）。详见 安装文档。

HomeBrew

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

CLI

HomeBrew

brew tap poco-ai/agentero
brew install agentero

开发

项目结构

agentero/
├── AGENTS.md             # 面向 Agent / 开发者的仓库指南
├── mkdocs.yml            # MkDocs 文档站配置
├── src/                  # React + TypeScript 前端
├── src-tauri/            # Tauri 2 + Rust Host（Vault、Wiki、ACP）
├── cli/                  # headless CLI（bin agentero；见 docs/backend/cli.md）
├── templates/vault/      # Create Vault 脚手架（含 .agents/skills）
├── docs/                 # MkDocs：usage / frontend / backend / development（草稿）
└── package.json

技术栈

• 桌面壳：Tauri 2
• 前端：React、TypeScript、Tailwind CSS、shadcn/ui、AI Elements
• 窗口管理： Dockview
• PDF： Embedded PDF
• 编辑器：Plate / Markdown
• Agent：Agent Client Protocol、BYOA

测试

git clone https://github.com/poco-ai/agentero.git
cd agentero
pnpm install

# 清除前端与 Rust 构建产物
pnpm clean

# 桌面应用（推荐）
pnpm tauri dev

# 仅前端预览（无原生 Vault / Agent 后端）
pnpm dev

贡献

欢迎提交 Issue 和 PR。

1. Fork 后创建功能分支。
2. 保持改动聚焦，并遵守现有 lint/format 设置（pnpm lint / pnpm format）。
3. PR 描述清楚改动内容和原因。

较大的想法请先开 issue 对齐范围。

License

本项目使用 MIT License。

Star History

致谢

感谢 LinuxDo 和 ModelScope 社区的支持与反馈。