注意：该插件为 早柚核心（GsCore / gsuid_core） 的扩展插件，使用前请确保 GsCore 已正确安装。
运行环境要求 Python
3.12+。插件依赖写在
pyproject.toml中，新版 GsCore 会自动检查并安装。
将插件克隆到 GsCore 插件目录，然后重启 Core：
cd gsuid_core/gsuid_core/plugins
git clone https://github.com/MimoKit/PhoebeHubUID.git PhoebeHubUID如果依赖没有自动安装，可在 GsCore 使用的 Python 环境中手动执行：
pip install "httpx>=0.28.1" "jieba>=0.42.1" "pillow>=10.0" "rapidfuzz>=3.0.0" "zhconv>=1.4.3"- 随机获取一张菲比（Phoebe）表情包
- 根据标题、描述和同义词进行模糊搜索
- 单次搜索默认返回 3 张，最多返回 10 张
- 表情包数据与图片本地缓存，减少重复网络请求
- 支持 HTTP 代理和缓存清理时间配置
- 接入 GsCore
to_ai，允许 AI 调用随机及搜索功能 - 注册到 GsCore 插件帮助一览
| 命令 | 说明 |
|---|---|
啾比 |
随机发送一张菲比表情包 |
来点菲比 |
啾比 的别名 |
菲比表情包 |
啾比 的别名 |
搜比 <关键词> [数量] |
模糊搜索菲比表情包，默认 3 张，最多 10 张 |
搜索菲比 <关键词> [数量] |
搜比 的别名 |
啾比帮助 |
查看插件使用帮助 |
示例：
啾比
搜比 开心
搜比 吃瓜 5
搜索菲比 无语 3
啾比帮助
所有命令默认无需插件前缀，直接发送即可。
配置项可在 GsCore WebConsole 的 PhoebeHubUID 配置页修改：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 数据缓存秒数 | 300 |
memes.json 的内存缓存时间，设为 0 表示每次刷新 |
| 随机触发词 | 啾比 等 |
可自定义随机表情包的精确触发词 |
| HTTP 代理 | 空 | 下载数据和图片时使用的代理地址 |
| 图片缓存小时 | 24 |
超时后自动清理图片缓存，设为 0 表示不清理 |
| 搜索算法 | v1 |
v1 偏高召回，v2 偏高区分度 |
| 启用 AI 工具 | 开启 | 允许 GsCore AI 调用随机及搜索功能 |
配置中的 GitHub Token 与 Fork 所有者字段为后续投稿工作流预留；当前版本未开放表情包上传、修改、删除和自动提交 PR 命令。
运行时数据统一保存在 GsCore 数据目录：
data/PhoebeHubUID/
├── cache/
│ └── images/
└── memes.json
插件代码目录不会写入运行时缓存，更新或重新安装插件不会主动删除已有缓存。
提示“暂时没有表情包”：检查服务器是否可以访问 GitHub Raw，必要时在控制台填写 HTTP 代理。
搜索没有结果：尝试简化关键词，或切换 v1 / v2 搜索算法。
图片下载失败：检查网络、代理配置和 GsCore 日志；缓存损坏时可清理 data/PhoebeHubUID/cache/images/ 后重试。
依赖安装失败：确认 GsCore 使用 Python 3.12+，并在同一个虚拟环境中手动安装依赖。
PhoebeHubUID/
├── __init__.py
├── __nest__.py
├── pyproject.toml
├── README.md
├── ICON.png
├── meme_synonyms.json
└── PhoebeHubUID/
├── __init__.py
├── __full__.py
├── version.py
├── phoebehub_main/
├── phoebehub_help/
├── phoebehub_config/
└── utils/
- 本项目由 timetetng/astrbot_plugin_phoebehub 移植到 GsCore
- 表情包数据来源：Kato-Shoko705/Phoebe-Hub
- 本项目沿用原插件的 MIT License，分发时请保留原版权与许可证声明
- 本项目仅供学习与交流使用，请遵守上游项目及素材来源的使用约定
- MIT License
- timetetng — AstrBot 原插件作者
- Kato-Shoko705 — Phoebe-Hub 数据与素材维护
- gsuid_core — GsCore 框架