entari-plugin-hyw 3.3.6__tar.gz → 3.3.8__tar.gz

entari_plugin_hyw-3.3.8/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: entari_plugin_hyw
+Version: 3.3.8
+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: Issue Tracker, 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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: arclet-entari[full]>=0.16.5
+Requires-Dist: openai
+Requires-Dist: httpx
+Requires-Dist: markdown>=3.10
+Requires-Dist: crawl4ai>=0.7.8
+Requires-Dist: jinja2>=3.0
+Requires-Dist: ddgs>=9.10.0
+Provides-Extra: dev
+Requires-Dist: entari-plugin-server>=0.5.0; extra == "dev"
+Requires-Dist: satori-python-adapter-onebot11>=0.2.5; extra == "dev"
+
+# Entari Plugin HYW
+
+[![PyPI version](https://badge.fury.io/py/entari-plugin-hyw.svg)](https://badge.fury.io/py/entari-plugin-hyw)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Versions](https://img.shields.io/pypi/pyversions/entari-plugin-hyw.svg)](https://pypi.org/project/entari-plugin-hyw/)
+
+**English** | [简体中文](docs/README_CN.md)
+
+**Entari Plugin HYW** is an advanced agentic chat plugin for the [Entari](https://github.com/entari-org/entari) framework. It leverages Large Language Models (LLMs) to provide intelligent, context-aware, and multi-modal responses within instant messaging environments (OneBot 11, Satori).
+
+The plugin implements a three-stage pipeline (**Vision**, **Instruct**, **Agent**) to autonomously decide when to search the web, crawl pages, or analyze images to answer user queries effectively.
+
+<p align="center">
+  <img src="docs/demo_mockup.svg" width="800" />
+</p>
+
+## Features
+
+- 📖 **Agentic Workflow**  
+  Autonomous decision-making process to search, browse, and reason.
+
+- 🎑 **Multi-Modal Support**  
+  Native support for image analysis using Vision Language Models (VLMs).
+
+- 🔍 **Web Search & Crawling**  
+  Integrated **DuckDuckGo** and **Crawl4AI** for real-time information retrieval.
+
+- 🎨 **Rich Rendering**  
+  Responses are rendered as images containing Markdown, syntax-highlighted code, LaTeX math, and citation badges.
+
+- 🔌 **Protocol Support**  
+  Deep integration with OneBot 11 and Satori protocols, handling reply context and JSON cards perfectly.
+
+## Installation
+
+```bash
+pip install entari-plugin-hyw
+```
+
+## Configuration
+
+Configure the plugin in your `entari.yml`.
+
+### Minimal Configuration
+
+```yaml
+plugins:
+  entari_plugin_hyw:
+    model_name: google/gemini-3-flash-preview
+    api_key: "your-or-api-key-here"
+```
+
+## Usage
+
+### Commands
+
+- **Text Query**
+  ```text
+  /q What's the latest news on Rust 1.83?
+  ```
+
+- **Image Analysis**
+  *(Send an image with command, or reply to an image)*
+  ```text
+  /q [Image] Explain this error.
+  ```
+- **Quote Query**
+  ```text
+  [quote: User Message] /q
+  ```
+
+- **Follow-up**
+  *Reply to the bot's message to continue the conversation.*
+
+## Documentation for AI/LLMs
+
+- [Instruction Guide (English)](docs/README_LLM_EN.md)
+- [指导手册 (简体中文)](docs/README_LLM_CN.md)
+
+---
+
+## License
+
+This project is licensed under the MIT License.

entari_plugin_hyw-3.3.8/README.md

@@ -0,0 +1,84 @@
+# Entari Plugin HYW
+
+[![PyPI version](https://badge.fury.io/py/entari-plugin-hyw.svg)](https://badge.fury.io/py/entari-plugin-hyw)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Versions](https://img.shields.io/pypi/pyversions/entari-plugin-hyw.svg)](https://pypi.org/project/entari-plugin-hyw/)
+
+**English** | [简体中文](docs/README_CN.md)
+
+**Entari Plugin HYW** is an advanced agentic chat plugin for the [Entari](https://github.com/entari-org/entari) framework. It leverages Large Language Models (LLMs) to provide intelligent, context-aware, and multi-modal responses within instant messaging environments (OneBot 11, Satori).
+
+The plugin implements a three-stage pipeline (**Vision**, **Instruct**, **Agent**) to autonomously decide when to search the web, crawl pages, or analyze images to answer user queries effectively.
+
+<p align="center">
+  <img src="docs/demo_mockup.svg" width="800" />
+</p>
+
+## Features
+
+- 📖 **Agentic Workflow**  
+  Autonomous decision-making process to search, browse, and reason.
+
+- 🎑 **Multi-Modal Support**  
+  Native support for image analysis using Vision Language Models (VLMs).
+
+- 🔍 **Web Search & Crawling**  
+  Integrated **DuckDuckGo** and **Crawl4AI** for real-time information retrieval.
+
+- 🎨 **Rich Rendering**  
+  Responses are rendered as images containing Markdown, syntax-highlighted code, LaTeX math, and citation badges.
+
+- 🔌 **Protocol Support**  
+  Deep integration with OneBot 11 and Satori protocols, handling reply context and JSON cards perfectly.
+
+## Installation
+
+```bash
+pip install entari-plugin-hyw
+```
+
+## Configuration
+
+Configure the plugin in your `entari.yml`.
+
+### Minimal Configuration
+
+```yaml
+plugins:
+  entari_plugin_hyw:
+    model_name: google/gemini-3-flash-preview
+    api_key: "your-or-api-key-here"
+```
+
+## Usage
+
+### Commands
+
+- **Text Query**
+  ```text
+  /q What's the latest news on Rust 1.83?
+  ```
+
+- **Image Analysis**
+  *(Send an image with command, or reply to an image)*
+  ```text
+  /q [Image] Explain this error.
+  ```
+- **Quote Query**
+  ```text
+  [quote: User Message] /q
+  ```
+
+- **Follow-up**
+  *Reply to the bot's message to continue the conversation.*
+
+## Documentation for AI/LLMs
+
+- [Instruction Guide (English)](docs/README_LLM_EN.md)
+- [指导手册 (简体中文)](docs/README_LLM_CN.md)
+
+---
+
+## License
+
+This project is licensed under the MIT License.

{entari_plugin_hyw-3.3.6 → entari_plugin_hyw-3.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "entari_plugin_hyw"
-version = "3.3.6"
+version = "3.3.8"
 description = "Use large language models to interpret chat messages"
 authors = [{name = "kumoSleeping", email = "zjr2992@outlook.com"}]
 dependencies = [

{entari_plugin_hyw-3.3.6 → entari_plugin_hyw-3.3.8}/src/entari_plugin_hyw/__init__.py

@@ -58,13 +58,11 @@ class HywConfig(BasicConfModel):
     base_url: str = "https://openrouter.ai/api/v1"
     vision_model_name: Optional[str] = None
     vision_api_key: Optional[str] = None
+    language: str = "Simplified Chinese"
     vision_base_url: Optional[str] = None
-    vision_system_prompt: Optional[str] = None
-    intruct_model_name: Optional[str] = None
-    intruct_api_key: Optional[str] = None
-    intruct_base_url: Optional[str] = None
-    intruct_system_prompt: Optional[str] = None
-    agent_system_prompt: Optional[str] = None
+    instruct_model_name: Optional[str] = None
+    instruct_api_key: Optional[str] = None
+    instruct_base_url: Optional[str] = None
     search_base_url: str = "https://lite.duckduckgo.com/lite/?q={query}"
     image_search_base_url: str = "https://duckduckgo.com/?q={query}&iax=images&ia=images"
     headless: bool = False
@@ -72,8 +70,10 @@ class HywConfig(BasicConfModel):
     icon: str = "openai"
     render_timeout_ms: int = 6000
     extra_body: Optional[Dict[str, Any]] = None
+    vision_extra_body: Optional[Dict[str, Any]] = None
+    instruct_extra_body: Optional[Dict[str, Any]] = None
     enable_browser_fallback: bool = False
-    reaction: bool = True
+    reaction: bool = False
     quote: bool = True
     temperature: float = 0.4
     # Billing configuration (price per million tokens)
@@ -83,14 +83,14 @@ class HywConfig(BasicConfModel):
     vision_input_price: Optional[float] = None
     vision_output_price: Optional[float] = None
     # Instruct model pricing overrides (defaults to main model pricing if not set)
-    intruct_input_price: Optional[float] = None
-    intruct_output_price: Optional[float] = None
+    instruct_input_price: Optional[float] = None
+    instruct_output_price: Optional[float] = None
     # Provider Names
     search_name: str = "DuckDuckGo"
     search_provider: str = "crawl4ai"  # crawl4ai | httpx | ddgs
     model_provider: Optional[str] = None
     vision_model_provider: Optional[str] = None
-    intruct_model_provider: Optional[str] = None
+    instruct_model_provider: Optional[str] = None
 
 
 

{entari_plugin_hyw-3.3.6 → entari_plugin_hyw-3.3.8}/src/entari_plugin_hyw/core/config.py

@@ -12,27 +12,27 @@ class HYWConfig:
     fusion_mode: bool = False 
     save_conversation: bool = False
     headless: bool = True
-    intruct_model_name: Optional[str] = None
-    intruct_api_key: Optional[str] = None
-    intruct_base_url: Optional[str] = None
+    instruct_model_name: Optional[str] = None
+    instruct_api_key: Optional[str] = None
+    instruct_base_url: Optional[str] = None
     search_base_url: str = "https://lite.duckduckgo.com/lite/?q={query}"
     image_search_base_url: str = "https://duckduckgo.com/?q={query}&iax=images&ia=images"
     search_params: Optional[str] = None  # e.g. "&kl=cn-zh" for China region
     search_limit: int = 8 
     extra_body: Optional[Dict[str, Any]] = None
+    vision_extra_body: Optional[Dict[str, Any]] = None
+    instruct_extra_body: Optional[Dict[str, Any]] = None
     temperature: float = 0.4
     max_turns: int = 10
     icon: str = "openai"  # logo for primary model
     vision_icon: Optional[str] = None  # logo for vision model (falls back to icon when absent)
     instruct_icon: Optional[str] = None # logo for instruct model
     enable_browser_fallback: bool = False
-    vision_system_prompt: Optional[str] = None
-    intruct_system_prompt: Optional[str] = None
-    agent_system_prompt: Optional[str] = None
+    language: str = "Simplified Chinese"
     input_price: Optional[float] = None  # $ per 1M input tokens
     output_price: Optional[float] = None  # $ per 1M output tokens
     vision_input_price: Optional[float] = None
     vision_output_price: Optional[float] = None
-    intruct_input_price: Optional[float] = None
-    intruct_output_price: Optional[float] = None
+    instruct_input_price: Optional[float] = None
+    instruct_output_price: Optional[float] = None