Skip to content

Trenki/push-template

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wechat-public-account-push

GitHub Stars GitHub Forks GitHub Issues GitHub Contributors GitHub License

wechat-public-account-push 是一个用于微信公众号/微信测试号给用户执行微信推送的脚本,改编自目前小红书/知乎突然火起来的【给女朋友的七夕浪漫,微信自动推送消息】,用Nodejs实现而成。

目前可被推送模板获取的字段如下:

* 为新增的可配置参数

删除线 为已废除的参数

天气类

参数 详细 示例
date.DATA YYYY-MM-DD 星期d 2022-08-26 星期五
* province.DATA 省份  广东
city.DATA 城市  惠州
weather.DATA 天气 阵雨转多云
min_temperature.DATA 最低气温 25℃
max_temperature.DATA 最高气温 25℃
* wind_direction.DATA 风向 持续东南风
* wind_scale.DATA 风级 <3级

每日N句

参数 详细 示例
note_en.DATA 金山每日一句-英文 Nothing in this world that's worth having comes easy.
note_ch.DATA 金山每日一句-中文 这世界上凡是值得拥有的东西,都不易获得。
* one_talk.DATA 每日一言-内容 愿你遍布祖国山河,觉得人生也值得
* talk_from.DATA 每日一言-来源 晓良

计时类

参数 详细 示例
love_day.DATA 已预置, 但是可以删掉, 在配置中自定义, 见下文 2674
marry_day.DATA 已预置, 但是可以删掉, 在配置中自定义, 见下文 965
birthday_message.DATA 生日消息 距离 宝贝 的生日还有122天

自定义计时类

现在你可以自己加入更多需要铭记的日子,来丰富你的推送模板了!

比如:

光荣的退伍军人,您好!
今天是您退伍的第{{ex_day.DATA}}天

您守护的不只是山河社稷,更是每个年轻人的未来!

这个 ex_day.DATA 在上面的出参表并没有定义啊,怎么设置它呢?

现在在配置文件中就可以进行设置了!

但是有以下情况需要注意,不要占用表中已有的关键字,会发生不可预料的状况噢!

自定义插槽

你可以在这里写超多的你想显示的内容了!想怎么组装自己的推送内容都可以。

用法同上

推送回执(特有, 仅在其他模板发送完成后才能获取)

参数 详细 示例
* post_time_zone.DATA 服务器时区 Asia/Shanghai
* post_time.DATA 服务器执行脚本时间 2022-08-31 19:41:57
* need_post_num.DATA 共需推送N人 4
* success_post_num.DATA 成功推送N人 1
* fail_post_num.DATA 推送失败N人 3
* success_post_ids.DATA 推送成功的用户 老婆0
* fail_post_ids.DATA 推送失败的用户 老婆1,老婆2,老婆3

目前可参考的推送模板如下:

亲爱的, 早上好

{{date.DATA}}  
城市:{{city.DATA}}  
天气:{{weather.DATA}}  
最低气温: {{min_temperature.DATA}}  
最高气温: {{max_temperature.DATA}}  
今天是我们恋爱的第{{love_day.DATA}}天
今天是我们结婚的第{{marry_day.DATA}}天


{{birthday_message.DATA}}


{{one_talk.DATA}} -- {{talk_from.DATA}}


{{note_en.DATA}}  
{{note_ch.DATA}}

推送提醒

服务器信息:{{post_time_zone.DATA}} {{post_time.DATA}}


共推送 {{need_post_num.DATA}}  人
成功: {{success_post_num.DATA}} | 失败: {{fail_post_num.DATA}}
成功用户: {{success_post_ids.DATA}}
失败用户: {{fail_post_ids.DATA}}

Github 仓库地址:wangxinleo/wechat-public-account-push

Github 镜像仓库地址(国内备用01):wangxinleo/wechat-public-account-push

Github 镜像仓库地址(国内备用02):wangxinleo/wechat-public-account-push

注意:

  • 本仓库开源的初衷是看不下去营销号用这么一个简单的脚本刻意在网络上肆意要求加群/关注微信公众号才能获取源码的行为
  • 本应用仅用于学习和测试,作者本人并不对其负责,请于运行测试完成后自行删除,请勿滥用!
  • 所有代码都是开源且透明的,任何人均可查看,程序不会保存或滥用任何用户的个人信息
  • 请仔细阅读配置文档,自己对自己的配置负责

运行图示:

运行图示

运行图示

wechat-public-account-push 答疑群

不管文档写得多详细,还是会有人不会呐!还是建个群答疑吧!

不会从9月1号之后群里永远都只有我一个人吧!多尴尬呀哈哈哈哈~

wechat-public-account-push 交流群

1.0.1 预计更新

  • [√] (已完成)修复github action默认使用utc时区,导致北京时间8点前的推送不显示为当天。现在会强制回显为PRC时区。
  • [√] (已完成)增加推送回执,不用去看控制台咯!
  • [√] (已完成)优化仓库目录结构,主脚本代码更清爽了!
  • [√] (已完成)节日推送千呼万唤,现在可以根据配置就近推送前N个节日了,就算节日过了也不怕啦!
  • [√] (已完成)加入了文艺青年专属每日一句!
  • [√] (已完成)增加更多天气预设的字段, 由用户自由选择想要展示的字段

1. 如何使用(以测试号为例)

wechat-public-account-push 实现自消息推送的原理,是通过调用一系列开放的api实现的, 所以也非常适合初学者学习。

要使用 wechat-public-account-push, 我们只需要做拥有自己的公众号, 得到相关配置信息进行配置即可

1.1. 第一步:注册一个微信公众号

  • 浏览器打开并登录 微信公众测试号

  • 登录成功后, 就可以生成微信公众测试号的appID和appsecret这两串数字, 记下备用 appID-appsecret

  • 扫描测试号二维码关注测试号, 扫描之后, 右边就会出现相应的已关注人员id, 记下备用 wx-test-follow

1.2. 第二步:进行模板配置

新增测试模板, 点击 新增测试模板 , 进行以下设置

这里面的每一个{{***.DATA}}都对应相应的数据,需要就保留,不需要就删掉

更多模板 请查看上方更新内容

模板标题: 自定义,例如: 亲爱的,早上好!

模板内容:

{{date.DATA}}  
城市:{{city.DATA}}  
天气:{{weather.DATA}}  
最低气温: {{min_temperature.DATA}}  
最高气温: {{max_temperature.DATA}}  
今天是我们恋爱的第{{love_day.DATA}}天
今天是我们结婚的第{{marry_day.DATA}}天
{{birthday_message.DATA}}


{{note_en.DATA}}  
{{note_ch.DATA}}

记下模板代码

1.3. 第三步:fork仓库, 填入相应配置

  • fork仓库

    github-fork

  • 修改相应配置

   

   

   

  • 按需填入相应配置后保存

   

   

   

1.4. 第四步:启用workflow自动任务,定时执行

  • 启用action脚本

   

   

   

1.5. 第五步(选做): 检查脚本是否可以正常执行

  • 手动启动脚本    

  • 查看执行结果    

   

   

2. action脚本说明

这里的脚本使用的是 github 的 workflow 定时任务, 具体脚本文件放置在:

wechat-public-account-push/.github/workflows/weixin-push-on-time.yml

这里简单说明一下如何更改自动执行时间

目前脚本默认执行时间为 每天的 北京时间上午 10:10

如果想要变更脚本定时任务执行时间,可以更改以下代码段

on:
  workflow_dispatch:
  schedule:
    # 每天国际时间2:10 运行, 即北京时间 10:10 运行
    - cron: '10 2 * * *'

推荐设置: 10 2 * * *10 22 * * * 等冷门时间,拥堵率低

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

3. 常见问题

Issues(议题)板块可以用来提交Bug建议

Discussions(讨论)板块可以用来提问讨论

3.1 问题导航

关于获取accessToken:请求失败invalid appsecret rid xxxxx

关于推送失败,报40001- 4000X

关于目前仅支持测试号的问题

关于定时任务好像没有自动执行(?)

所以如果你有疑问,

  • 请先确认是否可以通过升级到最新版本解决
  • 然后搜索文档(特别是配置说明文档和常见问题文档)查看是否已有解决方案

如果确认还未解决,可以自己提交 Issue,我会尽快确认并解决。

4. 版本发布及更新

关于新版本发布后,如何同步最新的内容到自己 Fork 的仓库

目前最简单也最不需要想其他的方法就是 删掉自己的仓库再重新Fork

4.1 重新fork

删掉后重新Fork会导致之前配置过的GitHub Secrets和提交的代码更改全部丢掉,只能重新部署。

4.2 pull request(这个方法太多人不会用了, 删除)

4.3 GitHub Fetch Upstream Branch

  • 在自己的项目仓库中选择 "Sync fork"

  • 点击 "Update branch" 完成

可能会遇到 因为冲突需要你们删除你们已经更改的记录

如果只是纯粹更改配置,放心大胆的点删除, 然后更新最新代码仓库就好了。

如果你更改了源代码进行了部分定制, 请注意备份代码段。

4.4 actions 脚本自动

以后会考虑加入actions 脚本每周自动更新fork仓库,但是目前精力不足,只能采用上述保守方案

建议每个人先看看更新的内容是否是自己需要的再进行更新。

也建议把右上角的 Star 点一下,这样有重要更新时就会有邮件推送了。

5. 成为开源贡献成员

5.1 贡献代码

如果你有好的想法,欢迎向仓库贡献你的代码,贡献步骤:

  • 搜索查看 Issue,确定是否已有人提过同类问题或者有新的想法

  • 确认没有同类 Issue 后,自己可新建 Issue,描述问题或建议

  • 如果想自己解决,请 Fork 仓库后,在develop 分支进行编码开发,完成后提交 PR 到 develop 分支,并标注解决的 Issue 编号

我会尽快进行代码审核,测试成功后会合并入 main 主分支,提前感谢您的贡献。

5.2 贡献文档

文档部分由于我个人精力有限(写文档比写代码累多了),所以有些地方写的很简略,甚至有遗漏和错别字,不能贡献代码的朋友也欢迎来一起维护文档,欢迎 PR 来纠正我,一样都算是对开源做贡献了。

6. 致谢

贡献/参与者

@LordonCN Lordon

感谢那些默默支持我, 鼓励我继续更新这个小玩具的朋友。

感谢所有参与到开发/测试中的朋友们,是大家的帮助让 TA 越来越好! (*´▽`)ノノ

7. 其他

时区查询: https://www.zeitverschiebung.net/cn/all-time-zones.html

8. 叨叨两句

这个仓库只能算是重复实现一下别人的想法, 主要是了解到了这个想法却一直找不到原作者的源码很是苦恼, 结果还遇到了要求加关注的情况

真的非常不喜欢目前国内论坛/某乎/某书/某字母站的博主在分享一些有趣的项目后,甚至是分享了教程之后却不提供源码链接,要求关注公众号或QQ群才进行分享

虽然我无权谴责这些流量变现的做法, 但是我认为作者既然开源自己的作品, 那就是希望其他人能一起体会coding的喜悦, 请部分博主尊重作者意愿, 尊重开源协议


About

微信公众号推送

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%