Skip to content

docs: 帮助图 slogan + README 命令一览 + KB 别名,并补 2.0.3 反代变更#78

Merged
FlanChanXwO merged 1 commit into
devfrom
docs/help-image-slogan-and-kb-aliases
Jun 1, 2026
Merged

docs: 帮助图 slogan + README 命令一览 + KB 别名,并补 2.0.3 反代变更#78
FlanChanXwO merged 1 commit into
devfrom
docs/help-image-slogan-and-kb-aliases

Conversation

@FlanChanXwO
Copy link
Copy Markdown
Owner

@FlanChanXwO FlanChanXwO commented Jun 1, 2026

整理帮助图与文档,并补全 2.0.3 发版说明,让 release 内容反映媒体反代等变更。

Modifications / 改动点

  • 帮助图scripts/template/rsshelp_template.html 副标题改为 Everything is RSSable(RSSHub 官方 slogan),并用 scripts/gen_rsshelp.sh 重新生成 assets/help/rsshelp_light.pngrsshelp_dark.png

  • README.md:顶部新增 Last Commit 徽章;新增「命令一览」段,直接贴出帮助图。

  • docs/usage/commands.md:补全 RSSHub Routes 知识库命令(/rsshub_kb_init / _sync / _status / _task)的中文别名,与代码入口一致。

  • CHANGELOG.md(2.0.3):补记本次发版包含的两项媒体能力——

    • 媒体反代 media.image_relay_base_url / media.media_relay_base_url(图片优先图片反代、非图片走通用反代、先反代再回源、缓存键与失败链接保持原始 URL)。
    • 无声视频转 GIF 的体积上限压缩。
      这样 release notes 能正确反映这些变更。
  • This is NOT a breaking change. / 这不是一个破坏性变更。

Screenshots or Test Results / 运行截图或测试结果

纯文档/帮助图改动,无代码逻辑变更。帮助图由仓库脚本生成:

$ ./scripts/gen_rsshelp.sh   # 生成 rsshelp_light.png / rsshelp_dark.png

帮助图顶部副标题已渲染为 Everything is RSSable

Checklist / 检查清单

  • 😊 If there are new features added in the PR, I have discussed them with the authors through issues/emails, etc. / 如果 PR 中有新加入的功能,已经通过 Issue / 邮件等方式和作者讨论过。
  • 👀 My changes have been well-tested, and "Verification Steps" and "Screenshots" have been provided above. / 我的更改经过了良好的测试,并已在上方提供了"验证步骤"和"运行截图"
  • 🤓 I have ensured that no new dependencies are introduced. / 我确保没有引入新依赖库。
  • 😮 My changes do not introduce malicious code. / 我的更改没有引入恶意代码。

Summary by Sourcery

更新文档、帮助资源和发行说明,以反映当前的命令以及新增加的媒体处理能力。

新功能:

  • 记录新增加的媒体中继(media relay)配置选项和行为,包括图片和通用媒体的代理处理。
  • 在 2.0.3 版本中记录针对静音视频转换的新 GIF 尺寸限制处理。

增强:

  • 在 README 中添加 “Last Commit” 徽章和内嵌的命令总览帮助图片,以便更快速地发现项目和命令。
  • 将帮助图片的副标题更新为官方的 RSSHub 标语,以保持品牌一致性。
  • 为 RSSHub Routes 知识库命令添加中文别名,使文档与现有的命令入口保持一致。

文档:

  • 扩展 README,加入可视化命令总览和仓库活动徽章。
  • 使命令文档与 RSSHub 知识库命令实际可用的别名保持一致。
  • 在 2.0.3 的更新日志中澄清媒体代理和 GIF 压缩相关行为的变更。
Original summary in English

Summary by Sourcery

Update documentation, help assets, and release notes to reflect current commands and newly added media handling capabilities.

New Features:

  • Document newly added media relay configuration options and behavior, including image and general media proxying.
  • Document new GIF size limit handling for silent video conversions in the 2.0.3 release.

Enhancements:

  • Add a Last Commit badge and an inline command overview help image to the README for quicker project and command discovery.
  • Update the help image subtitle to use the official RSSHub slogan for consistent branding.
  • Add Chinese aliases for RSSHub Routes knowledge base commands to align documentation with existing command entry points.

Documentation:

  • Expand the README with a visual command overview and repository activity badge.
  • Align command documentation with actual available aliases for RSSHub knowledge base commands.
  • Clarify 2.0.3 changelog to include media proxy and GIF compression behavior changes.

- 帮助图副标题改为 "Everything is RSSable",并重新生成 light/dark 帮助图。
- README 顶部加 Last Commit 徽章,新增「命令一览」段贴帮助图。
- docs/usage/commands.md 补全 RSSHub Routes 知识库命令的中文别名。
- CHANGELOG 2.0.3 补记媒体反代(image/media relay,先反代再回源、缓存键保持原始
  URL)与无声视频转 GIF 体积上限压缩,刷新发版内容。
Copilot AI review requested due to automatic review settings June 1, 2026 00:36
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 1, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 32505447-5a29-40b8-ac57-96f49120846e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions github-actions Bot added area: docs Documentation changes release Release metadata or changelog changes labels Jun 1, 2026
@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented Jun 1, 2026

审阅者指南(在小型 PR 上折叠)

审阅者指南

此 PR 刷新了用户可见的文档和帮助资源(帮助图片、README、命令文档、更新日志),以确保命令、KB 别名以及与媒体相关的发布说明是准确的,并与当前行为保持一致,同时不修改任何运行时逻辑。

2.0.3 版本 CHANGELOG 中记录的媒体转发行为流程图

flowchart TD
    A[Original_media_url] --> B[Check_content_type]
    B -->|is_image| C[Proxy_via_media.image_relay_base_url]
    B -->|not_image| D[Proxy_via_media.media_relay_base_url]
    C --> E[Download_via_relay_then_origin]
    D --> E
    E --> F[Cache_with_original_URL_as_key]
    F --> G[Serve_media_or_failure_link_with_original_URL]
Loading

文件级变更

变更 详情 文件
将 RSS 帮助图片的副标题更新为官方 RSSHub 标语,并基于模板重新生成浅色/深色帮助 PNG。
  • 把帮助图片模板中的 HTML 模板副标题文本改为 Everything is RSSable
  • 使用现有生成脚本重新生成 rsshelp_light.pngrsshelp_dark.png,确保渲染出的帮助图片与新的副标题和当前命令一致。
scripts/template/rsshelp_template.html
assets/help/rsshelp_light.png
assets/help/rsshelp_dark.png
在 README 中更显著地暴露帮助/命令信息,包括仓库活动情况。
  • 在顶部徽章附近添加一个 GitHub Last Commit 徽章,用于显示仓库的活跃情况。
  • 添加一个“命令一览”章节,通过 raw.githubusercontent.com 链接内联浅色主题帮助图片,让用户可以快速查看支持的命令。
README.md
使文档中的 RSSHub Routes KB 命令与代码中使用的中文别名保持一致。
  • 为 KB 初始化命令 /rsshub_kb_init 添加中文别名。
  • 为 KB 同步命令 /rsshub_kb_sync 添加中文别名。
  • 为 KB 状态命令 /rsshub_kb_status 添加中文别名。
  • 为 KB 最近任务命令 /rsshub_kb_task 添加中文别名。
docs/usage/commands.md
为 2.0.3 更新日志补充媒体转发和 GIF 压缩行为,使发布说明与实际功能一致。
  • 记录新的媒体转发配置键和行为:media.image_relay_base_urlmedia.media_relay_base_url,包括路由逻辑(图片 vs 通用媒体)、回退到源站、缓存键/原始 URL 行为,并明确提到 wsrv.nl 的使用方式。
  • 记录新的静音视频转 GIF 的大小限制压缩行为(为满足平台大小限制而逐步降低分辨率和帧率)。
CHANGELOG.md

技巧与命令

与 Sourcery 交互

  • 触发新的审阅: 在 pull request 中评论 @sourcery-ai review
  • 继续讨论: 直接回复 Sourcery 的审阅评论。
  • 从审阅评论生成 GitHub issue: 通过回复某条审阅评论,让 Sourcery 从该评论创建一个 issue。你也可以在审阅评论中回复 @sourcery-ai issue 来从它创建 issue。
  • 生成 pull request 标题: 在 pull request 标题中任意位置写上 @sourcery-ai,即可随时生成标题。你也可以在 pull request 中评论 @sourcery-ai title,以随时(重新)生成标题。
  • 生成 pull request 摘要: 在 pull request 正文任意位置写上 @sourcery-ai summary,即可在你想要的位置生成 PR 摘要。你也可以在 pull request 中评论 @sourcery-ai summary,以随时(重新)生成摘要。
  • 生成审阅者指南: 在 pull request 中评论 @sourcery-ai guide,即可随时(重新)生成审阅者指南。
  • 解决所有 Sourcery 评论: 在 pull request 中评论 @sourcery-ai resolve,即可解决所有 Sourcery 评论。如果你已经处理完所有评论且不想再看到它们,这会很有帮助。
  • 忽略所有 Sourcery 审阅: 在 pull request 中评论 @sourcery-ai dismiss,即可忽略所有现有的 Sourcery 审阅。特别适合在你想以一次全新的审阅重新开始时使用——别忘了再评论 @sourcery-ai review 以触发新的审阅!

自定义你的体验

打开你的控制面板 可以:

  • 启用或禁用诸如 Sourcery 生成的 pull request 摘要、审阅者指南等审阅功能。
  • 更改审阅语言。
  • 添加、移除或编辑自定义审阅指令。
  • 调整其他审阅设置。

获取帮助

Original review guide in English
Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

This PR refreshes user-facing documentation and help assets (help image, README, commands doc, changelog) so that commands, KB aliases, and media-related release notes are accurate and aligned with current behavior, without changing any runtime logic.

Flow diagram for media relay behavior documented in 2.0.3 CHANGELOG

flowchart TD
    A[Original_media_url] --> B[Check_content_type]
    B -->|is_image| C[Proxy_via_media.image_relay_base_url]
    B -->|not_image| D[Proxy_via_media.media_relay_base_url]
    C --> E[Download_via_relay_then_origin]
    D --> E
    E --> F[Cache_with_original_URL_as_key]
    F --> G[Serve_media_or_failure_link_with_original_URL]
Loading

File-Level Changes

Change Details Files
Update the RSS help image subtitle to the official RSSHub slogan and regenerate the light/dark help PNGs from the template.
  • Change the HTML template subtitle text in the help image template to Everything is RSSable.
  • Regenerate rsshelp_light.png and rsshelp_dark.png using the existing generation script so the rendered help images match the new subtitle and current commands.
scripts/template/rsshelp_template.html
assets/help/rsshelp_light.png
assets/help/rsshelp_dark.png
Expose help/commands more prominently in the README, including repository activity.
  • Add a GitHub Last Commit badge near the top badges to show repository activity.
  • Add a "命令一览" section that inlines the light-theme help image via a raw.githubusercontent.com URL so users can quickly see supported commands.
README.md
Align documented RSSHub Routes KB commands with their Chinese aliases used in code.
  • Add Chinese aliases for the KB init command /rsshub_kb_init.
  • Add Chinese aliases for the KB sync command /rsshub_kb_sync.
  • Add Chinese aliases for the KB status command /rsshub_kb_status.
  • Add Chinese aliases for the KB last-task command /rsshub_kb_task.
docs/usage/commands.md
Backfill 2.0.3 changelog with media relay and GIF compression behavior so release notes match actual features.
  • Document the new media relay configuration keys and behavior: media.image_relay_base_url and media.media_relay_base_url, including routing logic (images vs generic media), fallback to origin, and cache key/original URL behavior, with explicit mention of wsrv.nl usage patterns.
  • Document the new silent-video-to-GIF size-limit compression behavior (progressive downscaling of resolution and frame rate to fit platform size limits).
CHANGELOG.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - 我提供了一些总体反馈:

  • README 中的 Last Commit 徽章和命令概览图片都将分支名硬编码为 master;建议使用对默认分支不敏感的徽章配置,以及相对图片路径(或与分支无关的 URL),以便在默认分支发生变化或在 fork 仓库中时,这些内容仍能正常工作。
给 AI Agent 的提示
Please address the comments from this code review:

## Overall Comments
- The README’s Last Commit badge and the command overview image both hardcode the `master` branch; consider using a default-branch-insensitive badge configuration and a relative image path (or a branch-agnostic URL) so they keep working if the default branch changes or in forks.

Sourcery 对开源项目永久免费——如果你觉得我们的评审有帮助,欢迎分享 ✨
帮我变得更有用!请在每条评论上点 👍 或 👎,我会根据反馈改进之后的评审。
Original comment in English

Hey - I've left some high level feedback:

  • The README’s Last Commit badge and the command overview image both hardcode the master branch; consider using a default-branch-insensitive badge configuration and a relative image path (or a branch-agnostic URL) so they keep working if the default branch changes or in forks.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The README’s Last Commit badge and the command overview image both hardcode the `master` branch; consider using a default-branch-insensitive badge configuration and a relative image path (or a branch-agnostic URL) so they keep working if the default branch changes or in forks.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation-only PR that updates the help image subtitle, README, command aliases doc, and changelog entries for 2.0.3.

Changes:

  • Update help template subtitle to "Everything is RSSable" and add README badge + command overview image.
  • Document Chinese aliases for /rsshub_kb_* commands.
  • Add 2.0.3 changelog entries for media relay and GIF size-limit compression.

Reviewed changes

Copilot reviewed 4 out of 6 changed files in this pull request and generated no comments.

File Description
scripts/template/rsshelp_template.html Change help image subtitle to RSSHub slogan.
README.md Add Last Commit badge and inline command overview image.
docs/usage/commands.md Fill in Chinese aliases for KB commands.
CHANGELOG.md Add 2.0.3 entries for media relay and GIF size compression.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@FlanChanXwO FlanChanXwO merged commit 1442f7c into dev Jun 1, 2026
5 of 6 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in astrbot_plugin_rsshub Jun 1, 2026
@FlanChanXwO FlanChanXwO deleted the docs/help-image-slogan-and-kb-aliases branch June 1, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Documentation changes release Release metadata or changelog changes

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants