claude-hook-notify 1.2.2 → 1.3.1

package/README.md

@@ -89,7 +89,7 @@ npx claude-hook-notify setup --events Stop,TaskCompleted,Notification,PostToolUs
 | macOS   | `osascript`          | 无（系统自带）                                |
 | macOS   | `terminal-notifier`  | 可选: `brew install terminal-notifier`（更好） |
 | Linux   | `notify-send`        | `sudo apt-get install libnotify-bin`          |
-| Windows | PowerShell           | 无（系统自带）                                |
+| Windows | Toast 通知 (PowerShell) | 无（Windows 10+ 系统自带）                 |
 
 ## 原理
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-hook-notify",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "🔔 Claude Code 任务完成桌面通知 — 一键安装，跨平台支持",
   "main": "src/index.js",
   "bin": {
@@ -18,13 +18,22 @@
     "notify-send",
     "cli"
   ],
-  "author": "",
+  "author": "Mr-zj388",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Mr-zj388/claude-code-notify.git"
+  },
+  "homepage": "https://github.com/Mr-zj388/claude-code-notify#readme",
+  "bugs": {
+    "url": "https://github.com/Mr-zj388/claude-code-notify/issues"
+  },
   "engines": {
     "node": ">=16.0.0"
   },
   "files": [
     "src/",
+    "vendor/",
     "README.md"
   ]
 }

package/src/activate-watcher.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+/**
+ * 后台点击监听脚本
+ *
+ * 由主进程 spawn 为 detached 后台进程。
+ * 执行通知命令（带等待标志），检测用户点击后激活终端窗口。
+ *
+ * 参数格式:
+ *   node activate-watcher.js <JSON配置>
+ *
+ * JSON 配置:
+ *   {
+ *     "platform": "win32" | "linux",
+ *     "notifyCommand": "...",
+ *     "notifyArgs": ["..."],
+ *     "activateCommand": "...",
+ *     "activateArgs": ["..."],
+ *     "activateFallbackCommand": "...",   // 可选
+ *     "activateFallbackArgs": ["..."],    // 可选
+ *     "timeout": 120000
+ *   }
+ */
+
+const { spawn } = require("child_process");
+
+// 120 秒超时自动退出，防僵尸进程
+const config = parseConfig();
+const selfTimeout = setTimeout(() => process.exit(0), config.timeout || 120000);
+selfTimeout.unref();
+
+function parseConfig() {
+  try {
+    return JSON.parse(process.argv[2] || "{}");
+  } catch {
+    process.exit(1);
+  }
+}
+
+function activateTerminal() {
+  const { activateCommand, activateArgs, activateFallbackCommand, activateFallbackArgs } = config;
+  if (!activateCommand) return;
+
+  try {
+    execFileSync(activateCommand, activateArgs || [], { stdio: "ignore", timeout: 5000 });
+  } catch {
+    // 主命令失败，尝试回退
+    if (activateFallbackCommand) {
+      try {
+        execFileSync(activateFallbackCommand, activateFallbackArgs || [], { stdio: "ignore", timeout: 5000 });
+      } catch {
+        // 回退也失败，静默退出
+      }
+    }
+  }
+}
+
+async function main() {
+  const { platform, notifyCommand, notifyArgs } = config;
+  if (!notifyCommand) process.exit(1);
+
+  if (platform === "linux") {
+    // notify-send --action 模式：stdout 输出 action 名
+    const child = spawn(notifyCommand, notifyArgs, {
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 120000,
+    });
+
+    let output = "";
+    child.stdout.on("data", (chunk) => {
+      output += chunk.toString();
+    });
+
+    child.on("close", () => {
+      if (output.trim() === "default") {
+        activateTerminal();
+      }
+    });
+  }
+}
+
+main().catch(() => process.exit(1));

package/src/activate.js

@@ -0,0 +1,220 @@
+const { execSync, execFileSync } = require("child_process");
+const os = require("os");
+
+/**
+ * 终端进程名到 macOS bundleId 的映射
+ */
+const MAC_BUNDLE_MAP = {
+  "Terminal": "com.apple.Terminal",
+  "iTerm2": "com.googlecode.iterm2",
+  "iTerm2-v3": "com.googlecode.iterm2",
+  "Electron": null, // 需进一步判断
+  "Code": "com.microsoft.VSCode",
+  "Code - Insiders": "com.microsoft.VSCodeInsiders",
+  "Cursor": "com.todesktop.230313mzl4w4u92",
+  "WarpTerminal": "dev.warp.Warp-Stable",
+  "Alacritty": "org.alacritty",
+  "kitty": "net.kovidgoyal.kitty",
+  "Hyper": "co.zeit.hyper",
+  "Tabby": "org.tabby",
+};
+
+/**
+ * Windows 终端进程名（小写，不含 .exe）
+ */
+const WIN_TERMINAL_NAMES = new Set([
+  "windowsterminal",
+  "code",
+  "cursor",
+  "claude",
+  "cmd",
+  "powershell",
+  "pwsh",
+  "mintty",
+  "alacritty",
+  "wezterm-gui",
+  "hyper",
+  "tabby",
+  "conhost",
+]);
+
+/**
+ * Linux 终端进程名
+ */
+const LINUX_TERMINALS = new Set([
+  "gnome-terminal-server",
+  "gnome-terminal",
+  "konsole",
+  "xfce4-terminal",
+  "mate-terminal",
+  "tilix",
+  "terminator",
+  "alacritty",
+  "kitty",
+  "wezterm-gui",
+  "foot",
+  "code",
+  "cursor",
+  "hyper",
+  "tabby",
+]);
+
+/**
+ * 沿进程树向上查找终端进程
+ */
+function detectTerminal() {
+  const platform = os.platform();
+  try {
+    if (platform === "darwin") return detectMac();
+    if (platform === "win32") return detectWindows();
+    if (platform === "linux") return detectLinux();
+  } catch {
+    // 检测失败
+  }
+  return null;
+}
+
+function detectMac() {
+  let pid = process.ppid;
+  for (let i = 0; i < 20 && pid > 1; i++) {
+    try {
+      const info = execSync(`ps -o ppid=,comm= -p ${pid}`, { encoding: "utf-8" }).trim();
+      const match = info.match(/^\s*(\d+)\s+(.+)$/);
+      if (!match) break;
+      const ppid = parseInt(match[1], 10);
+      const comm = match[2].trim().split("/").pop();
+
+      if (MAC_BUNDLE_MAP[comm] !== undefined) {
+        const bundleId = MAC_BUNDLE_MAP[comm];
+        if (bundleId) {
+          return { name: comm, bundleId, pid, processName: comm };
+        }
+      }
+      pid = ppid;
+    } catch {
+      break;
+    }
+  }
+  // 回退：检查 TERM_PROGRAM 环境变量
+  const termProgram = process.env.TERM_PROGRAM;
+  if (termProgram) {
+    const map = {
+      "Apple_Terminal": { name: "Terminal", bundleId: "com.apple.Terminal" },
+      "iTerm.app": { name: "iTerm2", bundleId: "com.googlecode.iterm2" },
+      "vscode": { name: "Code", bundleId: "com.microsoft.VSCode" },
+      "WarpTerminal": { name: "Warp", bundleId: "dev.warp.Warp-Stable" },
+      "Hyper": { name: "Hyper", bundleId: "co.zeit.hyper" },
+    };
+    if (map[termProgram]) {
+      return { ...map[termProgram], pid: 0, processName: termProgram };
+    }
+  }
+  return null;
+}
+
+/**
+ * Windows: 优先环境变量，回退单次 PowerShell 批量查询
+ */
+function detectWindows() {
+  // 1. 环境变量快速检测（仅保留精确 PID 的路径）
+  if (process.env.VSCODE_PID) {
+    const pid = parseInt(process.env.VSCODE_PID, 10);
+    if (pid > 0) return { name: "Code", pid, processName: "code.exe" };
+  }
+
+  // 2. WMI 遍历进程树（OS 级 ParentProcessId 始终完整，不受 spawn 方式影响）
+  try {
+    const script = [
+      "$cpid=" + process.pid,
+      "for($i=0;$i -lt 30 -and $cpid -gt 0;$i++){",
+      "  $w=Get-CimInstance Win32_Process -Filter \"ProcessId=$cpid\" -EA SilentlyContinue",
+      "  if(-not $w){break}",
+      "  Write-Output \"$($w.Name)|$($w.ProcessId)|$($w.ParentProcessId)\"",
+      "  $cpid=$w.ParentProcessId",
+      "}",
+    ].join(";");
+    const output = execFileSync("powershell", ["-NoProfile", "-Command", script], {
+      encoding: "utf-8",
+      timeout: 8000,
+    }).trim();
+
+    // 遍历整棵进程树，取最高层级（最靠近根）的终端匹配
+    // 避免误取 powershell/cmd 等 shell 进程 —— 它们在 Windows Terminal 下不拥有窗口
+    let bestMatch = null;
+    for (const line of output.split("\n")) {
+      const parts = line.trim().split("|");
+      if (parts.length < 3) continue;
+      // WMI 返回的 Name 带 .exe 后缀，去掉再匹配
+      const name = parts[0].replace(/\.exe$/i, "").toLowerCase();
+      const pid = parseInt(parts[1], 10);
+      if (WIN_TERMINAL_NAMES.has(name)) {
+        bestMatch = { name: parts[0].replace(/\.exe$/i, ""), pid, processName: parts[0] };
+      }
+    }
+    return bestMatch;
+  } catch {
+    // PowerShell 调用失败
+  }
+  return null;
+}
+
+function detectLinux() {
+  // 1. 环境变量快速检测
+  if (process.env.VSCODE_PID) {
+    const pid = parseInt(process.env.VSCODE_PID, 10);
+    if (pid > 0) return { name: "code", pid, processName: "code" };
+  }
+
+  // 2. 进程树遍历
+  let pid = process.ppid;
+  for (let i = 0; i < 20 && pid > 1; i++) {
+    try {
+      const info = execSync(`ps -o ppid=,comm= -p ${pid}`, { encoding: "utf-8" }).trim();
+      const match = info.match(/^\s*(\d+)\s+(.+)$/);
+      if (!match) break;
+      const ppid = parseInt(match[1], 10);
+      const comm = match[2].trim();
+
+      if (LINUX_TERMINALS.has(comm)) {
+        return { name: comm, pid, processName: comm };
+      }
+      pid = ppid;
+    } catch {
+      break;
+    }
+  }
+  return null;
+}
+
+/**
+ * 获取激活终端窗口的命令和参数
+ */
+function getActivateCommand(terminalInfo) {
+  if (!terminalInfo) return null;
+  const platform = os.platform();
+
+  if (platform === "darwin") {
+    if (terminalInfo.bundleId) {
+      return {
+        command: "osascript",
+        args: ["-e", `tell application id "${terminalInfo.bundleId}" to activate`],
+      };
+    }
+    return null;
+  }
+
+  // Windows 使用 notify-helper.exe 自行处理激活，不需要此函数
+
+  if (platform === "linux") {
+    return {
+      command: "xdotool",
+      args: ["search", "--pid", String(terminalInfo.pid), "--onlyvisible", "windowactivate"],
+      fallbackCommand: "wmctrl",
+      fallbackArgs: ["-ia", String(terminalInfo.pid)],
+    };
+  }
+
+  return null;
+}
+
+module.exports = { detectTerminal, getActivateCommand };

package/src/notify.js

@@ -235,15 +235,11 @@ async function sendNotification(options = {}) {
       return result;
     }
   } else if (platform === "win32") {
-    // VBScript Popup: 零依赖，启动极快（<0.5 秒）
-    method = "vbscript-popup";
-    command = "wscript";
-    const escapedTitle = title.replace(/"/g, '""');
-    const escapedMessage = message.replace(/"/g, '""');
-    const vbsScript = `CreateObject("WScript.Shell").Popup "${escapedMessage}", 5, "${escapedTitle}", 64`;
-    tmpFile = path.join(os.tmpdir(), `claude-notify-${process.pid}.vbs`);
-    fs.writeFileSync(tmpFile, vbsScript, "utf-8");
-    args = ["//nologo", tmpFile];
+    // SnoreToast: 原生 Windows Toast 通知，UTF-16 支持，不抢焦点
+    method = "snoretoast";
+    const arch = os.arch() === "x64" ? "x64" : "x86";
+    command = path.join(__dirname, "..", "vendor", "snoretoast", `snoretoast-${arch}.exe`);
+    args = ["-t", title, "-m", message, "-appID", "Claude.Code"];
   }
 
   const result = { sent: !dryRun, method, command, args };

package/vendor/notify-helper/NotifyHelper.cs

@@ -0,0 +1,222 @@
+using System;
+using System.Diagnostics;
+using System.Drawing;
+using System.IO;
+using System.Runtime.InteropServices;
+using System.Windows.Forms;
+
+[assembly: System.Reflection.AssemblyTitle("Claude Code 完成通知")]
+[assembly: System.Reflection.AssemblyProduct("Claude Code Notify")]
+
+class NotifyHelper
+{
+    [DllImport("user32.dll")]
+    static extern bool SetForegroundWindow(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+
+    delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
+
+    [DllImport("user32.dll")]
+    static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
+
+    [DllImport("user32.dll")]
+    static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
+
+    [DllImport("user32.dll")]
+    static extern bool IsWindowVisible(IntPtr hWnd);
+
+    [DllImport("user32.dll", SetLastError = true)]
+    static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
+
+    [DllImport("user32.dll")]
+    static extern bool AttachThreadInput(uint idAttach, uint idAttachTo, bool fAttach);
+
+    [DllImport("user32.dll")]
+    static extern IntPtr GetForegroundWindow();
+
+    [DllImport("kernel32.dll")]
+    static extern uint GetCurrentThreadId();
+
+    // 已知 GUI 终端的窗口类名（用于 PID 查找失败时的回退）
+    static string[] KnownWindowClasses = new string[] {
+        "CASCADIA_HOSTING_WINDOW_CLASS",  // Windows Terminal
+        "mintty",                          // Git Bash / mintty
+    };
+
+    // Claude sparkle 图标 PNG（内嵌，无需外部文件）
+    static string IconBase64 = "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";
+
+    static IntPtr targetHandle = IntPtr.Zero;
+    static NotifyIcon notify;
+
+    static void Main(string[] args)
+    {
+        string title = args.Length > 0 ? args[0] : "Claude Code";
+        string message = args.Length > 1 ? args[1] : "任务完成";
+        string targetName = args.Length > 2 ? args[2] : "";
+        int targetPid = 0;
+        if (args.Length > 3) int.TryParse(args[3], out targetPid);
+
+        // 策略 1：通过 PID 精确定位终端窗口（多实例场景）
+        if (targetPid > 0)
+        {
+            try
+            {
+                using (var proc = Process.GetProcessById(targetPid))
+                {
+                    if (proc.MainWindowHandle != IntPtr.Zero)
+                    {
+                        targetHandle = proc.MainWindowHandle;
+                    }
+                    else
+                    {
+                        // MainWindowHandle 可能为零（如 Windows Terminal），用 EnumWindows 查找
+                        targetHandle = FindWindowByPid(targetPid);
+                    }
+                }
+            }
+            catch { /* 进程可能已退出，回退到名称查找 */ }
+        }
+
+        // 策略 2：通过进程名查找（回退方案）
+        if (targetHandle == IntPtr.Zero && !string.IsNullOrEmpty(targetName))
+        {
+            foreach (var name in targetName.Split(','))
+            {
+                try
+                {
+                    var procs = Process.GetProcessesByName(name.Trim());
+                    try
+                    {
+                        foreach (var p in procs)
+                        {
+                            if (p.MainWindowHandle != IntPtr.Zero)
+                            {
+                                targetHandle = p.MainWindowHandle;
+                                break;
+                            }
+                            // MainWindowHandle 为零时尝试 EnumWindows 查找
+                            IntPtr hwnd = FindWindowByPid(p.Id);
+                            if (hwnd != IntPtr.Zero)
+                            {
+                                targetHandle = hwnd;
+                                break;
+                            }
+                        }
+                    }
+                    finally
+                    {
+                        foreach (var p in procs) p.Dispose();
+                    }
+                    if (targetHandle != IntPtr.Zero) break;
+                }
+                catch { }
+            }
+        }
+
+        // 策略 3：通过已知窗口类名查找（兜底方案）
+        if (targetHandle == IntPtr.Zero)
+        {
+            foreach (var cls in KnownWindowClasses)
+            {
+                IntPtr hwnd = FindWindow(cls, null);
+                if (hwnd != IntPtr.Zero)
+                {
+                    targetHandle = hwnd;
+                    break;
+                }
+            }
+        }
+
+        notify = new NotifyIcon();
+        notify.Icon = LoadEmbeddedIcon();
+        notify.Visible = true;
+        notify.BalloonTipTitle = title;
+        notify.BalloonTipText = message;
+        notify.BalloonTipIcon = ToolTipIcon.None;
+
+        notify.BalloonTipClicked += delegate { ActivateAndExit(); };
+        notify.Click += delegate { ActivateAndExit(); };
+        notify.BalloonTipClosed += delegate { Cleanup(); };
+
+        notify.ShowBalloonTip(15000);
+
+        var timer = new Timer();
+        timer.Interval = 60000;
+        timer.Tick += delegate { Cleanup(); };
+        timer.Start();
+
+        Application.Run();
+    }
+
+    static IntPtr FindWindowByPid(int pid)
+    {
+        IntPtr found = IntPtr.Zero;
+        EnumWindows((hWnd, lParam) =>
+        {
+            uint procId;
+            GetWindowThreadProcessId(hWnd, out procId);
+            if ((int)procId == pid && IsWindowVisible(hWnd))
+            {
+                found = hWnd;
+                return false;
+            }
+            return true;
+        }, IntPtr.Zero);
+        return found;
+    }
+
+    static Icon LoadEmbeddedIcon()
+    {
+        try
+        {
+            var bytes = Convert.FromBase64String(IconBase64);
+            using (var ms = new MemoryStream(bytes))
+            {
+                var bmp = new Bitmap(ms);
+                var resized = new Bitmap(bmp, 32, 32);
+                return Icon.FromHandle(resized.GetHicon());
+            }
+        }
+        catch
+        {
+            return SystemIcons.Information;
+        }
+    }
+
+    static void ActivateAndExit()
+    {
+        if (targetHandle != IntPtr.Zero)
+        {
+            ShowWindow(targetHandle, 9); // SW_RESTORE
+            // 使用 AttachThreadInput 确保 SetForegroundWindow 成功
+            // （Windows 限制后台进程直接抢占前台焦点）
+            uint unusedPid;
+            uint targetThread = GetWindowThreadProcessId(targetHandle, out unusedPid);
+            uint curThread = GetCurrentThreadId();
+            if (curThread != targetThread)
+            {
+                AttachThreadInput(curThread, targetThread, true);
+                SetForegroundWindow(targetHandle);
+                AttachThreadInput(curThread, targetThread, false);
+            }
+            else
+            {
+                SetForegroundWindow(targetHandle);
+            }
+        }
+        Cleanup();
+    }
+
+    static void Cleanup()
+    {
+        if (notify != null)
+        {
+            notify.Visible = false;
+            notify.Dispose();
+        }
+        Application.ExitThread();
+    }
+}

package/vendor/snoretoast/LICENSE

@@ -0,0 +1,166 @@
+// Retrieved from https://github.com/KDE/snoretoast/blob/master/COPYING.LGPL-3 version 0.7.0
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.