@meet-im/lxcli 0.0.3 → 0.0.5

package/dist/commands/generate-skills.js

@@ -4,6 +4,7 @@ import * as path from 'path';
 import { outputCliError } from '../core/error.js';
 import { logger } from '../core/logger.js';
 import { PARAM_DEFS, METHOD_DESCRIPTIONS } from './services/kb/descriptions.js';
+import { METHOD_SKILL_METADATA } from './services/kb/skill-metadata.js';
 const API_ROOT = path.resolve('api');
 const DEFAULT_SKILLS_DIR = path.resolve('api/skills');
 const DEFAULT_OUTPUT = 'api/docs/skills.md';
@@ -157,6 +158,7 @@ async function readPackageVersion() {
 function renderSkillMd(method, version) {
     const description = METHOD_DESCRIPTIONS[method];
     const params = PARAM_DEFS[method] || [];
+    const metadata = METHOD_SKILL_METADATA[method];
     const skillName = `lxcli-kb-${method}`;
     const hasParams = params.length > 0;
     // 快捷参数列表
@@ -223,6 +225,9 @@ metadata:
         lines.push(renderParamsTable(params));
     }
     lines.push('## Examples', '', '```bash', shortcutUsage || `lxcli kb ${method}`, '```', '');
+    if (metadata?.notes?.length) {
+        lines.push('## Notes', '', ...metadata.notes.map((note) => `- ${note}`), '');
+    }
     return lines.join('\n');
 }
 async function generateServiceSkills(skillsDir, serviceName) {

package/dist/commands/services/kb/config.js

@@ -2,25 +2,25 @@
 // kanboard gateway 配置（按企业、按环境）
 // 实际地址需要根据部署环境配置
 const meetGateways = {
-    test: 'https://kanboard-test.miyachat.com',
+    test: 'https://kanboard-staging.miyachat.com',
     pre: 'https://kanboard-pre.miyachat.com',
     staging: 'https://kanboard-staging.miyachat.com',
-    beta: 'https://kanboard-beta.miyachat.com',
+    beta: 'https://kanboard-staging.miyachat.com',
     prod: 'https://kanboard.miyachat.com',
 };
 const coGateways = {
-    test: 'https://kanboard-test.co.example.com',
-    pre: 'https://kanboard-pre.co.example.com',
-    staging: 'https://kanboard-staging.co.example.com',
-    beta: 'https://kanboard-beta.co.example.com',
-    prod: 'https://kanboard.co.example.com',
+    test: 'https://kanboard.mecord668.com',
+    pre: 'https://kanboard.mecord668.com',
+    staging: 'https://kanboard.mecord668.com',
+    beta: 'https://kanboard.mecord668.com',
+    prod: 'https://kanboard.mecord668.com',
 };
 const skyGateways = {
-    test: 'https://kanboard-test.sky.example.com',
-    pre: 'https://kanboard-pre.sky.example.com',
-    staging: 'https://kanboard-staging.sky.example.com',
-    beta: 'https://kanboard-beta.sky.example.com',
-    prod: 'https://kanboard.sky.example.com',
+    test: 'https://kanboard.2tianxin.com',
+    pre: 'https://kanboard.2tianxin.com',
+    staging: 'https://kanboard.2tianxin.com',
+    beta: 'https://kanboard.2tianxin.com',
+    prod: 'https://kanboard.2tianxin.com',
 };
 export const kbConfig = {
     name: 'kb',

package/dist/commands/services/kb/descriptions.js

@@ -20,7 +20,9 @@ export const METHOD_DESCRIPTIONS = {
     getAllComments: '获取评论列表',
     createComment: '对需求增加评论',
     createProjectFile: '上传附件到项目',
+    downloadProjectFile: '下载项目附件',
     createTaskFile: '上传附件到需求',
+    downloadTaskFile: '下载需求附件',
 };
 // 重新导出 params.ts 的类型和定义，方便其他模块使用
 export { PARAM_DEFS } from './params.js';

package/dist/commands/services/kb/handler.d.ts

@@ -4,9 +4,15 @@ export interface KbCommandOptions {
     task_id?: string;
     title?: string;
     project_id?: string;
+    file_id?: string;
+    owner_id?: string;
+    category_id?: string;
     query?: string;
+    user_id?: string;
+    content?: string;
     user?: string;
     gateway?: string;
     file?: string;
+    out?: string;
 }
 export declare function createKbAction(method: Method): (options: KbCommandOptions) => Promise<void>;

package/dist/commands/services/kb/handler.js

@@ -1,4 +1,4 @@
-import { readFile } from 'fs/promises';
+import { readFile, writeFile } from 'fs/promises';
 import { basename } from 'path';
 import { getCurrentUser, getGatewayForUser } from '../../../core/auth.js';
 import { outputCliError } from '../../../core/error.js';
@@ -87,13 +87,15 @@ export function createKbAction(method) {
             }
             params = { task_id: taskId };
         }
-        else if (method === 'createTask' && options.title && options.project_id) {
+        else if (method === 'createTask' && options.title && options.project_id && options.owner_id && options.category_id) {
             const projectId = parseTaskId(options.project_id);
-            if (projectId === null) {
-                outputCliError('PARAM_INVALID', '--project_id must be a positive integer');
+            const ownerId = parseTaskId(options.owner_id);
+            const categoryId = parseTaskId(options.category_id);
+            if (projectId === null || ownerId === null || categoryId === null) {
+                outputCliError('PARAM_INVALID', '--project_id, --owner_id and --category_id must be positive integers');
                 return;
             }
-            params = { title: options.title, project_id: projectId };
+            params = { title: options.title, project_id: projectId, owner_id: ownerId, category_id: categoryId };
         }
         else if (method === 'searchTasks' && options.project_id && options.query) {
             const projectId = parseTaskId(options.project_id);
@@ -127,6 +129,24 @@ export function createKbAction(method) {
             }
             params = { task_id: taskId };
         }
+        else if (method === 'createComment' && options.task_id && options.user_id && options.content) {
+            const taskId = parseTaskId(options.task_id);
+            const userId = options.user_id === '0' ? 0 : parseTaskId(options.user_id);
+            if (taskId === null || userId === null) {
+                outputCliError('PARAM_INVALID', '--task_id and --user_id must be non-negative integers');
+                return;
+            }
+            params = { task_id: taskId, user_id: userId, content: options.content };
+        }
+        else if (method === 'downloadProjectFile' && options.project_id && options.file_id) {
+            const projectId = parseTaskId(options.project_id);
+            const fileId = parseTaskId(options.file_id);
+            if (projectId === null || fileId === null) {
+                outputCliError('PARAM_INVALID', '--project_id and --file_id must be positive integers');
+                return;
+            }
+            params = { project_id: projectId, file_id: fileId };
+        }
         else if (method === 'createProjectFile' && options.file && options.project_id) {
             const projectId = parseTaskId(options.project_id);
             if (projectId === null) {
@@ -144,6 +164,14 @@ export function createKbAction(method) {
                 return;
             }
         }
+        else if (method === 'downloadTaskFile' && options.file_id) {
+            const fileId = parseTaskId(options.file_id);
+            if (fileId === null) {
+                outputCliError('PARAM_INVALID', '--file_id must be a positive integer');
+                return;
+            }
+            params = { file_id: fileId };
+        }
         else if (method === 'createTaskFile' && options.file && options.task_id && options.project_id) {
             const taskId = parseTaskId(options.task_id);
             const projectId = parseTaskId(options.project_id);
@@ -169,12 +197,15 @@ export function createKbAction(method) {
         else {
             const shortcuts = {
                 getTask: '--task_id',
-                createTask: '--title and --project_id',
+                createTask: '--title, --project_id, --owner_id and --category_id',
                 searchTasks: '--project_id and --query',
                 getAllActiveIterations: '--project_id',
                 getAllCategories: '--project_id',
                 getAllComments: '--task_id',
+                createComment: '--task_id, --user_id and --content',
+                downloadProjectFile: '--project_id and --file_id',
                 createProjectFile: '--file and --project_id',
+                downloadTaskFile: '--file_id',
                 createTaskFile: '--file, --task_id and --project_id',
             };
             outputCliError('PARAM_INVALID', shortcuts[method]
@@ -183,6 +214,21 @@ export function createKbAction(method) {
             return;
         }
         const result = await jsonRpcCall(gateway, method, params, user.token);
+        if ((method === 'downloadProjectFile' || method === 'downloadTaskFile') && options.out) {
+            if (typeof result !== 'string') {
+                outputCliError('PARAM_INVALID', `${method} result must be a Base64 string`);
+                return;
+            }
+            try {
+                const buffer = Buffer.from(result, 'base64');
+                await writeFile(options.out, buffer);
+                outputJson({ success: true, path: options.out, bytes: buffer.length });
+            }
+            catch (error) {
+                outputCliError('PARAM_INVALID', `Failed to write file: ${options.out}`);
+            }
+            return;
+        }
         outputJson(result);
     };
 }

package/dist/commands/services/kb/index.js

@@ -38,13 +38,15 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('getTask'));
-        // createTask 支持快捷参数 --title / --project_id，且 --params 仍然可用
+        // createTask 支持快捷参数 --title / --project_id / --owner_id / --category_id，且 --params 仍然可用
         cmd
             .command('createTask')
             .description(METHOD_DESCRIPTIONS.createTask)
             .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
             .option('--title <title>', 'Task title (shortcut)')
             .option('--project_id <id>', 'Project ID (shortcut)')
+            .option('--owner_id <id>', 'Owner user ID (shortcut)')
+            .option('--category_id <id>', 'Category ID (shortcut)')
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createTask'));
@@ -85,6 +87,17 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('getAllComments'));
+        // createComment 支持快捷参数 --task_id / --user_id / --content
+        cmd
+            .command('createComment')
+            .description(METHOD_DESCRIPTIONS.createComment)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--task_id <id>', 'Task ID (shortcut)')
+            .option('--user_id <id>', 'Comment author user ID (shortcut)')
+            .option('--content <content>', 'Comment content (shortcut)')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('createComment'));
         for (const method of METHODS.filter((item) => item !== 'getMe' &&
             item !== 'getMyProjects' &&
             item !== 'getTask' &&
@@ -93,7 +106,10 @@ const kbService = {
             item !== 'getAllActiveIterations' &&
             item !== 'getAllCategories' &&
             item !== 'getAllComments' &&
+            item !== 'createComment' &&
+            item !== 'downloadProjectFile' &&
             item !== 'createTaskFile' &&
+            item !== 'downloadTaskFile' &&
             item !== 'createProjectFile')) {
             cmd
                 .command(method)
@@ -113,6 +129,17 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createProjectFile'));
+        // downloadProjectFile 支持快捷参数 --project_id / --file_id，可选 --out 落盘
+        cmd
+            .command('downloadProjectFile')
+            .description(METHOD_DESCRIPTIONS.downloadProjectFile)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--project_id <id>', 'Project ID (shortcut)')
+            .option('--file_id <id>', 'Project file ID (shortcut)')
+            .option('--out <path>', 'Write decoded file to path')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('downloadProjectFile'));
         // createTaskFile 支持快捷参数 --file / --task_id / --project_id，自动转 base64
         cmd
             .command('createTaskFile')
@@ -124,6 +151,16 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createTaskFile'));
+        // downloadTaskFile 支持快捷参数 --file_id，可选 --out 落盘
+        cmd
+            .command('downloadTaskFile')
+            .description(METHOD_DESCRIPTIONS.downloadTaskFile)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--file_id <id>', 'Task file ID (shortcut)')
+            .option('--out <path>', 'Write decoded file to path')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('downloadTaskFile'));
     },
 };
 export default kbService;

package/dist/commands/services/kb/params.js

@@ -77,10 +77,17 @@ export const PARAM_DEFS = {
         { name: 'filename', type: 'string', required: true, description: '文件名' },
         { name: 'blob', type: 'string', required: true, description: '文件内容 Base64 编码' },
     ],
+    downloadProjectFile: [
+        { name: 'project_id', type: 'integer', required: true, description: '项目 ID' },
+        { name: 'file_id', type: 'integer', required: true, description: '项目附件 ID' },
+    ],
     createTaskFile: [
         { name: 'project_id', type: 'integer', required: true, description: '项目 ID' },
         { name: 'task_id', type: 'integer', required: true, description: '需求/bug ID' },
         { name: 'filename', type: 'string', required: true, description: '文件名' },
         { name: 'blob', type: 'string', required: true, description: '文件内容 Base64 编码' },
     ],
+    downloadTaskFile: [
+        { name: 'file_id', type: 'integer', required: true, description: '需求附件 ID' },
+    ],
 };

package/dist/commands/services/kb/rpc.js

@@ -2,13 +2,14 @@ import { outputCliError } from '../../../core/error.js';
 import { request } from '../../../core/http.js';
 import { getNextRequestId } from './utils.js';
 export async function jsonRpcCall(gateway, method, params, pat) {
+    const requestId = getNextRequestId();
     const requestBody = {
         jsonrpc: '2.0',
         method,
-        id: getNextRequestId(),
+        id: requestId,
         params,
     };
-    const response = await request({
+    const result = await request({
         gateway,
         path: '/jsonrpc.php',
         method: 'POST',
@@ -16,11 +17,26 @@ export async function jsonRpcCall(gateway, method, params, pat) {
         headers: {
             Authorization: `meet ${pat}`,
         },
+        throwOnError: false,
     });
+    // HTTP 层错误
+    if (result.error) {
+        outputCliError('NETWORK_ERROR', result.error.message, {
+            code: result.error.code,
+            details: result.error.details,
+            requestId,
+        });
+        return undefined;
+    }
+    const response = result.data;
+    // JSON-RPC 层错误
     if (response.error) {
         outputCliError('NETWORK_ERROR', response.error.message, {
             code: response.error.code,
             data: response.error.data,
+            requestId,
+            // 服务端返回的 id（可能为 null）
+            responseId: response.id,
         });
         return undefined;
     }
@@ -28,6 +44,7 @@ export async function jsonRpcCall(gateway, method, params, pat) {
         outputCliError('NETWORK_ERROR', 'No result returned from Kanboard API', {
             method,
             params,
+            requestId,
         });
         return undefined;
     }

package/dist/commands/services/kb/skill-metadata.d.ts

@@ -0,0 +1,5 @@
+import type { Method } from './descriptions.js';
+export interface MethodSkillMetadata {
+    notes?: string[];
+}
+export declare const METHOD_SKILL_METADATA: Partial<Record<Method, MethodSkillMetadata>>;

package/dist/commands/services/kb/skill-metadata.js

@@ -0,0 +1,15 @@
+export const METHOD_SKILL_METADATA = {
+    downloadProjectFile: {
+        notes: [
+            '当附件链接包含 `project_id` 时，使用 `downloadProjectFile`。',
+            '例如：`/FileViewer/browser?project_id=4&file_id=168`。',
+            '例如：`/?controller=FileViewerController&action=browser&project_id=4&file_id=168`。',
+        ],
+    },
+    downloadTaskFile: {
+        notes: [
+            '当附件链接包含 `task_id` 时，使用 `downloadTaskFile`。',
+            '例如：`?controller=FileViewerController&action=browser&task_id=2000757&file_id=3870`。',
+        ],
+    },
+};

package/dist/commands/services/kb/types.d.ts

@@ -33,6 +33,7 @@ export interface KanboardTask {
     date_due?: string;
     date_started?: string;
     priority: string;
+    priority_name?: string;
     score: string;
     reference: string;
     url: string;
@@ -43,6 +44,17 @@ export interface KanboardTask {
     };
     tags?: string[];
 }
+export interface KanboardSubtask {
+    id: string;
+    title: string;
+    status: string;
+    status_name?: string;
+    time_estimated: string;
+    time_spent: string;
+    task_id: string;
+    user_id: string;
+    position: string;
+}
 export interface GetTaskParams {
     task_id: number;
 }

package/dist/commands/upgrade.d.ts

@@ -1,2 +1,6 @@
 import { Command } from 'commander';
+import { spawn } from 'child_process';
+export declare const upgradeDeps: {
+    spawn: typeof spawn;
+};
 export declare function registerUpgradeCommand(program: Command): void;

package/dist/commands/upgrade.js

@@ -1,8 +1,12 @@
 // src/commands/upgrade.ts
+import { spawn } from 'child_process';
 import { outputCliError } from '../core/error.js';
 import { outputJson } from '../utils/index.js';
 const PACKAGE_NAME = '@meet-im/lxcli';
 const NPM_REGISTRY = 'https://registry.npmjs.org';
+export const upgradeDeps = {
+    spawn,
+};
 async function getLatestVersion() {
     const res = await fetch(`${NPM_REGISTRY}/${PACKAGE_NAME}/latest`);
     if (!res.ok) {
@@ -11,22 +15,52 @@ async function getLatestVersion() {
     const data = await res.json();
     return data.version;
 }
+async function runNpmUpgrade() {
+    const command = process.platform === 'win32' ? 'cmd.exe' : 'npm';
+    const args = process.platform === 'win32'
+        ? ['/c', 'npm', 'install', '-g', `${PACKAGE_NAME}@latest`]
+        : ['install', '-g', `${PACKAGE_NAME}@latest`];
+    await new Promise((resolve, reject) => {
+        const child = upgradeDeps.spawn(command, args, {
+            stdio: 'inherit',
+        });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`npm install exited with code ${code ?? 'unknown'}`));
+        });
+    });
+}
 export function registerUpgradeCommand(program) {
     program
         .command('upgrade')
         .description('Check for updates and show upgrade instructions')
-        .action(async () => {
+        .option('--check', 'Only check for updates without installing')
+        .action(async (options) => {
         try {
             const currentVersion = program.version() || '1.0.0';
             const latestVersion = await getLatestVersion();
             const isLatest = currentVersion === latestVersion;
+            if (options.check || isLatest) {
+                outputJson({
+                    currentVersion,
+                    latestVersion,
+                    isLatest,
+                    message: isLatest
+                        ? 'Already on the latest version'
+                        : `Run "npm install -g ${PACKAGE_NAME}@latest" to upgrade`,
+                });
+                return;
+            }
+            await runNpmUpgrade();
             outputJson({
-                currentVersion,
+                previousVersion: currentVersion,
                 latestVersion,
-                isLatest,
-                message: isLatest
-                    ? 'Already on the latest version'
-                    : `Run "npm install -g ${PACKAGE_NAME}@latest" to upgrade`,
+                upgraded: true,
+                message: `Upgraded ${PACKAGE_NAME} to ${latestVersion}`,
             });
         }
         catch (error) {

package/dist/core/http.d.ts

@@ -1,4 +1,16 @@
-export interface RequestOptions {
+export interface RequestResult<T> {
+    /** HTTP 状态码 */
+    status: number;
+    /** 响应数据（成功时） */
+    data?: T;
+    /** 错误信息（失败时） */
+    error?: {
+        code: number;
+        message: string;
+        details?: unknown;
+    };
+}
+export interface RequestOptionsWithThrow {
     /** gateway 地址（必填） */
     gateway: string;
     /** 请求路径（不含域名） */
@@ -15,7 +27,30 @@ export interface RequestOptions {
     userAgent?: string;
     /** 最大重试次数，默认 3 */
     maxRetries?: number;
+    /** 错误时抛出异常而非直接退出，默认 true */
+    throwOnError?: true;
 }
+export interface RequestOptionsWithoutThrow {
+    /** gateway 地址（必填） */
+    gateway: string;
+    /** 请求路径（不含域名） */
+    path: string;
+    /** HTTP 方法，默认 GET */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** URL query 参数 */
+    query?: Record<string, string | number | boolean>;
+    /** 请求体 */
+    body?: Record<string, unknown>;
+    /** 自定义 headers（会覆盖默认 headers） */
+    headers?: Record<string, string>;
+    /** User-Agent，默认 lxcli/版本号 */
+    userAgent?: string;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 错误时返回 RequestResult 而非退出 */
+    throwOnError: false;
+}
+export type RequestOptions = RequestOptionsWithThrow | RequestOptionsWithoutThrow;
 /**
  * 通用请求函数
  *
@@ -24,5 +59,8 @@ export interface RequestOptions {
  * 支持自动重试：
  * - 429 (rate limit) 响应时重试，尊重 Retry-After header
  * - 网络错误时重试，使用指数退避
+ *
+ * 当 throwOnError 为 false 时，返回 RequestResult<T> 而非直接退出。
  */
-export declare function request<T>(options: RequestOptions): Promise<T>;
+export declare function request<T>(options: RequestOptionsWithThrow): Promise<T>;
+export declare function request<T>(options: RequestOptionsWithoutThrow): Promise<RequestResult<T>>;

package/dist/core/http.js

@@ -40,17 +40,8 @@ function joinUrl(gateway, path) {
     const normalizedPath = path.startsWith('/') ? path : `/${path}`;
     return `${normalizedGateway}${normalizedPath}`;
 }
-/**
- * 通用请求函数
- *
- * 支持灵活传递 gateway、路径、方法、参数、UA 等。
- *
- * 支持自动重试：
- * - 429 (rate limit) 响应时重试，尊重 Retry-After header
- * - 网络错误时重试，使用指数退避
- */
 export async function request(options) {
-    const { gateway, path, method = 'GET', query, body, headers = {}, userAgent = `lxcli/${pkg.version}`, maxRetries = MAX_RETRIES, } = options;
+    const { gateway, path, method = 'GET', query, body, headers = {}, userAgent = `lxcli/${pkg.version}`, maxRetries = MAX_RETRIES, throwOnError = true, } = options;
     // 构建 URL（gateway + path + query）
     let url = joinUrl(gateway, path);
     if (query && Object.keys(query).length > 0) {
@@ -65,6 +56,13 @@ export async function request(options) {
     };
     const requestBody = body ? JSON.stringify(body) : undefined;
     let lastError = null;
+    // 辅助函数：处理错误响应
+    const makeErrorResult = (status, code, message, details) => {
+        if (throwOnError) {
+            outputApiError(code, message, details, status);
+        }
+        return { status, error: { code, message, details } };
+    };
     // 发送请求（带重试）
     for (let attempt = 0; attempt < maxRetries; attempt++) {
         try {
@@ -94,19 +92,32 @@ export async function request(options) {
                     await sleep(delay);
                     continue;
                 }
-                outputApiError(errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details, response.status);
+                const result = makeErrorResult(response.status, errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details);
+                if (!throwOnError)
+                    return result;
+                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
             }
             let responseData;
             try {
                 responseData = parseJsonResponse(responseText);
             }
             catch {
-                outputApiError(response.status, `Invalid JSON response: ${responseText}`, undefined, response.status);
+                const result = makeErrorResult(response.status, response.status, `Invalid JSON response: ${responseText}`);
+                if (!throwOnError)
+                    return result;
+                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
             }
             logger.debug('Response', { status: response.status, data: responseData, attempt });
             if (!response.ok) {
                 const errorResponse = responseData;
-                outputApiError(errorResponse.error?.code || response.status, errorResponse.error?.message || 'Request failed', errorResponse.error?.details, response.status);
+                const result = makeErrorResult(response.status, errorResponse?.error?.code || response.status, errorResponse?.error?.message || 'Request failed', errorResponse?.error?.details);
+                if (!throwOnError)
+                    return result;
+                // throwOnError 为 true 时 makeErrorResult 已经调用 outputApiError 退出了
+            }
+            // throwOnError 为 false 时返回完整结果
+            if (!throwOnError) {
+                return { status: response.status, data: responseData };
             }
             return responseData;
         }
@@ -125,7 +136,9 @@ export async function request(options) {
             }
             if (isNetworkError) {
                 logger.error('Request failed', error);
-                outputApiError(500, error.message, undefined, 500);
+                const result = makeErrorResult(500, 500, error.message);
+                if (!throwOnError)
+                    return result;
             }
             throw error;
         }
@@ -133,7 +146,9 @@ export async function request(options) {
     // 所有重试都失败了
     if (lastError) {
         logger.error('All retries failed', lastError);
-        outputApiError(500, lastError.message, undefined, 500);
+        const result = makeErrorResult(500, 500, lastError.message);
+        if (!throwOnError)
+            return result;
     }
     // 不应该到达这里，但 TypeScript 需要返回值
     throw new Error('Request failed after all retries');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meet-im/lxcli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "连续科技命令行工具",
   "type": "module",
   "main": "dist/index.js",