tinet-clink2-cli 0.0.1__tar.gz

tinet_clink2_cli-0.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include cli_anything/README.md
+prune cli_anything/tests
+global-exclude *.py[cod] __pycache__ .DS_Store

tinet_clink2_cli-0.0.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: tinet-clink2-cli
+Version: 0.0.1
+Summary: Clink2 OpenAPI CLI (AK-SK, IVR queries)
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: responses>=0.25; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+
+Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
+
+**当前版本：** `0.0.1`  
+**PyPI：** https://pypi.org/project/tinet-clink2-cli/
+
+## 功能概览
+
+| 子命令 | 说明 |
+|--------|------|
+| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`ivr`** | 语音导航查询：列表、节点列表 |
+
+所有出站 HTTP 请求自动附加：
+- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+
+本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
+
+## 环境要求
+
+- Python **≥ 3.9**
+- 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
+- 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
+
+## 安装
+
+从 [PyPI](https://pypi.org/project/tinet-clink2-cli/) 安装（推荐）：
+
+```bash
+pip install tinet-clink2-cli
+tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --help
+```
+
+指定版本或升级：
+
+```bash
+pip install 'tinet-clink2-cli==0.0.1'
+pip install --upgrade tinet-clink2-cli
+```
+
+macOS 等受限环境可使用 [pipx](https://pipx.pypa.io/)：
+
+```bash
+pipx install tinet-clink2-cli
+```
+
+## 配置凭证
+
+**配置文件：** `~/.clink2/config.json`
+
+入参名称与 OpenAPI 公共参数一致：
+
+```bash
+tinet-clink2-cli config set \
+  --AccessKeyId your_access_key_id \
+  --AccessKeySecret your_access_key_secret \
+  --endpoint https://api-bj.clink.cn \
+  --Expires 60
+
+tinet-clink2-cli config show
+```
+
+默认接入地址为北京：`https://api-bj.clink.cn`。`config show` 会对 AccessKeySecret 脱敏。
+
+## 快速示例
+
+顺序与上方「功能概览」一致。完整取值见各子命令 `--help` 或 [开发者中心](https://develop.clink.cn)。
+
+```bash
+# config
+tinet-clink2-cli config show
+
+# ivr
+tinet-clink2-cli ivr list
+tinet-clink2-cli ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --json ivr list
+tinet-clink2-cli --json ivr nodes --ivrName your_ivr_name
+
+# dry-run：仅校验入参与配置，不调用服务端，但仍写本地日志
+tinet-clink2-cli --dry-run ivr list
+tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+```
+
+全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+
+## 帮助与 API 文档
+
+安装后通过 `--help` 查看一级子命令：
+
+```bash
+tinet-clink2-cli --help
+tinet-clink2-cli config --help
+tinet-clink2-cli ivr --help
+```
+
+OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

tinet_clink2_cli-0.0.1/cli_anything/README.md

@@ -0,0 +1,96 @@
+Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
+
+**当前版本：** `0.0.1`  
+**PyPI：** https://pypi.org/project/tinet-clink2-cli/
+
+## 功能概览
+
+| 子命令 | 说明 |
+|--------|------|
+| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`ivr`** | 语音导航查询：列表、节点列表 |
+
+所有出站 HTTP 请求自动附加：
+- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+
+本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
+
+## 环境要求
+
+- Python **≥ 3.9**
+- 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
+- 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
+
+## 安装
+
+从 [PyPI](https://pypi.org/project/tinet-clink2-cli/) 安装（推荐）：
+
+```bash
+pip install tinet-clink2-cli
+tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --help
+```
+
+指定版本或升级：
+
+```bash
+pip install 'tinet-clink2-cli==0.0.1'
+pip install --upgrade tinet-clink2-cli
+```
+
+macOS 等受限环境可使用 [pipx](https://pipx.pypa.io/)：
+
+```bash
+pipx install tinet-clink2-cli
+```
+
+## 配置凭证
+
+**配置文件：** `~/.clink2/config.json`
+
+入参名称与 OpenAPI 公共参数一致：
+
+```bash
+tinet-clink2-cli config set \
+  --AccessKeyId your_access_key_id \
+  --AccessKeySecret your_access_key_secret \
+  --endpoint https://api-bj.clink.cn \
+  --Expires 60
+
+tinet-clink2-cli config show
+```
+
+默认接入地址为北京：`https://api-bj.clink.cn`。`config show` 会对 AccessKeySecret 脱敏。
+
+## 快速示例
+
+顺序与上方「功能概览」一致。完整取值见各子命令 `--help` 或 [开发者中心](https://develop.clink.cn)。
+
+```bash
+# config
+tinet-clink2-cli config show
+
+# ivr
+tinet-clink2-cli ivr list
+tinet-clink2-cli ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --json ivr list
+tinet-clink2-cli --json ivr nodes --ivrName your_ivr_name
+
+# dry-run：仅校验入参与配置，不调用服务端，但仍写本地日志
+tinet-clink2-cli --dry-run ivr list
+tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+```
+
+全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+
+## 帮助与 API 文档
+
+安装后通过 `--help` 查看一级子命令：
+
+```bash
+tinet-clink2-cli --help
+tinet-clink2-cli config --help
+tinet-clink2-cli ivr --help
+```
+
+OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

tinet_clink2_cli-0.0.1/cli_anything/clink2/__init__.py

@@ -0,0 +1,3 @@
+"""Clink2 OpenAPI CLI package."""
+
+__version__ = "0.0.1"

tinet_clink2_cli-0.0.1/cli_anything/clink2/clink2_cli.py

@@ -0,0 +1,224 @@
+"""tinet-clink2-cli Click 入口"""
+
+from __future__ import annotations
+
+import json
+import time
+import uuid
+from typing import Any, Optional
+
+import click
+
+from cli_anything.clink2 import __version__
+from cli_anything.clink2.core import config as cfg
+from cli_anything.clink2.core.http import Clink2Client
+from cli_anything.clink2.core.logging import write_log_record
+
+
+@click.group()
+@click.version_option(
+    version=__version__,
+    prog_name="tinet-clink2-cli",
+    message="%(prog)s，version %(version)s，released on 2026-07-20",
+)
+@click.option("--json", "as_json", is_flag=True, help="以 JSON 格式输出结果")
+@click.option("--dry-run", is_flag=True, help="仅校验入参与配置，不调用服务端接口")
+@click.pass_context
+def cli(ctx: click.Context, as_json: bool, dry_run: bool) -> None:
+    """Clink2 OpenAPI 命令行工具"""
+    ctx.ensure_object(dict)
+    ctx.obj["as_json"] = as_json
+    ctx.obj["dry_run"] = dry_run
+
+
+@cli.group()
+def config() -> None:
+    """管理本地 AccessKey 与接入地址配置"""
+
+
+@config.command("set")
+@click.option(
+    "--AccessKeyId",
+    "access_key_id",
+    required=True,
+    help="访问密钥 ID",
+)
+@click.option(
+    "--AccessKeySecret",
+    "access_key_secret",
+    required=True,
+    help="访问密钥 Secret",
+)
+@click.option(
+    "--endpoint",
+    default=cfg.DEFAULT_ENDPOINT,
+    show_default=True,
+    help="API 接入地址（公有云北京/上海等）",
+)
+@click.option(
+    "--Expires",
+    "expires",
+    default=cfg.DEFAULT_EXPIRES,
+    show_default=True,
+    type=int,
+    help="签名有效时间，单位秒（与 OpenAPI 公共参数 Expires 一致，1–86400）",
+)
+def config_set(access_key_id: str, access_key_secret: str, endpoint: str, expires: int) -> None:
+    """将凭据保存到 ~/.clink2/config.json"""
+    path = cfg.save_config(
+        access_key_id=access_key_id,
+        access_key_secret=access_key_secret,
+        endpoint=endpoint,
+        expires=expires,
+    )
+    click.echo(f"配置已保存到 {path}")
+
+
+@config.command("show")
+def config_show() -> None:
+    """查看本地配置（AccessKeySecret 脱敏显示）"""
+    try:
+        data = cfg.load_config()
+    except FileNotFoundError as exc:
+        raise click.ClickException(str(exc)) from exc
+    display = {
+        "AccessKeyId": data["access_key_id"],
+        "AccessKeySecret": cfg.mask_secret(data["access_key_secret"]),
+        "endpoint": data.get("endpoint", cfg.DEFAULT_ENDPOINT),
+        "Expires": data.get("expires", cfg.DEFAULT_EXPIRES),
+    }
+    click.echo(json.dumps(display, ensure_ascii=False, indent=2))
+
+
+def _load_or_fail() -> dict[str, Any]:
+    """加载配置；失败时抛出 ClickException"""
+    try:
+        return cfg.load_config()
+    except (FileNotFoundError, ValueError) as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+def _emit(ctx: click.Context, payload: Any, *, exit_code: int = 0) -> None:
+    """输出结果（JSON 或文本）"""
+    if ctx.obj.get("as_json") or isinstance(payload, (dict, list)):
+        click.echo(json.dumps(payload, ensure_ascii=False, indent=2))
+    else:
+        click.echo(str(payload))
+    if exit_code:
+        ctx.exit(exit_code)
+
+
+def _run_api(
+    ctx: click.Context,
+    command: str,
+    method: str,
+    path: str,
+    params: Optional[dict[str, Any]] = None,
+) -> None:
+    """执行 API 调用或 dry-run，并写本地日志"""
+    started = time.perf_counter()
+    conf = _load_or_fail()
+    endpoint = conf["endpoint"].rstrip("/")
+    full_url = f"{endpoint}{path}"
+    trace_id = str(uuid.uuid4())
+    dry_run = bool(ctx.obj.get("dry_run"))
+
+    if dry_run:
+        duration_ms = int((time.perf_counter() - started) * 1000)
+        write_log_record(
+            command=command,
+            duration_ms=duration_ms,
+            endpoint=full_url,
+            trace_id=trace_id,
+            http_status=None,
+            result="0",
+            error_type=None,
+            error_message=None,
+            dry_run=True,
+            request_sent=False,
+        )
+        payload = {
+            "dry_run": "ok",
+            "method": method,
+            "endpoint": full_url,
+            "params": params or {},
+            "trace_id": trace_id,
+        }
+        _emit(ctx, payload)
+        return
+
+    client = Clink2Client(
+        endpoint=endpoint,
+        access_key_id=conf["access_key_id"],
+        access_key_secret=conf["access_key_secret"],
+        expires=int(conf.get("expires", cfg.DEFAULT_EXPIRES)),
+    )
+    try:
+        body, meta = client.request(method, path, params=params or {}, trace_id=trace_id)
+        duration_ms = meta["duration_ms"]
+        status = meta["http_status"]
+        ok = 200 <= int(status) < 300
+        write_log_record(
+            command=command,
+            duration_ms=duration_ms,
+            endpoint=meta.get("url") or full_url,
+            trace_id=meta["trace_id"],
+            http_status=status,
+            result="0" if ok else str(status),
+            error_type=None if ok else "http_error",
+            error_message=None if ok else f"HTTP {status}",
+        )
+        if not ok:
+            err = {"error_type": "http_error", "error_message": f"HTTP {status}", "data": body}
+            _emit(ctx, err, exit_code=1)
+            return
+        _emit(ctx, body)
+    except click.exceptions.Exit:
+        raise
+    except Exception as exc:  # noqa: BLE001
+        duration_ms = int((time.perf_counter() - started) * 1000)
+        write_log_record(
+            command=command,
+            duration_ms=duration_ms,
+            endpoint=full_url,
+            trace_id=trace_id,
+            http_status=None,
+            result="1",
+            error_type=type(exc).__name__,
+            error_message=str(exc),
+        )
+        err = {"error_type": type(exc).__name__, "error_message": str(exc)}
+        if ctx.obj.get("as_json"):
+            click.echo(json.dumps(err, ensure_ascii=False, indent=2), err=True)
+        else:
+            raise click.ClickException(str(exc)) from exc
+        ctx.exit(1)
+
+
+@cli.group()
+def ivr() -> None:
+    """语音导航（IVR）查询命令"""
+
+
+@ivr.command("list")
+@click.pass_context
+def ivr_list(ctx: click.Context) -> None:
+    """查询语音导航列表"""
+    _run_api(ctx, "ivr list", "GET", "/cc/list_ivrs", params={})
+
+
+@ivr.command("nodes")
+@click.option(
+    "--ivrName",
+    "ivr_name",
+    required=True,
+    help="语音导航名称（与 OpenAPI 请求参数 ivrName 一致）",
+)
+@click.pass_context
+def ivr_nodes(ctx: click.Context, ivr_name: str) -> None:
+    """查询语音导航节点列表"""
+    _run_api(ctx, "ivr nodes", "GET", "/cc/list_ivr_nodes", params={"ivrName": ivr_name})
+
+
+if __name__ == "__main__":
+    cli()

tinet_clink2_cli-0.0.1/cli_anything/clink2/core/__init__.py

@@ -0,0 +1 @@
+"""Core modules for config, auth, HTTP, and logging."""

tinet_clink2_cli-0.0.1/cli_anything/clink2/core/auth.py

@@ -0,0 +1,64 @@
+"""AK-SK signature helpers for Clink2 OpenAPI."""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+from typing import Mapping
+from urllib.parse import quote
+
+
+def build_string_to_sign(
+    method: str,
+    host: str,
+    path: str,
+    params: Mapping[str, str],
+) -> str:
+    """Build the canonical string to sign for a Clink2 request.
+
+    Args:
+        method: HTTP method (e.g. GET).
+        host: API host without scheme (e.g. api-bj.clink.cn).
+        path: Request path starting with /.
+        params: Query parameters excluding Signature.
+
+    Returns:
+        Canonical string used as hmac-sha1 input.
+    """
+    sorted_items = sorted(params.items(), key=lambda item: item[0])
+    encoded_pairs = [
+        f"{quote(str(name), safe='')}={quote(str(value), safe='')}"
+        for name, value in sorted_items
+    ]
+    query = "&".join(encoded_pairs)
+    return f"{method.upper()}{host}{path}?{query}"
+
+
+def sign_request(
+    access_key_secret: str,
+    method: str,
+    host: str,
+    path: str,
+    params: Mapping[str, str],
+) -> str:
+    """Compute URL-encoded Signature for Clink2 OpenAPI.
+
+    Args:
+        access_key_secret: AccessKeySecret used as HMAC key.
+        method: HTTP method.
+        host: API host without scheme.
+        path: Request path.
+        params: Query parameters excluding Signature.
+
+    Returns:
+        URL-encoded Signature value for the query string.
+    """
+    string_to_sign = build_string_to_sign(method, host, path, params)
+    digest = hmac.new(
+        access_key_secret.encode("utf-8"),
+        string_to_sign.encode("utf-8"),
+        hashlib.sha1,
+    ).digest()
+    # Return raw base64; HTTP clients URL-encode query values once.
+    return base64.b64encode(digest).decode("utf-8")

tinet_clink2_cli-0.0.1/cli_anything/clink2/core/config.py

@@ -0,0 +1,90 @@
+"""Local Clink2 CLI configuration stored under ~/.clink2."""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from typing import Any
+
+DEFAULT_ENDPOINT = "https://api-bj.clink.cn"
+DEFAULT_EXPIRES = 60
+
+
+def config_dir() -> Path:
+    """Return the Clink2 config directory (~/.clink2)."""
+    return Path(os.path.expanduser("~")) / ".clink2"
+
+
+def config_path() -> Path:
+    """Return the path to config.json."""
+    return config_dir() / "config.json"
+
+
+def mask_secret(secret: str) -> str:
+    """Return a masked representation of an access key secret.
+
+    Args:
+        secret: Plaintext secret.
+
+    Returns:
+        Masked string that never equals the plaintext for non-empty secrets.
+    """
+    if not secret:
+        return ""
+    if len(secret) <= 4:
+        return "*" * len(secret)
+    return "*" * (len(secret) - 4) + secret[-4:]
+
+
+def save_config(
+    access_key_id: str,
+    access_key_secret: str,
+    endpoint: str = DEFAULT_ENDPOINT,
+    expires: int = DEFAULT_EXPIRES,
+) -> Path:
+    """Persist credentials and endpoint to ~/.clink2/config.json.
+
+    Args:
+        access_key_id: AccessKeyId.
+        access_key_secret: AccessKeySecret.
+        endpoint: API base URL.
+        expires: Signature expires seconds.
+
+    Returns:
+        Path to the written config file.
+    """
+    directory = config_dir()
+    directory.mkdir(parents=True, exist_ok=True)
+    path = config_path()
+    payload = {
+        "access_key_id": access_key_id,
+        "access_key_secret": access_key_secret,
+        "endpoint": endpoint or DEFAULT_ENDPOINT,
+        "expires": int(expires) if expires is not None else DEFAULT_EXPIRES,
+    }
+    path.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    os.chmod(path, 0o600)
+    return path
+
+
+def load_config() -> dict[str, Any]:
+    """Load configuration from ~/.clink2/config.json.
+
+    Returns:
+        Config dictionary.
+
+    Raises:
+        FileNotFoundError: If config file is missing.
+        ValueError: If required fields are missing.
+    """
+    path = config_path()
+    if not path.exists():
+        raise FileNotFoundError(f"未找到配置文件: {path}。请先执行 `tinet-clink2-cli config set`。")
+    data = json.loads(path.read_text(encoding="utf-8"))
+    for key in ("access_key_id", "access_key_secret"):
+        if not data.get(key):
+            raise ValueError(f"配置缺少必填字段: {key}")
+    data.setdefault("endpoint", DEFAULT_ENDPOINT)
+    data.setdefault("expires", DEFAULT_EXPIRES)
+    return data

tinet_clink2_cli-0.0.1/cli_anything/clink2/core/http.py

@@ -0,0 +1,109 @@
+"""HTTPS client for Clink2 OpenAPI with AK-SK signing."""
+
+from __future__ import annotations
+
+import time
+import uuid
+from typing import Any, Mapping, MutableMapping, Optional, Tuple
+from urllib.parse import urlparse
+
+import requests
+
+from cli_anything.clink2.core.auth import sign_request
+
+
+class Clink2Client:
+    """Clink2 OpenAPI HTTP client."""
+
+    def __init__(
+        self,
+        endpoint: str,
+        access_key_id: str,
+        access_key_secret: str,
+        expires: int = 60,
+        session: Optional[requests.Session] = None,
+    ) -> None:
+        """Initialize client credentials and base endpoint.
+
+        Args:
+            endpoint: Base URL such as https://api-bj.clink.cn.
+            access_key_id: AccessKeyId.
+            access_key_secret: AccessKeySecret.
+            expires: Signature validity in seconds.
+            session: Optional requests session.
+        """
+        self.endpoint = endpoint.rstrip("/")
+        self.access_key_id = access_key_id
+        self.access_key_secret = access_key_secret
+        self.expires = int(expires)
+        self.session = session or requests.Session()
+
+    def _host(self) -> str:
+        """Return API host parsed from endpoint."""
+        parsed = urlparse(self.endpoint)
+        if parsed.scheme != "https":
+            raise ValueError("Only HTTPS endpoints are supported")
+        if not parsed.netloc:
+            raise ValueError(f"Invalid endpoint: {self.endpoint}")
+        return parsed.netloc
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        params: Optional[Mapping[str, Any]] = None,
+        trace_id: Optional[str] = None,
+    ) -> Tuple[Any, dict[str, Any]]:
+        """Send a signed HTTPS request.
+
+        Args:
+            method: HTTP method.
+            path: API path starting with /.
+            params: Business query parameters.
+            trace_id: Optional pre-generated trace id.
+
+        Returns:
+            Tuple of (JSON body, meta dict with http_status, trace_id, duration_ms, url).
+        """
+        business: MutableMapping[str, str] = {
+            str(k): str(v) for k, v in (params or {}).items() if v is not None
+        }
+        timestamp = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+        query: MutableMapping[str, str] = {
+            **business,
+            "AccessKeyId": self.access_key_id,
+            "Expires": str(self.expires),
+            "Timestamp": timestamp,
+        }
+        host = self._host()
+        signature = sign_request(
+            access_key_secret=self.access_key_secret,
+            method=method,
+            host=host,
+            path=path,
+            params=query,
+        )
+        query["Signature"] = signature
+        tid = trace_id or str(uuid.uuid4())
+        url = f"{self.endpoint}{path}"
+        started = time.perf_counter()
+        response = self.session.request(
+            method=method.upper(),
+            url=url,
+            params=query,
+            headers={"X-Trace-Id": tid},
+            timeout=30,
+            verify=True,
+        )
+        duration_ms = int((time.perf_counter() - started) * 1000)
+        try:
+            body: Any = response.json()
+        except ValueError:
+            body = {"raw": response.text}
+        meta = {
+            "http_status": response.status_code,
+            "trace_id": tid,
+            "duration_ms": duration_ms,
+            "url": response.url,
+        }
+        return body, meta

tinet_clink2_cli-0.0.1/cli_anything/clink2/core/logging.py

@@ -0,0 +1,130 @@
+"""Local JSON-lines logging for tinet-clink2-cli."""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import platform
+from datetime import datetime, timezone
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+from typing import Any, Optional
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
+
+from cli_anything.clink2 import __version__
+
+_LOGGER_NAME = "tinet_clink2_cli"
+_handler_configured = False
+
+
+def logs_dir() -> Path:
+    """Return ~/.clink2/logs directory."""
+    return Path(os.path.expanduser("~")) / ".clink2" / "logs"
+
+
+def get_log_path() -> Path:
+    """Return the primary log file path."""
+    return logs_dir() / "clink2.log"
+
+
+def redact_endpoint(endpoint: str) -> str:
+    """Remove or redact Signature from an endpoint URL for safe logging.
+
+    Args:
+        endpoint: Full or partial request URL.
+
+    Returns:
+        URL safe to write to logs.
+    """
+    if not endpoint:
+        return endpoint
+    parts = urlsplit(endpoint)
+    if not parts.query:
+        return endpoint
+    filtered = [(k, v) for k, v in parse_qsl(parts.query, keep_blank_values=True) if k != "Signature"]
+    return urlunsplit((parts.scheme, parts.netloc, parts.path, urlencode(filtered), parts.fragment))
+
+
+def _ensure_handler() -> logging.Logger:
+    """Configure a rotating JSON-line file handler once."""
+    global _handler_configured
+    logger = logging.getLogger(_LOGGER_NAME)
+    logger.setLevel(logging.INFO)
+    logger.propagate = False
+    if not _handler_configured:
+        directory = logs_dir()
+        directory.mkdir(parents=True, exist_ok=True)
+        handler = RotatingFileHandler(
+            get_log_path(),
+            maxBytes=10 * 1024 * 1024,
+            backupCount=5,
+            encoding="utf-8",
+        )
+        handler.setFormatter(logging.Formatter("%(message)s"))
+        logger.addHandler(handler)
+        _handler_configured = True
+    return logger
+
+
+def write_log_record(
+    command: str,
+    duration_ms: int,
+    endpoint: str,
+    trace_id: str,
+    http_status: Optional[int],
+    result: str,
+    error_type: Optional[str] = None,
+    error_message: Optional[str] = None,
+    dry_run: bool = False,
+    request_sent: Optional[bool] = None,
+) -> dict[str, Any]:
+    """Append one JSON log record to the rotating log file.
+
+    Args:
+        command: CLI command path (e.g. ivr list).
+        duration_ms: Elapsed milliseconds.
+        endpoint: Request URL (Signature will be redacted).
+        trace_id: Client-generated trace id.
+        http_status: HTTP status or None for dry-run.
+        result: Result code string ("0" for success).
+        error_type: Optional error type.
+        error_message: Optional error message.
+        dry_run: Whether this invocation was --dry-run.
+        request_sent: Whether an HTTP request was sent. Only written for dry-run.
+
+    Returns:
+        The record that was written.
+    """
+    now = datetime.now().astimezone()
+    record: dict[str, Any] = {
+        "timestamp": now.isoformat(timespec="milliseconds"),
+        "command": command,
+        "cli_version": __version__,
+        "os": platform.system(),
+        "arch": platform.machine(),
+        "duration_ms": duration_ms,
+        "endpoint": redact_endpoint(endpoint),
+        "trace_id": trace_id,
+        "http_status": http_status,
+        "result": result,
+        "error_type": error_type,
+        "error_message": error_message,
+    }
+    # Only emit dry-run markers for --dry-run invocations.
+    if dry_run:
+        record["dry_run"] = True
+        record["request_sent"] = False if request_sent is None else request_sent
+    logger = _ensure_handler()
+    logger.info(json.dumps(record, ensure_ascii=False))
+    return record
+
+
+def reset_logging_for_tests() -> None:
+    """Reset logger handlers (test helper)."""
+    global _handler_configured
+    logger = logging.getLogger(_LOGGER_NAME)
+    for handler in list(logger.handlers):
+        handler.close()
+        logger.removeHandler(handler)
+    _handler_configured = False

tinet_clink2_cli-0.0.1/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tinet-clink2-cli"
+version = "0.0.1"
+description = "Clink2 OpenAPI CLI (AK-SK, IVR queries)"
+readme = "cli_anything/README.md"
+requires-python = ">=3.9"
+dependencies = [
+  "click>=8.0",
+  "requests>=2.28",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0",
+  "responses>=0.25",
+  "build>=1.0",
+]
+
+[project.scripts]
+tinet-clink2-cli = "cli_anything.clink2.clink2_cli:cli"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["cli_anything*"]
+exclude = ["cli_anything.tests", "cli_anything.tests.*"]
+
+[tool.pytest.ini_options]
+testpaths = ["cli_anything/tests"]
+pythonpath = ["."]

tinet_clink2_cli-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: tinet-clink2-cli
+Version: 0.0.1
+Summary: Clink2 OpenAPI CLI (AK-SK, IVR queries)
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: responses>=0.25; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+
+Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
+
+**当前版本：** `0.0.1`  
+**PyPI：** https://pypi.org/project/tinet-clink2-cli/
+
+## 功能概览
+
+| 子命令 | 说明 |
+|--------|------|
+| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`ivr`** | 语音导航查询：列表、节点列表 |
+
+所有出站 HTTP 请求自动附加：
+- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+
+本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
+
+## 环境要求
+
+- Python **≥ 3.9**
+- 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
+- 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
+
+## 安装
+
+从 [PyPI](https://pypi.org/project/tinet-clink2-cli/) 安装（推荐）：
+
+```bash
+pip install tinet-clink2-cli
+tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --help
+```
+
+指定版本或升级：
+
+```bash
+pip install 'tinet-clink2-cli==0.0.1'
+pip install --upgrade tinet-clink2-cli
+```
+
+macOS 等受限环境可使用 [pipx](https://pipx.pypa.io/)：
+
+```bash
+pipx install tinet-clink2-cli
+```
+
+## 配置凭证
+
+**配置文件：** `~/.clink2/config.json`
+
+入参名称与 OpenAPI 公共参数一致：
+
+```bash
+tinet-clink2-cli config set \
+  --AccessKeyId your_access_key_id \
+  --AccessKeySecret your_access_key_secret \
+  --endpoint https://api-bj.clink.cn \
+  --Expires 60
+
+tinet-clink2-cli config show
+```
+
+默认接入地址为北京：`https://api-bj.clink.cn`。`config show` 会对 AccessKeySecret 脱敏。
+
+## 快速示例
+
+顺序与上方「功能概览」一致。完整取值见各子命令 `--help` 或 [开发者中心](https://develop.clink.cn)。
+
+```bash
+# config
+tinet-clink2-cli config show
+
+# ivr
+tinet-clink2-cli ivr list
+tinet-clink2-cli ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --json ivr list
+tinet-clink2-cli --json ivr nodes --ivrName your_ivr_name
+
+# dry-run：仅校验入参与配置，不调用服务端，但仍写本地日志
+tinet-clink2-cli --dry-run ivr list
+tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+```
+
+全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+
+## 帮助与 API 文档
+
+安装后通过 `--help` 查看一级子命令：
+
+```bash
+tinet-clink2-cli --help
+tinet-clink2-cli config --help
+tinet-clink2-cli ivr --help
+```
+
+OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+MANIFEST.in
+pyproject.toml
+cli_anything/README.md
+cli_anything/clink2/__init__.py
+cli_anything/clink2/clink2_cli.py
+cli_anything/clink2/core/__init__.py
+cli_anything/clink2/core/auth.py
+cli_anything/clink2/core/config.py
+cli_anything/clink2/core/http.py
+cli_anything/clink2/core/logging.py
+tinet_clink2_cli.egg-info/PKG-INFO
+tinet_clink2_cli.egg-info/SOURCES.txt
+tinet_clink2_cli.egg-info/dependency_links.txt
+tinet_clink2_cli.egg-info/entry_points.txt
+tinet_clink2_cli.egg-info/requires.txt
+tinet_clink2_cli.egg-info/top_level.txt

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tinet-clink2-cli = cli_anything.clink2.clink2_cli:cli

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/requires.txt

@@ -0,0 +1,7 @@
+click>=8.0
+requests>=2.28
+
+[dev]
+pytest>=7.0
+responses>=0.25
+build>=1.0

tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+cli_anything