From 13b2163788db8b724ed08e295c46b07c8c384d91 Mon Sep 17 00:00:00 2001
From: jxxghp <jxxghp@gmail.com>
Date: Sun, 31 May 2026 17:49:05 +0800
Subject: [PATCH] chore: add noqa for specific lines, update docstring, improve
 logging and variable naming

---
 app/agent/__init__.py            |  2 +-
 app/agent/llm/helper.py          | 10 +++++-----
 app/modules/telegram/__init__.py |  1 +
 app/modules/telegram/telegram.py |  4 ++--
 4 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/app/agent/__init__.py b/app/agent/__init__.py
index 9cdb7e1a..d606b9e5 100644
--- a/app/agent/__init__.py
+++ b/app/agent/__init__.py
@@ -1539,7 +1539,7 @@ class AgentManager:
                 await self._session_workers[session_id]
             except asyncio.CancelledError:
                 pass
-            self._session_workers.pop(session_id, None)
+            self._session_workers.pop(session_id, None)  # noqa
 
         # 清理队列
         self._session_queues.pop(session_id, None)
diff --git a/app/agent/llm/helper.py b/app/agent/llm/helper.py
index 63b99b26..2b10b1fd 100644
--- a/app/agent/llm/helper.py
+++ b/app/agent/llm/helper.py
@@ -87,7 +87,7 @@ def _patch_gemini_thought_signature():
         # 补丁 2：修复 _parse_chat_history 中 first_fc_seen 只修复第一个
         # function_call 的问题。用 wrapper 在原函数返回后，确保所有 model
         # 消息中所有 function_call 都带有 thought_signature。
-        _original_parse_chat_history = _cm._parse_chat_history
+        _original_parse_chat_history = _cm._parse_chat_history  # noqa
 
         def _patched_parse_chat_history(*args, **kwargs):
             result = _original_parse_chat_history(*args, **kwargs)
@@ -498,13 +498,13 @@ def _patch_openai_responses_empty_output_support():
         if callable(model_copy):
             try:
                 return model_copy(update={"output": []})
-            except Exception as err:
-                logger.debug(f"复制 Responses 对象失败，回退原地修补 output：{err}")
+            except Exception as e:
+                logger.debug(f"复制 Responses 对象失败，回退原地修补 output：{e}")
 
         try:
             setattr(response, "output", [])
-        except Exception as err:
-            logger.debug(f"原地修补 Responses output 失败：{err}")
+        except Exception as e:
+            logger.debug(f"原地修补 Responses output 失败：{e}")
         return response
 
     @wraps(original_construct)
diff --git a/app/modules/telegram/__init__.py b/app/modules/telegram/__init__.py
index 4da3aa1c..f051fd64 100644
--- a/app/modules/telegram/__init__.py
+++ b/app/modules/telegram/__init__.py
@@ -610,6 +610,7 @@ class TelegramModule(_ModuleBase, _MessageBase[Telegram]):
         :param text: 新的消息内容
         :param title: 消息标题
         :param buttons: 新的按钮列表
+        :param metadata: 其他元信息
         :return: 编辑是否成功
         """
         if channel != self._channel:
diff --git a/app/modules/telegram/telegram.py b/app/modules/telegram/telegram.py
index 9a87a659..fb9f1b44 100644
--- a/app/modules/telegram/telegram.py
+++ b/app/modules/telegram/telegram.py
@@ -225,14 +225,14 @@ class Telegram:
             ).get_res(file_url)
             if resp and resp.content:
                 logger.info(
-                    "Telegram图片下载成功: file_id=%s, file_path=%s, content_bytes=%s",
+                    "Telegram文件下载成功: file_id=%s, file_path=%s, content_bytes=%s",
                     file_id,
                     file_info.file_path,
                     len(resp.content),
                 )
                 return resp.content
             logger.warn(
-                "Telegram图片下载失败: file_id=%s, file_path=%s, file_url=%s, proxy_enabled=%s",
+                "Telegram文件下载失败: file_id=%s, file_path=%s, file_url=%s, proxy_enabled=%s",
                 file_id,
                 getattr(file_info, "file_path", None),
                 file_url,