>-

cli-anything-zotero 是一个面向智能体（agent-native）的 Zotero 桌面版命令行界面（CLI）。它并不重新实现 Zotero，而是组合 Zotero 真实的本地接口，让用户和智能体可以通过命令行操作本地 Zotero 库。

安装

pip install -e .

入口点

cli-anything-zotero
python -m cli_anything.zotero

主要能力（命令组）

App（应用与运行时检查）

• status：执行 status
• version：执行 version
• launch：执行 launch
• enable-local-api：执行 enable-local-api
• ping：执行 ping

Collection（分类查看与选择）

• list：执行 list
• find：执行 find
• tree：执行 tree
• get：执行 get
• items：执行 items
• use-selected：执行 use-selected
• create：执行 create

Item（条目查看与渲染）

• list、find、get、children、notes、attachments、file、export、citation、bibliography、context、analyze、add-to-collection、move-to-collection

Search（保存的搜索查看）

• list、get、items

Tag（标签查看）

• list、items

Style（已安装 CSL 样式查看）

• list

Import（官方 Zotero 导入与写入）

• file、json

Note（子笔记读取与添加）

• get、add

Session（会话与 REPL 上下文）

• status、use-library、use-collection、use-item、use-selected、clear-library、clear-collection、clear-item、history

使用示例

查看运行时状态（Zotero 路径与后端可用性）：

cli-anything-zotero app status --json

读取当前选中的分类（持久化 Zotero GUI 中选中的分类）：

cli-anything-zotero collection use-selected --json

渲染引用（使用 Zotero Local API）：

cli-anything-zotero item citation <item-key> --style apa --locale en-US --json

添加子笔记（在已有 Zotero 条目下创建子笔记）：

cli-anything-zotero note add <item-key> --text "Key takeaway" --json

构建 LLM 上下文（为下游模型分析组装结构化上下文）：

cli-anything-zotero item context <item-key> --include-notes --include-links --json

重要限制

• 条目搜索、条目导出、条目引用和条目参考文献功能需要启用 Zotero 的本地 API。
• note add（添加笔记）依赖 Zotero GUI 实时上下文，并期望在应用中选中同一库。
• 导入时的 PDF 附件支持仅限同一连接会话中创建的条目；对任意已有条目上传附件仍不在支持范围内。
• 实验性 SQLite 写入命令仅限本地、仅限用户库，应视为非稳定的高级用户操作。
• 如果同一裸 key 在多个库中重复，请先在后续命令前设置 session use-library <id>。

学术研究技能集成

Zotero harness 集成了 27 项学术研究技能，使用 skills 命令组：

cli-anything-zotero skills list              # 列出所有技能
cli-anything-zotero skills list -c writing   # 仅写作类技能
cli-anything-zotero skills pipeline original_article  # 推荐工作流
cli-anything-zotero skills journal "Nature"  # 期刊图表指南

技能分类

• search：lit-review、systematic-review、deep-search（文献发现）
• research：ideation、brainstorming、hypothesis、deep-research（研究设计）
• writing：write-paper、manuscript、citation、outline、revision（论文写作）
• review：full-review、peer-review、seven-pass、verify-citations、audit-data（同行评审）
• visualization：slides、schematics、poster、nature-fig（图表与演示）
• analysis：eda、statistics、critical-thinking（数据分析）
• pipeline：full-pipeline、research-to-paper（端到端工作流）

任务流水线

• literature_review：systematic-review → critical-thinking → write-paper → seven-pass
• original_article：hypothesis → statistics → manuscript → schematics → slides → full-review
• meta_analysis：deep-search → deep-research → statistics → write-paper → peer-review
• thesis：full-pipeline → seven-pass → slides → poster

版本

0.1.0