---
description: 引导在业务仓安装并配置 pi-cursor-sdk（Cursor 模型/Agent）；检查扩展与凭证
argument-hint: "[可选：status|help]"
---

> Pi 包 `@suwenguang/pi-kb`：运行时包根为环境变量 `PI_KB_ROOT`（由 `extensions/kb-root.ts` 注入）。
> 工种子 Agent 通过 **pi-subagents** 派发（已 bundled）；agent 定义见本包 `agents/`。
> 脚本调用示例：`node "$PI_KB_ROOT/scripts/<name>.mjs"`。

## 用户输入

${@:-（未附带参数；结合当前对话上下文执行，缺信息时向用户澄清。）}

---
引导用户完成 **Cursor Agent（`pi-cursor-sdk`）** 接入，使 Pi 可选 `cursor/*` 模型（推荐 `cursor/composer-2-5`）。

**注意**：本包**不** bundled `pi-cursor-sdk`（`@cursor/sdk` 含按平台二进制，跨 OS 打包不安全）。须在业务仓单独 `pi install`。

细则 SSOT：[kb-cursor-sdk.md](../skills/kb-workflow/references/kb-cursor-sdk.md)。

## Bootstrap

本命令**豁免**业务仓 bootstrap 门禁（与反馈/进化/DeepSeek setup 类似）：未 `/kb-init` 也可执行。

## 执行步骤

### 1. 探测是否已有 Cursor provider

- 若当前会话模型列表已有 `cursor/...`（或用户确认已装 `pi-cursor-sdk`）：进入步骤 2 查凭证。  
- 若没有：进入步骤 1b，**不要**臆造 Cursor 能力。

### 1b. 引导安装（缺扩展时）

请用户在**业务仓根**执行（Agent 可代跑；勿把 Key 写进命令历史以外的文件）：

```bash
pi install npm:pi-cursor-sdk -l --approve
```

然后 `/reload` 或新开 Pi 会话。环境要求：Node.js **22.19+**、Pi 建议 ≥ 0.80.9。

### 2. 引导配置凭证

按优先级请用户完成**其一**（本步只引导，Agent **禁止**索要或回显完整 API Key）：

1. Pi 执行 `/login` → Use an API key → **Cursor**  
2. 或本机：`export CURSOR_API_KEY=cursor_...`（申请：https://cursor.com/dashboard/integrations）

说明：不复用 Cursor Desktop / Agent CLI 登录态；Team Admin API Key 暂不支持。

### 3. 生效与选用模型

请用户：

```bash
pi --approve --model cursor/composer-2-5
# 或会话内：
/model
# 选 cursor/composer-2-5（或其它 cursor/*）
```

可选校验：`pi --list-models cursor`；登录后若目录不全可 `/cursor-refresh-models`。

### 4. 与 KB / MCP 关系（口头交代）

1. **KB 主流程不变**；换 Cursor 模型跑 `/kb-*` 即可。  
2. **Pi MCP**（`.pi/mcp.json`）与 **Cursor MCP**（`.cursor/mcp.json`）两套，不自动同步。  
3. `pi-cursor-sdk` 可选把 Pi 工具以 `pi__*` 桥给 Cursor（本地 bridge）。  
4. 完整条文：`skills/kb-workflow/references/kb-cursor-sdk.md`。

## 输出结构

1. **状态**：已就绪 / 缺扩展 / 缺 Key / 需 reload  
2. **用户下一步**：1～3 条可执行动作  
3. **实践入口**：`kb-cursor-sdk.md` 路径

始终使用简体中文。