@hecom/codearts 0.1.0 → 0.2.1

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

@@ -1,4 +1,4 @@
-import { AllWorkHourStats, HuaweiCloudConfig, IssueDetailResponseV2, IssueItem, IterationInfo, ProjectMember, WorkHourStats, WorkProgressStats } from '../types';
+import { AllWorkHourStats, HuaweiCloudConfig, IssueItem, IssueItemV2, IterationInfo, ProjectMember, ProjectRole, WorkHourStats, WorkProgressStats } from '../types';
 import { ApiService } from './api.service';
 /**
  * 业务服务类
@@ -19,6 +19,12 @@ export declare class BusinessService {
      * @returns 指定角色的成员列表
      */
     getMembersByRoleId(projectId: string, roleId: number): Promise<ProjectMember[]>;
+    /**
+     * 获取项目中的所有角色列表（去重）
+     * @param projectId 项目ID
+     * @returns 项目中的所有角色列表
+     */
+    getProjectRoles(projectId: string): Promise<ProjectRole[]>;
     /**
      * 获取指定日期之后的迭代列表
      * @param projectId 项目ID
@@ -42,7 +48,6 @@ export declare class BusinessService {
      * @returns Task和Story类型的工作项列表
      */
     getWorkloadByIterationAndUsers(projectId: string, iterationId: number, userIds: string[]): Promise<IssueItem[]>;
-    addIssueNote(projectId: string, issueId: number, content: string): Promise<IssueDetailResponseV2>;
     /**
      * 统计工作项进度信息
      * @param issues 工作项列表
@@ -57,6 +62,20 @@ export declare class BusinessService {
      * @returns 工时统计结果，包括总工时和按用户分组的工时详情
      */
     getDailyWorkHourStats(projectId: string, userIds: string[], date: string): Promise<WorkHourStats>;
+    /**
+     * 根据迭代标题获取迭代信息
+     * @param projectId 项目ID
+     * @param iterationTitles 迭代标题列表
+     * @returns 匹配的迭代信息列表
+     */
+    getIterationsByTitles(projectId: string, iterationTitles: string[]): Promise<IterationInfo[]>;
+    /**
+     * 根据迭代标题获取所有 Story
+     * @param projectId 项目ID
+     * @param iterationTitles 迭代标题列表
+     * @returns Story 类型的工作项列表
+     */
+    getStoriesByIterationTitles(projectId: string, iterationTitles: string[]): Promise<IssueItem[]>;
     /**
      * 查询指定用户在指定时间段内的所有工时统计（按人和领域分组）
      * @param projectId 项目ID
@@ -66,4 +85,25 @@ export declare class BusinessService {
      * @returns 工时统计结果，按用户和领域两个维度分组
      */
     getAllWorkHourStats(projectId: string, userIds: string[], beginDate: string, endDate: string): Promise<AllWorkHourStats>;
+    /**
+     * 获取指定工作项的所有子工作项（处理分页）
+     * @param projectId 项目ID
+     * @param issueId 父工作项ID
+     * @returns 所有子工作项列表
+     */
+    getChildIssues(projectId: string, issueId: string): Promise<IssueItemV2[]>;
+    /**
+     * 验证 IAM 凭证是否有效
+     * @returns 验证结果，包含成功状态和可能的错误信息
+     */
+    validateCredentials(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 获取项目列表
+     * @param limit 返回的项目数量限制，默认100
+     * @returns 项目列表
+     */
+    getProjects(limit?: number): Promise<import('../types').Project[]>;
 }

package/dist/services/business.service.js

@@ -32,6 +32,45 @@ class BusinessService {
         const allMembers = membersResponse.data?.members || [];
         return allMembers.filter((member) => member.role_id === roleId);
     }
+    /**
+     * 获取项目中的所有角色列表（去重）
+     * @param projectId 项目ID
+     * @returns 项目中的所有角色列表
+     */
+    async getProjectRoles(projectId) {
+        // 分页获取所有成员
+        const allMembers = [];
+        const pageSize = 100;
+        let offset = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const membersResponse = await this.apiService.getMembers(projectId, {
+                limit: pageSize,
+                offset: offset,
+            });
+            if (!membersResponse.success) {
+                throw new Error(`获取成员列表失败: ${membersResponse.error || '未知错误'}`);
+            }
+            const members = membersResponse.data?.members.filter((member) => member.role_id !== -1 && member.nick_name != null) || [];
+            allMembers.push(...members);
+            // 判断是否还有更多数据
+            const total = membersResponse.data?.total || 0;
+            offset += pageSize;
+            hasMore = offset < total;
+        }
+        // 使用 Map 去重，key 为 role_id
+        const rolesMap = new Map();
+        allMembers.forEach((member) => {
+            if (!rolesMap.has(member.role_id)) {
+                rolesMap.set(member.role_id, {
+                    role_id: member.role_id,
+                    role_name: member.role_name,
+                });
+            }
+        });
+        // 转换为数组并按 role_id 排序
+        return Array.from(rolesMap.values()).sort((a, b) => a.role_id - b.role_id);
+    }
     /**
      * 获取指定日期之后的迭代列表
      * @param projectId 项目ID
@@ -103,17 +142,6 @@ class BusinessService {
         }
         return issuesResponse.data?.issues || [];
     }
-    async addIssueNote(projectId, issueId, content) {
-        const result = await this.apiService.addIssueNotes({
-            projectUUId: projectId,
-            id: String(issueId),
-            notes: content,
-        });
-        if (result.data?.status === 'success') {
-            return result.data.result.issue;
-        }
-        throw new Error(`添加工作项备注失败: ${result.data?.status || '未知错误'}`);
-    }
     /**
      * 统计工作项进度信息
      * @param issues 工作项列表
@@ -210,6 +238,62 @@ class BusinessService {
             userStats,
         };
     }
+    /**
+     * 根据迭代标题获取迭代信息
+     * @param projectId 项目ID
+     * @param iterationTitles 迭代标题列表
+     * @returns 匹配的迭代信息列表
+     */
+    async getIterationsByTitles(projectId, iterationTitles) {
+        const iterationsResponse = await this.apiService.getIterations(projectId, {
+            include_deleted: false,
+        });
+        if (!iterationsResponse.success) {
+            throw new Error(`获取迭代列表失败: ${iterationsResponse.error || '未知错误'}`);
+        }
+        const iterations = iterationsResponse.data?.iterations || [];
+        // 过滤出标题匹配的迭代
+        return iterations.filter((iteration) => iterationTitles.includes(iteration.name));
+    }
+    /**
+     * 根据迭代标题获取所有 Story
+     * @param projectId 项目ID
+     * @param iterationTitles 迭代标题列表
+     * @returns Story 类型的工作项列表
+     */
+    async getStoriesByIterationTitles(projectId, iterationTitles) {
+        // Step 1: 根据标题获取迭代信息
+        const iterations = await this.getIterationsByTitles(projectId, iterationTitles);
+        if (iterations.length === 0) {
+            return [];
+        }
+        // Step 2: 提取迭代ID
+        const iterationIds = iterations.map((iteration) => iteration.id);
+        // Step 3: 分页查询所有 Story（tracker_id = 7）
+        const allStories = [];
+        const pageSize = 100;
+        let offset = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const issuesResponse = await this.apiService.getIssues(projectId, {
+                iteration_ids: iterationIds,
+                tracker_ids: [7], // 7=Story
+                include_deleted: false,
+                limit: pageSize,
+                offset: offset,
+            });
+            if (!issuesResponse.success) {
+                throw new Error(`获取Story列表失败: ${issuesResponse.error || '未知错误'}`);
+            }
+            const stories = issuesResponse.data?.issues || [];
+            allStories.push(...stories);
+            // 判断是否还有更多数据
+            const total = issuesResponse.data?.total || 0;
+            offset += pageSize;
+            hasMore = offset < total;
+        }
+        return allStories;
+    }
     /**
      * 查询指定用户在指定时间段内的所有工时统计（按人和领域分组）
      * @param projectId 项目ID
@@ -326,5 +410,55 @@ class BusinessService {
             userStats,
         };
     }
+    /**
+     * 获取指定工作项的所有子工作项（处理分页）
+     * @param projectId 项目ID
+     * @param issueId 父工作项ID
+     * @returns 所有子工作项列表
+     */
+    async getChildIssues(projectId, issueId) {
+        const allChildIssues = [];
+        const pageSize = 100;
+        let pageNo = 1;
+        let hasMore = true;
+        while (hasMore) {
+            const response = await this.apiService.getChildIssuesV2(projectId, issueId, pageSize, pageNo);
+            if (!response.success || !response.data) {
+                throw new Error(`获取子工作项失败: ${response.error || '未知错误'}`);
+            }
+            const childIssues = response.data.result.issues || [];
+            allChildIssues.push(...childIssues);
+            const total = response.data.result.total_count || 0;
+            hasMore = pageNo * pageSize < total;
+            pageNo++;
+        }
+        return allChildIssues;
+    }
+    /**
+     * 验证 IAM 凭证是否有效
+     * @returns 验证结果，包含成功状态和可能的错误信息
+     */
+    async validateCredentials() {
+        try {
+            await this.apiService.refreshToken();
+            return { success: true };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMsg };
+        }
+    }
+    /**
+     * 获取项目列表
+     * @param limit 返回的项目数量限制，默认100
+     * @returns 项目列表
+     */
+    async getProjects(limit = 100) {
+        const response = await this.apiService.getProjects({ limit });
+        if (!response.success || !response.data) {
+            throw new Error(response.error || '获取项目列表失败');
+        }
+        return response.data.projects;
+    }
 }
 exports.BusinessService = BusinessService;

package/dist/types/index.d.ts

@@ -95,29 +95,12 @@ export interface ApiResponse<T = unknown> {
     message?: string;
     error?: string;
 }
-export interface RawData {
-    id: string;
-    timestamp: string;
-    content: unknown;
-    metadata?: Record<string, unknown>;
-}
-export interface ProcessedData {
-    id: string;
-    processedAt: string;
-    result: unknown;
-    summary?: string;
-}
 export interface RequestOptions {
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
     headers?: Record<string, string>;
     params?: Record<string, unknown>;
     data?: unknown;
 }
-export interface ProjectType {
-    SCRUM: 'scrum';
-    NORMAL: 'normal';
-    XBOARD: 'xboard';
-}
 export interface ProjectQueryParams {
     offset?: number;
     limit?: number;
@@ -169,6 +152,10 @@ export interface ProjectMemberQueryParams {
     offset?: number;
     limit?: number;
 }
+export interface ProjectRole {
+    role_id: number;
+    role_name: string;
+}
 export interface ShowProjectWorkHoursRequest {
     begin_time?: string;
     end_time?: string;
@@ -338,124 +325,142 @@ export interface AddIssueNotesRequest {
     projectUUId: string;
     type?: string;
 }
-export interface UserVO {
-    assigned_nick_name?: string;
-    first_name?: string;
-    id?: number;
-    identifier?: string;
-    last_name?: string;
-    name?: string;
+export interface ListChildIssuesV4Response {
+    issues: IssueItem[];
+    total: number;
 }
-export interface CustomFieldV2 {
-    name?: string;
-    value?: string;
-    new_name?: string;
+export interface IssueUserV2 {
+    firstName: string;
+    lastName: string;
+    identifier: string;
+    imageId?: string;
+    name: string;
+    id: number;
+    assignedNickName?: string;
+    authorNickName?: string;
+    closederNickName?: string;
 }
-export interface IssueDetailCustomFieldV2 {
-    custom_field?: string;
-    field_name?: string;
-    value?: string;
-    field_type?: string;
-    description?: string;
+export interface IssueParentV2 {
+    subject: string;
+    id: number;
 }
-export interface DomainVO {
-    id?: number;
-    name?: string;
+export interface IssueProjectV2 {
+    identifier: string;
+    name: string;
+    id: number;
+    type: string;
 }
-export interface ProjectVO {
-    identifier?: string;
-    name?: string;
-    id?: number;
-    project_type?: string;
+export interface IssueTrackerV2 {
+    name: string;
+    id: number;
 }
-export interface IterationVO {
-    id?: number;
-    name?: string;
+export interface IssueSeverityV2 {
+    name: string;
+    id: number;
 }
-export interface StoryPointVO {
-    id?: number;
-    name?: string;
+export interface IssuePriorityV2 {
+    name: string;
+    id: number;
 }
-export interface ModuleVO {
-    id?: number;
-    name?: string;
+export interface IssueStatusV2 {
+    name: string;
+    id: number;
 }
-export interface ParentIssueVO {
-    id?: number;
-    name?: string;
+export interface IssueStatusAttributeV2 {
+    name: string;
+    id: number;
 }
-export interface PriorityVO {
-    id?: number;
-    name?: string;
+export interface IssueDomainV2 {
+    name: string;
+    id: number;
 }
-export interface SeverityVO {
+export interface IssueModuleV2 {
     id?: number;
     name?: string;
 }
-export interface StatusVO {
+export interface IssueDeveloperV2 {
     id?: number;
     name?: string;
 }
-export interface EnvVO {
-    id?: number;
-    name?: string;
+export interface IssueFixedVersionV2 {
+    name: string;
+    id: number;
 }
-export interface TrackerVO {
-    id?: number;
-    name?: string;
+export interface IssueOrderV2 {
+    name: number;
+    id: number;
 }
-export interface IssueAccessoryV2 {
-    attachment_id?: number;
-    issue_id?: number;
-    creator_num_id?: number;
-    created_date?: string;
-    file_name?: string;
-    container_type?: string;
-    disk_file_name?: string;
-    digest?: string;
-    disk_directory?: string;
-    creator_id?: string;
-}
-export interface IssueDetailResponseV2 {
-    actual_work_hours?: number;
-    assigned_cc_user?: UserVO[];
-    assigned_to?: UserVO;
-    start_date?: string;
-    created_on?: string;
-    author?: UserVO;
-    custom_fields?: CustomFieldV2[];
-    custom_value_new?: IssueDetailCustomFieldV2;
-    developer?: UserVO;
-    domain?: DomainVO;
-    done_ratio?: number;
-    end_time?: string;
-    expected_work_hours?: number;
-    id?: number;
-    project?: ProjectVO;
-    iteration?: IterationVO;
-    story_point?: StoryPointVO;
-    module?: ModuleVO;
-    subject?: string;
-    parent_issue?: ParentIssueVO;
-    priority?: PriorityVO;
-    severity?: SeverityVO;
-    status?: StatusVO;
-    release_dev?: string;
-    find_release_dev?: string;
-    env?: EnvVO;
-    tracker?: TrackerVO;
-    updated_on?: string;
-    closed_time?: string;
-    description?: string;
-    accessories_list?: IssueAccessoryV2[];
-    inner_text?: string;
-}
-export interface AddIssueNotesResult {
-    issue: IssueDetailResponseV2;
-}
-export interface AddIssueNotesResponse {
-    result: AddIssueNotesResult;
-    status: string;
+export interface IssueCustomValueNewV2 {
+    [key: string]: string;
+}
+export interface IssueItemV2 {
+    id: number;
+    subject: string;
+    description: string;
+    updated_on: string;
+    created_on: string;
+    closed_on: string;
+    parent_issue?: IssueParentV2;
+    parent_issue_id?: number;
+    project: IssueProjectV2;
+    done_ratio: number;
+    findReleaseDev: string;
+    tracker: IssueTrackerV2;
+    releaseDev: string;
+    customValueNew?: IssueCustomValueNewV2;
+    order?: IssueOrderV2;
+    assigned_to: IssueUserV2;
+    status_attribute: IssueStatusAttributeV2;
+    severity: IssueSeverityV2;
+    isParent: boolean;
+    author: IssueUserV2;
+    module: IssueModuleV2;
+    expected_work_hours: number;
+    priority: IssuePriorityV2;
+    actual_work_hours: number;
+    is_watcher: boolean;
+    deleted: boolean;
+    fixed_version?: IssueFixedVersionV2;
+    is_archived: boolean;
+    domain: IssueDomainV2;
+    developer: IssueDeveloperV2;
+    closeder?: IssueUserV2;
+    position: string;
+    closed_flag: number;
+    assigned_cc_user: IssueUserV2[];
+    status: IssueStatusV2;
+}
+export interface ListChildIssuesV2Response {
+    result: {
+        total_count: number;
+        issues: IssueItemV2[];
+    };
+    status: 'success';
+}
+/**
+ * 自定义字段类型枚举
+ */
+export type CustomFieldType = 'textbox' | 'textarea' | 'checkbox' | 'radio' | 'select' | 'date' | 'number';
+/**
+ * 缺陷技术分析选项枚举
+ * custom_field32（缺陷技术分析）字段的选项值枚举定义
+ */
+export declare enum DefectAnalysisType {
+    FUNCTION_IMPLEMENTATION = "\u529F\u80FD\u5B9E\u73B0\u95EE\u9898",
+    REQUIREMENT_CHANGE = "\u9700\u6C42\u53D8\u66F4\u95EE\u9898",
+    LEGACY_ISSUE = "\u5386\u53F2\u9057\u7559\u95EE\u9898",
+    CODE_LOGIC = "\u4EE3\u7801\u903B\u8F91\u95EE\u9898",
+    USER_INTERFACE = "\u7528\u6237\u754C\u9762\u95EE\u9898",
+    INTERFACE = "\u63A5\u53E3\u95EE\u9898",
+    DATA = "\u6570\u636E\u95EE\u9898",
+    PERFORMANCE = "\u6027\u80FD\u95EE\u9898",
+    ENVIRONMENT = "\u73AF\u5883\u95EE\u9898",
+    COMPATIBILITY = "\u517C\u5BB9\u6027\u95EE\u9898",
+    PRODUCT_DESIGN = "\u4EA7\u54C1\u8BBE\u8BA1\u95EE\u9898",
+    OPTIMIZATION_SUGGESTION = "\u4F18\u5316\u5EFA\u8BAE\u95EE\u9898",
+    TECH_REQUIREMENT_CHANGE = "\u6280\u672F\u5F15\u8D77\u7684\u9700\u6C42\u53D8\u66F4\u95EE\u9898",
+    USAGE_AND_CONFIG = "\u4F7F\u7528\u53CA\u914D\u7F6E\u95EE\u9898",
+    OTHER = "\u5176\u4ED6\u95EE\u9898"
 }
 /**
  * 用户工作项统计信息
@@ -520,3 +525,42 @@ export interface AllWorkHourStats {
     totalEntries: number;
     userStats: UserAllWorkHourStats[];
 }
+/**
+ * 配置键枚举
+ * 用于类型安全的配置项访问
+ */
+export declare enum ConfigKey {
+    HUAWEI_CLOUD_IAM_ENDPOINT = "HUAWEI_CLOUD_IAM_ENDPOINT",
+    HUAWEI_CLOUD_REGION = "HUAWEI_CLOUD_REGION",
+    HUAWEI_CLOUD_USERNAME = "HUAWEI_CLOUD_USERNAME",
+    HUAWEI_CLOUD_PASSWORD = "HUAWEI_CLOUD_PASSWORD",
+    HUAWEI_CLOUD_DOMAIN = "HUAWEI_CLOUD_DOMAIN",
+    CODEARTS_BASE_URL = "CODEARTS_BASE_URL",
+    PROJECT_ID = "PROJECT_ID",
+    ROLE_ID = "ROLE_ID"
+}
+/**
+ * 不可变配置键（只能通过 config 命令设置）
+ */
+export declare const IMMUTABLE_CONFIG_KEYS: ConfigKey[];
+/**
+ * 可变配置键（可以通过命令行参数覆盖）
+ */
+export declare const MUTABLE_CONFIG_KEYS: ConfigKey[];
+/**
+ * 类型安全的配置映射
+ */
+export type ConfigMap = {
+    [ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT]: string;
+    [ConfigKey.HUAWEI_CLOUD_REGION]: string;
+    [ConfigKey.HUAWEI_CLOUD_USERNAME]: string;
+    [ConfigKey.HUAWEI_CLOUD_PASSWORD]: string;
+    [ConfigKey.HUAWEI_CLOUD_DOMAIN]: string;
+    [ConfigKey.CODEARTS_BASE_URL]: string;
+    [ConfigKey.PROJECT_ID]: string;
+    [ConfigKey.ROLE_ID]: string;
+};
+/**
+ * 部分配置映射（用于读取配置文件）
+ */
+export type PartialConfigMap = Partial<ConfigMap>;

package/dist/types/index.js

@@ -1,2 +1,58 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MUTABLE_CONFIG_KEYS = exports.IMMUTABLE_CONFIG_KEYS = exports.ConfigKey = exports.DefectAnalysisType = void 0;
+/**
+ * 缺陷技术分析选项枚举
+ * custom_field32（缺陷技术分析）字段的选项值枚举定义
+ */
+var DefectAnalysisType;
+(function (DefectAnalysisType) {
+    DefectAnalysisType["FUNCTION_IMPLEMENTATION"] = "\u529F\u80FD\u5B9E\u73B0\u95EE\u9898";
+    DefectAnalysisType["REQUIREMENT_CHANGE"] = "\u9700\u6C42\u53D8\u66F4\u95EE\u9898";
+    DefectAnalysisType["LEGACY_ISSUE"] = "\u5386\u53F2\u9057\u7559\u95EE\u9898";
+    DefectAnalysisType["CODE_LOGIC"] = "\u4EE3\u7801\u903B\u8F91\u95EE\u9898";
+    DefectAnalysisType["USER_INTERFACE"] = "\u7528\u6237\u754C\u9762\u95EE\u9898";
+    DefectAnalysisType["INTERFACE"] = "\u63A5\u53E3\u95EE\u9898";
+    DefectAnalysisType["DATA"] = "\u6570\u636E\u95EE\u9898";
+    DefectAnalysisType["PERFORMANCE"] = "\u6027\u80FD\u95EE\u9898";
+    DefectAnalysisType["ENVIRONMENT"] = "\u73AF\u5883\u95EE\u9898";
+    DefectAnalysisType["COMPATIBILITY"] = "\u517C\u5BB9\u6027\u95EE\u9898";
+    DefectAnalysisType["PRODUCT_DESIGN"] = "\u4EA7\u54C1\u8BBE\u8BA1\u95EE\u9898";
+    DefectAnalysisType["OPTIMIZATION_SUGGESTION"] = "\u4F18\u5316\u5EFA\u8BAE\u95EE\u9898";
+    DefectAnalysisType["TECH_REQUIREMENT_CHANGE"] = "\u6280\u672F\u5F15\u8D77\u7684\u9700\u6C42\u53D8\u66F4\u95EE\u9898";
+    DefectAnalysisType["USAGE_AND_CONFIG"] = "\u4F7F\u7528\u53CA\u914D\u7F6E\u95EE\u9898";
+    DefectAnalysisType["OTHER"] = "\u5176\u4ED6\u95EE\u9898";
+})(DefectAnalysisType || (exports.DefectAnalysisType = DefectAnalysisType = {}));
+/**
+ * 配置键枚举
+ * 用于类型安全的配置项访问
+ */
+var ConfigKey;
+(function (ConfigKey) {
+    // 不可变配置（只能通过 config 命令设置）
+    ConfigKey["HUAWEI_CLOUD_IAM_ENDPOINT"] = "HUAWEI_CLOUD_IAM_ENDPOINT";
+    ConfigKey["HUAWEI_CLOUD_REGION"] = "HUAWEI_CLOUD_REGION";
+    ConfigKey["HUAWEI_CLOUD_USERNAME"] = "HUAWEI_CLOUD_USERNAME";
+    ConfigKey["HUAWEI_CLOUD_PASSWORD"] = "HUAWEI_CLOUD_PASSWORD";
+    ConfigKey["HUAWEI_CLOUD_DOMAIN"] = "HUAWEI_CLOUD_DOMAIN";
+    ConfigKey["CODEARTS_BASE_URL"] = "CODEARTS_BASE_URL";
+    ConfigKey["PROJECT_ID"] = "PROJECT_ID";
+    // 可变配置（可以通过命令行参数覆盖）
+    ConfigKey["ROLE_ID"] = "ROLE_ID";
+})(ConfigKey || (exports.ConfigKey = ConfigKey = {}));
+/**
+ * 不可变配置键（只能通过 config 命令设置）
+ */
+exports.IMMUTABLE_CONFIG_KEYS = [
+    ConfigKey.HUAWEI_CLOUD_IAM_ENDPOINT,
+    ConfigKey.HUAWEI_CLOUD_REGION,
+    ConfigKey.HUAWEI_CLOUD_USERNAME,
+    ConfigKey.HUAWEI_CLOUD_PASSWORD,
+    ConfigKey.HUAWEI_CLOUD_DOMAIN,
+    ConfigKey.CODEARTS_BASE_URL,
+    ConfigKey.PROJECT_ID,
+];
+/**
+ * 可变配置键（可以通过命令行参数覆盖）
+ */
+exports.MUTABLE_CONFIG_KEYS = [ConfigKey.ROLE_ID];

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

@@ -1,13 +1,27 @@
-import { HuaweiCloudConfig } from '../types';
+import { HuaweiCloudConfig, PartialConfigMap } from '../types';
+/**
+ * 获取全局配置文件路径
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * 检查全局配置文件是否存在
+ */
+export declare function globalConfigExists(): boolean;
+/**
+ * 读取全局配置
+ */
+export declare function readGlobalConfig(): PartialConfigMap;
+/**
+ * 写入全局配置
+ * 支持动态配置项，自动按分组组织配置文件
+ */
+export declare function writeGlobalConfig(config: PartialConfigMap): void;
+/**
+ * 删除全局配置
+ */
+export declare function deleteGlobalConfig(): void;
 export interface CliOptions {
-    projectId?: string;
     roleId?: string;
-    username?: string;
-    password?: string;
-    domain?: string;
-    region?: string;
-    iamEndpoint?: string;
-    codeartsUrl?: string;
 }
 export interface LoadedConfig {
     projectId: string;
@@ -15,8 +29,13 @@ export interface LoadedConfig {
     config: HuaweiCloudConfig;
 }
 /**
- * 加载配置，优先级：命令行参数 > 当前目录 .env > 全局配置 > 默认值
+ * 加载配置，优先级：命令行参数 > 全局配置
  * @param cliOptions 命令行选项
  * @returns 加载的配置
  */
 export declare function loadConfig(cliOptions?: CliOptions): LoadedConfig;
+/**
+ * 获取最终合并后的配置（用于显示）
+ * @returns 合并后的配置映射
+ */
+export declare function getConfig(): PartialConfigMap;