漂流瓶 - 瓶中信message_bottle 💌
写在开头
本项目是astrbot_plugin_drift_bottle的修改版本，区别在下文介绍。为避免歧义，本项目以瓶中信指代漂流瓶。
简介
一款功能丰富的漂流瓶插件，让你在自己的服务器内或跨越服务器的云端海洋中，投递和拾取瓶中信，体验未知的惊喜与相遇。
核心功能
- 🌐 双重模式：支持纯本地的瓶中信和跨服互动的云瓶中信两种玩法。
- ✍️ 内容丰富：瓶中信可以包含文字，还可以附带图片。未来支持更多形式，让分享更加生动。
- 📤 投瓶与拾瓶：轻松扔出自己的瓶中信，或随机捡起一个来自他人的瓶子。
- 📊 数据统计：随时查看当前海域（本地及云端）中未被捡起的瓶中信数量，以及自己捡到的瓶子总数。
- 📖 历史追溯：可以查看自己捡到过的所有瓶中信，通过编号精确查找。
- 🚫 内容审核：支持内容审核，确保瓶中信内容符合社区规范。
指令说明
所有指令均通过斜杠 (/) 触发。
| 指令 | 功能描述 |
|---|---|
| 本地瓶中信 | |
/扔瓶中信 [内容] |
扔出一个 本地 瓶中信，仅在当前服务器内可被捡到。 |
/捡瓶中信 |
随机捡一个 本地 海域中的瓶中信。 |
| 云端瓶中信 | |
/扔云瓶中信 [内容] |
扔出一个 云端 瓶中信，可被其他接入云服务的社区用户捡到。 |
/捡云瓶中信 |
随机捡一个来自 云端 的瓶中信，开启跨服奇遇。 |
| 通用指令 | |
/未被捡起的瓶中信 |
查看当前本地和云端海域中瓶中信的总数，以及自己捡到的数量。 |
/被捡起的瓶中信 [编号] |
查看一个你已捡到的瓶中信。若提供编号，则精确查找；若不提供，则随机展示一个。 |
/被捡起的瓶中信列表 |
列出你捡到的所有瓶中信的历史记录。 |
| 选项 | |
-p |
扔瓶中信时携带戳一戳(仅qq)，如 /扔云瓶中信 [内容] -p |
⚙️ 配置选项
插件支持通过配置文件进行自定义，以下是可配置项说明：
| 配置项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
max_text_length |
int |
500 |
瓶中信允许发送的文字内容最大长度。 |
max_images |
int |
1 |
每个瓶中信允许附带的最大图片数量。 |
api_base_url |
string |
安装插件后可见 | 用于云瓶中信功能的API服务器地址。 |
提示
- 云瓶中信功能依赖于外部API服务器，如果API服务器无法访问，将无法使用云瓶中信功能。
- 如果您只期望瓶中信在自己的bot内共享，那么仅使用本地瓶中信功能可能已经足够，但仍然强烈建议您使用云瓶中信功能（更健全的检索和存储机制）。
- API服务器默认为本人提供的接口，以期为用户提供便利并实现广泛的互通。
- 如需要使用自己的API服务器，请参考 API 服务器 部分，并修改配置文件中的
api_base_url。这适用于为多个不同服务器下的bot提供数据互通。
更新日志
v1.1.2
- 瓶中信支持携带戳一戳信息
v1.1.0
- 添加了对云瓶中信的审核功能，如有需要，可在插件配置中开启。
app_id,api_key,secret_key引用自astrbot的"配置文件-百度内容审核配置"，故需在该处进行配置(两个启用审核的开关是独立的，瓶中信的配置项仅对瓶中信插件生效)。
❤️ 作者与支持
- 作者: @Flartiny
- 致谢: 本项目由@wuyan1003的漂流瓶插件fork而来，进行了本体的重构并改变了上游服务器的实现。