claude-code-remote-remake/docs/QUICK_EMAIL_SETUP.md

TaskPing 邮件功能快速配置指南

🚀 三种配置方式

TaskPing 现在提供三种方式来配置邮件功能，您可以选择最适合的方式：

方式 1: 快速配置向导 (推荐 ⭐)

node taskping.js setup-email

优点:

• 🎯 一步到位，引导式配置
• 🛡️ 内置常见邮箱提供商设置
• 🧪 配置完成后可立即测试

适用于: 初次配置，想要快速开始使用的用户

---

方式 2: 直接编辑配置文件

node taskping.js edit-config channels

优点:

• ⚡ 最快速，适合有经验的用户
• 🔧 完全控制所有配置选项
• 📝 支持批量修改和复制粘贴

适用于: 熟悉JSON格式，需要精确控制配置的用户

---

方式 3: 交互式配置管理器

node taskping.js config
# 选择 "3. 通知渠道" → "2. 邮件通知"

优点:

• 🎮 交互式界面，逐步配置
• 💡 详细的配置说明和提示
• 🔄 可以随时修改现有配置

适用于: 喜欢逐步配置，需要详细指导的用户

---

📧 常见邮箱配置

Gmail 配置

前提条件:

1. 启用两步验证
2. 生成应用密码 (16位)

配置参数:

{
  "smtp": {
    "host": "smtp.gmail.com",
    "port": 587,
    "secure": false
  },
  "imap": {
    "host": "imap.gmail.com", 
    "port": 993,
    "secure": true
  }
}

QQ邮箱配置

前提条件:

1. 开启SMTP/IMAP服务
2. 获取授权码

配置参数:

{
  "smtp": {
    "host": "smtp.qq.com",
    "port": 587,
    "secure": false
  },
  "imap": {
    "host": "imap.qq.com",
    "port": 993, 
    "secure": true
  }
}

163邮箱配置

配置参数:

{
  "smtp": {
    "host": "smtp.163.com",
    "port": 587,
    "secure": false
  },
  "imap": {
    "host": "imap.163.com",
    "port": 993,
    "secure": true
  }
}

---

🛠️ 配置后的使用流程

1. 测试邮件发送

node taskping.js test

应该能看到：

Testing notification channels...

✅ desktop: PASS
✅ email: PASS

Test completed: 2/2 channels passed

2. 查看系统状态

node taskping.js status

应该能看到：

TaskPing Status

Configuration:
  Enabled: Yes
  Language: zh-CN
  Sounds: Submarine / Hero

Channels:
  desktop:
    Enabled: ✅
    Configured: ✅
    Supports Relay: ❌
  email:
    Enabled: ✅
    Configured: ✅
    Supports Relay: ✅

3. 启动命令中继服务

node taskping.js relay start

看到以下信息表示成功：

🚀 启动邮件命令中继服务...
✅ 命令中继服务已启动
📧 正在监听邮件回复...
💡 现在您可以通过回复邮件来远程执行Claude Code命令

按 Ctrl+C 停止服务

4. 开始使用

现在当您使用 Claude Code 时：

1. 任务完成时会收到邮件通知
2. 回复邮件即可远程执行下一步命令
3. 享受远程AI编程的便利！

---

🚨 常见问题解决

Q: 邮件发送失败

检查清单:

• ✅ 邮箱密码是否使用应用密码 (不是登录密码)
• ✅ SMTP/IMAP 服务是否已开启
• ✅ 网络连接是否正常
• ✅ 防火墙是否阻止连接

解决方法:

# 重新配置
node taskping.js setup-email

# 或检查配置文件
node taskping.js edit-config channels

Q: 收不到邮件

检查清单:

• ✅ 垃圾邮件文件夹
• ✅ 邮件地址是否正确
• ✅ 邮箱存储空间是否充足

Q: 无法接收回复

检查清单:

• ✅ 中继服务是否运行 (taskping relay status)
• ✅ IMAP 配置是否正确
• ✅ 是否回复的是 TaskPing 发送的邮件

---

📱 使用技巧

1. 邮件模板定制

您可以通过编辑配置文件自定义邮件检查间隔：

node taskping.js edit-config channels

找到 template.checkInterval 并修改值 (单位：秒)：

"template": {
  "checkInterval": 30  // 每30秒检查一次新邮件
}

2. 多项目管理

不同项目的通知会自动包含项目名称：

[TaskPing] Claude Code 任务完成 - MyProject
[TaskPing] Claude Code 任务完成 - AnotherProject

3. 批量配置

如果您有多台电脑需要配置，可以：

1. 在一台电脑上配置好
2. 复制 config/channels.json 文件
3. 粘贴到其他电脑的同一位置

---

🎯 最佳实践

1. 安全性: 定期更换应用密码
2. 性能: 根据使用频率调整检查间隔
3. 维护: 定期清理命令历史 (taskping relay cleanup)
4. 监控: 定期检查中继服务状态 (taskping relay status)

---

开始享受远程AI编程的便利吧！🚀