Agentero

传统文献管理器对 Agent 并不友好：

• 阅读高亮和笔记被锁在单篇文件里，Agent 很难跨论文复用。
• 每次对话都要重新提供上下文，缺少稳定的本地知识地图。
• PDF 对人友好，但对 Agent 来讲不是最舒服的阅读材料。

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

功能

• BYOA（Bring Your Own Agent）：Agentero 只作为 ACP Client 连接用户本机 Agent，不绑定模型宿主。
  • 精读：入库 / 单篇 Download 后可自动 paper-reader；文件树 Eye 可手动；写 NOTES.md 并标记 is_read。
• 魔棒入库：与 Zotero 当中能力一致；catalog 权威 + 默认 PDF / arXiv TeX。
• 文档标签页：多文档 tab（⌘W 关标签；无标签时关窗口）；Library / PDF / 图片 / Markdown。
• Markdown 内嵌图片：粘贴 / 工具栏写入笔记旁 ./assets/；选中显示源码；删除节点可 GC 文件。
• 双链与知识图谱：Obsidian 当中的双链与知识图谱功能。
• 桌面原生体验：全局错误 Toast、后台任务条、多窗口。

当前状态：早期 MVP

Quick Start

桌面应用

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

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

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

CLI

Headless Vault / Catalog 机器接口：创建与发现库、列表与入库文献基础能力。不含 BYOA / Agent 运行时。

常用脚本

命令	说明
pnpm tauri dev	启动桌面开发应用
pnpm build	构建前端产物
pnpm tauri build	构建桌面安装包
pnpm demo:vault	生成 demo Vault（catalog schema v3 + 样例 paper / loose PDF / 图片）
cargo build -p agentero-cli	构建 CLI（bin agentero）
cargo test -p agentero-cli	CLI 集成测试
pnpm lint	TypeScript（Biome）+ Rust（clippy）检查
pnpm format	格式化 TypeScript + Rust

项目结构

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/development/cli.md）
├── templates/vault/      # Create Vault 脚手架（含 .agents/skills）
├── docs/                 # MkDocs 文档源文件
└── package.json

技术栈

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

贡献

欢迎提交 Issue 和 PR。

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

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

License

本项目使用 MIT License。

Star History