接入 WorkBuddy
一键配置
将下面的提示复制给 WorkBuddy:
text
帮我配置知言家 AI Coding 伴侣的 WorkBuddy Hook。读 https://zyhome.run/docs/integrations/workbuddy.txt 按步骤执行。保留已有配置,冲突时先问我,不要整文件覆盖。完成后告诉我改了什么、是否需要重启。配置位置
text
%USERPROFILE%\.workbuddy\settings.json文件不存在时创建;已经存在时只合并知言家 hooks,保留其他配置。
安装步骤
确认本机已安装知言家驱动,并确认 %LOCALAPPDATA%\zy_home_vibe_coding_driver\bin\zy_home_vibe_coding_driver_hookbridge.exe 存在。修改前备份 settings.json;已有同名 zy-vibe- handler 时更新它,不要重复追加。
1. 合并 hooks 配置
将下面的 hooks 节点增量合并到 settings.json:
json
{
"hooks": {
"UserPromptSubmit": [
{ "hooks": [ { "type": "command", "command": "\"$LOCALAPPDATA/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe\" --source workbuddy --hook-event-name UserPromptSubmit", "timeout": 8 } ] }
],
"PreToolUse": [
{ "hooks": [ { "type": "command", "command": "\"$LOCALAPPDATA/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe\" --source workbuddy --hook-event-name PreToolUse", "timeout": 8 } ] }
],
"PostToolUse": [
{ "hooks": [ { "type": "command", "command": "\"$LOCALAPPDATA/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe\" --source workbuddy --hook-event-name PostToolUse", "timeout": 8 } ] }
],
"PermissionRequest": [
{ "hooks": [ { "type": "command", "command": "\"$LOCALAPPDATA/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe\" --source workbuddy --hook-event-name PermissionRequest", "timeout": 8 } ] }
],
"Stop": [
{ "hooks": [ { "type": "command", "command": "\"$LOCALAPPDATA/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe\" --source workbuddy --hook-event-name Stop", "timeout": 8 } ] }
]
}
}$LOCALAPPDATA 展开为当前用户目录;若你的环境无法正确展开,将整段替换为 hookbridge.exe 的实际绝对路径(例如 "C:/Users/你的用户名/AppData/Local/zy_home_vibe_coding_driver/bin/zy_home_vibe_coding_driver_hookbridge.exe")。
2. 生效
hooks 不支持热加载——已打开的会话使用启动时读取的配置快照。修改后通过以下任一方式生效:
- 重启 WorkBuddy(重新捕获配置快照);
- 新建会话(
/clear),或完全退出后重新打开。
若你的 WorkBuddy 版本提供 /hooks 面板,也可在面板中审核外部修改后直接应用,无需重启。
3. 验证
发一条普通消息,确认驱动控制台出现来源为“WorkBuddy”的任务记录。
触发一次授权,确认灯效进入等待授权状态。说明:WorkBuddy 桌面版的授权确认(含安全删除的批量确认)走的是 IDE 内置的环境守卫与原生权限对话框,不会触发
PermissionRequest或Notificationhook 事件;并且驱动对workbuddy来源的「等待授权」事件按来源白名单丢弃。因此「等待授权」灯效在 WorkBuddy 下不适用——当前只有「处理中」与「已完成」会随真实会话点亮。完成本轮任务,确认灯效进入完成状态。
