@cvtoolman/huawei-lts-cli 1.0.2 → 1.0.3

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('');
+}

package/dist/cli/commands/query.js

@@ -3,87 +3,70 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createQueryCommand = createQueryCommand;
 const commander_1 = require("commander");
 const client_1 = require("../../lts/client");
-const config_1 = require("../../config");
 const output_1 = require("../../output");
+const common_1 = require("./common");
+// commander 的处理函数会收到 (value, previous)，直接传 parseInt 会把 previous 当作进制
+function parseIntOption(value) {
+    return parseInt(value, 10);
+}
 function createQueryCommand() {
     const cmd = new commander_1.Command('query');
     cmd.description('Query LTS logs')
         .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('--start-time <startTime>', 'Start time (ISO 8601, e.g. 2024-01-01T00:00:00Z)')
-        .requiredOption('--end-time <endTime>', 'End time (ISO 8601, e.g. 2024-01-02T00:00:00Z)')
+        .option('--start-time <startTime>', 'Start time (ISO 8601, e.g. 2024-01-01T00:00:00Z)')
+        .option('--end-time <endTime>', 'End time (ISO 8601, e.g. 2024-01-02T00:00:00Z)')
         .option('--st <startTime>', 'Alias for --start-time')
         .option('--et <endTime>', 'Alias for --end-time')
+        .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (mutually exclusive with --st/--et)')
         .option('-k, --keyword <keyword>', 'Simple keyword search (legacy, use --query for advanced queries)')
         .option('-q, --query <query>', 'Advanced query expression. Supports:\n' +
         '  - Field queries: content:error AND appName:myapp\n' +
         '  - Comparison: time>60 AND region:r\n' +
         '  - SQL syntax: SELECT * FROM log WHERE content LIKE \'%error%\'\n' +
         '  - Logical operators: AND, OR, NOT (must be surrounded by spaces)')
-        .option('-l, --limit <limit>', 'Limit number of results', parseInt, 100)
-        .option('-o, --offset <offset>', 'Offset for pagination', parseInt, 0)
+        .option('--app <appName>', 'Filter by appName field (e.g. --app acerp-gateway), merged with -q via AND')
+        .option('--content <keyword>', 'Filter by log content (content:<keyword>), merged with -q via AND')
+        .option('--request-id <id>', 'Filter by REQUEST_ID field; output in chronological order')
+        .option('-l, --limit <limit>', 'Limit number of results', parseIntOption, 100)
+        .option('-o, --offset <offset>', 'Offset for pagination', parseIntOption, 0)
         .option('-r, --reverse', 'Reverse order (newest first)')
         .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
-        .option('--no-paginate', 'Disable auto-pagination (single page only)')
+        .option('--all', 'Fetch all pages (up to 10000 logs; default is single page)')
+        .option('--no-paginate', '(deprecated) Single page is the default; kept for compatibility')
         .action(async (options) => {
-        const config = (0, config_1.loadConfig)();
-        // Validate required credentials
-        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);
-        }
-        // groupId & streamId: CLI args take priority over 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');
-            process.exit(1);
-        }
-        // --st / --et are aliases for --start-time / --end-time
-        const startTime = options.startTime || options.st;
-        const endTime = options.endTime || options.et;
-        if (!startTime || !endTime) {
-            console.error('Error: --start-time and --end-time are required.');
-            process.exit(1);
-        }
-        const format = ['json', 'table', 'pretty'].includes(options.format)
-            ? options.format
-            : 'pretty';
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const timeParams = (0, common_1.resolveTimeParams)(options);
+        const query = (0, common_1.buildQueryExpression)(options);
+        const format = (0, common_1.resolveFormat)(options.format);
+        // --request-id 用于链路定位，按时间正序输出
+        const reverse = options.requestId ? false : options.reverse;
         const client = new client_1.LTSClient(config);
         const params = {
             groupId,
             streamId,
-            startTime,
-            endTime,
+            ...timeParams,
             keyword: options.keyword,
-            query: options.query,
+            query,
             limit: options.limit,
             offset: options.offset,
-            reverse: options.reverse,
+            reverse,
         };
         try {
-            if (options.paginate) {
+            if (!options.all) {
+                // 默认单页查询，结果量由 --limit 控制
                 const result = await client.queryLogs(params);
                 console.log((0, output_1.formatOutput)(result, format));
             }
             else {
-                // Auto-pagination: fetch all logs
+                // --all：自动翻页拉取全部日志，上限 10000 条防止失控
+                const MAX_LOGS = 10000;
                 const allLogs = [];
                 let offset = options.offset || 0;
                 const limit = options.limit || 100;
                 let hasMore = true;
-                while (hasMore) {
+                while (hasMore && allLogs.length < MAX_LOGS) {
                     const pageParams = {
                         ...params,
                         offset,
@@ -106,26 +89,7 @@ function createQueryCommand() {
             }
         }
         catch (error) {
-            const msg = error.message || String(error);
-            // Friendlier error messages for common issues
-            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 querying logs:', msg);
-            }
-            process.exit(1);
+            (0, common_1.handleCommandError)(error);
         }
     });
     return cmd;

package/dist/cli/commands/streams.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGroupsCommand = createGroupsCommand;
+exports.createStreamsCommand = createStreamsCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../../lts/client");
+const common_1 = require("./common");
+function printGroups(groups, format) {
+    if (format === 'json') {
+        console.log(JSON.stringify(groups, null, 2));
+        return;
+    }
+    if (groups.length === 0) {
+        console.log(chalk_1.default.yellow('No log groups found.'));
+        return;
+    }
+    console.log(chalk_1.default.bold.green(`Found ${groups.length} log groups:`));
+    console.log('');
+    for (const g of groups) {
+        console.log(`  ${chalk_1.default.cyan(g.name)}  ${chalk_1.default.gray(g.id)}`);
+    }
+    console.log('');
+    console.log(chalk_1.default.gray('Set default: lts-cli config --set groupId=<id>'));
+}
+function printStreams(streams, format) {
+    if (format === 'json') {
+        console.log(JSON.stringify(streams, null, 2));
+        return;
+    }
+    if (streams.length === 0) {
+        console.log(chalk_1.default.yellow('No log streams found.'));
+        return;
+    }
+    console.log(chalk_1.default.bold.green(`Found ${streams.length} log streams:`));
+    console.log('');
+    for (const s of streams) {
+        const group = s.groupId ? chalk_1.default.gray(`  group: ${s.groupId}`) : '';
+        console.log(`  ${chalk_1.default.cyan(s.name)}  ${chalk_1.default.gray(s.id)}${group}`);
+    }
+    console.log('');
+    console.log(chalk_1.default.gray('Set default: lts-cli config --set streamId=<id>'));
+}
+function createGroupsCommand() {
+    const cmd = new commander_1.Command('groups');
+    cmd.description('List all LTS log groups (name + ID)')
+        .option('-f, --format <format>', 'Output format: json, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const client = new client_1.LTSClient(config);
+        try {
+            const groups = await client.listGroups();
+            printGroups(groups, options.format);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}
+function createStreamsCommand() {
+    const cmd = new commander_1.Command('streams');
+    cmd.description('List LTS log streams, optionally filtered by log group name')
+        .option('-g, --group <name>', 'Filter by log group NAME (e.g. acerp)')
+        .option('-f, --format <format>', 'Output format: json, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const client = new client_1.LTSClient(config);
+        try {
+            const streams = await client.listStreams(options.group);
+            printStreams(streams, options.format);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/commands/trace.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTraceCommand = createTraceCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../../lts/client");
+const output_1 = require("../../output");
+const common_1 = require("./common");
+function createTraceCommand() {
+    const cmd = new commander_1.Command('trace');
+    cmd.description('Trace a request by REQUEST_ID — fetch the full request chain in chronological order')
+        .argument('<requestId>', 'REQUEST_ID value to trace')
+        .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)')
+        .option('--field <name>', 'Field to match: REQUEST_ID (default), trace_id, or content (full-text fallback)', 'REQUEST_ID')
+        .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (default: 24h)')
+        .option('--start-time <startTime>', 'Start time (ISO 8601)')
+        .option('--end-time <endTime>', 'End time (ISO 8601)')
+        .option('--st <startTime>', 'Alias for --start-time')
+        .option('--et <endTime>', 'Alias for --end-time')
+        .option('-l, --limit <limit>', 'Max number of logs to fetch', (v) => parseInt(v, 10), 200)
+        .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
+        .action(async (requestId, options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const timeParams = (0, common_1.resolveTimeParams)(options, '24h');
+        const format = (0, common_1.resolveFormat)(options.format);
+        const field = options.field;
+        // 值加双引号：含连字符的 UUID 不加引号会被分词导致匹配不到
+        const query = `${field}:"${requestId}"`;
+        const client = new client_1.LTSClient(config);
+        const params = {
+            groupId,
+            streamId,
+            ...timeParams,
+            query,
+            reverse: false, // 链路按时间正序
+        };
+        try {
+            // Auto-pagination up to --limit
+            const pageSize = Math.min(options.limit || 200, 500);
+            const maxTotal = options.limit || 200;
+            const allLogs = [];
+            let offset = 0;
+            let hasMore = true;
+            while (hasMore && allLogs.length < maxTotal) {
+                const result = await client.queryLogs({ ...params, offset, limit: pageSize });
+                allLogs.push(...result.logs);
+                if (result.logs.length < pageSize) {
+                    hasMore = false;
+                }
+                else {
+                    offset += pageSize;
+                }
+            }
+            const result = { logs: allLogs.slice(0, maxTotal), total: allLogs.length };
+            let output = (0, output_1.formatOutput)(result, format);
+            // pretty 格式下高亮 requestId，便于肉眼定位
+            if (format === 'pretty' && result.logs.length > 0) {
+                output = output.split(requestId).join(chalk_1.default.yellow.bold(requestId));
+            }
+            console.log(output);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/index.js

@@ -3,6 +3,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const query_1 = require("./commands/query");
+const trace_1 = require("./commands/trace");
+const context_1 = require("./commands/context");
+const streams_1 = require("./commands/streams");
 const config_1 = require("./commands/config");
 const init_1 = require("./commands/init");
 const program = new commander_1.Command();
@@ -13,8 +16,12 @@ program
     .addHelpText('after', `
 Examples:
   $ lts-cli init                     Setup credentials interactively
+  $ lts-cli init --from-url <url>    Import region/groupId/streamId from a console URL
   $ lts-cli config --list            Show current configuration
-  $ lts-cli query --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
+  $ lts-cli query --last 2h --app acerp-gateway --content "error"
+  $ lts-cli trace <requestId>        Fetch full request chain by REQUEST_ID
+  $ lts-cli groups                   List log groups
+  $ lts-cli streams                  List log streams
 
 Environment variables:
   LTS_AK           Access Key
@@ -27,6 +34,10 @@ Environment variables:
 `);
 program.addCommand((0, init_1.createInitCommand)());
 program.addCommand((0, query_1.createQueryCommand)());
+program.addCommand((0, trace_1.createTraceCommand)());
+program.addCommand((0, context_1.createContextCommand)());
+program.addCommand((0, streams_1.createGroupsCommand)());
+program.addCommand((0, streams_1.createStreamsCommand)());
 program.addCommand((0, config_1.createConfigCommand)());
 // Shell completion support
 const completionCmd = new commander_1.Command('completion')
@@ -42,7 +53,7 @@ _lts_cli_completion() {
   local cur="\${words[cword]}"
 
   if (( cword == 1 )); then
-    COMPREPLY=( $(compgen -W "query config init completion" -- "\$cur") )
+    COMPREPLY=( $(compgen -W "query trace context groups streams config init completion" -- "\$cur") )
     return
   fi
 
@@ -83,6 +94,10 @@ _lts_cli() {
   local -a commands
   commands=(
     'query:Query LTS logs'
+    'trace:Trace request chain by REQUEST_ID'
+    'context:View logs before/after a log entry'
+    'groups:List log groups'
+    'streams:List log streams'
     'config:Manage configuration'
     'init:Interactive setup wizard'
     'completion:Generate shell completion script'
@@ -137,7 +152,7 @@ compdef _lts_cli lts-cli`);
 Register-ArgumentCompleter -CommandName lts-cli -ScriptBlock {
   param(\$wordToComplete, \$commandAst, \$cursorPosition)
 
-  \$commands = @('query', 'config', 'init', 'completion')
+  \$commands = @('query', 'trace', 'context', 'groups', 'streams', 'config', 'init', 'completion')
 
   \$args = \$commandAst.ToString() -split '\\s+'
   if (\$args.Count -le 1) {

package/dist/lts/client.js

@@ -1,15 +1,74 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LTSClient = void 0;
+exports.resolveTimeRange = resolveTimeRange;
 const LtsClient_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/LtsClient");
 const ClientBuilder_1 = require("@huaweicloud/huaweicloud-sdk-core/ClientBuilder");
 const BasicCredentials_1 = require("@huaweicloud/huaweicloud-sdk-core/auth/BasicCredentials");
 const region_1 = require("@huaweicloud/huaweicloud-sdk-core/region/region");
 const ListLogsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogsRequest");
 const QueryLtsLogParams_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/QueryLtsLogParams");
+const ListLogContextRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogContextRequest");
+const ListLogContextRequestBody_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogContextRequestBody");
+const ListLogGroupsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogGroupsRequest");
+const ListLogStreamsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogStreamsRequest");
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+const DURATION_REGEX = /^(\d+)([mhd])$/;
+const DURATION_UNIT_MS = {
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+};
+/** 解析相对时间范围（如 30m/2h/1d），返回 [startMs, endMs] */
+function resolveTimeRange(params) {
+    if (params.last) {
+        const match = DURATION_REGEX.exec(params.last.trim());
+        if (!match) {
+            throw new Error(`Invalid --last duration: "${params.last}". Expected format like 30m, 2h, 1d, 7d.`);
+        }
+        const amount = parseInt(match[1], 10);
+        const endMs = Date.now();
+        return { startMs: endMs - amount * DURATION_UNIT_MS[match[2]], endMs };
+    }
+    if (!params.startTime || !params.endTime) {
+        throw new Error('Time range required: provide --last (e.g. --last 2h) or both --start-time and --end-time.');
+    }
+    const startMs = new Date(params.startTime).getTime();
+    const endMs = new Date(params.endTime).getTime();
+    if (Number.isNaN(startMs) || Number.isNaN(endMs)) {
+        throw new Error(`Invalid time format. Use ISO 8601 (e.g. 2024-01-01T00:00:00Z).`);
+    }
+    return { startMs, endMs };
+}
+/**
+ * 解析查询表达式（对齐控制台管道语法）：
+ * - "搜索语句 | SELECT ..." → keywords=搜索语句, query=SQL, is_analysis_query=true
+ * - 裸 "SELECT ..."         → query=SQL, is_analysis_query=true
+ * - 其他（field:value 等）  → keywords=搜索语句
+ */
+function parseQueryExpression(expr) {
+    const trimmed = expr.trim();
+    if (trimmed.includes('|')) {
+        const idx = trimmed.indexOf('|');
+        const searchPart = trimmed.slice(0, idx).trim();
+        const sqlPart = trimmed.slice(idx + 1).trim();
+        return {
+            keywords: searchPart && searchPart !== '*' ? searchPart : undefined,
+            query: sqlPart || undefined,
+            isAnalysisQuery: sqlPart.length > 0,
+        };
+    }
+    if (/^select\s/i.test(trimmed)) {
+        return { query: trimmed, isAnalysisQuery: true };
+    }
+    return { keywords: trimmed, isAnalysisQuery: false };
+}
+/** 服务端默认在命中词上包裹 <HighLightTag>，输出前剥离 */
+function stripHighlightTags(value) {
+    return value.replace(/<\/?HighLightTag>/g, '');
+}
 class LTSClient {
     client;
     config;
@@ -30,13 +89,23 @@ class LTSClient {
         this.client = builder.build();
     }
     async queryLogs(params) {
+        const { startMs, endMs } = resolveTimeRange(params);
         const queryParams = new QueryLtsLogParams_1.QueryLtsLogParams()
-            .withStartTime(new Date(params.startTime).getTime().toString())
-            .withEndTime(new Date(params.endTime).getTime().toString())
-            .withLimit(params.limit ?? 100);
+            .withStartTime(startMs.toString())
+            .withEndTime(endMs.toString())
+            .withLimit(Number.isFinite(params.limit) ? params.limit : 100);
         // 优先使用 query 参数（支持SQL和结构化查询）
         if (params.query) {
-            queryParams.withQuery(params.query);
+            const parsed = parseQueryExpression(params.query);
+            if (parsed.keywords) {
+                queryParams.withKeywords(parsed.keywords);
+            }
+            if (parsed.query) {
+                queryParams.withQuery(parsed.query);
+            }
+            if (parsed.isAnalysisQuery) {
+                queryParams.withIsAnalysisQuery(true);
+            }
         }
         else if (params.keyword) {
             // 向后兼容：简单关键词搜索
@@ -48,16 +117,73 @@ class LTSClient {
         const request = new ListLogsRequest_1.ListLogsRequest(params.groupId, params.streamId, 'application/json')
             .withBody(queryParams);
         const response = await this.retryRequest(() => this.client.listLogs(request));
+        const raw = response;
+        // SQL 分析查询：结果在 analysisLogs 中（行为 JSON 对象）
+        if (Array.isArray(raw.analysisLogs)) {
+            const logs = raw.analysisLogs.map((row) => ({
+                logTime: '',
+                content: JSON.stringify(row),
+                labels: {},
+            }));
+            return { logs, total: logs.length };
+        }
+        const logs = (response.logs || []).map((log) => ({
+            logTime: log.line_num ?? log.lineNum ?? '',
+            content: stripHighlightTags(log.content ?? ''),
+            labels: Object.fromEntries(Object.entries(log.labels ?? {}).map(([k, v]) => [k, stripHighlightTags(v)])),
+        }));
+        return {
+            logs,
+            total: response.count ?? logs.length,
+        };
+    }
+    /** 查询某条日志的上下文（前后各 N 行），对应控制台的“查看上下文” */
+    async queryContext(params) {
+        const body = new ListLogContextRequestBody_1.ListLogContextRequestBody()
+            .withLineNum(params.lineNum)
+            .withTime(params.time)
+            .withBackwardsSize(params.before ?? 20)
+            .withForwardsSize(params.after ?? 20);
+        const request = new ListLogContextRequest_1.ListLogContextRequest(params.groupId, params.streamId, 'application/json')
+            .withBody(body);
+        const response = await this.retryRequest(() => this.client.listLogContext(request));
         const logs = (response.logs || []).map((log) => ({
-            logTime: log.lineNum ?? '',
+            logTime: log.line_num ?? log.lineNum ?? '',
             content: log.content ?? '',
             labels: log.labels ?? {},
         }));
         return {
             logs,
-            total: response.count ?? logs.length,
+            // SDK 实际返回纯对象，字段为 snake_case
+            total: response.total_count ?? response.totalCount ?? logs.length,
         };
     }
+    /** 列出全部日志组 */
+    async listGroups() {
+        const request = new ListLogGroupsRequest_1.ListLogGroupsRequest();
+        const response = await this.retryRequest(() => this.client.listLogGroups(request));
+        // SDK 实际返回纯对象，字段为 snake_case（log_groups）
+        const groups = (response.log_groups ?? []);
+        return groups.map((g) => ({
+            id: g.log_group_id ?? '',
+            name: g.log_group_name ?? '',
+        }));
+    }
+    /** 列出日志流，可按日志组名称过滤（API 使用组名而非组 ID） */
+    async listStreams(groupName) {
+        const request = new ListLogStreamsRequest_1.ListLogStreamsRequest('application/json');
+        if (groupName) {
+            request.withLogGroupName(groupName);
+        }
+        const response = await this.retryRequest(() => this.client.listLogStreams(request));
+        // SDK 实际返回纯对象，字段为 snake_case（log_streams）
+        const streams = (response.log_streams ?? []);
+        return streams.map((s) => ({
+            id: s.log_stream_id ?? '',
+            name: s.log_stream_name ?? '',
+            groupId: s.log_group_id,
+        }));
+    }
     async retryRequest(fn, maxRetries = 3) {
         let lastError;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cvtoolman/huawei-lts-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Command-line tool for querying Huawei Cloud Log Tank Service (LTS) logs",
   "main": "dist/cli/index.js",
   "bin": {