Linux 需 Ubuntu 22.04+ 且依赖 webkit2gtk 4.1,版本不符可能装不上;Agent 功能需另行配置本地运行的 Agent(如 Claude Code、Codex);翻译自定义通道需自备 API Key
Agentero
poco-aiMIT活跃维护面向科研场景的人机协作工作台,支持 PDF 带引用问答、文献库管理和写作,补上 Zotero 与 AI Agent 之间的上下文断点。
Unified research workspace for humans & agents — PDF Q&A with citations, Vault, writing. 为人与 Agent 协作的科研工作台;补齐 Zotero 时代的人机上下文断点。
brew tap poco-ai/agentero
brew install --cask agenteroREADME 未说明显存或 GPU 要求;桌面客户端支持 macOS、Windows、Linux,Linux 需 Ubuntu 22.04+ 并依赖 webkit2gtk 4.1
为人与 Agent 协作设计的本地科研工作台,把 PDF、笔记和 Agent 上下文统一沉淀在本地
面向科研场景的人机协作工作台,支持 PDF 带引用问答、文献库管理和写作,补上 Zotero 与 AI Agent 之间的上下文断点。
核心能力
- PDF 阅读批注与全文检索,自动提取公式表格为 Markdown/LaTeX
- 基于 ACP 协议连接 Claude Code、Codex 等本地 Agent
- 内置 MCP Server,让外部 AI 客户端调用本地文献库
- 一键导入 Zotero 库并保留标签、笔记与附件
- 文献与笔记以标准 PDF/Markdown 存于本地文件夹
容易踩的坑
- v0.15.3Agentero v0.15.3最新正式版2026-11-08 · 2026-11-08 23:58 UTC
概要
本次发布把 Agent 回复从纯 Markdown 扩展到只读结构化 UI 块,PDF 划词翻译改为可固定、可拖动的浮卡,广场订阅条目可以直接交给 Agent;同时补齐 CLI 的订阅源命令与 discover 关键词 OR 能力,并修复 Zotero 迁移、广场嵌入页、快速对话和 PDF 翻译链路的一批问题。
新功能
- Agent 回复中的只读 UI 块: 助手回复里行首独立的
openui-lang围栏会解析成只读组件,覆盖布局、文本、状态、数据、论文阅读与流程;配色跟随主题 token,图表在 320px 侧栏内仍可读,组件签名随内置 skill 下发。(#1007 by @ffy6511) - PDF 划词翻译浮卡: 翻译结果以浮卡显示,可拖动、缩放和复制,滚动或缩放 PDF 时保留;Esc 关闭、P 固定,顶部预览原文并可跳回选区,同一阅读器只保留一张卡片。(#974 by @ffy6511)
- 广场订阅条目加入对话: RSS 列表的右键菜单和详情页工具栏新增「加入对话」,整条条目(标题与摘要或全文)作为引用 chip 直接进入 Composer。(#955 by @HenryLoveMiller)
- CLI 订阅源命令: 新增
agentero feed list/add/remove/refresh/items/read六个子命令,与桌面端共享抓取管线和 feeds.sqlite,返回稳定错误码,支持 cron 增量拉取。(#969 by @HenryLoveMiller)
改进
- Antigravity 改用原生
agy acp: 不再下载独立的 ACP server,直接复用本机agy acp与已有登录态,并解除 macOS Intel 的架构限制。(#1011 by @bet4it) - Markdown 源码切换收进状态栏: 渲染与源码的切换固定在编辑器状态栏左端,两处工具栏的重复入口移除,快捷键提示与按下状态保留。(163eb4ea6 by @ffy6511)
- CLI discover 支持关键词 OR:
--match any(MCP 对应keywordMatch)把多个关键词用 OR 合并,多词雷达不再召回归零,默认仍是 AND。(#971 by @HenryLoveMiller)
修复
- 广场嵌入页适应面板并支持缩放: 默认等比适配面板宽度,工具栏提供 25%–200% 手动缩放,点击百分比恢复自动适应,尺寸变化不重载 iframe。(#1005 by @W-RMSL)
- 切换标签不再丢广场页面: 已激活的嵌入页在切换工作区标签或分屏焦点后保持挂载,iframe 与页内状态不丢,后台标签仍按需加载。(#989 by @W-RMSL)
- Zotero 迁移不再被路径检查中断: 选择主目录下的新知识库时,父目录探测停在文件访问范围边界,不再抛 forbidden path。(#996 by @YasyaKarasu)
- 快速对话保持常显且可调整: 指针离开、滚动或缩放 PDF 后卡片仍在,可拖拽改变大小,长公式可横向滚动并受窗口边界约束。(#992 by @Aschenbath)
- 经管期刊等级不再丢失: EasyScholar 返回的 FMS 与 UTD24 在标签投影时保留,同一收录值只显示一次。(#1013 by @Aschenbath)
- Agent 回复里的 Mermaid 与表格: Mermaid 围栏改用共享渲染器;表格全屏改为应用内浮层,Esc 关闭。(176bfeda2 / 4f5f2a8c5 by @ffy6511)
- 本地技能出现在
/菜单: 斜杠菜单合并本地 SKILL.md 列表,选中后插入技能 token,ACP 命令仍优先。(cc8e7634f by @ffy6511) - ACP 命令前缀保持原样: 按 agent 声明的
$name形式插入和发送,只认$skill的 agent 不再拒绝/skill。(21497e578 by @ffy6511) - 最小化窗口可以重新唤起: Windows 下从齿轮再次打开设置等单例窗口时,先恢复、显示再聚焦。(1138d198a by @ffy6511)
- 删除论文不再残留 catalog 行: 文件夹已不存在的条目会在删除时一并清理,不再长期显示为缺少 PDF。(75aa1fb7f by @qychen2001)
- 浅色主题下引用标签可读: 去掉 muted 文字色覆盖,Twitter 浅色主题下引用标签不再显示为黑块。(#990 by @W-RMSL)
- 编号公式可以定位: 公式编号从 layout 的
\tag{N}解析,旧索引缺少公式时#formula=N也能找到页内公式。(92c4aae28 by @ffy6511)
已解决问题
- 分栏翻译没有进度: 双栏翻译面板现在显示翻译进度,长文档翻译时不再只剩空白面板。(#994 by @ffy6511)
- 全文翻译分栏报错: 渲染前等待译文显示文档就绪,全文翻译不再因分栏报错或出现空白页。(#991 by @ffy6511)
- 快速对话回复丢失: marks 刷新不再用语料库快照覆盖进行中的问答,已生成的回复在刷新后仍在。(#945 by @ffy6511)
Full diff: https://github.com/poco-ai/Agentero/compare/v0.15.2...v0.15.3
Summary
This release extends Agent replies from plain Markdown to read-only structured UI blocks, turns PDF selection translation into a pinnable floating card, and lets Plaza feed items go straight to the Agent. It also adds CLI feed subscriptions and OR keyword matching for discover, and fixes a batch of issues across
- Agent 回复中的只读 UI 块: 助手回复里行首独立的
- v0.15.2Agentero v0.15.22026-11-07 · 2026-11-07 16:41 UTC
查看更新说明
概要
v0.15.2 围绕科研记录与写作:科研表格现在可以充当实验记录本,行有稳定注册号、时间和编辑者,人和 Agent 共用同一套校验;Markdown 面板内可直接切到源码视图编辑,并补齐工具栏、格式快捷键与光标、行号对齐。全文翻译加入字符 IR 与译文 PDF 两级持久缓存,译文页改走与原文相同的渲染路径;广场接入 Papers with Code,论文侧栏链接拆成两行并新增 Hugging Face。更新提示与关于页可以查看 Release 详情,分屏笔记不再静默覆盖,默认翻译和正文解析分别固定为腾讯交互翻译与本地引擎。
新功能
- 实验记录表格: 科研表格成为实验数据的记录方式,行带稳定注册号、时间和编辑者,人和 Agent 走同一套校验;Agent 用
table_query/table_upsert/table_update_cells按注册号和字段名读写,写入校验修订号。新建实验记录会同时生成 Markdown 笔记与内嵌的结果表,侧栏只显示名称并由图标区分类型,表格底栏显示有多少笔记在引用它。(#951 by @qychen2001) - Markdown 内联源码模式: 在同一面板用
⌘//Ctrl+/在渲染视图与可编辑源码之间切换,源码直接保存原文,支持 Markdown/GFM、frontmatter、表格、公式与围栏代码高亮,复用自动保存、⌘S、保存冲突和外部改盘逻辑,切回时保留光标与视口。源码视图另有标题、引用、列表、图片、查找与导出工具栏,以及Mod-B/Mod-I/Mod-U/Mod-Shift-X格式快捷键。(#964 by @ffy6511) - 全文翻译持久缓存: 字符级 IR 与整篇译文 PDF 分两级落盘,缓存键覆盖 PDF/layout 内容、实际译文、字体与管线版本。重启后再翻译,准备阶段从约 3.1 秒降到 0.13 秒;开启译文 PDF 缓存后整篇构建也可直接复用(单篇约 25 MB)。两类缓存可在设置 → 翻译分别开关(IR 默认开、译文 PDF 默认关),关于页展示占用、提供打开缓存目录与一键清理。(#978 by @ffy6511)
- 译文页原生渲染: 整篇翻译完成后,译文页改用与原文页相同的渲染层按显示尺寸和 DPR 绘制,缩放会重新渲染而不是拉伸固定预览图;隐藏后再显示译文也不会重走生成页面或重建 PDF。(#978 by @ffy6511)
- Papers with Code 广场: 广场新增 paperswithcode.co 会议页面来源,论文卡片和详情操作行可直接导入;arXiv 论文保留 arXiv id 并复用现有 PDF/TeX 资产链,外部论文以
pwc-<catalog id>入库,导入后按 arXiv id 补齐 publication、代码仓库、引用数和摘要。(commit / commit by @Phil-Fan) - 论文侧栏链接与 Hugging Face: 论文信息链接拆成两行,第二行新增由 arXiv id 推导的 Hugging Face 页面;OpenReview 链接改用红色字母 O 标记。(commit / commit by @Phil-Fan)
改进
- 更新详情入口: 启动更新提示、标题栏和设置 → 关于新增待更新版本的 Release 详情入口,manifest 没有 notes 时也能查看完整说明,安装入口保持不变。(#979 by @Aschenbath)
- 默认翻译与正文解析: 新装及旧设置缺少 provider 时默认使用腾讯交互翻译,正文解析默认固定为本地引擎;用户已显式保存的有效选择保持不变。(#967 / #963 by @Aschenbath)
- 依赖安全补丁: 升级 lodash 与 minimatch,并通过 vendored tesseract-rs、realtime-tex 把 zip 与 lopdf 移到已修复版本,清掉相关安全公告。(commit / commit by @Phil-Fan)
修复
- 分屏笔记静默覆盖: 按面板区分 Markdown 保存所有权,干净的兄弟面板自动刷新;有改动的面板保留草稿并阻止保存,可明确选择保留草稿或载入磁盘版,渲染态与源码态都适用。(#970 by @Aschenbath)
- 选区浮窗尺寸: 高 PDF 缩放下翻译与 Ask 浮窗不再跟着放大,共享浮卡固定为 UI 尺寸与字号,选区屏幕锚点、翻转与视口限位保持不变。(#948 by @Ryan119911)
- Markdown 工具栏闪烁: 修复特定面板宽度下 ResizeObserver 自反馈导致按钮反复显隐、固定按钮左右跳动的问题;面板折叠或尚未布局时不再隐藏全部按钮。(commit by @Phil-Fan)
已解决问题
- 源码模式光标定位: 源码与渲染切换时把光标映射到准确字符位置,不再重置到文档开头。(#977 by @ffy6511)
- 源码模式行号宽度: 行号收进居中源码区并改用更小的等宽字体,不再溢出编辑器最大宽度。(#966 by @ffy6511)
- Windows Zcode Skill 索引: Zcode serve 模式忽略 ACP 会话 cwd 时改从进程 cwd 扫描
.agents/skills,Windows 上的 Vault skill 可正常索引。(#936 by @JiaheChen2002)
Summary
v0.15.2 centers on lab records and writing. Research tables now double as experiment notebooks, with stable registration numbers, timestamps, and editors per row and one validation path for people and agents; Markdown panels can switch inline to an editable source view, with a full toolbar, formatting shortcuts, and caret and line-number alignment. Full-text translation gains two persistent caches (character IR and finished PDF) and draws translated pages through the same renderer as source pages; the plaza adds Papers with Code, and paper sidebar links split i
- 实验记录表格: 科研表格成为实验数据的记录方式,行带稳定注册号、时间和编辑者,人和 Agent 走同一套校验;Agent 用
- v0.15.1Agentero v0.15.12026-11-07 · 2026-11-07 01:37 UTC
查看更新说明
概要
v0.15.1 把论文库、实验记录与远程协作接到一起:科研表格可以像笔记一样存进 Vault 并在笔记中内嵌预览,本地 Agent 会话可以把任务委派给已连接的远程 Vault,Agent 设置新增 Pi 项目信任与腾讯 CodeBuddy Code。论文现在可以链接或复制到其他文件夹与 Vault,翻译服务短暂不可用时网页导入不再失败。同期修掉了整篇翻译的启动与进度、PDF 翻译选区、中文论文目录在 Library 里互相隐藏、写作预览编译后跳回首页等问题。
新功能
- 科研表格: 文件树右键即可新建
*.table.json,用 Glide 网格编辑文本、带单位的数值、布尔、日期与单选字段,支持从 Excel 粘贴矩形区域、撤销重做和 CSV 导出。笔记里用/table嵌入只读预览,表格与笔记各自保存。(commit / commit by @qychen2001) - 远程 Vault 任务委派: 本地 ACP 会话可以把任务交给已连接远程 Vault 上注册的 CLI Agent,复用现有的 SSH 会话,不必在服务器上再跑一个 Agentero。(commit by @qychen2001)
- Pi 项目信任: 选中需要信任的本地 Vault 时,输入框上方出现可关闭的提示;信任只写入该 Vault 在 Pi
trust.json的条目,不改全局设置,并在下一轮用新进程重连。在 Pi 自己的 TUI 里做出的决定也会让提示消失。(commit / commit by @ffy6511) - 腾讯 CodeBuddy Code: Agent 设置新增 CodeBuddy 模板,走原生
codebuddy --acp,优先官方安装器、npm 兜底,支持卸载、版本检查与 Skill 提及。(commit by @Phil-Fan) - 论文链接到其他文件夹或 Vault: 同库内添加为共享文件和 catalog 行的别名,跨库则复制一份到目标库、源论文留在原位;删除别名不会删掉原论文。CLI 同步新增
agentero paper add。(commit / commit / commit by @JiaheChen2002) - 翻译服务中断时的网页导入: translator 返回 503 或 Cloudflare 1102 时先短暂重试;仍不可用且页面没有 DOI、arXiv ID、PMID 时,直接从页面本身导入,Toast 说明是已导入还是输入没保存。(commit / commit / commit / commit / commit by @JiaheChen2002)
改进
- 整篇翻译的启动与进度: 版面缓存已经就绪时立即开始翻译,不再等一次多余的重排;进度按已生成页面分批推进而不是一次跳变,计费进度也随之细化。(commit / commit / commit / commit by @JiaheChen2002)
- PDF 方向键滚动: 悬停或聚焦的阅读器接管上下方向键——连续布局约滚一个正文块,分页与横向布局翻到上一页/下一页;输入框、菜单、文件树和对话框保持原生方向键行为。(commit by @Phil-Fan)
- 补齐资源前先预览: 批量补齐按“下载原文 / 解析正文 / 修复本地状态”分类列出,确认后只入队选中的论文,修复类条目在预览阶段就地处理。(commit by @ffy6511)
- 统一的交互外观: 浮层、面板、空状态、列表行与选区工具条改用共享原语,新增 elevation 层级,悬停反馈与菜单密度在全应用收敛。(commit / commit / commit by @ffy6511)
- OpenAI 决策模型预设: 选中 OpenAI 后,System One 请求会适配
/v1/decisions的input与questions结构,只填/v1也会自动补全,测试连接不再报 400 或 404。(#930 by @W-RMSL) - 条目标题的内联 HTML: 标题里的斜体、上标等内联标签按富文本渲染,不再显示成字面标签。(commit by @qychen2001)
- 写作预览保持位置: 编译成功不再重建 PDF 预览组件,页码和缩放原样保留。(commit by @qychen2001)
修复
- 科研表格: 文件树右键即可新建
- v0.15.0Agentero v0.15.02026-11-04 · 2026-11-04 07:21 UTC
查看更新说明
概要
v0.15.0 把写作与 PDF 深度阅读串成一条完整工作流:写作项目可以独立绑定 GitHub 仓库,PDF 新增章节与段落级引用、嵌入阅读器内的共享批注,以及 arXiv HTML 页面加载。同期加入自定义快捷键、论文代码仓库识别、论文库文本属性与精读 Agent 席位,并集中修复 Windows 编译与进程清理,以及 PDF 渲染、缩放和翻译相关问题。
新功能
- 项目级写作与 GitHub 同步: 写作项目移到论文库下方,项目目录、源码、资源与编译后的 PDF 共用一套源码/预览工作区;每个项目可以单独绑定并同步到自己的 GitHub 仓库。(commit / commit by @qychen2001, @Phil-Fan)
- 章节与段落级引用: 支持
paper.pdf#2.1#p3形式的引用,Agent 问答、Markdown 链接与双链使用同一套解析和临时高亮。(#879 by @ffy6511) - 内嵌 PDF 阅读器: 嵌入的 PDF 可以定位并高亮引用目标、共享原论文的批注与评论卡,并在不重新打开文档或重置缩放的情况下返回目标页。(commit / commit / commit by @ffy6511)
- 自定义快捷键: 设置页可以录制、清除、恢复和搜索快捷键,Cmd+L 与“加入对话”分开,macOS 菜单同步自定义键位。(commit by @ffy6511)
- 论文代码仓库识别: 从论文摘要、脚注和末页提取 GitHub 仓库,写入空的
code_repo,并记住手动修改过的值。(commit / commit by @JiaheChen2002) - CLI / MCP 论文元数据编辑: 可以通过 CLI 与 MCP 更新论文的出版物、标题、日期、DOI、arXiv ID 与作者列表,并同步写入 catalog 与
metadata.json。(#875 by @bet4it) - 论文库文本属性: 自定义属性新增 Text 类型,可直接在单元格里编辑复现备注、实验配置等自由文本。(#868 by @Immortal-Fates)
- 精读论文独立席位: 设置 → Agent → 精读论文可以单独选择 Agent 与模型,不再继承默认 Agent 或 ACP 默认模型。(#867 by @hanlife02)
- 外部终端选择: 选择终端应用时显示各自图标,未设置时使用首个已安装终端;Otty 打开窗口后自动置前。(commit / commit / commit by @Phil-Fan)
- Mermaid 图表: 笔记与 Agent 消息里的 Mermaid 代码块默认渲染为图表,主题色跟随明暗模式,悬停可复制源码或编辑。(commit / commit by @Phil-Fan)
- Windows Word 模板: 接入官方 Windows Word 模板,引用会写入当前打开的文档。(commit by @JiaheChen2002)
改进
- PDF 渲染与生命周期: 缩短复杂 PDF 的首屏高清渲染和框选等待,修复原生链接重复累积、连续切换文档时异步文档未释放,以及阅读器关闭后共享版面 ONNX 会话被销毁的问题。(#874 by @ffy6511, commit by @JiaheChen2002)
- 写作编译反馈: 编译按钮区分空闲、编译中、成功、失败与取消,失败不会再被完成状态覆盖;编译错误统一进入问题列表,失败时用警示按钮展示具体错误。(commit / commit / commit by @JiaheChen2002, @Aschenbath)
- PDF 叠加卡片随缩放: 页面翻译入口、右侧批注卡与 Ask / 翻译 / 视觉批注浮卡都按 PDF 缩放比例重新布局字号与图标,50% 时同步减半、300% 时同步放大。(#883 by @ffy6511)
- 侧边栏文件树: 重做行的 hover 与选中背景、图标内边距和操作按钮,点击非论文文件夹时保留当前树选中与 Library 范围。(#927 by @ffy6511, @Phil-Fan)
- Windows 兼容性: 对齐 WebView2 与 windows crate 版本,处理
\\?\扩展路径、.claude/skills链接、并发文件替换与进程树回收。(#908 / #922 by @Aschenbath, @Phil-Fan, @JiaheChen2002) - 依赖安全更新: 升级 zip、Tauri updater 与受 RustSec / npm 公告影响的依赖。(commit / commit / commit by @Phil-Fan)
- 新建文件默认 Markdown: 文件树新建文件默认使用
.md,没有扩展名时自动补全。(#851 by @V-IOLE-T) - PDF 选择工具栏: “加入对话”成为主按钮,“快速对话”收进菜单,批注入口移入颜色组并打开聚焦的批注编辑器。(commit / [commit](https://github.com/poco-ai/Ag
- v0.14.0Agentero v0.14.02026-10-27 · 2026-10-27 14:20 UTC
查看更新说明
概要
v0.14.0 把「写作」做成与阅读并列的主画面:会议模板、Git 同步、SyncTeX 双向定位与实时预览一并落地。阅读侧新增知乎 Agent、PDF 内嵌目录编辑、字符级全文翻译与译文导出、论文库自定义属性,并修复了导入刷新、翻译预览与 PDF 阅读中的多项性能与交互问题。
新功能
- 写作工作台与会议模板: 左侧栏在「阅读 / 写作」之间切换;
thesis/下每个文件夹是一个项目,内置 ACL、CVPR、ECCV、ICLR、ICML、NeurIPS 官方模板,支持项目文件的重命名、移动、上传、删除与主文件设定。(commit by @JiaheChen2002) - Git 同步与版本历史: 将整个
thesis/提交并推送到 GitHub,支持手动、每次编译后或每 5/15/30/60 分钟上传;历史标签可查看每版差异并回退,回退不会删除之后的上传记录,编译产物与 PDF 不上传。(commit by @JiaheChen2002) - SyncTeX 双向定位: 源码到 PDF 按非空选区跨行、跨栏、跨页高亮,PDF 双击或按钮可跳回源码;后退同步优先复用最近一次点击的页内位置。(commit by @Phil-Fan)
- 实时预览与编译面板: PDF 顶栏集中选择 LaTeX 引擎、切换实时预览与自动编译,保存源文件即触发编译;编辑器检查与编译日志合并为问题面板,可跳转到对应源码。(commit by @Phil-Fan)
- 知乎 Agent: 内置知乎 Agent,可检索知乎直答与标题结果;论文 Info 面板可生成「去知乎提问」草稿,确认后打开知乎,对话空态改为讨论卡片。(commit by @Phil-Fan)
- 全文翻译重排与导出: 全文翻译改为字符级重排,保护行内公式与表格文字,保留原页矢量内容,并可导出单语或双语译文 PDF。(#832 by @qychen2001)
- 论文库自定义属性: 表头可新增 Select 属性,管理选项与颜色、在单元格中快捷赋值,并持久化列显隐、列宽与顺序;定义同时写入
properties.json和 catalog。(#835 by @Immortal-Fates) - PDF 内嵌目录编辑: 在阅读器中增删、重命名、拖拽书签及其层级,选中文字即可创建书签,修改自动写回 PDF,其他阅读器也能看到目录结构。(commit by @qychen2001)
- 订阅未读与快捷入库: 广场订阅记录条目未读状态并支持只看未读,右键即可把文章直接导入论文库。(未读 / 入库 by @Phil-Fan)
- PDF 换页模式: 阅读 PDF 时可切换逐页翻阅,用翻页键或按钮按页移动,不再只能连续滚动。(commit by @Phil-Fan)
- 本地 HTML 预览: 在 Markdown 中点击 HTML 链接或打开
.html文件时,可在右侧面板预览本地页面。(commit by @Phil-Fan) - CLI 笔记抓取:
agenteroCLI 新增从 Cool Papers 抓取论文笔记并写入NOTES.md的能力。(commit by @Phil-Fan) - Agent 预设: 新增 Cursor Agent 原生 ACP 模板与 Qoder CN 预设,配置流程和版本检查同步覆盖这两个客户端。(commit by @Phil-Fan)
改进
- 导入刷新局部化: 导入或改名论文后只刷新目标论文列表与双链,不再按论文库规模做全量重扫;800 篇库的导入后处理由多次全库扫描降为毫秒级局部更新。(#845 by @ffy6511)
- 翻译预览增量与性能: 译文预览改为逐页重排,先译完的页优先显示;重排构建使用独立 PDFium 引擎并降低流式开销,缓解翻译时滚动卡顿。(commit by @qychen2001, @Phil-Fan)
- 设置页重组: 整合接入与 MCP 分组,将「远程访问」重命名为「移动访问」,EasyScholar 改为 provider 卡片,移除已废弃的镜像与手动 Cookie 选项,登录关闭后自动探测机构代理。(commit by @Phil-Fan)
- 入门引导: 本地桌面应用前置展示,新增 CLI Agent 标题与桌面端提示,并在配置 Agent 前检查 Node.js 运行时。(commit by @Phil-Fan)
- PDF 阅读细节: 点击阅读区自动收起大纲,书签悬停操作更紧凑并显示完整标题,侧栏底部预留底栏空间,保存书签不再重载阅读器。(commit by @qychen2001)
- 写作与编辑器打磨: 统一浮动源码工具条,CodeMirror 滚动条空闲自动隐藏,重做写作标签、上传与预览外观,并强化结构大纲层级。(commit by @Phil-Fan)
- arXiv 源码获取: 未保存版本时下载最新 arXiv 源码,并统一 LaTeX 源码的准备与阅读流程。(commit by @qychen2001)
- WebVPN 凭据: 登录验证后自动捕获 WebVPN Cookie,简化设置步骤并在过期时提醒更新。([commit](https:/
- 写作工作台与会议模板: 左侧栏在「阅读 / 写作」之间切换;
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
如果本项目对你有帮助,请在右上角给个 star 吧!
背景与设计初衷
Zotero 是学术管理领域非常优秀的软件。它功能成熟、生态稳定,帮助许多科研人员建立了最初的文献归档体系。
但在当下日常科研与深度使用各类 Agent 时,传统的文献工具链暴露出一些断点:
- 上下文严重分散:论文存储在 Zotero,笔记记在 Obsidian,与模型的推导和分析留在各个网页对话框中。三者数据彼此隔离,当需要 Agent 结合某篇具体论文与历史笔记进行深入推导时,用户必须反复手动复制粘贴。
- 文献格式对模型不友好:人类习惯阅读排版良好的 PDF 文件;但对于模型而言,直接解析双栏排版、跨页表格、复杂数学公式和交叉引用的成本极高,极易产生识别错误与幻觉。结构化 Markdown 与 LaTeX 才是模型容易准确理解的格式。
- 维护成本较高:AI 伴读、全文翻译、笔记同步等高频需求,往往需要安装和调试多个社区插件,配置门槛高且在版本升级时容易出现兼容性问题。
- 批量自动化能力有限:通过 Deep Research 或自动化检索工具发现的大量文献,目前仍需人工在浏览器中逐篇点击保存,难以顺畅衔接批量研究流。
Agentero 并非旨在替代 Zotero,而是探索一种人与 Agent 协同处理科研上下文的新方式:
- 人类负责:提出研究问题、进行学术价值判断、深度研读与核心结论推导;
- Agent 负责:批量检索筛选、元数据抓取、图表与公式提取、引用关系梳理及基础总结。
核心功能
1. 结构化阅读与笔记系统
- PDF 阅读与批注:提供大纲导航、整页与宽度自适应、平滑划词、高亮批注与全文检索。
- 图表与公式提取:自动解析论文中的数学公式、算法伪代码及表格,生成结构化 Markdown 与 LaTeX 内容,确保 Agent 调用时上下文准确无误。
- 双向链接笔记:内置所见即所得 Markdown 编辑器,支持
[[双链]]引用语法、/快捷指令与 LaTeX 实时渲染,笔记与文献建立原生关联。 - 多模式翻译服务:支持划词翻译、按页对照翻译与全文翻译,内置可用翻译通道,并支持配置自定义 API Key(BYOK)。
2. 开放的 Agent 协议与自动化接口
- 基于 ACP 协议连接本地 Agent:底层遵循 Agent Client Protocol,支持连接各类本地运行的 Agent(如 Claude Code、OpenCode、Codex 或本地模型),不绑定特定厂商,上下文完全保留在本地。
- 内置 MCP (Model Context Protocol):可作为 MCP Server 运行,允许 ChatGPT Web、Claude Desktop 等外部客户端直接检索并调用本地文献库作为上下文。
- 极客 CLI 支持:内置无头命令行工具,支持通过脚本实现批量导入文献、提取元数据与写入笔记等自动化工作流。
3. 学术雷达与文献发现
- 多渠道抓取:内置集成 Cool Papers 与魔搭社区,支持在软件内直接浏览并一键归档文献;支持学术 RSS 订阅。
- 个性化推荐:基于本地已有文献库的内容特征,自动推荐每日 arXiv 的相关最新论文。
- 引用关系自动梳理:自动解析文献末尾的参考文献列表,支持一键批量抓取入库;支持获取出版商元数据并追踪后续被引动态。
4. 兼容 Zotero 生态与本地透明存储
- Zotero 书库无缝迁移:支持一键导入整个 Zotero 数据库,保留已有标签、笔记与附件;兼容 Zotero 浏览器扩展直接保存网页论文;支持导出 BibTeX / BibLaTeX。
- 本地文件夹透明管理:不使用私有数据库或散列混淆目录,所有文献与笔记均以标准文件(PDF、Markdown)保存在本地规范文件夹中,可自由使用外部编辑器读取。
- 多端同步与远程访问:支持与 S3 兼容的云存储服务进行同步;支持通过 SSH 隧道访问部署在远程服务器上的文献库。
界面与功能预览
1. 学术 RSS 订阅
追踪关注的学术博客、实验室主页与前沿动态:
2. Agent 技能(Skill)扩展
浏览并安装社区提供的科研技能,扩展论文精读与写作分析能力:
3. Agent 与连接配置
通过 ACP 协议管理、升级和切换本地 Agent:
4. 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)
如需在终端或通过脚本自动化管理文献:
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。
致谢与社区
- 感谢 LinuxDo 与 ModelScope 魔搭社区 成员在项目早期测试阶段提供的建议与反馈。
- 感谢 AtomGit 提供的国内镜像支持。
用户交流群
如果 Agentero 对你的日常学术研究有所帮助,欢迎在 GitHub 上为本项目点亮一个 ⭐ Star。
感谢所有贡献者!
Star History
开源许可证
本项目基于 MIT License 协议开源。第三方组件与许可证清单见 .github/THIRD_PARTY_NOTICES.md。