Skip to content
This repository was archived by the owner on Mar 5, 2026. It is now read-only.

v1.0.0 - First Stable Release

Choose a tag to compare

@FrankieeW FrankieeW released this 25 Jan 23:39
· 12 commits to main since this release

Task Notifier v1.0.0 - First Stable Release

🎉 Overview

Task Notifier 的第一个正式稳定版本!一个通用的任务完成邮件通知工具,支持 SMTP、完整的国际化支持(英文/中文),以及 OpenCode AI 编程助手集成。

The first stable release of Task Notifier! A general-purpose task completion email notification tool with SMTP support, full internationalization (English/Chinese), and OpenCode AI assistant integration.


✨ Core Features | 核心功能

📧 Email Notifications | 邮件通知

  • ✅ SMTP/SMTP_SSL support with auto-detection | SMTP/SMTP_SSL 支持,自动检测
  • ✅ Domain email support (separate login and sender) | 域名邮箱支持(分离登录和发送地址)
  • ✅ HTML + plain text dual format | HTML + 纯文本双格式
  • ✅ Detailed error messages with troubleshooting | 详细错误消息和故障排除
  • ✅ Connection timeout protection | 连接超时保护

🌍 Internationalization (i18n) | 国际化

  • ✅ Full English and Chinese support | 完整的英文和中文支持
  • ✅ 5-level language detection priority:
    1. --lang CLI flag | CLI 标志
    2. LANGUAGE= in config file | 配置文件
    3. TASK_NOTIFY_LANG environment variable | 环境变量
    4. System locale (auto-detects zh_CN, zh_TW, zh_HK) | 系统语言(自动检测中文)
    5. Default: English | 默认:英文
  • ✅ Separate documentation: README.md (EN) / README_zh.md (ZH)

🤖 OpenCode Integration | OpenCode 集成

  • ✅ Automatic notifications during AI coding sessions | AI 编程会话期间自动通知
  • ✅ Configurable triggers:
    • Session idle detection | 会话空闲检测
    • TODO completion tracking | TODO 完成追踪
    • Plan completion alerts | 计划完成提醒
    • Background task monitoring | 后台任务监控
    • Error notifications | 错误通知
  • ✅ Three detail levels: minimal, standard, detailed | 三种详细程度
  • ✅ JSONC config with comments | 支持注释的 JSONC 配置

🚀 Installation & Upgrade | 安装和升级

  • ✅ One-line installation script | 一键安装脚本
  • ✅ Version selection support: --version=vX.Y.Z | 版本选择支持
  • ✅ Automatic upgrade with config preservation | 自动升级并保留配置
  • ✅ OpenCode plugin auto-installation | OpenCode 插件自动安装
  • ✅ PATH configuration validation | PATH 配置验证

📦 Installation | 安装

Quick Install | 快速安装

# Install latest version | 安装最新版本
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install.sh | bash

# Install specific version | 安装指定版本
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install.sh | bash -s -- --version=v1.0.0

# Install with language preference | 安装并指定语言
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install.sh | bash -s -- --lang=zh

# Install OpenCode plugin only | 仅安装 OpenCode 插件
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install-opencode.sh | bash

Configuration | 配置

# Create config file | 创建配置文件
task-notify --setup

# Edit config | 编辑配置
vim ~/.task-notify.env

📝 Usage Examples | 使用示例

Basic Notification | 基本通知

task-notify "Build completed"
task-notify "构建完成" --lang=zh

With Details | 带详细信息

task-notify "Doc generation done" --details "Generated 42 pages"

Chain with Commands | 命令链

make build && task-notify "Build finished"
npm test && task-notify "Tests passed" || task-notify "Tests failed"

AI Task Helper | AI 任务助手

# Auto-collects Git info | 自动收集 Git 信息
notify-ai-task "Completed refactoring" --with-diff

🔄 Upgrade | 升级

# Upgrade to latest | 升级到最新版本
task-notify --upgrade

# Or via install script | 或使用安装脚本
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install.sh | bash -s -- --upgrade

# Upgrade to specific version | 升级到指定版本
curl -fsSL https://raw.githubusercontent.com/FrankieeW/task-notifier/main/scripts/install.sh | bash -s -- --upgrade --version=v1.0.0

📚 Documentation | 文档


🐛 Bug Fixes in This Release | 本版本修复的问题

  • ✅ Fixed .jsonc extension handling in OpenCode installer
  • ✅ Fixed hardcoded bilingual strings in upgrade prompts
  • ✅ Updated $schema URL to GitHub instead of local path

🎯 What's Next | 下一步计划

Future versions may include:

  • Web UI for configuration
  • More notification channels (Slack, Discord, etc.)
  • Task queue management
  • Notification history tracking

🙏 Support | 支持

If you find this project helpful, consider buying me a coffee! ☕

EVM (ETH/BSC/Polygon/Arbitrum/Base):

0x000000042c0e28cB7c59209e2FB745614814a4a4

📄 License | 许可证

MIT License


Full Changelog: https://github.com/FrankieeW/task-notifier/commits/v1.0.0