pushplus-notification（推加通知）

pushplus Notification

通过 pushplus HTTP API 直接向微信、邮箱、webhook、短信等渠道推送消息。无需安装任何依赖，只需 Shell 工具 + curl 即可使用。

前置条件

用户需要提供 PUSHPLUS_TOKEN（32 位字符串），在 pushplus.plus 注册后获取。

获取 token 的方式（按优先级）：

1. 用户在对话中直接提供
2. 环境变量 PUSHPLUS_TOKEN
3. 从项目根目录 .env 文件中仅提取 PUSHPLUS_TOKEN 的值（使用 grep ^PUSHPLUS_TOKEN= .env 或等效方式，禁止读取 .env 文件的其他内容，以避免泄露无关凭证）

如果找不到 token，必须询问用户，不要猜测。

API 端点

Content-Type: application/json

发送消息

使用 Shell 工具执行 curl 命令：

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"TOKEN","title":"标题","content":"内容","template":"html","channel":"wechat"}'

请求参数（/send）

请求参数（/batchSend）

模板类型

推送渠道

响应格式

{"code": 200, "msg": "请求成功", "data": "消息流水号"}

• code 为 200 表示成功
• data 为消息流水号
• 非 200 时根据 msg 排查（常见：token 无效、余额不足）

使用流程

1. 获取用户的 PUSHPLUS_TOKEN
2. 根据场景选择模板和渠道
3. 构造 JSON 请求体（注意转义特殊字符）
4. 通过 Shell 工具执行 curl 命令
5. 检查响应 code 是否为 200，向用户反馈结果

模板选择策略

示例

发送 Markdown 通知

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"任务完成","content":"## 任务已完成\
\
- **任务**: 代码重构\
- **状态**: 成功\
- **耗时**: 5分钟","template":"markdown","channel":"wechat"}'

发送 HTML 告警

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"构建失败","content":"<h2 style=\"color:red\">构建失败</h2><p>项目 my-app 构建失败，请检查日志。</p>","template":"html","channel":"wechat"}'

多渠道批量发送

curl -s -X POST "https://www.pushplus.plus/batchSend" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"紧急通知","content":"服务器 CPU 超过 90%","channel":"wechat,mail","template":"txt"}'

注意事项

• content 中的双引号需要转义为 \"
• content 中的换行使用 `\

`

• Windows 环境下 curl 的单引号需改为双引号，内部双引号用 \" 转义
• 如果 curl 不可用，可用 Python、Node.js 等发送 HTTP POST 请求作为替代
• token 是敏感信息，不要在输出中明文展示完整 token

安全要求

• 发送前确认：每次发送消息前必须向用户展示即将发送的标题和内容摘要，并获得用户明确确认后再执行 curl 命令。禁止在用户不知情的情况下自主发送消息。
• 凭证保护：不要在任何输出、日志或代码注释中明文展示完整 token。展示时应使用脱敏格式（如 a1b2****ef90）。
• 最小读取原则：从 .env 文件获取 token 时，仅提取 PUSHPLUS_TOKEN 行，禁止读取或输出文件中的其他变量。
• 敏感内容警示：如果用户要求发送的消息内容包含密码、密钥、个人身份信息等敏感数据，应警告用户消息将通过第三方服务（pushplus.plus）传输，并建议用户确认是否继续。
• 不要存储 token：不要将 token 写入任何文件、配置或代码中。仅在内存中用于构造请求。