ZeroMind (OrigoZero game engine)

@origozero/zeromind

@origozero/zeromind 包含两部分：写入 Agent 执行环境自身配置中的 远程 ZeroMind MCP 服务声明（https://origozero.ai/mcp），以及教会 Agent 在构建任何内容之前先检查 ZeroMind 的 技能。不会有任何内容在你的机器上运行——CLI 会将机器关联到你的 ZeroMind 账户、写入服务条目，然后退出。之后 Agent 调用的每个工具（ZeroMind 内容发现、世界，以及你打开的世界所用的引擎）都由 ZeroMind 通过 HTTPS 提供，因此 ZeroMind 一发布新工具，你就能立即使用，无需在此升级任何内容。

每个受支持的执行环境（Claude Code、Cursor、Codex CLI、Gemini CLI、OpenCode、Cline、Continue、Windsurf、Zed、openClaw、JetBrains Junie、Sourcegraph Amp、GitHub Copilot、Block Goose、Aider）都会通过各自原生的渠道完成引导——技能、AGENTS.md、GEMINI.md、.cursor/rules/*.mdc、.clinerules、CONVENTIONS.md、.goosehints——并在该执行环境读取的配置文件中写入 MCP 条目。没有定制集成的执行环境使用 ide/README.md 中的通用可流式 HTTP 接线方式。

关联完成后，Agent 可使用：ZeroMind 库（搜索、检查、预览、安装、参与）、世界（列出、创建、分叉、启动、连接，以及可撤销的删除／移入回收站／恢复），以及——对于 Agent 已连接的世界——引擎本身（execute、guides、capture、VFS、bash）。https://origozero.ai/mcp 上的 tools/list 展示了当前可用工具；这些工具由服务端提供而非随包发布，因此本 README 不逐一列举。

前置条件

Node.js 18 或更高版本，并且位于 PATH 中，用于运行 zeromind link、zeromind install、zeromind upload 和 zeromind open。之后，你的执行环境会通过 HTTPS 与 https://origozero.ai/mcp 通信，不会在本地启动任何进程。

• macOS：brew install node（或从 https://nodejs.org 下载）
• **Linux：**使用发行版的包管理器，或通过 https://nodejs.org / nvm 安装
• **Windows：**https://nodejs.org（LTS 安装程序）——安装后重启 IDE，使其读取新的 PATH

使用 node --version 验证。

安装

Claude Code

/plugin marketplace add OrigoZero/zeromind-plugin
/plugin install zeromind
npx -y @origozero/zeromind link

此程序包包含技能和一个 .mcp.json，其中的 Authorization 标头会展开 ${ZEROMIND_INSTALL_SECRET}；zeromind link 会将该变量写入 ~/.claude/settings.json 的 env 中。之后重启 Claude Code，使其读取新设置。

其他所有执行环境

npx -y @origozero/zeromind install <harness>

每个执行环境对应一条命令——如果机器尚未关联，该命令会先完成关联，写入执行环境原生的指令文件，并将 /mcp 条目写入该执行环境自己的 MCP 配置：

npx -y @origozero/zeromind install claude       # .claude/skills/zeromind-{getting-started,library}/SKILL.md
npx -y @origozero/zeromind install cursor       # .cursor/rules/zeromind.mdc
npx -y @origozero/zeromind install codex        # ~/.codex/AGENTS.md (or ./AGENTS.md)
npx -y @origozero/zeromind install gemini       # ~/.gemini/GEMINI.md (or ./GEMINI.md)
npx -y @origozero/zeromind install opencode     # .opencode/skills/zeromind/SKILL.md
npx -y @origozero/zeromind install cline        # .clinerules/zeromind.md
npx -y @origozero/zeromind install continue     # .continue/rules/zeromind.md
npx -y @origozero/zeromind install windsurf     # ./AGENTS.md
npx -y @origozero/zeromind install zed          # .claude/skills/zeromind/SKILL.md
npx -y @origozero/zeromind install openclaw     # skills/zeromind/SKILL.md
npx -y @origozero/zeromind install junie        # ./AGENTS.md
npx -y @origozero/zeromind install amp          # ./AGENT.md
npx -y @origozero/zeromind install copilot      # .github/copilot-instructions.md
npx -y @origozero/zeromind install goose        # ~/.config/goose/.goosehints
npx -y @origozero/zeromind install aider        # ./CONVENTIONS.md
npx -y @origozero/zeromind install hermes       # ~/.hermes/config.yaml + plugin bundle

npx -y @origozero/zeromind install --list       # enumerate

所有命令都具有幂等性：共享文件（AGENTS.md、GEMINI.md、CONVENTIONS.md、.goosehints、copilot-instructions.md）包含一个带分隔标记的 `` 块，更新时会就地替换；自有文件（技能、规则文件）则需要使用 --force 才会覆盖。有两个执行环境没有可写入的 MCP 配置路径——openClaw 的路径尚未确认，而 Aider 通过命令行接收服务——因此安装程序会打印相应条目，供你粘贴。完整表格以及每个执行环境对应的 README，请参阅 ide/README.md。

链接

一台机器只需链接一次，且使用的链接与 Zero 引擎使用的相同：两者都会在操作系统配置目录中读取和写入 session.json（Windows 上为 ~/.config/zero/session.json；Windows 上为 %APPDATA%\zero\session.json；非 Windows 系统上的权限模式为 0600）。从任一端链接都会同时链接两者；取消链接会一次性撤销这台机器上的所有运行环境。

npx -y @origozero/zeromind link                       # device code, approved in the browser
npx -y @origozero/zeromind link --username <handle>   # pre-fill the approval page's agent name
npx -y @origozero/zeromind status                     # what this machine is linked as
npx -y @origozero/zeromind unlink                     # revoke it

link 会将这台机器注册为独立的 ZeroMind 主体，显示一个 URL 和一个代码，并等待你在该页面上批准。获批的账户就是 Agent 的身份——它自己的 ZeroMind 账户，与你的账户不同。

如果机器上已有获批的安装——通过之前运行此命令链接，或通过写入同一文件的 Zero 引擎链接——link 会显示这台机器以谁的身份运行，不会索要新代码，但仍会将密钥交给 Claude Code。每台机器只允许一个已链接的安装；机器要更换运行身份的账户，需先执行 unlink，再执行 link。

unlink 会在 ZeroMind 撤销该安装，并从这台机器的缓存中移除它——只移除安装字段，因此 Zero 引擎用于登录的会话以及登录所针对的签发方都会保留。如果 ZeroMind 回复称不存在该安装，本地清除仍会执行；如果根本无法完成撤销，则不会清除任何内容，并会提示你等 ZeroMind 恢复可访问后重新运行命令。

如果 ~/.claude/settings.json 中的 ZEROMIND_INSTALL_SECRET 是即将撤销的密钥，unlink 也会将其移除——在执行任何撤销操作之前，因此如果无法读取设置文件，系统会报告此情况，但仍会完成取消链接。（之后需由你删除那一行。）install <harness> 写入其他运行环境的条目仍会保留已撤销的密钥，并返回 401，直到你重新链接并为该运行环境重新运行安装命令——命令运行时会说明这一点。

运行环境提交的凭据是该安装的密钥，以 Authorization: Bearer ins_sec_… 的形式发送。任何工具返回 401 / invalid_token 都表示这台机器尚未链接（或条目中存有过期密钥）：运行 link，重新运行 install <harness> 以重写该条目，然后重启运行环境。

将本地文件上传到世界

npx -y @origozero/zeromind upload <path> --world <name-or-guid> [--to <vfs dir>]

将文件或文件夹（保留其相对目录结构）从这台机器复制到世界的引擎 VFS 中，默认放在 /source 下，除非使用 --to 指定其他位置。文件内容会以 base64 形式从磁盘发送到世界的 write_file，因此资源包不会经过 Agent 的上下文窗口。写入任何内容之前，会检查 256 MiB 和 10 000 个文件的上限（使用 --max-bytes / --max-files 可调高上限）；如果世界没有运行引擎，命令会报告此情况，而不会只写入一部分内容。

在这台机器上打开世界

npx -y @origozero/zeromind open <world guid | name | https url | zero:// url> [--play | --edit] [--native | --browser] [--dry-run]

Agent 调用的所有工具都由 ZeroMind 提供，而 ZeroMind 没有浏览器标签页，也没有运行在你机器上的引擎进程：world.open 和 world.launch 会告知世界在哪里打开，而此命令负责在本机打开世界。默认打开世界的编辑器；使用 --play 则打开玩家视角。如果这台机器注册了 zero:// 处理程序，命令会将 URL 交给桌面引擎；如果没有，则交给浏览器标签页。--native / --browser 可直接指定打开方式，并会将选择记入 session.json 旁边的 open.json，因此后续调用若不带这两个标志，就会沿用你的选择。--dry-run 只会打印目标和 URL，不会进行任何更改。

打开 GUID 或 URL 时不会发起任何网络请求。名称则会通过 /mcp 在你自己的世界中解析，并使用这台机器的安装密钥——该密钥绝不会被打印出来。此过程完全不会联系任何引擎。

指向本地 / 可自托管的 ZeroMind

两个环境变量可以将整个 CLI 切换到另一个后端：

变量	默认值	控制内容
ZEROMIND_ISSUER	https://origozero.ai	所有 REST 调用（/v1/installs/*、/v1/worlds 等）的基础地址，以及写入某个执行环境配置的 /mcp URL。也是 /link 授权页面的来源地址。
ZEROMIND_CONFIG_DIR	~/.config/zero（XDG；Windows 上为 %APPDATA%\zero）	session.json 的存放位置，其中保存此机器与 Zero 引擎共享的 install_id / install_secret。将其指向其他位置（例如 ~/.config/zero-local），即可让本地后端获得全新的安装身份，而不是重放已注册到生产环境的凭据。

对于本地 ZeroMind 开发堆栈，请将发行者指向前门（http://127.0.0.1:3003），而不是裸 API 的 :3001——前门在同一个来源上提供 /v1 REST 界面、/mcp 和 Web 应用（包括 /link 和 /edit/<guid> 引擎页面），这是 CLI 的预期配置。

ZEROMIND_ISSUER=http://127.0.0.1:3003 \
ZEROMIND_CONFIG_DIR=$HOME/.config/zero-local \
  npx -y @origozero/zeromind link

ZEROMIND_ISSUER=http://127.0.0.1:3003 \
ZEROMIND_CONFIG_DIR=$HOME/.config/zero-local \
  npx -y @origozero/zeromind install claude

生成的条目会在本地地址使用生产环境的结构：

// .mcp.json
{
  "mcpServers": {
    "zeromind": {
      "type": "http",
      "url": "http://127.0.0.1:3003/mcp",
      "headers": {
        "Authorization": "Bearer ins_sec_...",
        "X-ZM-Harness": "claude-code"
      }
    }
  }
}

也可以使用 Claude Code CLI：

claude mcp add --transport http zeromind http://127.0.0.1:3003/mcp \
  --header "Authorization: Bearer ins_sec_..." \
  --header "X-ZM-Harness: claude-code"

纯 http:// 发行者端到端均可正常工作：每个请求都通过 Bearer 标头进行身份验证，不使用 Cookie，也不要求必须启用 TLS。

更新

• 工具由 https://origozero.ai/mcp 提供。每个执行环境都会访问正在运行的版本；无需在你的机器上升级任何内容。
• zeromind install <harness> 写入的工件——指令块、技能、MCP 条目——可通过重新运行安装命令刷新。
• Claude Code 捆绑包（技能 + .mcp.json）通过 /plugin 更新。

维护者：package.json 中的 version 是唯一可信来源。如果清单中的版本与其不一致，tests/directory-manifests.test.ts 就会失败。

状态

0.7.1 — 此插件不运行自己的 MCP 服务。它会关联一台机器，将远程 /mcp 条目写入 16 个执行环境，将本地文件上传到一个世界，在这台机器上打开一个世界，并提供两项技能。工具界面属于 ZeroMind，实时托管于 https://origozero.ai/mcp；测试会针对捆绑的模拟 ZeroMind 服务 tools/mock-zeromind/ 对 CLI 进行端到端测试。

此版本要求 Zero 引擎在其写入的共享 session.json 中保留 install_secret：如果引擎的缓存会话结构没有此字段，就会在重新序列化文件时将其删除，下次运行 CLI 时，这台机器会被识别为未关联。因此，0.7.1 会在该引擎版本发布后推出。

开发

npm install
npm test          # builds, then runs the suite against the bundled mock ZeroMind server
npm run build     # compile TypeScript
npm run lint

Agent 的标准操作手册位于 templates/manual.md；每个执行环境的安装程序都会用该执行环境所需的 frontmatter 包装这一个文件。添加执行环境只需在 src/cli-install.ts 中添加一项，并添加 ide/<harness>/README.md。

目录清单

四个插件目录会从此仓库的根目录读取清单：

目录	根目录文件	加载内容
Claude Code 市场	.claude-plugin/marketplace.json、.claude-plugin/plugin.json	skills/、.mcp.json
Gemini CLI 扩展库	gemini-extension.json	skills/、作为上下文文件的 templates/manual.md
Codex 插件	.codex-plugin/plugin.json	skills/、dist-publishing/codex-plugin/.mcp.json
Cursor 市场	.cursor-plugin/marketplace.json	dist-publishing/cursor-plugin/ 中的捆绑包

没有任何内容会生成这些文件或 dist-publishing/ 下的捆绑包。tests/directory-manifests.test.ts 会在 CI 中运行；如果根目录清单与捆绑包不一致、其中列出的路径无法解析，或者捆绑包中的 skills/ 副本与原始目录不同，测试就会失败。

发布

1. 在 package.json 和 tests/directory-manifests.test.ts 检查的每个清单中更新 version。
2. 执行 git tag vX.Y.Z && git push --tags——发布工作流将运行。

需要在仓库设置中配置 NPM_TOKEN 密钥，并将其限定为 @origozero npm 组织。

安全

SECURITY.md 说明了如何报告漏洞。

许可证

MIT。请参阅 LICENSE。