2.6 KiB
2.6 KiB
/webhook-test - 测试通知功能
发送测试通知,验证 Webhook 和 macOS 通知配置是否正确。
🚀 首次使用
重要:此命令首次使用需要安装依赖(仅需一次)
如果看到依赖缺失提示,请执行:
cd ${CLAUDE_PLUGIN_ROOT}
npm install
安装完成后即可使用测试功能。
功能说明
此命令支持测试所有已启用的通知器:
- macOS 通知 - 发送系统通知到通知中心
- Webhook 通知 - 发送 HTTP POST 请求到配置的 URL
- 全部测试 - 测试所有启用的通知器
命令选项
- 无参数 - 测试所有启用的通知器
--notifier macos- 仅测试 macOS 通知--notifier webhook- 仅测试 Webhook 通知--notifier all- 测试所有通知器(默认)
使用示例
测试所有通知器
/webhook-test
仅测试 macOS 通知
/webhook-test --notifier macos
仅测试 Webhook
/webhook-test --notifier webhook
测试内容
macOS 通知测试
发送系统通知到 macOS 通知中心,包含:
- 标题:配置的通知标题
- 副标题:"等待输入"
- 消息:测试消息内容
- 声音:配置的通知声音
Webhook 通知测试
发送 HTTP POST 请求到配置的 Webhook URL,包含:
{
"event": "notification",
"notification_type": "waiting_for_input",
"message": "This is a test notification",
"timestamp": "2025-10-31T08:00:00.000Z",
"session": {
"id": "test-cli-1234567890"
},
"project": {
"directory": "/current/working/directory",
"git_branch": "main",
"git_commit": "abc123..."
}
}
检查结果
执行命令后,检查以下内容:
- 终端输出 - 查看是否显示 "✅ Test completed successfully!"
- macOS 通知中心 - 应该看到测试通知弹窗(如果启用)
- 日志文件 -
~/.claude/webhook-notifier/logs//webhook-logs --lines 10 - Webhook 端点 - 检查服务端是否收到测试请求
故障排除
依赖缺失
如果看到 "缺少必需的依赖" 提示:
cd ${CLAUDE_PLUGIN_ROOT}
npm install
macOS 通知未显示
- 检查配置:
/webhook-config --show - 验证 macos.enabled 是否为 true
- 检查系统通知权限
Webhook 测试失败
- 验证 URL 配置正确
- 检查网络连接
- 查看详细日志:
/webhook-logs --level error
相关命令
/webhook-config- 配置通知系统/webhook-logs- 查看通知历史和错误日志
执行方式:
bash ${CLAUDE_PLUGIN_ROOT}/commands/webhook-test-wrapper.sh "$@"