mdrtreadtool 2.0.0__py3-none-win_amd64.whl

mdrtreadtool/__init__.py

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+"""mdrtreadtool —— 医疗器械警戒趋势分析工具（编译发行版）。
+
+本包在 PyPI 上分发的是一个 **已编译** 的扩展模块 ``chart_tool.pyd``
+（Cython + CPython 稳定 ABI / abi3），不包含任何 ``.py`` 形式的业务源码。
+
+命令行入口::
+
+    mdrtreadtool                 启动图形界面
+    mdrtreadtool --selftest      环境自检（弹窗 + 写出报告）
+    mdrtreadtool --selftest --quiet
+    mdrtreadtool --info          只打印模块信息并做一次纯函数自检
+    mdrtreadtool --version       打印版本号
+
+在代码中使用::
+
+    import mdrtreadtool
+    print(mdrtreadtool.__version__)
+
+    from mdrtreadtool import load_module          # 只加载、不启动界面
+    mod = load_module()
+    den, ev = mod.make_sample_data()
+"""
+
+__version__ = "2.0.0"
+__author__ = "sysucai"
+__license__ = "Proprietary"
+__all__ = ["__version__", "__author__", "__license__", "load_module", "resource_path"]
+
+
+def load_module():
+    """加载并返回已编译的主程序模块（不启动界面）。
+
+    等价于 ``from mdrtreadtool import _loader; _loader.load_module()``；
+    放在这里是为了让 ``import mdrtreadtool`` 保持轻量（不在导入期碰 tkinter）。
+    """
+    from ._loader import load_module as _load
+    return _load()
+
+
+def resource_path(name):
+    """返回包内随附资源（如 chart_tool.ico）的绝对路径；不存在返回 None。"""
+    from ._loader import resource_path as _res
+    return _res(name)

mdrtreadtool/__main__.py

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+"""支持 ``python -m mdrtreadtool`` 方式启动。"""
+import sys
+
+from ._loader import main
+
+if __name__ == "__main__":
+    sys.exit(main())

mdrtreadtool/_loader.py

@@ -0,0 +1,313 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""mdrtreadtool 的编译模块加载器。
+
+包内随附的 ``chart_tool.pyd`` 是主程序经 Cython 编译、以 CPython 稳定 ABI
+（abi3，``Py_LIMITED_API = 0x03080000``）生成的扩展模块。同一个文件可以直接被
+CPython 3.8 / 3.9 / 3.10 / 3.11 / 3.12 / 3.13 / 3.14（Windows x64）加载，
+不必为每个版本重新编译。
+
+加载器**不 import 任何第三方库**——即便 numpy / pandas / matplotlib 缺失，
+也能先把 ``mdrtreadtool --info`` 跑起来，一眼看清是「模块加载失败」还是
+「运行依赖缺失」，而不是毫无提示地退出。
+
+命令行
+------
+    mdrtreadtool                     启动图形界面
+    mdrtreadtool --selftest          环境自检（弹窗 + 写出报告）
+    mdrtreadtool --selftest --quiet  只写报告、不弹窗
+    mdrtreadtool --info              不启动界面，只打印模块信息并做一次纯函数自检
+    mdrtreadtool --version           打印版本号
+    mdrtreadtool --no-update         本次启动不做自动更新
+
+除 ``--info`` / ``--version`` 外，其余参数原样交给主程序处理。
+
+自动更新
+--------
+启动时（``--info`` / ``--version`` 除外）会先尝试通过 pip 自动更新，见 ``_update`` 模块。
+**只对 pip 安装的发行版生效**：单文件 exe（``sys.frozen``）环境会直接跳过——exe 的升级
+方式是替换新 exe，不该由 pip 覆盖。
+关键点是**时机**：更新必须在 import ``chart_tool.pyd`` **之前**完成——该文件一旦被加载
+就被 Windows 锁定、无法覆盖；而在加载前替换掉，本次启动用到的就是新版本。
+
+三步（查询 / 下载 / 安装）各带超时，任何一步超时或失败都只打印一行提示并继续启动；
+正常情况下**完全静默**。用 ``MDRTREADTOOL_UPDATE_VERBOSE=1`` 可看到每一步的结果，
+用 ``MDRTREADTOOL_NO_UPDATE=1`` 或 ``--no-update`` 可关闭。
+"""
+import importlib.machinery
+import importlib.util
+import os
+import sys
+
+PACKAGE = "mdrtreadtool"
+HERE = os.path.dirname(os.path.abspath(__file__))
+
+# 优先按此顺序找模块文件；找不到再扫描本包目录下任意扩展模块
+PREFERRED = ("chart_tool", "警戒图表工具")
+EXT_SUFFIXES = (".pyd", ".so", ".dylib")
+
+
+# ---------------------------------------------------------------------------
+# 模块定位与加载
+# ---------------------------------------------------------------------------
+def _module_dirs():
+    """按优先级返回「模块搜索目录」列表。
+
+    正常安装时模块就在本包目录里；额外兼容两种非 pip 场景：
+      · PyInstaller 单文件 exe —— 解包目录 sys._MEIPASS
+      · 绿色目录              —— 可执行文件所在目录
+    """
+    cands = []
+    meipass = getattr(sys, "_MEIPASS", None)
+    if meipass:
+        cands.append(meipass)
+    if getattr(sys, "frozen", False):
+        try:
+            cands.append(os.path.dirname(os.path.abspath(sys.executable)))
+        except Exception:                                   # noqa: BLE001
+            pass
+    cands.append(HERE)
+    out, seen = [], set()
+    for d in cands:
+        d = os.path.abspath(d)
+        if d not in seen:
+            seen.add(d)
+            out.append(d)
+    return out
+
+
+def _pick_module():
+    """返回 (模块文件绝对路径, 模块短名)。
+
+    短名必须取自**文件名**第一个点之前的部分：扩展模块的初始化函数名
+    （``PyInit_<短名>``）在编译时已固定，加载时给的短名与它不一致就会导入失败。
+    """
+    found = []                                  # [(目录, 文件绝对路径), ...]
+    for d in _module_dirs():
+        try:
+            names = sorted(os.listdir(d))
+        except OSError:
+            continue
+        for fn in names:
+            if fn.lower().endswith(EXT_SUFFIXES) and not fn.startswith("__"):
+                found.append((d, os.path.join(d, fn)))
+    for want in PREFERRED:                      # 先按首选名精确匹配
+        for _d, p in found:
+            if os.path.basename(p).split(".")[0].lower() == want.lower():
+                return p, os.path.basename(p).split(".")[0]
+    # 未命中首选名时，只有在「未打包」的情况下才退回到任意扩展模块——打包后的
+    # 解包目录里还躺着 numpy / pandas 等一大批 .pyd，盲目取第一个会加载错对象。
+    if found and not getattr(sys, "frozen", False):
+        p = found[0][1]
+        return p, os.path.basename(p).split(".")[0]
+    return None, None
+
+
+def _load_module(path, shortname):
+    """按显式模块名加载扩展模块（不用 __import__，以免依赖 sys.path 与文件命名约定）。"""
+    fullname = "%s.%s" % (PACKAGE, shortname)
+    loader = importlib.machinery.ExtensionFileLoader(fullname, path)
+    spec = importlib.util.spec_from_file_location(fullname, path, loader=loader)
+    if spec is None or spec.loader is None:
+        raise ImportError("无法为 %s 创建加载器。" % path)
+    mod = importlib.util.module_from_spec(spec)
+    sys.modules.setdefault(fullname, mod)       # 先登记，便于模块内部自引用
+    try:
+        spec.loader.exec_module(mod)
+    except BaseException:
+        sys.modules.pop(fullname, None)
+        raise
+    return mod
+
+
+def resource_path(name):
+    """返回包内随附资源（如 chart_tool.ico）的绝对路径；不存在返回 None。"""
+    for d in _module_dirs():
+        p = os.path.join(d, name)
+        try:
+            if os.path.isfile(p):
+                return p
+        except Exception:                                   # noqa: BLE001
+            pass
+    return None
+
+
+# ---------------------------------------------------------------------------
+# 失败提示
+# ---------------------------------------------------------------------------
+def _notify(title, text):
+    """无控制台时用弹窗提示致命错误。
+
+    有控制台就不打扰：信息已经写到 stderr。若用 pythonw / gui 方式启动，
+    ``sys.stderr`` 为 None，不做这一步用户只会看到「启动了但没反应」。
+    """
+    if sys.stderr is not None:
+        return
+    try:
+        import tkinter as tk
+        from tkinter import messagebox
+        root = tk.Tk()
+        root.withdraw()
+        messagebox.showerror(title, text)
+        root.destroy()
+    except Exception:                                       # noqa: BLE001
+        pass
+
+
+def _fail(msg, hint=""):
+    text = "\n[%s] 无法启动：%s\n" % (PACKAGE, msg)
+    if hint:
+        text += "\n%s\n" % hint
+    try:
+        sys.stderr.write(text)
+    except Exception:                                       # noqa: BLE001
+        pass
+    _notify("无法启动", ("%s\n\n%s" % (msg, hint)).strip())
+    return 2
+
+
+# ---------------------------------------------------------------------------
+# 对外接口
+# ---------------------------------------------------------------------------
+def load_module():
+    """加载并返回已编译的主程序模块（不启动界面）。
+
+    失败时抛出 ImportError / ModuleNotFoundError，供调用方自行处理；
+    命令行路径请用 main()，它会给出中文提示而不是抛栈。
+    """
+    path, shortname = _pick_module()
+    if path is None:
+        raise ImportError(
+            "在 %s 中没有找到扩展模块（%s）。请重新安装："
+            "python -m pip install --force-reinstall mdrtreadtool"
+            % (HERE, " / ".join(EXT_SUFFIXES)))
+    return _load_module(path, shortname)
+
+
+def _auto_update(argv):
+    """启动时尝试通过 pip 自动更新；任何异常都不影响启动。
+
+    只在真正启动程序（以及 ``--selftest``）时调用；``--info`` / ``--version`` 这类
+    诊断用法不会触发联网。``--no-update`` 或 ``MDRTREADTOOL_NO_UPDATE=1`` 可关闭。
+
+    **单文件 exe 环境不自动更新**：exe 自带解释器与依赖，升级方式是替换新 exe，
+    不应由 pip 覆盖。此处与 ``_update.maybe_update()`` 各设一道守卫。
+    """
+    if getattr(sys, "frozen", False):
+        return None
+    if "--no-update" in argv or "-no-update" in argv:
+        return None
+    try:
+        from . import _update
+    except Exception:                                       # noqa: BLE001
+        return None
+    try:
+        return _update.maybe_update(say=_say)
+    except Exception:                                       # noqa: BLE001
+        return None
+
+
+def _say(text):
+    """往控制台写一行；无 stdout 时安静放弃（不打断启动）。"""
+    try:
+        sys.stdout.write(text + "\n")
+        sys.stdout.flush()
+    except Exception:                                       # noqa: BLE001
+        pass
+
+
+def _print_info(mod, path, name):
+    print("=" * 72)
+    print("  mdrtreadtool 模块信息")
+    print("=" * 72)
+    try:
+        from . import __version__ as _v
+    except Exception:                                       # noqa: BLE001
+        _v = "?"
+    print("  版本         : %s" % _v)
+    print("  Python       : %s (%d 位)"
+          % (sys.version.split()[0], 64 if sys.maxsize > 2 ** 32 else 32))
+    print("  解释器       : %s" % sys.executable)
+    print("  模块文件     : %s" % getattr(mod, "__file__", path))
+    print("  模块名       : %s" % getattr(mod, "__name__", name))
+    print("  程序目录     : %s" % (mod._app_dir() if hasattr(mod, "_app_dir") else "?"))
+    print("  窗口图标     : %s" % (resource_path("chart_tool.ico") or "（未随包提供，将使用默认图标）"))
+    try:
+        from . import _update
+        print("  自动更新     : %s" % _update.summary())
+    except Exception:                                       # noqa: BLE001
+        print("  自动更新     : （不可用）")
+    print("  可调用入口   : main=%s  run_selftest=%s"
+          % (callable(getattr(mod, "main", None)),
+             callable(getattr(mod, "run_selftest", None))))
+    try:
+        den, ev = mod.make_sample_data()
+        df, meta = mod.compute_pareto(ev, risk_dim="器械故障表现", gran="Q")
+        print("  纯函数自检   : 示例数据 %d 期分母 / %d 例事件；帕累托 %s→%s 共 %d 类"
+              % (len(den), len(ev), meta["period_prev"], meta["period_curr"], len(df)))
+        print("  依据         : Python %s（稳定 ABI / abi3，支持 3.8~3.14）"
+              % sys.version.split()[0])
+        print("=" * 72)
+        print("  结果：模块加载与统计函数均正常。执行  mdrtreadtool  启动界面。")
+    except Exception as exc:                                # noqa: BLE001
+        print("  [警告] 纯函数自检失败：%s: %s" % (type(exc).__name__, exc))
+        print("=" * 72)
+    return 0
+
+
+def main(argv=None):
+    """命令行入口：定位、加载编译模块，然后按参数启动界面或自检。"""
+    argv = list(sys.argv[1:] if argv is None else argv)
+
+    if "--version" in argv or "-V" in argv:
+        try:
+            from . import __version__ as _v
+        except Exception:                                   # noqa: BLE001
+            _v = "?"
+        print("%s %s" % (PACKAGE, _v))
+        return 0
+
+    # 自动更新：必须在 import chart_tool.pyd 之前完成——该文件一旦被加载就被 Windows
+    # 锁定、无法覆盖；在加载前替换掉，本次启动用到的就是新版本。
+    # --info 属于纯诊断用法，不触发联网。
+    if "--info" not in argv:
+        _auto_update(argv)
+
+    path, name = _pick_module()
+    if path is None:
+        return _fail(
+            "本包中没有找到扩展模块（%s）。" % " / ".join(EXT_SUFFIXES),
+            "安装似乎不完整，请重装：\n    %s -m pip install --force-reinstall mdrtreadtool"
+            % os.path.basename(sys.executable))
+    try:
+        mod = _load_module(path, name)
+    except ModuleNotFoundError as exc:
+        miss = getattr(exc, "name", "") or str(exc)
+        return _fail(
+            "加载 %s 时缺少运行依赖：%s" % (os.path.basename(path), miss),
+            "请先安装依赖：\n    %s -m pip install numpy pandas matplotlib openpyxl\n"
+            "（本 .pyd 只需要 Python 运行时依赖，不需要编译器或 Cython。）"
+            % os.path.basename(sys.executable))
+    except ImportError as exc:
+        return _fail("加载 %s 失败：%s" % (os.path.basename(path), exc),
+                     "常见原因：\n"
+                     "  · .pyd 与当前 Python 版本/架构不匹配（本 .pyd 支持 CPython 3.8~3.14、64 位）；\n"
+                     "  · 安装过程中文件损坏，请重装：pip install --force-reinstall mdrtreadtool")
+    except OSError as exc:
+        return _fail("加载 %s 失败（%s）" % (os.path.basename(path), exc),
+                     "若提示「不是有效的 Win32 应用程序」，说明位数不匹配："
+                     "本 .pyd 为 64 位，请使用 64 位 Python。")
+
+    if "--info" in argv:
+        return _print_info(mod, path, name)
+
+    entry = getattr(mod, "main", None)
+    if not callable(entry):
+        return _fail("%s 里没有 main() 入口，可能编译的不是主程序源码。"
+                     % os.path.basename(path))
+    entry()                     # 主程序内部负责界面生命周期与进程退出
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

mdrtreadtool/_update.py

@@ -0,0 +1,389 @@
+# -*- coding: utf-8 -*-
+"""mdrtreadtool 的自动更新（仅对 pip 安装的发行版生效）。
+
+设计要点
+--------
+1. **只服务 pip 安装版**：本模块由 ``_loader.py`` 调用，而 ``_loader.py`` 只存在于
+   PyPI 分发的 wheel 里；源码运行（``python gen.py``）与单文件 exe 都不走这条路，
+   因此不受影响。为保险起见，``maybe_update()`` 还会显式检查 ``sys.frozen``，
+   一旦处于 PyInstaller 打包环境就立即跳过——exe 有自己的升级途径（换新 exe），
+   绝不该被 pip 覆盖。
+2. **在加载编译模块之前执行**：``chart_tool.pyd`` 一旦被 import 就会被 Windows 锁定，
+   无法覆盖。加载器在 import 之前完成更新，随后 import 到的就是新版本，本次启动即生效。
+3. **节流**：两次联网检查之间至少间隔 ``CHECK_INTERVAL``，避免每次启动都等网络。
+4. **超时即跳过**：查询 / 下载 / 安装三步各带超时，任何一步超时或失败都只记一笔日志，
+   绝不影响程序正常启动（所有异常都被吞掉）。
+5. **只升不降**：仅当 PyPI 上的版本高于本机已装版本时才更新。
+
+可用的环境变量
+--------------
+    MDRTREADTOOL_NO_UPDATE=1        关闭自动更新
+    MDRTREADTOOL_UPDATE_FORCE=1     忽略节流，本次强制联网检查
+    MDRTREADTOOL_UPDATE_VERBOSE=1   打印每一步的结果（正常、已最新、超时等）
+    MDRTREADTOOL_UPDATE_DIR=<目录>  覆盖状态文件与下载目录（默认 ~/treadtools/updates）
+    MDRTREADTOOL_PYPI_JSON=<URL>    覆盖 PyPI JSON 地址（便于离线自测 / 内网镜像）
+"""
+import json
+import os
+import re
+import shutil
+import subprocess
+import sys
+import time
+import urllib.request
+
+PROJECT = "mdrtreadtool"
+USER_AGENT = "mdrtreadtool-updater/2.0"
+
+# 两次联网检查之间的最小间隔（秒）。到点才联网，平时启动不等网络。
+CHECK_INTERVAL = 6 * 3600
+# 查询 / 下载 / 安装 三步各自的超时（秒）。
+CHECK_TIMEOUT = 5.0
+DOWNLOAD_TIMEOUT = 45.0
+INSTALL_TIMEOUT = 180.0
+
+# 本机是 Windows x64，包里是 abi3 通用轮子；按顺序挑第一个匹配的。
+WHEEL_TAGS = ("py3-none-win_amd64",)
+
+ENV_PYPI_JSON = "MDRTREADTOOL_PYPI_JSON"
+ENV_UPDATE_DIR = "MDRTREADTOOL_UPDATE_DIR"
+ENV_NO_UPDATE = "MDRTREADTOOL_NO_UPDATE"
+ENV_FORCE = "MDRTREADTOOL_UPDATE_FORCE"
+ENV_VERBOSE = "MDRTREADTOOL_UPDATE_VERBOSE"
+
+DEFAULT_PYPI_JSON = "https://pypi.org/pypi/%s/json" % PROJECT
+
+
+# ---------------------------------------------------------------------------
+# 小工具
+# ---------------------------------------------------------------------------
+def _truthy(name):
+    return os.environ.get(name, "").strip().lower() in ("1", "yes", "true", "on")
+
+
+def _default_say(text):
+    """往控制台写一行；无 stdout（如 pythonw）时安静地放弃。"""
+    try:
+        sys.stdout.write(text + "\n")
+        sys.stdout.flush()
+    except Exception:                                       # noqa: BLE001
+        pass
+
+
+def _log(say, verbose, text):
+    if verbose:
+        say(text)
+
+
+def _short(exc):
+    """把异常压成一句短的中文原因。"""
+    s = str(exc) or type(exc).__name__
+    low = s.lower()
+    if isinstance(exc, TimeoutError) or "timed out" in low or "timeout" in low:
+        return "超时"
+    if ("refused" in low or "unreachable" in low or "getaddrinfo" in low
+            or "name or service" in low or "temporary failure" in low):
+        return "无法连接"
+    return s[:80]
+
+
+def _parse_version(text):
+    """把版本号压成可比较的数字元组；取不到数字段时返回空元组。"""
+    m = re.match(r"^(\d+(?:\.\d+)*)", str(text or "").strip())
+    return tuple(int(x) for x in m.group(1).split(".")) if m else ()
+
+
+def _newer(candidate, current):
+    return _parse_version(candidate) > _parse_version(current)
+
+
+# ---------------------------------------------------------------------------
+# 状态文件
+# ---------------------------------------------------------------------------
+def update_dir():
+    """状态文件与下载缓存所在目录。"""
+    d = os.environ.get(ENV_UPDATE_DIR)
+    if not d:
+        d = os.path.join(os.path.expanduser("~"), "treadtools", "updates")
+    return d
+
+
+def _state_path():
+    return os.path.join(update_dir(), "state.json")
+
+
+def _load_state():
+    try:
+        with open(_state_path(), "r", encoding="utf-8") as f:
+            data = json.load(f)
+        return data if isinstance(data, dict) else {}
+    except Exception:                                       # noqa: BLE001
+        return {}
+
+
+def _save_state(state):
+    try:
+        os.makedirs(update_dir(), exist_ok=True)
+        tmp = _state_path() + ".tmp"
+        with open(tmp, "w", encoding="utf-8") as f:
+            json.dump(state, f, ensure_ascii=False, indent=2)
+        os.replace(tmp, _state_path())
+    except Exception:                                       # noqa: BLE001
+        pass
+
+
+# ---------------------------------------------------------------------------
+# 版本探测
+# ---------------------------------------------------------------------------
+def installed_version():
+    """返回本机已安装的发行版版本号；不是 pip 安装（或取不到）时返回 None。"""
+    try:
+        from importlib.metadata import version as _version   # Python 3.8+
+        return _version(PROJECT)
+    except Exception:                                       # noqa: BLE001
+        pass
+    try:
+        from . import __version__
+        return __version__
+    except Exception:                                       # noqa: BLE001
+        return None
+
+
+# ---------------------------------------------------------------------------
+# 联网
+# ---------------------------------------------------------------------------
+def _http_get(url, timeout):
+    req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})
+    with urllib.request.urlopen(req, timeout=timeout) as resp:
+        return resp.read()
+
+
+def _download(url, dest, timeout):
+    """流式下载到 dest；先写 .part 再改名，中途中断不会留下半个可用文件。"""
+    req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})
+    deadline = time.time() + timeout
+    tmp = dest + ".part"
+    try:
+        with urllib.request.urlopen(req, timeout=min(15.0, timeout)) as resp, \
+                open(tmp, "wb") as fh:
+            while True:
+                if time.time() > deadline:
+                    raise TimeoutError("download timed out")
+                chunk = resp.read(65536)
+                if not chunk:
+                    break
+                fh.write(chunk)
+        os.replace(tmp, dest)
+    except BaseException:
+        try:
+            os.remove(tmp)
+        except Exception:                                   # noqa: BLE001
+            pass
+        raise
+    return dest
+
+
+def _pick_wheel(info, version):
+    """从 PyPI JSON 里挑出适用于本机的轮子，返回 (文件名, 下载地址)。"""
+    cands = []
+    for item in (info.get("urls") or []):
+        name = item.get("filename") or ""
+        if item.get("packagetype") and item["packagetype"] != "bdist_wheel":
+            continue
+        if name.endswith(".whl") and item.get("url"):
+            cands.append((name, item["url"]))
+    if not cands:
+        for item in ((info.get("releases") or {}).get(version) or []):
+            name = item.get("filename") or ""
+            if name.endswith(".whl") and item.get("url"):
+                cands.append((name, item["url"]))
+    for tag in WHEEL_TAGS:
+        for name, url in cands:
+            if tag in name:
+                return name, url
+    return (cands[0] if cands else (None, None))
+
+
+def _check(current):
+    """查询 PyPI；有新版本返回 dict，否则返回 None。网络异常直接抛出，由调用方兜住。"""
+    url = os.environ.get(ENV_PYPI_JSON) or DEFAULT_PYPI_JSON
+    info = json.loads(_http_get(url, CHECK_TIMEOUT).decode("utf-8"))
+    latest = str(((info.get("info") or {}).get("version")) or "").strip()
+    if not latest or not _newer(latest, current):
+        return None
+    name, wheel_url = _pick_wheel(info, latest)
+    return {"version": latest, "wheel": name, "url": wheel_url}
+
+
+# ---------------------------------------------------------------------------
+# 安装
+# ---------------------------------------------------------------------------
+def _pip_install(path, timeout):
+    """用 pip 装本地轮子，返回 (返回码, 合并后的输出文本)。
+
+    用 --no-index 是因为轮子已经在本地：既不必再访问索引，也避免取到别的版本。
+    --force-reinstall 保证即使版本号相同也能覆盖。
+    """
+    exe = sys.executable or shutil.which("python") or "python"
+    cmd = [exe, "-m", "pip", "install",
+           "--upgrade", "--force-reinstall", "--no-deps", "--no-index",
+           "--disable-pip-version-check", "--no-input", path]
+    kwargs = {}
+    if os.name == "nt":
+        kwargs["creationflags"] = 0x08000000            # CREATE_NO_WINDOW
+    try:
+        proc = subprocess.run(cmd, stdin=subprocess.DEVNULL,
+                              stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
+                              timeout=timeout, **kwargs)
+        return proc.returncode, (proc.stdout or b"").decode("utf-8", "replace")
+    except subprocess.TimeoutExpired:
+        return -1, "pip 安装超时"
+    except Exception as exc:                                # noqa: BLE001
+        return -2, "%s: %s" % (type(exc).__name__, exc)
+
+
+# ---------------------------------------------------------------------------
+# 主流程
+# ---------------------------------------------------------------------------
+def summary():
+    """给 ``--info`` 用的一行状态说明。"""
+    if getattr(sys, "frozen", False):
+        return "单文件 exe 运行环境，不自动更新（exe 靠替换新版本升级）"
+    current = installed_version() or "未知"
+    state = _load_state()
+    last = state.get("last_check")
+    if last:
+        try:
+            when = time.strftime("%Y-%m-%d %H:%M", time.localtime(float(last)))
+        except Exception:                                   # noqa: BLE001
+            when = "?"
+    else:
+        when = "从未"
+    text = "当前 %s；上次联网检查 %s" % (current, when)
+    err = state.get("last_error")
+    if err:
+        text += "；上次异常 %s" % str(err)[:60]
+    return text
+
+
+def maybe_update(say=None, force=False):
+    """启动时调用一次。
+
+    永远不抛异常。返回状态 dict：
+        status ∈ updated / available / uptodate / throttled / offline
+                 / disabled / frozen / unknown
+        current  本机原版本号
+        version  本次发现的可用新版本号（若有）
+        detail   失败原因（若有）
+    """
+    say = say or _default_say
+    verbose = _truthy(ENV_VERBOSE) or force
+    st = {"status": "unknown", "current": None, "version": None, "detail": ""}
+
+    # 单文件 exe（PyInstaller）环境一律不自动更新：exe 自带 Python 运行时与依赖，
+    # 用 pip 去升级既没有意义，也可能把环境搞乱。exe 的升级方式就是换一个新的 exe。
+    if getattr(sys, "frozen", False):
+        st["status"] = "frozen"
+        st["detail"] = "单文件 exe 运行环境"
+        _log(say, verbose, "[更新] 当前是单文件 exe 运行环境，自动更新只对 pip 安装版生效，已跳过。")
+        return st
+
+    if _truthy(ENV_NO_UPDATE):
+        st["status"] = "disabled"
+        _log(say, verbose, "[更新] 已关闭自动更新。")
+        return st
+
+    current = installed_version()
+    st["current"] = current
+    if not current:
+        # 不是 pip 安装（例如手工拷贝的目录），不擅自升级
+        _log(say, verbose, "[更新] 未检测到已安装的发行版信息，跳过自动更新。")
+        return st
+
+    state = _load_state()
+    now = time.time()
+    if not (force or _truthy(ENV_FORCE)) and \
+            (now - float(state.get("last_check") or 0)) < CHECK_INTERVAL:
+        st["status"] = "throttled"
+        _log(say, verbose, "[更新] 距上次检查不足 %d 小时，本次跳过。"
+             % (CHECK_INTERVAL // 3600))
+        return st
+
+    try:
+        found = _check(current)
+    except Exception as exc:                                # noqa: BLE001
+        state["last_check"] = now
+        state["last_error"] = "%s: %s" % (type(exc).__name__, exc)
+        _save_state(state)
+        st["status"] = "offline"
+        st["detail"] = state["last_error"]
+        _log(say, verbose, "[更新] 检查更新失败（%s），已跳过，本次用 %s 启动。"
+             % (_short(exc), current))
+        return st
+
+    state["last_check"] = now
+    state.pop("last_error", None)
+    _save_state(state)
+
+    if not found:
+        st["status"] = "uptodate"
+        _log(say, verbose, "[更新] 已是最新版本 %s。" % current)
+        return st
+
+    latest = found["version"]
+    st["version"] = latest
+
+    if not found.get("url"):
+        st["status"] = "available"
+        st["detail"] = "PyPI 上没有适用于本机的轮子"
+        state["last_error"] = st["detail"]
+        _save_state(state)
+        say("[更新] 发现新版本 %s，但 PyPI 上没有适用于本机的轮子，已跳过。" % latest)
+        return st
+
+    say("[更新] 发现新版本 %s（当前 %s），正在通过 pip 更新 ..." % (latest, current))
+
+    dest = os.path.join(update_dir(), found["wheel"])
+    try:
+        os.makedirs(update_dir(), exist_ok=True)
+        _download(found["url"], dest, DOWNLOAD_TIMEOUT)
+    except Exception as exc:                                # noqa: BLE001
+        st["status"] = "available"
+        st["detail"] = "%s: %s" % (type(exc).__name__, exc)
+        state["last_error"] = st["detail"]
+        _save_state(state)
+        say("[更新] 新版本 %s 下载失败（%s），已跳过，本次仍用 %s 启动。"
+            % (latest, _short(exc), current))
+        return st
+
+    rc, out = _pip_install(dest, INSTALL_TIMEOUT)
+    if rc != 0:
+        st["status"] = "available"
+        st["detail"] = (out or "rc=%s" % rc)[-400:]
+        state["last_error"] = st["detail"]
+        _save_state(state)
+        say("[更新] 新版本 %s 安装失败，已跳过。可手动执行："
+            "pip install --upgrade %s" % (latest, PROJECT))
+        _log(say, verbose, "[更新] pip 输出：%s" % (out or "").strip())
+        return st
+
+    import importlib
+    importlib.invalidate_caches()
+    after = installed_version()
+    st["installed"] = after
+    try:
+        os.remove(dest)                                     # 装完即清，避免下次重复占用
+    except Exception:                                       # noqa: BLE001
+        pass
+
+    if after and _parse_version(after) >= _parse_version(latest):
+        st["status"] = "updated"
+        say("[更新] 更新完成：%s → %s，本次启动即为新版本。" % (current, after))
+    else:
+        st["status"] = "available"
+        st["detail"] = "安装完成但版本未变（当前仍报 %s）" % after
+        state["last_error"] = st["detail"]
+        _save_state(state)
+        say("[更新] 更新似乎未生效（当前仍为 %s）。可手动执行："
+            "pip install --upgrade %s" % (after, PROJECT))
+    return st

mdrtreadtool-2.0.0.dist-info/METADATA

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: mdrtreadtool
+Version: 2.0.0
+Summary: 医疗器械警戒趋势分析工具：把分母表与不良事件表一键生成控制图 / 直方图 / 帕累托图（编译发行版，Windows x64 / Python 3.8+）
+Author: sysucai
+Maintainer: sysucai
+License-Expression: LicenseRef-Proprietary
+Keywords: medical-device,vigilance,SPC,control-chart,p-chart,pareto,histogram,trend-analysis,医疗器械,警戒
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: openpyxl
+Provides-Extra: image
+Requires-Dist: Pillow>=9.0; extra == "image"
+Provides-Extra: xls
+Requires-Dist: xlrd>=2.0; extra == "xls"
+Provides-Extra: all
+Requires-Dist: Pillow>=9.0; extra == "all"
+Requires-Dist: xlrd>=2.0; extra == "all"
+Dynamic: license-file
+
+# mdrtreadtool · 医疗器械警戒趋势分析工具
+
+把「**分母表**（使用基数表）」与「**不良事件表**」两张 Excel 表，一键生成医疗器械警戒趋势报告所需的**三类统计图表**——控制图、直方图、帕累托图。
+
+面向医疗器械注册人 / 不良事件监测人员，依据《医疗器械趋势报告撰写指南》（试行）编制：控制图支持 P / NP / U / C 四种常规控制图与 G 图（稀有事件几何控制图），直方图按「型号比较」口径拆解故障表现 / 伤害表现，帕累托图支持两个时期对比。
+
+本发行版在 PyPI 上提供的是**已编译**的扩展模块（Cython + CPython 稳定 ABI / abi3），**不含 `.py` 业务源码**，与官方 exe 版行为完全一致。
+
+---
+
+## 系统要求
+
+| 项目 | 要求 |
+|---|---|
+| 操作系统 | Windows 10 / 11 / Server（**仅 64 位**） |
+| Python | **3.8 及以上**（CPython 3.8 ~ 3.14 均可，同一个轮子通用） |
+| 运行依赖 | `numpy`、`pandas`、`matplotlib`、`openpyxl`（`pip` 会自动安装） |
+
+> 轮子的文件名是 `mdrtreadtool-2.0.0-py3-none-win_amd64.whl`。因为随附的 `.pyd` 是以 **CPython 稳定 ABI（abi3）** 编译的，只依赖系统自带的 `python3.dll`，所以一个轮子可在 3.8 ~ 3.14 上直接加载，不必按版本分别编译或分别下载。
+
+---
+
+## 安装
+
+```bash
+python -m pip install mdrtreadtool
+```
+
+升级到最新版：
+
+```bash
+python -m pip install --upgrade mdrtreadtool
+```
+
+可选组件（不装也能用，程序会自动降级）：
+
+```bash
+python -m pip install "mdrtreadtool[image]"    # Pillow：抗锯齿圆角按钮 + 帮助插图
+python -m pip install "mdrtreadtool[xls]"      # xlrd：读取 Excel 97-2003 的 .xls 旧格式
+python -m pip install "mdrtreadtool[all]"      # 以上全部
+```
+
+---
+
+## 启动
+
+```bash
+mdrtreadtool
+```
+
+图形界面会直接打开。也可以在 Python 里以模块方式启动：
+
+```bash
+python -m mdrtreadtool
+```
+
+### 命令行参数
+
+| 命令 | 作用 |
+|---|---|
+| `mdrtreadtool` | 启动图形界面 |
+| `mdrtreadtool --selftest` | 环境自检：检查 Python / 依赖 / 中文字体 / 绘图内核，弹窗显示并写出报告 |
+| `mdrtreadtool --selftest --quiet` | 同上，只写报告、不弹窗（适合脚本批量检查） |
+| `mdrtreadtool --info` | 不启动界面，只打印模块信息并跑一次纯函数自检（排查问题时最先用这个） |
+| `mdrtreadtool --version` | 打印版本号 |
+| `mdrtreadtool --no-update` | 本次启动不做自动更新 |
+
+> 程序首次启动时会弹出一个「用户登记」窗口。**直接关闭即可**——不登记不影响任何功能；登记后仅用于接收版本更新通知。
+
+### 自动更新
+
+程序启动时会自动检查 PyPI 上有没有新版本，有的话**通过 pip 自动升级，本次启动即用上新版本**。
+整个过程带超时保护：**查询、下载、安装三步各自的超时一到就放弃**，绝不会卡住或影响启动。
+
+- 正常情况**完全静默**；只有真的发生了更新（或更新失败需要你手动处理）才会打印一行提示。
+- 为减少等待，联网检查**最长每 6 小时一次**；其余启动不再联网。
+- 想看看它到底干了什么：`set MDRTREADTOOL_UPDATE_VERBOSE=1`，或直接 `mdrtreadtool --info`（末行会显示上次检查时间）。
+- 想临时/永久关掉：加参数 `--no-update`，或设环境变量 `MDRTREADTOOL_NO_UPDATE=1`。
+- 内网镜像 / 离线自测：`set MDRTREADTOOL_PYPI_JSON=<你的 JSON 地址>`。
+
+> **注意**：自动更新**只对 `pip install` 安装的版本生效**。
+> 源码运行（`python gen.py`）不涉及；单文件 exe 版**完全不做自动更新**——exe 自带
+> Python 运行时与依赖，升级方式就是替换一个新的 exe，程序不会去执行 pip。
+> 换句话说，只有在 pip 环境里跑 `mdrtreadtool` 的用户会被自动更新。
+
+---
+
+## 数据准备
+
+导入一个 `.xlsx` 文件，内含两张工作表：**第一张 = 不良事件表**，**第二张 = 分母表**。
+（工作表名含「事件 / 不良」或「分母 / 基数」时按名字匹配，否则按上述顺序取；只有一张表时按列判断归属。没有分母表时，「发生率」类指标不可用。）
+
+### 分母表（使用基数表）—— 固定 6 列
+
+| 注册证编号/曾用注册证编号 | 型号 | 规格 | 产品批号 | 月份 | 使用基数 |
+|---|---|---|---|---|---|
+
+- 「月份」支持 `2026-01` / `2026/01` / `2026-01-05`，会自动取所属月；
+- 一行 = 某注册证下某型号 / 规格 / 批号在某月的使用基数。
+
+### 不良事件表 —— 至少包含
+
+| 报告编码 | 事件发生日期 | 注册证编号/曾用注册证编号 |
+|---|---|---|
+
+可选列：`型号`、`规格`、`产品批号`、`器械故障表现`、`伤害表现`（用于直方图与帕累托图的分组维度）。
+
+> 界面上点「下载示例数据」可导出一份符合上述约定的样例文件，照着填即可。
+
+**分母对不齐时**：选「发生率」出图时，若某些取值在分母表中找不到对应记录，程序会先弹窗告诉你具体缺哪些维度、涉及多少条事件，由你决定「忽略这些事件继续生成」还是「取消本次生成」。
+
+---
+
+## 三类图表
+
+### 1. 控制图
+
+按月份 / 季度观察风险表现是否超出控制限。
+
+| 图型 | 适用数据 | 控制限 |
+|---|---|---|
+| **P 图** | 不良率（二项） | `p̄ ± 3·√( p̄(1-p̄) / nᵢ )` |
+| **NP 图** | 不良数（二项） | 同上 × `nᵢ` |
+| **U 图** | 单位缺陷数（泊松） | `ū ± 3·√( ū / nᵢ )` |
+| **C 图** | 缺陷数（泊松） | 同上 × `nᵢ` |
+| **G 图** | 稀有事件·事件间隔（几何分布） | `CL = ln2·ḡ`、`UCL = ḡ + 3·√(ḡ(ḡ+1))`、`LCL ≡ 0` |
+
+- 中心线 `p̄ = Σ风险表现数 / Σ使用基数`（加权汇集，GB/T 17989.2—2020 口径），图下脚注给出与「简单平均」口径的实际差异；
+- 控制限随各期分母 `nᵢ` 变化呈锯齿状；仅当分母固定时退化为水平直线；
+- G 图方向与 P 图相反：间隔越短 = 事件越密 = 风险升高；配合 1.5×IQR 参考线（探索性离群参考线，**不是**控制限）。
+
+### 2. 直方图（型号比较）
+
+按型号 / 注册证编号分组，拆解故障表现 / 伤害表现作对比（依据《指南》附录 1「直方图法·型号比较」）。
+
+- 指标支持「发生率（需分母表）」「数量」「构成比」，默认发生率；
+- 发生率 = 风险表现数 ÷ 使用基数 × 100%；构成比 = 该组该类风险表现数 ÷ 该组全部风险表现数 × 100%（分母不因「展示前 N 组」截断）。
+
+### 3. 帕累托图
+
+按月份 / 季度（或故障 / 伤害表现）排序并叠加累计占比，默认对比「上期 → 本期」两期。
+
+- 期次可按粒度选择，也可用「指定时间段」自定两段日期区间（如 `20240103–20240630` vs `20240701–20241231`）；
+- 支持一键导出帕累托数据表（.xlsx）。
+
+### 附带能力
+
+- **参数自动记忆**：所有界面参数保存在 `~/treadtools/setting.json`，下次启动原样回填；
+- **数值显示统一口径**：可在「总体设置」里切换百分数 / 小数、自动适配有效数字或手动指定位数，改动即时重绘；
+- **数据校验报告**：导入时给出 6 节校验（概况 / 必要列完整性 / 分子表覆盖范围 / 分母表覆盖范围 / 数据质量 / 数据剔除），可导出为 Markdown；
+- **统计表与图完全一致**：控制图 / 直方图可「显示表格」「导出表格」，表格口径与图中参考序列严格对齐；
+- **容错**：自动绕过 openpyxl 3.1.0~3.1.2 解析 `autoFilter` 的已知缺陷，坏文件里的正常数据照样读得出来。
+
+---
+
+## 常见问题
+
+**Q：装完执行 `mdrtreadtool` 报「不是有效的 Win32 应用程序」？**
+A：位数不匹配。本包只提供 64 位版本，请使用 **64 位** Python。
+
+**Q：提示缺少 numpy / pandas？**
+A：`pip` 一般会自动装。若公司网络无法直连 PyPI，请配置内网镜像后执行
+`python -m pip install numpy pandas matplotlib openpyxl`，或改用 exe 单文件版（免 Python 环境）。
+
+**Q：图里的中文变成方框？**
+A：执行 `mdrtreadtool --selftest`，报告里会列出检测到的中文字体；若一个都没检测到，请安装「微软雅黑 / 黑体」等常见中文字体。
+
+**Q：能否拿到源码做二次开发？**
+A：不能。本包在 PyPI 上分发的是**编译后的二进制模块**，不包含业务源码，授权为专有授权（见下）。有二次开发或定制需求请联系作者。
+
+**Q：`~/treadtools/setting.json` 是什么？**
+A：界面参数（期次、粒度、字段映射、显示口径等）的自动保存文件，删掉即可恢复默认，不影响数据。
+
+---
+
+## 授权
+
+**专有授权（Proprietary License）—— 非开源。**
+
+Copyright (C) 2026 sysucai. All rights reserved.
+
+允许：在授权范围内**免费使用**本软件（含内部业务使用）。
+禁止：反向工程、反编译、拆解二进制、再分发、转售、以本软件或其衍生品提供商业服务，以及移除任何版权或授权声明。
+
+完整条款见随包附带的 [`LICENSE`](LICENSE)。下载、安装或使用本软件即视为已阅读并同意该协议。
+
+---
+
+## 说明
+
+- 医疗器械警戒判定涉及法规责任，本工具输出的图表与统计量仅供参考，**最终结论应由具备相应资质的专业人员判断**。
+- 报告中所有方法学口径（控制图原理、基线口径、判异规则）均写在程序「帮助文件」页与图下脚注中，可逐条核对。

mdrtreadtool-2.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+mdrtreadtool/__init__.py,sha256=z_uBGWwOzZ5T_5COSgu96tW3BbW_BzX_Zoz3oBQm-0E,1532
+mdrtreadtool/__main__.py,sha256=yse7Auhq1aXWGT5Vu5zgq7p698aXMFx0HGpe2uBSD0I,167
+mdrtreadtool/_loader.py,sha256=7U9KcoE7L9HsZ5NLk00xBFfw_2zv-u5MzooIKz4PX10,13423
+mdrtreadtool/_update.py,sha256=i9OpN2PrEbFPn8OXM0tdBUSRI8gKE79RKRqom9p134c,15382
+mdrtreadtool/chart_tool.ico,sha256=QSkGjDbY2BIoFsA45Akc0aIoesObVkKJltvD46HfVQU,381038
+mdrtreadtool/chart_tool.pyd,sha256=MyM_GGGTspoG61vy3nSWbDzqz5WL6zDPhA3mu3C76D0,2580992
+mdrtreadtool-2.0.0.dist-info/licenses/LICENSE,sha256=cWhR4QS0Pm_q2sPM9IIuIyIBhQu64mA3g65W0gXGG4w,7957
+mdrtreadtool-2.0.0.dist-info/METADATA,sha256=K-nAmiydJQ9188cKoXX-8_Yb8VKOwJd9TSn_IMzhDQU,11776
+mdrtreadtool-2.0.0.dist-info/WHEEL,sha256=hVx9elvUDfBjRmbl8JwIcXXikst35RZTZK9nspfI_28,98
+mdrtreadtool-2.0.0.dist-info/entry_points.txt,sha256=YnX_BzkubLaip8X9T6zPmHeLV8cME8kHP2lZhRJ5kas,59
+mdrtreadtool-2.0.0.dist-info/top_level.txt,sha256=teSwJorMMlStOWQUPY7nfpfgH105hq1BijqrcdOTwxc,13
+mdrtreadtool-2.0.0.dist-info/RECORD,,

mdrtreadtool-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

mdrtreadtool-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mdrtreadtool = mdrtreadtool._loader:main

mdrtreadtool-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,156 @@
+专有软件许可协议
+PROPRIETARY SOFTWARE LICENSE AGREEMENT
+
+软件名称：mdrtreadtool —— 医疗器械警戒趋势分析工具
+版本：2.0.0
+著作权人（许可方）：sysucai
+发布日期：2026-10-12
+
+本协议同时提供中文与英文文本。中、英文文本如有歧义，以中文文本为准。
+This Agreement is provided in both Chinese and English. In case of any
+discrepancy, the Chinese text shall prevail.
+
+
+一、定义
+
+1.1 「本软件」指 mdrtreadtool 软件包及其全部组成文件，包括但不限于已编译的扩展
+    模块（chart_tool.pyd）、图标资源、文档、示例数据与随附脚本。
+1.2 「许可方」指本软件的著作权人 sysucai。
+1.3 「被许可方」指通过合法途径获取、安装或使用本软件的自然人或法人。
+
+
+二、授权范围
+
+2.1 在遵守本协议全部条款的前提下，许可方授予被许可方一项**非独占、不可转让、
+    不可再许可**的普通使用许可，允许被许可方：
+    (a) 在其自身业务（含企业内部业务）中安装、运行本软件；
+    (b) 使用本软件生成的图表、统计数据与报告，用于内部质量分析、法规报告编制
+        等正当用途。
+
+2.2 被许可方**无需**为上述使用支付许可费用。
+
+
+三、限制
+
+被许可方**不得**实施下列行为，亦不得允许或协助第三方实施：
+
+3.1 对本软件进行反向工程、反编译、反汇编、解密，或以其他方式试图获取其源代码、
+    内部算法或未公开的实现细节；
+3.2 复制、发布、分发、出租、出借、出售、转让本软件或其任何部分，或将本软件
+    上传至任何公开的软件仓库、网盘、论坛或其他信息分享平台；
+3.3 移除、遮蔽、篡改本软件中的任何著作权声明、许可声明、版本标识或作者署名；
+3.4 将本软件或其修改版本用于提供商业服务（包括但不限于 SaaS、代做报告、
+    二次销售），无论是否直接收费；
+3.5 将本软件用于任何违反中华人民共和国法律法规的用途；
+3.6 以本软件为基础开发实质功能相同或近似的竞争性产品。
+
+
+四、权利保留
+
+4.1 本软件系授权使用，而非出售。本协议未明示授予的一切权利，均由许可方保留。
+4.2 本软件的全部知识产权（包括但不限于著作权、商标权、商业秘密）均归许可方
+    所有，不因本协议的签署或履行而发生转移。
+
+
+五、第三方组件
+
+5.1 本软件在运行过程中依赖若干第三方开源组件（例如 NumPy、pandas、matplotlib、
+    openpyxl、Pillow、xlrd 等）。这些组件由各自的著作权人依照其自身的开源许可
+    协议（如 BSD、MIT、PSF 等）授权，**不适用**本协议的专有条款。
+5.2 被许可方如分发本软件所在的 Python 环境，应自行遵守上述第三方组件的许可要求。
+
+
+六、无担保
+
+6.1 本软件按「现状」提供，不附带任何形式的明示或默示担保，包括但不限于对
+    适销性、特定用途适用性及不侵权的担保。
+6.2 许可方不保证本软件运行无中断、无错误，亦不保证其输出的统计结果、图表或
+    结论满足任何特定监管要求。
+
+
+七、责任限制
+
+7.1 在适用法律允许的最大范围内，许可方不对因使用或无法使用本软件而产生的
+    任何直接、间接、附带、特殊、惩罚性或后果性损害（包括但不限于数据丢失、
+    业务中断、利润损失、监管处罚）承担赔偿责任，无论其是否已被告知该等
+    损害的可能性。
+7.2 本软件输出的图表与统计量仅供参考。医疗器械警戒判定涉及法规责任，最终
+    结论应由具备相应资质的专业人员独立作出。
+
+
+八、协议的终止
+
+8.1 被许可方违反本协议任一条款时，本协议项下的授权**自动终止**，无需许可方
+    另行通知。
+8.2 授权终止后，被许可方应立即停止使用并销毁本软件的全部副本。
+
+
+九、适用法律与争议解决
+
+9.1 本协议的订立、效力、解释、履行及争议解决，均适用中华人民共和国法律。
+9.2 因本协议产生的争议，双方应友好协商解决；协商不成的，任何一方均可向许可方
+    住所地有管辖权的人民法院提起诉讼。
+
+
+十、其他
+
+10.1 下载、安装、复制或以任何方式使用本软件，即视为被许可方已阅读、理解并
+     同意接受本协议全部条款的约束。
+10.2 若被许可方不同意本协议的任何条款，请立即停止安装与使用，并删除本软件的
+     全部副本。
+
+
+────────────────────────────────────────────────────────────────────────────
+ENGLISH TEXT
+
+Software: mdrtreadtool — Medical Device Vigilance Trend Analysis Tool
+Copyright (C) 2026 sysucai. All rights reserved.
+
+1. GRANT. Subject to the terms of this Agreement, the Licensor grants you a
+   non-exclusive, non-transferable, non-sublicensable license to install and
+   use this software for your own internal business purposes, free of charge.
+
+2. RESTRICTIONS. You may NOT: (a) reverse engineer, decompile, disassemble or
+   otherwise attempt to derive the source code, internal algorithms or
+   non-public implementation details of the software; (b) copy, publish,
+   distribute, rent, lease, sell, transfer or upload the software or any part
+   of it to any public repository, file-sharing service, forum or other
+   information-sharing platform; (c) remove, obscure or alter any copyright,
+   license, version or attribution notice; (d) use the software or any
+   derivative thereof to provide commercial services, including but not
+   limited to SaaS offerings, report-writing services or resale, whether or
+   not a fee is charged; (e) use the software for any purpose prohibited by
+   the laws of the People's Republic of China; or (f) develop a competing
+   product with substantially similar functionality based on the software.
+
+3. RESERVATION. The software is licensed, not sold. All rights not expressly
+   granted are reserved by the Licensor. All intellectual property rights in
+   the software remain with the Licensor and are not transferred.
+
+4. THIRD-PARTY COMPONENTS. The software depends on third-party open-source
+   components (e.g. NumPy, pandas, matplotlib, openpyxl, Pillow, xlrd), which
+   are licensed under their own respective licenses and are NOT governed by
+   this Agreement.
+
+5. NO WARRANTY. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+6. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW,
+   THE LICENSOR SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+   SPECIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATING TO
+   THE USE OF OR INABILITY TO USE THE SOFTWARE.
+
+7. TERMINATION. Your rights under this Agreement terminate automatically
+   without notice if you breach any of its terms.
+
+8. GOVERNING LAW. This Agreement shall be governed by and construed in
+   accordance with the laws of the People's Republic of China.
+
+9. ACCEPTANCE. By downloading, installing, copying or otherwise using this
+   software, you acknowledge that you have read, understood and agree to be
+   bound by this Agreement. If you do not agree, you must stop using the
+   software and delete all copies immediately.
+
+────────────────────────────────────────────────────────────────────────────
+SPDX-License-Identifier: LicenseRef-Proprietary

mdrtreadtool-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mdrtreadtool