3. 消息上下文与发送能力

ctx 由框架为每个消息构造（createContext），包含发送能力与机器人信息。

3.1 ctx.sendText(text)

await ctx.sendText('你好！');

内部处理：消息入库 → 调用 iLink 发送 → 更新状态 → 推送 SSE 事件。context_token 过期（-14）时自动从 DB 获取最新入站 token 重试一次。

3.2 ctx.sendMedia(filePath, mediaType, filename?, playtime?)

await ctx.sendMedia('/tmp/photo.jpg', 'image');
await ctx.sendMedia('/tmp/report.pdf', 'file', '报告.pdf');

• sendMedia 不会自动删除临时文件，插件发送后需自行清理（fs.unlinkSync）。
• 不要用 'voice' 类型——微信客户端不渲染语音条、点不开。用 'file' 代替。
• 图片类型会跳过缩略图生成，保持原图质量。

3.3 ctx.bot / ctx.msg

ctx.bot.id              // 机器人 ID
ctx.bot.bot_token       // 机器人 token
ctx.bot.base_url        // iLink 基础地址
ctx.bot.user_id         // 所属账号 ID

ctx.msg.content         // 消息文本（已解密）
ctx.msg.peer_id         // 会话 ID（如 o9cq802Ep_xxxx@im.wechat 或 QQ 群 peer）
ctx.msg.context_token   // 上下文票据（用于回复）
ctx.msg.msg_type        // 消息类型：text/image/voice/video/file
ctx.msg.group_id        // 群 ID（群消息非空，私聊为空）
ctx.msg.user_id         // 发送者用户 ID
ctx.msg.sender_info     // 发送者信息（含昵称等，QQ 群被动识别成员时可用）

3.4 主动调用智能助手做 AI 生成（callAssistant）

插件也能主动调 AI 做文本生成：

const plugins = require('../../lib/plugins');

const reply = await plugins.callAssistant({
  botId: ctx.bot.id,
  userId: ctx.bot.user_id,
  prompt: '把以下数据用口语总结成一段话：\n' + JSON.stringify(rawData),
});

await ctx.sendText(reply);

务必传入 userId，让用量纳入统计，避免被滥用。调用失败会抛 Error，请用 try/catch 包裹。