95 lines
3.3 KiB
Markdown
95 lines
3.3 KiB
Markdown
# 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、日志或任何会提交到仓库的文件里。
|
||
|
||
私有配置模板位于：
|
||
|
||
```text
|
||
config/config.template.json
|
||
```
|
||
|
||
真实配置应保存在本地忽略文件：
|
||
|
||
```text
|
||
config/config.local.json
|
||
```
|
||
|
||
## 对 AI 的常用指令
|
||
|
||
可以直接在 Codex 里这样说：
|
||
|
||
```text
|
||
使用 MYwrite skill，检查我的 Zotero 文库里哪些文献还没有生成 AI 阅读笔记。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，为这个 Zotero 条目生成一条 AI 阅读笔记：SXAIQUJT。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，为这个 Zotero 条目重新生成满血版深度阅读笔记：SXAIQUJT。覆盖已有 AI 子笔记，不要新建重复笔记。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，给这些 Zotero 条目批量生成 AI 阅读笔记：SXAIQUJT、X7GJZ627、ZCZXGRAM。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，从上次中断的位置继续生成文献笔记，跳过已经生成过的条目。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，帮我检查 Obsidian 文献阅读库的 Dataview 页面是否能正确展示 Zotero 笔记。
|
||
```
|
||
|
||
```text
|
||
使用 MYwrite skill，整理我的文献阅读模板，让后续生成的 Zotero 子笔记更适合 Obsidian Dataview 使用。
|
||
```
|
||
|
||
## 批处理建议
|
||
|
||
整库生成会向 Zotero 写入大量子笔记。除非已经明确确认目标文库和写入范围，否则不要要求 AI 直接处理整个 Zotero 文库。
|
||
|
||
更稳妥的方式是每次处理 20-30 篇文献，并要求 AI 跳过已经生成过笔记的条目。这样即使中途失败，也可以继续执行而不会重复写入。
|
||
|
||
如果需要和手动 AwesomeGPT 生成结果接近的详细笔记，请明确告诉 AI 使用“满血版”或“深度精读”模式。该模式会读取更多全文内容，并要求模型输出更完整的结构化笔记。
|
||
|
||
重新生成笔记时，默认应覆盖已有 AI 子笔记，不要新建重复笔记。只有在明确需要对比两个版本时，才让 AI 另存为新的 Zotero 子笔记。
|
||
|
||
## 仓库内容
|
||
|
||
```text
|
||
.
|
||
|-- 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
|
||
```
|