Files
gh-zephyrdeng-cc-plugins-pl…/commands/webhook-test.md
2025-11-30 09:08:27 +08:00

2.6 KiB
Raw Blame History

/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..."
  }
}

检查结果

执行命令后,检查以下内容:

  1. 终端输出 - 查看是否显示 " Test completed successfully!"
  2. macOS 通知中心 - 应该看到测试通知弹窗(如果启用)
  3. 日志文件 - ~/.claude/webhook-notifier/logs/
    /webhook-logs --lines 10
    
  4. 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 "$@"