clash-controller 0.2.6__tar.gz → 0.2.7__tar.gz

{clash_controller-0.2.6 → clash_controller-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clash_controller
-Version: 0.2.6
+Version: 0.2.7
 Summary: A Textual TUI for managing Clash proxy instances
 Author-email: Moha-Master <hongkongreporter@outlook.com>
 License-Expression: MIT
@@ -96,6 +96,14 @@ clashctl -D /path/to/config/dir   # 指定配置目录（默认 ~/.config/clash-
 clashctl --debug                  # 启用 API / SSH 调试日志（显示在应用日志页）
 ```
 
+## Windows 说明
+
+- Clash 配置目录默认从 `%USERPROFILE%\.config\clash` / `%USERPROFILE%\.config\mihomo` 探测，也可在端点里手动填写（支持 `~`、`%VAR%`）。
+- 若配置目录位于 `Program Files`、`ProgramData` 等受保护位置，部署时会弹出 UAC 请求管理员写入；请在端点设置中保持“管理员写入 (UAC)”开启，并在弹出的对话框中点击“是”。提权后由程序自身的管理员进程完成写入（不借助 PowerShell，避免被安全软件当成攻击行为掐掉）。部署界面会显示当前阶段（请求授权 / 已授权正在写入），详情同时写入“应用日志”页。
+- 写入是否成功以 `config.yaml` 的实际内容为准：只要目标文件已替换为拉取到的配置就判定成功，不会因提权进程未回写确认文件而误报“等待 UAC 超时”。替换走系统 `ReplaceFileW`，会保留 `config.yaml` 原有的访问权限（ACL），原配置备份为同目录的 `config.yaml.bak`。
+- 如果当前进程已经是管理员权限、或账户不属于管理员组，程序不会白弹 UAC，而是直接说明真正的原因（只读属性 / ACL 拒绝 / 文件被占用，或建议把配置目录放到用户目录）。
+- 订阅与本地配置会按 UTF-8 / GB18030 / 带 BOM 的 UTF-16 自动识别，并统一以 UTF-8（无 BOM、LF 换行）写入，不会再把中文变成乱码；控制 API 响应体同样按字节解码，中文节点名不受 `Content-Type` 缺 charset 影响。
+
 ## 开发者安装
 
 ```bash

{clash_controller-0.2.6 → clash_controller-0.2.7}/README.md

@@ -69,6 +69,14 @@ clashctl -D /path/to/config/dir   # 指定配置目录（默认 ~/.config/clash-
 clashctl --debug                  # 启用 API / SSH 调试日志（显示在应用日志页）
 ```
 
+## Windows 说明
+
+- Clash 配置目录默认从 `%USERPROFILE%\.config\clash` / `%USERPROFILE%\.config\mihomo` 探测，也可在端点里手动填写（支持 `~`、`%VAR%`）。
+- 若配置目录位于 `Program Files`、`ProgramData` 等受保护位置，部署时会弹出 UAC 请求管理员写入；请在端点设置中保持“管理员写入 (UAC)”开启，并在弹出的对话框中点击“是”。提权后由程序自身的管理员进程完成写入（不借助 PowerShell，避免被安全软件当成攻击行为掐掉）。部署界面会显示当前阶段（请求授权 / 已授权正在写入），详情同时写入“应用日志”页。
+- 写入是否成功以 `config.yaml` 的实际内容为准：只要目标文件已替换为拉取到的配置就判定成功，不会因提权进程未回写确认文件而误报“等待 UAC 超时”。替换走系统 `ReplaceFileW`，会保留 `config.yaml` 原有的访问权限（ACL），原配置备份为同目录的 `config.yaml.bak`。
+- 如果当前进程已经是管理员权限、或账户不属于管理员组，程序不会白弹 UAC，而是直接说明真正的原因（只读属性 / ACL 拒绝 / 文件被占用，或建议把配置目录放到用户目录）。
+- 订阅与本地配置会按 UTF-8 / GB18030 / 带 BOM 的 UTF-16 自动识别，并统一以 UTF-8（无 BOM、LF 换行）写入，不会再把中文变成乱码；控制 API 响应体同样按字节解码，中文节点名不受 `Content-Type` 缺 charset 影响。
+
 ## 开发者安装
 
 ```bash

{clash_controller-0.2.6 → clash_controller-0.2.7}/clash_controller/__init__.py

@@ -2,4 +2,4 @@
 Clash Controller - A Textual TUI for managing Clash proxy instances.
 """
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"

{clash_controller-0.2.6 → clash_controller-0.2.7}/clash_controller/api.py

@@ -1,12 +1,39 @@
+import json
 from urllib.parse import quote
 
 import requests
 
+BODY_ENCODINGS = ("utf-8-sig", "gb18030")
+
 
 def _noop(_message: str) -> None:
     pass
 
 
+def _decode_body(response) -> str:
+    """按字节显式解码响应体。
+
+    不要直接用 ``response.text``：中间层（反向代理 / CDN）可能把 Content-Type 改成
+    没有 charset 的 ``text/*``，requests 会强制按 ISO-8859-1 解码，中文节点名直接乱码。
+    """
+    data = response.content or b""
+    for encoding in BODY_ENCODINGS:
+        try:
+            return data.decode(encoding)
+        except UnicodeDecodeError:
+            continue
+    return data.decode("utf-8", errors="replace")
+
+
+def _parse_body(response):
+    """解析响应体：优先按 JSON，失败则退回解码后的文本。"""
+    text = _decode_body(response)
+    try:
+        return json.loads(text)
+    except ValueError:
+        return text
+
+
 class ClashAPI:
     # Special sentinel returned when the request was sent but the connection
     # was interrupted (server closed connection / connection reset) and the
@@ -105,13 +132,10 @@ class ClashAPI:
                 return {"status": "success", "status_code": response.status_code}, None
 
             # Try JSON first, fall back to text
-            try:
-                parsed = response.json()
-            except Exception:
-                parsed = response.text
+            parsed = _parse_body(response)
 
             if self.debug:
-                raw = (response.text or '')[:4096]
+                raw = _decode_body(response)[:4096]
                 self._log(f"[DEBUG] Response: status={response.status_code} headers={dict(response.headers)} body(<=4k)={raw}")
 
             # If the parsed result is a dict, inject status_code for caller convenience
@@ -147,9 +171,13 @@ class ClashAPI:
                     return {"status": "success"}, None
 
                 if self.debug:
-                    raw = response.text[:4096]
+                    raw = _decode_body(response)[:4096]
                     self._log(f"[DEBUG] Response after retry: status={response.status_code} headers={dict(response.headers)} body(<=4k)={raw}")
-                return response.json(), None
+                parsed = _parse_body(response)
+                if isinstance(parsed, dict):
+                    parsed.setdefault('status_code', response.status_code)
+                    return parsed, None
+                return {"body": parsed, "status_code": response.status_code}, None
 
             except requests.exceptions.RequestException as exc:
                 if self.debug:
@@ -182,16 +210,13 @@ class ClashAPI:
             resp = getattr(e, 'response', None)
             if resp is not None:
                 try:
-                    body = resp.json()
+                    body = _parse_body(resp)
                 except Exception:
-                    try:
-                        body = resp.text
-                    except Exception:
-                        body = ''
+                    body = ''
 
                 if self.debug:
                     try:
-                        self._log(f"[DEBUG] Error Response: status={resp.status_code} headers={dict(resp.headers)} body(<=4k)={(resp.text or '')[:4096]}")
+                        self._log(f"[DEBUG] Error Response: status={resp.status_code} headers={dict(resp.headers)} body(<=4k)={_decode_body(resp)[:4096]}")
                     except Exception:
                         self._log(f"[DEBUG] Error Response: status={getattr(resp, 'status_code', 'unknown')}")
 

{clash_controller-0.2.6 → clash_controller-0.2.7}/clash_controller/config.py

@@ -31,9 +31,13 @@ def _load_json(path: Path, log: Callable[[str], None]) -> list:
     if not path.exists():
         return []
     try:
-        with open(path, encoding="utf-8") as f:
-            data = json.load(f)
-    except (json.JSONDecodeError, OSError) as e:
+        raw = path.read_bytes()
+        if raw.startswith((b"\xff\xfe", b"\xfe\xff")):
+            text = raw.decode("utf-16")
+        else:
+            text = raw.decode("utf-8-sig")
+        data = json.loads(text)
+    except (json.JSONDecodeError, UnicodeDecodeError, OSError) as e:
         log(f"无法读取或解析配置文件 {path}: {e}")
         return []
     return data if isinstance(data, list) else []
@@ -41,7 +45,7 @@ def _load_json(path: Path, log: Callable[[str], None]) -> list:
 
 def _save_json(path: Path, data: list) -> Path:
     path.parent.mkdir(parents=True, exist_ok=True)
-    with open(path, "w", encoding="utf-8") as f:
+    with open(path, "w", encoding="utf-8", newline="\n") as f:
         json.dump(data, f, indent=4, ensure_ascii=False)
     return path
 

{clash_controller-0.2.6 → clash_controller-0.2.7}/clash_controller/deploy.py

@@ -8,8 +8,11 @@ from urllib.parse import urlparse
 
 import requests
 
+from .platform_utils import default_local_config_dir, expand_local_path
 from .ssh import fetch_remote_file_meta_and_content
 
+CONFIG_ENCODINGS = ("utf-8-sig", "gb18030")
+
 
 def _noop(_message: str) -> None:
     pass
@@ -40,25 +43,59 @@ def default_ssh_host(url: str) -> str:
     return '127.0.0.1'
 
 
-def get_remote_last_modified(url: str) -> datetime | None:
-    """读取远端 URL 的 Last-Modified 头，失败或缺失返回 None。"""
+def decode_config_bytes(data: bytes) -> str:
+    """把订阅 / 本地配置字节解码为文本。
+
+    不能用 ``response.text``：requests 对没有 charset 的 ``text/*`` 会强制按
+    ISO-8859-1 解码，中文会变成乱码。这里显式按 UTF-8（去 BOM）→ GB18030
+    的顺序尝试，覆盖国内机场常见的两种编码；带 BOM 的 UTF-16（Windows 记事本
+    “Unicode”格式）也能识别。
+    """
+    if data.startswith((b"\xff\xfe", b"\xfe\xff")):
+        # Windows 记事本“Unicode”保存的是带 BOM 的 UTF-16。
+        try:
+            return data.decode("utf-16")
+        except UnicodeDecodeError:
+            pass
+    for encoding in CONFIG_ENCODINGS:
+        try:
+            return data.decode(encoding)
+        except UnicodeDecodeError:
+            continue
+    raise RuntimeError("配置内容不是有效的 UTF-8 / GB18030 文本，无法部署")
+
+
+def normalize_config_text(text: str) -> str:
+    """统一为 LF 换行，避免 Windows 文本模式写出的 CRLF 造成哈希反复不一致。"""
+    return text.replace("\r\n", "\n").replace("\r", "\n")
+
+
+def canonical_config_bytes(data: bytes) -> bytes:
+    """把配置规范化为 UTF-8（无 BOM、LF 换行）字节，用于落盘与哈希比对。"""
+    return normalize_config_text(decode_config_bytes(data)).encode("utf-8")
+
+
+def parse_last_modified(value: str | None) -> datetime | None:
+    if not value:
+        return None
     try:
-        response = requests.head(url, timeout=5)
-        response.raise_for_status()
-        last_modified = response.headers.get('Last-Modified')
-        if last_modified:
-            return parsedate_to_datetime(last_modified)
-    except requests.exceptions.RequestException:
+        return parsedate_to_datetime(value)
+    except (TypeError, ValueError, OverflowError):
         return None
-    return None
 
 
 def fetch_remote_config(url: str) -> tuple[str, str, datetime | None]:
-    """拉取远端配置，返回 (text, sha256, last_modified)。失败抛异常。"""
+    """拉取远端配置，返回 (规范化文本, sha256, last_modified)。失败抛异常。
+
+    直接读取 ``response.content`` 并显式解码，最后统一换行；哈希基于规范化后的
+    UTF-8 字节，保证与本地落盘内容可比。Last-Modified 取自本次 GET 响应，避免
+    额外 HEAD 请求（部分订阅服务器不支持 HEAD）。
+    """
     response = requests.get(url, timeout=30)
     response.raise_for_status()
-    text = response.text
-    return text, compute_sha256(text.encode('utf-8')), get_remote_last_modified(url)
+    payload = canonical_config_bytes(response.content)
+    text = payload.decode('utf-8')
+    return text, compute_sha256(payload), parse_last_modified(response.headers.get('Last-Modified'))
 
 
 def read_current_config(
@@ -70,7 +107,7 @@ def read_current_config(
     if profile.get('endpoint_type', 'local') == 'remote':
         return fetch_remote_file_meta_and_content(profile, log=log, debug=debug)
 
-    config_dir = profile.get('config_directory', '/etc/clash')
+    config_dir = expand_local_path(profile.get('config_directory') or default_local_config_dir())
     config_path = os.path.join(config_dir, 'config.yaml')
     if not os.path.exists(config_path):
         raise RuntimeError(f"local config file not found: {config_path}")

clash_controller-0.2.7/clash_controller/elevated_helper.py

@@ -0,0 +1,36 @@
+"""Windows 提权写入 helper：由 ``platform_utils`` 通过 UAC 以管理员令牌再启动本包执行。
+
+职责刻意收窄成「读 payload → 原子写目标 → 回写状态」三件事：不读应用配置、不联网、不碰 UI，
+所以被提权的进程能做的事非常有限，出错也只可能来自这几个路径。
+"""
+import argparse
+import sys
+
+from .platform_utils import HELPER_FLAG, elevated_apply_payload, write_status
+
+EXIT_OK = 0
+EXIT_FAILED = 1
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog=f"clashctl {HELPER_FLAG}",
+        description="以管理员权限写入 Clash 配置文件（由 clashctl 内部调用，无需手动执行）",
+    )
+    parser.add_argument("payload", help="待写入内容所在的临时文件")
+    parser.add_argument("target", help="目标 config.yaml 的绝对路径")
+    parser.add_argument("backup", help="备份文件路径")
+    parser.add_argument("status", help="回写结果的状态文件路径")
+    args = parser.parse_args(argv)
+
+    try:
+        elevated_apply_payload(args.payload, args.target, args.backup)
+    except BaseException as exc:  # noqa: BLE001  # 提权进程必须把任何失败原因带回主进程
+        write_status(args.status, f"ERR {type(exc).__name__}: {exc}")
+        return EXIT_FAILED
+    write_status(args.status, "OK")
+    return EXIT_OK
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{clash_controller-0.2.6 → clash_controller-0.2.7}/clash_controller/main.py

@@ -7,6 +7,7 @@ from pathlib import Path
 
 from . import __version__
 from .config import CONFIG_DIR_ENV, DEFAULT_CONFIG_DIR
+from .platform_utils import HELPER_FLAG
 
 
 def _setup_logging() -> None:
@@ -37,6 +38,14 @@ def parse_args():
 
 
 def main() -> int:
+    # 提权 helper：打包成 exe 后 sys.executable 就是本程序，UAC 提权重启时由这里分派；
+    # pip 安装则直接走 `python -m clash_controller.elevated_helper`，不经过本函数。
+    argv = sys.argv[1:]
+    if argv[:1] == [HELPER_FLAG]:
+        from .elevated_helper import main as elevated_main
+
+        return elevated_main(argv[1:])
+
     _setup_logging()
     args = parse_args()
     os.environ[CONFIG_DIR_ENV] = args.dir