GitHub Helper / GitHub Notice 订阅插件

cssxsh

GitHub Helper

基于 Mirai Console 的 GitHub Notice 订阅插件

使用前应该查阅的相关文档或项目

指令

注意: 使用前请确保可以在聊天环境执行指令
<...>中的是指令名，例如/repo-issue add mamoe/mirai
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 io.github.gnuf0rce.github-helper:command.*, * 是指令的第一指令名
例如 /repo-issue add mamoe/mirai 的权限ID为 io.github.gnuf0rce.github-helper:command.repo-issue

[repo] 格式为 {owner}/{repo}, 举例 mamoe/mirai
[contact]?是可选的参数，会自动由当前环境填充，例如群聊填充群号，私聊填充QQ号

GitHubIssuesCommand

指令	描述
`/<issues> <add> [contact]?`	添加订阅
`/<issues> <remove> [contact]?`	移除订阅
`/<issues> <interval> [millis]?`	设置订阅轮询间隔
`/<issues> <list>?`	查看订阅列表

这个指令用于获取当前用户的issues，所以需要有效 token

GitHubRepoCommitCommand

指令	描述
`/<repo-commit> <add> [repo] [contact]?`	添加订阅
`/<repo-commit> <remove> [repo] [contact]?`	移除订阅
`/<repo-commit> <interval> [repo] [millis]?`	设置订阅轮询间隔
`/<repo-commit> <list> [contact]?`	查看订阅列表

GitHubRepoIssueCommand

指令	描述
`/<repo-issue> <add> [repo] [contact]?`	添加订阅
`/<repo-issue> <remove> [repo] [contact]?`	移除订阅
`/<repo-issue> <interval> [repo] [millis]?`	设置订阅轮询间隔
`/<repo-issue> <list> [contact]?`	查看订阅列表

GitHubRepoPullCommand

指令	描述
`/<repo-pull> <add> [repo] [contact]?`	添加订阅
`/<repo-pull> <remove> [repo] [contact]?`	移除订阅
`/<repo-pull> <interval> [repo] [millis]?`	设置订阅轮询间隔
`/<repo-pull> <list> [contact]?`	查看订阅列表

GitHubRepoReleaseCommand

指令	描述
`/<repo-release> <add> [repo] [contact]?`	添加订阅
`/<repo-release> <remove> [repo] [contact]?`	移除订阅
`/<repo-release> <interval> [repo] [millis]?`	设置订阅轮询间隔
`/<repo-release> <list> [contact]?`	查看订阅列表

GitHubStatsCommand

指令	描述
`/<stats> <card> [name]`	查看状态
`/<stats> <contribution> [name]`	查看贡献

自动通过加群问题放行开发者

1.1.7 起对接到 mirai-administrator 实现此功能

举例：

问题：GitHub ID ?
答案：cssxsh

机器人会检查 cssxsh 的活跃度是否满足要求，如满足要求则放行

设置

GithubConfig

proxy Format http://127.0.0.1:8080 or socks://127.0.0.1:1080
token Personal Access Tokens
reply Subscriber Reply Message Type TEXT, XML, JSON, JSON 尚不可用
percentage_member_join 加群放行活跃等级（百分制），默认0，不开启功能
sign_member_join 加群放行提示信息
github_readme_stats stats card 绘制参数

安装

MCL 指令安装

./mcl --update-package io.github.gnuf0rce:github-helper --channel stable --type plugin

手动安装

运行 Mirai Console 生成plugins文件夹
从 Releases 下载jar并将其放入plugins文件夹中

cssxsh

有需要的 Notice 对象可以到 GitHub 提 feat issue

EdgeStar2020

刚开始使用，在启动mirai后此插件会提示not found doc，是否会有影响？
只订阅了一个releases

cssxsh

@edgestar2020
我需要更完整的日志

EdgeStar2020

@cssxsh 刚刚我去重新启动看了一下，我能找到的关于此插件的日志，只有图里面红色字体的这一条，除此之外没有看到其他相关的日志了

再附上其他可能有用的插件运行环境信息：
服务器操作系统：Windows Server 2012 R2 DataCenter 64bitCN
JRE版本：OpenJDK Runtime Environment Temurin-11.0.12+7 (11.0.12+7) (build 11.0.12+7)
Java VM：OpenJDK Client VM Temurin-11.0.12+7 (11.0.12+7, mixed mode, serial gc, windows-x86)
Mirai版本：2.7.1
插件版本：1.1.3

cssxsh

@edgestar2020
没能复现，话说你这是 1.1.3 ?
看报错格式是 1.1.2,
1.1.3 我修改了报错格式

EdgeStar2020

@cssxsh 啊，是我看错了，因为我昨天下午下载时确定下载的是最新版，所以下意识的直接贴了看到的最新版版本号，没想到之后又更新了，我的版本确实是1.1.2，至于上面的这个问题，我刚刚把mirai更新到了2.8.0、插件更新到了1.1.3之后，就没有报错了，打扰大佬了

wz18207

话说，可不可以加入自定义的git，额老实说我现在是自建的私人的git想在qq上显示提交信息这样可以吗感谢

cssxsh

@wz18207
这个插件是基于github rest api 的
目前没有支持其他git service 的计划
有需要你可以开issue，看情况加入开发备忘录

wz18207

@cssxsh 可