浏览代码

docs: update readme

JustSong 2 年之前
父节点
当前提交
77ed255c52
共有 1 个文件被更改,包括 57 次插入4 次删除
  1. 57 4
      README.md

+ 57 - 4
README.md

@@ -6,7 +6,7 @@
 
 # 消息推送服务
 
-_✨ 搭建专属于你的消息推送服务,支持通过邮件,微信测试号,企业微信,飞书,钉钉等推送消息,支持 Markdown✨_
+_✨ 搭建专属于你的消息推送服务,支持多种消息推送方式,支持 Markdown,仅单可执行文件,开箱即用✨_
 
 </div>
 
@@ -35,6 +35,8 @@ _✨ 搭建专属于你的消息推送服务,支持通过邮件,微信测试
   <a href="https://message-pusher.vercel.app/">在线演示</a>
 </p>
 
+> 注意:Message Pusher 原本基于 Node.js 开发,当前版本为 Golang 重构版本,目前处于预发布阶段,可能不太稳定,如果需要稳定版请使用[旧版本](https://github.com/songquanpeng/message-pusher/releases/tag/v0.2.3)。
+
 ## 功能
 + [x] 多种消息推送方式:
   + [x] 邮件消息
@@ -44,7 +46,7 @@ _✨ 搭建专属于你的消息推送服务,支持通过邮件,微信测试
   + [x] 钉钉群机器人
   + [ ] 桌面客户端
   + [ ] Bark
-+ [x] 多种用户验证方式:
++ [x] 多种用户登录注册方式:
   + [x] 邮箱登录注册以及通过邮箱进行密码重置
   + [x] [GitHub 开放授权](https://github.com/settings/applications/new)
   + [x] 微信公众号授权(需要 [wechat-server](https://github.com/songquanpeng/wechat-server))
@@ -65,7 +67,7 @@ _✨ 搭建专属于你的消息推送服务,支持通过邮件,微信测试
 3. 访问 [http://localhost:3000/](http://localhost:3000/) 并登录。初始账号用户名为 `root`,密码为 `123456`。
 
 ## 配置
-系统本身开箱即用
+系统本身仅需要下载一个可执行文件即可开始使用,无其他依赖
 
 你可以通过设置环境变量或者命令行参数进行配置。
 
@@ -87,5 +89,56 @@ _✨ 搭建专属于你的消息推送服务,支持通过邮件,微信测试
 3. `--version`: 打印系统版本号并退出。
 
 
+### 进一步的配置
+1. 系统设置:
+   1. 填写服务器地址。
+   2. 配置登录注册选项,如果系统不对外开发,请取消选择`允许新用户注册`。
+   3. 配置 SMTP 服务,可以使用 QQ 邮箱的 SMTP 服务。
+   4. 其他配置可选,请按照页面上的指示完成配置。
+2. 个人设置:
+   1. 点击`更新用户信息`更改默认用户名和密码。
+   2. 点击`绑定邮箱地址`绑定邮箱以启用邮件消息推送方式。
+3. 推送设置:
+   1. 设置`默认推送方式`,默认为通过邮件进行推送。
+   2. 设置`推送 token`,用以推送 API 调用鉴权,如果不需要留空即可。
+   3. 设置其他推送方式,按照页面上的指示即可,完成配置后点击对应的`测试`按钮即可测试配置是否成功。
+4. 其他设置:如果系统对外提供服务,本系统也提供了一定的个性化设置功能,你可以设置关于界面和页脚,以及发布公告。
+
 ## 用法
-TODO
+1. 消息推送 API URL:`https://<domain>/push/<username>`
+   + 将上面的 `<domain>` 以及 `<username>` 替换为真实值,例如:`https://push.mydomain.cn/admin`
+2. `GET` 请求方式:`https://<domain>/push/<username>?title=<标题>&description=<描述>&content=<Markdown 文本>&channel=<推送方式>&token=<推送 token>`
+   1. `title`:选填,受限于具体的消息推送方式,其可能被忽略。
+   2. `description`:必填,可以替换为 `desp`。
+   3. `content`:选填,受限于具体的消息推送方式,Markdown 语法的支持有所区别。
+   4. `channel`:选填,如果不填则系统使用你在后台设置的默认推送方式。可选的推送方式有:
+      1. `email`:通过发送邮件的方式进行推送。
+      2. `test`:通过微信测试号进行推送。
+      3. `corp`:通过企业微信的应用号进行推送。
+      4. `lark`:通过飞书群机器人进行推送。
+      5. `ding`:通过钉钉群机器人进行推送。
+   5. `token`:如果你在后台设置了推送 token,则此项必填。另外可以通过设置 HTTP `Authorization` 头部设置此项。
+3. `POST` 请求方式:字段与上面 `GET` 请求方式保持一致。
+
+**示例:**
+```python
+import requests
+
+# GET 方式
+res = requests.get("https://your.domain.com/push/username?title={}&description={}&token={}".format("标题", "描述", "666"))
+
+# POST 方式
+res = requests.post("https://your.domain.com/push/username", data={
+    "title": "标题",
+    "description" : "描述",
+    "content": "**Markdown 内容**",
+    "token": "6666"
+})
+
+print(res.text)
+# 输出为:{"success":true,"message":"ok"}
+```
+
+## 其他
+1. `v0.3` 之前的版本基于 Node.js,你可以切换到 [`nodejs`](https://github.com/songquanpeng/message-pusher/tree/nodejs) 分支查看,该版本不再有功能性更新。
+2. `v0.3` 以及后续版本基于 Gin Template [`v0.2.1`](https://github.com/songquanpeng/gin-template) 版本开发。