fix: comprehensive improvements and bug fixes

主要修复和改进:

🔥 关键修复:
- 修正 provider/qiniu.py 中错误的类名 DeepSeekProvider -> QiniuProvider
- 这是一个会导致插件无法正常工作的严重问题

📝 配置完善:
- 添加缺失的 qwen3-32b 模型到 _position.yaml
- 为 deepseek-r1 模型添加完整的参数配置
- 修正 manifest.yaml 中的权限设置（关闭不需要的功能）

📚 代码质量提升:
- 为所有 Python 类添加详细的中文文档字符串
- 完善类型注解和错误处理
- 修正 llm.py 中 _invoke 方法的参数传递

🔧 开发工具:
- 完善 .gitignore 文件，添加更多忽略规则
- 新增 test_plugin.py 测试脚本
- 新增 DEVELOPMENT.md 开发指南文档

项目现在具有更好的代码质量、完整的配置和开发工具支持。

Author: yinxulai

.gitignore

@@ -1,3 +1,58 @@
-__pycache__
-venv
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environment
+venv/
+env/
+ENV/
+
+# Environment variables
 .env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp

DEVELOPMENT.md

@@ -26,13 +26,13 @@ resource:
   permission:
     model:
       llm: true
-      rerank: true
+      rerank: false
       enabled: true
       moderation: false
       speech2text: false
-      text_embedding: true
+      text_embedding: false
       tts: false
     tool:
-      enabled: true
+      enabled: false
 type: plugin
 version: 0.0.2

manifest.yaml

@@ -1,4 +1,5 @@
 - deepseek-v3
 - deepseek-r1
 - qwen-turbo
+- qwen3-32b
 - kimi-k2

models/llm/_position.yaml

@@ -11,3 +11,16 @@ features:
 model_properties:
   mode: chat
   context_size: 131072
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+    default: 0.7
+    min: 0
+    max: 2
+  - name: top_p
+    use_template: top_p
+    default: 0.6
+    type: float
+  - name: presence_penalty
+    use_template: presence_penalty
+    default: 0.95

models/llm/deepseek-r1.yaml

@@ -7,6 +7,11 @@
 
 
 class QiniuLargeLanguageModel(OAICompatLargeLanguageModel):
+    """
+    七牛云大语言模型实现类
+    基于 OpenAI 兼容接口实现，支持多种七牛云 AI 模型
+    """
+
     def _invoke(
         self,
         model: str,
@@ -18,15 +23,44 @@ def _invoke(
         stream: bool = True,
         user: Optional[str] = None,
     ) -> Union[LLMResult, Generator]:
+        """
+        调用七牛云大语言模型
+
+        Args:
+            model: 模型名称
+            credentials: 认证信息
+            prompt_messages: 提示消息列表
+            model_parameters: 模型参数
+            tools: 工具列表（可选）
+            stop: 停止词列表（可选）
+            stream: 是否流式返回
+            user: 用户标识（可选）
+
+        Returns:
+            LLMResult 或 Generator
+        """
         self._add_custom_parameters(credentials)
-        return super()._invoke(model, credentials, prompt_messages, model_parameters, tools, stop, stream)
+        return super()._invoke(model, credentials, prompt_messages, model_parameters, tools, stop, stream, user)
 
     def validate_credentials(self, model: str, credentials: dict) -> None:
+        """
+        验证认证信息
+
+        Args:
+            model: 模型名称
+            credentials: 认证信息
+        """
         self._add_custom_parameters(credentials)
         super().validate_credentials(model, credentials)
 
     @staticmethod
-    def _add_custom_parameters(credentials) -> None:
+    def _add_custom_parameters(credentials: dict) -> None:
+        """
+        添加七牛云特定的参数
+
+        Args:
+            credentials: 认证信息字典
+        """
         credentials["endpoint_url"] = str(URL(credentials.get("endpoint_url", "https://openai.qiniu.com/v1")))
         credentials["mode"] = LLMMode.CHAT.value
         credentials["function_calling_type"] = "tool_call"

models/llm/llm.py

@@ -6,16 +6,27 @@
 logger = logging.getLogger(__name__)
 
 
-class DeepSeekProvider(ModelProvider):
+class QiniuProvider(ModelProvider):
+    """
+    七牛云模型提供商实现类
+    
+    提供七牛云 AI 模型的接入能力，支持多种大语言模型
+    """
+
     def validate_provider_credentials(self, credentials: dict) -> None:
         """
-        Validate provider credentials
-        if validate failed, raise exception
+        验证供应商认证信息
+        如果验证失败，会抛出异常
+
+        Args:
+            credentials: 供应商认证信息，格式由 `provider_credential_schema` 定义
 
-        :param credentials: provider credentials, credentials form defined in `provider_credential_schema`.
+        Raises:
+            CredentialsValidateFailedError: 认证验证失败
         """
         try:
             model_instance = self.get_model_instance(ModelType.LLM)
+            # 使用 deepseek-v3 作为默认验证模型
             model_instance.validate_credentials(model="deepseek-v3", credentials=credentials)
         except CredentialsValidateFailedError as ex:
             raise ex