接入 Windsurf
Windsurf 是 Codeium 推出的 AI 编程 IDE。
方式一 · 让 Windsurf 自己配置（推荐）
把下面的提示复制给 Windsurf：
text
帮我配置知言家 AI Coding 伴侣的 Windsurf Cascade Hooks。读取 https://zyhome.run/docs/integrations/windsurf.txt 并按步骤执行。保留已有配置，发现重复或冲突时先问我，不要整文件覆盖。完成后告诉我改了哪些文件、是否需要重新打开 Cascade 会话。方式二 · 手动配置
Windsurf 通过 Cascade Hook 同步任务状态。
1. 下载转发脚本
powershell
$HookDir = Join-Path $env:USERPROFILE '.codeium\windsurf'
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%\.codeium\windsurf\hooks.json，把下面两个事件增量合并到原有 hooks：
json
{
"hooks": {
"pre_user_prompt": [
{
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.codeium\\windsurf\\zy-home-hook.ps1\" -Profile windsurf -Event start",
"show_output": false
}
],
"post_cascade_response": [
{
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.codeium\\windsurf\\zy-home-hook.ps1\" -Profile windsurf -Event stop",
"show_output": false
}
]
}
}已有同名事件时追加知言家命令，不要覆盖其他 Hook。
3. 检查重复配置并重启
检查当前项目的 .windsurf\hooks.json。如果里面也有知言家 Hook，只保留一份。然后关闭当前 Cascade 会话并重新打开。
JetBrains 版请把脚本和配置分别放到 %USERPROFILE%\.codeium\zy-home-hook.ps1 与 %USERPROFILE%\.codeium\hooks.json，并同步修改命令路径。
验证
- 确认脚本和
hooks.json已保存，JSON 可以正常解析。 - 重新打开 Cascade 会话并发送一条普通消息。
- 确认驱动出现来源为 windsurf 的任务，设备进入处理中。
- 本轮结束后，确认任务进入完成状态。
注意事项
- 只配置
pre_user_prompt和post_cascade_response，不配置工具、文件和 MCP 事件。 - 不要改用
post_cascade_response_with_transcript。 post_cascade_response的输入含有响应正文，但转发脚本只取trajectory_id和execution_id，不会发送正文。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1 |
| 转发脚本位置 | %USERPROFILE%\.codeium\windsurf\zy-home-hook.ps1 |
| 配置文件 | %USERPROFILE%\.codeium\windsurf\hooks.json |
| 完成后 | 重新打开 Cascade 会话 |