xinops 1.0.1__tar.gz

xinops-1.0.1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: xinops
+Version: 1.0.1
+Summary: 营销数据运维工具库：Hive交互、企业微信/飞书消息、Excel/飞书表格、邮件推送等一体化工具集
+Author: DongYang
+Author-email: 649898871@qq.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: xlsxwriter>=3.0.0
+Requires-Dist: requests>=2.26.0
+Requires-Dist: pyhive>=0.6.5
+Requires-Dist: thrift>=0.15.0
+Requires-Dist: beautifulsoup4>=4.10.0
+Requires-Dist: lxml>=4.6.3
+Requires-Dist: pillow>=8.4.0
+Requires-Dist: psutil>=5.8.0
+Requires-Dist: tenacity>=8.0.0
+Requires-Dist: openpyxl>=3.0.0
+Requires-Dist: pyarrow>=10.0.0
+Requires-Dist: yagmail>=0.15.293
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: WeComMsg>=1.0.9
+Requires-Dist: HiveClient>=1.0.4
+Provides-Extra: excel-win
+Requires-Dist: xlwings>=0.27.0; extra == "excel-win"
+Provides-Extra: browser
+Requires-Dist: selenium>=4.0.0; extra == "browser"
+Requires-Dist: webdriver-manager>=3.8.0; extra == "browser"
+Provides-Extra: pinyin
+Requires-Dist: pypinyin>=0.48.0; extra == "pinyin"
+Provides-Extra: all
+Requires-Dist: xlwings>=0.27.0; extra == "all"
+Requires-Dist: selenium>=4.0.0; extra == "all"
+Requires-Dist: webdriver-manager>=3.8.0; extra == "all"
+Requires-Dist: pypinyin>=0.48.0; extra == "all"
+
+# xinops
+
+营销数据运维一体化工具库（原 Functions_d + feishu_to_excel 合并重构版），**Windows / Mac 通用**。
+
+## 与旧库的关系
+
+- 原 `Functions_d`（1.46）与 `feishu_to_excel`（0.0.5）**保留为备份，不再更新**
+- 本库为新库名下的持续维护版本，`DataProcessingAndMessaging` 类的方法名与 Functions_d 1.46 **完全一致**
+- 业务脚本迁移只需改一行 import：
+
+```python
+# 旧写法
+import Functions_d
+ux = Functions_d.DataProcessingAndMessaging()
+
+# 新写法
+import xinops
+ux = xinops.DataProcessingAndMessaging()
+```
+
+## 安装
+
+```bash
+pip install xinops          # 核心功能（Windows/Mac 通用）
+
+# 可选功能按需加装：
+pip install "xinops[excel_win]"   # writer_excel_data / screen（xlwings 操作本机 Excel，仅 Windows）
+pip install "xinops[browser]"     # init_edge_driver（Selenium Edge 自动化）
+pip install "xinops[pinyin]"      # name_to_pinyin / car_task_transfer
+pip install "xinops[all]"         # 全部装上（等同旧版 Functions_d 的安装效果）
+```
+
+> Mac 用户注意：`writer_excel_data`（xlwings）与 `screen`（Excel 截图）依赖 Windows 上的本机 Excel，
+> Mac 上请使用跨平台的 `writer_excel_data_new`（openpyxl 方案，无需安装 Excel）。
+> xlwings/pythoncom 均为方法内延迟导入，Mac 上未安装不影响库的导入与其他功能。
+
+## 密钥配置文件（必须）
+
+本库不再在代码中硬编码任何密码。首次使用前，创建 `xinops_secrets.yaml`：
+
+```yaml
+# 企业微信消息
+wecom_corpid: "wxd4e113eb4c0136b9"
+wecom_corpsecret: "你的secret"
+wecom_agentid: "1000026"
+
+# 企业微信文档
+wecom_doc_corpid: "wxd4e113eb4c0136b9"
+wecom_doc_corpsecret: "你的secret"
+
+# 邮件 SMTP
+smtp_sender: "cc_yingxiao@xin.com"
+smtp_pwd: "你的密码"
+smtp_host: "smtp.exmail.qq.com"
+smtp_port: 465
+
+# Hive 连接
+hive_host: "172.20.2.190"
+hive_port: 10023
+hive_user: "cc_yingxiao"
+hive_pwd: "你的密码"
+```
+
+**查找顺序**（找到即用）：
+
+1. 环境变量 `XINOPS_CONFIG`（或旧名 `PYPI_KU_CONFIG`）指定的路径
+2. 业务脚本所在目录及其上层目录（最多向上 3 层）——推荐放在脚本目录的上层，多台机器迁移时随脚本目录一起拷贝
+3. 用户主目录
+
+所有配置项也支持同名环境变量覆盖（如 `WECOM_CORPSECRET`、`SMTP_PWD`、`HIVE_PWD`）。
+**配置文件含敏感信息，切勿提交 git、切勿放进本仓库目录**（仓库 .gitignore 已加双保险）。
+
+## 模块结构
+
+| 模块 | 功能 |
+|---|---|
+| `_core.py` | 日志初始化、密钥配置加载、脚本生命周期、日期时间与通用工具 |
+| `_wecom.py` | 企业微信消息 + 企微智能表格文档 |
+| `_email.py` | 邮件发送（旧版 yagmail / 新版 smtplib 带重试） |
+| `_hive.py` | Hive SQL 执行（dml/dmls/dql/dqls）与错误提取 |
+| `_excel.py` | Excel 模板写入（xlwings/openpyxl 双方案）、截图、格式化导出 |
+| `_export.py` | Parquet / CSV 导出 |
+| `_misc.py` | Edge 驱动、数据量检查、拼音转换、车辆任务、内网文件服务器上传 |
+| `_feishu.py` | 飞书表格上传器 FeishuSheetUploader（原 feishu_to_excel） |
+
+## 使用示例
+
+```python
+import xinops
+
+# 主工具类（用法与 Functions_d 完全一致）
+ux = xinops.DataProcessingAndMessaging()
+ux.Start_Get_filepath_and_filename()
+
+data = ux.run_sql(ux.path, "xxx.sql")
+ux.writer_excel_data_new(path=ux.path, filename="muban.xlsx",
+                         send_file=ux.path + "result.xlsx",
+                         sheet_data=[{"data": data, "sheet_name": "明细",
+                                      "clear_range": "A2:U1000000", "date_range": "A1"}],
+                         headers=True)
+ux.uxin_wx("dongyang", "处理完成")
+
+# 飞书表格上传（原 feishu_to_excel 功能）
+uploader = xinops.FeishuSheetUploader(app_id="cli_xxx", app_secret="xxx")
+token = uploader.create_spreadsheet(title="日报")
+uploader.upload_to_sheet(token, "汇总", data, start_cell="A1")
+
+ux.End_operation()
+```

xinops-1.0.1/README.md

@@ -0,0 +1,109 @@
+# xinops
+
+营销数据运维一体化工具库（原 Functions_d + feishu_to_excel 合并重构版），**Windows / Mac 通用**。
+
+## 与旧库的关系
+
+- 原 `Functions_d`（1.46）与 `feishu_to_excel`（0.0.5）**保留为备份，不再更新**
+- 本库为新库名下的持续维护版本，`DataProcessingAndMessaging` 类的方法名与 Functions_d 1.46 **完全一致**
+- 业务脚本迁移只需改一行 import：
+
+```python
+# 旧写法
+import Functions_d
+ux = Functions_d.DataProcessingAndMessaging()
+
+# 新写法
+import xinops
+ux = xinops.DataProcessingAndMessaging()
+```
+
+## 安装
+
+```bash
+pip install xinops          # 核心功能（Windows/Mac 通用）
+
+# 可选功能按需加装：
+pip install "xinops[excel_win]"   # writer_excel_data / screen（xlwings 操作本机 Excel，仅 Windows）
+pip install "xinops[browser]"     # init_edge_driver（Selenium Edge 自动化）
+pip install "xinops[pinyin]"      # name_to_pinyin / car_task_transfer
+pip install "xinops[all]"         # 全部装上（等同旧版 Functions_d 的安装效果）
+```
+
+> Mac 用户注意：`writer_excel_data`（xlwings）与 `screen`（Excel 截图）依赖 Windows 上的本机 Excel，
+> Mac 上请使用跨平台的 `writer_excel_data_new`（openpyxl 方案，无需安装 Excel）。
+> xlwings/pythoncom 均为方法内延迟导入，Mac 上未安装不影响库的导入与其他功能。
+
+## 密钥配置文件（必须）
+
+本库不再在代码中硬编码任何密码。首次使用前，创建 `xinops_secrets.yaml`：
+
+```yaml
+# 企业微信消息
+wecom_corpid: "wxd4e113eb4c0136b9"
+wecom_corpsecret: "你的secret"
+wecom_agentid: "1000026"
+
+# 企业微信文档
+wecom_doc_corpid: "wxd4e113eb4c0136b9"
+wecom_doc_corpsecret: "你的secret"
+
+# 邮件 SMTP
+smtp_sender: "cc_yingxiao@xin.com"
+smtp_pwd: "你的密码"
+smtp_host: "smtp.exmail.qq.com"
+smtp_port: 465
+
+# Hive 连接
+hive_host: "172.20.2.190"
+hive_port: 10023
+hive_user: "cc_yingxiao"
+hive_pwd: "你的密码"
+```
+
+**查找顺序**（找到即用）：
+
+1. 环境变量 `XINOPS_CONFIG`（或旧名 `PYPI_KU_CONFIG`）指定的路径
+2. 业务脚本所在目录及其上层目录（最多向上 3 层）——推荐放在脚本目录的上层，多台机器迁移时随脚本目录一起拷贝
+3. 用户主目录
+
+所有配置项也支持同名环境变量覆盖（如 `WECOM_CORPSECRET`、`SMTP_PWD`、`HIVE_PWD`）。
+**配置文件含敏感信息，切勿提交 git、切勿放进本仓库目录**（仓库 .gitignore 已加双保险）。
+
+## 模块结构
+
+| 模块 | 功能 |
+|---|---|
+| `_core.py` | 日志初始化、密钥配置加载、脚本生命周期、日期时间与通用工具 |
+| `_wecom.py` | 企业微信消息 + 企微智能表格文档 |
+| `_email.py` | 邮件发送（旧版 yagmail / 新版 smtplib 带重试） |
+| `_hive.py` | Hive SQL 执行（dml/dmls/dql/dqls）与错误提取 |
+| `_excel.py` | Excel 模板写入（xlwings/openpyxl 双方案）、截图、格式化导出 |
+| `_export.py` | Parquet / CSV 导出 |
+| `_misc.py` | Edge 驱动、数据量检查、拼音转换、车辆任务、内网文件服务器上传 |
+| `_feishu.py` | 飞书表格上传器 FeishuSheetUploader（原 feishu_to_excel） |
+
+## 使用示例
+
+```python
+import xinops
+
+# 主工具类（用法与 Functions_d 完全一致）
+ux = xinops.DataProcessingAndMessaging()
+ux.Start_Get_filepath_and_filename()
+
+data = ux.run_sql(ux.path, "xxx.sql")
+ux.writer_excel_data_new(path=ux.path, filename="muban.xlsx",
+                         send_file=ux.path + "result.xlsx",
+                         sheet_data=[{"data": data, "sheet_name": "明细",
+                                      "clear_range": "A2:U1000000", "date_range": "A1"}],
+                         headers=True)
+ux.uxin_wx("dongyang", "处理完成")
+
+# 飞书表格上传（原 feishu_to_excel 功能）
+uploader = xinops.FeishuSheetUploader(app_id="cli_xxx", app_secret="xxx")
+token = uploader.create_spreadsheet(title="日报")
+uploader.upload_to_sheet(token, "汇总", data, start_cell="A1")
+
+ux.End_operation()
+```

xinops-1.0.1/pyproject.toml

@@ -0,0 +1,4 @@
+[build-system]
+# 声明构建依赖和后端（使用 setuptools 作为构建工具）
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

xinops-1.0.1/setup.cfg

@@ -0,0 +1,64 @@
+[metadata]
+name = xinops
+version = 1.0.1
+author = DongYang
+author_email = 649898871@qq.com
+description = 营销数据运维工具库：Hive交互、企业微信/飞书消息、Excel/飞书表格、邮件推送等一体化工具集
+long_description = file: README.md
+long_description_content_type = text/markdown
+classifiers = 
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.7
+	Programming Language :: Python :: 3.8
+	Programming Language :: Python :: 3.9
+	Operating System :: OS Independent
+	Intended Audience :: Developers
+	Topic :: Software Development :: Libraries :: Python Modules
+license = MIT
+
+[options]
+packages = find:
+python_requires = >=3.7
+install_requires = 
+	pandas>=1.3.0
+	numpy>=1.21.0
+	xlsxwriter>=3.0.0
+	requests>=2.26.0
+	pyhive>=0.6.5
+	thrift>=0.15.0
+	beautifulsoup4>=4.10.0
+	lxml>=4.6.3
+	pillow>=8.4.0
+	psutil>=5.8.0
+	tenacity>=8.0.0
+	openpyxl>=3.0.0
+	pyarrow>=10.0.0
+	yagmail>=0.15.293
+	PyYAML>=6.0
+	WeComMsg>=1.0.9
+	HiveClient>=1.0.4
+
+[options.extras_require]
+excel_win = 
+	xlwings>=0.27.0
+browser = 
+	selenium>=4.0.0
+	webdriver-manager>=3.8.0
+pinyin = 
+	pypinyin>=0.48.0
+all = 
+	xlwings>=0.27.0
+	selenium>=4.0.0
+	webdriver-manager>=3.8.0
+	pypinyin>=0.48.0
+
+[options.packages.find]
+where = .
+exclude = 
+	tests*
+	docs*
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

xinops-1.0.1/setup.py

@@ -0,0 +1,2 @@
+from setuptools import setup
+setup()  # 仅用于兼容旧工具，实际配置从 setup.cfg 读取

xinops-1.0.1/xinops/__init__.py

@@ -0,0 +1,27 @@
+# Xinops/__init__.py
+
+# 包版本号（与 setup.cfg 中的 version 保持一致）
+__version__ = "1.0.0"
+
+# 各功能模块 Mixin 导入
+from ._core import CoreMixin
+from ._wecom import WeComMixin
+from ._email import EmailMixin
+from ._hive import HiveMixin
+from ._excel import ExcelMixin
+from ._export import ExportMixin
+from ._misc import MiscMixin
+
+# 飞书表格上传器（独立类，不参与 Mixin 组装）
+from ._feishu import FeishuSheetUploader
+
+
+# 组装为对外统一的类：方法名与 Functions_d 1.46 完全一致，业务脚本仅需改 import
+class DataProcessingAndMessaging(CoreMixin, WeComMixin, EmailMixin, HiveMixin,
+                                  ExcelMixin, ExportMixin, MiscMixin):
+    """数据处理与消息推送工具类（由多个功能 Mixin 组装而成）"""
+    pass
+
+
+# 明确指定包对外暴露的成员（规范导入）
+__all__ = ["DataProcessingAndMessaging", "FeishuSheetUploader", "__version__"]

xinops-1.0.1/xinops/_core.py

@@ -0,0 +1,213 @@
+# -*- coding:utf-8 -*-
+"""核心模块：日志初始化、脚本生命周期管理、日期时间与通用工具方法"""
+import datetime
+import inspect
+import logging
+import os
+import time
+import psutil
+import yaml
+
+
+class CoreMixin:
+    """基础设施 Mixin：日志器、运行状态属性、密钥配置加载、通用工具方法"""
+
+    def __init__(self, enable_console_log=None):
+        # -------------------------- 1. 主类日志初始化 --------------------------
+        caller_frame = inspect.stack()[1]
+        caller_filename = caller_frame.filename
+        caller_filename = os.path.abspath(caller_filename)
+        script_dir = os.path.dirname(caller_filename)
+        log_filename = os.path.splitext(os.path.basename(caller_filename))[0] + ".log"
+        self.main_log_file = os.path.join(script_dir, log_filename)
+
+        self.logger = logging.getLogger("main_logger")
+        self.logger.setLevel(logging.INFO)
+        self.logger.propagate = False  # 防止日志扩散
+        if not self.logger.handlers:
+            file_handler = logging.FileHandler(self.main_log_file, encoding='utf-8')
+            file_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s'))
+            self.logger.addHandler(file_handler)
+            if enable_console_log:
+                console_handler = logging.StreamHandler()
+                console_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s'))
+                self.logger.addHandler(console_handler)
+
+        self.logger.info("\n" * 1)  # 1行空行，可自行修改数字
+        self.logger.info("初始化 DataProcessingAndMessaging 类")
+
+        # -------------------------- 2. 主类核心参数初始化 --------------------------
+        self.start_time = None
+        self.current_script_name = None
+        self.log_filename = None
+        self.current_script_names = None
+        self.current_path = None
+        self.path = None
+
+        # -------------------------- 2.1 密钥配置加载（外部yaml，代码不再硬编码） --------------------------
+        sec = self._load_secrets(script_dir)
+
+        # 企业微信消息发送参数（环境变量 > 配置文件）
+        self.corpid = os.getenv("WECOM_CORPID") or sec.get("wecom_corpid")
+        self.corpsecret = os.getenv("WECOM_CORPSECRET") or sec.get("wecom_corpsecret")
+        self.agentid = str(sec.get("wecom_agentid", "1000026"))
+
+        # -------------------------- 3. 企业微信文档功能初始化 --------------------------
+        self.WECHAT_DOC_CORP_ID = os.getenv("WECOM_DOC_CORPID") or sec.get("wecom_doc_corpid")
+        self.WECHAT_DOC_SECRET = os.getenv("WECOM_DOC_SECRET") or sec.get("wecom_doc_corpsecret")
+        self.WECHAT_DOC_SPACE_ID = None
+        self.WECHAT_DOC_LOG_FILE = os.path.join(script_dir, "docs_operation.log")
+        self.wechat_doc_access_token = None
+        self._wechat_doc_logger = None  # 企微文档独立日志器（延迟初始化）
+
+        # -------------------------- 邮件SMTP全局配置 --------------------------
+        self.SMTP_SENDER = sec.get("smtp_sender")
+        self.SMTP_PWD = sec.get("smtp_pwd")
+        self.SMTP_HOST = sec.get("smtp_host", "smtp.exmail.qq.com")
+        self.SMTP_PORT = int(sec.get("smtp_port", 465))
+        self.SMTP_TIMEOUT = 300  # 超时延长至5分钟
+        self.MAIL_RETRY_TIMES = 3  # 失败重试3次
+        self.MAIL_RETRY_INTERVAL = 5  # 重试间隔5秒
+
+        # -------------------------- Hive连接配置（run_sql使用） --------------------------
+        self.hive_host = os.getenv("HIVE_HOST") or sec.get("hive_host")
+        self.hive_port = int(sec.get("hive_port", 10023))
+        self.hive_user = os.getenv("HIVE_USER") or sec.get("hive_user")
+        self.hive_pwd = os.getenv("HIVE_PWD") or sec.get("hive_pwd")
+
+    # -------------------------- 密钥配置文件加载 --------------------------
+    def _load_secrets(self, script_dir):
+        """按优先级查找密钥配置文件（xinops_secrets.yaml 或 pypi_ku_secrets.yaml）：
+        1. 环境变量 XINOPS_CONFIG / PYPI_KU_CONFIG 指定的路径
+        2. 调用方脚本所在目录及其各级上层目录（最多向上3层）
+        3. 用户主目录
+        配置文件放在代码仓库之外，切勿提交到 git 或打包进 PyPI。
+        """
+        candidates = []
+        for env_key in ("XINOPS_CONFIG", "PYPI_KU_CONFIG"):
+            env_path = os.getenv(env_key)
+            if env_path:
+                candidates.append(env_path)
+
+        file_names = ("xinops_secrets.yaml", "pypi_ku_secrets.yaml")
+        # 从脚本所在目录开始向上查找（本目录 + 上3层）
+        d = script_dir
+        for _ in range(4):
+            for fn in file_names:
+                candidates.append(os.path.join(d, fn))
+            parent = os.path.dirname(d)
+            if parent == d:  # 已到根目录
+                break
+            d = parent
+
+        # 用户主目录兜底
+        home = os.path.expanduser("~")
+        for fn in file_names:
+            candidates.append(os.path.join(home, fn))
+
+        for path in candidates:
+            if os.path.exists(path):
+                try:
+                    with open(path, encoding="utf-8") as f:
+                        return yaml.safe_load(f) or {}
+                except yaml.YAMLError as e:
+                    raise ValueError(f"密钥配置文件格式错误（{path}）：{e}")
+
+        raise FileNotFoundError(
+            "未找到密钥配置文件 xinops_secrets.yaml（或 pypi_ku_secrets.yaml），已查找以下位置：\n"
+            + "\n".join(candidates)
+            + "\n请把配置文件放到业务脚本上层目录，或设置环境变量 XINOPS_CONFIG 指向实际路径"
+        )
+
+    # -------------------------- 脚本路径和文件名初始化 --------------------------
+    def Start_Get_filepath_and_filename(self):
+        self.start_time = time.time()
+        # ========== 新增：运行开始时追加10行空行分隔 ==========
+        # self.logger.info('\n' * 5)
+        caller_frame = inspect.stack()[1]
+        self.current_script_name = caller_frame.filename
+        self.log_filename = os.path.splitext(self.current_script_name)[0] + ".log"
+        self.current_script_names = os.path.basename(self.current_script_name)
+        self.current_path = os.path.dirname(os.path.abspath(self.current_script_name))
+        self.path = self.current_path + os.sep
+        print(f"当前时间：{self.get_date_and_time('%Y-%m-%d %H:%M:%S', 0)}")
+        print(f"开始执行脚本：{self.current_script_names}")
+        self.logger.info(f"开始执行脚本：{self.current_script_names}")
+
+    # -------------------------- 脚本结束处理 --------------------------
+    def End_operation(self):
+        print(f"脚本：{self.current_script_names} 执行成功")
+        self.logger.info(f"脚本：{self.current_script_names} 执行成功")
+        end_time = time.time()
+        elapsed_time = round(end_time - self.start_time, 0)
+        print(f"运行时间：{elapsed_time} 秒")
+        self.logger.info(f"运行时间：{elapsed_time} 秒")
+        # self.logger.info('\n' * 2)
+
+    # -------------------------- 获取指定格式的日期时间 --------------------------
+    def get_date_and_time(self, format_type, days):
+        today = datetime.datetime.today()
+        target_date = today - datetime.timedelta(days=days)
+        result = target_date.strftime(format_type)
+        return result
+
+    # -------------------------- 获取文件大小（KB） --------------------------
+    def get_FileSize(self, img_name):
+        fsize = os.path.getsize(img_name)
+        fsize = fsize / float(1024)
+        return round(fsize, 2)
+
+    # -------------------------- 列标转换（A,B,C...） --------------------------
+    def column_label(self, n):
+        result = ""
+        while n > 0:
+            n, remainder = divmod(n - 1, 26)
+            result = chr(65 + remainder) + result
+        return result
+
+    # -------------------------- 辅助方法：检查文件是否被占用 --------------------------
+    def is_file_locked(self, file_path):
+        if not os.path.exists(file_path):
+            return False
+        try:
+            with open(file_path, 'a', encoding='utf-8') as f:
+                pass
+            return False
+        except IOError:
+            return True
+
+    # -------------------------- 辅助方法：安全关闭Excel进程 --------------------------
+    def _safe_quit_excel(self, app):
+        """安全关闭Excel进程，优化时序检查逻辑"""
+        try:
+            pid = app.pid
+            # 先尝试正常退出
+            app.quit()
+
+            # 增加短暂延迟，等待进程自然退出（解决时序问题）
+            time.sleep(0.5)
+
+            # 检查进程是否还存在
+            if psutil.pid_exists(pid):
+                # 尝试优雅终止
+                proc = psutil.Process(pid)
+                proc.terminate()  # 发送终止信号
+
+                # 等待进程退出，最多等待3秒
+                try:
+                    proc.wait(timeout=3)
+                    self.logger.debug(f"Excel进程（PID: {pid}）已被强制终止")
+                except psutil.TimeoutExpired:
+                    # 超时后强制杀死进程
+                    proc.kill()
+                    self.logger.debug(f"Excel进程（PID: {pid}）超时未退出，已强制杀死")
+            else:
+                # 进程已正常退出，不记录警告
+                self.logger.debug(f"Excel进程（PID: {pid}）已正常退出")
+
+        except psutil.NoSuchProcess:
+            # 进程在检查前已退出，属于正常情况，不记录警告
+            self.logger.debug(f"Excel进程已提前退出（PID: {pid}）")
+        except Exception as e:
+            # 其他未知错误才记录警告
+            self.logger.warning(f"关闭Excel进程时发生异常: {str(e)}")