scholar-inbox-cliplisted
Install: claude install-skill SungFeng-Huang/research-cards
# Scholar Inbox → Heptabase Clip Skill
## Agent(claude / codex)
本 skill 可由 Claude Code 或 Codex 駕駛(Codex 端:`research-cards@private-plugins` plugin 的 scholar-inbox-clip skill)。
差異:alphaXiv MCP 工具僅 Claude 有——Codex 駕駛時改用 run.py 內建的 HTTP 抓取
(`fetch_alphaxiv_*`)取得論文內容。cron/scripts 的文字生成呼叫依 config `agent`
分流(claude --print / codex exec),互動 session 一律由駕駛中的 agent 本人生成。
## Backend(heptabase / obsidian / both)
讀 `~/.config/research-cards/config.json`(樣板:plugin 根目錄 `config.example.json`)。
`heptabase`/`both`(或無 config):原 heptabase CLI 路徑,行為不變(自動化流程安全)。
`obsidian`:卡片=vault `Papers/` 的 .md(frontmatter 存 arxiv_id/source_type/tasks),
journal=每日筆記 `<date>.md`(資料夾由 `obsidian.journal.folder` 設定,空=vault 根),顏色標記=`<span style="color:…">`、
toggle=`- ⏵ `字首 bullet(plugin markdown 方言,Obsidian 可渲染、不可誤點)。`check-tasks` 的選項清單在
obsidian 模式改為「OVERVIEW_TASKS ∪ vault 既有 tasks 值」(無 tag database 可查)。
## 互動模式的兩條硬規則(cron 以外的每一次 clip,任何 backend)
1. **卡片必須直接以教學式格式產出**(card-rewrite 的 8 點清單:一句話/為什麼〈config profile.reader〉該讀/0. 先備知識/教學式正文/中英並列/快速摘要/圖片/上色/Source)。
「baseline 翻譯卡+日後 retrofit」只是 cron(run.py 無人值守)的權宜——互動 clip 沒有理由產出半成品。
2. **圖片放置不要 shell 出 claude CLI**(巢狀呼叫在互動 session 內會失敗):先
`headings, figs = run.figure_candidates(cid, arxiv_id)` 看候選,
自行決定後 `run.insert_figures_into_card(cid, arxiv_id, placements=[...])`。
cron 路徑仍走 call_claude,失敗時自動降級為無圖並進 retry 記錄,不會中斷管線。
Automates the full pipeline: read digest emails → fetch alphaXiv AI
overview per paper → translate to the output language → color-highl