{"id":38600650,"url":"https://github.com/gnuf0rce/rss-helper","last_synced_at":"2026-01-17T08:33:20.328Z","repository":{"id":40632172,"uuid":"314775897","full_name":"gnuf0rce/rss-helper","owner":"gnuf0rce","description":"mirai-console 插件开发计划","archived":false,"fork":false,"pushed_at":"2024-03-09T00:56:06.000Z","size":310,"stargazers_count":47,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-04-16T11:07:55.265Z","etag":null,"topics":["qqbot","rss"],"latest_commit_sha":null,"homepage":"https://github.com/orgs/gnuf0rce/projects/1","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":"CHANGELOG.md","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}},"created_at":"2020-11-21T09:26:26.000Z","updated_at":"2024-04-16T11:07:55.266Z","dependencies_parsed_at":"2023-02-09T22:07:39.829Z","dependency_job_id":"2d311fef-0993-47fc-a7a4-3e553d7bc48a","html_url":"https://github.com/gnuf0rce/rss-helper","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/gnuf0rce/rss-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Frss-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Frss-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Frss-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Frss-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnuf0rce","download_url":"https://codeload.github.com/gnuf0rce/rss-helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnuf0rce%2Frss-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28504364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: 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":["qqbot","rss"],"created_at":"2026-01-17T08:33:19.682Z","updated_at":"2026-01-17T08:33:20.320Z","avatar_url":"https://github.com/gnuf0rce.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Rss Helper](https://github.com/gnuf0rce/rss-helper)\n\n\u003e 基于 [Mirai Console](https://github.com/mamoe/mirai-console) 的RSS订阅插件\n\n[![Release](https://img.shields.io/github/v/release/gnuf0rce/rss-helper)](https://github.com/gnuf0rce/rss-helper/releases)\n[![Downloads](https://img.shields.io/github/downloads/gnuf0rce/rss-helper/total)](https://shields.io/category/downloads)\n[![MiraiForum](https://img.shields.io/badge/post-on%20MiraiForum-yellow)](https://mirai.mamoe.net/topic/334)\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带括号的`/`前缀是可选的  \n`\u003c...\u003e`中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如 `/rss add https://github.com/cssxsh.atom`  \n`[...]`表示参数，当`[...]`后面带`?`时表示参数可选  \n`{...}`表示连续的多个参数  \n\n本插件指令权限ID 格式为 `io.github.gnuf0rce.rss-helper:command.*`, `*` 是指令的第一指令名  \n例如 `/rss-mirai other` 的权限ID为 `io.github.gnuf0rce.rss-helper:command.rss-mirai`\n\n下列指令的 URL 参数可以使用 base64 编码 后的形式\n\n### RssBaseCommand\n\n| 指令                                   | 描述           |\n|:-------------------------------------|:-------------|\n| `/\u003crss\u003e \u003cadd\u003e [url]`                 | 添加一个订阅       |\n| `/\u003crss\u003e \u003clist\u003e`                      | 列出订阅列表       |\n| `/\u003crss\u003e \u003cinterval\u003e [url] [duration]` | 设置订阅间隔, 单位分钟 |\n| `/\u003crss\u003e \u003cstop\u003e [url]`                | 取消一个订阅       |\n\n### RssGithubCommand\n\n| 指令                                        | 描述             |\n|:------------------------------------------|:---------------|\n| `/\u003crss-github\u003e \u003creleases\u003e [owner] [repo]` | 添加一个Releases订阅 |\n| `/\u003crss-github\u003e \u003ccommits\u003e [owner] [repo]`  | 添加一个Commits订阅  |\n| `/\u003crss-github\u003e \u003ctags\u003e [owner] [repo]`     | 添加一个Tags订阅     |\n| `/\u003crss-github\u003e \u003cactivity\u003e [user]`         | 添加一个Activity订阅 |\n| `/\u003crss-github\u003e \u003cprivate\u003e [user] [secret]` | 添加一个Private订阅  |\n\n### RssMikanCommand\n\n| 指令                                         | 描述              |\n|:-------------------------------------------|:----------------|\n| `/\u003crss-mikan mikan\u003e \u003cmy\u003e [token]`          | 添加一个MyBangumi订阅 |\n| `/\u003crss-mikan mikan\u003e \u003cclassic\u003e`             | 添加一个Classic订阅   |\n| `/\u003crss-mikan mikan\u003e \u003cbangumi\u003e [id] [sub]?` | 添加一个Bangumi订阅   |\n| `/\u003crss-mikan mikan\u003e \u003csearch\u003e [word]`       | 添加一个Search订阅    |\n\n此指令基于 [蜜柑计划](https://mikanani.me/)\n\n### RssMoeCommand\n\n| 指令                           | 描述        |\n|:-----------------------------|:----------|\n| `/\u003crss-moe\u003e \u003crecent\u003e`        | 查看当季番剧TAG |\n| `/\u003crss-moe\u003e \u003csearch\u003e [name]` | 搜索TAG     |\n| `/\u003crss-moe\u003e \u003ctags\u003e {ids}`    | 添加一个Tag订阅 |\n\n此指令基于 [萌番组](https://bangumi.moe/)\n\n### RssTestCommand\n\n| 指令                                     | 描述     |\n|:---------------------------------------|:-------|\n| `/\u003crss-test\u003e \u003cbuild\u003e [url] [forward]?` | 测试一个订阅 |\n| `/\u003crss-test\u003e \u003cssl\u003e`                    | 测试SSL  |\n| `/\u003crss-test\u003e \u003cclear\u003e`                  | 清空种子文件 |\n\n### RssMiraiCommand\n\n| 指令                                      | 描述         |\n|:----------------------------------------|:-----------|\n| `/\u003crss-mirai mirai\u003e \u003ccategory\u003e [value]` | 添加标签订阅     |\n| `/\u003crss-mirai mirai\u003e \u003cplugin\u003e`           | 添加插件发布订阅   |\n| `/\u003crss-mirai mirai\u003e \u003cother\u003e`            | 添加其他项目发布订阅 |\n\n### RssHubCommand\n\n| 指令                        | 描述           |\n|:--------------------------|:-------------|\n| `/\u003crss-hub rsshub\u003e \u003cadd\u003e` | 交互添加RssHub订阅 |\n\n交互过程举例\n\n```text\n1748(1438159989)  23:29:58\n/rsshub add\n\nQQBot(3337342367)  23:30:02\nrequest returned 1899 routes\n\nQQBot(3337342367)  23:30:03\n请输入路由名\n\n1748(1438159989)  23:30:07\n755\n\nQQBot(3337342367)  23:30:07\n(0, /755/user/:username)\n\nQQBot(3337342367)  23:30:08\n/755/user/:username, 输入:username (置空可以输入#)\n\n1748(1438159989)  23:30:21\nakimoto-manatsu\n\nQQBot(3337342367)  23:30:26\n1748  \n/rsshub add\nRSS订阅任务[秋元真夏(乃木坂46) - 755]已添加\n```\n\n配置文件 `RssHubConfig.yml` 可以配置rsshub的域名，即可以配置rsshub的源  \n此配置只对新的rsshub订阅订阅行为有效\n\n## 配置\n\n### RssHubConfig\n\n*   `domain` ~~rsshub 服务器的域名，默认为官方的 rsshub.app~~ 此配置废除\n*   `host` rsshub 服务器，默认为官方的 \u003chttps://rsshub.app:443\u003e\n\n### HttpClientConfig\n\n*   `doh` Dns Over Https Url (为空时关闭Doh，使用系统DNS since 1.0.0-dev-6)\n*   `sni` 需要移除 SNI HostName 的域名的正则表达式列表\n*   `proxy` 代理列表 host: proxy, host=`127.0.0.1`时是全局代理\n*   `ipv6` doh 开启ipv6 支持 (since 1.0.3)\n\n设置默认代理\n```yaml\n# MAP(host, proxy), default by host=127.0.0.1\nproxy: \n  127.0.0.1: 'http://127.0.0.1:8080'\n```\n\n### RssContentConfig\n\n*   `limit` 订阅内容输出到QQ消息的最大长度，超过则只会输出 `内容过长`\n*   `forward` 通过转发消息的形式发送\n\n## TODO\n\n- [ ] 翻译功能\n- [x] 代理支持\n- [x] Doh支持\n- [x] 将Html转化为Mirai的MessageChain(主要目的是显示图片)\n\n## 安装\n\n### MCL 指令安装\n\n`./mcl --update-package io.github.gnuf0rce:rss-helper --channel maven-stable --type plugin`\n\n### 手动安装\n\n1.  从 [Releases](https://github.com/gnuf0rce/rss-helper/releases) 或者 [Maven](https://repo1.maven.org/maven2/io/github/gnuf0rce/rss-helper/) 下载 `mirai2.jar`\n2.  将其放入 `plugins` 文件夹中\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuf0rce%2Frss-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnuf0rce%2Frss-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnuf0rce%2Frss-helper/lists"}