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号
[type] 消息的格式，可选值为 OLD, TEXT, FORWARD, GRAPH

GitHubIssuesCommand

指令	描述
`/<issues> <add> [contact]?`	添加订阅
`/<issues> <remove> [contact]?`	移除订阅
`/<issues> <interval> [millis]`	设置订阅轮询间隔
`/<issues> <format> [type]`	设置订阅消息格式
`/<issues> <list> [contact]?`	查看订阅列表
`/<issues> <test> [type] [contact]?`	测试订阅

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

GitHubRepoCommitCommand

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

GitHubRepoIssueCommand

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

GitHubRepoPullCommand

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

GitHubRepoReleaseCommand

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

GitHubStatsCommand

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

设置

GithubConfig

proxy Format http://127.0.0.1:8080 or socks://127.0.0.1:1080
doh Dns Over Https Url
github_token Personal Access Tokens
reply_type URL解析回复的消息格式
timeout Http 访问超时时间，单位秒
percentage_member_join 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能
percentages 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能
sign_member_join 加群放行提示信息
github_readme_stats stats card 绘制参数

安装

MCL 指令安装

请确认 mcl.jar 的版本是 2.1.0+
./mcl --update-package io.github.gnuf0rce:github-helper --channel maven-stable --type plugins

手动安装

从 Releases 或者 Maven 下载 mirai2.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
没问题了，我给了管理权限就可以了

cssxsh

打算在 v1.3.0 中加入 GtiHubReleasePluginUpdater
也就是帮助在 GtiHub Release 中发布的插件进行自动更新
例如 https://github.com/Colter23/bilibili-dynamic-mirai-plugin

    public val dict: MutableMap<String, String> = hashMapOf(
        "cn.whitrayhb.grasspics" to "NLR-DevTeam/GrassPictures",

        "com.evolvedghost.mutegames" to "EvolvedGhost/MuteGames",
        "com.happysnaker.HRobot" to "happysnaker/mirai-plugin-HRobot",
        "com.hcyacg.pixiv" to "Nekoer/mirai-plugins-pixiv",
        "com.hrs.kloping.AutoReply" to "Kloping/Mirai_Plugins_Auto_Reply",
        "com.kasukusakura.mlss" to "KasukuSakura/mirai-login-solver-sakura",
        "com.khjxiaogu.mirai.MiraiSongPlugin" to "khjxiaogu/MiraiSongPlugin",
        "com.xtex.repeater" to "xtexChooser/mirai-repeater",

        "io.github.samarium150.mirai.plugin.lolicon" to "Samarium150/mirai-console-lolicon",
        "io.github.samarium150.mirai.plugin.mirai-console-drift-bottle" to "Samarium150/mirai-console-drift-bottle",

        "me.jie65535.mirai-console-jnr-plugin" to "jie65535/mirai-console-jnr-plugin",
        "me.stageguard.sctimetable" to "StageGuard/SuperCourseTimetableBot",
        "me.stageguard.obms.OsuMapSuggester" to "StageGuard/OsuMapSuggester",

        "org.laolittle.plugin.draw.DrawMeme" to "LaoLittle/DrawMeme",
        "org.laolittle.plugin.SkikoMirai" to "LaoLittle/SkikoMirai",

        "top.colter.bilibili-dynamic-mirai-plugin" to "Colter23/bilibili-dynamic-mirai-plugin",
        "top.cutestar.antiRecall" to "Pmaru-top/AntiRecall",
        "top.limbang.mcmod" to "limbang/mirai-console-mcmod-plugin",
        "top.limbang.mcsm" to "limbang/mirai-console-mcsm-plugin",
        "top.limbang.minecraft" to "limbang/mirai-console-minecraft-plugin",

        "xmmt.dituon.petpet" to "Dituon/petpet",

        "xyz.cssxsh.mirai.plugin.novelai-helper" to "cssxsh/novelai-helper",
        "xyz.cssxsh.mirai.plugin.pixiv-helper" to "cssxsh/pixiv-helper"
    )

以上是默认的更新列表

Samarium150

@cssxsh
Lolicon的插件id应该是io.github.samarium150.mirai.plugin.mirai-console-lolicon，昨天看成package名了。
顺便帮我把这个也加上吧

"io.github.samarium150.mirai.plugin.mirai-console-loafers-calendar" to "Samarium150/mirai-console-loafers-calendar"

谢谢你，xsh