Amnesia Protocol Lite is een lokale desktopwerkplek voor het gecontroleerd opschonen en synthetiseren van gevoelige tekst. De app combineert menselijke review, getypeerde pseudonimisering en een expliciete tweede laag voor realistische fictieve data. Zo kan tekst veilig worden voorbereid voordat die een ander venster of een cloud-LLM bereikt.
De app is ontworpen voor persoonlijk gebruik op één Mac. Het doel is gecontroleerde pseudonimisering en synthetische vervanging, niet anonimiteit of een garantie dat alle indirecte identificerende informatie verdwijnt.
flowchart LR
A[Brontekst of Terminal-uitvoer] --> B[Lokale detectoren]
B --> C[Menselijke review]
C --> D[Getypeerde markers]
D --> E[Veilige gekopieerde tekst]
E --> F[Synthetische tweede laag]
F --> G[Fictieve waarden]
G --> H[Lokale chat]
H --> I[Ollama op localhost]
J[Instellingen] --> F
J --> H
J --> I
De app heeft geen serverlaag. De standaardflow blijft binnen de desktopapp; alleen de optionele lokale AI-functies praten met Ollama op dezelfde Mac.
- Lokaal als standaard: detectie, review en standaardgeneratie draaien op de Mac zonder account, cloudservice of telemetrie.
- Twee expliciete lagen: eerst wordt gevoelige tekst omgezet naar markers; daarna plakt de gebruiker die veilige tekst bewust in de synthetische laag.
- Menselijke controle: kandidaten, markers en gegenereerde waarden blijven zichtbaar en aanpasbaar.
- Privacy door ontkoppeling: laag 2 ontvangt alleen markers zoals
EMAIL_1en nooit de oorspronkelijke bronwaarde. - Eerlijke grenzen: geen enkele detector of pseudoniem maakt tekst automatisch volledig anoniem.
- Start een nieuwe controle.
- Plak tekst in het bronvenster.
- Bekijk de automatisch gevonden kandidaten.
- Kies per kandidaat
Genereer token,NegerenofWaarde aanpassen. - Voeg gemiste passages handmatig toe met de
+-knop. - Gebruik eventueel
Accepteer openstaande; eerdere genegeerde of aangepaste kandidaten blijven ongemoeid. - Controleer de vervangingen en klik op
Kopieer veilige tekst.
- Open tabblad
02 Synthetisch. - Plak daar zelf de gekopieerde tekst uit laag 1.
- Controleer de gevonden markers.
- Klik expliciet op
Genereer standaardvervangers. - Gebruik voor
OTHERoptioneel een lokaal Ollama-model. - Controleer en corrigeer de fictieve waarden.
- Klik op
Kopieer synthetische tekst.
- Klik op
Terminalvanaf het welkomstscherm. - Plak terminaluitvoer in de editor.
- Laat mogelijke API keys, tokens, private keys, credential-URL's, accountpaden en Git-remotes markeren.
- Beoordeel iedere kandidaat zoals in de normale reviewflow.
- Kopieer de opgeschoonde terminaltekst en gebruik optioneel de synthetische laag.
- Open tabblad
03 Chat. - Stel vragen aan het geselecteerde lokale Ollama-model.
- Voeg alleen via de icon-only contextknop de synthetische output toe.
- Wis het gesprek wanneer je de sessiecontext wilt verwijderen.
De veilige bulkactie accepteert alleen openstaande kandidaten. Forceer alle kandidaten is een aparte, expliciet bevestigde actie die ook eerder genegeerde kandidaten accepteert. Geen van beide acties kopieert automatisch; controleer de tekst altijd voordat je op Kopieer veilige tekst klikt.
De detectoren werken volledig lokaal met regexen, contextregels en checksums waar mogelijk. De huidige typen zijn:
- E-mailadressen
- Nederlandse mobiele, vaste en zakelijke telefoonnummers
- IBAN met mod-97-validatie
- BSN met elfproef-validatie
- IPv4-adressen
- Nederlandse postcodes, inclusief plaatscontext
- Straatadressen met huisnummer als
address - Numerieke en geschreven datums, inclusief korte jaaraanduidingen
- Internetdomeinen en websites
- Persoonsnamen met initialen en contextlabels zoals
naam:ofcontactpersoon: - Klant-, lid-, relatie-, account-, polis- en personeelsnummers
- Transactie-, order-, bestel-, factuur-, ticket- en betalingsnummers
- Serienummers, apparaat-ID's, contract- en chassisnummers
- Dossier-, zaak-, referentie-, KvK- en BTW/VAT-nummers
Context is belangrijk. Een los nummer kan niet betrouwbaar worden onderscheiden als bijvoorbeeld BSN, klantnummer of transactienummer. Een nummer na klantnummer: krijgt daarom een andere classificatie dan dezelfde waarde zonder context.
Goedgekeurde waarden krijgen een typegebonden token:
klant@example.com -> EMAIL_1
klantnummer 123456 -> CUSTOMER_1
transactie TX-2025-04 -> TRANSACTION_1
serienummer SN8844 -> SERIAL_1
Dezelfde combinatie van type en waarde krijgt binnen één actieve sessie hetzelfde token. Nummers worden na edits, negeren, undo of redo niet hergebruikt of verschoven. Bij het sluiten van de app verdwijnt de mapping. Er is bewust nog geen vault, wachtwoordscherm, projectbestand of persistente opslag.
In tabblad 02 Synthetisch plakt de gebruiker eerst zelf de veilige tekst uit laag 1. Alleen ondersteunde markers zoals EMAIL_1, CUSTOMER_1 en LINK_1 worden herkend; de tweede laag ontvangt geen bronwaarden uit de eerste laag. Na een expliciete klik worden de markers opnieuw opgebouwd als volledig fictieve waarden. Kies in de synthetische laag Nederlands of English. Domeinen komen uitsluitend uit de gereserveerde example.*-reeks; BSN- en IBAN-achtige waarden zijn opzettelijk ongeldig en secret-achtige waarden gebruiken herkenbare demoformaten. De tekst wordt pas gekopieerd nadat alle vervangers zijn ingevuld en opnieuw door de runtimevalidator is goedgekeurd.
OTHER wordt niet willekeurig ingevuld. Hiervoor kan optioneel het apart geselecteerde lokale Qwen-/Ollama-model worden gebruikt. Het request volgt model-prompt.md, gebruikt /api/chat met think:false en wordt niet stil genormaliseerd: een contractfout of weigering wordt als fout getoond en nooit ingevuld. De app communiceert hiervoor uitsluitend met http://localhost:11434; er worden geen cloudmodellen of externe endpoints ondersteund.
Tabblad 03 Chat biedt een eenvoudige chat met het geselecteerde lokale Ollama-model. De oorspronkelijke bronlaag wordt nooit automatisch als context meegestuurd. Met de icon-only contextknop kan de gebruiker expliciet de synthetische output uit laag 2 toevoegen. De chat gebruikt maximaal 4.000 contexttokens, maximaal 512 outputtokens, maximaal 5 vragen per minuut en minimaal 3 seconden tussen vragen. Chatgeschiedenis bestaat alleen in het sessiegeheugen.
De modelcatalogus kan optioneel modellen via Ollama downloaden. Voor elke download toont de app de geschatte omvang en aanbevolen RAM en vraagt hij expliciet om bevestiging. Zonder Ollama blijven review, pseudonimisering en standaard synthetische vervanging beschikbaar.
Open het tandwiel in de topbar om voorkeuren te beheren. De voorkeuren worden tussen appstarts lokaal bewaard:
- een expliciet model voor
OTHERen een apart model voor algemene chat, zonder stille fallback; - taal voor synthetische waarden en lokale prompts;
- automatische clipboard-cleartimer;
- lokale modellen verversen en nieuwe modellen downloaden.
In de chat toont de modelbadge welk lokaal model geselecteerd is. Als een geselecteerd model ontbreekt, geeft de app een fout en kiest hij niet automatisch een alternatief. Alleen voorkeuren worden persistent opgeslagen. Brondata, mappings en chatgeschiedenis blijven sessiegebonden.
- React 19 en TypeScript
- Vite
- Tauri 2
- Rust als minimale desktoplaag
- Tailwind CSS en lokale styles
- Vitest voor unit-tests
- Playwright voor end-to-end-tests
- Tauri clipboard-plugin voor lokaal klembordgebruik
- Ollama als optionele lokale AI-runtime voor
OTHER
Vereisten:
- macOS op Apple Silicon voor de huidige
.app-build - Node.js 22 of nieuwer
- Rust en Cargo
- Ollama is alleen nodig voor AI-vervanging van
OTHER
Ollama wordt niet meegeleverd met de macOS-app. Zonder Ollama blijven Review, Terminal en standaard synthetische vervanging gewoon werken. Alleen lokale chat en AI-vervanging van OTHER hebben Ollama nodig.
- Installeer Ollama voor macOS via ollama.com/download/mac.
- Open Ollama één keer zodat de lokale server draait.
- Open in Amnesia Protocol
Instellingenen klik opVervers lokale modellen. - Selecteer afzonderlijk een lokaal model voor
OTHERen voor algemene chat.
De app communiceert alleen met Ollama op http://localhost:11434. Modeldownloads zijn de enige optionele actie die een internetverbinding gebruikt. Als Ollama niet aanwezig is, toont Instellingen een korte onboarding met deze stappen.
Installeer dependencies:
npm installOptionele lokale AI instellen:
ollama serve
ollama pull qwen3.5:4b
ollama pull mistralDe tweede laag gebruikt standaard amnesia-qwen:4b, de lokale naam van het later geëxporteerde en gekwantiseerde model. Voor S0 kan qwen3.5:4b expliciet worden gekozen. Chat heeft een eigen modelkeuze. Via Ververs lokale Ollama-modellen worden alleen lokaal geïnstalleerde modellen gecontroleerd; ontbrekende modellen veroorzaken een zichtbare fout en nooit een stille fallback. De app gebruikt uitsluitend Ollama op http://localhost:11434; zonder Ollama blijven alle standaardvervangers volledig offline beschikbaar.
Start de webontwikkelserver:
npm run devStart de desktopapp in development mode:
npm run tauri devUnit-tests:
npm run testEnd-to-end-tests:
npm run test:e2eCodekwaliteit:
npm run lint
npm run formatProductiebuild:
npm run tauri buildDe standaard Tauri-build maakt de macOS-app zonder Finder-automatisering:
src-tauri/target/release/bundle/macos/Amnesia Protocol.app
Een DMG kan lokaal zonder AppleScript worden gemaakt met:
hdiutil create \
-volname "Amnesia Protocol" \
-srcfolder "src-tauri/target/release/bundle/macos/Amnesia Protocol.app" \
-ov \
-format UDZO \
"src-tauri/target/release/bundle/dmg/Amnesia Protocol_0.2.6_aarch64.dmg"Beide kopieeracties gebruiken dezelfde lokale clipboardadapter. Na het schrijven leest Amnesia Protocol het klembord direct terug en vergelijkt het resultaat met de verwachte tekst. Alleen bij een overeenkomende readback wordt succes gemeld. De UI toont tijdens het kopiëren Kopiëren... en daarna een blijvende succes- of foutstatus naast de knoppen.
Het klembord wordt standaard na 60 seconden automatisch geleegd. In de reviewbalk kan dit worden aangepast naar 30 seconden, 60 seconden, 5 minuten of Nooit. De app wist alleen wanneer de clipboardinhoud nog exact overeenkomt met de laatst door Amnesia Protocol gekopieerde tekst; inhoud die intussen door een andere app is geplaatst blijft ongemoeid.
De browser-e2e-tests geven Playwright expliciete klembordrechten en controleren de gekopieerde inhoud. Dit valideert de browserfallback. Controleer voor een native macOS-release ook handmatig de gebouwde .app: kopieer een tekst met een token, plak die in een lokale teksteditor en controleer dat bijvoorbeeld EMAIL_1 aanwezig is. De native Tauri-permissies staan in src-tauri/capabilities/default.json.
Zolang je de app lokaal gebruikt, blijft de normale verwerking op je Mac. De detectoren werken lokaal, de review gebeurt lokaal en de mapping leeft alleen in het geheugen van deze sessie. De tweede laag ontvangt alleen de tekst die je zelf kopieert en plakt; de oorspronkelijke bronmapping wordt niet automatisch doorgegeven. De optionele AI-functies praten uitsluitend met Ollama op localhost.
Er is geen account, backend, analytics of telemetrie. De app voert geen Terminal-commando's uit en leest geen Terminalvensters automatisch; Terminaldata wordt alleen verwerkt nadat je die zelf plakt. Alleen niet-gevoelige voorkeuren zoals taal, modelbeleid en clipboardtimer worden via localStorage lokaal tussen appstarts bewaard.
FileVault beschermt de Mac op schijfniveau. De app gebruikt in deze versie geen extra encryptielaag omdat de mapping niet persistent wordt opgeslagen. De brondata en mapping leven tijdens gebruik wel tijdelijk in het geheugen van de applicatie.
Let op:
- Clipboardinhoud kan door andere lokale apps worden gelezen.
- Een gepseudonimiseerde tekst kan nog indirect identificerende informatie bevatten.
- Automatische detectie is geen garantie dat alle gevoelige informatie is gevonden.
- Vertrouw niet uitsluitend op de bulkactie voor gegevens met hoge impact; beoordeel bij voorkeur de kandidaten handmatig.
- Namen zonder duidelijke context worden niet algemeen via NER gedetecteerd. Handmatig markeren blijft nodig voor veel namen.
- Invoer is begrensd op 1.000.000 tekens en undo/redo bewaart maximaal 50 snapshots om geheugenverbruik te begrenzen.
- HTML-tabellen worden als tekst met tabs en regels ingevoegd; complexe visuele styling wordt niet behouden.
- Overlapresolutie is bewust eenvoudig en gericht op korte geplakte teksten. Bij complexe meervoudige overlaps kan menselijke controle nodig zijn.
- PDF, DOCX, OCR, CSV-structuurbehoud en bestandsimport/export zijn nog geen onderdeel van deze MVP.
- Persistente mapping tussen sessies is uitgesteld tot daar een concreet gebruiksmoment voor bestaat.
src/
App.tsx App-shell en laagselectie
HomeScreen.tsx Welkomstscherm
ReviewWorkspace.tsx Revieweditor en kandidaatlijst
ReviewBottomBar.tsx Reviewacties en clipboardknoppen
AppDialog.tsx Modalweergave en focusbeheer
ChatPanel.tsx Lokale chat met optionele synthetische context
chat.ts Chatlimieten en contextbeheer
SettingsPanel.tsx Persistente voorkeuren en Ollama-modelbeheer
settings.ts Lokale voorkeuren tussen appstarts
useDialog.ts Confirm- en promptlogica
useReviewState.ts Debounced detectie, history en reviewacties
useClipboard.ts Clipboardstatus en readback-verificatie
SyntheticPanel.tsx Tweede laag voor geplakte markers
detectors.ts Review- en Terminal-detectoren, contextregels en checksums
synthetic.ts Markerparser en fictieve datageneratoren
ollama.ts Lokale Ollama-integratie voor OTHER
review.ts Reviewacties, merge-logica en vervanging
types.ts Domeintypen en labels
*.test.ts Unit-tests
e2e/
review.spec.ts Playwright-workflowtests
src-tauri/
src/ Minimale Tauri/Rust-entrypoint
capabilities/ Beperkte desktoppermissies
De huidige implementatie bevat de Fase 1/2-MVP plus Terminal-opschoning en een lokale chatlaag: lokale review, detectie van Terminal-secrets en accountpaden, uitgebreide Nederlandse detectieregels, sessiegebonden pseudonimisering, een onafhankelijk geplakte synthetische tweede laag, Engelse synthetische waarden, optionele lokale Ollama-AI met timeouts en outputnormalisatie, lokale modeldownloads met hardwarewaarschuwing, clipboardcontrole, begrensde snapshot-history, gescheiden veilige en geforceerde bulkacties, debounce voor langere teksten en een begrensde lokale chat. De tests en productiebuild moeten groen zijn voordat wijzigingen als afgerond worden beschouwd.



