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