Revisió del lloc de Neotoma amb comentaris sobre la versió dels desenvolupadors

Vaig revisar el lloc Neotoma. L'antic mur de text d'una sola pàgina és ara una presentació visual recolzada per documentació completa, guies d'integració específiques d'eines i immersió profunda de l'arquitectura. La majoria del que va canviar es remunta a alguna cosa que va dir un provador o es va quedar enganxat durant el llançament del desenvolupador.

El que em van dir els comentaris

Des que vaig anunciar la liberació del desenvolupador, he recollit comentaris d'una dotzena de verificadors a través de trucades, xat, correu electrònic i enregistraments de pantalla. El sentiment ha estat encoratjador. Una persona ho va qualificar de "un problema molt rellevant" i va assenyalar que "la majoria de la gent està fent el seu en aquests moments". Un altre va dir que sembla un problema que val la pena resoldre. Algú més va ser bombejat, va sortir a la natura.

Però els comentaris més útils van ser sobre on es va quedar encallat la gent:

"Per a qui és això i per què l'utilitzaria?"

Moltes persones ho van preguntar directament. L'antic lloc portava amb arquitectura i abstraccions. Els provadors volien primer dolor agut i específic. Un ho va comparar amb vendre una vitamina en lloc d'un analgèsic. Un altre va preguntar a boca de boca: "Sóc una de les persones per a això?" El lloc havia de respondre aquesta pregunta en els primers segons.

Les noves pàgines de casos d'ús per a enginyers d'infraestructures d'IA, constructors de sistemes agentics i operadors individuals natius d'IA, a més de la [https://neotoma.io/ai-native-operators), a més de la [https://memory models comparaison. resposta.

"Això està pensat per substituir la meva memòria existent o viure al costat d'ella?"

Un verificador tècnic va preguntar si Neotoma hauria de ser el sistema de memòria principal o s'asseu al costat de coses com la memòria automàtica de Claude Code. Un altre va preguntar com funciona la ingestió: és l'expressió regular, l'avaluació de l'IA o l'agent que omple els paràmetres de l'eina? L'antic lloc no abordava res d'això. L'arquitectura i la mecànica estaven escampades pels documents README i repo.

La nova pàgina de models de memòria i la tutorial per a desenvolupadors aborden ambdues preguntes.

"Com puc configurar això amb la meva eina?"

Un provador tenia Neotoma funcionant amb la CLI, però va preguntar "per tant, no funciona amb OpenClaw?" perquè la llista de clients al lloc no estava clara. Un altre va produir un error de mòdul no trobat intentant iniciar l'API. Un tercer va passar una hora llegint documents en una màquina virtual nova i va marcar un enllaç trencat a l'índex de documentació a més de finestres emergents de permís de macOS inesperades. Les instruccions de configuració estaven enterrades i variades segons l'eina, i el fragment d'instal·lació del lloc no tenia un enllaç directe amb el que passa després d'iniciar.

La nova pàgina d'instal·lació i guies d'integració per a Cursor, Claude, Claude Code, amb-claudetoma ChatGPT, Codex i OpenClaw aborden això.

El senyal positiu sota tot això: diversos provadors van fer funcionar Neotoma i van verificar que s'emmagatzemava i recuperava correctament. Un va confirmar que "emmagatzema coses quan ho pregunto i ho puc verificar amb la CLI". El nucli funciona. El lloc i la incorporació no ho van fer.

Pàgina d'inici

La pàgina d'inici ara té nou seccions diferents en lloc d'un desplaçament llarg. Els tres que responen més directament als comentaris:

Taula de garanties de memòria

La taula de garanties de memòria és la resposta a "en què és diferent?" Una comparació de la memòria de la plataforma (Claude, ChatGPT), sistemes de recuperació (Mem0, Zep, LangChain Memory), enfocaments basats en fitxers (Markdown, botigues JSON) i Neotoma en 12 propietats:

Propietat	Descripció
Evolució de l'estat determinista	Les mateixes observacions sempre produeixen el mateix estat d'entitat independentment de l'ordre. Elimina errors de comanda i fa que les transicions d'estat siguin comprovables.
Historial de versions	Cada canvi crea una versió nova en lloc de sobreescriure. Els estats anteriors es mantenen accessibles.
Línia de temps repetible	La seqüència completa d'observacions es pot reproduir des del principi per reconstruir qualsevol estat històric.
Registre de canvis auditable	Cada modificació registra qui la va fer, quan i des de quina font.
Restriccions d'esquema	Les entitats s'ajusten als tipus i regles de validació definits. Les dades amb format incorrecte es rebutgen, no s'accepten en silenci.
Risc de mutació silenciosa	Si les dades poden canviar sense una consciència explícita. Els enfocaments basats en la plataforma, la recuperació i els fitxers comporten aquest risc. El neotoma ho impedeix.
Risc de fets conflictius	Si les afirmacions contradictòries poden coexistir sense detecció. Neotoma marca i resol els conflictes en lloc d'emmagatzemar tots dos.
Reconstrucció de l'estat reproducible	L'estat actual complet es pot reconstruir només a partir de les entrades en brut, de la manera com un llibre major equilibra a zero a partir de les seves entrades.
Inspecció humana	Podeu examinar exactament què ha canviat entre dues versions i rastrejar on es va originar cada fet.
Incorporació de configuració zero	Si la memòria funciona des del primer missatge sense instal·lació. La memòria de la plataforma té això. Neotoma no.
Cerca de similitud semàntica	Trobar el context rellevant pel significat en lloc de la concordança exacta. Els sistemes de recuperació i Neotoma proporcionen això, amb un àmbit diferent.
Editabilitat humana directa	Si podeu obrir el magatzem de memòria en un editor estàndard i modificar-lo directament. Els sistemes basats en fitxers tenen això. Neotoma no.

Cada fila enllaça a una pàgina d'explicació dedicada amb exemples abans/després i codi CLI. Un provador havia assenyalat que "l'emmagatzematge general amb esquemes no s'ha resolt" i que els esquemes populars podrien ser la resposta. La taula de garanties és la meva resposta: aquí hi ha les propietats específiques, aquí és on ofereix cada enfocament, aquí és on no.

Abans i després

L'animació d'introducció fa circular la mateixa pregunta a través de dos resultats. Sense Neotoma: "No s'ha trobat cap contracte per a Kline". Amb Neotoma: "Net-30, signat el 12 d'octubre, renova automàticament el primer trimestre". Onze escenaris giren, cadascun mostra un mode de fallada real d'un cop d'ull.

A sota de l'animació, quatre targetes de fallades desglossen els escenaris per tipus de dades: fets financers, persones i relacions, compromisos i tasques, esdeveniments i decisions. Cada targeta té una narració concreta: contactes obsolets que van a la persona equivocada, terminis oblidats que desencadenen recordatoris contra tasques antigues, registres conflictius on dos agents llegeixen versions diferents del mateix contracte i cap sabia que existia l'altre.

Aquesta va ser la resposta directa a la retroalimentació "vitamina vs analgèsic". L'antic lloc portava amb arquitectura. Aquesta secció porta amb el que es trenca sense estat determinista i el que et costa.

Per a qui va

Tres targetes de públic amb il·lustracions personalitzades: enginyers d'infraestructures d'IA, constructors de sistemes agentics i operadors individuals natius de IA. Cadascun enllaça a una pàgina dedicada amb modes d'error, tipus de dades i patrons d'esquema específics per a aquest públic. Aquesta és la resposta directa a "sóc una de les persones per a això?"

Documentació

El lloc antic tenia tot en línia. Els provadors que volien profunditat havien d'anar al repo. Ara hi ha pàgines dedicades organitzades en una barra lateral de navegació.

Tutorial per a desenvolupadors

El developer walkthrough és un escenari de diverses sessions que recorre el bucle bàsic: emmagatzemar una decisió arquitectònica a la sessió 1, recuperar-la i actuar-hi a la sessió 2, gestionar una actualització conflictiva a la sessió 3 i, a continuació, auditar la pista d'observació completa. Tots els que utilitzen MCP (Model Context Protocol) emmagatzemen trucades amb exemples reals de sol·licitud/resposta. Això aborda directament la pregunta d'ingestió: l'agent crida a l'eina MCP amb paràmetres estructurats, Neotoma emmagatzema l'observació. No hi ha trucades ocultes de model d'IA, ni extracció d'expressions regulars.

Models de memòria

La pàgina models de memòria compara quatre enfocaments: memòria de plataforma, memòria de recuperació, memòria basada en fitxers i [deterministic-deterministic] memòria](https://neotoma.io/deterministic-memory). Aquí és on el "Neotoma hauria de substituir o complementar la meva memòria existent?" la pregunta es contesta. Cada model té una subpàgina dedicada que explica què és, on funciona i on es trenca.

Fonaments

Foundations cobreix privacy-first, determinista i multiplataforma en profunditat. La primera pàgina de privadesa respon als provadors que eren escèptics sobre l'alimentació de dades personals a les eines d'IA al núvol. Neotoma funciona a la vostra màquina. Les teves dades es mantenen locals.

Arquitectura

La pàgina arquitectura cobreix el flux d'estat (font, observació, entitat, instantània de l'entitat), les capes i com s'apliquen les garanties a cada etapa. Aquesta va ser una de les incorporacions més sol·licitades.

Pàgines de referència

Taula completa de API REST, catàleg Accions MCP i referència de la línia d'ordres. La pàgina de l'API inclou descripcions i paràmetres per punt final. La pàgina MCP enumera les 24 accions. La pàgina CLI cobreix les 38 ordres.

Guies d'integració

Sis pàgines específiques d'eines, cadascuna de les quals recorre la configuració des de la instal·lació fins a la primera botiga:

Aquesta és la resposta directa a "funciona amb X?" i "com puc configurar això amb la meva eina?" Cada guia cobreix la configuració, un exemple de primera execució i què esperar. La pàgina de ChatGPT és la més detallada perquè la configuració de GPT personalitzada té la majoria de passos. La pàgina OpenClaw existeix perquè un verificador va preguntar específicament si era compatible i el lloc antic era ambigu.

Casos d'ús

Ara tres pàgines dedicades al públic destaquen i expliquen per a qui s'adreça Neotoma, proporcionant una guia d'orientació que no tenia l'antiga pàgina d'inici:

Enginyers d'infraestructures d'AI. Punts de dolor com ara execucions d'agents no reproduïbles, canvis d'estat invisibles i cap rastre de procedència. Modes d'error habituals amb icones específiques. Tipus de dades amb què treballen aquests equips (estat de sessió, canalitzacions, avaluacions, pistes d'auditoria) i els tipus d'entitats que apareixen amb més freqüència (agent_session, acció, canalització, avaluació).

Constructors de sistemes agentics. Estructura similar centrada en marcs d'agent, fluxos de treball de diversos passos i observabilitat. Els modes d'error com els canvis d'estat silenciós entre sessions, els fluxos de treball que no es poden reproduir i la pèrdua de context quan un agent passa a un altre.

Operadors individuals natius d'IA. Centrat en l'experiència diària de compromisos perduts, pèrdua de context d'eina a eina i dades personals a la memòria opaca del proveïdor. Aquesta és la pàgina del provador que va preguntar "sóc una de les persones per a això?"

Instal·lació dirigida per l'agent

Això és nou des de l'anunci del llançament del desenvolupador. En lloc de llegir documents i configurar manualment, copieu una sol·licitud de la pàgina d'instal·lació, l'enganxeu a la vostra eina d'IA i l'agent s'encarrega de la resta: instal·lar el paquet, executar init, configurar la connexió MCP i emmagatzemar les vostres primeres dades.

L'indicador està dissenyat per a Claude Code, Codex, Cursor i OpenClaw. Indica a l'agent que instal·li Neotoma amb `npm install -g neotoma', que l'inicialitzi i que, a continuació, enllaçi la guia d'integració corresponent per a aquesta eina. L'agent escaneja el context local i la memòria de la plataforma, previsualitza el que ha trobat i només emmagatzema el que aproveu.

Cada guia d'integració enllaça amb la sol·licitud d'instal·lació, de manera que la ruta d'incorporació és la mateixa, independentment de l'eina amb la qual comenceu. L'objectiu és passar de zero a una configuració de Neotoma que funcioni amb dades reals emmagatzemades en menys de cinc minuts, sense llegir mai un document de configuració.

Suport lingüístic

El lloc i tot el contingut de les publicacions ara es tradueixen automàticament a 12 idiomes: àrab, bengalí, català, francès, alemany, hindi, indonesi, xinès mandarí, portuguès, rus, espanyol i urdú. Cada pàgina inclou un commutador d'idiomes i els dissenys RTL funcionen per a àrab i urdú.

Això és important perquè la versió per a desenvolupadors ha arribat a provadors fora dels mercats de parla anglesa. En comptes de fer servir la documentació darrere d'un únic idioma, cada pàgina (la pàgina d'inici, garanties de memòria, guies d'integració, pàgines de casos d'ús i publicacions) està disponible a les 12 localitzacions. Les traduccions es generen automàticament i potser no són perfectes, però redueixen la barrera per a qualsevol persona que avaluï Neotoma en el seu idioma principal.

Què passa després

La revisió del lloc aborda els buits de presentació i documentació. La següent ronda de treball aborda les llacunes del producte que van sorgir els provadors.

Incorporació impulsada per agents. El flux d'instal·lació actual us permet configurar, però és passiu. Instal·leu, inicieu i comenceu a emmagatzemar. La següent versió serà una experiència de descoberta guiada on el vostre agent escaneja els vostres fitxers locals, proposa els candidats de més valor i reconstrueix una línia de temps a partir de les vostres pròpies dades en els primers minuts. L'objectiu és un moment concret on veieu els vostres fitxers de projecte dispersos convertits en una línia de temps estructurada amb cada esdeveniment rastrejat a una font específica. És el moment en què la diferència entre Neotoma i una memòria de xat es fa evident.
Exportació de registres de marcatge. Diversos desenvolupadors, especialment els que provenen de Claude Code, esperen que la memòria es representi com a fitxers de marcatge que poden navegar i editar directament. Neotoma utilitza SQLite com a magatzem canònic, que us ofereix consultes deterministes i restriccions d'esquema, però vol dir que no podeu obrir només un fitxer al vostre editor. Estic afegint una ordre per exportar els vostres registres com a fitxers de reducció al disc, organitzats per tipus d'entitat, amb metadades i procedència de la matèria primera. SQLite es manté canònic. Els fitxers de reducció són un mirall fàcil de llegir per a la transparència i la inspecció.
Accés remot més suau per a ChatGPT i Claude. Les guies d'integració existeixen ara, però els camins de configuració remots per a ChatGPT (GPT personalitzat amb punt final de l'API) i Claude (escriptori amb MCP remot) necessiten més de la meva prova interna i depuració abans que siguin tan fluids com els camins locals per a Cursor i Claude Code. Vull que funcionin de manera fiable de punta a punta i actualitzar les guies amb instruccions i resolució de problemes més clares.

Sobre el que vull comentaris

La versió per a desenvolupadors encara està activa. Si proveu d'instal·lar Neotoma i treballar a través del lloc, vull saber:

El posicionament és clar? Quan arribeu a la pàgina d'inici, enteneu què fa Neotoma i en què es diferencia del que ja feu servir?
La taula de garanties de memòria us ajuda a decidir si Neotoma és rellevant per al vostre flux de treball?
El camí d'instal·lació i incorporació està clar? Es pot passar del lloc a una configuració de treball sense colpejar una paret?
Les guies d'integració són precises per a la vostra eina?

Visiteu neotoma.io, demaneu al vostre agent que instal·li amb les instruccions per copiar i enganxar i compartiu els vostres comentaris. Obriu un problema a GitHub o contacteu directament.

Punts clau