[Feature] 为插件注册的平台适配器提供可扩展的引导式接入流程

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

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

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
12/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
活発
技術スタック
python
領域
backend, frontend

調査の方向性

The issue names no files or entry points. It asks for a declarative onboarding contract for platform adapters, both built-in and plugin, shown on the bot management page. Start by finding how adapters are registered today and what config template and form metadata they expose. Done means maintainers agree on the step and state contract in the issue thread. Implementation is not yet a first-timer task.

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

説明

enhancement
功能描述

希望本体为内置及插件注册的平台适配器提供统一的引导式接入流程扩展机制,使适配器能够在“机器人”页面提供创建、绑定、初始化和重新授权等交互式接入能力,而不仅限于静态配置表单。

目前适配器注册接口主要描述配置模板和表单元数据,较复杂的接入流程需要本体针对平台分别实现。插件适配器无法通过标准扩展点接入原生页面,只能要求用户跳转到独立插件页面,或者手动整理并填写凭据。

建议将接入过程抽象为声明式、可推进的标准流程:适配器描述所需步骤与输入,负责平台侧交互并返回标准状态及配置结果;本体统一负责流程发现、页面展示、状态推进、取消/失败/过期处理以及最终配置保存。该机制不应绑定某一平台或某种授权方式,也不要求插件注入前端代码。

使用场景

不同平台的接入过程可能包含扫码确认、设备码授权、OAuth、应用自动创建、账号配对、凭据交换、连接验证或多个连续步骤。这些流程虽然平台实现不同,但具有相同的启动、等待、完成、失败、取消和配置回填生命周期。

统一扩展后,内置和插件适配器均可按照同一契约提供引导式接入,用户能够在“机器人”页面完成从创建到生成可用配置的全过程;本体可以减少平台专属分支,插件也无需为接入环节重复建设独立管理页面。未声明扩展流程的适配器继续使用现有静态表单,保持兼容。

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

環境構築

はじめの一歩

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

AstrBotDevs/AstrBot のほかの issue

AstrBotDevs/AstrBot の issue をすべて見る

似ている issue

Python の issue をもっと見る

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

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