ai-ipcheck 0.1.0__tar.gz

ai_ipcheck-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+dist/
+build/
+*.egg-info/
+*.egg
+.DS_Store
+.env
+.env.*
+.vscode/
+.idea/
+.claude/

ai_ipcheck-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

ai_ipcheck-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: ai-ipcheck
+Version: 0.1.0
+Summary: A lightweight diagnostic tool for AI developers to verify network environment compatibility and IP reputation.
+Project-URL: Repository, https://github.com/stormzhang/ip_check
+Project-URL: Issues, https://github.com/stormzhang/ip_check/issues
+Author-email: stormzhang <stormzhang.dev@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude,diagnostic,ip-check,network,openai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: System :: Networking
+Requires-Python: >=3.10
+Requires-Dist: colorama; sys_platform == 'win32'
+Requires-Dist: requests>=2.28.0
+Requires-Dist: tzdata; sys_platform == 'win32'
+Description-Content-Type: text/markdown
+
+# ipcheck
+
+网络环境诊断工具，一键检测 IP、DNS、代理、风控、时区，确保 AI 工具流畅运行。
+
+[English](./README_EN.md)
+
+![screenshot](./screenshot.png)
+
+## 为什么需要这个工具
+
+想让 Claude Code、OpenAI API、Cursor 等 AI 工具流畅稳定运行，网络环境配置至关重要。以下问题可能影响使用体验：
+
+- **IPv6 泄露真实地址** — 代理通常只处理 IPv4，IPv6 会暴露你的实际位置
+- **DNS 泄露** — 使用国内 DNS 会暴露真实地理位置
+- **IP 风险过高** — 机房 IP 或被滥用的 IP 可能影响连接质量
+- **时区不一致** — 本地时区配置与 IP 所在地不匹配
+
+`ipcheck` 一键检测这些问题，确保你的 AI 工具流畅稳定运行，尤其 Claude 启动之前先检测下，原因你懂得，规避封号。
+
+## 功能
+
+| 检测项 | 说明 |
+|--------|------|
+| 局域网 IP / IPv6 | 检测本机 IP，确认 IPv6 是否已禁用 |
+| DNS 服务器 | 识别 DNS 来源（国内/国外），标注已知 DNS 服务商 |
+| 公网 IP 信息 | 出口 IP、国家、地区、ISP、运营商 |
+| 代理检测 | 环境变量代理配置、IP 是否被标记为代理 |
+| IP 类型 | 住宅 IP / 机房 IP 识别 |
+| IP 风险评分 | 通过 proxycheck.io 查询风险分数 |
+| 滥用记录 | 通过 StopForumSpam 查询 IP 是否被举报 |
+| 时区一致性 | 对比本地 CLI 时区与公网 IP 所在时区是否匹配 |
+
+## 安装
+
+```bash
+pip install ai-ipcheck
+```
+
+升级到最新版：
+
+```bash
+pip install --upgrade ipcheck
+```
+
+## 使用
+
+```bash
+ipcheck
+```
+
+### 环境要求
+
+- Python 3.10+
+- 支持 macOS / Linux / Windows
+
+## 结果说明
+
+**局域网 & DNS** — IPv6 建议禁用，大部分代理不处理 IPv6 流量，开启后可能同时暴露两个不同地区的 IP 地址。如果检测到国内 DNS，需要在代理软件中调整 DNS 设置。
+
+**公网 IP 信息** — 显示经过代理后的出口 IP、所在国家/地区、ISP 和时区。这些信息直接影响 AI 服务对你请求来源的判断。
+
+**IP 风险评估** — 检测 IP 是住宅还是机房类型。机房 IP 不一定有问题，但会进一步查询风险评分和滥用记录。如果风险评分偏高，建议更换节点。
+
+**时区一致性** — 对比本地 `$TZ` 环境变量（或系统时区）与公网 IP 所在时区。保持一致可以获得更好的服务体验。建议在 shell 配置中设置 `TZ` 为与 IP 所在地匹配的 IANA 时区（如 `America/Los_Angeles`）。
+
+## License
+
+[MIT](LICENSE) © 2026 stormzhang

ai_ipcheck-0.1.0/README.md

@@ -0,0 +1,68 @@
+# ipcheck
+
+网络环境诊断工具，一键检测 IP、DNS、代理、风控、时区，确保 AI 工具流畅运行。
+
+[English](./README_EN.md)
+
+![screenshot](./screenshot.png)
+
+## 为什么需要这个工具
+
+想让 Claude Code、OpenAI API、Cursor 等 AI 工具流畅稳定运行，网络环境配置至关重要。以下问题可能影响使用体验：
+
+- **IPv6 泄露真实地址** — 代理通常只处理 IPv4，IPv6 会暴露你的实际位置
+- **DNS 泄露** — 使用国内 DNS 会暴露真实地理位置
+- **IP 风险过高** — 机房 IP 或被滥用的 IP 可能影响连接质量
+- **时区不一致** — 本地时区配置与 IP 所在地不匹配
+
+`ipcheck` 一键检测这些问题，确保你的 AI 工具流畅稳定运行，尤其 Claude 启动之前先检测下，原因你懂得，规避封号。
+
+## 功能
+
+| 检测项 | 说明 |
+|--------|------|
+| 局域网 IP / IPv6 | 检测本机 IP，确认 IPv6 是否已禁用 |
+| DNS 服务器 | 识别 DNS 来源（国内/国外），标注已知 DNS 服务商 |
+| 公网 IP 信息 | 出口 IP、国家、地区、ISP、运营商 |
+| 代理检测 | 环境变量代理配置、IP 是否被标记为代理 |
+| IP 类型 | 住宅 IP / 机房 IP 识别 |
+| IP 风险评分 | 通过 proxycheck.io 查询风险分数 |
+| 滥用记录 | 通过 StopForumSpam 查询 IP 是否被举报 |
+| 时区一致性 | 对比本地 CLI 时区与公网 IP 所在时区是否匹配 |
+
+## 安装
+
+```bash
+pip install ai-ipcheck
+```
+
+升级到最新版：
+
+```bash
+pip install --upgrade ipcheck
+```
+
+## 使用
+
+```bash
+ipcheck
+```
+
+### 环境要求
+
+- Python 3.10+
+- 支持 macOS / Linux / Windows
+
+## 结果说明
+
+**局域网 & DNS** — IPv6 建议禁用，大部分代理不处理 IPv6 流量，开启后可能同时暴露两个不同地区的 IP 地址。如果检测到国内 DNS，需要在代理软件中调整 DNS 设置。
+
+**公网 IP 信息** — 显示经过代理后的出口 IP、所在国家/地区、ISP 和时区。这些信息直接影响 AI 服务对你请求来源的判断。
+
+**IP 风险评估** — 检测 IP 是住宅还是机房类型。机房 IP 不一定有问题，但会进一步查询风险评分和滥用记录。如果风险评分偏高，建议更换节点。
+
+**时区一致性** — 对比本地 `$TZ` 环境变量（或系统时区）与公网 IP 所在时区。保持一致可以获得更好的服务体验。建议在 shell 配置中设置 `TZ` 为与 IP 所在地匹配的 IANA 时区（如 `America/Los_Angeles`）。
+
+## License
+
+[MIT](LICENSE) © 2026 stormzhang

ai_ipcheck-0.1.0/README_EN.md

@@ -0,0 +1,62 @@
+# ipcheck
+
+A lightweight diagnostic tool for AI developers to verify network environment compatibility and IP reputation.
+
+[中文](./README.md)
+
+![screenshot](./screenshot.png)
+
+## Why
+
+To ensure AI tools like Claude Code, OpenAI API, and Cursor run smoothly and reliably, a properly configured network environment is essential. Common issues that may affect performance:
+
+- **IPv6 leaking real location** — Most proxies only handle IPv4; IPv6 can expose your actual geographic location
+- **DNS leakage** — Local DNS servers can reveal your true location to AI services
+- **High-risk IP** — Datacenter IPs or abused IPs may affect connection quality
+- **Timezone mismatch** — Inconsistency between local timezone and IP geolocation
+
+`ipcheck` detects all these issues in one run, ensuring your AI tools run smoothly and stably.
+
+## Features
+
+| Check Item | Description |
+|------------|-------------|
+| LAN IP / IPv6 | Detect local IP, verify if IPv6 is disabled |
+| DNS Servers | Identify DNS origin (domestic/foreign), label known DNS providers |
+| Public IP Info | Exit IP, country, region, ISP, organization |
+| Proxy Detection | Env proxy settings, whether IP is flagged as proxy |
+| IP Type | Residential vs. datacenter IP identification |
+| IP Risk Score | Risk scoring via proxycheck.io |
+| Abuse Records | IP abuse lookup via StopForumSpam |
+| Timezone Consistency | Compare local CLI timezone with public IP geolocation timezone |
+
+## Install
+
+```bash
+pip install ai-ipcheck
+```
+
+## Usage
+
+```bash
+ipcheck
+```
+
+### Requirements
+
+- Python 3.10+
+- macOS / Linux / Windows
+
+## Understanding the Results
+
+**LAN & DNS** — Disable IPv6 if possible. Most proxies don't handle IPv6 traffic, which may expose two IPs from different regions simultaneously. If a domestic DNS is detected, adjust DNS settings in your proxy software.
+
+**Public IP Info** — Shows your exit IP after proxy, including country/region, ISP, and timezone. These directly affect how AI services evaluate your request origin.
+
+**IP Risk Assessment** — Identifies whether your IP is residential or datacenter. Datacenter IPs aren't necessarily problematic, but the tool will query risk scores and abuse records. Switch nodes if your risk score is high.
+
+**Timezone Consistency** — Compares your local `$TZ` environment variable (or system timezone) with the public IP's timezone. Keeping them consistent ensures a better service experience. Set `TZ` in your shell config to match your IP's IANA timezone (e.g., `America/Los_Angeles`).
+
+## License
+
+[MIT](LICENSE) © 2026 stormzhang

ai_ipcheck-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ai-ipcheck"
+version = "0.1.0"
+description = "A lightweight diagnostic tool for AI developers to verify network environment compatibility and IP reputation."
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "stormzhang", email = "stormzhang.dev@gmail.com"}]
+requires-python = ">=3.10"
+keywords = ["ip-check", "network", "ai", "claude", "openai", "diagnostic"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Networking",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "colorama; sys_platform == 'win32'",
+    "tzdata; sys_platform == 'win32'",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ipcheck"]
+
+[project.scripts]
+ipcheck = "ipcheck.cli:main"
+
+[project.urls]
+Repository = "https://github.com/stormzhang/ip_check"
+Issues = "https://github.com/stormzhang/ip_check/issues"

ai_ipcheck-0.1.0/src/ipcheck/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

ai_ipcheck-0.1.0/src/ipcheck/__main__.py

@@ -0,0 +1,3 @@
+from ipcheck.cli import main
+
+main()

ai_ipcheck-0.1.0/src/ipcheck/cli.py

@@ -0,0 +1,444 @@
+#!/usr/bin/env python3
+"""
+ipcheck — 网络环境诊断工具
+检测本机 IP、IPv6、DNS、公网信息、代理状态、时区
+支持 macOS / Linux / Windows
+"""
+
+import socket
+import ipaddress
+import os
+import sys
+import subprocess
+import datetime
+import re
+import platform
+
+import requests
+
+try:
+    from zoneinfo import ZoneInfo as _ZI
+except ImportError:
+    _ZI = None
+
+# ── 编码修正（Windows cmd 默认非 UTF-8）────────────────────
+if sys.stdout.encoding and sys.stdout.encoding.lower() not in ('utf-8', 'utf8'):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    except AttributeError:
+        pass
+
+IS_WIN = platform.system() == 'Windows'
+
+
+# ── 已知 DNS ──────────────────────────────────────────────
+KNOWN_DNS = {
+    '1.1.1.1':         'Cloudflare (US)',
+    '1.0.0.1':         'Cloudflare (US)',
+    '1.1.1.2':         'Cloudflare for Families (US)',
+    '1.0.0.2':         'Cloudflare for Families (US)',
+    '1.1.1.3':         'Cloudflare for Families (US)',
+    '1.0.0.3':         'Cloudflare for Families (US)',
+    '8.8.8.8':         'Google Public DNS (US)',
+    '8.8.4.4':         'Google Public DNS (US)',
+    '9.9.9.9':         'Quad9 (US)',
+    '149.112.112.112': 'Quad9 (US)',
+    '208.67.222.222':  'OpenDNS/Cisco (US)',
+    '208.67.220.220':  'OpenDNS/Cisco (US)',
+    '223.5.5.5':       'AliDNS 阿里 (CN)',
+    '223.6.6.6':       'AliDNS 阿里 (CN)',
+    '119.29.29.29':    'DNSPod 腾讯 (CN)',
+    '182.254.116.116': 'DNSPod 腾讯 (CN)',
+    '114.114.114.114': '114DNS (CN)',
+    '114.114.115.115': '114DNS (CN)',
+    '180.76.76.76':    'BaiduDNS 百度 (CN)',
+    '1.2.4.8':         'CNNIC (CN)',
+    '210.2.4.8':       'CNNIC (CN)',
+    '94.140.14.14':    'AdGuard (CY)',
+    '94.140.15.15':    'AdGuard (CY)',
+    '185.228.168.9':   'CleanBrowsing (US)',
+    '185.228.169.9':   'CleanBrowsing (US)',
+    '76.76.2.0':       'Alternate DNS (US)',
+    '76.76.10.0':      'Alternate DNS (US)',
+}
+
+
+def dns_label(ip):
+    if ip in KNOWN_DNS:
+        return f"{ip}  {KNOWN_DNS[ip]}"
+    try:
+        if ipaddress.ip_address(ip).is_private:
+            return f"{ip}  局域网路由器"
+    except Exception:
+        pass
+    return ip
+
+
+def make_zone(name):
+    if not _ZI or not name:
+        return None
+    try:
+        return _ZI(name)
+    except Exception:
+        return None
+
+
+def _val(v, fallback="未知"):
+    return v if v else warn(fallback)
+
+
+# ── 颜色 ─────────────────────────────────────────────────
+def _init_color():
+    if IS_WIN:
+        try:
+            import colorama
+            colorama.init()
+            return True
+        except ImportError:
+            pass
+        try:
+            import ctypes
+            h = ctypes.windll.kernel32.GetStdHandle(-11)
+            m = ctypes.c_ulong()
+            ctypes.windll.kernel32.GetConsoleMode(h, ctypes.byref(m))
+            ctypes.windll.kernel32.SetConsoleMode(h, m.value | 0x0004)
+            return True
+        except Exception:
+            return False
+    return True
+
+_COLOR = _init_color()
+
+
+class C:
+    RESET  = "\033[0m"  if _COLOR else ""
+    BOLD   = "\033[1m"  if _COLOR else ""
+    RED    = "\033[91m" if _COLOR else ""
+    GREEN  = "\033[92m" if _COLOR else ""
+    YELLOW = "\033[93m" if _COLOR else ""
+    CYAN   = "\033[96m" if _COLOR else ""
+    GRAY   = "\033[90m" if _COLOR else ""
+
+ANSI_RE = re.compile(r'\033\[[0-9;]*m')
+
+
+def char_width(c):
+    cp = ord(c)
+    if (0x2E80 <= cp <= 0x303E or 0x3040 <= cp <= 0x33FF or
+        0x3400 <= cp <= 0x4DBF or 0x4E00 <= cp <= 0x9FFF or
+        0xAC00 <= cp <= 0xD7AF or 0xF900 <= cp <= 0xFAFF or
+        0xFE30 <= cp <= 0xFE6F or 0xFF00 <= cp <= 0xFF60 or
+        0x20000 <= cp <= 0x2FFFD):
+        return 2
+    return 1
+
+
+def display_len(s):
+    return sum(char_width(c) for c in ANSI_RE.sub('', s))
+
+
+def ok(v):   return f"{C.GREEN}{v}{C.RESET}"
+def warn(v): return f"{C.YELLOW}{v}{C.RESET}"
+def bad(v):  return f"{C.RED}{v}{C.RESET}"
+
+
+# ── 表格渲染 ──────────────────────────────────────────────
+COL_LABEL, COL_VALUE = 18, 46
+
+def tbl_top(): print(f"  ╔{'═'*(COL_LABEL+2)}╤{'═'*(COL_VALUE+2)}╗")
+def tbl_sep(): print(f"  ╠{'═'*(COL_LABEL+2)}╪{'═'*(COL_VALUE+2)}╣")
+def tbl_bot(): print(f"  ╚{'═'*(COL_LABEL+2)}╧{'═'*(COL_VALUE+2)}╝")
+
+
+def tbl_row(label, value):
+    value = str(value)
+    lpad = ' ' * max(0, COL_LABEL - display_len(label))
+    vpad = ' ' * max(0, COL_VALUE - display_len(value))
+    lstr = f"{label}{lpad}" if label else ' ' * COL_LABEL
+    print(f"  ║ {lstr} │ {value}{vpad} ║")
+
+
+# ── 数据采集 ─────────────────────────────────────────────
+def get_lan_ip():
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except Exception:
+        return warn("获取失败")
+
+
+def get_ipv6():
+    try:
+        s = socket.socket(socket.AF_INET6, socket.SOCK_DGRAM)
+        s.connect(("2001:4860:4860::8888", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        if ip and ip not in ('', '::'):
+            return ip
+    except Exception:
+        pass
+    return warn("已禁用")
+
+
+def get_dns_servers():
+    servers = []
+    if IS_WIN:
+        try:
+            r = subprocess.run(
+                ['powershell', '-NoProfile', '-Command',
+                 'Get-DnsClientServerAddress -AddressFamily IPv4 | '
+                 'Select-Object -ExpandProperty ServerAddresses'],
+                capture_output=True, text=True, timeout=5, encoding='utf-8',
+            )
+            seen = set()
+            for line in r.stdout.splitlines():
+                ip = line.strip()
+                if not ip:
+                    continue
+                try:
+                    ipaddress.ip_address(ip)
+                    if ip not in seen:
+                        seen.add(ip)
+                        servers.append(ip)
+                except ValueError:
+                    pass
+        except Exception:
+            pass
+    else:
+        try:
+            seen = set()
+            with open('/etc/resolv.conf') as f:
+                for line in f:
+                    if line.strip().startswith('nameserver'):
+                        ip = line.split()[1]
+                        if ip not in seen:
+                            seen.add(ip)
+                            servers.append(ip)
+        except Exception:
+            pass
+        if not servers:
+            try:
+                r = subprocess.run(
+                    ['scutil', '--dns'], capture_output=True, text=True, timeout=3,
+                )
+                seen = set()
+                for line in r.stdout.splitlines():
+                    line = line.strip()
+                    if line.startswith('nameserver['):
+                        ip = line.split(':', 1)[1].strip()
+                        if ip not in seen:
+                            seen.add(ip)
+                            servers.append(ip)
+            except Exception:
+                pass
+    return servers
+
+
+def get_public_info():
+    try:
+        resp = requests.get(
+            "http://ip-api.com/json/",
+            params={"fields": "status,message,country,regionName,city,isp,org,proxy,hosting,query,timezone"},
+            timeout=6,
+        )
+        return resp.json()
+    except Exception as e:
+        return {"status": "fail", "message": str(e)}
+
+
+def get_ip_risk(ip):
+    try:
+        resp = requests.get(
+            f"https://proxycheck.io/v2/{ip}",
+            params={"risk": 1, "vpn": 1, "asn": 1},
+            timeout=6,
+        )
+        data = resp.json().get(ip, {})
+        risk  = data.get("risk")
+        itype = data.get("type", "")
+        proxy = data.get("proxy", "")
+        parts = []
+        if risk is not None:
+            score = int(risk)
+            if score < 30:
+                color, level = C.GREEN, "低风险"
+            elif score < 70:
+                color, level = C.YELLOW, "中风险"
+            else:
+                color, level = C.RED, "高风险"
+            parts.append(f"{color}{score}/100 {level}{C.RESET}")
+        if itype:
+            parts.append(f"类型 {itype}")
+        if proxy == "yes":
+            parts.append(bad("已标记为代理"))
+        return "  ".join(parts) if parts else warn("暂无数据")
+    except Exception as e:
+        return warn(f"查询失败（{e}）")
+
+
+def get_stopforumspam(ip):
+    try:
+        resp = requests.get(
+            "https://api.stopforumspam.org/api",
+            params={"json": 1, "ip": ip},
+            timeout=6,
+        )
+        data = resp.json().get("ip", {})
+        if not data.get("appears"):
+            return [ok("未收录  低风险 ✓")]
+        confidence = float(data.get("confidence", 0))
+        frequency  = int(data.get("frequency", 0))
+        last_seen  = (data.get("lastseen") or "")[:10]
+        if confidence < 30:
+            color, level = C.GREEN, "低风险"
+        elif confidence < 70:
+            color, level = C.YELLOW, "中风险"
+        else:
+            color, level = C.RED, "高风险"
+        lines = [f"{color}{confidence:.1f}/100 {level}{C.RESET}  举报 {frequency} 次"]
+        if last_seen:
+            lines.append(f"最近举报 {last_seen}")
+        return lines
+    except Exception as e:
+        return [warn(f"查询失败（{e}）")]
+
+
+def get_proxy_envs():
+    seen = {}
+    for key in ["HTTP_PROXY", "HTTPS_PROXY", "ALL_PROXY",
+                "http_proxy", "https_proxy", "all_proxy"]:
+        val = os.environ.get(key)
+        if val and val not in seen.values():
+            seen[key.upper()] = val
+    return seen
+
+
+def _utc_str(offset):
+    total = int(offset.total_seconds())
+    h, r  = divmod(abs(total), 3600)
+    sign  = "+" if total >= 0 else "-"
+    return f"UTC{sign}{h:02d}:{r//60:02d}"
+
+
+def get_cli_tz_name():
+    tz_env = os.environ.get('TZ', '')
+    if tz_env:
+        return tz_env, True
+
+    if IS_WIN:
+        try:
+            r = subprocess.run(
+                ['powershell', '-NoProfile', '-Command',
+                 '[System.TimeZoneInfo]::Local.Id'],
+                capture_output=True, text=True, timeout=3, encoding='utf-8',
+            )
+            win_id = r.stdout.strip()
+            if win_id:
+                return win_id, False
+        except Exception:
+            pass
+
+    name = datetime.datetime.now().astimezone().tzname() or "Unknown"
+    return name, False
+
+
+# ── 主程序 ────────────────────────────────────────────────
+def main():
+    if len(sys.argv) > 1 and sys.argv[1] in ('--version', '-v', '-V'):
+        from ipcheck import __version__
+        print(f"ipcheck {__version__}")
+        return
+
+    pub = get_public_info()
+
+    print(f"\n  {C.BOLD}ipcheck — 网络环境诊断工具{C.RESET}  "
+          f"{C.GRAY}({platform.system()} / Python {platform.python_version()}){C.RESET}\n")
+    tbl_top()
+
+    # 本机网络
+    tbl_row("局域网 IP", get_lan_ip())
+    tbl_row("IPv6 地址", get_ipv6())
+    dns = get_dns_servers()
+    if dns:
+        tbl_row("DNS 服务器", dns_label(dns[0]))
+        for d in dns[1:]:
+            tbl_row("", dns_label(d))
+    else:
+        tbl_row("DNS 服务器", warn("获取失败"))
+
+    tbl_sep()
+
+    # 公网信息
+    if pub.get("status") == "success":
+        pub_ip = pub.get("query")
+        tbl_row("公网 IP",          pub_ip or bad("获取失败"))
+        tbl_row("国家 / 省份",      f"{_val(pub.get('country'))} / {_val(pub.get('regionName'))}")
+        tbl_row("城市",              _val(pub.get("city")))
+        tbl_row("ISP(互联网服务商)", _val(pub.get("isp")))
+        tbl_row("组织",              _val(pub.get("org")))
+        pub_tz_name = pub.get("timezone")
+        if pub_tz_name:
+            zi = make_zone(pub_tz_name)
+            if zi:
+                off = datetime.datetime.now(zi).utcoffset()
+                tbl_row("所处时区", f"{pub_tz_name}  ({_utc_str(off)})")
+            else:
+                tbl_row("所处时区", pub_tz_name)
+        else:
+            tbl_row("所处时区", _val(None))
+    else:
+        tbl_row("公网请求", bad(pub.get("message") or "未知错误"))
+
+    tbl_sep()
+
+    # 代理检测
+    proxy_envs = get_proxy_envs()
+    if proxy_envs:
+        for k, v in proxy_envs.items():
+            tbl_row(k, warn(v))
+    else:
+        tbl_row("环境变量代理", ok("未设置"))
+    if pub.get("status") == "success":
+        tbl_row("IP 标记为代理", bad("是 ✗") if pub.get("proxy")   else ok("否 ✓"))
+        tbl_row("机房 / 托管",   bad("是 ✗") if pub.get("hosting") else ok("否 ✓"))
+        if (pub.get("hosting") or pub.get("proxy")) and pub_ip:
+            tbl_row("IP 风险查询",  get_ip_risk(pub_ip))
+            spam_lines = get_stopforumspam(pub_ip)
+            tbl_row("垃圾滥用记录", spam_lines[0])
+            for line in spam_lines[1:]:
+                tbl_row("", line)
+
+    tbl_sep()
+
+    # 时区
+    cli_dt     = datetime.datetime.now().astimezone()
+    cli_offset = cli_dt.utcoffset()
+    tz_name, is_iana = get_cli_tz_name()
+    tbl_row("CLI 时区", f"{tz_name}  ({_utc_str(cli_offset)})")
+
+    pub_tz_name = pub.get("timezone") if pub.get("status") == "success" else None
+    if pub_tz_name:
+        pub_zi     = make_zone(pub_tz_name)
+        pub_offset = datetime.datetime.now(pub_zi).utcoffset() if pub_zi else None
+
+        if is_iana:
+            match = ok("一致 ✓") if tz_name == pub_tz_name else bad("不一致 ✗")
+        elif pub_offset is not None:
+            if cli_offset == pub_offset:
+                match = warn("UTC 偏移一致（建议设置 $TZ=IANA 名称精确比对）")
+            else:
+                match = bad("不一致 ✗（UTC 偏移不同）")
+        else:
+            match = warn("无法比对（tzdata 未安装？pip install tzdata）")
+        tbl_row("时区一致性", match)
+
+    tbl_bot()
+
+    if IS_WIN and _ZI is None:
+        print(f"\n  {C.YELLOW}提示：pip install tzdata  （Windows 时区精确比对所需）{C.RESET}")
+    if IS_WIN and not _COLOR:
+        print(f"\n  提示：pip install colorama  （启用彩色输出）")
+    print()