Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

DiffLens compares two documents — PDF, DOCX, XLSX, PPTX or TXT — entirely on your machine, and produces a severity-banded change report with a full audit trail. Paragraphs are matched by meaning through local multilingual embeddings, so moved clauses are detected as moves rather than delete-plus-insert noise. Money, date, percent and duration changes are extracted by deterministic rules that show which rule fired and the before/after values — the same inputs always yield the same report. An optional local LLM (Qwen via llama.cpp, loopback-only) can explain any change in English or Vietnamese; it can never alter the diff or its severity.

At a glance: 100% local · MIT licensed · 5 formats · English + Tiếng Việt

PlatformsWindows 10/11 x64 · macOS 14+ (Apple Silicon) · Linux x64
Current release1.0.1
LicenseMIT (third-party notices)
Repositoryvibecoder880/difflens · Wiki

Why DiffLens

  • Semantic alignment — e5-small embeddings run locally; a 3-pass aligner (deterministic anchors → Needleman–Wunsch → move repair) keeps contract structure intact.
  • Deterministic intelligence — plain rules, published point values, banded severity (info → critical). Auditable by design; no hallucination possible in the scoring path.
  • Optional local LLM — download a small Apache-2.0 model through the in-app manager; explanations stream from a loopback-only sidecar. Nothing is sent anywhere.
  • Honest tooling — OCR is labeled experimental; every download is checksum-gated; the egress invariant is enforced by CI.

Feature overview

FeatureChapter
Installing per OS + SHA-256 verificationInstallation
First comparison walkthroughQuickstart
The four screens in depthUser Guide
Pipeline: extract → align → diff → enrichHow Diffing Works
Downloading models, privacy propertiesAI Explanations Setup
Scanned PDFs via TesseractOCR (Experimental)
Threat model, download integrity, reviewPrivacy and Security
Workspace, stack table, IPC surfaceArchitecture
Toolchain, feature flags, test tiersBuilding from Source