Skip to content

Commit bf41241

Browse files
simonsysunclaude
andcommitted
docs: explain title weight 1.5 design rationale in README
Content-first vaults often contain a mix of titled articles and untitled process notes. The lower title weight ensures untitled content isn't systematically buried in search results. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 5caa603 commit bf41241

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,10 @@ SeekLink runs four search channels in parallel and merges results with Reciproca
127127
- **Indegree**: notes that many other notes link to rank higher — a lightweight quality signal from your knowledge graph.
128128
- **Title/Alias** (FTS5): matches against note titles and `aliases` frontmatter. Weight 1.5 gives a modest boost without overwhelming content matches.
129129

130+
### Why title weight is 1.5 (not higher)
131+
132+
Many personal knowledge bases contain a mix of **titled articles** (permanent notes, literature reviews) and **untitled process notes** (daily logs, journal entries, quick captures). A high title weight systematically buries untitled content — even when it's the most relevant result for the query. The default of 1.5 keeps title matching useful for precise `[[alias]]` lookups while letting content-based matches compete on their own merits. Override with `--title-weight` per query if needed.
133+
130134
### Optional: cross-encoder reranking
131135

132136
When enabled (default on Apple Silicon), the top-20 RRF candidates are re-scored by Qwen3-Reranker-0.6B running on MLX (Metal GPU). This reads each (query, passage) pair with full cross-attention — more accurate than vector similarity alone, at the cost of ~1-2s per query.

0 commit comments

Comments
 (0)