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 可

leoweyr

Bug?

cssxsh

@leoweyr
java.util.NoSuchElementException 和 org.openqa.selenium.NoSuchElementException 同名了，我没注意到

不过触发这个错误意味着你有个 Contact 设置的不正确

leoweyr

@cssxsh 在 GitHub Helper / GitHub Notice 订阅插件中说：

@leoweyr
java.util.NoSuchElementException 和 org.openqa.selenium.NoSuchElementException 同名了，我没注意到

不过触发这个错误意味着你有个 Contact 设置的不正确

?Contact就是群聊号嘛，正确的呀

cssxsh

@leoweyr
https://github.com/gnuf0rce/github-helper/releases/tag/v1.2.2
尝试修复

leoweyr

我突然想到这个repo是团队的仓库，我记得团队仓库的API数据结构好像和个人仓库的API数据结构不一样

haha

这是需要什么权限吗
Mirai 版本 2.12.0
Windows 10 21H2

2022-07-28 21:40:52 E/main: Exception in coroutine Bot 23xxxxxx67
net.mamoe.mirai.contact.PermissionDeniedException: Permission denied: 'createFolder' on file '/' requires an operator permission.
        at net.mamoe.mirai.internal.contact.file.AbstractAbsoluteFileFolder.throwPermissionDeniedException(AbstractAbsoluteFileFolder.kt:57)
        at net.mamoe.mirai.internal.contact.file.AbsoluteFolderImpl.checkPermission(AbsoluteFolderImpl.kt:89)
        at net.mamoe.mirai.internal.contact.file.AbsoluteFolderImpl.createFolder(AbsoluteFolderImpl.kt:312)
        at github-helper-1.2.3.mirai2.jar//io.github.gnuf0rce.mirai.github.GitHubMessageKt.uploadTo(GitHubMessage.kt:818)
        at github-helper-1.2.3.mirai2.jar//io.github.gnuf0rce.mirai.github.GitHubMessageKt$toMessage$31.invokeSuspend(GitHubMessage.kt:769)
        at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)
        at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:106)
        at kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely(CoroutineScheduler.kt:570)
        at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.executeTask(CoroutineScheduler.kt:749)
        at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.runWorker(CoroutineScheduler.kt:677)
        at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.run(CoroutineScheduler.kt:664)

cssxsh

@haha

哦，创建群文件夹需要管理员权限
我没注意到这点

haha

@cssxsh
没问题了，我给了管理权限就可以了