[Feature] 插件配置项支持折叠:以 template_list 的折叠条目为例,让插件配置不再占满设置页面

オープン
#11,058 コメント 3 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@XTsat がすでに取り組んでいます。

2026年11月9日 から。

  • #11067 @XTsat による — オープン

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
48/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
python

調査の方向性

Start by reading dashboard/src/components/shared/AstrBotConfig.vue and AstrBotConfigV4.vue, then compare how TemplateListEditor.vue folds template entries and displays their summaries. Work out how folding should apply to ordinary plugin configuration groups while preserving the existing core settings behavior; done means users can identify groups from their collapsed summaries and expand them to edit their fields.

索引モデルが issue の本文から書いたものです。

説明

enhancement
功能描述

当前 WebUI 的配置渲染是完全平铺的:

  • 插件配置页(dashboard/src/components/shared/AstrBotConfig.vue):object 类型递归渲染整棵子树,所有字段一行行往下排,没有任何折叠;
  • 核心配置页(AstrBotConfigV4.vue):虽然有左侧导航和分组标题,但分组内部依然全部平铺,只有 collapsed: true 的字段会被塞进统一的「更多配置」开关里(而且插件配置页连这个都没实现);
  • 唯一具备折叠能力的是 template_list 的条目(TemplateListEditor.vue):每条模板条目折叠成一行标题 + display_item 摘要,点开才渲染字段。

结果是:插件越复杂,配置页越长,用户只能靠滚动条盲找,找不到想要改的那一项。

使用场景
  1. 一屏的信息密度:一个含 3 条模板、每条 6 个字段的 template_list,平铺是 18 行表单项,且完全分不清哪一行属于哪个条目;折叠后是 3 行标题(Attribute Name: my-adapter),一眼看清"有几条、分别是什么",需要细节时再展开。
  2. 定位成本:折叠态一屏能看到十几个配置组,平铺态一屏只能看到三五个字段;找配置从"滚动 + 肉眼扫描"变成"看标题 + 点开"。
  3. 折叠标题即摘要:display_item 让用户不展开就知道当前值,折叠不等于信息丢失——这套模式完全可以搬到普通配置分组上。

我用邪道把所有设置都写到模板里面了,可以看到折叠之后整体信息获取能力和修改配置方面都有极大的提升

原先十页的配置可以压缩到两页以内,只需要专注自己需要修改的设置,现在必须现在设置里面一直找到自己要改的类目

(我这个是有几个在下面没有压缩,也就是把主要核心设置不折叠,然后专用一个方向的功能都分别折叠)

Image Image
检查清单
  • 我已在 Issue 列表中搜索过相关功能,确认该功能想法从未被提出过。
  • 我建议的功能与 AstrBot 本体相关,而非在建议某一插件的功能。
  • 我已阅读并同意本项目的贡献者行为准则。
  • (可选)我愿意提交 PR 以帮助实现该功能。
主要言語
Python
スター
46.4k
フォーク
3.4k
平均マージ
1日 11時間
マージ済み PR(30日)
120

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

AstrBotDevs/AstrBot のほかの issue

AstrBotDevs/AstrBot の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。