跳转至

Cursor 集成(实验性){#cursor-integration-experimental}

此适配器面向 Cursor 本地 Agent。安装、工作流和隔离性均未经验证。暂勿将 Cursor 加入受支持主机列表。请参阅设计和 issue #145。

接口与版本

选定的 CLI 参考版本为 2026.10.01-e373342,于 2026-10-24 检查。其帮助信息列出了 --plugin-dir、--model、--workspace 和 --output-format。帮助、版本及原生离线加载器探测均已运行。未运行任何模型或审查器。这是已检查的版本,而非经核实的最低版本。

第一条 version 命令在锁定的 macOS 钥匙串处停止。启动器的逐命令 AGENT_CLI_CREDENTIAL_STORE=file 设置允许检查帮助和版本。未更改任何账户配置。

原生清单为 .cursor-plugin/plugin.json。目录描述符 .cursor-plugin/marketplace.json 指向它。原生清单选择共享的 skills/、.cursor-plugin/agents/ 中的 Cursor 适配器,以及 .cursor-plugin/rules/ 中的 Cursor 规则。显式 agent 路径排除原始共享角色。每个审查器均声明 readonly: true、permissionMode: readonly、model: inherit 和 is_background: false。所选 CLI 的插件加载器读取的是 permissionMode,而非 readonly。文档化的 readonly 字段仍用于本地 Agent 接口。原生加载器探测确认全部八个审查器均以只读方式注册。这并不能证明运行时强制执行或前台行为。请为将来的实时运行显式选择一个模型,并从任务记录中记录其实际标识符。

来源:插件参考、subagent 配置与上下文和本地插件安装。这些来源描述的是主机能力,而非 EGM 验证结果。

安装候选包

使用不含其他 EGM 安装的全新 Cursor 配置。主机策略必须允许本地导入。请勿禁用组织策略或覆盖现有包。

  1. 在干净的 EGM 检出中检出任选提交。
  2. 在该检出目录下运行以下命令:
git diff --exit-code HEAD
egm_candidate="$HOME/.cursor/plugins/local/egm"
mkdir -p "$(dirname "$egm_candidate")"
mkdir "$egm_candidate" && {
  cp -R .cursor-plugin skills agents resources docs LICENSE "$egm_candidate/" &&
  git rev-parse HEAD > "$egm_candidate/.egm-source-sha"
}
  1. 如果某条命令失败,请停止。重试前先检查任何部分复制的内容。
  2. 重新加载 Cursor,并在 Customize 中检查插件。
  3. 确认七个 Skill、八个 EGM 审查器以及 EGM 运行时规则。
  4. 记录软件包的绝对路径和已安装文件的校验和。

复制内容保留所有共享运行时目录及其相对布局。它排除了便携式根清单,以显式选择 Cursor 格式。它不包含指向外部检出的符号链接。共享源文件保持不变。

被检查的 CLI 还通过 agent --plugin-dir /absolute/path/to/cursor-package 接受临时候选包。该命令会启动一个 agent,并可能产生模型使用量。仅在明确授权进行实时测试后运行它。请勿使用强制手段或自动 MCP 审批。

调用工作流

在第一个 Skill 之前,向本地 Agent 提供已安装的根目录:

EGM_ROOT: /absolute/path/to/cursor-package
Read /absolute/path/to/cursor-package/docs/cursor.md.
Run /egm-brainstorm for the requested feature.

从 Cursor 的斜杠菜单中选择已安装的 EGM Skill。如果某个 Skill 未显示,请读取其绝对路径 skills/<directory>/SKILL.md 并在父上下文中遵循该文件。不要凭空发明斜杠命令命名空间。对 egm-draft、egm-review 和工作流子 Skill 采用相同流程。适配器规则必须在执行前处于激活状态。

相对于所选的软件包根目录解析 agents/、resources/ 和 docs/。相对于 Skill 所在目录解析该 Skill 的 references/。不要假设 Markdown 会展开 ${CURSOR_PLUGIN_ROOT} 或 ${CLAUDE_PLUGIN_ROOT}。针对 Claude 和 Codex 的主机特定指令不会选择 Cursor 运行时。

将合成器的编排保留在父上下文中,并直接调度审查器。需要时,阅读 agents/synthesizer.md 以获取其规范合成指令。不要创建不受限制的合成器子级。Bootstrap 子级委派不在本实验性适配器的范围内;如果所请求的操作需要它,请停止。

对于每次审查,启动一个具有已注册角色类型的新原生 Task。传递绝对软件包根目录、角色、目标、范围和所需标准。只传递明确的 Goldfish 上下文,不包含父级讨论或历史记录。仅当规范阶段明确要求时,才包含以前的报告。在进入下一阶段之前收集每个完成结果。绝不重用审查器上下文。在调度下一阶段之前,写入每个已完成的阶段报告。对于第 8 步,将现有 zoom_out_report.md 的绝对路径传递给审查器。如果该报告缺失,请停止。如果调度、所需读取或完成失败,请报告不完整的阶段并停止。不要用线程内模拟替换原生审查器。

父级将产物写入用户的工作目录。遵循用户提示或指令文件中的 EGM artifact directory: <path>。相对于工作目录解析相对覆盖路径,并在需要时创建它。切勿将报告写入已安装的插件。保留规范的审批暂停。

验证门禁

离线检查通过 pytest tests/unit/test_cursor.py 或 pytest tests/unit 运行。它们检查元数据、原生配置,以及路径中包含空格和 Unicode 的重定位包。如果没有本地 bundle,可选的原生检查会跳过。

在 macOS 或 Linux 上,针对被检查的 arm64 CLI bundle 运行原生加载器探测:

EGM_CURSOR_BUNDLE="$HOME/.local/share/cursor-agent/versions/2026.10.01-e373342/index.js" \
  pytest tests/unit/test_cursor.py

探针按平台和 bundle SHA-256 将 Cursor CLI 2026.10.01-e373342 固定:

  • macOS arm64:f6bd8dece34b56431ee74f1ac827e032d054381085e7da7088e85abdd1008330。
  • Linux arm64:90ec23826cd3089232b0b243b8954ac72fab0454dd86d7d71ddae29d39c75cd2。

Linux bundle 来自 Cursor 的版本化包。其下载的压缩包 SHA-256 为 785c5f6bf2a60eb1121e27ed8c14f5ee07ed1b5b6692324f2d9a997238245eb5。这些哈希标识的是被检查的文件,并非供应商签名。它调用已安装的插件加载器,而不使用 CLI 入口点。它在探针内部阻断网络连接和子进程启动。它不会修补已安装的 CLI,也不会启动模型会话。私有加载器导出是版本专用的。更改固定版本之前,请重新审计它。

探针在迁移后的包中发现了七个技能、七个只读审查者注册项和一条启用的规则。最初,仅 readonly: true 注册了默认权限。新增的 permissionMode 字段纠正了这一结果。这些是原生解析结果,而非交互式安装或运行时证据。此历史说明未指明所测试的 EGM 提交或已安装包的校验和。在针对该候选版本采信之前,请对固定的候选版本重复发现流程。

在进行实时运行之前,请获得模型使用的明确批准。使用不包含无关 MCP 服务或记忆的干净工作区和用户配置。记录候选版本的 SHA、包校验和、主机版本、界面、模型和日期。

将以下结果分开记录:

门禁 所需证据 当前结果
安装 交互式发现及对已安装 personas、标准和指南的实际读取 未验证;离线原生发现已通过
工作流 头脑风暴、草稿、审查、工件,以及一次实际的人工批准暂停 未验证
隔离 全新的子级记录、必需读取、只读拒绝,以及每位审查者的完成情况 未验证

对于隔离验证,请仅在父对话中放置随机标记。检查子级的输入记录、工具记录及其回答。对一次性测试夹具探测写入拒绝,并验证其字节保持不变。原生只读模式限制写入;它并非文件系统边界。提示词还禁止使用 shell 和 MCP,但这些并非经证实的工具允许列表。请分别评估注入的规则、仓库指令、记忆、MCP 访问和共享文件。新任务不会移除这些可能的信息来源。

记录原生审查者的启动和完成情况,而不只是父级的摘要。缺失的记录会使相应的门禁保持未验证状态。

对于 CLI 2026.10.01-e373342,tests/integration/cursor_child_reads.py 检查某个子级的 SQLite 存储,查找匹配的 ReadFile 调用和成功结果:

python tests/integration/cursor_child_reads.py /absolute/path/to/child/store.db \
  --required /absolute/path/to/persona.md

根据匹配的父级 Task 完成情况,使用子级 ID 选择存储。子级停止后,使用 SQLite 的备份 API 创建封闭快照。该命令拒绝带有 WAL 文件或主文件正在变化的快照。如果某个必需路径缺少匹配的非空成功记录,该命令将以非零状态退出。存储和输出可能包含私有路径。请保持其私密。该命令仅检查读取。它不验证调度、批准、阶段顺序、隔离或工件。存储架构是私有的且版本专用。它会统计不透明的二进制 blob,但无法解释其内容。未提供完整的 Cursor 工作流跟踪解析器。在采信某个解析器之前,请测试缺失的启动、缺失的完成、格式错误的记录以及 Unicode 行分隔符。仅按字面 LF 分割 JSONL。现有的 Claude 和 Codex 跟踪测试不能验证 Cursor 证据。

Grok Bot 评估

Grok Bot 仍然是一个独立且未经验证的界面。未包含任何 Grok Bot 适配器。其工作指南描述了保留记忆和共享计算机。这些内容可能会将之前的发现暴露给另一位审查者。本地 Cursor 结果无法确立 Grok Bot 兼容性。

需求 评估
完整包导入和资源读取 未测试
全新的审查者上下文 未测试;保留记忆需要单独的探针
只读强制 未测试
原生启动和完成 未测试
人工批准暂停 未测试
记忆和共享文件中的先前发现 未测试;请独立检查两者

在这些检查之后,请单独提出任何 Grok Bot 实现方案。

移除候选版本

在 Cursor 中禁用本地 EGM 插件。仅移除你创建的候选文件夹,然后重新加载 Cursor。保留工作区工件和验证证据。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model