Pushplus WeChat Push (General Version): A Skill Empowering Users with Notification Capabilities

前言

给脚本、定时任务或 Agent 加通知,常见做法是在代码里写死 Token 和推送 URL。这样每换一个用户就要改一次代码,Token 泄漏后排查也麻烦。Pushplus 微信推送(通用版)走的是另一个方向:Token 由使用者自己配置并保存在本地,Skill 本身不保存凭证,通知渠道也不止微信一种。

下面介绍这个 Skill 的定位、功能和用法。

这是什么

Pushplus 微信推送(通用版)是一个基于通用 SKILL.md 格式的社区 Skill,坐标 @user_5d10d7f7/pushplus-notify,当前版本 1.1.0,由 user_5d10d7f7 发布维护。

它解决的问题是:把”通过 Pushplus 推送服务发送消息通知”这件事封装成可分发的能力。首次使用时交互式配置 Token,并写入本地配置文件;之后推送请求由 Skill 调用,不需要把 Token 固化在技能定义或业务代码里。适合需要把通知能力分发给不同用户的团队或个人。

来源标注为 community,分类 dev-programming,标签 requires_api_key=true。

核心功能

根据 SkillHub 页面的简介,这个 Skill 支持的能力包括:

  • 单条推送、群组推送、多渠道推送。
  • 模板类型覆盖 Markdown、HTML、JSON。
  • 渠道覆盖 Pushplus 侧的 Webhook、邮件、短信、语音等。
  • 首次使用交互式配置 Token,保存到本地配置文件。
  • Token 不写死在 Skill 内,便于分发给不同用户。

页面同时给出评分 100000,下载 994,安装 0。安装数为 0 表示当前 SkillHub 页面未记录实际安装量,不代表不可用。

安装与启用

SkillHub 页面未给出具体的 git clone 或包管理器安装命令,也没有 Cursor、Codex CLI、Claude Code 的分别说明。这里只写可核实的信息:官方地址为 https://api.skillhub.cn/user_5d10d7f7/pushplus-notify,SkillHub 展示页为 https://www.skillhub.cn/skills/user_5d10d7f7/pushplus-notify。

通用启用方式按 SKILL.md 格式处理即可:

# 将仓库或技能目录放入本地 skills 目录后,由支持 SKILL.md 的客户端加载

使用前必须先完成 Token 配置,因为页面标签明确标注 requires_api_key=true。

典型用法

官方资料只说明了配置与推送目标,没有给出逐字示例。下面按 Skill 描述还原调用口径,具体字段以 Pushplus 接口文档和本地生成的配置文件为准。

首次触发时按交互提示完成配置:

# 配置 Token,并保存到本地配置文件
# Skill 不把 Token 写死在技能定义里

之后发起推送:

# 单条推送
# 群组推送
# 多渠道推送:Webhook / 邮件 / 短信 / 语音
# 模板:Markdown / HTML / JSON

如果你的环境由 Agent 调用 Skill,直接让 Agent 执行该 Skill 即可,参数指向本地配置文件中的 Token 和目标渠道。

适用场景与注意

适合:

  • 需要把通知能力分发给多个用户,又不希望每个用户改代码。
  • 脚本、定时任务、Agent 工作流中需要接一条微信或多渠道通知。
  • 内容需要按 Markdown、HTML 或 JSON 组织。

注意:

  • Skill 依赖 Pushplus 推送服务,Token 需要先申请并正确配置。
  • 页面未提供安装命令和客户端差异说明,部署前先在 SkillHub 页面核对安装方式。
  • 页面显示安装量为 0,采用前建议自行验证推送链路。

结尾

这个 Skill 的价值在于把”发通知”从硬编码里拆出来:Token 本地保存,推送目标和模板按需选择,便于分发。如果你的场景正好是给不同用户分发通知能力,可以从官方地址查看并先完成 Token 配置:https://api.skillhub.cn/user_5d10d7f7/pushplus-notify。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye