@hecom/codearts 0.1.0 → 0.2.0

package/dist/bin/cli.js

@@ -38,40 +38,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const dotenv_1 = __importDefault(require("dotenv"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const dotenv_1 = __importDefault(require("dotenv"));
-const daily_command_1 = require("../commands/daily.command");
+const bug_command_1 = require("../commands/bug.command");
 const config_command_1 = require("../commands/config.command");
+const daily_command_1 = require("../commands/daily.command");
 const work_hour_command_1 = require("../commands/work-hour.command");
 const global_config_1 = require("../utils/global-config");
 // 读取 package.json 中的版本号
 const packageJsonPath = path.join(__dirname, '../../package.json');
 const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-const version = packageJson.version || '0.0.1';
+const version = packageJson.version;
 const program = new commander_1.Command();
-program.name('codearts').description('华为云 CodeArts API 工时统计分析工具').version(version);
+program.name('codearts').description('华为云 CodeArts 统计分析工具').version(version);
 // 全局选项（环境变量覆盖）
-program
-    .option('--project-id <id>', '项目 ID')
-    .option('--role-id <ids>', '角色 ID（支持逗号分隔，如: 1,2,3）')
-    .option('--username <username>', 'IAM 用户名')
-    .option('--password <password>', 'IAM 密码（建议使用 .env 文件）')
-    .option('--domain <domain>', '华为云账号名')
-    .option('--region <region>', '华为云区域')
-    .option('--iam-endpoint <url>', 'IAM 认证端点')
-    .option('--codearts-url <url>', 'CodeArts API 地址');
+program.option('--role-id <ids>', '角色 ID（支持逗号分隔，如: 1,2,3），优先级高于环境变量 ROLE_ID');
 // config 命令 - 交互式配置向导
 program
     .command('config')
-    .description('交互式配置向导\n\n引导用户创建或更新全局配置文件')
+    .description('交互式配置向导，引导用户创建或更新全局配置文件\n\n')
     .action(async () => {
     await (0, config_command_1.configCommand)();
 });
 // daily 命令
 program
     .command('daily [date]')
-    .description('生成日报统计\n\n示例:\n  $ codearts daily\n  $ codearts daily 2026-01-15\n  $ codearts daily --project-id abc123 --role-id 1,2')
+    .description('生成日报统计\n\n示例:\n  $ codearts daily\n  $ codearts daily 2026-01-15\n')
     .action(async (date) => {
     const opts = program.opts();
     await (0, daily_command_1.dailyCommand)(date, opts);
@@ -79,36 +72,19 @@ program
 // work-hour 命令
 program
     .command('work-hour [year]')
-    .description('生成年度工时统计\n\n示例:\n  $ codearts work-hour\n  $ codearts work-hour 2025\n  $ codearts work-hour 2025 --role-id 1,2,3')
+    .description('生成年度工时统计\n\n示例:\n  $ codearts work-hour\n  $ codearts work-hour 2025\n')
     .action(async (year) => {
     const opts = program.opts();
     await (0, work_hour_command_1.workHourCommand)(year, opts);
 });
-// 添加帮助信息
-program.addHelpText('after', `
-环境变量:
-  命令行参数优先于环境变量。可通过 .env 文件配置以下变量:
-
-  HUAWEI_CLOUD_IAM_ENDPOINT   IAM 认证端点
-  HUAWEI_CLOUD_REGION         华为云区域
-  HUAWEI_CLOUD_USERNAME       IAM 用户名
-  HUAWEI_CLOUD_PASSWORD       IAM 密码
-  HUAWEI_CLOUD_DOMAIN         华为云账号名
-  CODEARTS_BASE_URL           CodeArts API 地址
-  PROJECT_ID                  项目 ID
-  ROLE_ID                     角色 ID（支持逗号分隔）
-
-配置优先级:
-  命令行参数 > 环境变量 > 默认值
-
-快速开始:
-  1. 运行配置向导: codearts config
-  2. 生成日报: codearts daily
-  3. 生成年度工时统计: codearts work-hour
-
-更多信息:
-  https://github.com/hecom-rn/hecom-codearts
-`);
+// bug-rate 命令
+program
+    .command('bug-rate <iterations>')
+    .description('按迭代统计产品缺陷率，支持多个迭代（逗号分隔）\n\n示例:\n  $ codearts bug-rate "迭代1,迭代2"\n')
+    .action(async (iterations) => {
+    const opts = program.opts();
+    await (0, bug_command_1.bugCommand)(iterations, opts);
+});
 // 检查配置并自动执行 config 命令
 async function checkConfigAndRun() {
     const args = process.argv.slice(2);

package/dist/commands/bug.command.d.ts

@@ -0,0 +1,7 @@
+import { CliOptions } from '../utils/config-loader';
+/**
+ * bug 命令入口
+ * @param iterationTitlesStr 迭代标题（支持逗号、分号、空格、竖线、顿号等分隔符）
+ * @param cliOptions CLI 选项
+ */
+export declare function bugCommand(iterationTitlesStr: string, cliOptions?: CliOptions): Promise<void>;

package/dist/commands/bug.command.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bugCommand = bugCommand;
+const business_service_1 = require("../services/business.service");
+const types_1 = require("../types");
+const config_loader_1 = require("../utils/config-loader");
+/**
+ * 判断 Bug 是否属于需求变更或产品设计问题
+ * @param bug Bug 工作项
+ * @returns 是否属于需求变更或产品设计问题
+ */
+function isRequirementOrDesignBug(bug) {
+    // 检查 customValueNew（v2 版本的自定义字段，是对象格式）
+    const defectAnalysisValue = bug.customValueNew?.custom_field32;
+    if (defectAnalysisValue) {
+        return (defectAnalysisValue === types_1.DefectAnalysisType.REQUIREMENT_CHANGE ||
+            defectAnalysisValue === types_1.DefectAnalysisType.PRODUCT_DESIGN);
+    }
+    return false;
+}
+/**
+ * 生成 Bug 统计报告
+ */
+async function generateBugReport(businessService, projectId, roleIds, iterationTitles) {
+    console.log(`\n正在统计迭代中的 Bug 数据...`);
+    console.log(`目标迭代: ${iterationTitles.join(', ')}`);
+    console.log(`角色过滤: ${roleIds.length > 0 ? roleIds.join(', ') : '无（保留所有人）'}`);
+    console.log(`统计规则: 统计所有 Bug，同时标记"需求变更问题"和"产品设计问题"`);
+    // Step 1: 获取指定角色的成员列表（如果启用了角色过滤）
+    const targetMemberIds = new Set();
+    if (roleIds.length > 0) {
+        for (const roleId of roleIds) {
+            const members = await businessService.getMembersByRoleId(projectId, roleId);
+            members.forEach((member) => targetMemberIds.add(member.user_num_id));
+        }
+        console.log(`\n目标角色成员数: ${targetMemberIds.size} 人`);
+    }
+    else {
+        console.log(`\n角色过滤: 已禁用，将统计所有人`);
+    }
+    // Step 2: 获取所有 Story
+    const stories = await businessService.getStoriesByIterationTitles(projectId, iterationTitles);
+    if (stories.length === 0) {
+        console.log('未找到任何 Story');
+        return;
+    }
+    // Step 3: 过滤出目标角色成员处理的 Story（如果启用了角色过滤）
+    const filteredStories = roleIds.length > 0
+        ? stories.filter((story) => {
+            const assignedUserId = story.assigned_user?.id;
+            return assignedUserId && targetMemberIds.has(assignedUserId);
+        })
+        : stories;
+    if (filteredStories.length === 0) {
+        console.log(roleIds.length > 0 ? '未找到目标角色成员处理的 Story' : '未找到任何 Story');
+        return;
+    }
+    if (roleIds.length > 0) {
+        console.log(`\n找到 ${stories.length} 个 Story，其中 ${filteredStories.length} 个由目标角色成员处理，正在统计 Bug...`);
+    }
+    else {
+        console.log(`\n找到 ${filteredStories.length} 个 Story，正在统计 Bug...`);
+    }
+    // Step 4: 获取每个 Story 的子工作项（Bug）
+    const bugStatsMap = new Map();
+    for (const story of filteredStories) {
+        const childIssues = await businessService.getChildIssues(projectId, String(story.id));
+        // 过滤出所有 Bug 类型的子工作项（tracker_id = 3）
+        const allBugs = childIssues.filter((issue) => issue.tracker.id === 3);
+        if (allBugs.length === 0) {
+            continue;
+        }
+        // 统计产品问题 Bug（需求变更 + 产品设计）
+        const productBugs = allBugs.filter((bug) => isRequirementOrDesignBug(bug));
+        // Step 3: 按 Story 的处理人统计 Bug
+        const assignedUserId = story.assigned_user?.id;
+        const assignedUserName = story.assigned_user?.nick_name;
+        if (!assignedUserId) {
+            continue;
+        }
+        if (!bugStatsMap.has(assignedUserId)) {
+            bugStatsMap.set(assignedUserId, {
+                assignedUser: assignedUserName,
+                userId: assignedUserId,
+                totalBugCount: 0,
+                productBugCount: 0,
+                productDefectRate: 0,
+                stories: [],
+            });
+        }
+        const userStats = bugStatsMap.get(assignedUserId);
+        userStats.totalBugCount += allBugs.length;
+        userStats.productBugCount += productBugs.length;
+        userStats.stories.push({
+            storyName: story.name,
+            storyId: story.id,
+            totalBugCount: allBugs.length,
+            productBugCount: productBugs.length,
+        });
+    }
+    // 计算每个人的产品缺陷率
+    bugStatsMap.forEach((stats) => {
+        stats.productDefectRate =
+            stats.totalBugCount > 0 ? (stats.productBugCount / stats.totalBugCount) * 100 : 0;
+    });
+    // Step 4: 输出统计结果
+    console.log('\n');
+    console.log('='.repeat(80));
+    console.log(`Bug 统计报告 [${iterationTitles.join(', ')}]`);
+    console.log('='.repeat(80));
+    console.log('');
+    if (bugStatsMap.size === 0) {
+        console.log('未找到任何 Bug');
+        return;
+    }
+    // 按总 Bug 数量降序排列
+    const sortedStats = Array.from(bugStatsMap.values()).sort((a, b) => b.totalBugCount - a.totalBugCount);
+    let totalBugs = 0;
+    let totalProductBugs = 0;
+    sortedStats.forEach((stats) => {
+        console.log(`\x1b[31m${stats.assignedUser}: 总 Bug ${stats.totalBugCount} 个 | 产品问题 ${stats.productBugCount} 个 | 产品缺陷率 ${stats.productDefectRate.toFixed(1)}%\x1b[0m`);
+        // 输出该用户的 Story 及其 Bug 数量
+        stats.stories.forEach((story) => {
+            console.log(`  - ${story.storyName} (总 ${story.totalBugCount} 个 Bug，其中产品问题 ${story.productBugCount} 个)`);
+        });
+        totalBugs += stats.totalBugCount;
+        totalProductBugs += stats.productBugCount;
+        console.log('');
+    });
+    const overallProductDefectRate = totalBugs > 0 ? (totalProductBugs / totalBugs) * 100 : 0;
+    console.log('='.repeat(80));
+    console.log(`总计: ${totalBugs} 个 Bug（产品问题 ${totalProductBugs} 个，产品缺陷率 ${overallProductDefectRate.toFixed(1)}%），涉及 ${sortedStats.length} 位处理人`);
+    console.log('='.repeat(80));
+}
+/**
+ * bug 命令入口
+ * @param iterationTitlesStr 迭代标题（支持逗号、分号、空格、竖线、顿号等分隔符）
+ * @param cliOptions CLI 选项
+ */
+async function bugCommand(iterationTitlesStr, cliOptions = {}) {
+    try {
+        if (!iterationTitlesStr || iterationTitlesStr.trim() === '') {
+            throw new Error('请指定至少一个迭代标题\n示例: codearts bug "迭代1,迭代2" 或 "迭代1 迭代2" 或 "迭代1;迭代2"');
+        }
+        // 解析迭代标题（支持多种分隔符：逗号、分号、空格、竖线、顿号等）
+        const iterationTitles = iterationTitlesStr
+            .split(/[,，;；|\s、]+/)
+            .map((title) => title.trim())
+            .filter((title) => title.length > 0);
+        const { projectId, roleIds, config } = (0, config_loader_1.loadConfig)(cliOptions);
+        const businessService = new business_service_1.BusinessService(config);
+        await generateBugReport(businessService, projectId, roleIds, iterationTitles);
+    }
+    catch (error) {
+        console.error('执行过程中发生错误:', error);
+        process.exit(1);
+    }
+}

package/dist/commands/index.d.ts

@@ -1,3 +1,4 @@
 export { dailyCommand } from './daily.command';
 export { workHourCommand } from './work-hour.command';
 export { configCommand } from './config.command';
+export { bugCommand } from './bug.command';

package/dist/commands/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.configCommand = exports.workHourCommand = exports.dailyCommand = void 0;
+exports.bugCommand = exports.configCommand = exports.workHourCommand = exports.dailyCommand = void 0;
 var daily_command_1 = require("./daily.command");
 Object.defineProperty(exports, "dailyCommand", { enumerable: true, get: function () { return daily_command_1.dailyCommand; } });
 var work_hour_command_1 = require("./work-hour.command");
 Object.defineProperty(exports, "workHourCommand", { enumerable: true, get: function () { return work_hour_command_1.workHourCommand; } });
 var config_command_1 = require("./config.command");
 Object.defineProperty(exports, "configCommand", { enumerable: true, get: function () { return config_command_1.configCommand; } });
+var bug_command_1 = require("./bug.command");
+Object.defineProperty(exports, "bugCommand", { enumerable: true, get: function () { return bug_command_1.bugCommand; } });

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

@@ -1,4 +1,4 @@
-import { AddIssueNotesRequest, AddIssueNotesResponse, ApiResponse, CachedToken, HuaweiCloudConfig, ListIssuesV4Request, ListIssuesV4Response, ListProjectIterationsV4Request, ListProjectIterationsV4Response, ProjectListResponse, ProjectMemberListResponse, ProjectMemberQueryParams, ProjectQueryParams, ShowProjectWorkHoursRequest, ShowProjectWorkHoursResponse } from '../types';
+import { ApiResponse, CachedToken, HuaweiCloudConfig, ListChildIssuesV2Response, ListIssuesV4Request, ListIssuesV4Response, ListProjectIterationsV4Request, ListProjectIterationsV4Response, ProjectListResponse, ProjectMemberListResponse, ProjectMemberQueryParams, ProjectQueryParams, ShowProjectWorkHoursRequest, ShowProjectWorkHoursResponse } from '../types';
 /**
  * 华为云CodeArts API服务类
  * 支持IAM Token认证和CodeArts API调用
@@ -55,6 +55,11 @@ export declare class ApiService {
      * 获取指定工作项的详细信息
      */
     getIssueById(projectId: string, issueId: string): Promise<ApiResponse<unknown>>;
+    /**
+     * 查询子工作项 (ListChildIssuesV4)
+     * 获取指定工作项的所有子工作项
+     */
+    getChildIssues(projectId: string, issueId: string, pageSize?: number, pageNo?: number): Promise<ApiResponse<ListChildIssuesV2Response>>;
     /**
      * 创建工作项
      */
@@ -83,10 +88,6 @@ export declare class ApiService {
      * 按用户查询工时（单项目）
      */
     showProjectWorkHours(projectId: string, params?: ShowProjectWorkHoursRequest): Promise<ApiResponse<ShowProjectWorkHoursResponse>>;
-    /**
-     * 工作项添加评论
-     */
-    addIssueNotes(params: AddIssueNotesRequest): Promise<ApiResponse<AddIssueNotesResponse>>;
     /**
      * 获取当前Token信息（用于调试）
      */

package/dist/services/api.service.js

@@ -310,6 +310,26 @@ class ApiService {
             method: 'GET',
         });
     }
+    /**
+     * 查询子工作项 (ListChildIssuesV4)
+     * 获取指定工作项的所有子工作项
+     */
+    async getChildIssues(projectId, issueId, pageSize = 100, pageNo = 1) {
+        // return this.request(`/v4/projects/${projectId}/issues/${issueId}/child`, {
+        //   method: 'GET',
+        // });
+        return this.request('/v2/issues/child-issue-list', {
+            method: 'POST',
+            data: {
+                parentId: issueId,
+                projectUUId: projectId,
+                queryType: 'basic',
+                subject: '',
+                pageSize,
+                pageNo,
+            },
+        });
+    }
     /**
      * 创建工作项
      */
@@ -379,15 +399,6 @@ class ApiService {
             },
         });
     }
-    /**
-     * 工作项添加评论
-     */
-    async addIssueNotes(params) {
-        return this.request('/v2/issues/update-issue-notes', {
-            method: 'POST',
-            data: params,
-        });
-    }
     /**
      * 获取当前Token信息（用于调试）
      */

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, WorkHourStats, WorkProgressStats } from '../types';
 import { ApiService } from './api.service';
 /**
  * 业务服务类
@@ -42,7 +42,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 +56,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 +79,11 @@ 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[]>;
 }

package/dist/services/business.service.js

@@ -103,17 +103,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 +199,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 +371,29 @@ 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.getChildIssues(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;
+    }
 }
 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;
@@ -338,124 +321,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"
 }
 /**
  * 用户工作项统计信息

package/dist/types/index.js

@@ -1,2 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+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 = {}));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hecom/codearts",
-  "version": "0.1.0",
-  "description": "从CodeArts获取日报信息",
+  "version": "0.2.0",
+  "description": "华为云 CodeArts 统计分析工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -17,7 +17,8 @@
     "build": "rm -rf dist && tsc && chmod +x bin/codearts",
     "test": "jest --passWithNoTests",
     "test:coverage": "jest --coverage --passWithNoTests",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "dev": "ts-node src/bin/cli.ts"
   },
   "keywords": [
     "huawei-cloud",
@@ -40,7 +41,7 @@
     "url": "https://github.com/hecom-rn/hecom-codearts/issues"
   },
   "engines": {
-    "node": ">=16.0.0",
+    "node": ">=23.0.0",
     "npm": ">=7.0.0"
   },
   "dependencies": {