entari-plugin-hyw 3.3.0

Use large language models to interpret chat messages

Entari Plugin HYW

Entari 智能聊天解释插件

IM 环境下的 LLM 智能解释方案

v3.3 迎来大幅度改动、现在图文不符

🎑 效果展示

✨ 功能特性

• 关于搜索：一次性触发 Bing 网页与图片搜索，组合结果后再回应。
• 给予 Alconna 与 MessageChain 混合处理, 深度优化触发体验。
• 网页获取：使用 Playwright 进行实时页面获取。
• 多模态理解：支持图片视觉分析。
• 上下文感知：维护对话历史记录，支持连续的多轮对话。
• reaction 表情, 表示任务开始。
• OneBot 优化：针对 OneBot 11 协议深度优化，支持解析 JSON 卡片、引用消息等特殊元素。

📦 安装

基础安装

pip install entari-plugin-hyw

搜索

默认通过 HTTP 请求搜索引擎（DuckDuckGo，可在配置中自定义完整搜索链接，如 https://duckduckgo.com/?q={query}）。

⚙️ 配置

请在 entari.yml 中添加以下配置：

plugins:
  entari_plugin_hyw:
    # --- 基础设置 ---
    # 触发机器人的命令列表
    command_name_list: ["zssm", "hyw"]
    
    # 主 LLM 模型配置（必需）, 如 x-ai/grok-4.1-fast:online、perplexity/sonar
    model_name: "gx-ai/grok-4.1-fast:free"
    api_key: "your-api-key"

    # 默认 https://openrouter.ai/api/v1
    base_url: "openai-compatible-url"  
    
    # --- 浏览器与搜索 ---
    headless: true
    
    # --- 视觉配置 (可选) ---
    # 如果未设置，将回退使用主模型
    vision_model_name: "qwen-vl-plus"
    vision_api_key: "your-vision-api-key"
    vision_base_url: "your-vision_base_url"
    
    # --- openai extra_body ---
    extra_body:
      reasoning:
        effort: low
    
    # --- 交互体验 ---
    # 是否开启表情反应 (默认: true)
    reaction: true

    # --- 调试 ---
    save_conversation: false

📖 使用方法

基础指令

使用配置的命令前缀与机器人交互：

hyw 最近LLM有啥新闻, 是不是claude又被秒了
hyw [图片消息] 里面这人写代码怎么我一句都看不懂
hyw https://koishi.chat/ 怎么安装
[回复消息] hyw 
[回复消息<[图片消息]>] hyw -t
[回复消息] hyw 补充: 这个rf的意思是github用户RF-Tar-Railt
[回复消息(hyw插件的输出)] /1 详细点描述
[回复消息(hyw插件的输出>] /那谁有多余解释器?

选项参数

• -t / --text: 强制纯文本模式（跳过图片分析，节省 Token 或时间）。

hyw -t 一大段话。

引用回复

支持引用消息进行追问，机器人会自动读取被引用的消息作为上下文：

• 引用 + 命令：机器人将理解被引用消息的内容（包括图片）通过 MessageChain 操作拼接 Text、Image 与部分 Custom。

UncleCode. (2024). Crawl4AI: Open-source LLM Friendly Web Crawler & Scraper [Computer software]. GitHub. https://github.com/unclecode/crawl4ai