AiHummer
Dansk
Log indKonto
v1.1.x
{ }Swagger

Einstein (hukommelsesplugin)

v1.1.x · opdateret 2026-07-05

Einstein er den officielle langtids hukommelsesplugin for AiHummer. Det giver en agent et holdbart, søgbart hukommelse, der overlever genstart og samtaler, uden nogensinde at forvandle den hukommelse til en sort boks. Den vejledende regel er enkel: PostgreSQL er systemets lager, og kanonisk Markdown er dets menneskeligt læsbare projektion, og systemet indekserer og foreslår ændringer. I review tilstand bliver hver forfremmelse til langtidshukommelsen gennemgået af et menneske; i auto tilstand (standarden) bliver et faktum, som agenten gemmer eksplicit med memory_store værktøjet, søgbart med det samme.

Pluginen kører værtseget som sin egen lille Python-tjeneste (kun standardbibliotek — ingen tungt rammeværk) og kommunikerer med gatewayen over aihummer.memory.v1 kontrakt. In-gateway hukommelsessubsystemet (påstande, tilbagekaldelse, data-hegn) er beskrevet på koncept-siden Hukommelse (Einstein); denne side dækker plugin der støtter det.

Fakta

Mark Værdi
Version 1.0.0
Havn 8820
Kørselstid Python (standardbibliotek), vært-native

Hvad det er

Einstein gemmer hukommelse som menneskelæsbar Markdown — den kanoniske optegnelse, en person kan åbne, læse og redigere. Oven på denne optegnelse bygger det det apparat, en agent har brug for på sin tur:

  • Hentning — hent den hukommelse, der er relevant for den nuværende samtale.
  • Søg — fuldtekst- og indlejringsbaseret opslag over gemte fakta.
  • Indlejring — vektorer til semantisk hukommelse, serveret over HTTP.

Fordi Markdown er kanonisk, er der intet ved indekserne, der er værdifuldt: de kan gendannes fra den kanoniske optegnelse når som helst, og en anmelder læser altid den samme tekst, som agenten læser.

Hvordan det bruges

Ved drejetid spørger gatewayen Einstein efter den hukommelse, der er relevant for den nuværende kontekst. Genkaldelse leveres til modellen som et værktøjsresultat omsluttet af et data-hegn, aldrig som indsprøjtede instruktioner — så en ondsindet note, der fandt vej ind i hukommelsen, ikke kan kapre agenten. Nye fakta, der observeres i en samtale, udtrækkes som påstande med bevis og sat i kø til gennemgang i stedet for at blive skrevet direkte ind i hukommelsen.

Der findes en anden vej: en agent kan selv gemme et faktum med memory_store værktøjet. Hvordan den skrivning lander, afgøres af kernens hukommelsesopsamlingstilstand — med auto (standarden) er faktummet søgbart med det samme; med review eller off bliver det en kandidat, der afventer godkendelse. Værktøjsresultatet bærer et searchable_now felt, så agenten ærligt kan fortælle dig, om det netop gemte faktum allerede kan genkaldes.

[!NOTE] Systemet indekserer og foreslår, men omskriver aldrig hukommelsen tavst. I review tilstand er fremme af en påstand til langtidshukommelsen et bevidst, menneskeligt gennemgået trin; i auto tilstand (standarden) er fakta, som agenten gemmer eksplicit, søgbare med det samme. Hukommelsestilstand (auto / review / off) og genfindingstilstand (fulltext / embedding) er kerne-indstillinger (AIHUMMER_MEMORY_CAPTURE / AIHUMMER_MEMORY_RETRIEVAL i indstillingskataloget), ikke en plugin-formular.

V2-hukommelsesplatformen (aktiveret som standard)

Einstein sender det hele v2 hukommelsesplatform, og al dens magt er færdig til brug — intet at forbinde manuelt: påstandsekstraktion, en anmeldelseskø, en baggrundsderiver (fakta, links og enheder fra beviser), et “drømme”/konsolideringspas (fjern dubletter og selvhelbredelse af hukommelse), en hukommelsesgraf og modsigelsesdetektion. Hukommelsestilstand, indlejreren og vektorlageret konfigureres separat, som kerneindstillinger. Einstein selv er leverandørkonfigureret: pluginet eksponerer ingen operatørindstillinger, og på Plugins-siden er kun dets opdateringshandling tilgængelig.

[!NOTE] Det eneste menneskelige skridt er godkende en skrivning til kanonisk hukommelse (MEMORY.md). Hver v2-arbejder skriver kun til en separat sidecar-lager og rører aldrig ved kanonisk Markdown. Når Einstein udleder en redigering, der er værd at inkludere i kanonen, vises den i anmeldelsesbrugerfladen og anvendes med et klik. Så al kraften er tilgængelig med det samme, og alligevel gælder kernegarantien: hukommelse bliver aldrig omskrevet bag din ryg. Det er en produktbeslutning, ikke en operatørindstilling.

Installation

Einstein er en indbygget plugin: det installeres automatisk for hver lejer, bærer en Indbygget mærkat i pluginlisten og kan ikke fjernes — hukommelse er en del af produktets kerne. Modulet selv er altid til stede, men hukommelsessamling kan slås fra: off hukommelsestilstanden (kerneindstillingen AIHUMMER_MEMORY_CAPTURE) stopper nye minder fra at blive indsamlet uden at fjerne modulet. Der er ikke noget at installere separat; hele livscyklussen for almindelige plugins er beskrevet i Installation og opdateringer. Der er ingen containere — Einstein kører som sin egen systemd-tjeneste sammen med gatewayen.

Sikkerhed og grænser

  • Kanonisk Markdown er en læsbar projektion. Systembutikken er PostgreSQL; indeks og indlejring kan udledes; den kanoniske tekst er, hvad en menneskelige anmeldelser og redigeringer.
  • Ingen stille omskrivninger. V2-platformen fungerer ud af boksen, men en skrivning til canon går gennem ét-klik menneskelig godkendelse; arbejdstagere skriver kun til sidevognen og rør aldrig den kanoniske Markdown.
  • Data-indhegnet tilbagekaldelse. Hukommelse når modellen som indhegnet værktøjsoutput, aldrig som instruktioner, der blokerer indirekte prompt-injektion.
  • Sikret webbrugergrænseflade. Pluginens anmeldelses-/administrationsbrugergrænseflade er adgangskontrolleret.
  • Værts-native. Kører under systemd, ikke i en container.

Hvor til næste