接入 Cursor
Cursor 是 Anysphere 推出的 AI 编程 IDE。
方式一 · 让 Cursor 自己配置（推荐）
把下面的提示复制给 Cursor：
text
帮我配置知言家 AI Coding 伴侣的 Cursor Hooks。读取 https://zyhome.run/docs/integrations/cursor.txt 并按步骤执行。保留已有配置，发现重复或冲突时先问我，不要整文件覆盖。完成后告诉我改了哪些文件、是否需要重新打开 Agent 会话。方式二 · 手动配置
Cursor 通过用户级 Hook 同步任务状态。
1. 下载转发脚本
在 PowerShell 中执行：
powershell
$HookDir = Join-Path $env:USERPROFILE '.cursor\hooks'
New-Item -ItemType Directory -Path $HookDir -Force | Out-Null
Invoke-WebRequest `
-Uri 'https://zyhome.run/docs/integrations/zy-home-hook.ps1' `
-OutFile (Join-Path $HookDir 'zy-home-hook.ps1')2. 合并 Hook 配置
编辑 %USERPROFILE%\.cursor\hooks.json。文件已存在时，只把下面两个 Hook 合并到原有 hooks 中：
json
{
"version": 1,
"hooks": {
"beforeSubmitPrompt": [
{
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.cursor\\hooks\\zy-home-hook.ps1\" -Profile cursor -Event start"
}
],
"stop": [
{
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.cursor\\hooks\\zy-home-hook.ps1\" -Profile cursor -Event stop"
}
]
}
}如果已有 beforeSubmitPrompt 或 stop，把知言家这一项追加到对应数组，不要删除原有命令。
3. 检查项目级重复配置
检查当前项目的 .cursor\hooks.json。如果里面也有知言家 Hook，只保留用户级或项目级其中一份。
4. 重新打开会话
关闭当前 Agent 会话并新建会话。Cursor 本地用户 Hook 支持重新加载，但首次配置后新开会话最容易确认完整生命周期。
验证
- 确认脚本和
hooks.json都存在，且 JSON 可以正常打开。 - 新建 Cursor Agent 会话并发送一条普通消息。
- 确认驱动出现来源为 cursor 的任务，设备进入处理中。
- 等待任务结束，确认正常完成、失败或取消与 Cursor 的实际结果一致。
注意事项
- 只配置
beforeSubmitPrompt和stop；工具执行、文件操作和子代理事件不会创建知言家任务。 - 转发脚本只使用
conversation_id、generation_id和结束状态，不发送 Prompt、回答或 Transcript。 - Cursor 云端 Agent 不读取本机用户级 Hook；本教程适用于本机 Cursor Agent。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1 |
| 转发脚本位置 | %USERPROFILE%\.cursor\hooks\zy-home-hook.ps1 |
| 配置文件 | %USERPROFILE%\.cursor\hooks.json |
| 完成后 | 重新打开 Cursor Agent 会话 |