【工具】AI Common Notify：统一 AI 编程工具通知服务
内容提要
AI Common Notify 是一个开源工具，为Claude Code、Cursor等主流AI编程工具提供统一通知服务。它支持Hook、MCP和API模式，跨平台兼容，可自定义通知内容，并通过脚本回调集成微信等渠道。用户可通过npm安装，使用quickInit快速配置，解决多任务并行时通知缺失问题。
延伸解读
为什么需要统一通知工具
当前AI编程工具在任务完成后不会主动通知用户，导致多任务并行时容易错过重要信息。市面上的通知工具往往只支持单一工具，造成配置碎片化、体验不一致和维护成本高。AI Common Notify 通过统一接口解决了这些问题，让开发者只需配置一次即可覆盖多种工具。
三种触发模式的选择
AI Common Notify 提供 Hook、MCP 和 API 三种模式。Hook 模式适用于 Claude Code，MCP 模式适用于 Cursor、Windsurf 等，API 模式则适合在线平台或自定义集成。用户可根据使用的工具选择相应模式，并通过 quickInit 自动检测项目中的工具生成配置，简化部署。
脚本回调的扩展潜力
脚本回调功能允许在通知发送时执行自定义脚本，从而集成微信、钉钉等第三方通知渠道。脚本可接收通知标题、消息、紧急程度等环境变量，方便用户构建个性化通知流程。例如，可编写 Node.js 脚本将通知转发到企业微信，实现移动端实时提醒。
配置层级与注意事项
配置支持全局和项目两个层级，项目配置优先级更高，便于团队协作。使用时需注意：部分系统可能不支持 timeout 和 icon 参数；MCP 模式下建议在提示中明确要求发送通知，以确保 AI 工具调用通知功能。此外，API 模式需设置 token 保证安全。
Q&A
AI Common Notify 是什么？它主要解决什么问题？
AI Common Notify 是一个开源工具，为 Claude Code、Cursor、Windsurf、Trae 等主流 AI 编程工具提供统一的通知服务。它解决了这些工具在任务完成后不主动通知用户的问题，避免开发者需要手动检查任务状态，尤其是在多任务并行时容易错过重要信息。
AI Common Notify 支持哪些通知触发模式？分别适用于哪些工具？
AI Common Notify 支持三种模式：Hook 模式（适用于 Claude Code）、MCP 模式（适用于 Cursor、Windsurf、Trae、CodeBuddy、Gemini-cli 等）、API 模式（适用于自定义集成或在线平台工具）。
如何安装 AI Common Notify？
安装前需确保本地已安装 Node.js（推荐 v18 及以上），然后通过 npm 全局安装：npm install -g ai-common-notify。安装后可用 ai-common-notify --version 查看版本，或用 ai-common-notify test 发送测试通知验证。
AI Common Notify 支持哪些自定义通知选项？
支持自定义标题（title）、消息内容（message）、紧急程度（urgency，可选 low/normal/critical）、超时时间（timeout，0 表示永久显示）、是否播放声音（sound）以及自定义图标路径（icon）。此外，还可通过 JSON 配置文件设置默认值、标题模板和消息模板。
如何通过脚本回调集成微信通知？
在 AI Common Notify 的配置文件中设置 scripts.notify 数组，添加类型为 node 或 shell 的脚本路径。脚本可接收环境变量（如 NOTIFY_TITLE、NOTIFY_MESSAGE 等）。示例中提供了一个 Node.js 脚本，使用企业微信机器人 Webhook 发送通知，只需将 webhookUrl 替换为自己的 key 即可。
AI Common Notify 的快速初始化功能（quickInit）支持哪些工具？如何使用？
quickInit 支持 Cursor（通过 MCP）、Claude Code（通过 Hook）、Windsurf（通过 MCP 和规则文件）、Gemini-cli（通过 MCP）。在项目目录下运行 ai-common-notify quickInit 可自动检测并生成配置，也可用 --tool 参数指定工具，如 ai-common-notify quickInit --tool cursor。
AI Common Notify 的配置层级是怎样的？
配置分为全局配置和项目配置，优先级从低到高为：全局配置（~/.config/ai-common-notify/config.json 或 %APPDATA%\ai-common-notify\config.json）和项目配置（<project-root>/.ai-notify.json）。项目配置会覆盖全局配置。
AI Common Notify 有哪些实际使用场景？
常见场景包括：多任务并行处理（同时运行多个 AI 任务时接收完成通知）、长时间运行任务监控（如模型训练完成通知）、错误警报系统（在 CI/CD 中集成关键错误通知）、自动化工作流（在部署脚本中发送完成通知）。
