@hecom/codearts 0.3.2 → 0.4.1

package/dist/services/business.service.d.ts

@@ -1,4 +1,4 @@
-import { AllWorkHourStats, HuaweiCloudConfig, IssueItem, IssueItemV2, IterationInfo, ProjectMember, ProjectRole, WorkHourStats, WorkProgressStats } from '../types';
+import { AllWorkHourStats, BugFixData, HuaweiCloudConfig, IssueItem, IssueItemV2, IterationInfo, ProjectMember, ProjectRole, WorkHourStats, WorkProgressStats } from '../types';
 /**
  * 业务服务类
  * 提供面向业务场景的高级操作，封装ApiService的底层调用
@@ -102,4 +102,43 @@ export declare class BusinessService {
      * @returns 项目列表
      */
     getProjects(limit?: number): Promise<import('../types').Project[]>;
+    /**
+     * 查询当前用户的所有 Bug
+     * @param projectId 项目ID
+     * @param options 查询选项
+     * @param options.hasIteration 是否有迭代（true: 有迭代, false: 无迭代, undefined: 不过滤）
+     * @returns Bug 类型的工作项列表，按创建时间倒序排列
+     */
+    getCurrentUserBugs(projectId: string, options?: {
+        hasIteration?: boolean;
+    }): Promise<IssueItem[]>;
+    /**
+     * 根据迭代 ID 和终端类型查询有效 Bug（分页获取全量）
+     * @param projectId 项目ID
+     * @param iterationIds 迭代 ID 列表
+     * @param terminalTypes 终端类型列表（对应 custom_field24），为空则不过滤
+     * @returns Bug 类型工作项列表
+     */
+    getBugsByIterationsAndTerminals(projectId: string, iterationIds: number[], terminalTypes: string[]): Promise<IssueItem[]>;
+    /**
+     * 批量获取自定义字段的选项
+     * @param projectId 项目ID
+     * @param customFieldIds 自定义字段ID列表
+     * @returns 自定义字段选项映射，key为字段ID，value为选项数组
+     */
+    getCustomFieldOptions(projectId: string, customFieldIds: string[]): Promise<Record<string, string[]>>;
+    /**
+     * 修复缺陷工作项
+     * 根据填写的缺陷分析信息更新缺陷工作项，仅当问题为缺陷且状态为可处理状态时才更新
+     * @param projectId 项目ID
+     * @param issue 选中的缺陷工作项
+     * @param bugFixData 缺陷分析数据
+     */
+    fixBug(projectId: string, issue: IssueItem, bugFixData: BugFixData): Promise<void>;
+    /**
+     * 将日期字符串解析为时间戳
+     * @param dateStr 日期字符串，格式：YYYY-MM-DD
+     * @returns 毫秒时间戳，如果解析失败返回 null
+     */
+    private parseDateToTimestamp;
 }

package/dist/services/business.service.js

@@ -124,7 +124,7 @@ class BusinessService {
         }
         const issuesResponse = await this.apiService.getIssues(projectId, {
             iteration_ids: iterationIds,
-            tracker_ids: [2], // 2=Task(任务), 7=Story
+            tracker_ids: [types_1.IssueTrackerId.TASK], // Task
             assigned_ids: userIds,
             limit: 100,
             offset: 0,
@@ -168,8 +168,10 @@ class BusinessService {
                 };
             }
             stats[userId].count++;
-            // 如果状态是已关闭（id=5），expectedHours 取实际工时，否则取预估工时
-            const expectedHours = issue.status?.id === 5 ? issue.actual_work_hours || 0 : issue.expected_work_hours || 0;
+            // 如果状态是已关闭，expectedHours 取实际工时，否则取预估工时
+            const expectedHours = issue.status?.id === types_1.IssueStatusId.CLOSED
+                ? issue.actual_work_hours || 0
+                : issue.expected_work_hours || 0;
             stats[userId].expectedHours += expectedHours;
             stats[userId].actualHours += issue.actual_work_hours || 0;
             // 累计总工时
@@ -279,7 +281,7 @@ class BusinessService {
             const issuesResponse = await this.apiService.getIssues(projectId, {
                 iteration_ids: iterationIds,
                 assigned_ids: userIds,
-                tracker_ids: [7], // 7=Story
+                tracker_ids: [types_1.IssueTrackerId.STORY], // Story
                 include_deleted: false,
                 limit: pageSize,
                 offset: offset,
@@ -351,7 +353,7 @@ class BusinessService {
         // Step 4: 为每个工时记录关联领域信息
         const enrichedWorkHours = allWorkHours.map((workHour) => {
             const issue = issueDetailsMap.get(workHour.issue_id);
-            const isBug = issue?.tracker?.id === 3; // 3=Bug
+            const isBug = issue?.tracker?.id === types_1.IssueTrackerId.BUG;
             const type = isBug ? issue?.tracker?.name || '' : issue?.domain?.name || '未分配领域';
             return {
                 ...workHour,
@@ -462,5 +464,224 @@ class BusinessService {
         }
         return response.data.projects;
     }
+    /**
+     * 查询当前用户的所有 Bug
+     * @param projectId 项目ID
+     * @param options 查询选项
+     * @param options.hasIteration 是否有迭代（true: 有迭代, false: 无迭代, undefined: 不过滤）
+     * @returns Bug 类型的工作项列表，按创建时间倒序排列
+     */
+    async getCurrentUserBugs(projectId, options = {}) {
+        // Step 1: 获取当前用户信息
+        const userInfoResponse = await this.apiService.showCurUserInfo();
+        if (!userInfoResponse.success || !userInfoResponse.data) {
+            throw new Error(`获取当前用户信息失败: ${userInfoResponse.error || '未知错误'}`);
+        }
+        const currentUserId = userInfoResponse.data.user_id;
+        // Step 2: 分页查询所有 Bug（tracker_id = 3 为 Bug）
+        const allBugs = [];
+        const pageSize = 100;
+        let offset = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const issuesResponse = await this.apiService.getIssues(projectId, {
+                assigned_ids: [currentUserId],
+                tracker_ids: [types_1.IssueTrackerId.BUG], // Bug
+                status_ids: [
+                    types_1.IssueStatusId.NEW_ISSUE,
+                    types_1.IssueStatusId.REOPENED,
+                    types_1.IssueStatusId.NEW_REQUIREMENT,
+                ], // 可处理状态
+                include_deleted: false,
+                limit: pageSize,
+                offset: offset,
+            });
+            if (!issuesResponse.success) {
+                throw new Error(`获取Bug列表失败: ${issuesResponse.error || '未知错误'}`);
+            }
+            const bugs = issuesResponse.data?.issues || [];
+            allBugs.push(...bugs);
+            // 判断是否还有更多数据
+            const total = issuesResponse.data?.total || 0;
+            offset += pageSize;
+            hasMore = offset < total;
+        }
+        // Step 3: 按照迭代状态过滤
+        let filteredBugs = allBugs;
+        if (options.hasIteration !== undefined) {
+            filteredBugs = allBugs.filter((bug) => {
+                const hasIteration = bug.iteration && bug.iteration.id > 0;
+                return options.hasIteration ? hasIteration : !hasIteration;
+            });
+        }
+        // Step 4: 按创建时间倒序排列
+        filteredBugs.sort((a, b) => {
+            const timeA = new Date(a.created_time).getTime();
+            const timeB = new Date(b.created_time).getTime();
+            return timeB - timeA; // 倒序
+        });
+        return filteredBugs;
+    }
+    /**
+     * 根据迭代 ID 和终端类型查询有效 Bug（分页获取全量）
+     * @param projectId 项目ID
+     * @param iterationIds 迭代 ID 列表
+     * @param terminalTypes 终端类型列表（对应 custom_field24），为空则不过滤
+     * @returns Bug 类型工作项列表
+     */
+    async getBugsByIterationsAndTerminals(projectId, iterationIds, terminalTypes) {
+        if (iterationIds.length === 0) {
+            return [];
+        }
+        const customFieldsFilter = terminalTypes.length > 0
+            ? [{ custom_field: types_1.CustomFieldId.TERMINAL_TYPE, value: terminalTypes.join(',') }]
+            : [];
+        const allBugs = [];
+        const pageSize = 100;
+        let offset = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const issuesResponse = await this.apiService.getIssues(projectId, {
+                tracker_ids: [types_1.IssueTrackerId.BUG],
+                iteration_ids: iterationIds,
+                custom_fields: customFieldsFilter.length > 0 ? customFieldsFilter : undefined,
+                include_deleted: false,
+                limit: pageSize,
+                offset,
+            });
+            if (!issuesResponse.success) {
+                throw new Error(`查询 Bug 失败: ${issuesResponse.error || '未知错误'}`);
+            }
+            const bugs = issuesResponse.data?.issues || [];
+            allBugs.push(...bugs);
+            const total = issuesResponse.data?.total || 0;
+            offset += pageSize;
+            hasMore = offset < total;
+        }
+        return allBugs.filter((bug) => bug.status?.id !== types_1.IssueStatusId.REJECTED);
+    }
+    /**
+     * 批量获取自定义字段的选项
+     * @param projectId 项目ID
+     * @param customFieldIds 自定义字段ID列表
+     * @returns 自定义字段选项映射，key为字段ID，value为选项数组
+     */
+    async getCustomFieldOptions(projectId, customFieldIds) {
+        if (customFieldIds.length === 0) {
+            return {};
+        }
+        const response = await this.apiService.getCustomFields(projectId, customFieldIds);
+        if (!response.success || !response.data) {
+            throw new Error(`获取自定义字段信息失败: ${response.error || '未知错误'}`);
+        }
+        // 将自定义字段列表转换为 fieldId -> options 的映射
+        const optionsMap = {};
+        response.data.datas.forEach((field) => {
+            // 如果 options 为 null，返回空数组；否则将逗号分隔的字符串解析为数组
+            optionsMap[field.custom_field] = field.options
+                ? field.options.split(',').map((option) => option.trim())
+                : [];
+        });
+        return optionsMap;
+    }
+    /**
+     * 修复缺陷工作项
+     * 根据填写的缺陷分析信息更新缺陷工作项，仅当问题为缺陷且状态为可处理状态时才更新
+     * @param projectId 项目ID
+     * @param issue 选中的缺陷工作项
+     * @param bugFixData 缺陷分析数据
+     */
+    async fixBug(projectId, issue, bugFixData) {
+        const { defectAnalysis, problemReason, impactScope, introductionStage, releaseDate } = bugFixData;
+        // 验证工作项是否为缺陷
+        if (issue.tracker?.id !== types_1.IssueTrackerId.BUG) {
+            throw new Error('选择的工作项不是缺陷类型');
+        }
+        // 验证工作项状态是否为可处理状态
+        // 可处理状态：17（新问题）、15（重新打开）、1（新需求）
+        if (![types_1.IssueStatusId.NEW_ISSUE, types_1.IssueStatusId.REOPENED, types_1.IssueStatusId.NEW_REQUIREMENT].includes(issue.status?.id)) {
+            throw new Error('缺陷工作项状态不可处理');
+        }
+        // 构建更新请求体
+        const newCustomFields = [];
+        if (defectAnalysis) {
+            newCustomFields.push({
+                custom_field: 'custom_field32',
+                field_name: '缺陷技术分析',
+                value: defectAnalysis,
+            });
+        }
+        if (problemReason) {
+            newCustomFields.push({
+                custom_field: 'custom_field39',
+                field_name: '问题原因',
+                value: problemReason,
+            });
+        }
+        if (impactScope) {
+            newCustomFields.push({
+                custom_field: 'custom_field40',
+                field_name: '影响范围',
+                value: impactScope,
+            });
+        }
+        // 检查缺陷类型是否为客户反馈
+        const issueCustomFields = issue.new_custom_fields || [];
+        const issueDefectTypeField = issueCustomFields.find((field) => field?.custom_field === 'custom_field36' || field?.field_name === '缺陷类型');
+        const issueDefectType = issueDefectTypeField?.value || '';
+        const isCustomerFeedback = issueDefectType === '客户反馈';
+        if (isCustomerFeedback) {
+            if (introductionStage) {
+                newCustomFields.push({
+                    custom_field: 'custom_field29',
+                    field_name: '引入阶段',
+                    value: introductionStage,
+                });
+            }
+            if (releaseDate) {
+                // 将日期字符串转换为时间戳
+                const releaseTimestamp = this.parseDateToTimestamp(releaseDate);
+                if (releaseTimestamp !== null) {
+                    newCustomFields.push({
+                        custom_field: 'custom_field18',
+                        field_name: '发布日期',
+                        value: String(releaseTimestamp),
+                    });
+                }
+            }
+        }
+        // 只有在有自定义字段时才发送更新请求
+        if (newCustomFields.length > 0) {
+            const updateData = {
+                status_id: types_1.IssueStatusId.RESOLVED, // 设置状态为已解决
+                new_custom_fields: newCustomFields,
+            };
+            // 如果处理人不是创建人，则更新开发人员和处理人
+            if (issue.assigned_user?.id !== issue.creator?.id) {
+                Object.assign(updateData, {
+                    developer_id: issue.assigned_user?.id, // 开发人员设置为当前处理人
+                    assigned_id: issue.creator?.id, // 处理人设置为创建人
+                });
+            }
+            await this.apiService.updateIssue(projectId, String(issue.id), updateData);
+        }
+    }
+    /**
+     * 将日期字符串解析为时间戳
+     * @param dateStr 日期字符串，格式：YYYY-MM-DD
+     * @returns 毫秒时间戳，如果解析失败返回 null
+     */
+    parseDateToTimestamp(dateStr) {
+        try {
+            const date = new Date(dateStr);
+            if (isNaN(date.getTime())) {
+                return null;
+            }
+            return date.getTime();
+        }
+        catch {
+            return null;
+        }
+    }
 }
 exports.BusinessService = BusinessService;

package/dist/types/index.d.ts

@@ -265,10 +265,38 @@ export interface IssueStatus {
     id: number;
     name: string;
 }
+export declare enum IssueStatusId {
+    NEW_REQUIREMENT = 1,// 新需求
+    IN_PROGRESS = 2,// 进行中
+    RESOLVED = 3,// 已解决
+    TESTING = 4,// 测试中
+    CLOSED = 5,// 已关闭
+    REJECTED = 6,// 已拒绝
+    PRODUCT_DESIGN = 7,// 产品设计
+    REVIEW_READY = 8,// 可评审
+    DEV_POOL = 9,// 开发池
+    DEVELOPING = 10,// 开发中
+    TEST_READY = 11,// 可提测
+    HANDOFF_EXPERIENCE = 12,// 转体验
+    ACCEPTED = 13,// 接受处理
+    VERIFIED = 14,// 已验证
+    REOPENED = 15,// 重新打开
+    POSTPONED = 16,// 延期
+    NEW_ISSUE = 17,// 新问题
+    CONVERTED_TO_REQUIREMENT = 18,// 转需求
+    PENDING_TEST = 19
+}
 export interface IssueTracker {
     id: number;
     name: string;
 }
+export declare enum IssueTrackerId {
+    TASK = 2,// 任务
+    BUG = 3,// 缺陷
+    EPIC = 5,// Epic
+    FEATURE = 6,// Feature
+    STORY = 7
+}
 export interface IssueItem {
     actual_work_hours: number;
     assigned_cc_user: IssueUser[];
@@ -331,6 +359,26 @@ export interface AddIssueNotesRequest {
     projectUUId: string;
     type?: string;
 }
+export interface UpdateIssueRequest {
+    actual_work_hours?: number;
+    assigned_id?: number;
+    begin_time?: string;
+    description?: string;
+    developer_id?: number;
+    domain_id?: number;
+    done_ratio?: number;
+    end_time?: string;
+    expected_work_hours?: number;
+    iteration_id?: number;
+    module_id?: number;
+    name?: string;
+    parent_issue_id?: number;
+    priority_id?: number;
+    severity_id?: number;
+    status_id?: number;
+    tracker_id?: number;
+    new_custom_fields?: IssueNewCustomField[];
+}
 export interface ListChildIssuesV4Response {
     issues: IssueItem[];
     total: number;
@@ -446,7 +494,32 @@ export interface ListChildIssuesV2Response {
 /**
  * 自定义字段类型枚举
  */
-export type CustomFieldType = 'textbox' | 'textarea' | 'checkbox' | 'radio' | 'select' | 'date' | 'number';
+export type CustomFieldType = 'textbox' | 'textarea' | 'checkbox' | 'radio' | 'select' | 'date' | 'number' | 'text' | 'textArea' | 'user' | 'time_date';
+/**
+ * 缺陷相关自定义字段ID枚举
+ */
+export declare enum CustomFieldId {
+    FEEDBACK_PERSON = "custom_field20",// 反馈人
+    DEFECT_TECHNICAL_ANALYSIS = "custom_field32",// 缺陷技术分析
+    IMPACT_SCOPE = "custom_field40",// 影响范围
+    ENVIRONMENT = "custom_field30",// 环境
+    TERMINAL_TYPE = "custom_field24",// 终端类型
+    DEFECT_TYPE = "custom_field36",// 缺陷类型
+    PRODUCT_MODULE = "custom_field33",// 产品模块
+    CUSTOMER_FEEDBACK_NO = "custom_field22",// 客户反馈编号
+    TEST_CASE_COVERAGE = "custom_field34",// 测试用例覆盖
+    TEST_STAGE = "custom_field23",// 测试阶段
+    COMPANY_NAME = "custom_field17",// 企业名称
+    DEFECT_ROOT_CAUSE = "custom_field28",// 缺陷根源
+    PROBLEM_CAUSE_AND_SOLUTION = "custom_field39",// 问题原因及解决办法
+    RELEASE_TIME = "custom_field18",// 发布时间
+    INTRODUCTION_PHASE = "custom_field29",// 引入阶段
+    VERSION = "custom_field37",// 版本
+    TESTER = "custom_field26",// 测试人员
+    DEVELOPMENT_END = "custom_field16",// 开发端
+    AI_RELATED = "custom_field25",// AI相关
+    BRIEFING_TIME = "custom_field38"
+}
 /**
  * 缺陷技术分析选项枚举
  * custom_field32（缺陷技术分析）字段的选项值枚举定义
@@ -575,3 +648,36 @@ export interface AddIssueNotesResponse {
 export interface AddIssueNotesResult {
     issue: unknown;
 }
+export interface CurrentUserInfo {
+    id: number;
+    name: string;
+    nick_name: string;
+    user_id: string;
+    user_num_id: number;
+    domain_id: string;
+    domain_name: string;
+    email?: string;
+    phone?: string;
+    status?: number;
+}
+export interface CustomFieldOption {
+    custom_field: string;
+    type: CustomFieldType;
+    name: string;
+    options: string;
+    tracker_ids: number[];
+    create_time: string;
+}
+export interface GetCustomFieldsRequest {
+    custom_fields: string[];
+}
+export interface GetCustomFieldsResponse {
+    datas: CustomFieldOption[];
+}
+export interface BugFixData {
+    defectAnalysis?: string;
+    problemReason?: string;
+    impactScope?: string;
+    introductionStage?: string;
+    releaseDate?: string;
+}

package/dist/types/index.js

@@ -1,6 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigKey = exports.DefectAnalysisType = exports.IterationStatus = void 0;
+exports.ConfigKey = exports.DefectAnalysisType = exports.CustomFieldId = exports.IterationStatus = exports.IssueTrackerId = exports.IssueStatusId = void 0;
+// 工作项状态ID枚举
+var IssueStatusId;
+(function (IssueStatusId) {
+    IssueStatusId[IssueStatusId["NEW_REQUIREMENT"] = 1] = "NEW_REQUIREMENT";
+    IssueStatusId[IssueStatusId["IN_PROGRESS"] = 2] = "IN_PROGRESS";
+    IssueStatusId[IssueStatusId["RESOLVED"] = 3] = "RESOLVED";
+    IssueStatusId[IssueStatusId["TESTING"] = 4] = "TESTING";
+    IssueStatusId[IssueStatusId["CLOSED"] = 5] = "CLOSED";
+    IssueStatusId[IssueStatusId["REJECTED"] = 6] = "REJECTED";
+    IssueStatusId[IssueStatusId["PRODUCT_DESIGN"] = 7] = "PRODUCT_DESIGN";
+    IssueStatusId[IssueStatusId["REVIEW_READY"] = 8] = "REVIEW_READY";
+    IssueStatusId[IssueStatusId["DEV_POOL"] = 9] = "DEV_POOL";
+    IssueStatusId[IssueStatusId["DEVELOPING"] = 10] = "DEVELOPING";
+    IssueStatusId[IssueStatusId["TEST_READY"] = 11] = "TEST_READY";
+    IssueStatusId[IssueStatusId["HANDOFF_EXPERIENCE"] = 12] = "HANDOFF_EXPERIENCE";
+    IssueStatusId[IssueStatusId["ACCEPTED"] = 13] = "ACCEPTED";
+    IssueStatusId[IssueStatusId["VERIFIED"] = 14] = "VERIFIED";
+    IssueStatusId[IssueStatusId["REOPENED"] = 15] = "REOPENED";
+    IssueStatusId[IssueStatusId["POSTPONED"] = 16] = "POSTPONED";
+    IssueStatusId[IssueStatusId["NEW_ISSUE"] = 17] = "NEW_ISSUE";
+    IssueStatusId[IssueStatusId["CONVERTED_TO_REQUIREMENT"] = 18] = "CONVERTED_TO_REQUIREMENT";
+    IssueStatusId[IssueStatusId["PENDING_TEST"] = 19] = "PENDING_TEST";
+})(IssueStatusId || (exports.IssueStatusId = IssueStatusId = {}));
+// 工作项类型ID枚举
+var IssueTrackerId;
+(function (IssueTrackerId) {
+    IssueTrackerId[IssueTrackerId["TASK"] = 2] = "TASK";
+    IssueTrackerId[IssueTrackerId["BUG"] = 3] = "BUG";
+    IssueTrackerId[IssueTrackerId["EPIC"] = 5] = "EPIC";
+    IssueTrackerId[IssueTrackerId["FEATURE"] = 6] = "FEATURE";
+    IssueTrackerId[IssueTrackerId["STORY"] = 7] = "STORY";
+})(IssueTrackerId || (exports.IssueTrackerId = IssueTrackerId = {}));
 var IterationStatus;
 (function (IterationStatus) {
     IterationStatus["OPEN"] = "open";
@@ -8,6 +40,33 @@ var IterationStatus;
     IterationStatus["IN_PROGRESS"] = "1";
     IterationStatus["COMPLETED"] = "2";
 })(IterationStatus || (exports.IterationStatus = IterationStatus = {}));
+/**
+ * 缺陷相关自定义字段ID枚举
+ */
+var CustomFieldId;
+(function (CustomFieldId) {
+    // Bug专用字段
+    CustomFieldId["FEEDBACK_PERSON"] = "custom_field20";
+    CustomFieldId["DEFECT_TECHNICAL_ANALYSIS"] = "custom_field32";
+    CustomFieldId["IMPACT_SCOPE"] = "custom_field40";
+    CustomFieldId["ENVIRONMENT"] = "custom_field30";
+    CustomFieldId["TERMINAL_TYPE"] = "custom_field24";
+    CustomFieldId["DEFECT_TYPE"] = "custom_field36";
+    CustomFieldId["PRODUCT_MODULE"] = "custom_field33";
+    CustomFieldId["CUSTOMER_FEEDBACK_NO"] = "custom_field22";
+    CustomFieldId["TEST_CASE_COVERAGE"] = "custom_field34";
+    CustomFieldId["TEST_STAGE"] = "custom_field23";
+    CustomFieldId["COMPANY_NAME"] = "custom_field17";
+    CustomFieldId["DEFECT_ROOT_CAUSE"] = "custom_field28";
+    CustomFieldId["PROBLEM_CAUSE_AND_SOLUTION"] = "custom_field39";
+    CustomFieldId["RELEASE_TIME"] = "custom_field18";
+    CustomFieldId["INTRODUCTION_PHASE"] = "custom_field29";
+    CustomFieldId["VERSION"] = "custom_field37";
+    CustomFieldId["TESTER"] = "custom_field26";
+    CustomFieldId["DEVELOPMENT_END"] = "custom_field16";
+    CustomFieldId["AI_RELATED"] = "custom_field25";
+    CustomFieldId["BRIEFING_TIME"] = "custom_field38";
+})(CustomFieldId || (exports.CustomFieldId = CustomFieldId = {}));
 /**
  * 缺陷技术分析选项枚举
  * custom_field32（缺陷技术分析）字段的选项值枚举定义

package/dist/utils/config-loader.d.ts

@@ -1,29 +1,30 @@
 import { ConfigMap, HuaweiCloudConfig, OutputFormat } from '../types';
 /**
- * 获取全局配置文件路径
+ * 获取配置文件路径
  */
 export declare function getConfigPath(): string;
 /**
- * 检查全局配置文件是否存在
+ * 检查配置文件是否存在
  */
 export declare function configExists(): boolean;
 /**
- * 读取全局配置
+ * 读取配置
  */
 export declare function readConfig(): Partial<ConfigMap>;
 /**
- * 写入全局配置
+ * 写入配置
  * 支持动态配置项，自动按分组组织配置文件
  */
 export declare function writeConfig(config: Partial<ConfigMap>): void;
 /**
- * 删除全局配置
+ * 删除配置
  */
 export declare function deleteConfig(): void;
 export interface CliOptions {
     role?: string;
     output?: string;
     report?: boolean;
+    outputDir?: string;
 }
 export interface LoadedConfig {
     projectId: string;
@@ -32,7 +33,7 @@ export interface LoadedConfig {
     outputFormat: OutputFormat;
 }
 /**
- * 加载配置，优先级：命令行参数 > 全局配置
+ * 加载配置，优先级：命令行参数 > 配置文件
  * @param cliOptions 命令行选项
  * @returns 加载的配置
  */

package/dist/utils/config-loader.js

@@ -45,7 +45,7 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const types_1 = require("../types");
 /**
- * 全局配置管理工具
+ * 配置管理工具
  * 配置文件存储在用户主目录下的 .hecom-codearts 目录
  */
 const CONFIG_DIR = path.join(os.homedir(), '.hecom-codearts');
@@ -59,19 +59,19 @@ function ensureConfigDir() {
     }
 }
 /**
- * 获取全局配置文件路径
+ * 获取配置文件路径
  */
 function getConfigPath() {
     return CONFIG_FILE;
 }
 /**
- * 检查全局配置文件是否存在
+ * 检查配置文件是否存在
  */
 function configExists() {
     return fs.existsSync(CONFIG_FILE);
 }
 /**
- * 读取全局配置
+ * 读取配置
  */
 function readConfig() {
     if (!configExists()) {
@@ -98,7 +98,7 @@ function readConfig() {
         }
     }
     catch (error) {
-        console.error('读取全局配置文件失败:', error);
+        console.error('读取配置文件失败:', error);
     }
     return config;
 }
@@ -124,13 +124,13 @@ const CONFIG_GROUPS = [
     },
 ];
 /**
- * 写入全局配置
+ * 写入配置
  * 支持动态配置项，自动按分组组织配置文件
  */
 function writeConfig(config) {
     ensureConfigDir();
     // 构建配置文件头部
-    let content = `# Hecom CodeArts 全局配置文件`;
+    let content = `# Hecom CodeArts 配置文件`;
     // 记录已写入的配置项
     const writtenKeys = new Set();
     // 按分组写入配置
@@ -155,11 +155,11 @@ function writeConfig(config) {
         fs.writeFileSync(CONFIG_FILE, content, 'utf-8');
     }
     catch (error) {
-        throw new Error(`写入全局配置文件失败: ${error}`);
+        throw new Error(`写入配置文件失败: ${error}`);
     }
 }
 /**
- * 删除全局配置
+ * 删除配置
  */
 function deleteConfig() {
     if (configExists()) {
@@ -167,19 +167,19 @@ function deleteConfig() {
             fs.unlinkSync(CONFIG_FILE);
         }
         catch (error) {
-            throw new Error(`删除全局配置文件失败: ${error}`);
+            throw new Error(`删除配置文件失败: ${error}`);
         }
     }
 }
-// 加载全局配置
+// 加载配置
 const globalConfig = configExists() ? readConfig() : {};
 /**
- * 加载配置，优先级：命令行参数 > 全局配置
+ * 加载配置，优先级：命令行参数 > 配置文件
  * @param cliOptions 命令行选项
  * @returns 加载的配置
  */
 function loadConfig(cliOptions = {}) {
-    // 命令行参数 > 全局配置
+    // 命令行参数 > 配置文件
     const projectId = globalConfig[types_1.ConfigKey.PROJECT_ID];
     const roleIdStr = cliOptions.role || globalConfig[types_1.ConfigKey.ROLE_ID];
     if (!projectId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hecom/codearts",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "华为云 CodeArts 统计分析工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,7 +17,10 @@
     "test": "jest --passWithNoTests",
     "test:coverage": "jest --coverage --passWithNoTests",
     "prepublishOnly": "npm run build",
-    "dev": "ts-node src/bin/cli.ts"
+    "dev": "ts-node src/bin/cli.ts",
+    "minor": "npm version minor -m \"Bump version to %s\"; git push --tags",
+    "patch": "npm version patch -m \"Bump version to %s\"; git push --tags",
+    "major": "npm version major -m \"Bump version to %s\"; git push --tags"
   },
   "keywords": [
     "huawei-cloud",