@cvtoolman/huawei-lts-cli 1.0.1 → 1.0.3

package/README.md

@@ -1,194 +1,261 @@
-# huawei-lts-cli — CLI + SKILL
-
-**简体中文** | [English](README_en.md)
-
-[![npm version](https://img.shields.io/npm/v/@cvtoolman/huawei-lts-cli.svg)](https://www.npmjs.com/package/@cvtoolman/huawei-lts-cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
-> 让你的 AI 编程助手（Claude Code、Cursor、Copilot、Qoder 等）通过自然语言查询华为云日志服务（LTS）。
-
-**一个工具，两部分：**
-
-| 部分 | 作用 |
-|---|---|
-| **CLI** (`lts-cli`) | 轻量命令行工具，对接华为云 LTS API |
-| **SKILL** (`SKILL.md`) | 一份给 AI 看的"说明书"，教它如何把自然语言转成 CLI 命令 |
-
-AI 读完 skill 后，你只需说一句"查下今天的 ERROR 日志"，AI 就能自动拼出正确的 `lts-cli` 命令并执行。不用记参数，不用手写 ISO 8601 时间格式。
-
-## 为什么用 CLI + SKILL 而不是 MCP？
-
-AI 编程助手的上下文窗口很宝贵——一边要装代码库、一边要推理、一边还要跑工具。**省 token 就是省时省钱。**
-
-| | CLI + SKILL | MCP |
-|---|---|---|
-| **上下文开销** | **低** — skill 就一个短 markdown 文件，CLI 输出是纯文本 | **高** — 工具 schema + 快照数据常驻上下文 |
-| **AI 使用方式** | 执行 shell 命令，读取结果 | 通过协议调用结构化工具 |
-| **配置难度** | `npm install -g`、一个 skill 文件 | 服务进程、配置连线 |
-| **适用场景** | 编码过程中顺手查日志 | 长时间运行的自动化循环 |
-
-> **一句话：** 如果你想让 AI 在写代码时顺嘴帮你查日志——CLI + SKILL 是更轻、更省钱的方案。
-
-## 快速开始
-
-### 1. 安装 CLI
-
-```bash
-npm install -g @cvtoolman/huawei-lts-cli
-```
-
-### 2. 配置凭证
-
-```bash
-lts-cli init
-```
-
-向导会依次询问 AK、SK、Project ID、Region，一次配好。配置存储在 `~/.lts-cli/config.json`。
-
-### 3. 安装 Skill（给 AI 工具用）
-
-**Claude Code:**
-```bash
-mkdir -p .claude/skills/huawei-lts-log-query
-curl -o .claude/skills/huawei-lts-log-query/SKILL.md \
-  https://raw.githubusercontent.com/jcxy/huawei-lts-cli/main/skills/huawei-lts-log-query/SKILL.md
-```
-
-**Qoder:**
-```bash
-mkdir -p .qoder/skills/huawei-lts-log-query
-curl -o .qoder/skills/huawei-lts-log-query/SKILL.md \
-  https://raw.githubusercontent.com/jcxy/huawei-lts-cli/main/skills/huawei-lts-log-query/SKILL.md
-```
-
-**手动安装（任意 AI 工具）：** 将 [skills/huawei-lts-log-query/SKILL.md](skills/huawei-lts-log-query/SKILL.md) 复制到对应 AI 工具的 skills 目录下（`.claude/skills/`、`.qoder/skills/`、`.cursor/skills/` 等）。
-
-### 4. 命令行直接使用（不依赖 AI）
-
-```bash
-# 基础查询
-lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
-
-# 关键词搜索
-lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z -k "ERROR"
-
-# JSON 格式输出，管道给 jq 处理
-lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z -f json | jq .
-```
-
-## 命令参考
-
-### `lts-cli query` — 查询日志
-
-```
-lts-cli query [选项]
-
-选项:
-  -g, --group-id <groupId>      日志组 ID（可在配置中预设）
-  -s, --stream-id <streamId>    日志流 ID（可在配置中预设）
-  --start-time, --st <time>     开始时间，ISO 8601 格式（必填）
-  --end-time, --et <time>       结束时间，ISO 8601 格式（必填）
-  -k, --keyword <keyword>       搜索关键词
-  -l, --limit <limit>           每页条数（默认: 100）
-  -o, --offset <offset>         分页偏移量（默认: 0）
-  -r, --reverse                 按时间倒序
-  -f, --format <format>         输出格式: pretty、json、table（默认: pretty）
-  --no-paginate                 关闭自动翻页
-```
-
-### `lts-cli config` — 管理配置
-
-```
-lts-cli config [选项]
-
-选项:
-  --set <key=value>             设置配置项
-  --get <key>                   查看配置项
-  --list                        列出所有配置
-  --unset <key>                 删除配置项
-```
-
-### `lts-cli init` — 配置向导
-
-```
-lts-cli init
-
-交互式向导，引导设置 AK、SK、Project ID、Region、endpoint，
-以及可选的默认日志组和日志流。
-```
-
-### `lts-cli completion` — Shell 补全
-
-```
-lts-cli completion <bash|zsh|powershell>
-
-生成 shell 补全脚本。
-```
-
-## 配置说明
-
-配置存储在 `~/.lts-cli/config.json`（Linux/macOS）或 `%USERPROFILE%\.lts-cli\config.json`（Windows）。
-
-| 键 | 必填 | 说明 |
-|---|---|---|
-| `ak` | 是 | 华为云访问密钥 |
-| `sk` | 是 | 华为云私有密钥 |
-| `projectId` | 是 | 项目 ID |
-| `region` | 否 | 如 `cn-south-1` |
-| `endpoint` | 否 | 需包含 `https://` |
-| `groupId` | 否 | 默认日志组 ID |
-| `streamId` | 否 | 默认日志流 ID |
-
-### 环境变量
-
-所有配置项也支持环境变量（适用于 CI/CD）：
-
-| 配置键 | 环境变量 |
-|---|---|
-| `ak` | `LTS_AK` |
-| `sk` | `LTS_SK` |
-| `projectId` | `LTS_PROJECT_ID` |
-| `region` | `LTS_REGION` |
-| `endpoint` | `LTS_ENDPOINT` |
-| `groupId` | `LTS_GROUP_ID` |
-| `streamId` | `LTS_STREAM_ID` |
-
-环境变量优先级高于配置文件。
-
-## 支持的区域
-
-| 区域 ID | 区域名称 | Endpoint |
-|---|---|---|
-| `cn-north-1` | 华北-北京一 | `lts.cn-north-1.myhuaweicloud.com` |
-| `cn-north-4` | 华北-北京四 | `lts.cn-north-4.myhuaweicloud.com` |
-| `cn-east-2` | 华东-上海二 | `lts.cn-east-2.myhuaweicloud.com` |
-| `cn-east-3` | 华东-上海三 | `lts.cn-east-3.myhuaweicloud.com` |
-| `cn-south-1` | 华南-广州 | `lts.cn-south-1.myhuaweicloud.com` |
-| `cn-south-4` | 华南-深圳 | `lts.cn-south-4.myhuaweicloud.com` |
-| `cn-southwest-2` | 西南-贵阳一 | `lts.cn-southwest-2.myhuaweicloud.com` |
-| `ap-southeast-1` | 亚太-新加坡 | `lts.ap-southeast-1.myhuaweicloud.com` |
-| `ap-southeast-2` | 亚太-曼谷 | `lts.ap-southeast-2.myhuaweicloud.com` |
-| `ap-southeast-3` | 亚太-雅加达 | `lts.ap-southeast-3.myhuaweicloud.com` |
-| `af-south-1` | 非洲-约翰内斯堡 | `lts.af-south-1.myhuaweicloud.com` |
-
-> 完整列表请参考 [华为云 LTS 终端节点](https://support.huaweicloud.com/api-lts/lts_api_0011.html)。
-
-## 开发指南
-
-```bash
-git clone https://github.com/jcxy/huawei-lts-cli.git
-cd huawei-lts-cli
-npm install
-npm run build
-
-# 开发模式运行（无需编译）
-npm run dev -- query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
-
-# 本地测试
-npm link
-lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
-```
-
-## License
-
-[MIT](LICENSE)
+# huawei-lts-cli — CLI + SKILL
+
+**简体中文** | [English](README_en.md)
+
+[![npm version](https://img.shields.io/npm/v/@cvtoolman/huawei-lts-cli.svg)](https://www.npmjs.com/package/@cvtoolman/huawei-lts-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> 让你的 AI 编程助手（Claude Code、Cursor、Copilot、Qoder 等）通过自然语言查询华为云日志服务（LTS）。
+
+**一个工具，两部分：**
+
+| 部分 | 作用 |
+|---|---|
+| **CLI** (`lts-cli`) | 轻量命令行工具，对接华为云 LTS API |
+| **SKILL** (`SKILL.md`) | 一份给 AI 看的"说明书"，教它如何把自然语言转成 CLI 命令 |
+
+AI 读完 skill 后，你只需说一句"查下今天的 ERROR 日志"，AI 就能自动拼出正确的 `lts-cli` 命令并执行。不用记参数，不用手写 ISO 8601 时间格式。
+
+## 为什么用 CLI + SKILL 而不是 MCP？
+
+AI 编程助手的上下文窗口很宝贵——一边要装代码库、一边要推理、一边还要跑工具。**省 token 就是省时省钱。**
+
+| | CLI + SKILL | MCP |
+|---|---|---|
+| **上下文开销** | **低** — skill 就一个短 markdown 文件，CLI 输出是纯文本 | **高** — 工具 schema + 快照数据常驻上下文 |
+| **AI 使用方式** | 执行 shell 命令，读取结果 | 通过协议调用结构化工具 |
+| **配置难度** | `npm install -g`、一个 skill 文件 | 服务进程、配置连线 |
+| **适用场景** | 编码过程中顺手查日志 | 长时间运行的自动化循环 |
+
+> **一句话：** 如果你想让 AI 在写代码时顺嘴帮你查日志——CLI + SKILL 是更轻、更省钱的方案。
+
+## 快速开始
+
+### 1. 安装 CLI
+
+```bash
+npm install -g @cvtoolman/huawei-lts-cli
+```
+
+### 2. 配置凭证
+
+```bash
+lts-cli init
+```
+
+向导会依次询问 AK、SK、Project ID、Region，一次配好。配置存储在 `~/.lts-cli/config.json`。
+
+### 3. 安装 Skill（给 AI 工具用）
+
+**Claude Code:**
+```bash
+mkdir -p .claude/skills/huawei-lts-log-query
+curl -o .claude/skills/huawei-lts-log-query/SKILL.md \
+  https://raw.githubusercontent.com/jcxy/huawei-lts-cli/main/skills/huawei-lts-log-query/SKILL.md
+```
+
+**Qoder:**
+```bash
+mkdir -p .qoder/skills/huawei-lts-log-query
+curl -o .qoder/skills/huawei-lts-log-query/SKILL.md \
+  https://raw.githubusercontent.com/jcxy/huawei-lts-cli/main/skills/huawei-lts-log-query/SKILL.md
+```
+
+**手动安装（任意 AI 工具）：** 将 [skills/huawei-lts-log-query/SKILL.md](skills/huawei-lts-log-query/SKILL.md) 复制到对应 AI 工具的 skills 目录下（`.claude/skills/`、`.qoder/skills/`、`.cursor/skills/` 等）。
+
+### 4. 命令行直接使用（不依赖 AI）
+
+```bash
+# 基础查询
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
+
+# 简单关键词搜索（旧版，向后兼容）
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z -k "ERROR"
+
+# 高级查询：多字段组合（推荐）
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "content:error AND appName:myapp"
+
+# 复杂逻辑查询
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "(level:ERROR OR level:WARN) NOT env:test"
+
+# SQL 分析查询
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "SELECT count(*) as cnt, level FROM log GROUP BY level" \
+  -f json
+
+# JSON 格式输出，管道给 jq 处理
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z -f json | jq .
+```
+
+> 💡 **提示**：使用 `-q` 参数可实现与 LTS 控制台相同的多条件组合查询功能。详见 [查询语法速查表](skills/huawei-lts-log-query/references/cheatsheet.md) 和 [高级查询指南](skills/huawei-lts-log-query/references/advanced-query-guide.md)。
+
+## 命令参考
+
+### `lts-cli query` — 查询日志
+
+```bash
+lts-cli query [选项]
+
+选项:
+  -g, --group-id <groupId>      日志组 ID（可在配置中预设）
+  -s, --stream-id <streamId>    日志流 ID（可在配置中预设）
+  --start-time, --st <time>     开始时间，ISO 8601 格式（必填）
+  --end-time, --et <time>       结束时间，ISO 8601 格式（必填）
+  -k, --keyword <keyword>       简单关键词搜索（旧版，不推荐）
+  -q, --query <query>           高级查询表达式（推荐）：
+                                  - 字段查询: content:error AND appName:myapp
+                                  - 比较运算: time>60 AND region:r
+                                  - SQL语法: SELECT * FROM log WHERE ...
+                                  - 逻辑运算符: AND, OR, NOT（需空格分隔）
+  -l, --limit <limit>           每页条数（默认: 100）
+  -o, --offset <offset>         分页偏移量（默认: 0）
+  -r, --reverse                 按时间倒序
+  -f, --format <format>         输出格式: pretty、json、table（默认: pretty）
+  --no-paginate                 关闭自动翻页
+```
+
+#### 高级查询语法示例
+
+**字段查询：**
+```bash
+# 单字段匹配
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "content:error"
+
+# 多字段组合（且关系）
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "content:error AND appName:myapp AND node:server1"
+
+# 多字段组合（或关系）
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "level:ERROR OR level:WARN"
+
+# 排除条件
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "level:DEBUG NOT module:test"
+
+# 数值比较
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "response_time>1000 AND status_code!=200"
+
+# 复杂组合
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "(level:ERROR OR level:WARN) NOT env:test"
+```
+
+**SQL 查询：**
+```bash
+# 统计各应用错误数量
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "SELECT count(*) as cnt, appName FROM log WHERE content LIKE '%error%' GROUP BY appName"
+
+# 平均响应时间
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z \
+  -q "SELECT avg(response_time) as avg_time FROM log WHERE status_code=200"
+```
+
+> ⚠️ **注意**：AND、OR、NOT 前后必须有**空格**！
+
+详细文档请查看：
+- [查询语法速查表](skills/huawei-lts-log-query/references/cheatsheet.md)
+- [高级查询指南](skills/huawei-lts-log-query/references/advanced-query-guide.md)
+- [控制台 vs CLI 对照](skills/huawei-lts-log-query/references/query-comparison.md)
+
+### `lts-cli config` — 管理配置
+
+```
+lts-cli config [选项]
+
+选项:
+  --set <key=value>             设置配置项
+  --get <key>                   查看配置项
+  --list                        列出所有配置
+  --unset <key>                 删除配置项
+```
+
+### `lts-cli init` — 配置向导
+
+```
+lts-cli init
+
+交互式向导，引导设置 AK、SK、Project ID、Region、endpoint，
+以及可选的默认日志组和日志流。
+```
+
+### `lts-cli completion` — Shell 补全
+
+```
+lts-cli completion <bash|zsh|powershell>
+
+生成 shell 补全脚本。
+```
+
+## 配置说明
+
+配置存储在 `~/.lts-cli/config.json`（Linux/macOS）或 `%USERPROFILE%\.lts-cli\config.json`（Windows）。
+
+| 键 | 必填 | 说明 |
+|---|---|---|
+| `ak` | 是 | 华为云访问密钥 |
+| `sk` | 是 | 华为云私有密钥 |
+| `projectId` | 是 | 项目 ID |
+| `region` | 否 | 如 `cn-south-1` |
+| `endpoint` | 否 | 需包含 `https://` |
+| `groupId` | 否 | 默认日志组 ID |
+| `streamId` | 否 | 默认日志流 ID |
+
+### 环境变量
+
+所有配置项也支持环境变量（适用于 CI/CD）：
+
+| 配置键 | 环境变量 |
+|---|---|
+| `ak` | `LTS_AK` |
+| `sk` | `LTS_SK` |
+| `projectId` | `LTS_PROJECT_ID` |
+| `region` | `LTS_REGION` |
+| `endpoint` | `LTS_ENDPOINT` |
+| `groupId` | `LTS_GROUP_ID` |
+| `streamId` | `LTS_STREAM_ID` |
+
+环境变量优先级高于配置文件。
+
+## 支持的区域
+
+| 区域 ID | 区域名称 | Endpoint |
+|---|---|---|
+| `cn-north-1` | 华北-北京一 | `lts.cn-north-1.myhuaweicloud.com` |
+| `cn-north-4` | 华北-北京四 | `lts.cn-north-4.myhuaweicloud.com` |
+| `cn-east-2` | 华东-上海二 | `lts.cn-east-2.myhuaweicloud.com` |
+| `cn-east-3` | 华东-上海三 | `lts.cn-east-3.myhuaweicloud.com` |
+| `cn-south-1` | 华南-广州 | `lts.cn-south-1.myhuaweicloud.com` |
+| `cn-south-4` | 华南-深圳 | `lts.cn-south-4.myhuaweicloud.com` |
+| `cn-southwest-2` | 西南-贵阳一 | `lts.cn-southwest-2.myhuaweicloud.com` |
+| `ap-southeast-1` | 亚太-新加坡 | `lts.ap-southeast-1.myhuaweicloud.com` |
+| `ap-southeast-2` | 亚太-曼谷 | `lts.ap-southeast-2.myhuaweicloud.com` |
+| `ap-southeast-3` | 亚太-雅加达 | `lts.ap-southeast-3.myhuaweicloud.com` |
+| `af-south-1` | 非洲-约翰内斯堡 | `lts.af-south-1.myhuaweicloud.com` |
+
+> 完整列表请参考 [华为云 LTS 终端节点](https://support.huaweicloud.com/api-lts/lts_api_0011.html)。
+
+## 开发指南
+
+```bash
+git clone https://github.com/jcxy/huawei-lts-cli.git
+cd huawei-lts-cli
+npm install
+npm run build
+
+# 开发模式运行（无需编译）
+npm run dev -- query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
+
+# 本地测试
+npm link
+lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/cli/commands/common.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCheckedConfig = loadCheckedConfig;
+exports.resolveGroupStream = resolveGroupStream;
+exports.resolveTimeParams = resolveTimeParams;
+exports.buildQueryExpression = buildQueryExpression;
+exports.resolveFormat = resolveFormat;
+exports.handleCommandError = handleCommandError;
+const config_1 = require("../../config");
+/** 加载配置并校验凭证，缺失时打印引导并退出 */
+function loadCheckedConfig() {
+    const config = (0, config_1.loadConfig)();
+    if (!config.ak || !config.sk || !config.projectId) {
+        console.error('Error: Missing required credentials. Please configure them first:');
+        console.error('');
+        console.error('  Quick setup (recommended):');
+        console.error('    lts-cli init');
+        console.error('');
+        console.error('  Or set individually:');
+        console.error('    lts-cli config --set ak=<your-access-key>');
+        console.error('    lts-cli config --set sk=<your-secret-key>');
+        console.error('    lts-cli config --set projectId=<your-project-id>');
+        process.exit(1);
+    }
+    return config;
+}
+/** groupId/streamId：CLI 参数优先，其次配置默认值，都没有则报错退出 */
+function resolveGroupStream(options, config) {
+    const groupId = options.groupId || config.groupId;
+    const streamId = options.streamId || config.streamId;
+    if (!groupId || !streamId) {
+        console.error('Error: groupId and streamId are required. Provide them via:');
+        console.error('  lts-cli config --set groupId=<your-group-id>');
+        console.error('    lts-cli config --set streamId=<your-stream-id>');
+        console.error('  or use -g <groupId> -s <streamId> flags');
+        console.error('  Tip: run "lts-cli groups" / "lts-cli streams" to discover IDs');
+        process.exit(1);
+    }
+    return { groupId, streamId };
+}
+/** 解析时间选项：--last 与 --st/--et 互斥，至少提供一组 */
+function resolveTimeParams(options, defaultLast) {
+    const startTime = options.startTime || options.st;
+    const endTime = options.endTime || options.et;
+    const last = options.last || (!startTime && !endTime ? defaultLast : undefined);
+    if (last && (startTime || endTime)) {
+        console.error('Error: --last is mutually exclusive with --start-time/--end-time. Provide only one style.');
+        process.exit(1);
+    }
+    if (!last && (!startTime || !endTime)) {
+        console.error('Error: time range required. Use --last (e.g. --last 2h) or both --start-time and --end-time.');
+        process.exit(1);
+    }
+    return last ? { last } : { startTime, endTime };
+}
+/** 将 -q 表达式与便捷筛选 flag 合并为一个查询表达式（AND 连接）
+ *  字段值统一加双引号：含连字符等分词符的值（如 UUID）不加引号会匹配不到 */
+function buildQueryExpression(options) {
+    const parts = [];
+    if (options.query) {
+        parts.push(options.query);
+    }
+    if (options.app) {
+        parts.push(`appName:"${options.app}"`);
+    }
+    if (options.content) {
+        parts.push(`content:"${options.content}"`);
+    }
+    if (options.requestId) {
+        parts.push(`REQUEST_ID:"${options.requestId}"`);
+    }
+    return parts.length > 0 ? parts.join(' AND ') : undefined;
+}
+/** 解析输出格式，非法值回退 pretty */
+function resolveFormat(value) {
+    return ['json', 'table', 'pretty'].includes(value) ? value : 'pretty';
+}
+/** 统一错误处理：常见错误给出友好提示 */
+function handleCommandError(error) {
+    const msg = error.message || String(error);
+    if (msg.includes('Invalid URL')) {
+        console.error('Error: Invalid endpoint URL. Make sure it starts with https://');
+        console.error('  Example: https://lts.cn-south-1.myhuaweicloud.com');
+    }
+    else if (msg.includes('Authentication failed') || msg.includes('401') || msg.includes('403')) {
+        console.error('Error: Authentication failed. Please check your AK/SK credentials:');
+        console.error('  lts-cli config --list');
+    }
+    else if (msg.includes('ENOTFOUND') || msg.includes('ECONNREFUSED')) {
+        console.error('Error: Cannot reach the LTS service. Please check your endpoint and network connection.');
+    }
+    else if (msg.includes('Request failed after retries')) {
+        console.error('Error: The service is temporarily unavailable. Please try again later.');
+    }
+    else {
+        console.error('Error:', msg);
+    }
+    process.exit(1);
+}

package/dist/cli/commands/context.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextCommand = createContextCommand;
+const commander_1 = require("commander");
+const client_1 = require("../../lts/client");
+const output_1 = require("../../output");
+const common_1 = require("./common");
+function createContextCommand() {
+    const cmd = new commander_1.Command('context');
+    cmd.description('View logs before/after a specific log entry (like "View Context" in the console)')
+        .option('-g, --group-id <groupId>', 'Log group ID (can also be set via config)')
+        .option('-s, --stream-id <streamId>', 'Log stream ID (can also be set via config)')
+        .requiredOption('--line-num <lineNum>', 'line_num of the anchor log entry')
+        .requiredOption('--time <time>', 'Timestamp (ms) of the anchor log entry')
+        .option('--before <count>', 'Number of logs before the anchor', (v) => parseInt(v, 10), 20)
+        .option('--after <count>', 'Number of logs after the anchor', (v) => parseInt(v, 10), 20)
+        .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const format = (0, common_1.resolveFormat)(options.format);
+        const client = new client_1.LTSClient(config);
+        const params = {
+            groupId,
+            streamId,
+            lineNum: options.lineNum,
+            time: options.time,
+            before: options.before,
+            after: options.after,
+        };
+        try {
+            const result = await client.queryContext(params);
+            console.log((0, output_1.formatOutput)(result, format));
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/commands/init.js

@@ -67,7 +67,13 @@ const ENDPOINT_MAP = {
 function createInitCommand() {
     const cmd = new commander_1.Command('init');
     cmd.description('Interactive setup wizard — configure credentials step by step')
-        .action(async () => {
+        .option('--from-url <url>', 'Import region/groupId/streamId from an LTS console URL (non-interactive)')
+        .action(async (options) => {
+        // 从控制台 URL 导入：解析 region、groupId、topicId（即 streamId），无需交互
+        if (options.fromUrl) {
+            importFromConsoleUrl(options.fromUrl);
+            return;
+        }
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
@@ -154,3 +160,52 @@ function createInitCommand() {
     });
     return cmd;
 }
+/** 从华为云 LTS 控制台 URL 中解析 region / groupId / streamId 并写入配置 */
+function importFromConsoleUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        console.error('Error: Invalid URL. Please paste the full console URL, e.g.:');
+        console.error('  https://console.huaweicloud.com/lts/?region=cn-south-1#/cts/logEventsLeftMenu/events?groupId=...&topicId=...');
+        process.exit(1);
+    }
+    const region = url.searchParams.get('region') || undefined;
+    // groupId / topicId 位于 hash 段的查询参数中：#/cts/logEventsLeftMenu/events?groupId=...&topicId=...
+    const hash = url.hash || '';
+    const qIndex = hash.indexOf('?');
+    const hashParams = new URLSearchParams(qIndex >= 0 ? hash.slice(qIndex + 1) : '');
+    const groupId = hashParams.get('groupId') || url.searchParams.get('groupId') || undefined;
+    const streamId = hashParams.get('topicId') || hashParams.get('streamId') || url.searchParams.get('topicId') || undefined;
+    if (!region && !groupId && !streamId) {
+        console.error('Error: No region/groupId/topicId found in the URL. Make sure it is an LTS log search page URL.');
+        process.exit(1);
+    }
+    console.log('');
+    console.log('Importing from console URL:');
+    if (region) {
+        (0, config_1.setConfig)('region', region);
+        console.log(`  region   = ${region}`);
+        const autoEndpoint = ENDPOINT_MAP[region];
+        if (autoEndpoint) {
+            (0, config_1.setConfig)('endpoint', `https://${autoEndpoint}`);
+            console.log(`  endpoint = https://${autoEndpoint} (derived from region)`);
+        }
+    }
+    if (groupId) {
+        (0, config_1.setConfig)('groupId', groupId);
+        console.log(`  groupId  = ${groupId}`);
+    }
+    if (streamId) {
+        (0, config_1.setConfig)('streamId', streamId);
+        console.log(`  streamId = ${streamId}`);
+    }
+    console.log('');
+    console.log('✅ Configuration saved!');
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Configure credentials if not done yet: lts-cli init');
+    console.log('  2. Query logs: lts-cli query --last 2h --content "error"');
+    console.log('');
+}