📢 Release 1.0.0-beta.11(2026-06-03)现已推出
Arcadia

消息通知

第三方渠道推送通知

过时的内容

即将上线监控告警功能,当前内容将被废弃已不再维护,注意持续关注项目的功能变动

旧版通知渠道

用于在脚本运行后将指定内容推送到你的设备上,支持多个渠道同时推送,推送内容由脚本而定。 目前支持:Server酱、Bark、Telegram、钉钉、企业微信、iGot、pushplus、go-cqhttp、WxPusher

此功能基于底层 sendNotify.js 脚本实现,仅支持常见 js 脚本

控制面板入口

编辑配置 - 下拉选择 config.sh - 推送通知设置区域

  • 通知尾

    export NOTIFY_TAIL="本通知 By:https://github.com/SuperManito/Arcadia"

    默认如上,如想修改请编辑 config.sh 配置文件中的变量

  • 通知屏蔽

    export NOTIFY_MASKING=""

    变量中填写想要屏蔽的关键词,多个词用 & 连接,注意屏蔽针对的是内容而不是通知标题


Server酱

官网:https://sct.ftqq.com

  • SCHKEY 或 SendKey(必填)

    export PUSH_KEY=""
  • 自建 Server 酱(选填)

    export SCKEY_WECOM=""
    export SCKEY_WECOM_URL=""

Bark

  • 设备码(必填)

    export BARK_PUSH=""

    例如 https://api.day.app/123 则填写 123

  • 声音设置(必填)

    export BARK_SOUND=""

    具体值请在bark-推送铃声-查看所有铃声,例如 choo

  • 推送消息分组

    export BARK_GROUP=""

    默认为 Arcadia,推送成功后可以在历史消息 - 右上角文件夹图标查看


Telegram

注意

注意网络连通性问题,可能需要魔法

  • token(必填)

    export TG_BOT_TOKEN=""

    填写自己申请 @BotFather 的 Token,如 10xxx4:AAFcqxxxxgER5uw

  • user_id(必填)

    export TG_USER_ID=""

    填写 @getuseridbot 中获取到的纯数字ID

  • 代理设置

    在配置文件中,代理相关变量已默认被注释,如需使用请自行解除注释


钉钉

官方文档:https://developers.dingtalk.com/document/app/custom-robot-access

  • token后面的内容(必填)

    export DD_BOT_TOKEN=""

    只需 https://oapi.dingtalk.com/robot/send?access_token=XXX 等号后面的 XXX 即可

  • 密钥(必填)

    export DD_BOT_SECRET=""

    机器人安全设置页面,加签一栏下面显示的 SEC 开头的 SECXXXXXXXXXX 等字符

    注意

    钉钉机器人安全设置只需勾选加签即可,其他选项不要勾选


企业微信机器人

官方文档:https://work.weixin.qq.com/api/doc/90000/90136/91770

  • 密钥(必填)

    export QYWX_KEY=""

    企业微信推送 webhook 后面的 key


企业微信应用

参考文档:http://note.youdao.com/s/HMiudGkb
ㅤㅤㅤㅤㅤhttp://note.youdao.com/noteshare?id=1a0c8aff284ad28cbd011b29b3ad0191

  • id(必填)

    export QYWX_AM=""

    素材库图片id(corpid,corpsecret,touser,agentid),素材库图片填 0 为图文消息, 填 1 为纯文本消息


iGot聚合 [!toc]

官方文档:https://wahao.github.io/Bark-MP-helper

  • 推送key(必填)

    export IGOT_PUSH_KEY=""

    支持多方式推送,确保消息可达


pushplus

官网:http://www.pushplus.plus

  • Token(必填)

    export PUSH_PLUS_TOKEN=""

    微信扫码登录后一对一推送或一对多推送下面的 token,只填此变量默认为一对一推送

  • 一对一多推送群组编码(选填)

    export PUSH_PLUS_USER=""

    一对多推送下面 -你的群组(如无则新建) -群组编码

    需订阅者扫描二维码;如果你是创建群组所属人,也需点击 查看二维码 扫描绑定


WxPusher

官方仓库:https://github.com/wxpusher/wxpusher-client
官方文档:https://wxpusher.zjiecode.com/docs
微信公众号:WxPusher 消息推送平台

  • appToken(必填)

    export WP_APP_TOKEN=""

    可在管理台查看:https://wxpusher.zjiecode.com/admin/main/app/appToken

  • 微信用户的UID(选填)

    export WP_UIDS=""

    多个用户用 ; 分隔,WP_UIDSWP_TOPICIDS 可以同时填写, 也可以只填写一个

  • 主题的TopicId(选填)

    export WP_TOPICIDS=""

    适用于群发,用户只需要订阅主题即可,多个主题用 ; 分隔,使用 WP_UIDS 单独发送的时可以不定义此变量

  • 原文链接(选填)

    export WP_URL=""

对接消息中心

平台消息中心功能提供了统一的消息推送与管理,具备通知聚合能力,您可以将业务消息集中推送至此。

消息中心内置自动去重机制,支持最大字符数:标题 200 内容 20000,超出部分将被截断。

  • Markdown 语法

    消息内容支持 Markdown 格式渲染,常用语法如下:

    # 标题(支持 1-6 级)
    ## 二级标题
    
    **加粗文本***斜体文本*
    
    - 无序列表项
    - 另一项
    
    1. 有序列表
    2. 第二项
    
    [链接文本](https://example.com)
    
    ![图片描述](https://example.com/image.png)
    ![自定义尺寸](https://example.com/image.png =200x100)
    
    `行内代码`
    
    ```bash
    // 代码块(支持语言高亮)
    echo "Hello, World!"
    ```
    
    > 引用文本
    
    | 表头 | 表头 |
    |------|------|
    | 内容 | 内容 |
  • SDK

    SDK 位于项目 src/utils/message-sdk 目录下,零外部依赖,仅支持本地环境调用。

    import { push } from '/arcadia/src/utils/message-sdk'
    
    // 推送 info 类型消息(默认)
    await push('备份完成', '数据库备份已成功完成')
    // 推送 success 类型消息
    await push('版本更新', 'v2.1.0 已发布', 'success')

    调用导出方法 push(title, content, type)

    参数必填说明
    title消息标题
    content消息内容
    type消息类型,默认 info,可选值:infowarnerrorsuccess

    返回值:推送成功返回 true,推送失败抛出 Error

    其它语言建议使用下方的本地 HTTP 请求方式

  • HTTP 请求

    • API

      内部接口,仅支持本地调用,无认证,与 SDK 的工作原理相同

      基准地址:http://127.0.0.1:5678

      POST/api/inner/message/push

      参数

      类型

    • OpenAPI

      详见 Message 消息中心 - 推送消息

  • CLI(命令行)

    详见 CLI - 推送通知