我彻底修改了 [Neotoma](https://neotoma.io) 网站。旧的单页文本墙现在是由[完整文档](https://neotoma.io/docs)、特定工具集成指南和[架构深入研究](https://neotoma.io/architecture)支持的视觉呈现。大多数更改都可以追溯到测试人员在开发人员发布期间所说的或被困住的事情。

![屏幕截图：Neotoma 主页英雄 — 没有状态层的值道具和代理会话](/images/posts/neotoma-site-overhaul-home-hero.png "screenshot")

## 反馈告诉我什么

自从宣布[开发者版本](/posts/neotoma-developer-release)以来，我已经从大约十几名测试人员的电话、聊天、电子邮件和屏幕录制中收集了反馈。这种情绪一直令人鼓舞。一个人称其为“一个非常相关的问题”，并指出“大多数人现在都在推出自己的问题”。另一位表示，这听起来是一个值得解决的问题。其他人刚刚被抽到野外。

但最有用的反馈是关于人们陷入困境的地方：

### “这是给谁用的？我为什么要使用它？”

不少人直接问道。旧网站以建筑和抽象为主导。测试人员首先想要的是急性、特定的疼痛。有人将其比作销售维生素而不是止痛药。另一个人直截了当地问道：“我是这个的目标人群之一吗？”该网站需要在最初几秒钟内回答这个问题。

[AI 基础设施工程师](https://neotoma.io/ai-infrastruct-engineers)、[代理系统构建者](https://neotoma.io/agentic-systems-builders) 和[AI 原生个体操作员](https://neotoma.io/ai-native-operators) 以及[内存模型比较](https://neotoma.io/memory-models) 的新用例页面是直接响应。

### “这是为了取代我现有的记忆，还是与它共存？”

一位技术测试人员询问 Neotoma 是否应该成为主要记忆系统，或者与 Claude Code 的自动记忆系统并列。另一个人问摄取是如何工作的：是正则表达式、人工智能评估，还是填充工具参数的代理？旧网站没有解决这些问题。架构和机制分散在自述文件和存储库文档中。

新的[内存模型页面](https://neotoma.io/memory-models)和[开发人员演练](https://neotoma.io/developer-walkthrough)解决了这两个问题。

### “如何使用我的工具进行设置？”

一位测试人员让 Neotoma 与 CLI 一起运行，但问道：“那么它不能与 OpenClaw 一起使用吗？”因为网站上的客户列表不明确。另一个尝试启动 API 时遇到模块未找到错误。第三个人花了一个小时在新虚拟机上阅读文档，并在文档索引中标记了一个损坏的链接以及意外的 macOS 权限弹出窗口。安装说明被隐藏并因工具而异，并且该站点的安装片段缺乏指向初始化后发生的情况的直接链接。

新的[安装页面](https://neotoma.io/install)和[Cursor](https://neotoma.io/neotoma-with-cursor)、[Claude](https://neotoma.io/neotoma-with-claude)、[Claude Code](https://neotoma.io/neotoma-with-claude-code)的集成指南， [ChatGPT](https://neotoma.io/neotoma-with-chatgpt)、[Codex](https://neotoma.io/neotoma-with-codex) 和 [OpenClaw](https://neotoma.io/neotoma-with-openclaw) 解决了这个问题。

所有这一切背后的积极信号是：几位测试人员让 Neotoma 工作并验证了它正确存储和检索。一位人士证实，它“会在我询问时存储内容，并且可以通过 CLI 进行验证”。核心工作。网站和入职没有。

## 主页

主页现在有九个不同的部分，而不是一个长卷轴。对反馈做出最直接反应的三个：

### 内存保证表

[内存保证表](https://neotoma.io/memory-guarantees) 是“这有何不同？”的答案。平台内存（Claude、ChatGPT）、检索系统（Mem0、Zep、LangChain Memory）、基于文件的方法（Markdown、JSON 存储）和 Neotoma 的 12 个属性的比较：

![截图：Neotoma 主页上的内存保证对照表](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png "screenshot")

|物业 |描述 |
| -------- | ----------- |
| [确定性状态演化](https://neotoma.io/memory-guarantees#definistic-state-evolution) |无论顺序如何，相同的观察总是产生相同的实体状态。消除排序错误并使状态转换可测试。 |
| [版本历史记录](https://neotoma.io/memory-guarantees#versioned-history) |每次更改都会创建一个新版本而不是覆盖。较早的状态仍然可以访问。 |
| [可重播时间线](https://neotoma.io/memory-guarantees#replayable-timeline) |可以从头开始重播完整的观察序列，以重建任何历史状态。 |
| [可审核更改日志](https://neotoma.io/memory-guarantees#auditable-change-log) |每个修改都会记录谁进行的、何时进行以及来自何处。 |
| [架构约束](https://neotoma.io/memory-guarantees#schema-constraints) |实体符合定义的类型和验证规则。格式错误的数据会被拒绝，而不是默默地接受。 |
| [沉默突变风险](https://neotoma.io/memory-guarantees#silent-mutation-risk) |数据是否可以在没有明确意识的情况下发生变化。平台、检索和基于文件的方法都存在这种风险。 Neotoma 可以预防它。 |
| [冲突事实风险](https://neotoma.io/memory-guarantees#conflicting-facts-risk) |矛盾的陈述是否可以共存而不被发现。 Neotoma 标记并解决冲突，而不是同时存储两者。 |
| [可重现的状态重建](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) |完整的当前状态可以仅从原始输入重建，就像分类帐从其条目平衡为零的方式一样。 |
| [人类检查能力](https://neotoma.io/memory-guarantees# human-inspectability) |您可以准确检查任意两个版本之间发生的变化，并追踪每个事实的起源。 |
| [零设置入门](https://neotoma.io/memory-guarantees#zero-setup-onboarding) |内存是否从第一条消息开始工作，无需安装。平台内存有这个。尼奥托马则不然。 |
| [语义相似度搜索](https://neotoma.io/memory-guarantees#semantic-similarity-search) |通过含义而不是精确匹配来查找相关上下文。检索系统和 Neotoma 都提供此功能，但范围不同。 |
| [直接人类可编辑性](https://neotoma.io/memory-guarantees#direct- human-editability) |是否可以在标准编辑器中打开内存存储并直接修改。基于文件的系统有这个。尼奥托马则不然。 |

每行都链接到一个专门的解释页面，其中包含之前/之后的示例和 CLI 代码。一位测试人员指出，“具有模式的通用存储尚未解决”，而流行的模式可能是答案。保证表是我的回应：这里是具体属性，这里是每种方法提供的地方，这里是它不提供的地方。

### 之前和之后

![屏幕截图：显示失败与成功响应的之前/之后部分](/images/posts/neotoma-site-overhaul-before-after-section.png "screenshot")

介绍动画通过两个结果循环相同的问题。没有尼托马：“没有找到克莱恩的合同。” Neotoma：“Net-30，10 月 12 日签署，自动续订第一季度。”十一个场景轮流出现，每个场景都一目了然地显示出真实的故障模式。

在动画下方，四张失败卡按数据类型细分了场景：财务事实、人员和关系、承诺和任务、事件和决策。每张卡片都有一个具体的叙述——过时的联系人发给了错误的人，被遗忘的最后期限触发了对旧任务的提醒，冲突的记录，两个特工阅读了同一合同的不同版本，但都不知道对方的存在。

这是对“维生素与止痛药”反馈的直接回应。旧址以建筑为主导。本节首先介绍在没有确定性状态的情况下会出现什么问题以及您会付出什么代价。

### 适合谁

![截图：Neotoma 主页上的三张带插图的观众卡](/images/posts/neotoma-site-overhaul-audience-cards.png "screenshot")

三张带有自定义插图的观众卡：[AI基础设施工程师](https://neotoma.io/ai-infrastruct-engineers)、[代理系统构建者](https://neotoma.io/agentic-systems-builders)和[AI原生个体操作员](https://neotoma.io/ai-native-operators)。每个链接都指向一个专用页面，其中包含特定于该受众的故障模式、数据类型和模式模式。这是“我是这个产品的目标人群之一吗？”的直接答案。

## 文档

旧网站的所有内容都是内联的。想要深度的测试人员必须去仓库。现在，在侧边栏导航中组织了专用页面。

### 开发者演练

![屏幕截图：显示多会话 MCP 示例的开发人员演练页面](/images/posts/neotoma-site-overhaul-developer-walkthrough.png "screenshot")

[开发人员演练](https://neotoma.io/developer-walkthrough) 是一个多会话场景，贯穿核心循环：在会话 1 中存储架构决策，在会话 2 中检索并执行该决策，在会话 3 中处理冲突的更新，然后审核完整的观察跟踪。所有使用 MCP（模型上下文协议）的存储调用都带有真实的请求/响应示例。这直接解决了摄取问题：代理使用结构化参数调用 [MCP 工具](https://neotoma.io/mcp)，Neotoma 存储观察结果。没有隐藏的人工智能模型调用，没有正则表达式提取。

### 内存模型

![屏幕截图：显示平台、检索、基于文件和确定性内存的内存模型页面](/images/posts/neotoma-site-overhaul-memory-models.png "screenshot")

[内存模型](https://neotoma.io/memory-models)页面比较了四种方法：[平台内存](https://neotoma.io/platform-memory)、[检索内存](https://neotoma.io/retrieval-memory)、[基于文件的内存](https://neotoma.io/file-based-memory)和[确定性内存](https://neotoma.io/definistic-memory)。这就是“Neotoma 应该取代或补充我现有的记忆吗？”的地方。问题得到解答。每个模型都有一个专门的子页面，解释它是什么、它在哪里工作以及它在哪里损坏。

### 基础

![屏幕截图：显示隐私优先、确定性和跨平台承诺的基金会页面](/images/posts/neotoma-site-overhaul-foundations.png "screenshot")

[基础](https://neotoma.io/foundations) 深入涵盖[隐私优先](https://neotoma.io/privacy-first)、确定性和[跨平台](https://neotoma.io/cross-platform)。隐私第一页面回应了对将个人数据输入云人工智能工具持怀疑态度的测试人员。 Neotoma 在您的机器上运行。您的数据保留在本地。

### 架构

![屏幕截图：显示状态流程图的架构页面](/images/posts/neotoma-site-overhaul-architecture-state-flow.png "screenshot")

[架构](https://neotoma.io/architecture) 页面涵盖了状态流（源、观察、实体、实体快照）、层以及如何在每个阶段执行保证。这是最需要的补充内容之一。

### 参考页

完整的 [REST API](https://neotoma.io/api) 端点表、[MCP 操作](https://neotoma.io/mcp) 目录和[命令行参考](https://neotoma.io/cli)。 API 页面包括每个端点的描述和参数。 MCP 页面列出了所有 24 个操作。 CLI 页面涵盖了所有 38 个命令。

## 集成指南

六个特定于工具的页面，每个页面都会完成从安装到第一个商店的设置：

- [ChatGPT](https://neotoma.io/neotoma-with-chatgpt)
- [克劳德（桌面）](https://neotoma.io/neotoma-with-claude)
- [克劳德代码](https://neotoma.io/neotoma-with-claude-code)
- [法典](https://neotoma.io/neotoma-with-codex)
- [光标](https://neotoma.io/neotoma-with-cursor)
- [OpenClaw](https://neotoma.io/neotoma-with-openclaw)

![屏幕截图：Neotoma 与 Claude Code 集成指南](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png "screenshot")

这是“它与 X 一起工作吗？”的直接答案。以及“如何使用我的工具进行设置？”每个指南都涵盖配置、首次运行示例以及预期内容。 ChatGPT 页面是最详细的，因为自定义 GPT 设置的步骤最多。 OpenClaw 页面之所以存在，是因为测试人员专门询问是否支持它，而旧站点的含糊不清。

## 用例

现在，三个专门的受众页面突出显示并解释了 Neotoma 的受众群体，提供了旧主页所缺乏的定位指导：

![屏幕截图：AI 基础设施工程师观众页面显示故障模式和常见数据模式](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastruct.png "screenshot")

**[AI 基础设施工程师](https://neotoma.io/ai-infrastruct-engineers)。** 诸如不可重现的代理运行、不可见的状态变化以及无来源追踪等痛点。具有特定图标的常见故障模式。这些团队使用的数据类型（会话状态、管道、评估、审计跟踪）以及最常出现的实体类型（agent_session、操作、管道、评估）。

**[代理系统的构建者](https://neotoma.io/agentic-systems-builders)。**类似的结构侧重于代理框架、多步骤工作流程和可观察性。失败模式包括会话之间的静默状态更改、无法重播的工作流程以及一个代理移交给另一个代理时上下文丢失。

**[AI 原生个体运营商](https://neotoma.io/ai-native-operators)。** 专注于丢失承诺、工具到工具上下文丢失以及不透明提供商内存中的个人数据的日常体验。这是测试人员询问“我是这个页面的目标人群之一吗？”的页面。

## 代理主导的安装

![屏幕截图：包含复制粘贴说明和代理会话演示的代理安装页面](/images/posts/neotoma-site-overhaul-agent-install.png "screenshot")

这是自开发者发布公告以来的新内容。您无需阅读文档并手动配置，而是从[安装页面](https://neotoma.io/install)复制单个提示，将其粘贴到您的 AI 工具中，代理将处理其余的事情：安装包、运行 init、配置 MCP 连接和存储您的第一个数据。

该提示符是为 Claude Code、Codex、Cursor 和 OpenClaw 设计的。它告诉代理使用“npm install -g neotoma”安装 Neotoma，初始化它，然后链接该工具的匹配集成指南。代理会扫描您的本地上下文和平台内存，预览发现的内容，并仅存储您批准的内容。

每个集成指南都链接到安装提示，因此无论您从哪个工具开始，入门路径都是相同的。我们的目标是在五分钟内从零开始建立一个可工作的 Neotoma 设置，并存储真实数据，而无需阅读配置文档。

## 语言支持

该网站和所有帖子内容现在自动翻译成 12 种语言：阿拉伯语、孟加拉语、加泰罗尼亚语、法语、德语、印地语、印度尼西亚语、中文普通话、葡萄牙语、俄语、西班牙语和乌尔都语。每个页面都包含一个语言切换器，RTL 布局适用于阿拉伯语和乌尔都语。

这很重要，因为开发人员版本已经到达英语市场以外的测试人员手中。每个页面（主页、内存保证、集成指南、用例页面和帖子）都可以在所有 12 个区域设置中使用，而不是将文档封闭在单一语言后面。翻译是自动生成的，可能并不完美，但它们降低了任何人用其主要语言评估 Neotoma 的障碍。

## 接下来是什么

网站检修解决了演示和文档方面的差距。下一轮工作将解决测试人员发现的产品差距。

- **代理驱动的入门。** 当前的安装流程可以让您进行设置，但它是被动的。您安装、初始化、开始存储。下一个版本将是引导式发现体验，您的代理将扫描您的本地文件，提出最高价值的候选者，并在最初几分钟内根据您自己的数据重建时间线。目标是一个具体的时刻，您可以看到分散的项目文件变成结构化的时间线，每个事件都追溯到特定的源。从那时起，Neotoma 和聊天记忆之间的区别就变得明显了。

- **Markdown 记录导出。** 一些开发人员，尤其是来自 Claude Code 的开发人员，希望将内存表示为他们可以直接浏览和编辑的 Markdown 文件。 Neotoma 使用 SQLite 作为其规范存储，它为您提供确定性查询和模式约束，但意味着您不能只在编辑器中打开文件。我添加了一个命令，将您的记录导出为磁盘上的 Markdown 文件，按实体类型组织，并包含 frontmatter 元数据和出处。 SQLite 保持规范。 Markdown 文件是一个易于阅读的镜像，具有透明度和可检查性。

- **ChatGPT 和 Claude 的远程访问更加顺畅。** 集成指南现已存在，但 ChatGPT（带有 API 端点的自定义 GPT）和 Claude（带有远程 MCP 的桌面）的远程设置路径需要更多我自己的测试和调试，然后才能像 Cursor 和 Claude Code 的本地路径一样平滑。我希望两者能够端到端可靠地工作，并通过更清晰的说明和故障排除更新指南。

## 我想要反馈什么

开发者版本仍然有效。如果您尝试安装 Neotoma 并浏览该网站，我想知道：

- 定位是否清晰？当您登陆主页时，您是否了解 Neotoma 的用途以及它与您已经使用的有何不同？
- 内存保证表是否可以帮助您确定 Neotoma 是否与您的工作流程相关？
- 安装和入门路径是否清晰？您能在不碰壁的情况下从现场进入工作环境吗？
- 集成指南对于您的工具来说准确吗？

访问 [neotoma.io](https://neotoma.io)，要求您的代理按照复制粘贴说明进行[安装](https://neotoma.io/install)，并分享您的反馈。在 [GitHub](https://github.com/markmhendrickson/neotoma) 上提出问题或直接联系。