接入 Cline
Cline 是开源的 AI 编程助手(VS Code 扩展)。
方式一 · 让 Cline 自己配置(推荐)
把下面的提示复制给 Cline:
text
帮我配置知言家 AI Coding 伴侣的 Cline Hooks。读取 https://zyhome.run/docs/integrations/cline.txt 并按步骤执行。只处理 %USERPROFILE%\Documents\Cline\Hooks\ 下的三个知言家 Hook;已有同名文件时先问我,不要直接覆盖。完成后告诉我创建了哪些文件、是否需要重新打开任务。方式二 · 手动安装
Windows 版 Cline 通过固定文件名的 Hook 脚本同步任务状态。
1. 检查同名 Hook
打开 %USERPROFILE%\Documents\Cline\Hooks\。如果已经存在下面三个文件,先备份并确认它们不是其他用途:
text
UserPromptSubmit.ps1
TaskComplete.ps1
TaskCancel.ps12. 下载三个 Hook 文件
三个文件使用同一份知言家脚本,文件名由 Cline 决定触发时机。在 PowerShell 中执行:
powershell
$HookDir = Join-Path $env:USERPROFILE 'Documents\Cline\Hooks'
$Source = 'https://zyhome.run/docs/integrations/zy-home-hook.ps1'
New-Item -ItemType Directory -Path $HookDir -Force | Out-Null
Invoke-WebRequest -Uri $Source -OutFile (Join-Path $HookDir 'UserPromptSubmit.ps1')
Invoke-WebRequest -Uri $Source -OutFile (Join-Path $HookDir 'TaskComplete.ps1')
Invoke-WebRequest -Uri $Source -OutFile (Join-Path $HookDir 'TaskCancel.ps1')Windows 版 Cline 会自动发现这三个准确文件名,不需要再编辑 JSON 配置。
3. 检查项目级重复 Hook
检查当前项目的 .clinerules\hooks\。如果那里也有这三个知言家 Hook,只保留全局或项目级其中一份。
4. 重新打开任务
关闭当前 Cline 任务并新建任务。Windows 版只要 .ps1 文件存在就会执行,不需要额外打开启用开关。
验证
- 确认三个
.ps1文件都已保存到全局 Hook 目录。 - 新建 Cline 任务并发送一条普通消息。
- 确认驱动出现来源为 cline 的任务,设备进入处理中。
- 正常完成一次任务,再取消一次测试任务,确认两种结果没有混为成功完成。
注意事项
- 文件名和
.ps1扩展名必须完全一致,其他名称不会被 Windows 版 Cline 识别。 - 不安装
TaskStart,避免它和UserPromptSubmit重复创建任务。 - Hook 返回 Cline 要求的放行 JSON;知言家异常不会阻止 Cline 工作。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1(同一份脚本保存为三个文件名) |
| Hook 目录 | %USERPROFILE%\Documents\Cline\Hooks\ |
| 固定文件名 | UserPromptSubmit.ps1、TaskComplete.ps1、TaskCancel.ps1 |
| 完成后 | 重新打开 Cline 任务 |
