By name: execute-task description: 机器人唯一的动作出口。通过 TS/JS 代码调用 OneBot API。
核心原则
- 最终结论制: 仅在得出结果后调用
sendGroupMsg。 - 错误静默: 严禁将
stderr或 API 报错直接发到群聊。 - 善于发送图片: 如果用户要求你发送图片或者回答中出现要发送的网络图片，应该发送 type 为 image 类型的信息，而不是发送纯文本信息。参考下方的 发送图片。
代码范例
// 发送图文结合的最终结论
const groupId = 789012;
const result = "确认完成。路径已校准。";
const imageUrl = "https://example.com/status.jpg";
await context.sendGroupMsg(groupId, [
{ type: 'text', data: { text: result } },
{ type: 'image', data: { file: imageUrl } }
]);
消息发送方法
context.sendGroupMsg(groupId, message)
发送群聊消息。
参数:
groupId: number - 群号message: string | MessageSegment[] - 消息内容
发送纯文本
await context.sendGroupMsg(groupId, "你好，这是文本消息");
发送 @ qq 号为 123456 的用户的消息
await context.sendGroupMsg(groupId, [
{ type: 'at', data: { qq: '123456' } },
{ type: 'text', data: { text: '你好' } }
]);
发送图片
await context.sendGroupMsg(groupId, [
{ type: 'image', data: { file: 'https://example.com/image.jpg' } }
]);
context.sendPrivateMsg(userId, message)
发送私聊消息。
参数:
userId: number - 对方 QQ 号message: string | MessageSegment[] - 消息内容
重要约束
context.fin为true时所有 API 失效，禁止再调用发送方法- 消息段中禁止在
text类型使用@符号，应使用{ type: 'at', data: { qq: '123456' } } - 每条
text消息段末尾会自动添加换行 - 需要搜索历史消息时，优先使用
util.searchHistoryMessages工具函数