Pushplus 微信推送(通用版):把通知能力交給用戶的 Skill

前言

給腳本、定時任務或 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。

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

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

小夜