接入 Factory Droid
Factory Droid 是 Factory 推出的 AI 编程智能体。
方式一 · 让 Droid 自己配置（推荐）
把下面的提示复制给 Factory Droid：
text
帮我配置知言家 AI Coding 伴侣的 Factory Droid Hooks。读取 https://zyhome.run/docs/integrations/factory-droid.txt 并按步骤执行。保留已有配置，发现重复或冲突时先问我，不要整文件覆盖。完成后告诉我改了哪些文件，并提醒我用 /hooks 审核。方式二 · 手动配置
Factory Droid 通过用户级 Hook 同步任务状态。
1. 下载转发脚本
powershell
$HookDir = Join-Path $env:USERPROFILE '.factory'
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%\.factory\hooks.json。这是独立配置文件，顶层直接使用事件名：
json
{
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.factory\\zy-home-hook.ps1\" -Profile factory-droid -Event start",
"timeout": 8
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.factory\\zy-home-hook.ps1\" -Profile factory-droid -Event stop",
"timeout": 8
}
]
}
]
}已有 UserPromptSubmit 或 Stop 时追加知言家 handler，不要覆盖原有 Hook。也要检查当前项目的 .factory\hooks.json，同一来源只保留一份。
3. 审核并重启
Droid 会提示外部修改。执行 /hooks，在 User 或 Effective 中核对脚本绝对路径和两个事件，再允许配置。然后重新打开会话。
验证
- 在
/hooks中确认两个知言家 Hook 已加载。 - 新开会话并发送一条普通消息。
- 确认驱动出现来源为 factory-droid 的任务，设备进入处理中。
- 本轮自然结束后，确认任务进入完成状态。
注意事项
- 不配置
Notification.idle_prompt；它也会在用户取消后出现，不能当作完成。 - 当前不根据
permission_prompt或elicitation_dialog改变灯语，避免多个等待请求相互覆盖。 - 转发脚本只使用
session_id，不发送 Prompt、通知正文或 Transcript。
速查
| 项目 | 路径或动作 |
|---|---|
| 转发脚本来源 | zy-home-hook.ps1 |
| 转发脚本位置 | %USERPROFILE%\.factory\zy-home-hook.ps1 |
| 配置文件 | %USERPROFILE%\.factory\hooks.json |
| 完成后 | 在 Droid 中执行 /hooks 审核并重新打开会话 |