QQnote-skill/README.md

3.3 KiB
Raw Permalink Blame History

MYwrite

这是一个用于 Zotero 和 Obsidian 文献阅读流程的 Codex skill。普通使用者不需要手动运行脚本只需要在 Codex 里用自然语言提出任务AI 会根据 SKILL.md 和配套脚本完成检查、生成、批处理或维护工作。

适合做什么

  • 在 Zotero 中为文献生成 AI 阅读笔记。
  • 把生成结果写成 Zotero 子笔记,而不是直接写到 Obsidian 文件夹。
  • 检查哪些 Zotero 条目还没有生成 AI 笔记。
  • 按指定条目、指定集合或小批量方式继续生成笔记。
  • 维护 Obsidian 文献阅读库、模板和 Dataview 视图。
  • 在不暴露 Zotero、DeepSeek 或 AwesomeGPT 密钥的前提下完成自动化处理。

使用前准备

  • 打开 Zotero Desktop。
  • 确认 Zotero Local API 可用。
  • 确认 Obsidian 文献库路径为 C:\Users\qyh15\Documents\Obsidian Vault
  • 确认 Zotero Web API key 和 DeepSeek/AwesomeGPT 配置已经放在本地私有配置中。
  • 不要把真实 API key 发到聊天、README、日志或任何会提交到仓库的文件里。

私有配置模板位于:

config/config.template.json

真实配置应保存在本地忽略文件:

config/config.local.json

对 AI 的常用指令

可以直接在 Codex 里这样说:

使用 MYwrite skill检查我的 Zotero 文库里哪些文献还没有生成 AI 阅读笔记。
使用 MYwrite skill为这个 Zotero 条目生成一条 AI 阅读笔记SXAIQUJT。
使用 MYwrite skill为这个 Zotero 条目重新生成满血版深度阅读笔记SXAIQUJT。覆盖已有 AI 子笔记,不要新建重复笔记。
使用 MYwrite skill给这些 Zotero 条目批量生成 AI 阅读笔记SXAIQUJT、X7GJZ627、ZCZXGRAM。
使用 MYwrite skill从上次中断的位置继续生成文献笔记跳过已经生成过的条目。
使用 MYwrite skill帮我检查 Obsidian 文献阅读库的 Dataview 页面是否能正确展示 Zotero 笔记。
使用 MYwrite skill整理我的文献阅读模板让后续生成的 Zotero 子笔记更适合 Obsidian Dataview 使用。

批处理建议

整库生成会向 Zotero 写入大量子笔记。除非已经明确确认目标文库和写入范围,否则不要要求 AI 直接处理整个 Zotero 文库。

更稳妥的方式是每次处理 20-30 篇文献,并要求 AI 跳过已经生成过笔记的条目。这样即使中途失败,也可以继续执行而不会重复写入。

如果需要和手动 AwesomeGPT 生成结果接近的详细笔记,请明确告诉 AI 使用“满血版”或“深度精读”模式。该模式会读取更多全文内容,并要求模型输出更完整的结构化笔记。

重新生成笔记时,默认应覆盖已有 AI 子笔记,不要新建重复笔记。只有在明确需要对比两个版本时,才让 AI 另存为新的 Zotero 子笔记。

仓库内容

.
|-- SKILL.md
|-- agents/
|   `-- openai.yaml
|-- config/
|   `-- config.template.json
|-- references/
|   |-- obsidian-integration.md
|   |-- obsidian-literature-maintenance.md
|   |-- upgrade-plan.md
|   `-- upstream-obsidian-skills.md
`-- scripts/
    |-- audit_zotero_ai_notes.py
    |-- generate_zotero_ai_note.py
    `-- init_private_config.py