{"id":37016980,"url":"https://github.com/gnuf0rce/github-helper","last_synced_at":"2026-01-14T01:56:33.904Z","repository":{"id":45816591,"uuid":"395049438","full_name":"gnuf0rce/github-helper","owner":"gnuf0rce","description":"mirai-console 插件开发计划","archived":false,"fork":false,"pushed_at":"2024-12-23T01:03:30.000Z","size":612,"stargazers_count":25,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-23T02:19:34.661Z","etag":null,"topics":["github","mirai","mirai-console","qqbot"],"latest_commit_sha":null,"homepage":"https://github.com/orgs/gnuf0rce/projects/3","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnuf0rce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-11T16:17:22.000Z","updated_at":"2024-12-23T01:03:33.000Z","dependencies_parsed_at":"2024-12-11T04:20:55.606Z","dependency_job_id":"11558eff-751a-4e3c-9037-0e2022d97c14","html_url":"https://github.com/gnuf0rce/github-helper","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/gnuf0rce/github-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Fgithub-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Fgithub-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Fgithub-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Fgithub-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnuf0rce","download_url":"https://codeload.github.com/gnuf0rce/github-helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Fgithub-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28408692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T00:40:43.272Z","status":"ssl_error","status_checked_at":"2026-01-14T00:40:42.636Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","mirai","mirai-console","qqbot"],"created_at":"2026-01-14T01:56:33.220Z","updated_at":"2026-01-14T01:56:33.893Z","avatar_url":"https://github.com/gnuf0rce.png","language":"Kotlin","readme":"# [GitHub Helper](https://github.com/gnuf0rce/github-helper)\n\n\u003e 基于 [Mirai Console](https://github.com/mamoe/mirai-console) 的 GitHub Notice 订阅插件\n\n[![Release](https://img.shields.io/github/v/release/gnuf0rce/github-helper)](https://github.com/gnuf0rce/github-helper/releases)\n[![Downloads](https://img.shields.io/github/downloads/gnuf0rce/github-helper/total)](https://repo1.maven.org/maven2/io/github/gnuf0rce/mirai-content-censor/)\n[![MiraiForum](https://img.shields.io/badge/post-on%20MiraiForum-yellow)](https://mirai.mamoe.net/topic/554)\n[![GitHub Client Test](https://github.com/gnuf0rce/github-helper/actions/workflows/test.yml/badge.svg)](https://github.com/gnuf0rce/github-helper/actions/workflows/test.yml)\n\n**使用前应该查阅的相关文档或项目**\n\n* [User Manual](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md)\n* [Permission Command](https://github.com/mamoe/mirai/blob/dev/mirai-console/docs/BuiltInCommands.md#permissioncommand)\n* [Chat Command](https://github.com/project-mirai/chat-command)\n\n## 指令\n\n注意: 使用前请确保可以 [在聊天环境执行指令](https://github.com/project-mirai/chat-command)   \n`\u003c...\u003e`中的是指令名，例如`/repo-issue add mamoe/mirai`  \n`[...]`表示参数，当`[...]`后面带`?`时表示参数可选  \n`{...}`表示连续的多个参数\n\n本插件指令权限ID 格式为 `io.github.gnuf0rce.github-helper:command.*`, `*` 是指令的第一指令名  \n例如 `/repo-issue add mamoe/mirai` 的权限ID为 `io.github.gnuf0rce.github-helper:command.repo-issue`\n\n`[repo]` 格式为 `{owner}/{repo}`, 举例 `mamoe/mirai`  \n`[contact]?`是可选的参数，会自动由当前环境填充，例如群聊填充群号，私聊填充QQ号  \n`[type]` 消息的格式，可选值为 `OLD`, `TEXT`, `FORWARD`\n\n**1.3.0** 版本起，添加从 GitHub Release Latest 更新插件的功能  \n其配置文件位于 `config/update.dict.json`\n\n### GitHubIssuesCommand\n\n| 指令                                   | 描述       |\n|:-------------------------------------|:---------|\n| `/\u003cissues\u003e \u003cadd\u003e [contact]?`         | 添加订阅     |\n| `/\u003cissues\u003e \u003cremove\u003e [contact]?`      | 移除订阅     |\n| `/\u003cissues\u003e \u003cinterval\u003e [millis]`      | 设置订阅轮询间隔 |\n| `/\u003cissues\u003e \u003cformat\u003e [type]`          | 设置订阅消息格式 |\n| `/\u003cissues\u003e \u003clist\u003e [contact]?`        | 查看订阅列表   |\n| `/\u003cissues\u003e \u003ctest\u003e [type] [contact]?` | 测试订阅     |\n\n这个指令用于获取当前用户的`issues`，所以需要有效 `token`\n\n### GitHubRepoCommitCommand\n\n| 指令                                               | 描述       |\n|:-------------------------------------------------|:---------|\n| `/\u003crepo-commit\u003e \u003cadd\u003e [repo] [contact]?`         | 添加订阅     |\n| `/\u003crepo-commit\u003e \u003cremove\u003e [repo] [contact]?`      | 移除订阅     |\n| `/\u003crepo-commit\u003e \u003cinterval\u003e [repo] [millis]`      | 设置订阅轮询间隔 |\n| `/\u003crepo-commit\u003e \u003cformat\u003e [repo] [type]`          | 设置订阅消息格式 |\n| `/\u003crepo-commit\u003e \u003clist\u003e [contact]?`               | 查看订阅列表   |\n| `/\u003crepo-commit\u003e \u003ctest\u003e [repo] [type] [contact]?` | 测试订阅     |\n\n### GitHubRepoIssueCommand\n\n| 指令                                              | 描述       |\n|:------------------------------------------------|:---------|\n| `/\u003crepo-issue\u003e \u003cadd\u003e [repo] [contact]?`         | 添加订阅     |\n| `/\u003crepo-issue\u003e \u003cremove\u003e [repo] [contact]?`      | 移除订阅     |\n| `/\u003crepo-issue\u003e \u003cinterval\u003e [repo] [millis]?`     | 设置订阅轮询间隔 |\n| `/\u003crepo-issue\u003e \u003cformat\u003e [repo] [type]`          | 设置订阅消息格式 |\n| `/\u003crepo-issue\u003e \u003clist\u003e [contact]?`               | 查看订阅列表   |\n| `/\u003crepo-issue\u003e \u003ctest\u003e [repo] [type] [contact]?` | 测试订阅     |\n\n* since 1.5.0 在 `repo` 后可补充分支名，例如 `/repo-issue add Moyuyanli/HuYanSession:dev`\n\n### GitHubRepoPullCommand\n\n| 指令                                             | 描述       |\n|:-----------------------------------------------|:---------|\n| `/\u003crepo-pull\u003e \u003cadd\u003e [repo] [contact]?`         | 添加订阅     |\n| `/\u003crepo-pull\u003e \u003cremove\u003e [repo] [contact]?`      | 移除订阅     |\n| `/\u003crepo-pull\u003e \u003cinterval\u003e [repo] [millis]?`     | 设置订阅轮询间隔 |\n| `/\u003crepo-pull\u003e \u003cformat\u003e [repo] [type]`          | 设置订阅消息格式 |\n| `/\u003crepo-pull\u003e \u003clist\u003e [contact]?`               | 查看订阅列表   |\n| `/\u003crepo-pull\u003e \u003ctest\u003e [repo] [type] [contact]?` | 测试订阅     |\n\n### GitHubRepoReleaseCommand\n\n| 指令                                                | 描述       |\n|:--------------------------------------------------|:---------|\n| `/\u003crepo-release\u003e \u003cadd\u003e [repo] [contact]?`         | 添加订阅     |\n| `/\u003crepo-release\u003e \u003cremove\u003e [repo] [contact]?`      | 移除订阅     |\n| `/\u003crepo-release\u003e \u003cinterval\u003e [repo] [millis]?`     | 设置订阅轮询间隔 |\n| `/\u003crepo-release\u003e \u003cformat\u003e [repo] [type]`          | 设置订阅消息格式 |\n| `/\u003crepo-release\u003e \u003clist\u003e [contact]?`               | 查看订阅列表   |\n| `/\u003crepo-release\u003e \u003ctest\u003e [repo] [type] [contact]?` | 测试订阅     |\n\n### GitHubStatsCommand\n\n| 指令                               | 描述   |\n|:---------------------------------|:-----|\n| `/\u003cstats\u003e \u003ccard\u003e [name]`         | 查看状态 |\n| `/\u003cstats\u003e \u003ccontribution\u003e [name]` | 查看贡献 |\n| `/\u003cstats\u003e \u003ctrophy\u003e [name]`       | 查看奖杯 |\n\n### GitHubUpdateCommand\n\n| 指令          | 描述     |\n|:------------|:-------|\n| `/\u003cupdate\u003e` | 检查插件更新 |\n\n## 自动通过加群问题放行开发者\n\n`1.1.7` 起对接到 [mirai-administrator](https://github.com/cssxsh/mirai-administrator) 实现此功能\n\n举例：\n\n```text\n问题：GitHub ID ?\n答案：cssxsh\n```\n\n机器人会检查 \u003chttps://github.com/cssxsh\u003e 的活跃度是否满足要求，如满足要求则放行\n\n## 设置\n\n### GithubConfig\n\n*   `proxy` Format http://127.0.0.1:8080 or socks://127.0.0.1:1080\n*   `doh` Dns Over Https Url\n*   `github_token` [Personal Access Tokens](https://github.com/settings/tokens)\n*   `reply_type` URL解析回复的消息格式\n*   `timeout` Http 访问超时时间，单位秒\n*   `percentage_member_join` 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能\n*   `percentages` 加群放行 GitHub 活跃等级（百分制），默认0，不开启功能\n*   `sign_member_join` 加群放行提示信息\n*   `github_readme_stats` stats card 绘制参数\n*   `auto_update` 启动时检查插件更新\n\n## 安装\n\n### MCL 指令安装\n\n**请确认 mcl.jar 的版本是 2.1.0+**  \n`./mcl --update-package io.github.gnuf0rce:github-helper --channel maven-stable --type plugins`\n\n### 手动安装\n\n1.  从 [Releases](https://github.com/gnuf0rce/github-helper/releases) 或者 [Maven](https://repo1.maven.org/maven2/io/github/gnuf0rce/mirai-content-censor/) 下载 `mirai2.jar`\n2.  将其放入 `plugins` 文件夹中","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuf0rce%2Fgithub-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnuf0rce%2Fgithub-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuf0rce%2Fgithub-helper/lists"}