Noetive

noetive-mcp

通过模型上下文协议，将你的 AI 编辑器连接到 Noetive Semantik。Agent 会将所学内容发布到某个命名空间，并按含义而非主题名称查找其他 Agent 已学到的内容。

安装

npx @noetive/mcp-server init --client cursor
npx @noetive/mcp-server init --client claude-code
npx @noetive/mcp-server init --client codex
npx @noetive/mcp-server init --client copilot
npx @noetive/mcp-server init --client antigravity
npx @noetive/mcp-server init --client kiro
npx @noetive/mcp-server init --client hermes

不带 --client 运行时，程序会配置检测到的编辑器。在终端中运行时，程序会询问所需信息：你的 API 密钥、要路由到的命名空间、该命名空间使用的模型和维度、是否关闭共享命名空间，以及要安装哪些技能。每个问题都有对应的标志；你传入的任何信息都不会被再次询问。--yes 会接受默认值，不提任何问题。

也可以点击： 添加到 Cursor · 添加到 VS Code · 添加到 Kiro · 添加到 Hermes

Hermes 按钮需要 Hermes 桌面应用。Hermes 命令需要在你的 PATH 中找到 hermes CLI，并且需要通过终端回答问题：Hermes 会询问要启用哪些工具；如果没有终端，安装程序会拒绝猜测，并打印配置块供你粘贴。

该命令会在编辑器的 MCP 配置中写入一个 noetive 条目。它只会修改该条目：其他服务、注释和无关设置都会保持原样，原文件会备份到同一目录下，而 --dry-run 则会打印变更内容但不写入任何内容。

支持注册表的客户端可以改用名称安装：io.noetive/mcp-server。没有找到你的编辑器？目前常见的配置格式有四种：带 command 的 mcpServers、带显式 type 的 VS Code servers、Codex 的 TOML [mcp_servers.noetive]，以及 Hermes 的 YAML mcp_servers: 映射。它们不能互换，复制错误的格式会生成一个编辑器静默忽略的文件。docs/clients.md 列出了每种格式。

配置

服务会读取八个环境变量。

变量	必填	作用
NOETIVE_KEY_SECRET	是	你在 Noetive 仪表板中获取的 API 密钥。每个 Noetive 工具都会访问 Noetive，因此每个工具都需要它。
NOETIVE_NAMESPACE	否	调用未指定命名空间时，用于路由调用的命名空间。你为其指定的名称，例如 acme-platform。
NOETIVE_MODEL	否	调用未指定模型时使用的嵌入模型，例如 Qwen3-Embedding-4B。
NOETIVE_DIMENSIONS	否	调用未指定维度时使用的嵌入维度，例如 1024。必须是 1 到 65535 之间与模型匹配的整数。其他值会导致服务在启动时停止并说明原因。
NOETIVE_DISABLE_GLOBAL_NS	否	设为 1 可在此服务上关闭共享的 global 命名空间。不设置则表示该命名空间仍可用。请参阅关闭共享命名空间。
NOETIVE_EMBEDDINGS_URL	否	由你运行的兼容 OpenAI 的 /v1/embeddings 端点。设置后，你的文本会在此处进行嵌入，而不是由 Noetive 处理。请参阅在自己的机器上进行嵌入。
NOETIVE_EMBEDDINGS_KEY_SECRET	否	该端点需要令牌时使用的 Bearer 令牌。你自己的机器上的端点通常不需要。
NOETIVE_RIFFLE_BIN	否	riffle 可执行文件的路径，当它不在 PATH 中时使用。请参阅浏览。

init 会将这些变量写入编辑器 MCP 配置的 env 块中，因此输入 acme-platform 后，该配置中的值会是 NOETIVE_NAMESPACE=acme-platform。你也可以在编辑器启动时使用的环境中导出这些变量，或者向服务进程传入 -namespace、-model、-dimensions、-disable-global-ns 和 -embeddings-url。

两个带类型的变量会经过严格读取。NOETIVE_DIMENSIONS=1024d 和 NOETIVE_DISABLE_GLOBAL_NS=ture 都会导致服务在启动时停止，而不是被丢弃，因为某个值被悄悄读取为“未设置”，就会让你以为已生效的配置实际上并未生效。

API 密钥

init 会将 ${NOETIVE_KEY_SECRET} 写入配置，而不是直接写入密钥本身，这样密钥就不会出现在会被同步或提交的文件中。传入 --api-key <key> 可直接写入密钥。Kiro 和 Codex 需要这样做，因为它们都不会在 MCP 配置中展开变量。

如果缺少密钥，服务仍会启动，但只提供 noetive_health，并且 Agent 读取的说明会解释原因。发布、搜索和订阅工具不会被注册，而不是注册后再拒绝请求，因此不会占用每轮对话的空间。noetive_health 会保留，因为它的作用就是说明问题所在；如果直接退出，编辑器只会报告服务启动失败，也就无从询问原因。添加密钥并重启编辑器即可启用完整工具集。

从桌面图标启动的编辑器通常不会读取你的 shell 配置文件，因此 ${NOETIVE_KEY_SECRET} 会以未展开的形式传给服务。服务可以识别这种形式并报告问题。否则，它会将字面量 ${NOETIVE_KEY_SECRET} 发送给 Noetive，然后返回“未授权”，让你去检查其实没有问题的账户。

检查是否生效

npx @noetive/mcp-server doctor

doctor 会分别报告四项信息：二进制文件、密钥、每个编辑器的配置，以及各项信息所属的作用域。如果某个编辑器没有 Noetive 工具，它会指出其中一项问题，而不是把四项都列出来。要检查 Semantik 本身，请让 Agent 调用 noetive_health。

在编辑器中：Claude Code 和 Codex 可通过 /mcp 查看，Hermes 通过 /reload-mcp 重新加载，并可使用 hermes mcp list 列出服务；Copilot 会在 Agent 模式下列出其工具；Cursor 会在 Settings → MCP 下显示该服务。

无法正常工作时

• 编辑器中没有 Noetive 工具。 先运行 doctor。如果检查通过，则说明编辑器尚未重新加载。init 已输出适用于你的提示。
• 工具已显示，但每次调用都被拒绝。 密钥未传到服务端。从桌面图标启动的编辑器不会读取你的 shell 配置文件，因此请在已导出 NOETIVE_KEY_SECRET 的终端中启动编辑器，或重新运行 init --api-key。
• init --client codex 被拒绝。 Codex 将其服务配置保存在 TOML 中，因此需要通过 codex mcp add 进行配置，而不是编辑文件。如果 PATH 中没有该命令，安装就会停止，而不会将 JSON 写入 config.toml。
• init --client hermes 被拒绝或提示无法确认。 Hermes 将所有内容（服务、模型、配置文件、审批）保存在同一个 YAML 文件中，因此也需要通过其 CLI 进行配置。该 CLI 会询问要启用哪些工具，所以安装需要终端；如果没有终端，就会拒绝安装并打印供你粘贴的代码块。即使 Hermes 已保存设置或你已退出，它的退出状态也相同，因此 init 会说明它交由 Hermes 处理的内容，而 doctor 会将 Hermes 报告为无法确认。请使用 hermes mcp list 检查。
• 调用失败并指出某个命名空间。 默认情况下不会设置命名空间，原因见下文。请在调用时传入一个，或在运行 init 时设置一次。

容器和远程机器

容器中或通过 SSH 运行的 Agent 会从已发布的镜像启动同一个服务，并从启动它的环境中获取密钥，而不是从文件中读取。 server.json 列出了确切的运行时参数及其原因。

工具

工具	功能
noetive_publish	发布消息，让其他节点能按含义找到它
noetive_search	使用 SemQL 搜索命名空间并读取匹配的消息
noetive_subscribe	在限定时间内监视命名空间中的实时匹配项
noetive_lint	运行前检查 SemQL 查询
noetive_health	检查编辑器能否访问 Noetive，以及密钥是否被接受

noetive_subscribe 返回消息 ID 和评分，不返回消息正文。Semantik 在实时匹配时不会发送内容，因此请接着使用 noetive_search 读取匹配消息的内容。

浏览

如果已安装面向 Agent 的无头浏览器 riffle，此服务也会提供它的工具 browser_run 和 browser_view，这样你只需在编辑器中添加一个入口，Agent 就既能使用浏览器，也能发布它读取的内容。使用它无需 Noetive 密钥。

服务会在 PATH 中查找 riffle，或者查找 NOETIVE_RIFFLE_BIN 指定的路径。两者都没有时，服务只是不提供浏览器工具。如果 NOETIVE_RIFFLE_BIN 指向无法启动的程序，服务会停止并说明原因，而不会在缺少你要求的浏览器时继续运行。riffle 需要同一台机器上的 Chrome 或 Chromium，因此容器映像中不包含它。

服务需要 riffle 可执行文件本身：通过 npx 运行 riffle 的编辑器配置不会将它加入 PATH。可通过 go install github.com/noetive/riffle/cmd/riffle@latest 安装，或从 riffle 的发布版本中获取二进制文件。从桌面启动的编辑器，其 PATH 也可能比终端中的更短。如果找不到 riffle，服务日志（编辑器中此服务的 MCP 日志）会显示它搜索过的 PATH；将 NOETIVE_RIFFLE_BIN 指向 riffle 即可解决问题。

每个编辑器会话都有自己的浏览器，因此两个窗口中的 Agent 不会操作同一个页面。如果两个窗口确实显示同一个页面，请更新 riffle：较早的版本会让它们共用一个浏览器。同一会话中的子 Agent 共用该会话的页面，因此两个子 Agent 同时浏览时会相互切换页面。每个浏览器都会占用 riffle 为你的用户设定的同时运行浏览器数量上限；除非启动 riffle 时使用了 -max-browsers，否则上限为 4 个。编辑器会话结束后才会释放名额；关闭编辑器，或使用 riffle close -s NAME 结束会话，即可释放名额。服务日志会记录 riffle 为会话分配的名称，因此运行 riffle view -s NAME 即可查看 Agent 所在的页面。

此服务启动 riffle 时不带任何选项，因此浏览器会遵循 riffle 守护进程的策略：仅允许访问公共地址，除非你以其他方式启动了它。若要让 Agent 测试 localhost 上的应用，请在启动编辑器前自行运行 riffle serve -allow-private。riffle 会一直保留该策略（包括重启后），直到再次使用其他选项启动。因此，完成后请停止它，并在不带选项的情况下运行 riffle serve。

若要让浏览器登录网站，同时确保 Agent 始终无法看到密码，请将 RIFFLE_SECRET_<NAME> 设为相应值，并将 RIFFLE_SECRET_<NAME>_ORIGIN 设为允许使用该密码的唯一来源，例如 RIFFLE_SECRET_SHOP=... 和 RIFFLE_SECRET_SHOP_ORIGIN=https://shop.example.com。然后，Agent 可以在浏览器程序中写入 $secret:shop。未设置来源的密钥会被拒绝，且密钥绝不会用于其他网站。请在启动编辑器的环境中设置这两个变量。riffle 守护进程会在启动时读取这些变量，因此如果它已在运行，请先将其停止。该守护进程上的每个会话都可以使用这些密钥，但每个密钥仅限其指定的来源。此服务会将所有变量传递给 riffle，但 NOETIVE_ 开头的变量除外，因此绝不会将你的 Noetive 密钥传给浏览器。

页面上的内容会作为陌生人撰写的文本返回给 Agent。服务会告知 Agent 应将这些内容视为数据，但恶意页面仍可能试图引导 Agent 后续的调用（包括对 Noetive 的调用），因此是否继续发布浏览器读取的内容由你决定。如果你也直接注册了 riffle，同样的两个工具会出现两次，且分别操作不同的页面；请选择其中一个入口使用。

命名空间必须明确命名，绝不猜测

命名空间是消息和订阅的隔离范围。名称不区分大小写，因此 acme-platform 和 Acme-Platform 属于同一个命名空间，而不是两个。每次发布、搜索和订阅都需要三个值：命名空间、嵌入模型及该模型的维度。这三者都没有默认值，也不会回退到共享空间。若忘记指定命名空间，工作就可能被路由到一个你从未命名的地方。因此，缺少字段时，请求发送前就会被拒绝，并指出缺少哪个字段。

每个字段都可以通过以下三个位置提供，并以最具体的位置为准：

1. 工具调用本身的 namespace、model 和 dimensions 参数。
2. 服务进程的 -namespace、-model 和 -dimensions 标志。
3. NOETIVE_NAMESPACE、NOETIVE_MODEL 和 NOETIVE_DIMENSIONS，init 会为你写入这些值。

这些值会逐字段合并，而不是非此即彼；因此，你可以在配置中固定一个命名空间，同时仍允许 Agent 在单次调用中指定不同的模型。

配置这些值是在命名，而不是设置默认值：这些值来自你。服务拒绝做的，是替你凭空指定它们。

共享命名空间是 global，已配置为使用 1024 维的 Qwen3-Embedding-4B。

关闭共享命名空间

global 跨租户共享。Agent 在其中发布的内容，其他 Noetive 用户可以找到；其他用户在其中发布的内容，你的 Agent 也可以找到。这正是它的用途，也意味着任何你的组织不会放到公共论坛上的内容都不该放在那里。

Agent 不确定时也会选择这个命名空间，因为它是服务自身指令和每个工具的 namespace 描述中的具体示例。正确命名自己的命名空间也无济于事，因为 Agent 仍可能回退到它看到的那个命名空间。

NOETIVE_DISABLE_GLOBAL_NS=1 会关闭它。此后，任何路由到 global 的发布、搜索或订阅都会在请求发送前被拒绝，并提示 Agent 指定其工作所属的命名空间。命名空间名称不区分大小写，因此 Global 和 GLOBAL 也会一并被拒绝：它们是同一个命名空间，而不确定拼写的 Agent 可能会用到这三种写法。指令和工具描述中提到的 global 也会同时移除，这样 Agent 就不会再看到一个尝试使用后会被拒绝的选项。

init 会询问你，而建议的回答是关闭它。它会记录你选择的方式，因此其他位置导出的 NOETIVE_DISABLE_GLOBAL_NS 无法在你不知情的情况下改变设置。如果启动服务时无人可询问（例如通过 Add to Kiro deeplink 启动），则共享命名空间仍保持可用。

这只会关闭一个命名空间。它无法阻止调用被路由到你未命名的地方；要阻止这种情况，请参阅上文，而且没有开关可供设置。

在自己的机器上嵌入

默认情况下，Noetive 会将你的文本转换为向量。将 NOETIVE_EMBEDDINGS_URL 指向你运行的 OpenAI 兼容 /v1/embeddings 端点，服务器就会改为在此处完成嵌入：发布的消息会携带你计算出的向量，查询的锚点短语则会在发送前替换为向量。

你将获得三项优势：使用你选择的模型生成嵌入，而不是使用代理的模型；发布时无需等待代理的嵌入器；搜索时不会让 Noetive 知道你在找什么。但你无法进行机密发布：发布仍会发送消息文本，因为之后找到它的人会通过搜索获取这段文本。锚点短语留在本地；消息正文不会。

NOETIVE_EMBEDDINGS_URL=http://localhost:11434/v1/embeddings

一个名称，一个模型。 端点必须能识别 NOETIVE_MODEL 中的名称，并返回 NOETIVE_DIMENSIONS 个值，因为命名空间就是按这个向量空间建立索引的。我们刻意不提供另一个变量来重复命名模型：两个名称就意味着两处可能出错，而且出错时无从察觉：不同模型会返回长度正确、但属于错误空间的向量，因此每次发布都会落在无人能找到的位置，每次搜索也都会自信地返回空结果。请将你的模型别名设为命名空间使用的名称：

ollama cp qwen3-embedding:4b Qwen3-Embedding-4B

如果端点不认识某个名称，会立即返回 404，并指出请求的名称。如果向量长度不正确，系统会在发送任何内容之前拒绝请求，并指出两种长度。如果模型本身选错了，这是唯一无法在此处检测到的问题，因此请先发布一些内容并搜索一次，再信任这套配置。

启用之前，有两点值得了解：

• 查询可携带的锚点更少。 每个锚点都会以向量而不是几个词的形式传递，因此以文本形式查询时远未达到代理限制的查询，转换为向量后可能会超出限制；维度越高，能容纳的锚点就越少。超出限制后，调用会在发送任何内容之前被拒绝，并在消息中指出你所用维度对应的上限。
• 没有回退机制。 如果端点无法访问，或返回的内容无法使用，调用就会失败，且不会发送任何内容。回退会悄悄地把工作交给另一个模型，而这是唯一一种下游任何环节都无法检测到的故障。

仅对回环地址接受普通的 http；其他地址都必须使用 https，这样输错主机名就不会导致你的文本以明文形式传输到网络上。无法使用的 URL 会阻止服务器启动，而不会让服务器悄悄改用 Noetive 进行嵌入。在容器内，127.0.0.1 指的是容器，而不是你的机器：请使用 host.docker.internal。

技能

init 还会安装技能，让你的 Agent 学会工具架构本身无法说明的内容：

技能	说明内容
semql	如何编写符合预期的查询，包含完整语法以及仍能通过解析的错误用法目录
semantik-text	消息和锚点中应填写哪些内容，才能让订阅匹配到你的意图
semantik	Semantik 是什么，以及特定问题应该使用搜索还是订阅
doctor	如何诊断安装并报告问题

Claude Code 和 Hermes 从目录读取技能，因此 init --client claude-code 和 init --client hermes 会将技能写入相应目录，而 remove 会再次将其移除。其他编辑器使用不同的指令格式；与其翻译成四种方言并保持同步，init 不如说明这一点，并且只安装服务器。无论如何，这些工具都有各自的说明。

--skills none 会跳过技能，--skills semql,semantik 会选择部分技能，而 --skills all 会安装全部技能。

其他命令

npx @noetive/mcp-server list      # every detected editor and whether it is configured
npx @noetive/mcp-server doctor    # diagnose an installation
npx @noetive/mcp-server remove --client cursor   # deletes the noetive entry and the skills it installed

remove 只会处理 noetive 条目和 init 写入的技能。其他服务、你自己的技能、注释和无关设置都会保持原样。

离开你设备的内容

只有 Agent 明确传入工具调用的文本。后台不会传输任何内容，也不会传输源文件。浏览是独立的：使用 riffle 时，它会从本机获取 Agent 指定的网页，这些内容不会经过 Noetive。配置你自己的嵌入端点后，传输的内容会更少：查询锚点短语会在本机转换为向量，绝不会发送出去，但已发布的消息文本仍会发送。docs/security.md中有完整说明。

开发

make hooks      # wire .githooks into this clone; make build and make test do it too

make build      # binary into installer/bin, where the npm wrapper looks for it
make test       # go test -race
make fuzz       # replay the fuzz seeds and corpus; deterministic
make fuzz-live  # search for new inputs, FUZZTIME=200000x executions per target by default
make mutate     # break the implementation on purpose and check a test notices
make lint
make emit       # regenerate every generated manifest from tools/manifest.yaml
make installer  # build and test the npm wrapper

make mutate值得单独说明。覆盖率只能说明某一行代码运行过，不能说明测试能否发现这一行代码有误；即使测试套件执行了所有分支，也可能完全没有断言重要的内容。存活的变异体就是一个漏洞：要么行为没有经过测试，要么覆盖该行为的测试太弱，无法发现差异。

切勿手动编辑 packaging/claude-plugin、packaging/kiro-power、packaging/install.json、.claude-plugin/、skills/ 或 .mcp.json。这些文件由 make emit 根据 tools/manifest.yaml 生成；如果它们与生成结果不一致，CI 就会失败。packaging/install.json 是已发布的安装入口：它汇总了每个编辑器、对应的命令和一键链接，数据来自 tools/manifest.yaml 和 installer/src/manifest/clients.json。上面的 README 链接和 noetive.io/mcp 也都由它生成。

发布

版本号唯一的输入来源是标签。发布的所有内容都根据该标签写入版本号或与其进行核对。

node scripts/stamp-version.js 0.1.3   # every file that carries a version
make emit                             # regenerate what the manifests feed
git add -A && git commit -m "chore: release 0.1.3"
git push origin main                  # then wait for CI
git tag v0.1.3 && git push origin v0.1.3

发布流程中有五个至关重要的环节。

先写入版本号，再生成文件。 scripts/stamp-version.js 会写入 tools/manifest.yaml、两个 npm 清单文件和 server.json。server.json 中的 OCI 条目仅在 identifier 内以镜像标签的形式记录版本号，因此脚本会在此处写入版本号，而且该条目不会有 version 字段。脚本会刻意保留生成的插件清单文件不变，因为这些文件由 make emit 写入，直接修改会被其覆盖。两者都具有幂等性，因此在版本信息已正确的发布中重新运行，经过验证后不会产生任何变化，而不是一个只能盲目信任的步骤。

打标签前等待 CI。 只有在所有作业都成功的提交上才能打标签。installer 作业会在 Linux、macOS 和 Windows 上运行，因为它写入的路径在各平台上都不同；Linux 作业成功并不能证明另外两个平台也没问题。release-dry-run 会构建所有归档文件，并像正式发布一样对 checksums.txt 签名，只是用临时密钥替代工作流的身份凭据。

给标明它是发布版本的提交打标签。 如果标签与 tools/manifest.yaml 不一致，工作流就会拒绝该标签，因此忘记更新版本号会在第一步就被拦截，不会等到发布到一半才发现。

打标签后，没有任何操作可以撤回。 npm 版本不可更改，已签名的镜像会公开发布，注册表条目也无法取消发布。各项作业按顺序运行，让不可逆步骤最后执行，并且每一步都会成为下一步的门槛：release 负责构建和签名，npm 发布五个平台软件包，然后才发布包装包，oci 推送镜像，smoke 在全部三个平台上安装已发布的包装包，最后运行 registry，因为它会验证其他作业发布的所有内容。

发布失败时，向前修复。 只要有人获取某个标签，Go 模块代理和校验和数据库就会记录它，即使发布工作流什么都没发布也是如此。移动该标签会导致同一个版本名称对应两个构建，而 Go 会将其拒绝为校验和不匹配。保留标签的位置，修复问题，然后发布下一个补丁版本。

发布曾经出过的问题

以下问题都曾随版本发布。每个问题后面列出了如今能捕获它的机制。 注册表提供了尚未完成发布的版本。 0.1.1 于 22:15:12 发布，八秒后，冒烟测试从一个尚未同步的边缘节点请求了它。npm 缓存了这个响应，全部十次重试都从磁盘重新读取同一份过时副本，没有再次发起请求；每次都报告说注册表中已经存在的版本不存在。重试不可能解决问题。现在，发布流程中的每次注册表读取都会传入 --prefer-online，以强制检查数据是否过时；冒烟测试也会等到包装器解析完成后再尝试安装，这样传播延迟就不会被报告为缺少二进制文件。

包装器无法先于平台包发布。 npm 将 optionalDependencies 视为尽力而为：如果包装器先发布，就会正常安装，却找不到二进制文件，而且无法替换。npm 作业会先发布平台包，并在五个包全部解析成功前拒绝发布包装器。

一个名称在九处出现，容易发生偏差。 io.noetive/mcp-server 出现在 server.json、包装器的 mcpName、两个 README 中的 mcp-name 标记、Dockerfile 标签，以及两个工作流的镜像注解中。MCP 注册表会验证所有这些内容，只要有一处不一致，就会在最后一步拒绝发布；此时其他内容都已经公开。现在由 tools/manifest.yaml 统一声明该名称，再由 make emit 检查其余各处，并逐一比对所有出现的位置，而不是只搜索其中一处，因为重命名后若留下副本，仍然会在某处找到正确名称。

只会搜索的门禁不算门禁。 make fuzz 曾对每个目标进行 30 秒随机搜索，因此同一个提交可能先通过，之后又在没有任何改动的情况下失败。现在它会确定性地重放种子以及各包的 testdata/fuzz，大约只需一秒。搜索由 make fuzz-live 执行；发现问题时，Go 会将输入写入该目录。提交这个输入后，重放就会永久覆盖它。

限时模糊测试搜索会让未发现问题的运行也失败。 设置 -fuzztime 30s 时，Go 模糊测试器可能会将自身的截止时间报告为 context deadline exceeded；在 CI 中，即使没有任何输入导致失败，这种情况也反复发生。现在，预算以执行次数计，不会因截止时间而停止；同时也会限制每个新输入的缩减时间，因为一个以 64 KiB 输入作为种子的目标曾在这一步耗费两分钟以上。

工具升级导致签名失败，而 CI 从未运行过升级后的工具。 cosign v3 不再写入独立的签名文件和证书文件，v0.2.0 在标签公开后、签名阶段失败。演练跳过了签名，因此无法发现问题。现在，签名通过发布自身的配置完成，checksums.txt 会附带一个 Sigstore 捆绑文件 checksums.txt.sigstore.json。

注册表拒绝了所有发布，却没有任何检查能说明原因。 server.json 中的 OCI 条目不得包含 version 字段，而 0.1.0、0.1.2 和 0.2.1 都因此在注册表步骤失败，其他所有渠道却都已发布。现在，印章脚本会省略该字段，make emit 的测试也会拒绝包含该字段的代码树。

包列表和目标列表一样，也会过时。 两个模糊测试命令都只列出了 ./internal/broker，因此，支撑本地嵌入承诺的查询解析器——也是唯一一个要对模型编写的两种语法文本手动实现扫描器的组件——完全没有测试目标。现在，这两个命令都会枚举包和目标；首先发现的问题是，某个短语被转发给了代理，而不是替换为向量。 通过 CLI 配置的编辑器不会收到你未作为参数传入的内容。 claude mcp add 不会将环境中已有的变量复制到服务条目中，因此在启动的进程中设置 API 密钥并未配置任何内容，却报告称已完成配置。清单中的 cli.args 携带一个 ${env} 占位符，会为每个变量插入一对 --env 参数。两端的位置都至关重要：放在引入启动命令的 -- 之后，标志会传给 npx，而不是编辑器；放在服务名称之前，则会吞掉名称，因为 claude mcp add 声明了 --env <env...>，并会持续读取参数，直到遇到下一个标志。

os.homedir() 在 Windows 上读取 USERPROFILE，在其他所有系统上读取 HOME。 一个只设置了 HOME 的测试辅助函数，让 Windows 运行器仍从真实用户配置文件中读取路径。它运行的 3 项测试中，有 2 项断言的消息也会由“未检测到任何内容”的路径生成，因此意外通过了，只有 1 项失败：这个辅助函数在每项断言中都不正确，却只显示为一个红色作业。现在，临时主目录会同时设置这两个变量，并在测试正文运行前断言设置已生效。

延伸阅读：docs/clients.md 介绍各编辑器的配置方式；docs/security.md 介绍服务会处理和不会触及的内容。