Repository navigation
Releases
DiffLens v1.0.1
Security hardening release. All 10 secondary findings from the v1.0.0 code review are fixed; no new features, no behavior regressions (282 Rust + 52 frontend tests green).
Hardening highlights
- API key off the command line — llama-server now receives the loopback session key via the
LLAMA_API_KEYenvironment variable (verified against the pinned llama.cpp b12503 binary); never visible in the process table. - Stricter loopback guard — only literal
127.0.0.1/[::1]accepted; DNS names rejected. - Bounded retries & streams — HTTP 416 resume attempt capped; streaming explanation text capped at 256 KiB.
- Memory & lock hygiene — diff job map pruned (max 50, running jobs never evicted); sidecar spawn no longer holds the status lock; lock poisoning returns errors instead of panicking; pipeline runs via
spawn_blocking. - Temp file hygiene — OCR rasterizations written owner-only (0600) and deleted on drop.
- Stronger key entropy — session keys from OS randomness (
getrandom). - CI supply chain — all GitHub Actions pinned by commit SHA; documented redirect policy (auth stripped on redirects by ureq; downloads verify SHA-256 before rename).
Downloads
| Platform | File |
|---|---|
| macOS (Apple Silicon) | DiffLens_1.0.1_aarch64.dmg |
| Windows | DiffLens_1.0.1_x64-setup.exe / .msi |
| Linux | .AppImage / .deb / .rpm |
Unsigned installers: macOS right-click → Open (first launch); Windows SmartScreen → More info → Run anyway. Verify integrity with checksums.txt (SHA-256 below).
DiffLens processes documents 100% locally — no accounts, no telemetry, no cloud. AI explanations run on your machine via an optional llama.cpp sidecar you install from inside the app.
SHA-256
3432fa0e4b24c01ab8725f00201c2efb52ebd7eea1111ffe06d5dc79b20dab75 DiffLens-1.0.1-1.x86_64.rpm
b420fddab9da6093a5283f4431e42c458ca69a78aab11c4287b54e8f68bf90e6 DiffLens_1.0.1_aarch64.dmg
4a3ceaed0f0fe43669c2c00352723e208645f6a2868254c160ca2d311af40981 DiffLens_1.0.1_amd64.AppImage
80c327d2d23dbf589da5c97171a48e1bcd4eac9e363827261cc0e8be9f2b039b DiffLens_1.0.1_amd64.deb
c274a74f078ae74ec22f701ed2c986f97a53bc5ede07f63c7c9f104eb850989c DiffLens_1.0.1_x64-setup.exe
153e1f229f64508ef0f47b4061aa284e6932a3f0a63e54fbb874613b2eb7aab1 DiffLens_1.0.1_x64_en-US.msi
5f35b32a50d76d7ff501e544d3891e0df65912ef9d6c3ee66f4f11d024709aa0 DiffLens_aarch64.app.tar.gz
Full changelog: v1.0.0...v1.0.1 — P1 + P2 hardening from the public code review (report).
DiffLens v1.0.0
DiffLens v1.0.0 — first production release
Local-first, cross-platform document diffing. Compare two documents —
PDF, DOCX, TXT, XLSX, PPTX — entirely on your machine. No accounts, no
telemetry, no cloud: your files never leave your device.
Highlights
- Side-by-side diffing — virtualized two-pane view with inline
word-level highlights, move arrows (⇄) and collapsible unchanged blocks;
stays smooth on very large documents. - Semantic alignment — paragraphs are matched by meaning (local
e5-small embeddings, on-device), so moved clauses are detected instead of
flagged as delete+insert noise. - Deterministic intelligence — money / date / percent / duration /
reference / clause-rename / entity changes are extracted with plain
rules, banded info → critical, and every flag shows which rule fired
with before/after values and a full audit trail. Same input → same
output, always. - Filterable change list — filter by kind and severity; click to jump
straight to the row, with a detail drawer per change. - Optional on-device AI explanations — install a small model from the
in-app Downloads page (Qwen3-4B primary, Qwen2.5-3B low-RAM fallback,
SHA-256-verified pins; llama.cppb12503) and DiffLens explains any
change locally. AI output is always labelled "AI-generated, may be
wrong" and never mixed into the deterministic audit trail. - Experimental OCR — scanned PDFs are read via Tesseract
(user-installedtesseract-ocr+tesseract-ocr-vie); every OCR result
is honestly labelled as experimental. - Session history + report export — comparisons are stored locally
(SQLite) and exportable as HTML or Markdown with the audit trail. - English + Vietnamese interface, light/dark theme.
Platform notes
| Platform | Artifacts | Notes |
|---|---|---|
| Windows x64 | .msi, -setup.exe |
Unsigned — SmartScreen: More info → Run anyway |
| macOS Apple Silicon | .dmg (aarch64) |
Unsigned — right-click the app → Open. Intel Macs are out of scope for v1.0 |
| Linux x64 | .AppImage, .deb, .rpm |
AppImage is the quickest way to run |
- Auto-update is not included in v1.0 (post-1.0 scope).
- AI explanations and OCR are optional add-ons installed from the in-app
Downloads page; everything else works out of the box.
Checksums (SHA-256)
3cc67edfc842d2ed2e3335228118a68dbe23325521b667142ad7550308448f5c DiffLens-1.0.0-1.x86_64.rpm
8222ee3387dfe6b8745dc596b0f0d07b0d04bf61d1f84d02fdef999d42406c49 DiffLens_1.0.0_aarch64.dmg
3123aeb0b8ad7ed28a07fd19fc50f8f00f8c55f6ed1dfef749c8ac1be737c84c DiffLens_1.0.0_amd64.AppImage
df3f47272b38d7b471958a9be91b7fb2d370fe3a6b26b23e803fd6eb981236ff DiffLens_1.0.0_amd64.deb
02d6b1d6104eeb0594b1c466abc482b741cd5ec3b17619b2da95a51c64de4f0c DiffLens_1.0.0_x64-setup.exe
36591f18028d3960e1d7fbe1c869c1f0fc56e936cf8377a06ec1d5d07bacad69 DiffLens_1.0.0_x64_en-US.msi
e57934ed4fa4573fbcfa6a8c045308815d12e96f0cc1919fb49425f792a2dcfa DiffLens_aarch64.app.tar.gz
(DiffLens_aarch64.app.tar.gz is the raw macOS app bundle; most users
want the .dmg.)
Full license and third-party attributions: see
LICENSE and
THIRD-PARTY-NOTICES.md.