平台特性说明
本文档详细介绍了云湖平台的一些特性和限制，帮助开发者更好地理解和使用本适配器。
消息发送限制
语音消息
- 机器人不支持发送语音消息
- 适配器会将
<audio>元素转换为 A2UIAudioPlayer组件
指令触发
- 机器人官网控制台的预设指令必须以
/作为前缀触发 - 所有指令在 Koishi 中配置时也需要包含
/前缀
文件限制
- 图片：最大 10MB
- 视频：最大 20MB
- 其他文件：最大 20MB
- 超限的视频会被自动压缩，但超限的图片和其他文件将无法发送
机器人交互
- 机器人快捷菜单仅有按钮会通过按钮事件下发
- 机器人不会收到其他机器人的消息
- 机器人无法直接发送音频文件，音频通过 A2UI 消息展示
特殊处理
图片资源访问
直接访问云湖的图片 URL 会因为缺少 Referer 请求头而导致 403 Forbidden 错误。
您必须在请求中添加 Referer: https://www.yhchat.com/ 头才能成功获取图片。
视频要求
上传的视频必须包含有效的画面，否则消息可能无法正常显示。
音频处理
由于云湖机器人不支持直接发送音频消息，本适配器会为音频生成 A2UI AudioPlayer 组件。公网地址直接使用，其他来源会先上传并通过媒体代理地址访问。