cli-anything-zotero

cli-anything-zotero

cli-anything-zotero 是面向 Agent 的 Zotero 桌面版 CLI。它不会重新实现 Zotero，而是组合使用 Zotero 实际的本地接口：

安装

pip install -e .

入口点

cli-anything-zotero
python -m cli_anything.zotero

重要限制

• search items、item export、item citation 和 item bibliography 需要启用 Zotero 的 Local API。
• note add 依赖正在运行的 Zotero GUI 上下文，并要求应用中选中同一个文库。
• 导入时的 PDF 附件支持仅限于在同一连接器会话中创建的条目；为任意现有条目上传附件目前仍不在支持范围内。
• 实验性 SQLite 写入命令仅限本地、仅限用户文库，应视为不稳定的高级用户操作。
• 如果不同文库中存在重复的裸键，请在后续命令执行前运行 session use-library <id>。

命令组

应用

应用和运行时检查命令。

命令	描述
status	执行 status。
version	执行 version。
launch	执行 launch。
enable-local-api	执行 enable-local-api。
ping	执行 ping。

分类

分类检查和选择命令。

命令	描述
list	执行 list。
find	执行 find。
tree	执行 tree。
get	执行 get。
items	执行 items。
use-selected	执行 use-selected。
create	执行 create。

条目

条目检查和呈现命令。

命令	描述
list	执行 list。
find	执行 find。
get	执行 get。
children	执行 children。
notes	执行 notes。
attachments	执行 attachments。
file	执行 file。
export	执行 export。
citation	执行 citation。
bibliography	执行 bibliography。
context	执行 context。
analyze	执行 analyze。
add-to-collection	执行 add-to-collection。
move-to-collection	执行 move-to-collection。

搜索

已保存搜索的检查命令。

命令	描述
list	执行 list。
get	执行 get。
items	执行 items。

标签

标签检查命令。

命令	描述
list	执行 list。
items	执行 items。

样式

已安装 CSL 样式的检查命令。

命令	描述
list	执行 list。

导入

官方 Zotero 导入和写入命令。

命令	描述
file	执行 file。
json	执行 json。

笔记

读取和添加子笔记。

命令	描述
get	执行 get。
add	执行 add。

会话

会话和 REPL 上下文命令。

命令	描述
status	执行 status。
use-library	执行 use-library。
use-collection	执行 use-collection。
use-item	执行 use-item。
use-selected	执行 use-selected。
clear-library	执行 clear-library。
clear-collection	执行 clear-collection。
clear-item	执行 clear-item。
history	执行 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

版本

0.1.0

---

学术研究技能集成

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

cli-anything-zotero skills list              # List all skills
cli-anything-zotero skills list -c writing   # Writing skills only
cli-anything-zotero skills pipeline original_article  # Recommended workflow
cli-anything-zotero skills journal "Nature"  # Journal figure guide

技能类别

类别	技能	描述
搜索	lit-review, systematic-review, deep-search	文献发现
研究	ideation, brainstorming, hypothesis, deep-research	研究设计
写作	write-paper, manuscript, citation, outline, revision	论文写作
评审	full-review, peer-review, seven-pass, verify-citations, audit-data	同行评审
可视化	slides, schematics, poster, nature-fig	图表与演示文稿
分析	eda, statistics, critical-thinking	数据分析
流程	full-pipeline, research-to-paper	端到端工作流

任务流程

任务	步骤
文献综述	systematic-review → critical-thinking → write-paper → seven-pass
原创论文	hypothesis → statistics → manuscript → schematics → slides → full-review
元分析	deep-search → deep-research → statistics → write-paper → peer-review
学位论文	full-pipeline → seven-pass → slides → poster