Won · revisions

Wie viel von einem Store neu geschrieben wurde

revisions antwortet mit revised von total: wie viele Erinnerungen in einem Store nach dem Schreiben verändert wurden. Es lohnt sich, danach zu fragen, bevor Sie sich bei etwas Wichtigem auf das Gedächtnis stützen, oder wenn ein abgerufener Fakt nicht zu dem passt, was der Nutzer gerade sagt. Ein Store, in dem drei von zehn Fakten ersetzt wurden, verdient weniger Vertrauen als einer, den niemand bearbeitet hat.

Unterstützt ab Tablet 2. Aufrufbar über die HTTP-API, aus den Python-, TypeScript- und Rust-SDKs sowie als MCP-Tool. Ältere Engines antworten mit 501 und nennen das Modell, das dies nicht leisten kann.

Anzahlen

Gezählt wird, was eine Transformation berührt hat - ersetzt, aktualisiert, zurückgezogen sowie entfernte Bilder.

mem.revisions()
# {"revised": 3, "unrevised": 37, "total": 40, …}
await mem.revisions();
mem.revisions(None).await?;
curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" -d '{"user_id":"alice"}'
FeldBedeutung
revisedErinnerungen, die eine Transformation berührt hat.
unrevisedErinnerungen, die seit dem Schreiben nichts verändert hat. revised + unrevised ergibt immer total - der Wert ist abgeleitet und wird nicht separat gezählt, ein gleichzeitiger Schreibvorgang kann die drei also nicht in Widerspruch bringen.
totalErinnerungen im Store.
counts / excludesEinfache Sätze, keine Flags, die ausformulieren, was die Zahlen abdecken. Der Aufrufer ist oft ein Modell.

Die Liste lesen

Übergeben Sie include, um die Erinnerungen selbst zu erhalten, nicht nur deren Anzahl. Ohne diesen Parameter erhalten Sie nur die Zählwerte, was der günstige Aufruf ist.

page = mem.revisions(include="revised", limit=20)
page["memories"], page["matched"], page["has_more"]
const page = await mem.revisions(undefined, { include: "revised", limit: 20 });
let page = mem.revisions_page(None, "revised", 20, None, None).await?;
curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" \
  -d '{"user_id":"alice","include":"revised","limit":20}'
FeldWas er tut
include"revised" oder "unrevised". Jeder andere Wert wird mit einem 400 abgelehnt, statt auf die Zählwerte zurückzufallen - ein Tippfehler, der die Liste stillschweigend weglässt, sieht genau wie ein leerer Store aus.
limit5 bis 20, Standard 20. Werte außerhalb des Bereichs oder mit falschem Typ werden abgelehnt, nicht begrenzt.
matchedGesamtzahl der Zeilen hinter dieser Seite, nicht die Größe der Seite.
ordered_byDer Dienst nennt seine eigene Sortierung: zuletzt gespeichert zuerst, nicht zuletzt bearbeitet.
next_beforeCursor für die nächste Seite, zusammen mit next_skip_ids. Geben Sie beides zurück; die IDs sammeln sich über die Seiten hinweg an.
Die Liste ist danach sortiert, wann eine Erinnerung gespeichert wurde, nicht wann sie geändert wurde. Wer "zuletzt bearbeitet zuerst" annimmt, liest die Seite falsch; deshalb nennt die Antwort ausdrücklich, welche Sortierung gilt.
Löschungen werden nicht gezählt. Eine gelöschte Erinnerung lässt nichts übrig, was sich zählen ließe, daher meldet auch ein stark ausgedünnter Store weiterhin ein niedriges revised. Diese Zahl sagt Ihnen, wie viel neu geschrieben wurde, nicht wie viel verschwunden ist.