claude-hook-notify 1.0.0 → 1.2.0

package/README.md

@@ -73,14 +73,13 @@ npx claude-hook-notify notify --title "构建完成" --message "所有测试通
 | `Stop`            | Claude Code 完成一次响应         | Glass        |
 | `TaskCompleted`   | 子任务被标记为完成               | Hero         |
 | `Notification`    | Claude Code 需要你注意（等输入） | Ping         |
-| `StopFailure`     | API 错误导致中断（限流/认证/服务器错误等） | Sosumi       |
 
 > **注意**: `Stop` 事件在响应因 token 限制被截断时会显示特殊提示。
 
-也可以添加额外事件：
+也可以添加额外事件（注意：`StopFailure` 不是 Claude Code 官方支持的 hook 事件，使用会导致配置报错）：
 
 ```bash
-npx claude-hook-notify setup --events Stop,TaskCompleted,Notification,StopFailure,PostToolUseFailure,SubagentStop
+npx claude-hook-notify setup --events Stop,TaskCompleted,Notification,PostToolUseFailure,SubagentStop
 ```
 
 ## 平台支持
@@ -113,7 +112,8 @@ await sendNotification({
 ## 已知限制
 
 - **Ctrl+C 用户中断**: 用户手动按 Ctrl+C 取消时不会触发任何 hook 事件，因此无法发送通知。
-- **网络完全断开**: 如果网络完全断开导致 Claude Code 进程本身退出，hook 可能无法执行。API 层面的网络错误（如超时）会通过 `StopFailure` 的 `server_error` 类型捕获。
+- **网络完全断开**: 如果网络完全断开导致 Claude Code 进程本身退出，hook 可能无法执行。
+- **StopFailure 事件**: `StopFailure` 不是 Claude Code 官方支持的 hook 事件名，默认不再注册。如通过 `--events` 手动指定，会导致 settings.json 校验报错，整个配置文件被跳过。
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-hook-notify",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "🔔 Claude Code 任务完成桌面通知 — 一键安装，跨平台支持",
   "main": "src/index.js",
   "bin": {

package/src/cli.js

@@ -17,7 +17,7 @@ const HELP = `
     --global                 安装到全局配置 ~/.claude/settings.json（默认）
     --local                  安装到当前项目 .claude/settings.json
     --events <事件列表>      要监听的事件，逗号分隔
-                             默认: Stop,TaskCompleted,Notification,StopFailure
+                             默认: Stop,TaskCompleted,Notification
 
   notify 选项:
     --event <事件名>         事件类型 (Stop/TaskCompleted/Notification/...)
@@ -69,7 +69,7 @@ async function main() {
     const scope = args.local ? "local" : "global";
     const events = args.events
       ? args.events.split(",").map((e) => e.trim())
-      : ["Stop", "TaskCompleted", "Notification", "StopFailure"];
+      : ["Stop", "TaskCompleted", "Notification"];
     await setup({ scope, events });
     return;
   }

package/src/notify.js

@@ -234,20 +234,38 @@ async function sendNotification(options = {}) {
       return result;
     }
   } else if (platform === "win32") {
-    method = "powershell";
+    method = "powershell-toast";
     command = "powershell.exe";
-    const psScript = `
-      [void][System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms');
-      $n = New-Object System.Windows.Forms.NotifyIcon;
-      $n.Icon = [System.Drawing.SystemIcons]::Information;
-      $n.BalloonTipTitle = '${title.replace(/'/g, "''")}';
-      $n.BalloonTipText = '${message.replace(/'/g, "''")}';
-      $n.Visible = $true;
-      $n.ShowBalloonTip(5000);
-      Start-Sleep -Seconds 6;
-      $n.Dispose();
-    `.replace(/\n/g, " ");
-    args = ["-NoProfile", "-Command", psScript];
+    const t = title.replace(/'/g, "''");
+    const m = message.replace(/'/g, "''");
+    const appId =
+      "{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe";
+    const psScript = [
+      "$t='" + t + "'",
+      "$m='" + m + "'",
+      "try{",
+      "  [void][Windows.UI.Notifications.ToastNotificationManager,Windows.UI.Notifications,ContentType=WindowsRuntime]",
+      "  [void][Windows.Data.Xml.Dom.XmlDocument,Windows.Data.Xml.Dom,ContentType=WindowsRuntime]",
+      "  $x=New-Object Windows.Data.Xml.Dom.XmlDocument",
+      "  $te=[System.Security.SecurityElement]::Escape($t)",
+      "  $me=[System.Security.SecurityElement]::Escape($m)",
+      '  $x.LoadXml("<toast><visual><binding template=\'ToastGeneric\'><text>$te</text><text>$me</text></binding></visual></toast>")',
+      "  $toast=[Windows.UI.Notifications.ToastNotification]::new($x)",
+      "  [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('" + appId + "').Show($toast)",
+      "}catch{",
+      "  [void][System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms')",
+      "  $n=New-Object System.Windows.Forms.NotifyIcon",
+      "  $n.Icon=[System.Drawing.SystemIcons]::Information",
+      "  $n.BalloonTipTitle=$t",
+      "  $n.BalloonTipText=$m",
+      "  $n.Visible=$true",
+      "  $n.ShowBalloonTip(5000)",
+      "  Start-Sleep -Seconds 6",
+      "  $n.Dispose()",
+      "}",
+    ].join("\n");
+    const encoded = Buffer.from(psScript, "utf16le").toString("base64");
+    args = ["-NoProfile", "-EncodedCommand", encoded];
   }
 
   const result = { sent: !dryRun, method, command, args };
@@ -260,8 +278,19 @@ async function sendNotification(options = {}) {
 
   try {
     if (command) {
-      const { execFileSync } = require("child_process");
-      execFileSync(command, args, { stdio: "ignore", timeout: 5000 });
+      if (platform === "win32") {
+        // Windows: spawn detached so hook exits immediately, notification lives independently
+        const { spawn } = require("child_process");
+        const child = spawn(command, args, {
+          detached: true,
+          stdio: "ignore",
+          windowsHide: true,
+        });
+        child.unref();
+      } else {
+        const { execFileSync } = require("child_process");
+        execFileSync(command, args, { stdio: "ignore", timeout: 5000 });
+      }
     }
   } catch (err) {
     result.sent = false;

package/src/setup.js

@@ -111,7 +111,7 @@ function checkDependencies() {
 /**
  * 安装 hooks 配置
  */
-async function setup({ scope = "global", events = ["Stop", "TaskCompleted", "Notification", "StopFailure"] }) {
+async function setup({ scope = "global", events = ["Stop", "TaskCompleted", "Notification"] }) {
   const settingsPath = getSettingsPath(scope);
   const scopeLabel = scope === "global" ? "全局" : "项目";
 
@@ -196,6 +196,44 @@ async function setup({ scope = "global", events = ["Stop", "TaskCompleted", "Not
   console.log();
 }
 
+/**
+ * 清理 npx 缓存中的 claude-hook-notify
+ */
+function cleanNpxCache() {
+  let cacheDir;
+  try {
+    cacheDir = require("child_process")
+      .execSync("npm config get cache", { encoding: "utf-8" })
+      .trim();
+  } catch {
+    return 0;
+  }
+
+  const npxDir = path.join(cacheDir, "_npx");
+  if (!fs.existsSync(npxDir)) return 0;
+
+  let cleaned = 0;
+  try {
+    const entries = fs.readdirSync(npxDir);
+    for (const entry of entries) {
+      const pkgPath = path.join(npxDir, entry, "package.json");
+      try {
+        if (!fs.existsSync(pkgPath)) continue;
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        if (pkg.dependencies && pkg.dependencies[PKG_NAME]) {
+          fs.rmSync(path.join(npxDir, entry), { recursive: true, force: true });
+          cleaned++;
+        }
+      } catch {
+        // 跳过无法读取的目录
+      }
+    }
+  } catch {
+    // 无法读取 npx 缓存目录
+  }
+  return cleaned;
+}
+
 /**
  * 卸载 hooks 配置
  */
@@ -207,41 +245,34 @@ async function uninstall({ scope = "global" }) {
   console.log(`  ${c.bold("🔔 Claude Code Notify — 卸载")}`);
   console.log();
 
-  if (!fs.existsSync(settingsPath)) {
-    console.log(`  ${c.yellow("⚠")}  未找到配置文件: ${settingsPath}`);
-    console.log();
-    return;
-  }
-
-  const settings = readJSON(settingsPath);
-  if (!settings.hooks) {
-    console.log(`  ${c.yellow("⚠")}  配置中没有 hooks`);
-    console.log();
-    return;
-  }
-
+  // 清理 hooks 配置
   let removed = 0;
 
-  for (const [event, hookConfigs] of Object.entries(settings.hooks)) {
-    const before = hookConfigs.length;
-    settings.hooks[event] = hookConfigs.filter(
-      (h) => !h.hooks?.some((hh) => hh.command?.includes(PKG_NAME))
-    );
-    removed += before - settings.hooks[event].length;
-
-    // 清理空数组
-    if (settings.hooks[event].length === 0) {
-      delete settings.hooks[event];
+  if (fs.existsSync(settingsPath)) {
+    const settings = readJSON(settingsPath);
+    if (settings.hooks) {
+      for (const [event, hookConfigs] of Object.entries(settings.hooks)) {
+        const before = hookConfigs.length;
+        settings.hooks[event] = hookConfigs.filter(
+          (h) => !h.hooks?.some((hh) => hh.command?.includes(PKG_NAME))
+        );
+        removed += before - settings.hooks[event].length;
+
+        // 清理空数组
+        if (settings.hooks[event].length === 0) {
+          delete settings.hooks[event];
+        }
+      }
+
+      // 清理空 hooks 对象
+      if (Object.keys(settings.hooks).length === 0) {
+        delete settings.hooks;
+      }
+
+      writeJSON(settingsPath, settings);
     }
   }
 
-  // 清理空 hooks 对象
-  if (Object.keys(settings.hooks).length === 0) {
-    delete settings.hooks;
-  }
-
-  writeJSON(settingsPath, settings);
-
   if (removed > 0) {
     console.log(
       `  ${c.green("✓")}  已从${scopeLabel}配置中移除 ${removed} 个通知 hook`
@@ -254,6 +285,15 @@ async function uninstall({ scope = "global" }) {
   console.log(
     `  ${c.dim("配置文件: " + settingsPath)}`
   );
+
+  // 清理 npx 缓存
+  const cleaned = cleanNpxCache();
+  if (cleaned > 0) {
+    console.log(
+      `  ${c.green("✓")}  已清理 ${cleaned} 个 npx 缓存目录`
+    );
+  }
+
   console.log();
 }