Skip to content

cursor-host.md

Latest commit

 

History

History
70 lines (46 loc) · 6.01 KB

cursor-host.md

File metadata and controls

70 lines (46 loc) · 6.01 KB
Raw

Cursor 宿主接入

Cursor 安装一次即可支持本地 IDE 与 Agent CLI，Cloud Agent 不在本期范围。IDE 始终通过用户级 Plugin Rule 进入；CLI 在方案、开发、继续和收口等 Sopify 请求中按需选择顶层 Skill，再读取同一 Rule。普通问答不强制经过该入口。支持档位保持 BASELINE_SUPPORTED；本期不增加 launcher、项目 Rule 或 runtime，也不把安装成功外推为跨模型稳定性或完整协议认证。

安装面

curl -fsSL https://github.com/evidentloop/sopify/releases/latest/download/install.sh | bash -s -- --target cursor:zh-CN

首次安装或更新本地 Plugin 后，重启 Cursor，或执行 Developer: Reload Window，再检查 Plugin 与 Rule。Cursor 官方将 reload/restart 作为 ~/.cursor/plugins/local 本地测试流程的一部分。

安装一次，管理四个用户级落点：

  • Plugin：~/.cursor/plugins/local/sopify/.cursor-plugin/plugin.json、README.md 与 rules/sopify.mdc。README 渐进介绍用途与边界；薄 Always Rule 是 IDE 的语义入口。
  • Skills：~/.cursor/skills/sopify/SKILL.md 是 Agent CLI 的方案/开发/接续入口；同目录下的 analyze、design、develop、kb、templates 和共享 references 由 IDE 与 CLI 共用。
  • Payload：~/.cursor/sopify/，包含版本化 bundle 与 Hook helper。
  • Hooks：合并到 ~/.cursor/hooks.json；不写仓库级 hooks。

Cursor 不需要 --workspace，安装器不在目标仓库创建 .cursor/rules/sopify.mdc 或预热 .sopify。它也不创建或修改 Cursor 的 settings.json、代理、模型、账号、API Key、钥匙串或 MCP。兼容目录中的同名 Skills 不作为安装成功依据；Rule 明确路由到 ~/.cursor/skills/sopify。

--with-evidentloop 对 Cursor 当前版本 fail closed。

语义与 Hook 边界

IDE 直接加载 Plugin Rule；Agent CLI 的顶层 Skill 被选中后先读取同一 Rule。Rule 负责意图分类与 Skill 路由：

  • consult_readonly 直接只读回答，不自动恢复 active plan；
  • quick_fix 可修改用户授权的产品代码，但不直接写协议 state、handoff、receipt 或知识库；
  • 已授权动作若扩大为新的用户级或系统级持久化、删除操作，先说明新增影响并重新等待确认；
  • new_plan、continue_plan、finalize 和明确的 managed develop 才进入对应 Skill 与四步协议入口；
  • Analyze 必须实际执行 Skill 中的评分脚本，machine truth 只经 sopify_writer 库 API 写入。

用户级 Hooks 只补确定性边界，不做意图分类：

  • .sopify/ 是 managed-root 信号；没有该目录时文件与 Shell guard no-op。
  • sessionStart 只在唯一 managed root 且 active plan 方案包有效时注入事实；多根不唯一或状态无效时不猜测。
  • preToolUse 按文件目标路径拒绝明显直接写入 active_plan.json、current_handoff.json 与 plan/*/receipts/*.json。
  • beforeShellExecution 只在 cwd 所属 managed root 中拒绝同类明显直接写入；plan.md、tasks.md、design.md 和业务代码不在保护范围。
  • helper 缺失或异常 fail-open，由 Doctor 报告；这不是完整 Shell parser 或安全沙箱。

Doctor 语义

python3 scripts/sopify_doctor.py --format json --home-root "$HOME"

Cursor 分开报告：

  • cursor_plugin_present：Plugin manifest 与 Rule 是否存在；README 是包内说明，不作为行为或安装健康硬门槛；
  • global_skill_tree_present：CLI 顶层 Skill、五项阶段 Skills、共享写作/输出契约与 Analyze 评分脚本是否存在；
  • payload_present：payload/bundle 是否结构完整；
  • cursor_hooks_present：用户 hooks 与 helper 是否安全、完整；
  • cursor_ide_behavior、cursor_cli_behavior：真实宿主黑盒，默认 skip (BLACK_BOX_NOT_VERIFIED)。

缺席判定只看 Sopify 自有落点，不把整个 ~/.cursor 或现有 IDE settings 当成已安装。文件检查通过不代表 Cursor 已遵循工作流。

IDE / CLI 证据边界

IDE 与 CLI 分开记录，不互相外推：

  1. IDE baseline 已有可观察证据：已安装 Rule 含 alwaysApply: true，consult 实际读取 Cursor 写作规范并保持只读；Analyze 读取 Cursor Skill 并执行评分脚本；有限选项澄清留下 AskQuestion tool use 与 Tool not found 文本回退，结构化问卷 UI 仅作为人工观察，transcript 不含 tool result 或选项回传；managed 场景按 Analyze → Design → Develop 推进，经 sopify_writer 写 state、handoff 与 receipts；明显 Shell 直写 machine truth 被 Hook 拒绝且文件哈希不变。
  2. IDE 未验证边界：AskQuestion 是否跨模型稳定提供、独立 sessionStart 行为与显式 finalize。本期依赖文本追问回退和现有协议边界，不把这些项目作为 baseline 发布阻塞。
  3. CLI 已观察到方案审计请求自动选择顶层 Skill、读取 Plugin Rule，并在修正 description 读取顺序后通过独立 Cursor 复审。该证据只证明当前本机路径，不承诺每个普通请求、所有模型或所有机器都会自动选择。

Cursor CLI 不会自行加载用户 Plugin Rule；Sopify 通过默认安装的顶层 Skill 显式读取该 Rule，不依赖 --plugin-dir、项目 Rule 或 prompt injector。Skill 发现和模型选择仍是宿主行为，因此 Doctor 继续把安装事实与 cursor_cli_behavior 黑盒证据分开。

一次临时仓库黑盒已观察到四步读链、受管开发与 sopify_writer 写回；本机顶层 Skill 复审又观察到方案类请求按需选择入口并读取 Rule。显式 finalize、跨模型一致性与可移植黑盒仍未完整认证；Doctor 的行为项继续保持静态 BLACK_BOX_NOT_VERIFIED。

官方依据：Cursor Plugins、Plugin format、Cursor Rules、Cursor Agent Skills、Cursor Hooks、Cursor CLI。