Five cards instead of forty notes: a local model that refuses to guess

说明与用途

five‑things 工具使用本地 Gemma 2 2B 模型，快速识别大量笔记文件中最重要的五条，限制时间和数量，并验证每条卡片包含原文引用。

问题

A notes folder grows faster than it is read; users need a quick way to identify the five most important notes each week.

结果

The tool reduces the effort to identify key notes from ~20 minutes to a single command, outputs concise actionable cards, enforces a time budget, and guarantees quote verification to avoid misleading summaries.

工作流

• Scan folder for notes and compute ranking signals (age, markers, dates, sections).
• Apply budget allocator to limit to N notes and M minutes of wall‑clock time.
• For each selected note, send text to local Gemma 2 2B model via llama‑cpp to generate a card JSON.
• Validate the generated quote against the note text; if invalid, mark card as unverified and keep note in queue.
• Print the five cards and a list of deferred notes with reasons.
• Cache results keyed on note text to avoid re‑processing on subsequent runs.

证据

five-things brief ~/notes --budget 5 --minutes 2

A quote without a receipt is not a card.

On this laptop, CPU only: Generation, single stream 0.8 to 1.1 tokens per second

The cache is the third saving: cards are keyed on note text, not path, so renaming a file does not burn another call.