🔍 智能插件发现

• 🎯 精准搜索：基于 AstrBot_Plugins_Collection 的官方插件数据库
• 🔤 多种标识符：支持插件ID、短名称、完整名称搜索
• 📄 分页浏览：每页显示8个插件，支持翻页浏览
• ⭐ 实时star数：显示最新的GitHub star数量
• 🏷️ 智能排序：按star数量和相关性排序

📦 已安装插件管理

• 🔍 插件清单：查看当前已安装的所有插件及其star状态
• 🔄 智能匹配：自动匹配已安装插件与GitHub插件库
• ☆⭐ 状态显示：实时显示每个插件的star状态
• 📊 分类统计：区分GitHub插件和本地插件
• 📄 分页支持：支持大量插件的分页浏览

🌟 点Star功能

• 🎯 单个点star：支持数字ID、短名称、完整名称点star
• ⚡ 批量点star：一键star所有已安装的GitHub插件
• 🛡️ 防重复检查：自动检测是否已点star，避免重复操作
• 📊 实时反馈：显示当前star数量和操作结果
• 📈 进度显示：批量操作时显示详细进度和统计

1. 获取GitHub Personal Access Token

1. 访问 GitHub Settings > Developer settings > Personal access tokens
2. 点击 "Generate new token (classic)"
3. 选择以下权限：
   • ✅ public_repo - 访问公开仓库
   • ✅ user - 读取用户信息
   • token是会过期的，在选择Expiration（到期时间）时，选择No expiration，token将永久有效
4. 点击最下面绿色按钮“Generate token”，生成我们的token
5. 复制生成的token（形如：ghp_xxxxxxxxxxxx）

（多嘴一句：请保管好自己的token，不要随意告诉他人！）

2. 安装插件

1. 将 github_star_plugin 文件夹复制到AstrBot的插件目录
2. 重启AstrBot或重新加载插件
3. 在插件列表中启用 "GitHub Star Manager"

3. 配置插件

在AstrBot的插件配置页面中设置：

{
  "github_token": "你的GitHub Personal Access Token",
  "github_username": "你的GitHub用户名",
  "allowed_users": "{\"用户QQ号1\": true, \"用户QQ号2\": true}",
  "api_settings": {
    "request_timeout": 15,
    "max_retries": 3,
    "enable_fallback": true
  }
}

💡 提示：如果 allowed_users 为空或 {}，则允许所有用户使用插件

🔍 插件发现命令

📦 已安装插件管理

⭐ 点Star命令

🛠️ 管理工具

搜索插件

用户: /find_plugins 天气

机器人: 🔍 关键词: 天气 - 找到 5 个插件 (第1/1页):

[1] 📦 weather_api
    👤 dev*** | ⭐ 245
    📝 实时天气查询插件，支持多城市天气预报功能，提供详细的气象信息...
    🔗 https://github.com/***/***/...

[15] 📦 weather_forecast
    👤 dev*** | ⭐ 123
    📝 天气预报插件，提供未来7天天气预测，支持降雨概率和温度趋势...
    🔗 https://github.com/***/***/...

💡 使用 /star_plugin <ID或名称> 来给插件点star
💡 示例: /star_plugin 1 或 /star_plugin weather_api

给插件点Star

用户: /star_plugin 1

机器人: ⭐ 正在给 [1] weather_api 点star...
       🌟 成功给 weather_api 点star！
       当前⭐数量: 246

按作者搜索

用户: /find_by_author 木有知

机器人: 🔍 作者 '木有知' 的插件 - 找到 2 个插件 (第1/1页):

[8] 📦 example_plugin
    👤 木有知 | ⭐ 156
    📝 一个示例插件，展示基本的AstrBot插件开发模式...
    🔗 https://github.com/***/***/...

查看已安装插件

用户: /list_installed

机器人: 🔍 正在获取已安装插件列表...
       ⏳ 检查star状态中...
       
       🔍 已安装插件列表 - 共21个插件 (第1/3页):
       
       📊 分类统计: GitHub插件 18个 | 本地插件 3个
       
       [504] 📦 astrbot_plugin_buckshot_roulette ☆
           👤 w33d | 🏷️ v1.1.1
           🔗 https://github.com/Last-emo-boy/astrbot_plugin_buckshot_roulette
       
       [492] 📦 astrbot_plugin_essential ⭐
           👤 Soulter,FateTrial | 🏷️ v1.1.0
           🔗 https://github.com/Soulter/astrbot_plugin_essential
       
       🔧 my_local_plugin (本地插件)
           👤 unknown | 🏷️ v1.0.0
       
       📄 第1/3页 | 下一页: /list_installed 2
       
       💡 使用说明:
       • /star_plugin <ID> - 给指定插件点star
       • /starall - 批量star所有GitHub插件
       • ⭐ = 已star | ☆ = 未star | ⚠️ = 无法检查

批量点Star

用户: /starall

机器人: 🌟 开始批量star操作...
       
       扫描已安装插件: 21个
       匹配到GitHub库: 18个
       跳过本地插件: 3个
       
       检查star状态...
       📊 Star状态检查完成:
       需要star: 12个
       已经star: 6个
       检查失败: 0个
       
       开始批量star操作...
       
       📊 批量star操作完成:
       
       🌟 成功star (12个):
         ✅ astrbot_plugin_buckshot_roulette
         ✅ fishing2.0
         ✅ astrbot_plugin_knowledge_base
         ✅ meme_manager
         ✅ astrbot_plugin_pokepro
         ✅ favorpro
         ...（还有6个）
       
       📈 汇总统计:
       ✅ 成功: 12个
       ❌ 失败: 0个
       ⏭️ 跳过: 6个 (已star)
       ⚠️ 忽略: 0个 (检查失败)
       🔧 本地插件: 3个 (无GitHub仓库)
       
       🎉 感谢您为12个AstrBot插件点star！

网络测试

用户: /test_network

机器人: 🔍 测试GitHub API连通性...
       📊 网络连通性测试结果:
       ✅ api.github.com (245ms)
       🚀 GitHub API连通正常: 245ms

使用方式

• /star_plugin 1 - 使用数字ID
• /star_plugin weather_api - 使用短名称
• /star_plugin astrbot_plugin_weather_api - 使用完整名称

API设置优化

{
  "api_settings": {
    "request_timeout": 30,     // 请求超时时间（秒）
    "max_retries": 3,          // 最大重试次数
    "enable_fallback": true    // 启用API端点故障转移
  }
}

常见问题

1. "GitHub token无效或已过期"

• ✅ 检查token是否正确复制（不要包含空格）
• ✅ 确认token具有 public_repo 权限
• ✅ 检查token是否已过期
• ✅ 使用 /debug_config 检查配置状态

2. "插件未正确初始化"

• ✅ 检查GitHub token配置
• ✅ 使用 /test_network 测试网络连接
• ✅ 使用 /update_plugins 手动更新插件数据

3. "未找到插件"

• ✅ 使用 /find_plugins 浏览所有可用插件
• ✅ 尝试使用插件的短名称或完整名称
• ✅ 检查插件是否在 AstrBot插件集合 中

4. "权限不足"

• ✅ 检查 allowed_users 配置格式
• ✅ 确认用户QQ号在白名单中
• ✅ 使用 /debug_config 查看权限状态

5. "插件显示⚠️无法检查star状态"

• ✅ 检查网络连接和GitHub API访问
• ✅ 确认GitHub token权限充足
• ✅ 使用 /test_network 验证GitHub API连通性

调试工具

# 查看配置状态
/debug_config

# 测试网络连通性
/test_network

• ⚡ 高性能搜索：基于内存的快速模糊匹配
• 🔄 智能缓存：插件数据库1小时自动缓存
• 📡 实时更新：搜索时自动更新前10个插件的star数
• 🌐 网络优化：多端点故障转移和重试机制
• 📈 可扩展性：支持大量插件数据的高效处理
• 🔍 智能匹配：已安装插件与GitHub库的多层匹配算法

• 数据源：AstrBot_Plugins_Collection 官方插件数据库
• API：GitHub REST API v3
• 缓存：内存缓存 + TTL机制
• 搜索：加权模糊匹配算法
• 网络：aiohttp异步HTTP客户端
• 插件管理：基于AstrBot的context.get_all_stars() API

v1.1.0 (2025-9-16) - 重大更新版本

🌟 新增功能特性

• ✨ /list_installed 命令：查看所有已安装插件

  • 📊 智能分类显示：GitHub插件 vs 本地插件
  • ⭐ 实时star状态：⭐(已star) | ☆(未star) | ⚠️(无法检查)
  • 📄 支持分页浏览：/list_installed <页码>
  • 🆔 统一ID系统：与其他命令保持ID一致性

• ✨ /starall 批量star命令：一键star所有GitHub插件

  • 🔍 自动检测已安装的GitHub插件
  • 📈 智能跳过已star和检查失败的插件
  • 🚀 静默执行，避免刷屏消息（用户体验优化）
  • 📊 详细统计报告：成功/失败/跳过数量及详细列表

🧠 智能化改进

• ✨ 智能插件匹配算法：
  • 🔗 仓库地址精确匹配
  • 📝 插件名称智能匹配
  • 👤 作者+插件名组合匹配
  • 🔄 使用context.get_all_stars() API获取已安装插件

🐛 重要问题修复

• 🐛 Star状态显示修复：修复所有插件显示"⚠️无法检查"的关键bug
  • 🔧 正确处理NotStarredError异常，现在显示☆(未star)而非⚠️
  • 🔧 区分"仓库不存在"和"仓库存在但未star"两种情况
• 🐛 GitHub API超时修复：解决部分仓库检查超时问题
  • ⏱️ 默认超时时间：15秒 → 30秒
  • 🌐 提升网络兼容性，减少超时错误

🎯 用户体验优化

• 🔧 批量star操作体验升级：
  • ❌ 修改前：20条刷屏消息 [1/10] 🌟 正在star... [1/10] ✅ 成功...
  • ✅ 修改后：3条消息，最后统一展示成功/失败列表
• 🔧 ID系统统一：确保/list_installed、/star_plugin等命令使用相同ID
• 🔧 API保护：批量操作时添加0.5秒延迟，防止GitHub API限流

v1.0.0 (初始版本)

• ✨ 新增插件ID系统，支持数字ID快速操作
• ✨ 新增分页浏览功能，优化大量插件展示
• ✨ 新增实时star数更新，显示最新数据
• ✨ 新增按作者搜索功能
• 🔧 优化代码结构，统一显示格式
• 🐛 修复点star状态码判断问题
• 🐛 修复作者搜索ID同步问题
• ⚡ 性能优化，提升搜索和显示速度