接入 Gemini CLI
Gemini CLI 是 Google 推出的 AI 编程命令行工具。
方式一 · 让 Gemini CLI 自己配置（推荐）
把下面的提示复制给 Gemini CLI：
text
帮我配置知言家 AI Coding 伴侣的 Gemini CLI Hooks。读取 https://zyhome.run/docs/integrations/gemini-cli.txt 并按步骤执行。保留已有配置，发现重复或冲突时先问我，不要整文件覆盖。完成后告诉我改了哪些文件、是否需要重新打开会话。方式二 · 手动配置
Gemini CLI 通过用户级 Hook 同步任务状态。
1. 下载转发脚本
powershell
$HookDir = Join-Path $env:USERPROFILE '.gemini'
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%\.gemini\settings.json，把下面两个事件增量合并到原有 hooks：
json
{
"hooks": {
"BeforeAgent": [
{
"hooks": [
{
"name": "知言家-任务开始",
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.gemini\\zy-home-hook.ps1\" -Profile gemini-cli -Event start",
"timeout": 8000
}
]
}
],
"AfterAgent": [
{
"hooks": [
{
"name": "知言家-任务完成",
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.gemini\\zy-home-hook.ps1\" -Profile gemini-cli -Event stop",
"timeout": 8000
}
]
}
]
}
}已有 BeforeAgent 或 AfterAgent 时，只追加知言家 handler。
3. 重启
完全退出 Gemini CLI，再重新打开会话。
验证
- 确认脚本和
settings.json已保存，JSON 可以正常解析。 - 重新打开 Gemini CLI，发送一条普通消息。
- 确认驱动出现来源为 gemini-cli 的任务，设备进入处理中。
- 本轮结束后，确认任务进入完成状态。
注意事项
- 只配置
BeforeAgent和AfterAgent；普通工具事件不会创建知言家任务。 - 权限通知没有可可靠配对的授权编号，因此当前不改变灯语。
- 转发脚本只使用
session_id，不发送 Prompt、回答或 Transcript；正式运行时标准输出保持安静。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1 |
| 转发脚本位置 | %USERPROFILE%\.gemini\zy-home-hook.ps1 |
| 配置文件 | %USERPROFILE%\.gemini\settings.json |
| 完成后 | 重新打开 Gemini CLI 会话 |