Skip to content

Marginalia v0.2.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Jun 16:07
· 15 commits to main since this release
v0.2.2
376eab7

Highlights

  • Added Settings UI and API controls for embedding, semantic recall, rerank, and evidence-selection configuration.
  • Hardened citation footnote rendering so raw entry_id, quote, and reason metadata is hidden across more model output variants.
  • Improved OpenAI-compatible model handling for DeepSeek-style DSML text tool calls.
  • Added a quick-mode forced final-answer retry when the capped final turn still attempts another tool call.

Retrieval Settings

Embedding, semantic recall, rerank, and evidence-selection knobs are now available from the desktop Settings page and the settings API. This makes the retrieval stack testable without editing .env by hand for every toggle.

Citation Handling

Citation footnotes now tolerate quoted entry_id values and fields emitted in a different order. This prevents model-written metadata such as entry_id=..., quote=..., and reason=... from leaking into the rendered answer when the model uses a slightly different footnote shape.

Quick Mode Reliability

OpenAI-compatible adapters now convert DSML text tool-call blocks into real tool calls instead of letting pseudo-XML reach the user-facing answer. Quick mode also performs one forced final-answer retry if the final capped execute turn still asks for another tool call.

Validation

  • Targeted backend tests passed: 41 passed.
  • Frontend TypeScript check passed: npm run lint.
  • uv sync --locked --extra dev passed after syncing uv.lock to 0.2.2.
  • Local Windows x64 NSIS build passed.
  • Local Windows x64 portable zip build passed and contains sidecar manifest package: 0.2.2.
  • Main CI completed successfully after the lockfile sync fix.
  • Release workflow completed successfully.

Artifacts

Desktop bundles built from v0.2.2.
Desktop targets: Windows x64/arm64, macOS arm64, Linux x64/arm64.
Each bundle ships a self-contained Python runtime; no system Python required.
Docker image: ghcr.io/shenmintao/marginalia:v0.2.2 (linux/amd64, linux/arm64)

First-Launch Notes For Unsigned Binaries

  • Windows: SmartScreen may say "Windows protected your PC". Click "More info" and then "Run anyway".
  • macOS: Gatekeeper may refuse to open the .dmg. Run xattr -dr com.apple.quarantine /Applications/Marginalia.app after dragging it across.
Assets 11
Loading