这是一个智能提醒系统，用于在Claude Code完成任务时通过多种方式提醒你，支持手机通知和手环震动，让你可以专心玩手机而不用频繁检查任务状态。

• ✅ 飞书通知推送：任务完成时自动发送飞书消息到手机
• ✅ Telegram通知推送：支持通过Telegram Bot发送通知消息
• ✅ HTTP代理支持：Telegram通知支持HTTP/HTTPS代理配置
• ✅ 手环震动提醒：小米手环等智能穿戴设备会震动提醒
• ✅ 语音声音提醒：电脑播放"任务完成，已发送手机通知"
• ✅ 双重提醒保障：声音 + 手机推送，确保不会错过
• ✅ 智能项目识别：自动识别项目名称（package.json > git仓库名 > 目录名）
• ✅ 精简消息格式：项目名: 任务信息，适配手环显示
• ✅ Windows系统优化：完美支持Windows 10/11
• ✅ 配置灵活：可自由开关各种提醒方式
• ✅ 安全可靠：使用官方API，安全稳定

ccdd/
├── notify-system.js           # 主通知系统（集成所有功能）
├── notification-manager.js    # 通知管理器（统一接口管理）
├── env-config.js             # 环境变量配置管理（统一环境变量）
├── feishu-notify.js          # 飞书通知模块
├── telegram-notify.js        # Telegram通知模块（支持代理）
├── setup-wizard.js           # 一键配置向导
├── .env                     # 环境变量配置（包含敏感信息，已git忽略）
├── .env.example            # 环境变量模板文件
├── .gitignore              # Git忽略文件配置
├── config.json             # 传统配置文件（可选）
├── package.json            # NPM项目配置
├── test-project/           # 测试项目
│   └── package.json
├── README.md               # 项目说明文档
├── SETUP.md                # 详细配置指南
└── task-completion-log.jsonl # 任务日志

node setup-wizard.js

向导会自动帮你配置所有设置，包括安全存储webhook地址。

1. 复制 .env.example 为 .env
2. 在飞书中创建群组，添加自定义机器人，复制webhook地址
3. 编辑 .env 文件，替换 FEISHU_WEBHOOK_URL 为你的实际地址

详细步骤请查看 SETUP.md

# 测试完整通知系统
node notify-system.js --task "测试手环震动提醒"

重启Claude Code使配置生效，然后正常使用即可！

.env 文件支持以下配置：

# 飞书Webhook地址
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/你的地址

# Telegram Bot配置
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here

# HTTP代理配置（可选，用于Telegram）
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

# 通知开关
NOTIFICATION_ENABLED=true    # 是否启用飞书通知
SOUND_ENABLED=true          # 是否启用声音提醒

1. 与 @BotFather 对话，发送 /newbot 创建机器人
2. 获取 Bot Token
3. 与你的机器人发送一条消息
4. 访问 https://api.telegram.org/bot<TOKEN>/getUpdates 获取 Chat ID
5. 在 .env 文件中配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID
6. 在 config.json 中将 notification.telegram.enabled 设为 true

config.json 仍然支持传统配置方式，环境变量会覆盖配置文件设置。

{
  "notification": {
    "feishu": {
      "enabled": false
    },
    "telegram": {
      "enabled": true
    },
    "sound": {
      "enabled": false
    }
  }
}

在 ~/.claude/settings.json 中配置hook，任务完成时自动发送通知：

推荐配置（使用统一通知系统）：

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "node /projects/ccdd/notify-system.js --message 'Claude Code任务已完成'"
      }]
    }]
  }
}

高级配置（自定义消息）：

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "node /projects/ccdd/notify-system.js --message '代码优化完成'"
      }]
    }]
  }
}

该配置会：

• ✅ 自动识别项目名称并显示在通知标题
• 📱 发送飞书通知（如果配置了）
• 📲 发送Telegram通知（如果配置了）
• 🔊 播放声音提醒
• ⌚ 触发手环震动

配置完成后，当Claude Code完成任务时：

1. 📱 手机通知：飞书APP会收到任务完成消息
2. ⌚ 手环震动：小米手环等智能设备会震动提醒
3. 🔊 语音提醒：电脑播放"任务完成，已发送手机通知"

这样你就可以专心玩手机，当任务完成时通过手环震动就能知道！

node notify-system.js --task "测试任务"

node feishu-notify.js --webhook "你的webhook地址" --message "测试消息"

node telegram-notify.js --message "测试消息"

node notify-sound.js

cd test-project
npm run test

• 分层架构：env-config → notification-manager → notify-system
• 模块化设计：分离各种通知方式，独立开发和测试
• 统一接口：通过NotificationManager统一管理所有通知
• 异步处理：并行发送多种通知，提高响应速度
• 容错机制：单一通知失败不影响其他通知方式
• 环境变量优先：支持.env安全配置，保护敏感信息

• 🔒 环境变量保护：敏感信息存储在.env文件中，已加入.gitignore
• 🔐 配置隔离：敏感配置与代码分离，防止意外泄露
• 🛡️ 模板化配置：提供.env.example模板，便于团队协作
• 🌐 代理支持：Telegram通知支持HTTP/HTTPS代理，适应网络环境

• notify-system.js：主通知系统，协调所有提醒方式
• notification-manager.js：通知管理器，统一管理各种通知接口
• env-config.js：环境变量配置管理，统一处理环境变量加载
• feishu-notify.js：飞书API调用模块，支持富文本消息
• telegram-notify.js：Telegram Bot API调用模块，支持HTTP/HTTPS代理
• config.json：传统的配置文件管理（可选）

• 🧠 项目名称识别：自动识别当前项目名称（package.json > git仓库名 > 目录名）
• 📱 手环适配：消息格式优化，项目名优先显示，适配小屏幕设备
• 🔄 跨项目支持：无论从哪个目录启动Claude都能正确识别项目

• 使用Claude Code的Stop hook，在任务完成时自动触发
• 不影响正常的任务执行流程
• 支持命令行参数自定义任务信息

• 支持更多通知平台（微信、钉钉、企业微信）
• 添加任务执行时间统计
• 支持自定义通知模板
• 开发可视化配置界面

• 开发Claude Code官方插件
• 支持跨平台（macOS、Linux）
• 添加任务进度实时推送
• 支持群组协作通知

• 智能任务调度和优先级管理
• 集成更多智能穿戴设备
• 开发移动端APP
• 支持多AI平台集成

1. 专注度提升：开发者可以专心做其他事情，不用频繁检查任务状态
2. 效率优化：及时获知任务完成，提高工作流程效率
3. 体验改善：通过手环震动等私密提醒，不打扰他人

1. 多通道通知：声音 + 手机推送 + 手环震动的立体提醒体系
2. 智能集成：与Claude Code深度集成，自动触发通知
3. 模块化架构：高度可扩展，支持多种通知方式
4. 用户友好：配置简单，一键启用

• B2C市场：面向个人开发者的小工具产品
• B2B市场：面向开发团队的协作效率工具
• 生态价值：丰富AI编程工具生态，提升用户体验

graph TD
    A[用户向Claude Code下达任务] --> B[Claude Code执行任务]
    B --> C[用户专心玩手机/做其他事]
    B --> D[任务执行完成]
    D --> E[触发Stop Hook]
    E --> F[调用notify-system.js]
    F --> G[并行发送通知]
    G --> H[📱 飞书消息推送到手机]
    G --> I[🔊 电脑播放语音提醒]
    H --> J[⌚ 手环震动提醒]
    I --> K[用户听到语音提醒]
    J --> L[用户感到手环震动]
    K --> M[查看任务结果]
    L --> M

现在你只需要配置好飞书webhook，就能享受这个强大的提醒系统了！详细配置请查看 SETUP.md。

让AI编程更专注，让开发更高效！ 🚀