Initial commit

commands/webhook-test.md

@@ -0,0 +1,118 @@
+# /webhook-test - 测试通知功能
+
+发送测试通知，验证 Webhook 和 macOS 通知配置是否正确。
+
+## 🚀 首次使用
+
+**重要**：此命令首次使用需要安装依赖（仅需一次）
+
+如果看到依赖缺失提示，请执行：
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}
+npm install
+```
+
+安装完成后即可使用测试功能。
+
+## 功能说明
+
+此命令支持测试所有已启用的通知器：
+- **macOS 通知** - 发送系统通知到通知中心
+- **Webhook 通知** - 发送 HTTP POST 请求到配置的 URL
+- **全部测试** - 测试所有启用的通知器
+
+## 命令选项
+
+- 无参数 - 测试所有启用的通知器
+- `--notifier macos` - 仅测试 macOS 通知
+- `--notifier webhook` - 仅测试 Webhook 通知
+- `--notifier all` - 测试所有通知器（默认）
+
+## 使用示例
+
+### 测试所有通知器
+```bash
+/webhook-test
+```
+
+### 仅测试 macOS 通知
+```bash
+/webhook-test --notifier macos
+```
+
+### 仅测试 Webhook
+```bash
+/webhook-test --notifier webhook
+```
+
+## 测试内容
+
+### macOS 通知测试
+发送系统通知到 macOS 通知中心，包含：
+- 标题：配置的通知标题
+- 副标题："等待输入"
+- 消息：测试消息内容
+- 声音：配置的通知声音
+
+### Webhook 通知测试
+发送 HTTP POST 请求到配置的 Webhook URL，包含：
+```json
+{
+  "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/`
+   ```bash
+   /webhook-logs --lines 10
+   ```
+4. **Webhook 端点** - 检查服务端是否收到测试请求
+
+## 故障排除
+
+### 依赖缺失
+如果看到 "缺少必需的依赖" 提示：
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}
+npm install
+```
+
+### macOS 通知未显示
+- 检查配置：`/webhook-config --show`
+- 验证 macos.enabled 是否为 true
+- 检查系统通知权限
+
+### Webhook 测试失败
+- 验证 URL 配置正确
+- 检查网络连接
+- 查看详细日志：`/webhook-logs --level error`
+
+## 相关命令
+
+- `/webhook-config` - 配置通知系统
+- `/webhook-logs` - 查看通知历史和错误日志
+
+---
+
+**执行方式：**
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/commands/webhook-test-wrapper.sh "$@"
+```