# QQzot

QQzot 是从 QQnote 中拆分出来的 Zotero 专用 skill。它负责 Zotero 侧的文献库操作，避免 QQnote 同时承担 Zotero、Obsidian、Dataview 和笔记维护，导致职责过重。

## 职责范围

QQzot 负责：

- 检索 Zotero 本地文献库。
- 使用 Zotero item key、DOI、题名、作者和年份定位文献。
- 生成 Zotero AI child notes。
- 审计哪些 Zotero 条目缺少 AI child notes。
- 将指定 Zotero 文献汇总为 Markdown 对比表。
- 为 qqcites、qqsci 和 QQnote 提供 Zotero 侧的文献输入。

QQzot 不负责：

- Obsidian 文献笔记组织。
- Dataview 文献看板。
- Markdown 笔记清理。
- 论文写作和科学逻辑判断。
- 按句子推荐引用文献。

## 与其他 QQ Skill 的分工

| Skill | 职责 |
|---|---|
| QQzot | Zotero 文献库、item key、AI child notes、Zotero 元数据和文献表格 |
| QQnote | Obsidian 文献笔记、Markdown 组织、Dataview 看板和 vault 维护 |
| qqcites | 按句子或 claim 推荐引用、排序、去重和验证 |
| qqsci | 论文写作、科学逻辑、故事线、claim-evidence 和审稿风险 |
| qqwrite | Word 模板、排版、插图、批注和投稿文件执行 |

## 常用场景

- “帮我查 Zotero 里有没有这篇文献。”
- “给这些 Zotero key 生成 AI 笔记。”
- “审计一下哪些文献还没有 AI child note。”
- “把这几篇 Zotero 文献整理成对比表。”
- “先从 Zotero 找候选文献，再交给 qqcites 排引用。”

## 内置脚本

| 脚本 | 用途 |
|---|---|
| `scripts/generate_zotero_ai_note.py` | 为 Zotero 条目生成 AI child notes |
| `scripts/audit_zotero_ai_notes.py` | 审计缺失的 Zotero AI child notes |
| `scripts/summarize_zotero_table.py` | 将 Zotero 条目汇总为 Markdown 对比表 |

## 运行前提

- Zotero Desktop 已打开。
- Zotero Local API 可访问：`http://127.0.0.1:23119`。
- 需要写入 Zotero Web API 时，环境变量中存在 `ZOTERO_API_KEY`。
- 需要调用 LLM 生成笔记或表格时，使用 AwesomeGPT 或 DeepSeek 相关环境配置。

不要把 API key 写入 skill 文件、Obsidian 笔记、Git 提交、终端输出或聊天记录。