Merge pull request #67 from led-mirage/feature/v1.38.0

Feature/v1.38.0

Author: led-mirage

Readme.md

@@ -208,7 +208,7 @@ Windowsの場合は、Windowsの検索窓で「環境変数を編集」で検索
 
 以下のリンクから ZundaGPT2.ZIP をダウンロードして、作成したフォルダに展開するのだ。
 
-https://github.com/led-mirage/ZundaGPT2/releases/tag/v1.37.0
+https://github.com/led-mirage/ZundaGPT2/releases/tag/v1.38.0
 
 #### 3. 実行
 
@@ -356,11 +356,11 @@ CSSを知らない人はなんのことかわからないかもしれないけ
 
 VirusTotalでのチェック結果はこちらなのだ。
 
-- Windows版: [72個中2個のアンチウィルスエンジンで検出 :2025/11/29 v1.37.0](https://www.virustotal.com/gui/file/e55a2acfce4000515d04a079abe80517640cd3c624a933f0b85d0c1e0be6e0c5/detection)
-- Raspberry Pi版: [60個中0個のアンチウィルスエンジンで検出 :2025/11/29 v1.37.0](https://www.virustotal.com/gui/file/74cd59e946fbf2081356a6d337d0233cf7f3e0e79c3f4687f347814c8c1127e9/detection)
-- Linux版: [63個中0個のアンチウィルスエンジンで検出 :2025/11/29 v1.37.0](https://www.virustotal.com/gui/file/7792c4572402e154ff4bb7065936a02b52e63270529dc0c8c8f0c454e2ae11f1/detection)
+- Windows版: [72個中2個のアンチウィルスエンジンで検出 :2025/12/06 v1.38.0](https://www.virustotal.com/gui/file/102f24d526d687b824ff9675a77a05cd881b6644bb6eb07cd88003cee04111ea/detection)
+- Raspberry Pi版: [62個中0個のアンチウィルスエンジンで検出 :2025/12/06 v1.38.0](https://www.virustotal.com/gui/file/5115a54df54e6810d7bf71e9ca1276931d8a562efa19f6f8913eb4cf5375ebde/detection)
+- Linux版: [63個中0個のアンチウィルスエンジンで検出 :2025/12/06 v1.38.0](https://www.virustotal.com/gui/file/9af5094c46eab85a4c3865b92ac3daaa13afbfd7f5c4b150edf755875c446e26/detection)
 
-<img src="doc/images/virustotal_1.37.0.png" width="600">
+<img src="doc/images/virustotal_1.38.0.png" width="600">
 
 ### ⚡ ご利用について
 
@@ -496,6 +496,13 @@ VirusTotalでのチェック結果はこちらなのだ。
 
 ## 💎 バージョン履歴
 
+### 1.38.0 (2025/12/06)
+
+- キャラ設定に`temperature`パラメータを追加
+- Chat系クラスのリファクタリング
+- SAPI利用時の例外処理を追加
+- その他軽微なバグ修正
+
 ### 1.37.0 (2025/11/29)
 
 - フルスクリーンモードに対応
@@ -531,6 +538,8 @@ VirusTotalでのチェック結果はこちらなのだ。
   - Claude、Geminiにも対応
   - 画像をクリックすることで拡大表示する機能を追加
 
+<details><summary>それ以前のバージョンアップの履歴はこちらなのだ</summary>
+
 ### 1.33.0 (2025/10/31)
 
 - 画像送信機能の追加（実験的機能）
@@ -544,8 +553,6 @@ VirusTotalでのチェック結果はこちらなのだ。
 - chatパッケージのリファクタリング
 - タイポ修正
 
-<details><summary>それ以前のバージョンアップの履歴はこちらなのだ</summary>
-
 ### 1.31.0 (2025/10/19)
 
 - openaiライブラリを2.5.0に更新

app/chat/__init__.py

@@ -4,4 +4,5 @@
 from .chat_gemini import ChatGemini
 from .chat_claude import ChatClaude
 from .chat_factory import ChatFactory
+from .chat_factory_options import ChatFactoryOptions
 from .listener import SendMessageListener

app/chat/chat.py

@@ -7,6 +7,7 @@
 # ライセンスの詳細については、このプロジェクトのLICENSEファイルを参照してください。
 
 from abc import abstractmethod
+from dataclasses import dataclass
 import threading
 from datetime import datetime
 
@@ -15,39 +16,61 @@
 
 # チャット基底クラス
 class Chat:
+    messages: list
+    chat_start_time: datetime
+    chat_update_time: datetime
+    client_creation_error: str
+    _client: object
+    _model: str
+    _temperature: float
+    _instruction: str
+    _bad_response: str
+    _history_size: int
+    _history_char_limit: int
+    _stop_send_event: threading.Event
+
     # コンストラクタ
-    def __init__(self, client, model: str, instruction: str, bad_response: str, history_size: int, history_char_limit: int):
+    def __init__(self, model: str, temperature: float, instruction: str, bad_response: str, history_size: int, history_char_limit: int):
         self.messages = []
-        self.client = client
-        self.model = model
-        self.instruction = instruction
-        self.bad_response = bad_response
-        self.history_size = history_size
-        self.history_char_limit = history_char_limit
         self.chat_start_time = datetime.now()
         self.chat_update_time = datetime.now()
-        self.stop_send_event = threading.Event()
         self.client_creation_error = ""
+        self._client = None
+        self._model = model
+        self._temperature = temperature
+        self._instruction = instruction
+        self._bad_response = bad_response
+        self._history_size = history_size
+        self._history_char_limit = history_char_limit
+        self._stop_send_event = threading.Event()
 
     # AIエージェントが利用可能かどうかを返す
     def is_ai_agent_available(self):
-        return self.client is not None
+        return self._client is not None
 
     # 指定index以下のメッセージを切り捨てる
     def truncate_messages(self, index):
         self.messages = self.messages[:index]
 
     # 進行中のsend_message関数の送信を停止する
     def stop_send_message(self):
-        self.stop_send_event.set()
+        self._stop_send_event.set()
+
+    @abstractmethod
+    def send_onetime_message(self, text: str) -> str:
+        pass
+
+    @abstractmethod
+    def send_message(self, text: str, images: list[str], listener: SendMessageListener) -> str:
+        pass
 
     # 送信する会話履歴を取得するメッセージメッセージ
-    def get_history(self):
+    def _get_history(self):
         # まずhistory_size件だけ切り出す
-        target_messages = self.messages[-self.history_size:]
+        target_messages = self.messages[-self._history_size:]
 
         # history_char_limitの指定がなければそのまま返す
-        if self.history_char_limit <= 0:
+        if self._history_char_limit <= 0:
             return target_messages
 
         # 末尾（新しい順）から合計文字数をカウントしつつ、history_char_limitで切る
@@ -58,7 +81,7 @@ def get_history(self):
         for msg in reversed(target_messages):
             msg_len = len(msg["content"])
             # 3件以上あって、かつ文字数が上限を超えたらbreak
-            if len(result) >= 3 and total_chars + msg_len > self.history_char_limit:
+            if len(result) >= 3 and total_chars + msg_len > self._history_char_limit:
                 break
             result.append(msg)
             total_chars += msg_len
@@ -69,11 +92,3 @@ def get_history(self):
 
         # 新しい順に並び替えて返却
         return list(reversed(result))
-
-    @abstractmethod
-    def send_onetime_message(self, text: str) -> str:
-        pass
-
-    @abstractmethod
-    def send_message(self, text: str, images: list[str], listener: SendMessageListener) -> str:
-        pass

app/chat/chat_azureopenai.py

@@ -17,9 +17,18 @@
 
 # Azure OpenAI チャットクラス
 class ChatAzureOpenAI(ChatOpenAIBase):
-    def __init__(self, model: str, instruction: str, bad_response: str, history_size: int, history_char_limit: int,
+    def __init__(self, model: str, temperature: float, instruction: str, bad_response: str, history_size: int, history_char_limit: int,
                  api_timeout: float, api_key_envvar: str=None, api_endpoint: str=None):
 
+        super().__init__(
+            model = model,
+            temperature = temperature,
+            instruction = instruction,
+            bad_response = bad_response,
+            history_size = history_size,
+            history_char_limit = history_char_limit
+        )
+
         if api_key_envvar:
             api_key = os.environ.get(api_key_envvar)
         else:
@@ -30,20 +39,11 @@ def __init__(self, model: str, instruction: str, bad_response: str, history_size
         else:
             endpoint = os.environ.get("AZURE_OPENAI_ENDPOINT")
 
-        client = None
+        self._client = None
         if endpoint and api_key:
-            client = AzureOpenAI(azure_endpoint=endpoint, api_key=api_key, api_version="2025-04-01-preview",
+            self._client = AzureOpenAI(azure_endpoint=endpoint, api_key=api_key, api_version="2025-04-01-preview",
                                  timeout=httpx.Timeout(api_timeout, connect=5.0))
 
-        super().__init__(
-            client = client,
-            model = model,
-            instruction = instruction,
-            bad_response = bad_response,
-            history_size = history_size,
-            history_char_limit = history_char_limit
-        )
-
         if endpoint is None:
             self.client_creation_error = get_text_resource("ERROR_MISSING_AZURE_OPENAI_ENDPOINT")
         if api_key is None:

app/chat/chat_claude.py

@@ -22,28 +22,28 @@
 class ChatClaude(Chat):
     MAX_IMAGE_SIZE_MB = 4.0
 
-    def __init__(self, model: str, instruction: str, bad_response: str, history_size: int, history_char_limit: int,
+    def __init__(self, model: str, temperature: float, instruction: str, bad_response: str, history_size: int, history_char_limit: int,
                  api_key_envvar: str=None, claude_options: dict=None):
 
+        super().__init__(
+            model = model,
+            temperature = temperature,
+            instruction = instruction,
+            bad_response = bad_response,
+            history_size = history_size,
+            history_char_limit = history_char_limit
+        )
+
         self.claude_options = claude_options
 
         if api_key_envvar:
             api_key = os.environ.get(api_key_envvar)
         else:
             api_key = os.environ.get("ANTHROPIC_API_KEY")
 
-        client = None
+        self._client = None
         if api_key:
-            client = anthropic.Anthropic(api_key=api_key)
-
-        super().__init__(
-            client = client,
-            model = model,
-            instruction = instruction,
-            bad_response = bad_response,
-            history_size = history_size,
-            history_char_limit = history_char_limit
-        )
+            self._client = anthropic.Anthropic(api_key=api_key)
 
         if api_key is None:
             self.client_creation_error = get_text_resource("ERROR_MISSING_ANTHROPIC_API_KEY")
@@ -52,11 +52,13 @@ def __init__(self, model: str, instruction: str, bad_response: str, history_size
     def send_onetime_message(self, text:str):
         messages = []
         messages.append({"role": "user", "content": text})
-        response = self.client.messages.create(
+
+        response = self._client.messages.create(
             max_tokens=4096,
-            system=self.instruction,
+            system=self._instruction,
             messages=messages,
-            model=self.model)
+            model=self._model
+            )
         return response.content[0].text
 
     # メッセージを送信して回答を得る
@@ -67,10 +69,10 @@ def send_message(
         listener: SendMessageListener) -> str:
 
         try:
-            self.stop_send_event.clear()
+            self._stop_send_event.clear()
 
             self.messages.append({"role": "user", "content": text})
-            messages = copy.deepcopy(self.get_history())
+            messages = copy.deepcopy(self._get_history())
 
             if images and len(images) > 0:
                 messages = messages[:-1]
@@ -102,18 +104,23 @@ def send_message(
                     "type": "disabled"
                 }
 
-            with self.client.messages.stream(
+            temperature = anthropic.omit
+            if self._temperature:
+                temperature = self._temperature
+
+            with self._client.messages.stream(
                 max_tokens=max_tokens,
                 thinking=thinking,
-                system=self.instruction,
+                system=self._instruction,
                 messages=messages,
-                model=self.model,
+                model=self._model,
+                temperature=temperature
             ) as stream:
                 code_block = 0
                 code_block_inside = False
 
                 for text in stream.text_stream:
-                    if self.stop_send_event.is_set():
+                    if self._stop_send_event.is_set():
                         break
 
                     if text is not None:
@@ -154,8 +161,8 @@ def send_message(
                     listener.on_end_response(content)
                     return content
                 else:
-                    listener.on_end_response(self.bad_response)
-                    return self.bad_response
+                    listener.on_end_response(self._bad_response)
+                    return self._bad_response
         except anthropic.APITimeoutError as e:
             listener.on_error(e, "Timeout")
         except anthropic.APIConnectionError as e:

app/chat/chat_factory.py

@@ -6,6 +6,7 @@
 # このソースコードは MITライセンス の下でライセンスされています。
 # ライセンスの詳細については、このプロジェクトのLICENSEファイルを参照してください。
 
+from .chat_factory_options import ChatFactoryOptions
 from .chat import Chat
 from .chat_openai import ChatOpenAI
 from .chat_azureopenai import ChatAzureOpenAI
@@ -18,15 +19,22 @@
 class ChatFactory:
     # api_idに基づいてChatオブジェクトを作成する
     @staticmethod
-    def create(api_id: str, model: str, instruction: str, bad_response: str, history_size: int, history_char_limit: int, api_timeout: float,
-               api_key_envvar: str=None, api_key_endpoint: str=None, api_base_url: str=None, gemini_option: dict=None, claude_options: dict=None) -> Chat:
-        if api_id == "OpenAI":
-            return ChatOpenAI(model, instruction, bad_response, history_size, history_char_limit, api_timeout, api_key_envvar, api_base_url)
-        elif api_id == "AzureOpenAI":
-            return ChatAzureOpenAI(model, instruction, bad_response, history_size, history_char_limit, api_timeout, api_key_envvar, api_key_endpoint)
-        elif api_id == "Gemini":
-            return ChatGemini(model, instruction, bad_response, history_size, history_char_limit, api_key_envvar, gemini_option)
-        elif api_id == "Claude":
-            return ChatClaude(model, instruction, bad_response, history_size, history_char_limit, api_key_envvar, claude_options)
+    def create(options: ChatFactoryOptions) -> Chat:
+        if options.api_id == "OpenAI":
+            return ChatOpenAI(
+                options.model, options.temperature, options.instruction, options.bad_response, options.history_size, options.history_char_limit,
+                options.api_timeout, options.api_key_envvar, options.api_base_url)
+        elif options.api_id == "AzureOpenAI":
+            return ChatAzureOpenAI(
+                options.model, options.temperature, options.instruction, options.bad_response, options.history_size, options.history_char_limit,
+                options.api_timeout, options.api_key_envvar, options.api_endpoint_envvar)
+        elif options.api_id == "Gemini":
+            return ChatGemini(
+                options.model, options.temperature, options.instruction, options.bad_response, options.history_size, options.history_char_limit,
+                options.api_key_envvar, options.gemini_option)
+        elif options.api_id == "Claude":
+            return ChatClaude(
+                options.model, options.temperature, options.instruction, options.bad_response, options.history_size, options.history_char_limit,
+                options.api_key_envvar, options.claude_options)
         else:
             raise ValueError(get_text_resource("ERROR_API_ID_IS_INCORRECT"))

app/chat/chat_factory_options.py

@@ -0,0 +1,26 @@
+# ZundaGPT2 / ZundaGPT2 Lite
+#
+# チャットファクトリオプション クラス
+#
+# Copyright (c) 2024-2025 led-mirage
+# このソースコードは MITライセンス の下でライセンスされています。
+# ライセンスの詳細については、このプロジェクトのLICENSEファイルを参照してください。
+
+from dataclasses import dataclass
+
+
+@dataclass
+class ChatFactoryOptions:
+    api_id: str
+    model: str
+    temperature: float
+    instruction: str
+    bad_response: str
+    history_size: int
+    history_char_limit: int
+    api_timeout: float
+    api_key_envvar: str
+    api_endpoint_envvar: str
+    api_base_url: str
+    gemini_option: dict
+    claude_options: dict