tinet-clink2-cli 0.0.1__tar.gz → 0.0.2__tar.gz

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/MANIFEST.in

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

{tinet_clink2_cli-0.0.1/tinet_clink2_cli.egg-info → tinet_clink2_cli-0.0.2}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: tinet-clink2-cli
-Version: 0.0.1
-Summary: Clink2 OpenAPI CLI (AK-SK, IVR queries)
-Requires-Python: >=3.9
+Version: 0.0.2
+Summary: Clink2 OpenAPI CLI
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: click>=8.0
 Requires-Dist: requests>=2.28
@@ -13,24 +13,26 @@ Requires-Dist: build>=1.0; extra == "dev"
 
 Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
 
-**当前版本：** `0.0.1`  
+**当前版本：** `0.0.2`  
 **PyPI：** https://pypi.org/project/tinet-clink2-cli/
 
 ## 功能概览
 
 | 子命令 | 说明 |
 |--------|------|
-| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`config`** | 本地凭证管理 |
 | **`ivr`** | 语音导航查询：列表、节点列表 |
+| **`voicemail`** | 留言箱设置：查看留言箱列表 |
 
 所有出站 HTTP 请求自动附加：
-- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+- `X-Trace-Id: {UUID}`
+- `X-Clink2-CLI-Version: {CLI 版本}`
 
 本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
 
 ## 环境要求
 
-- Python **≥ 3.9**
+- Python **≥ 3.10**
 - 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
 - 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
 
@@ -40,14 +42,14 @@ Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开
 
 ```bash
 pip install tinet-clink2-cli
-tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --version   # 0.0.2
 tinet-clink2-cli --help
 ```
 
 指定版本或升级：
 
 ```bash
-pip install 'tinet-clink2-cli==0.0.1'
+pip install 'tinet-clink2-cli==0.0.2'
 pip install --upgrade tinet-clink2-cli
 ```
 
@@ -61,14 +63,15 @@ 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 \
+  --accessKeyId your_access_key_id \
+  --accessKeySecret your_access_key_secret \
   --endpoint https://api-bj.clink.cn \
-  --Expires 60
+  --expires 60 \
+  --log true
 
 tinet-clink2-cli config show
 ```
@@ -84,26 +87,34 @@ tinet-clink2-cli config show
 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：仅校验入参与配置，不调用服务端，但仍写本地日志
+# dry-run：仅校验入参与配置，不调用服务端（是否写日志取决于 config.log）
 tinet-clink2-cli --dry-run ivr list
-tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --dry-run voicemail list --offset 0 --limit 10
+
+# verbose：向 stderr 打印 url / method / 版本 Header / TraceId / result（不含 body）
+tinet-clink2-cli --verbose --json voicemail list
 ```
 
-全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+全局选项：
+- `--json`：机器可读 stdout
+- `--dry-run`：本地校验与预览，不发请求
+- `--verbose`：stderr 排障
 
-## 帮助与 API 文档
+## 安全提示
 
-安装后通过 `--help` 查看一级子命令：
+- 勿将 AccessKeySecret 写入仓库、截图或日志外发渠道。
+- `config set --log false` 为用户显式关闭本地审计；关闭后排障将缺少本地 JSON 日志。
+
+## 帮助与 API 文档
 
 ```bash
 tinet-clink2-cli --help
 tinet-clink2-cli config --help
 tinet-clink2-cli ivr --help
+tinet-clink2-cli voicemail --help
 ```
 
 OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

{tinet_clink2_cli-0.0.1/cli_anything → tinet_clink2_cli-0.0.2}/README.md

@@ -1,23 +1,25 @@
 Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
 
-**当前版本：** `0.0.1`  
+**当前版本：** `0.0.2`  
 **PyPI：** https://pypi.org/project/tinet-clink2-cli/
 
 ## 功能概览
 
 | 子命令 | 说明 |
 |--------|------|
-| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`config`** | 本地凭证管理 |
 | **`ivr`** | 语音导航查询：列表、节点列表 |
+| **`voicemail`** | 留言箱设置：查看留言箱列表 |
 
 所有出站 HTTP 请求自动附加：
-- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+- `X-Trace-Id: {UUID}`
+- `X-Clink2-CLI-Version: {CLI 版本}`
 
 本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
 
 ## 环境要求
 
-- Python **≥ 3.9**
+- Python **≥ 3.10**
 - 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
 - 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
 
@@ -27,14 +29,14 @@ Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开
 
 ```bash
 pip install tinet-clink2-cli
-tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --version   # 0.0.2
 tinet-clink2-cli --help
 ```
 
 指定版本或升级：
 
 ```bash
-pip install 'tinet-clink2-cli==0.0.1'
+pip install 'tinet-clink2-cli==0.0.2'
 pip install --upgrade tinet-clink2-cli
 ```
 
@@ -48,14 +50,15 @@ 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 \
+  --accessKeyId your_access_key_id \
+  --accessKeySecret your_access_key_secret \
   --endpoint https://api-bj.clink.cn \
-  --Expires 60
+  --expires 60 \
+  --log true
 
 tinet-clink2-cli config show
 ```
@@ -71,26 +74,34 @@ tinet-clink2-cli config show
 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：仅校验入参与配置，不调用服务端，但仍写本地日志
+# dry-run：仅校验入参与配置，不调用服务端（是否写日志取决于 config.log）
 tinet-clink2-cli --dry-run ivr list
-tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --dry-run voicemail list --offset 0 --limit 10
+
+# verbose：向 stderr 打印 url / method / 版本 Header / TraceId / result（不含 body）
+tinet-clink2-cli --verbose --json voicemail list
 ```
 
-全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+全局选项：
+- `--json`：机器可读 stdout
+- `--dry-run`：本地校验与预览，不发请求
+- `--verbose`：stderr 排障
 
-## 帮助与 API 文档
+## 安全提示
 
-安装后通过 `--help` 查看一级子命令：
+- 勿将 AccessKeySecret 写入仓库、截图或日志外发渠道。
+- `config set --log false` 为用户显式关闭本地审计；关闭后排障将缺少本地 JSON 日志。
+
+## 帮助与 API 文档
 
 ```bash
 tinet-clink2-cli --help
 tinet-clink2-cli config --help
 tinet-clink2-cli ivr --help
+tinet-clink2-cli voicemail --help
 ```
 
 OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/cli_anything/clink2/__init__.py

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

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/cli_anything/clink2/clink2_cli.py

@@ -12,23 +12,29 @@ 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
+from cli_anything.clink2.core.logging import redact_endpoint, 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",
+    message="%(prog)s，version %(version)s，released on 2026-07-21",
 )
 @click.option("--json", "as_json", is_flag=True, help="以 JSON 格式输出结果")
 @click.option("--dry-run", is_flag=True, help="仅校验入参与配置，不调用服务端接口")
+@click.option(
+    "--verbose",
+    is_flag=True,
+    help="向 stderr 打印排障信息（url、method、X-Clink2-CLI-Version、X-Trace-Id、result，不含 body）",
+)
 @click.pass_context
-def cli(ctx: click.Context, as_json: bool, dry_run: bool) -> None:
+def cli(ctx: click.Context, as_json: bool, dry_run: bool, verbose: bool) -> None:
     """Clink2 OpenAPI 命令行工具"""
     ctx.ensure_object(dict)
     ctx.obj["as_json"] = as_json
     ctx.obj["dry_run"] = dry_run
+    ctx.obj["verbose"] = verbose
 
 
 @cli.group()
@@ -38,13 +44,13 @@ def config() -> None:
 
 @config.command("set")
 @click.option(
-    "--AccessKeyId",
+    "--accessKeyId",
     "access_key_id",
     required=True,
     help="访问密钥 ID",
 )
 @click.option(
-    "--AccessKeySecret",
+    "--accessKeySecret",
     "access_key_secret",
     required=True,
     help="访问密钥 Secret",
@@ -56,20 +62,34 @@ def config() -> None:
     help="API 接入地址（公有云北京/上海等）",
 )
 @click.option(
-    "--Expires",
+    "--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:
+@click.option(
+    "--log",
+    type=click.Choice(["true", "false"], case_sensitive=False),
+    default="true",
+    show_default=True,
+    help="是否写入本地 JSON 日志文件（true|false）",
+)
+def config_set(
+    access_key_id: str,
+    access_key_secret: str,
+    endpoint: str,
+    expires: int,
+    log: str,
+) -> None:
     """将凭据保存到 ~/.clink2/config.json"""
     path = cfg.save_config(
         access_key_id=access_key_id,
         access_key_secret=access_key_secret,
         endpoint=endpoint,
         expires=expires,
+        log=(log.lower() == "true"),
     )
     click.echo(f"配置已保存到 {path}")
 
@@ -86,6 +106,7 @@ def config_show() -> None:
         "AccessKeySecret": cfg.mask_secret(data["access_key_secret"]),
         "endpoint": data.get("endpoint", cfg.DEFAULT_ENDPOINT),
         "Expires": data.get("expires", cfg.DEFAULT_EXPIRES),
+        "log": data.get("log", cfg.DEFAULT_LOG),
     }
     click.echo(json.dumps(display, ensure_ascii=False, indent=2))
 
@@ -108,6 +129,43 @@ def _emit(ctx: click.Context, payload: Any, *, exit_code: int = 0) -> None:
         ctx.exit(exit_code)
 
 
+def _openapi_business_result(body: Any, *, transport_ok: bool) -> str:
+    """从 OpenAPI 响应体解析业务状态码 result。
+
+    平台约定（如座席详细信息获取 Wiki）：``0`` 成功，``-1`` 失败（常伴随
+    ``errorCode`` / ``description``）。若响应体未带 ``result`` 字段（部分新版
+    CC 列表接口仅返回 ``requestId`` + 业务数据），则：传输成功记 ``0``，否则 ``-1``。
+
+    Args:
+        body: Parsed JSON body (dict/list/other).
+        transport_ok: Whether HTTP layer succeeded (2xx).
+
+    Returns:
+        Business result as string, e.g. ``"0"`` or ``"-1"``.
+    """
+    if isinstance(body, dict) and body.get("result") is not None:
+        return str(body["result"])
+    return "0" if transport_ok else "-1"
+
+
+def _emit_verbose(url: str, version: str, trace_id: str, method: str, result: str) -> None:
+    """向 stderr 打印排障信息（不含 body）。
+
+    Args:
+        url: Request URL (Signature should already be redacted by caller or here).
+        version: CLI version string for X-Clink2-CLI-Version.
+        trace_id: Client trace id.
+        method: HTTP method such as GET or POST.
+        result: OpenAPI 业务状态码（响应体 result；0 成功，-1 失败）。
+    """
+    safe_url = redact_endpoint(url)
+    click.echo(f"url={safe_url}", err=True)
+    click.echo(f"method={method.upper()}", err=True)
+    click.echo(f"X-Clink2-CLI-Version={version}", err=True)
+    click.echo(f"X-Trace-Id={trace_id}", err=True)
+    click.echo(f"result={result}", err=True)
+
+
 def _run_api(
     ctx: click.Context,
     command: str,
@@ -115,15 +173,21 @@ def _run_api(
     path: str,
     params: Optional[dict[str, Any]] = None,
 ) -> None:
-    """执行 API 调用或 dry-run，并写本地日志"""
+    """执行 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"))
+    verbose = bool(ctx.obj.get("verbose"))
+    log_enabled = bool(conf.get("log", True))
+    http_method = method.upper()
 
     if dry_run:
+        # 无 OpenAPI 响应体：本地校验通过按业务成功 0 记录
+        if verbose:
+            _emit_verbose(full_url, __version__, trace_id, http_method, "0")
         duration_ms = int((time.perf_counter() - started) * 1000)
         write_log_record(
             command=command,
@@ -136,10 +200,11 @@ def _run_api(
             error_message=None,
             dry_run=True,
             request_sent=False,
+            enabled=log_enabled,
         )
         payload = {
             "dry_run": "ok",
-            "method": method,
+            "method": http_method,
             "endpoint": full_url,
             "params": params or {},
             "trace_id": trace_id,
@@ -154,38 +219,59 @@ def _run_api(
         expires=int(conf.get("expires", cfg.DEFAULT_EXPIRES)),
     )
     try:
-        body, meta = client.request(method, path, params=params or {}, trace_id=trace_id)
+        body, meta = client.request(http_method, path, params=params or {}, trace_id=trace_id)
         duration_ms = meta["duration_ms"]
         status = meta["http_status"]
-        ok = 200 <= int(status) < 300
+        http_ok = 200 <= int(status) < 300
+        result = _openapi_business_result(body, transport_ok=http_ok)
+        business_ok = result == "0"
+        if verbose:
+            _emit_verbose(
+                meta.get("url") or full_url,
+                __version__,
+                meta["trace_id"],
+                http_method,
+                result,
+            )
         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}",
+            result=result,
+            error_type=None if (http_ok and business_ok) else ("http_error" if not http_ok else "business_error"),
+            error_message=(
+                None
+                if (http_ok and business_ok)
+                else (f"HTTP {status}" if not http_ok else f"OpenAPI result={result}")
+            ),
+            enabled=log_enabled,
         )
-        if not ok:
+        if not http_ok:
             err = {"error_type": "http_error", "error_message": f"HTTP {status}", "data": body}
             _emit(ctx, err, exit_code=1)
             return
+        if not business_ok:
+            _emit(ctx, body, 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)
+        if verbose:
+            _emit_verbose(full_url, __version__, trace_id, http_method, "-1")
         write_log_record(
             command=command,
             duration_ms=duration_ms,
             endpoint=full_url,
             trace_id=trace_id,
             http_status=None,
-            result="1",
+            result="-1",
             error_type=type(exc).__name__,
             error_message=str(exc),
+            enabled=log_enabled,
         )
         err = {"error_type": type(exc).__name__, "error_message": str(exc)}
         if ctx.obj.get("as_json"):
@@ -212,7 +298,7 @@ def ivr_list(ctx: click.Context) -> None:
     "--ivrName",
     "ivr_name",
     required=True,
-    help="语音导航名称（与 OpenAPI 请求参数 ivrName 一致）",
+    help="语音导航名称",
 )
 @click.pass_context
 def ivr_nodes(ctx: click.Context, ivr_name: str) -> None:
@@ -220,5 +306,43 @@ def ivr_nodes(ctx: click.Context, ivr_name: str) -> None:
     _run_api(ctx, "ivr nodes", "GET", "/cc/list_ivr_nodes", params={"ivrName": ivr_name})
 
 
+@cli.group()
+def voicemail() -> None:
+    """留言箱设置相关查询命令"""
+
+
+@voicemail.command("list")
+@click.option(
+    "--offset",
+    default=0,
+    show_default=True,
+    type=int,
+    help="偏移量，范围 0-99990。默认值为 0。注：limit + offset 不允许超过 100000",
+)
+@click.option(
+    "--limit",
+    default=10,
+    show_default=True,
+    type=int,
+    help="查询条数，范围 10-100。默认值为 10。注：limit + offset 不允许超过 100000",
+)
+@click.pass_context
+def voicemail_list(ctx: click.Context, offset: int, limit: int) -> None:
+    """查看留言箱列表"""
+    if offset < 0 or offset > 99990:
+        raise click.ClickException("offset 超出范围 0-99990")
+    if limit < 10 or limit > 100:
+        raise click.ClickException("limit 超出范围 10-100")
+    if limit + offset > 100000:
+        raise click.ClickException("limit + offset 不允许超过 100000")
+    _run_api(
+        ctx,
+        "voicemail list",
+        "GET",
+        "/cc/list_voice_mails",
+        params={"offset": offset, "limit": limit},
+    )
+
+
 if __name__ == "__main__":
     cli()

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/cli_anything/clink2/core/config.py

@@ -9,6 +9,7 @@ from typing import Any
 
 DEFAULT_ENDPOINT = "https://api-bj.clink.cn"
 DEFAULT_EXPIRES = 60
+DEFAULT_LOG = True
 
 
 def config_dir() -> Path:
@@ -42,6 +43,7 @@ def save_config(
     access_key_secret: str,
     endpoint: str = DEFAULT_ENDPOINT,
     expires: int = DEFAULT_EXPIRES,
+    log: bool = DEFAULT_LOG,
 ) -> Path:
     """Persist credentials and endpoint to ~/.clink2/config.json.
 
@@ -50,6 +52,7 @@ def save_config(
         access_key_secret: AccessKeySecret.
         endpoint: API base URL.
         expires: Signature expires seconds.
+        log: Whether to write local JSON log files.
 
     Returns:
         Path to the written config file.
@@ -62,6 +65,7 @@ def save_config(
         "access_key_secret": access_key_secret,
         "endpoint": endpoint or DEFAULT_ENDPOINT,
         "expires": int(expires) if expires is not None else DEFAULT_EXPIRES,
+        "log": bool(log),
     }
     path.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
     os.chmod(path, 0o600)
@@ -76,7 +80,7 @@ def load_config() -> dict[str, Any]:
 
     Raises:
         FileNotFoundError: If config file is missing.
-        ValueError: If required fields are missing.
+        ValueError: If required fields are missing or log is not a boolean.
     """
     path = config_path()
     if not path.exists():
@@ -87,4 +91,8 @@ def load_config() -> dict[str, Any]:
             raise ValueError(f"配置缺少必填字段: {key}")
     data.setdefault("endpoint", DEFAULT_ENDPOINT)
     data.setdefault("expires", DEFAULT_EXPIRES)
+    if "log" not in data:
+        data["log"] = DEFAULT_LOG
+    elif not isinstance(data["log"], bool):
+        raise ValueError("配置字段 log 必须为 JSON boolean（true/false）")
     return data

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/cli_anything/clink2/core/http.py

@@ -9,6 +9,7 @@ from urllib.parse import urlparse
 
 import requests
 
+from cli_anything.clink2 import __version__
 from cli_anything.clink2.core.auth import sign_request
 
 
@@ -91,7 +92,10 @@ class Clink2Client:
             method=method.upper(),
             url=url,
             params=query,
-            headers={"X-Trace-Id": tid},
+            headers={
+                "X-Trace-Id": tid,
+                "X-Clink2-CLI-Version": __version__,
+            },
             timeout=30,
             verify=True,
         )

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/cli_anything/clink2/core/logging.py

@@ -78,6 +78,7 @@ def write_log_record(
     error_message: Optional[str] = None,
     dry_run: bool = False,
     request_sent: Optional[bool] = None,
+    enabled: bool = True,
 ) -> dict[str, Any]:
     """Append one JSON log record to the rotating log file.
 
@@ -92,9 +93,10 @@ def write_log_record(
         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.
+        enabled: When False, skip writing to the log file (still return the record).
 
     Returns:
-        The record that was written.
+        The record that was written (or would have been written).
     """
     now = datetime.now().astimezone()
     record: dict[str, Any] = {
@@ -115,6 +117,8 @@ def write_log_record(
     if dry_run:
         record["dry_run"] = True
         record["request_sent"] = False if request_sent is None else request_sent
+    if not enabled:
+        return record
     logger = _ensure_handler()
     logger.info(json.dumps(record, ensure_ascii=False))
     return record

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/pyproject.toml

@@ -4,10 +4,10 @@ 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"
+version = "0.0.2"
+description = "Clink2 OpenAPI CLI"
+readme = "README.md"
+requires-python = ">=3.10"
 dependencies = [
   "click>=8.0",
   "requests>=2.28",

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2/tinet_clink2_cli.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: tinet-clink2-cli
-Version: 0.0.1
-Summary: Clink2 OpenAPI CLI (AK-SK, IVR queries)
-Requires-Python: >=3.9
+Version: 0.0.2
+Summary: Clink2 OpenAPI CLI
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: click>=8.0
 Requires-Dist: requests>=2.28
@@ -13,24 +13,26 @@ Requires-Dist: build>=1.0; extra == "dev"
 
 Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开发者中心](https://develop.clink.cn) 中参数与响应一致，适合脚本化集成与 Agent 调用。
 
-**当前版本：** `0.0.1`  
+**当前版本：** `0.0.2`  
 **PyPI：** https://pypi.org/project/tinet-clink2-cli/
 
 ## 功能概览
 
 | 子命令 | 说明 |
 |--------|------|
-| **`config`** | 本地凭证管理（AccessKeyId / AccessKeySecret / 接入地址 / Expires） |
+| **`config`** | 本地凭证管理 |
 | **`ivr`** | 语音导航查询：列表、节点列表 |
+| **`voicemail`** | 留言箱设置：查看留言箱列表 |
 
 所有出站 HTTP 请求自动附加：
-- `X-Trace-Id: {UUID}`（每次请求新生成，不参与签名）
+- `X-Trace-Id: {UUID}`
+- `X-Clink2-CLI-Version: {CLI 版本}`
 
 本地默认写入 JSON Lines 日志：`~/.clink2/logs/clink2.log`（单文件最大 10MB，滚动保留 5 个）。
 
 ## 环境要求
 
-- Python **≥ 3.9**
+- Python **≥ 3.10**
 - 运行时需访问公有云接入地址，例如 `https://api-bj.clink.cn` / `https://api-sh.clink.cn`
 - 需在管理后台获取 AccessKeyId / AccessKeySecret（系统管理 → 安全设置 → 接口密钥）
 
@@ -40,14 +42,14 @@ Clink2 命令行客户端，封装 OpenAPI 接口，与 [智慧服务平台开
 
 ```bash
 pip install tinet-clink2-cli
-tinet-clink2-cli --version   # 0.0.1
+tinet-clink2-cli --version   # 0.0.2
 tinet-clink2-cli --help
 ```
 
 指定版本或升级：
 
 ```bash
-pip install 'tinet-clink2-cli==0.0.1'
+pip install 'tinet-clink2-cli==0.0.2'
 pip install --upgrade tinet-clink2-cli
 ```
 
@@ -61,14 +63,15 @@ 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 \
+  --accessKeyId your_access_key_id \
+  --accessKeySecret your_access_key_secret \
   --endpoint https://api-bj.clink.cn \
-  --Expires 60
+  --expires 60 \
+  --log true
 
 tinet-clink2-cli config show
 ```
@@ -84,26 +87,34 @@ tinet-clink2-cli config show
 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：仅校验入参与配置，不调用服务端，但仍写本地日志
+# dry-run：仅校验入参与配置，不调用服务端（是否写日志取决于 config.log）
 tinet-clink2-cli --dry-run ivr list
-tinet-clink2-cli --dry-run ivr nodes --ivrName your_ivr_name
+tinet-clink2-cli --dry-run voicemail list --offset 0 --limit 10
+
+# verbose：向 stderr 打印 url / method / 版本 Header / TraceId / result（不含 body）
+tinet-clink2-cli --verbose --json voicemail list
 ```
 
-全局 `--json` 输出 OpenAPI 原始 JSON。`--dry-run` 做本地校验与预览（不发请求），详见 `--help`。
+全局选项：
+- `--json`：机器可读 stdout
+- `--dry-run`：本地校验与预览，不发请求
+- `--verbose`：stderr 排障
 
-## 帮助与 API 文档
+## 安全提示
 
-安装后通过 `--help` 查看一级子命令：
+- 勿将 AccessKeySecret 写入仓库、截图或日志外发渠道。
+- `config set --log false` 为用户显式关闭本地审计；关闭后排障将缺少本地 JSON 日志。
+
+## 帮助与 API 文档
 
 ```bash
 tinet-clink2-cli --help
 tinet-clink2-cli config --help
 tinet-clink2-cli ivr --help
+tinet-clink2-cli voicemail --help
 ```
 
 OpenAPI 契约与字段说明见 [智慧服务平台开发者中心](https://develop.clink.cn)。

{tinet_clink2_cli-0.0.1 → tinet_clink2_cli-0.0.2}/tinet_clink2_cli.egg-info/SOURCES.txt

@@ -1,6 +1,6 @@
 MANIFEST.in
+README.md
 pyproject.toml
-cli_anything/README.md
 cli_anything/clink2/__init__.py
 cli_anything/clink2/clink2_cli.py
 cli_anything/clink2/core/__init__.py