From 5ecc0d1619c4a40f1f64c1bf1a56d578cf773ba3 Mon Sep 17 00:00:00 2001
From: CaoMeiYouRen <996881204@qq.com>
Date: Fri, 4 Oct 2024 22:48:49 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20Server=20=E9=85=B1?=
 =?UTF-8?q?=C2=B3=20=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                     | 14 +++++---
 src/index.ts                  |  1 +
 src/push/server-chan-turbo.ts |  5 +--
 src/push/server-chan-v3.ts    | 68 +++++++++++++++++++++++++++++++++++
 4 files changed, 82 insertions(+), 6 deletions(-)
 create mode 100644 src/push/server-chan-v3.ts

diff --git a/README.md b/README.md
index 707f732..39318fa 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@
   </a>
 </p>
 
-> Push All In One！支持 Server 酱、自定义邮件、钉钉机器人、企业微信机器人、企业微信应用、pushplus、iGot 、Qmsg、息知、PushDeer、Discord、OneBot、Telegram 等多种推送方式。
+> Push All In One！支持 Server 酱(以及 Server 酱³)、自定义邮件、钉钉机器人、企业微信机器人、企业微信应用、pushplus、iGot 、Qmsg、息知、PushDeer、Discord、OneBot、Telegram 等多种推送方式。
 >
 > 温馨提示：出于安全考虑， **所有** 推送方式请在 **服务端** 使用！请勿在 **客户端(网页端)** 使用！网页端使用还将额外产生跨域问题。
 
@@ -52,13 +52,19 @@ npm i push-all-in-one -S
 ## 👨‍💻 使用
 
 ```ts
-import { ServerChanTurbo, CustomEmail, Dingtalk, WechatRobot, WechatApp, PushPlus, IGot, Qmsg, XiZhi, PushDeer, Discord, OneBot, Telegram } from 'push-all-in-one'
+import { ServerChanTurbo, ServerChanV3, CustomEmail, Dingtalk, WechatRobot, WechatApp, PushPlus, IGot, Qmsg, XiZhi, PushDeer, Discord, OneBot, Telegram } from 'push-all-in-one'
 
-// Server酱。官方文档：https://sct.ftqq.com/r/13172
+// Server酱·Turbo。官方文档：https://sct.ftqq.com/r/13172
 const SCTKEY = 'SCTxxxxxxxxxxxxxxxxxxx'
 const serverChanTurbo = new ServerChanTurbo(SCTKEY)
 serverChanTurbo.send('你好', '你好，我很可爱')
 
+// 【推荐】Server酱³
+// Server酱3。官方文档：https://sc3.ft07.com/doc
+const sendkey = 'sctpXXXXXXXXXXXXXXXXXXXXXXXX'
+const serverChanV3 = new ServerChanV3(sendkey)
+serverChanV3.send('你好', '你好，我很可爱 - 来自 Server酱³')
+
 // 【推荐】自定义邮件，基于 nodemailer 实现，官方文档: https://github.com/nodemailer/nodemailer
 const customEmail = new CustomEmail({
     EMAIL_TYPE: 'text',
@@ -115,7 +121,7 @@ const XI_ZHI_KEY = 'xxxxxxxxxxxxx'
 const xiZhi = new XiZhi(XI_ZHI_KEY)
 xiZhi.send('你好', '你好，我很可爱 - XiZhi')
 
-// 【推荐】PushDeer 推送，官方文档：https://github.com/easychen/pushdeer
+// PushDeer 推送，官方文档：https://github.com/easychen/pushdeer
 const PUSH_DEER_PUSH_KEY = 'xxxxxxxxxx'
 const pushDeer = new PushDeer(PUSH_DEER_PUSH_KEY)
 pushDeer.send('你好', '你好，我很可爱 - PushDeer', 'markdown')
diff --git a/src/index.ts b/src/index.ts
index 56e64b0..01fae54 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -7,6 +7,7 @@ export * from './push/push-deer'
 export * from './push/push-plus'
 export * from './push/qmsg'
 export * from './push/server-chan-turbo'
+export * from './push/server-chan-v3'
 export * from './push/telegram'
 export * from './push/wechat-app'
 export * from './push/wechat-robot'
diff --git a/src/push/server-chan-turbo.ts b/src/push/server-chan-turbo.ts
index 028b362..4d37e02 100644
--- a/src/push/server-chan-turbo.ts
+++ b/src/push/server-chan-turbo.ts
@@ -1,6 +1,6 @@
 import { AxiosResponse } from 'axios'
 import debug from 'debug'
-import { Send } from '../interfaces/send'
+import { Send } from '@/interfaces/send'
 import { ajax } from '@/utils/ajax'
 
 const Debugger = debug('push:server-chan-turbo')
@@ -43,6 +43,7 @@ export type ServerChanTurboOptions = {
 }
 
 /**
+ * Server 酱·Turbo
  * 文档 https://sct.ftqq.com/
  *
  * @author CaoMeiYouRen
@@ -81,7 +82,7 @@ export class ServerChanTurbo implements Send {
      * @param desp 消息的内容，支持 Markdown
      */
     async send(text: string, desp: string = '', options: ServerChanTurboOptions = {}): Promise<AxiosResponse<any>> {
-        Debugger('text: "%s", desp: "%s"', text, desp)
+        Debugger('text: "%s", desp: "%s", options: %O', text, desp, options)
         if (options.noip === 1 || options.noip === true) {
             options.noip = '1'
         }
diff --git a/src/push/server-chan-v3.ts b/src/push/server-chan-v3.ts
new file mode 100644
index 0000000..59ea2a0
--- /dev/null
+++ b/src/push/server-chan-v3.ts
@@ -0,0 +1,68 @@
+import { AxiosResponse } from 'axios'
+import debug from 'debug'
+import { Send } from '@/interfaces/send'
+import { ajax } from '@/utils/ajax'
+
+const Debugger = debug('push:server-chan-v3')
+
+/**
+ * 附加参数
+ */
+export type ServerChanV3Options = {
+    tags?: string | string[] // 标签列表，多个标签使用竖线分隔；也可以用数组格式，数组格式下不要加竖线
+    short?: string // 推送消息的简短描述，用于指定消息卡片的内容部分，尤其是在推送markdown的时候
+}
+
+/**
+ * Server酱³
+ * 文档：https://sc3.ft07.com/doc
+ * @author CaoMeiYouRen
+ * @date 2024-10-04
+ * @export
+ * @class ServerChanV3
+ */
+export class ServerChanV3 implements Send {
+
+    /**
+     * 请前往 https://sc3.ft07.com/sendkey 领取
+     *
+     * @author CaoMeiYouRen
+     * @date 2024-10-04
+     * @private
+     */
+    private sendkey: string
+
+    /**
+     * @author CaoMeiYouRen
+     * @date 2024-10-04
+     * @param sendkey 请前往 https://sc3.ft07.com/sendkey 领取
+     */
+    constructor(sendkey: string) {
+        this.sendkey = sendkey
+        Debugger('set sendkey: "%s"', sendkey)
+        if (!this.sendkey) {
+            throw new Error('sendkey 是必须的！')
+        }
+    }
+
+    async send(text: string, desp: string = '', options: ServerChanV3Options = {}): Promise<any> {
+        Debugger('text: "%s", desp: "%s", options: %O', text, desp, options)
+        if (Array.isArray(options.tags)) {
+            options.tags = options.tags.join('|')
+        }
+        const data = {
+            text,
+            desp,
+            ...options,
+        }
+        return ajax({
+            url: `https://${this.sendkey}.push.ft07.com/send`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            data,
+        })
+    }
+
+}