Metadata-Version: 2.4
Name: entari_plugin_hyw
Version: 0.3.5
Summary: Use large language models to interpret chat messages
Author-email: kumoSleeping <zjr2992@outlook.com>
License: MIT
Project-URL: Homepage, https://github.com/kumoSleeping/entari-plugin-hyw
Project-URL: Repository, https://github.com/kumoSleeping/entari-plugin-hyw
Project-URL: Issues, https://github.com/kumoSleeping/entari-plugin-hyw/issues
Keywords: entari,llm,ai,bot,chat
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: arclet-entari[full]>=0.16.5
Requires-Dist: langchain-openai
Requires-Dist: httpx
Requires-Dist: bs4>=0.0.2
Requires-Dist: langchain>=1.0.1
Requires-Dist: langgraph>=1.0.0
Requires-Dist: entari-plugin-server>=0.5.0
Requires-Dist: satori-python-adapter-onebot11>=0.2.5
Requires-Dist: nekobox>=0.1.6
Requires-Dist: ddgs>=9.6.1

# entari-plugin-hyw


![License](https://img.shields.io/badge/License-MIT-green.svg) ![PyPI](https://img.shields.io/badge/PyPI-Available-brightgreen.svg)

**使用大语言模型在聊天环境解释大家的hyw**

### 目前的局限

> 目前仅支持 satori-python-adapter-onebot11 使用此插件, 更多适配请等一会...

> 目前没有考虑 video , 小程序 等复杂消息类型的处理


## 🚀 快速开始

### 安装

```bash
pip install entari-plugin-hyw
```

### 配置

在你的 `entari.yml` 配置文件中根据您的情况添加以下配置：

```yaml
plugins:
  entari_plugin_hyw:
    hyw_command_name: ["/hyw", "hyw"]
    
    # 文本模型配置
    text_llm_model_name: "qwen3-max"
    text_llm_api_key: "your-api-key"
    text_llm_model_base_url: "https://xxx/v1"
    text_llm_enable_search: false
    
    # 视觉模型配置
    vision_llm_model_name: "qwen3-vl-plus"
    vision_llm_api_key: "your-api-key"
    vision_llm_model_base_url: "https://xxx/v1"
    vision_llm_enable_search: false
```

## 📖 使用方法

```
hyw 什么是人工智能？
hyw [图片]
```


```
[引用消息[图片, 文字]] hyw
[引用消息[图片, 文字]] [At] hyw 什么是人工智能？ [图片]
```

> 自动屏蔽 At 元素

## ⚙️ 配置参数

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `hyw_command_name` | `str \| List[str]` | `"hyw"` | 触发命令名称 |
| `text_llm_model_name` | `str` | - | 文本模型名称 |
| `text_llm_api_key` | `str` | - | 文本模型 API 密钥 |
| `text_llm_model_base_url` | `str` | - | 文本模型 API 地址 |
| `text_llm_temperature` | `float` | `0.4` | 文本模型温度参数 |
| `text_llm_enable_search` | `bool` | `false` | 是否启用搜索功能 |
| `vision_llm_model_name` | `str` | - | 视觉模型名称 |
| `vision_llm_api_key` | `str` | - | 视觉模型 API 密钥 |
| `vision_llm_model_base_url` | `str` | - | 视觉模型 API 地址 |
| `vision_llm_temperature` | `float` | `0.4` | 视觉模型温度参数 |
| `vision_llm_enable_search` | `bool` | `false` | 是否启用视觉搜索 |
| `hyw_prompt` | `str` | 默认提示词 | 自定义系统提示词 |





