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