Skip to content

feat(ui): relocate plugin web pages from sidebar to dedicated dashboard panel - #9823

Open
XTsat wants to merge 7 commits into
AstrBotDevs:masterfrom
XTsat:plugin-page-dev
Open

feat(ui): relocate plugin web pages from sidebar to dedicated dashboard panel#9823
XTsat wants to merge 7 commits into
AstrBotDevs:masterfrom
XTsat:plugin-page-dev

Conversation

@XTsat

@XTsat XTsat commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

让插件UI页面更符合面板使用 #9816

Modifications / 改动点

将 Astrbot 的插件 Web 面板从侧边栏中独立出来,新建一个“插件页面”页面

  • This is NOT a breaking change. / 这不是一个破坏性变更。

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

036caeea88c34d7e078215188d4f00cc
PixPin_2026-08-26_18-52-30.mp4

Checklist / 检查清单

  • 😊 If there are new features added in the PR, I have discussed it 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, OR if new dependencies are introduced, they have been added to the appropriate locations in requirements.txt and pyproject.toml.
    / 我确保没有引入新依赖库,或者引入了新依赖库的同时将其添加到 requirements.txtpyproject.toml 文件相应位置。

  • 😮 My changes do not introduce malicious code.
    / 我的更改没有引入恶意代码。

Summary by Sourcery

Move plugin web interfaces into a dedicated, integrated dashboard page with improved navigation and plugin management.

New Features:

  • Add a dedicated plugin pages workspace tab with searchable plugin cards and inline page viewing.
  • Provide navigation between active plugins with web pages, including active-state highlighting, expansion, horizontal scrolling, and browser-tab opening behavior.
  • Support pinning plugin page entries and preserve existing plugin management actions within the new view.

Bug Fixes:

  • Keep plugin web pages within the dashboard workspace instead of opening them through a standalone full-screen route.

Enhancements:

  • Remove dynamic plugin entries from the sidebar and integrate plugin page navigation into the extension workspace.
  • Update extension routing and localized labels for the dedicated plugin pages experience.
  • Adjust workspace layout to support full-height inline plugin pages while retaining dashboard chrome.

Chores:

  • Remove the obsolete plugin sidebar composable and standalone plugin-page route.

@dosubot dosubot Bot added size:XL This PR changes 500-999 lines, ignoring generated files. area:webui The bug / feature is about webui(dashboard) of astrbot. feature:plugin The bug / feature is about AstrBot plugin system. labels Aug 26, 2026

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hey - I've found 2 issues

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="dashboard/src/router/MainRoutes.ts" line_range="93-97" />
<code_context>
           props: { initialTab: 'market' },
           meta: { extensionTab: 'installed', pluginView: 'market' }
         },
+        {
+          name: 'ExtensionPluginPages',
+          path: 'pages/:pluginName?/:pageName?',
+          component: () => import('@/views/ExtensionPage.vue'),
+          props: { initialTab: 'installed' },
+          meta: { extensionTab: 'pluginPages', pluginView: 'pluginPages' }
+        },
         {
           name: 'ExtensionMcp',
</code_context>
<issue_to_address>
**issue (broader_impact):** Existing bookmarks, external links, or plugin-generated links to `/plugin-page/:pluginName/:pageName` now resolve to a 404 because the old route is deleted and no redirect to `ExtensionPluginPages` is registered.

**Triggers:** When a user opens a previously generated or bookmarked standalone plugin-page URL.

**Suggested fix:** Keep a compatibility redirect for `/plugin-page/:pluginName/:pageName` to `ExtensionPluginPages` with the corresponding parameters.
</issue_to_address>

### Comment 2
<location path="dashboard/src/views/ExtensionPage.vue" line_range="192-194" />
<code_context>

+// All installed plugins that ship web pages, listed in the page switcher row.
+const pluginsWithPages = computed(() =>
+  filteredExtensions.value.filter(
+    (plugin) => Array.isArray(plugin?.pages) && plugin.pages.length > 0,
+  ),
+);
+
+const openPluginPage = (plugin) => {
</code_context>
<issue_to_address>
**issue (bug_risk):** The plugin-page switcher includes installed plugins with pages regardless of `plugin.activated`; selecting a disabled plugin navigates to its page and `PluginPagePage` then displays a disabled-plugin error instead of excluding it from the switcher.

**Triggers:** When an installed plugin exposes pages but is disabled.

**Suggested fix:** Filter the switcher list to activated plugins, or disable the corresponding switcher buttons and prevent navigation.

```suggestion
  filteredExtensions.value.filter(
    (plugin) =>
      plugin?.activated &&
      Array.isArray(plugin?.pages) &&
      plugin.pages.length > 0,
  ),
```
</issue_to_address>

Sourcery assessment

Approval pending. 2 findings to address first.

Blocking findings: dashboard/src/router/MainRoutes.ts:97, dashboard/src/views/ExtensionPage.vue:194


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.

Comment thread dashboard/src/router/MainRoutes.ts
Comment thread dashboard/src/views/ExtensionPage.vue Outdated
@XTsat XTsat changed the title Plugin page dev feat(ui): relocate plugin web pages from sidebar to dedicated dashboard panel Aug 27, 2026
@XTsat

XTsat commented Aug 28, 2026

Copy link
Copy Markdown
Contributor Author

针对插件页面的修改已经完成了,可以审阅了

@mantoujun12

Copy link
Copy Markdown
Contributor

有一些建议可以和您说一下:

  1. 如果您最近的改动相比之前上传的 截图 / 视频 差距较大,可以重新修改 PR 的描述内容的。
    比如重新截一张您最近改动的 截图 / 视频 ,替换掉您之前的,这样可以减少维护者对您的 PR 进行代码查阅和测试。

  2. PR 改动点可以稍微说的详细一点,增加您的改动理由,比如:更改后,用户可以更方便的使用插件的管理面板……

  3. 分支尽量规范化命名,bug修复就以 fix/ 开头加上issue编号,功能请求开头就是 feat/ ,比如这个分支名按照规范应为 feat/plugin-page-dev ,除非维护者提及,否则可以不用修改。

  4. 关于 commit 我看了一下,标题不是很规范,有些是中文有些是英文。下次请尽量使用语义化前缀
    比如 fix: , feat: , docs: , style: , refactor: , test: , chore: 然后内容统一英文,不知道 commit 该如何写可以询问 AI

上述均为个人观点,您可以尝试上述提供的方法进行适当修改,或者参考 贡献指南

当前 AstrBot 项目最近在进行 Web UI 相关的重构,所以对于贡献者提出功能相关的拉取请求优先级可能会暂缓
截止 2026/8/31 AstrBot 仍然有 1061 个 Open issues 和 406 个 Open pull request ,所以没注意到是很正常的
而且维护者比较忙,有时候 PR 突然被关闭且没有任何回复也是很正常的,不用太担心。一般可能是您的功能改动不在计划之内,或者是和其它 PR 的改动有冲突等都会有,很正常。

总之,我也只是普通的贡献者,对于您的改动我能理解。但是我没有相关权限,所以请您耐心等候。感谢您对 AstrBot 的支持!

@mantoujun12 mantoujun12 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

帮您稍微看了一下您的改动,个人认为还不错。给一些文件和代码添加了评论。
您可以随时回复我的审阅并把我的子评论标记为“已解决”。

看了一下还完善了 i18n 支持,说明确实用心,可以。

不过正如我之前所说,最近维护者的其它 PRWeb UI 进行了重构,您的 PR 可能会因为这个原因会暂缓,或者直接关闭。这都是很正常的,不用太担心。

虽然作为贡献者可以同意您的修改,不过为了社区公平性,我不会进行 Approve ,即使同意了也需要等待维护者审查您的 PR 并考虑是否需要合并。

目前的情况,您只需要耐心等待即可。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

此文件作用:为 Dashboard 中的“插件页面”提供一个水平可滚动/可展开的切换器,方便在有 Web 页面界面的已激活插件之间快速切换。
这应该是本 PR 中的主要文件

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

因为有了 PluginPagesSwitcher.vue‎ 承担插件面板的显示,所以就不需要这个文件了

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

将插件的 Web Pages 从侧边栏动态条目搬到独立的“插件页面”面板,UI/导航更集中清晰
但是风险有点大,可能会影响原有用户的操作

Comment on lines +59 to +65
{
name: 'ExtensionPluginPages',
path: 'pages/:pluginName?/:pageName?',
component: () => import('@/views/ExtensionPage.vue'),
props: { initialTab: 'installed' },
meta: { extensionTab: 'pluginPages', pluginView: 'pluginPages' }
},

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

这个route应该是导向已安装的插件的 web ui

Comment on lines -162 to +164
name: "PluginPage",
name: "ExtensionPluginPages",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

PluginPage 改为 ExtensionPluginPages ,以对应 MainRoutes.ts 中 R59-R65 的 ExtensionPluginPages

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:webui The bug / feature is about webui(dashboard) of astrbot. feature:plugin The bug / feature is about AstrBot plugin system. size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants