obsidian-plugin/lllin000_PaperForge
1
0
Fork 0
mirror of https://github.com/lllin000/PaperForge.git synced 2026-07-22 06:50:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

fix(literature-qa): prefer glob over resolve-key for quick key lookup, remove rg dependency

Browse source
This commit is contained in:
Research Assistant 2026-05-12 00:11:24 +08:00
parent f244f72056
commit 84d388d8f6
2 changed files with 12 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
paperforge/skills/literature-qa/SKILL.md
View file

@ -98,11 +98,12 @@ Vault: $VAULT
### 确定性命令 — 优先使用
| 场景 | 命令 |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| 按 key 定位论文 | `$PYTHON -m paperforge.worker.paper_resolver resolve-key <KEY> --vault "$VAULT"` |
| 按 DOI 定位论文 | `$PYTHON -m paperforge.worker.paper_resolver resolve-doi "<DOI>" --vault "$VAULT"` |
| 按字段搜索论文 | `$PYTHON -m paperforge.worker.paper_resolver search --title "..." --author "..." --year ... --domain "..." --vault "$VAULT"` |
| 场景 | 命令 | 原因 |
| ---------------------- | ------------------------------------------------------------------------------------------ | ---- |
| 按 key 快速找文件 | `glob("$LIT_DIR/**/<KEY>.md")` 或用 `Get-ChildItem "$LIT_DIR" -Recurse -Filter "<KEY>.md"` | 不需要 $PYTHON，最快 |
| 按 key 查完整信息 | `$PYTHON -m paperforge.worker.paper_resolver resolve-key <KEY> --vault "$VAULT"` | 返回 frontmatter 字段 (analyze, ocr_status 等) |
| 按 DOI 定位论文 | `$PYTHON -m paperforge.worker.paper_resolver resolve-doi "<DOI>" --vault "$VAULT"` | DOI 无法用文件系统快速匹配 |
| 按字段搜索论文 | `$PYTHON -m paperforge.worker.paper_resolver search --title "..." --author "..." --year ... --domain "..." --vault "$VAULT"` | 结构化搜索，含相关性打分 |
| 精读 prepare | `$PYTHON "$SKILL_DIR/scripts/ld_deep.py" prepare --key <KEY> --vault "$VAULT"` |
| 精读 postprocess | `$PYTHON "$SKILL_DIR/scripts/ld_deep.py" postprocess-pass2 <FORMAL_NOTE_PATH> --figures <N> --vault "$VAULT"` |
| 精读 validate | `$PYTHON "$SKILL_DIR/scripts/ld_deep.py" validate-note <FORMAL_NOTE_PATH> --fulltext <FULLTEXT_PATH>` |
@ -114,9 +115,9 @@ Vault: $VAULT
| ------------------------ | ----------------------------------------------------------- |
| 按关键词模糊搜索全部文献 | 读 `$IDX_PATH` 的 JSON，筛 `title` / `abstract` / `journal` |
| 按 collection 筛选 | 读 `$IDX_PATH`，筛 `collection_path` 字段 |
| 读论文全文 | 已通过 resolve-key 拿到 `fulltext_path` → 直接 read |
| 读精读笔记 | 已拿到 `formal_note_path` → read 的 `## 🔍 精读` 区域 |
| 遍历笔记做批量统计 | `rg <pattern> $LIT_DIR/ --include '*.md'` |
| 读论文全文 | 已找到 `fulltext.md` 路径（glob 或 resolve-key） → 直接 read |
| 读精读笔记 | 已找到 formal note 路径 → read 的 `## 🔍 精读` 区域 |
| 遍历笔记做批量统计 | `Get-ChildItem "$LIT_DIR" -Recurse -Filter "*.md"` + 读 frontmatter 或 `find "$LIT_DIR" -name "*.md"` |
| **禁止的操作** | **根据 vault-knowledge 示例拼接路径、把目录名写死在文件路径里** |
---

6
paperforge/skills/literature-qa/references/multi-reading.md
View file

@ -38,10 +38,10 @@
对每篇选定文献：
1. `$PYTHON -m paperforge.worker.paper_resolver resolve-key <KEY> --vault "$VAULT"` → 获取 workspace 路径
1. 用 glob 找到 formal note：`glob("$LIT_DIR/**/<KEY>.md")`（最快，不需要 $PYTHON）
2. 读 formal note frontmatter → 元数据
3. 如果有 `fulltext.md` → 读 Abstract、Results、Discussion
4. 如果有 `ocr_status == "done"` 但 fulltext 内容太长 → 先读 caption + figure 描述定位关键段落
3. 同目录下找 `fulltext.md` → 读 Abstract、Results、Discussion
4. 如果有 OCR 但 fulltext 太长 → 先读 caption + figure 描述定位关键段落
5. 如果没有 fulltext → 如实告知用户，仅基于已知信息
### Step 3: 写 Reading Log（JSON → MD）