接入 OpenHands
OpenHands 是 All Hands AI 开源的 AI 编程智能体。
方式一 · 让 OpenHands 自己配置（推荐）
把下面的提示复制给 OpenHands：
text
帮我为当前项目配置知言家 AI Coding 伴侣的 OpenHands Hooks。读取 https://zyhome.run/docs/integrations/openhands.txt 并按步骤执行。保留 .openhands\hooks.json 中已有配置，发现重复或冲突时先问我，不要整文件覆盖。完成后告诉我创建了哪些文件、是否需要重新打开会话。方式二 · 手动配置
OpenHands 通过项目级 Hook 同步任务状态。
下面的命令需要在要接入的项目根目录执行。
1. 下载转发脚本
powershell
$HookDir = Join-Path (Get-Location) '.openhands'
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 配置
编辑 <项目>\.openhands\hooks.json，把下面两个事件增量合并到现有对象：
json
{
"user_prompt_submit": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \".\\.openhands\\zy-home-hook.ps1\" -Profile openhands -Event start",
"timeout": 8
}
]
}
],
"stop": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \".\\.openhands\\zy-home-hook.ps1\" -Profile openhands -Event stop",
"timeout": 8
}
]
}
]
}如果同名事件已经存在，只追加知言家命令，不要删除其他 Hook。
3. 重新打开会话
关闭当前 OpenHands 会话，再从这个项目重新打开。
验证
- 确认
.openhands\zy-home-hook.ps1和.openhands\hooks.json都存在。 - 重新打开会话并发送一条普通消息。
- 确认驱动出现来源为 openhands 的任务，设备进入处理中。
- 本轮结束后，确认任务进入完成状态。
注意事项
- OpenHands Hook 是项目级配置；其他项目需要单独安装。
- 只配置
user_prompt_submit和stop，不根据工具事件推断授权状态。 - 转发脚本只使用
session_id，不发送 Prompt、工具参数或文件内容。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1 |
| 转发脚本位置 | <项目>\.openhands\zy-home-hook.ps1 |
| 配置文件 | <项目>\.openhands\hooks.json |
| 完成后 | 在该项目中重新打开 OpenHands 会话 |