agentwake 1.0.0 → 1.0.2-beta.0

package/.cursor/hooks.json

@@ -3,12 +3,12 @@
   "hooks": {
     "beforeShellExecution": [
       {
-        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
+        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" CURSOR_AGENT=\"${CURSOR_AGENT:-1}\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
       }
     ],
     "afterShellExecution": [
       {
-        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
+        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" CURSOR_AGENT=\"${CURSOR_AGENT:-1}\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
       }
     ]
   }

package/.env.example

@@ -1,18 +1,19 @@
 AGENTWAKE_HOST=0.0.0.0
 AGENTWAKE_PORT=3199
-AGENTWAKE_HTTPS_ENABLED=1
+AGENTWAKE_HTTPS_ENABLED=0
 AGENTWAKE_HTTPS_CERT_PATH=certs/dev-cert.pem
 AGENTWAKE_HTTPS_KEY_PATH=certs/dev-key.pem
 AGENTWAKE_CURSOR_HOOK_PATH=/hooks/cursor
 AGENTWAKE_CLAUDE_HOOK_PATH=/hooks/claude
 AGENTWAKE_QODER_LOG_PATH=/path/to/qoder.log
 AGENTWAKE_WS_PATH=/ws
+AGENTWAKE_DESKTOP_ENABLED=1
+AGENTWAKE_PWA_ENABLED=0
 AGENTWAKE_DEDUPE_WINDOW_MS=10000
 AGENTWAKE_RATE_LIMIT_WINDOW_MS=10000
 AGENTWAKE_RATE_LIMIT_MAX_EVENTS=40
 AGENTWAKE_ALLOWED_HOOK_IPS=
 AGENTWAKE_VAPID_SUBJECT=mailto:agentwake@example.com
-AGENTWAKE_DESKTOP_MODE=notification
 AGENTWAKE_CURSOR_APPROVAL_MODE=cursor-ask
 AGENTWAKE_CURSOR_ENFORCE_ASK=0
 # AGENTWAKE_VAPID_PUBLIC_KEY=

package/README.md

@@ -1,137 +1,277 @@
-# AgentWake 🚀
+# AgentWake
 
-**AgentWake** 是一个跨编辑器（Cursor / Claude Code / Qoder）的终端授权提醒网关。  
-当你在使用 AI 辅助编程工具时，终端任务经常会进入“等待用户同意（Approval）”状态。AgentWake 会在桌面和移动端为你提供实时通知，让你无需时刻盯着屏幕，告别阻塞等待！
+English | [简体中文](README.zh-CN.md)
+
+A cross-editor AI programming notification gateway. Supports Cursor / Claude Code / Qoder. Real-time push notifications to desktop, mobile, and IM groups when AI tasks are completed, abnormally terminated, or waiting for authorization.
+
+## Preview
+
+<p align="center">
+  <img src="docs/screenshots/web.jpg" width="48%" alt="Web Interface" />
+  <img src="docs/screenshots/mobile_notify.jpg" width="48%" alt="Mobile Notification" />
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/cursor.png" width="48%" alt="Cursor Notification" />
+  <img src="docs/screenshots/qoder.png" width="48%" alt="Qoder Notification" />
+</p>
 
 ---
 
-## 🌟 核心特性
+## Core Features
 
-- **多编辑器支持**：原生支持监听 Cursor Hook、Claude Hook 以及 Qoder 日志中的授权等待信号。
-- **全平台桌面通知**：支持 macOS、Windows、Linux 的系统级弹窗提醒。
-- **移动端实时提醒**：内置移动端 Web 应用，支持 PWA 安装，通过 HTTPS + WebSocket 实现手机端毫秒级推送。
-- **智能防打扰**：内置去重和限流机制，避免消息重复轰炸。
-- **开箱即用**：提供极简的 CLI 命令行工具，一键初始化与启动。
+- **Multi-editor Support** — Cursor Hook, Claude Code Hook, Qoder log listening
+- **Multi-channel Notifications** — Desktop system notifications, PWA web push, DingTalk, Feishu, WeCom
+- **Claude Code Deep Integration** — Supports all Hook events like Stop / Notification / StopFailure / SessionEnd, customizable notification titles for each event
+- **Mobile Real-time Push** — Built-in PWA Web App, HTTPS + WebSocket millisecond push, supports QR code connection
+- **Smart Anti-disturbance** — Event deduplication + rate limiting to prevent message bombing
+- **Interactive Configuration** — `agentwake setup` guides you through all configurations step by step
 
 ---
 
-## 🚀 快速开始
+## Quick Start
+
+### Prerequisites
+
+- Node.js >= 18
+- [mkcert](https://github.com/FiloSottile/mkcert) (Only required when enabling PWA push)
+
+### Installation
+
+```bash
+npm i -g agentwake
+```
 
-### 环境要求
+### Method 1: Interactive Guide (Recommended)
 
-- Node.js (推荐 v18+)
-- [mkcert](https://github.com/FiloSottile/mkcert) (用于生成本地 HTTPS 证书，移动端访问必备)
+```bash
+agentwake setup    # Interactive configuration wizard
+```
 
-### 安装与启动
+`setup` will guide you through:
+1. Select AI tools (Claude Code / Cursor / All)
+2. Select event types to listen to
+3. Customize notification titles for each event (optional)
+4. Select notification channels (DingTalk / Feishu / WeCom / PWA / Desktop)
+5. Enter Webhook URLs and secrets
+6. Automatically install editor hooks:
+   - Claude Code Hooks to `~/.claude/settings.json`
+   - Cursor Hooks to `~/.cursor/hooks.json` (relay script at `~/.agentwake/hooks/cursor-hook.sh`)
+7. If PWA is enabled, generate HTTPS certificates automatically; otherwise default to HTTP
+8. Start the service
 
-1. **全局安装 CLI**
-   ```bash
-   npm i -g agentwake
-   ```
+### Method 2: Manual Configuration
 
-2. **初始化项目与证书**
-   ```bash
-   mkdir my-agentwake && cd my-agentwake
-   agentwake init
-   ```
-   *注意：初始化过程中会自动使用 mkcert 生成本地 HTTPS 证书。*
+```bash
+agentwake setup   # Generate ~/.agentwake/.env and complete configuration
+# Edit ~/.agentwake/.env to fill in configurations
+agentwake start
+```
 
-3. **启动网关服务**
-   ```bash
-   agentwake start
-   ```
+All data is stored in the `~/.agentwake/` directory, no need to create a working directory manually.
 
-启动后，网关默认运行在 `https://localhost:3199` (或者局域网 IP)。
+### Method 3: Start from Source
+
+```bash
+git clone https://github.com/tjdxwwj/agentwake.git
+cd agentwake
+npm install
+
+# Interactive setup
+npm run setup
+
+# Start development server
+npm run dev
+```
+
+After starting, the service runs at `http://localhost:3199` by default, or `https://localhost:3199` when PWA is enabled.
 
 ---
 
-## 🔌 编辑器接入指南
+## Notification Channels
 
-### Cursor 接入
+| Channel | Configuration | Description |
+|------|---------|------|
+| Desktop Notification | Built-in, no config needed | macOS / Windows / Linux |
+| PWA Web Push | Built-in, open service URL in mobile browser | Requires HTTPS, supports Service Worker system notifications |
+| DingTalk | `AGENTWAKE_DINGTALK_WEBHOOK` | Group bot Webhook, supports signature verification |
+| Feishu | `AGENTWAKE_FEISHU_WEBHOOK` | Group bot Webhook, supports signature verification |
+| WeCom | `AGENTWAKE_WECOM_WEBHOOK` | Group bot Webhook, security guaranteed by URL Key |
 
-AgentWake 已经内置了对 Cursor 工作流的支持：
-1. 确保在目标项目中执行过 `agentwake init`。
-2. 保持 `agentwake start` 运行。
-3. 当 Cursor 终端触发需要用户授权的命令时，你将立刻收到通知。
+### DingTalk Configuration
 
-### Qoder 接入
+In DingTalk Group -> Group Settings -> Smart Group Assistant -> Add Bot -> Custom Webhook, copy the Webhook URL.
 
-AgentWake 会尝试自动发现 Qoder 的日志目录（如 macOS 下的 `~/Library/Application Support/Qoder/logs/.../agent.log`）。
+```env
+AGENTWAKE_DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx
+AGENTWAKE_DINGTALK_SECRET=SECxxx   # Optional, signature secret
+```
+
+### Feishu Configuration
+
+In Feishu Group -> Settings -> Bots -> Add Custom Bot, copy the Webhook URL.
+
+```env
+AGENTWAKE_FEISHU_WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+AGENTWAKE_FEISHU_SECRET=xxx   # Optional, signature verification secret
+```
+
+### WeCom Configuration
+
+In WeCom Group -> Group Bots -> Add Group Bot, copy the Webhook URL.
+
+```env
+AGENTWAKE_WECOM_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx
+```
+
+---
+
+## Editor Integration
+
+### Claude Code
+
+Running `agentwake setup` will automatically:
+- Generate Hook relay script to `~/.agentwake/hooks/claude-hook-relay.sh`
+- Write Hook configuration to `~/.claude/settings.json`
+
+Supported Hook events:
+
+| Event | Description | Enabled by Default |
+|------|------|---------|
+| Notification | Requires user attention | Yes |
+| Stop | Task completed | Yes |
+| StopFailure | Task terminated abnormally | Yes |
+| SessionEnd | Session ended | Yes |
+| SessionStart | Session started | No |
+| PreToolUse | Before tool use | No |
+| PostToolUse | After tool use | No |
+
+### Cursor
+
+Running `agentwake setup` will automatically:
+- Generate Cursor relay script to `~/.agentwake/hooks/cursor-hook.sh`
+- Write `beforeShellExecution` / `afterShellExecution` Hook commands to `~/.cursor/hooks.json`
+
+Then keep `agentwake start` running to receive Cursor approval/lifecycle notifications.
+
+### Qoder
+
+Automatically discover log directory, or specify manually:
 
-如果自动发现失败，你可以通过环境变量手动指定日志路径：
 ```bash
-AGENTWAKE_QODER_LOG_PATH="/ABSOLUTE/PATH/TO/agent.log" agentwake start
+AGENTWAKE_QODER_LOG_PATH="/path/to/agent.log" agentwake start
 ```
 
 ---
 
-## 📱 移动端访问与证书信任（必读）
+## Custom Notification Titles
+
+Set interactively via `agentwake setup`, or configure directly in `.env`:
 
-为了在手机上接收实时通知，你必须让手机信任电脑上由 `mkcert` 生成的根证书。
+```env
+AGENTWAKE_CLAUDE_TITLE_STOP=AI Done
+AGENTWAKE_CLAUDE_TITLE_STOP_FAILURE=AI Failed
+AGENTWAKE_CLAUDE_TITLE_NOTIFICATION=AI Needs Attention
+AGENTWAKE_CLAUDE_TITLE_SESSION_END=Session Ended
+```
 
-1. 找到根证书位置：
-   在电脑终端运行 `mkcert -CAROOT`，找到目录下的 `rootCA.pem` 文件。
-2. 安装到手机：
-   - **iOS**：将文件发送到手机，在“设置”中安装描述文件，并在“通用 -> 关于本机 -> 证书信任设置”中开启“完全信任”。
-   - **Android**：将文件发送到手机，在安全设置中“从存储设备安装” CA 证书（部分安卓系统可能需要将后缀改为 `.crt`）。
-3. Node.js TLS 兼容（如果遇到本地转发报错）：
-   ```bash
-   export NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem"
-   ```
+Events without configured titles will use default titles.
 
 ---
 
-## 🛠️ 面向开发者
+## Mobile PWA Setup
 
-如果你想参与 AgentWake 的开发，请参考以下指南：
+Your phone needs to trust the local HTTPS certificate to receive Service Worker system notifications.
 
-### 技术栈
-- **后端**：Node.js + TypeScript + Express + WebSocket (`ws`) + Zod
-- **前端**：HTML/CSS/JS (PWA 支持)
-- **系统交互**：`node-notifier` (桌面通知)
+1. Get root certificate path: run `mkcert -CAROOT` to find `rootCA.pem`
+2. Install on mobile:
+   - **iOS** — Send to phone, install profile, then enable full trust in Settings > General > About > Certificate Trust Settings
+   - **Android** — Install CA certificate in security settings (may need to rename extension to `.crt`)
+3. Open `https://<LAN IP>:3199` in mobile browser, confirm HTTPS connection is secure and allow notification permissions
 
-### 本地开发
+---
+
+## All Environment Variables
+
+| Variable | Default Value | Description |
+|------|--------|------|
+| `AGENTWAKE_HOST` | `0.0.0.0` | Listening address |
+| `AGENTWAKE_PORT` | `3199` | Listening port |
+| `AGENTWAKE_HTTPS_ENABLED` | `0` | Enable HTTPS (auto set to `1` when PWA is enabled) |
+| `AGENTWAKE_HTTPS_CERT_PATH` | `certs/dev-cert.pem` | HTTPS certificate path |
+| `AGENTWAKE_HTTPS_KEY_PATH` | `certs/dev-key.pem` | HTTPS private key path |
+| `AGENTWAKE_DESKTOP_ENABLED` | `1` | Enable desktop system notifications (`0` to disable); on ARM, uses native command fallback instead of `node-notifier` |
+| `AGENTWAKE_PWA_ENABLED` | `0` | Enable PWA/WebSocket push (`0` to disable) |
+| `AGENTWAKE_DINGTALK_ENABLED` | `1` | Enable DingTalk notifications (`0` to disable) |
+| `AGENTWAKE_DINGTALK_WEBHOOK` | — | DingTalk Webhook URL |
+| `AGENTWAKE_DINGTALK_SECRET` | — | DingTalk signature secret |
+| `AGENTWAKE_FEISHU_ENABLED` | `1` | Enable Feishu notifications (`0` to disable) |
+| `AGENTWAKE_FEISHU_WEBHOOK` | — | Feishu Webhook URL |
+| `AGENTWAKE_FEISHU_SECRET` | — | Feishu signature secret |
+| `AGENTWAKE_WECOM_ENABLED` | `1` | Enable WeCom notifications (`0` to disable) |
+| `AGENTWAKE_WECOM_WEBHOOK` | — | WeCom Webhook URL |
+| `AGENTWAKE_CLAUDE_TITLE_*` | — | Claude event custom titles |
+| `AGENTWAKE_DEDUPE_WINDOW_MS` | `10000` | Deduplication window (ms) |
+| `AGENTWAKE_RATE_LIMIT_WINDOW_MS` | `10000` | Rate limit window (ms) |
+| `AGENTWAKE_RATE_LIMIT_MAX_EVENTS` | `40` | Max events within window |
+| `AGENTWAKE_WS_PATH` | `/ws` | WebSocket path |
+| `AGENTWAKE_QODER_LOG_PATH` | — | Qoder log path (auto-discovered) |
+| `AGENTWAKE_ALLOWED_HOOK_IPS` | — | Limit Hook source IPs (comma-separated) |
+
+---
+
+## Development
 
 ```bash
-# 1. 克隆代码并安装依赖
-git clone https://github.com/your-username/agentwake.git
+git clone https://github.com/tjdxwwj/agentwake.git
 cd agentwake
 npm install
-
-# 2. 准备环境变量
 cp .env.example .env
+npm run setup    # Interactive setup (optional PWA/HTTPS)
+npm run dev      # Start development server
+npm test         # Run tests
+```
 
-# 3. 初始化（生成本地证书等）
-npm run init
+### Directory Structure
 
-# 4. 启动开发服务器
-npm run dev
 ```
+src/
+  adapters/       # Input adapters (Cursor / Claude / Qoder)
+  gateway/        # Core gateway (Adapter registration, event routing)
+  notifiers/      # Notification dispatchers (Desktop / WebSocket / DingTalk / Feishu / WeCom)
+  installers/     # Hook auto-installers
+web/              # PWA frontend
+```
+
+### Tech Stack
 
-### 核心目录结构
-- `src/adapters/`：各类编辑器（Cursor/Claude/Qoder）的输入信号适配器。
-- `src/gateway/`：核心网关，负责 Adapter 注册与事件路由。
-- `src/notifiers/`：通知分发器（桌面系统通知、移动端 WebSocket、PWA Push）。
-- `web/`：移动端 Web App 源码。
+Node.js + TypeScript + Express + WebSocket (ws) + Zod
 
 ---
 
-## ❓ 常见问题 (FAQ)
+## FAQ
 
-**Q: 为什么手机端收不到通知？**  
-A: 请按顺序检查：
-1. 手机是否和电脑在同一局域网下。
-2. 手机浏览器是否显示“安全/受信任”的 HTTPS 连接（若显示不安全，请重新检查证书安装步骤）。
-3. 检查 Web 页面上的 WebSocket 连接状态是否显示为“已连接”。
+**Cannot receive notifications on mobile?**
+1. Ensure phone and computer are on the same LAN
+2. Ensure browser shows secure HTTPS connection (not "Not Secure")
+3. Ensure notification permissions are granted
+4. Check if Web page WebSocket status is "Connected"
 
-**Q: 能否自定义运行端口？**  
-A: 可以，通过 CLI 参数或环境变量修改：
+**How to change port?**
 ```bash
-agentwake start --port 4000
-# 或者使用环境变量
 AGENTWAKE_PORT=4000 agentwake start
 ```
 
+**Can personal WeChat receive notifications?**
+WeChat does not support Webhook message push API. You can use WeCom group bots as an alternative.
+
+---
+
+## Contributors
+
+- [@tjdxwwj](https://github.com/tjdxwwj)
+- [@qiangguanglin](https://github.com/qiangguanglin)
+
 ---
 
-*AgentWake - 让 AI 编程更省心。*
+MIT License

package/README.zh-CN.md

@@ -0,0 +1,277 @@
+# AgentWake
+
+[English](README.md) | 简体中文
+
+跨编辑器的 AI 编程通知网关。支持 Cursor / Claude Code / Qoder，当 AI 任务完成、异常终止或等待授权时，实时推送通知到桌面、手机和 IM 群。
+
+## 效果预览
+
+<p align="center">
+  <img src="docs/screenshots/web.jpg" width="48%" alt="Web 界面" />
+  <img src="docs/screenshots/mobile_notify.jpg" width="48%" alt="手机通知" />
+</p>
+
+<p align="center">
+  <img src="docs/screenshots/cursor.png" width="48%" alt="Cursor 通知" />
+  <img src="docs/screenshots/qoder.png" width="48%" alt="Qoder 通知" />
+</p>
+
+---
+
+## 核心特性
+
+- **多编辑器支持** — Cursor Hook、Claude Code Hook、Qoder 日志监听
+- **多通知渠道** — 桌面系统通知、PWA 网页推送、钉钉、飞书、企业微信
+- **Claude Code 深度集成** — 支持 Stop / Notification / StopFailure / SessionEnd 等全部 Hook 事件，可自定义每个事件的通知标题
+- **移动端实时推送** — 内置 PWA Web App，HTTPS + WebSocket 毫秒级推送，支持扫码连接
+- **智能防打扰** — 事件去重 + 速率限流，避免消息轰炸
+- **交互式配置** — `agentwake setup` 一步步引导完成全部配置
+
+---
+
+## 快速开始
+
+### 环境要求
+
+- Node.js >= 18
+- [mkcert](https://github.com/FiloSottile/mkcert)（仅在启用 PWA 推送时需要）
+
+### 安装
+
+```bash
+npm i -g agentwake
+```
+
+### 方式一：交互式引导（推荐）
+
+```bash
+agentwake setup    # 交互式配置向导
+```
+
+`setup` 会引导你完成：
+1. 选择 AI 工具（Claude Code / Cursor / 全部）
+2. 选择监听的事件类型
+3. 自定义每个事件的通知标题（可选）
+4. 选择通知渠道（钉钉 / 飞书 / 企业微信 / PWA / 桌面通知）
+5. 输入 Webhook 地址和密钥
+6. 自动安装编辑器 Hooks：
+   - Claude Code Hooks 到 `~/.claude/settings.json`
+   - Cursor Hooks 到 `~/.cursor/hooks.json`（转发脚本位于 `~/.agentwake/hooks/cursor-hook.sh`）
+7. 若启用 PWA 则自动生成 HTTPS 证书；未启用则默认使用 HTTP
+8. 启动服务
+
+### 方式二：手动配置
+
+```bash
+agentwake setup   # 生成 ~/.agentwake/.env 并完成配置
+# 编辑 ~/.agentwake/.env 填入配置
+agentwake start
+```
+
+所有数据存放在 `~/.agentwake/` 目录下，无需手动创建工作目录。
+
+### 方式三：从源码启动
+
+```bash
+git clone https://github.com/tjdxwwj/agentwake.git
+cd agentwake
+npm install
+
+# 交互式配置
+npm run setup
+
+# 启动开发服务器
+npm run dev
+```
+
+启动后服务默认运行在 `http://localhost:3199`；启用 PWA 后为 `https://localhost:3199`。
+
+---
+
+## 通知渠道
+
+| 渠道 | 配置方式 | 说明 |
+|------|---------|------|
+| 桌面系统通知 | 内置，无需配置 | macOS / Windows / Linux |
+| PWA 网页推送 | 内置，手机浏览器打开服务地址 | 需 HTTPS，支持 Service Worker 系统通知 |
+| 钉钉 | `AGENTWAKE_DINGTALK_WEBHOOK` | 群机器人 Webhook，支持签名校验 |
+| 飞书 | `AGENTWAKE_FEISHU_WEBHOOK` | 群机器人 Webhook，支持签名校验 |
+| 企业微信 | `AGENTWAKE_WECOM_WEBHOOK` | 群机器人 Webhook，安全性由 URL Key 保证 |
+
+### 钉钉配置
+
+在钉钉群 -> 群设置 -> 智能群助手 -> 添加机器人 -> 自定义 Webhook，复制 Webhook 地址。
+
+```env
+AGENTWAKE_DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx
+AGENTWAKE_DINGTALK_SECRET=SECxxx   # 可选，签名密钥
+```
+
+### 飞书配置
+
+在飞书群 -> 设置 -> 群机器人 -> 添加自定义机器人，复制 Webhook 地址。
+
+```env
+AGENTWAKE_FEISHU_WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+AGENTWAKE_FEISHU_SECRET=xxx   # 可选，签名校验密钥
+```
+
+### 企业微信配置
+
+在企业微信群 -> 群机器人 -> 添加群机器人，复制 Webhook 地址。
+
+```env
+AGENTWAKE_WECOM_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx
+```
+
+---
+
+## 编辑器接入
+
+### Claude Code
+
+运行 `agentwake setup` 会自动完成以下操作：
+- 生成 Hook 转发脚本到 `~/.agentwake/hooks/claude-hook-relay.sh`
+- 写入 Hook 配置到 `~/.claude/settings.json`
+
+支持的 Hook 事件：
+
+| 事件 | 说明 | 默认启用 |
+|------|------|---------|
+| Notification | 需要用户注意 | 是 |
+| Stop | 任务完成 | 是 |
+| StopFailure | 任务异常终止 | 是 |
+| SessionEnd | 会话结束 | 是 |
+| SessionStart | 会话开始 | 否 |
+| PreToolUse | 工具调用前 | 否 |
+| PostToolUse | 工具调用后 | 否 |
+
+### Cursor
+
+运行 `agentwake setup` 会自动完成：
+- 生成 Cursor Hook 转发脚本到 `~/.agentwake/hooks/cursor-hook.sh`
+- 写入 `beforeShellExecution` / `afterShellExecution` 到 `~/.cursor/hooks.json`
+
+然后保持 `agentwake start` 运行，即可接收 Cursor 授权等待与生命周期通知。
+
+### Qoder
+
+自动发现日志目录，或手动指定：
+
+```bash
+AGENTWAKE_QODER_LOG_PATH=”/path/to/agent.log” agentwake start
+```
+
+---
+
+## 自定义通知标题
+
+通过 `agentwake setup` 交互式设置，或直接在 `.env` 中配置：
+
+```env
+AGENTWAKE_CLAUDE_TITLE_STOP=AI搞定了
+AGENTWAKE_CLAUDE_TITLE_STOP_FAILURE=AI挂了
+AGENTWAKE_CLAUDE_TITLE_NOTIFICATION=AI喊你看一眼
+AGENTWAKE_CLAUDE_TITLE_SESSION_END=会话结束了
+```
+
+未配置的事件使用默认标题。
+
+---
+
+## 移动端 PWA 设置
+
+手机需要信任本地 HTTPS 证书才能接收 Service Worker 系统通知。
+
+1. 获取根证书路径：`mkcert -CAROOT`，找到 `rootCA.pem`
+2. 安装到手机：
+   - **iOS** — 发送到手机安装描述文件，然后在 设置 > 通用 > 关于本机 > 证书信任设置 中启用完全信任
+   - **Android** — 在安全设置中安装 CA 证书（可能需要改后缀为 `.crt`）
+3. 手机浏览器打开 `https://<局域网IP>:3199`，确认 HTTPS 连接安全后允许通知权限
+
+---
+
+## 全部环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `AGENTWAKE_HOST` | `0.0.0.0` | 监听地址 |
+| `AGENTWAKE_PORT` | `3199` | 监听端口 |
+| `AGENTWAKE_HTTPS_ENABLED` | `0` | 是否启用 HTTPS（启用 PWA 时自动设为 `1`） |
+| `AGENTWAKE_HTTPS_CERT_PATH` | `certs/dev-cert.pem` | HTTPS 证书路径 |
+| `AGENTWAKE_HTTPS_KEY_PATH` | `certs/dev-key.pem` | HTTPS 私钥路径 |
+| `AGENTWAKE_DESKTOP_ENABLED` | `1` | 是否启用桌面系统通知（`0` 关闭）；ARM 平台会自动改用系统原生命令，不依赖 `node-notifier` |
+| `AGENTWAKE_PWA_ENABLED` | `0` | 是否启用 PWA/WebSocket 推送（`0` 关闭） |
+| `AGENTWAKE_DINGTALK_ENABLED` | `1` | 是否启用钉钉通知（`0` 关闭） |
+| `AGENTWAKE_DINGTALK_WEBHOOK` | — | 钉钉 Webhook URL |
+| `AGENTWAKE_DINGTALK_SECRET` | — | 钉钉签名密钥 |
+| `AGENTWAKE_FEISHU_ENABLED` | `1` | 是否启用飞书通知（`0` 关闭） |
+| `AGENTWAKE_FEISHU_WEBHOOK` | — | 飞书 Webhook URL |
+| `AGENTWAKE_FEISHU_SECRET` | — | 飞书签名密钥 |
+| `AGENTWAKE_WECOM_ENABLED` | `1` | 是否启用企业微信通知（`0` 关闭） |
+| `AGENTWAKE_WECOM_WEBHOOK` | — | 企业微信 Webhook URL |
+| `AGENTWAKE_CLAUDE_TITLE_*` | — | Claude 事件自定义标题 |
+| `AGENTWAKE_DEDUPE_WINDOW_MS` | `10000` | 去重窗口（毫秒） |
+| `AGENTWAKE_RATE_LIMIT_WINDOW_MS` | `10000` | 限流窗口（毫秒） |
+| `AGENTWAKE_RATE_LIMIT_MAX_EVENTS` | `40` | 窗口内最大事件数 |
+| `AGENTWAKE_WS_PATH` | `/ws` | WebSocket 路径 |
+| `AGENTWAKE_QODER_LOG_PATH` | — | Qoder 日志路径（自动发现） |
+| `AGENTWAKE_ALLOWED_HOOK_IPS` | — | 限制 Hook 来源 IP（逗号分隔） |
+
+---
+
+## 开发
+
+```bash
+git clone https://github.com/tjdxwwj/agentwake.git
+cd agentwake
+npm install
+cp .env.example .env
+npm run setup    # 交互式配置（可选启用 PWA/HTTPS）
+npm run dev      # 启动开发服务器
+npm test         # 运行测试
+```
+
+### 目录结构
+
+```
+src/
+  adapters/       # 输入适配器（Cursor / Claude / Qoder）
+  gateway/        # 核心网关（Adapter 注册、事件路由）
+  notifiers/      # 通知分发（桌面 / WebSocket / 钉钉 / 飞书 / 企业微信）
+  installers/     # Hook 自动安装器
+web/              # PWA 前端
+```
+
+### 技术栈
+
+Node.js + TypeScript + Express + WebSocket (ws) + Zod
+
+---
+
+## FAQ
+
+**手机收不到通知？**
+1. 确认手机和电脑在同一局域网
+2. 确认浏览器显示安全的 HTTPS 连接（非”不安全”）
+3. 确认已授予通知权限
+4. 检查 Web 页面 WebSocket 状态是否为”已连接”
+
+**如何修改端口？**
+```bash
+AGENTWAKE_PORT=4000 agentwake start
+```
+
+**个人微信能收通知吗？**
+微信不支持 Webhook 消息推送 API。可以使用企业微信群机器人作为替代。
+
+---
+
+## 贡献者
+
+- [@tjdxwwj](https://github.com/tjdxwwj)
+- [@qiangguanglin](https://github.com/qiangguanglin)
+
+---
+
+MIT License

package/dist/adapters/claude-hook-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-hook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-hook-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,wBAAgB,uBAAuB,IAAI,cAAc,CAoBxD"}
+{"version":3,"file":"claude-hook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-hook-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA+CzD,wBAAgB,uBAAuB,IAAI,cAAc,CAsDxD"}