@hecom/codearts 0.3.1 → 0.4.0

package/README.md

@@ -31,7 +31,7 @@ npx @hecom/codearts bug-rate "迭代1,迭代2"
 ### 3. 更新配置
 
 ```bash
-# 更新全局配置
+# 更新配置文件
 npx @hecom/codearts config
 
 # 单独更新角色配置

package/dist/bin/cli.js

@@ -40,6 +40,7 @@ const path = __importStar(require("path"));
 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 fix_command_1 = require("../commands/fix.command");
 const work_hour_command_1 = require("../commands/work-hour.command");
 const config_loader_1 = require("../utils/config-loader");
 const console_1 = require("../utils/console");
@@ -57,7 +58,7 @@ program
 // config 命令 - 交互式配置向导
 const configCmd = program
     .command('config')
-    .description('交互式配置向导，引导用户创建或更新全局配置文件')
+    .description('交互式配置向导，引导用户创建或更新配置文件')
     .action(async () => {
     (0, console_1.showLogo)();
     await (0, config_command_1.configCommand)();
@@ -85,7 +86,7 @@ availableConfigs.forEach((configItem) => {
 // daily 命令
 program
     .command('daily [date]')
-    .description('每日工时统计（默认日期为当天）')
+    .description('每日工时统计（默认日期为当天），日期格式：YYYY-MM-DD')
     .option('-r, --report', '显示总结报告', false)
     .action(async (date, options, command) => {
     const cliOptions = { ...command.parent.opts(), report: options.report };
@@ -95,7 +96,7 @@ program
 // work-hour 命令
 program
     .command('work-hour [year]')
-    .description('年度工时统计（默认当前年份）')
+    .description('年度工时统计（默认当前年份），年份格式：YYYY')
     .action(async (year, options, command) => {
     const cliOptions = command.parent.opts();
     logger_1.logger.setOutputFormat(cliOptions.output);
@@ -110,13 +111,22 @@ program
     logger_1.logger.setOutputFormat(cliOptions.output);
     await (0, bug_command_1.bugCommand)(cliOptions);
 });
+// fix 命令
+program
+    .command('fix')
+    .description('交互式修复 bug，填写相关信息')
+    .action(async (options, command) => {
+    const cliOptions = command.parent.opts();
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, fix_command_1.fixCommand)(cliOptions);
+});
 // 检查配置并自动执行 config 命令
 async function checkConfigAndRun() {
     const args = process.argv.slice(2);
     // 如果没有参数（直接执行 codearts），检测配置
     if (args.length === 0) {
         (0, console_1.showLogo)();
-        // 检查是否有全局配置
+        // 检查是否有配置文件
         const hasConfig = (0, config_loader_1.configExists)();
         if (!hasConfig) {
             // 没有配置，自动执行 config 命令

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

@@ -10,7 +10,7 @@ interface ProjectConfigItem {
 }
 /**
  * 交互式配置向导命令
- * 引导用户创建或更新全局配置文件
+ * 引导用户创建或更新配置文件
  */
 export declare function configCommand(): Promise<void>;
 /**

package/dist/commands/config.command.js

@@ -139,7 +139,7 @@ async function inputPassword() {
 }
 /**
  * 交互式配置向导命令
- * 引导用户创建或更新全局配置文件
+ * 引导用户创建或更新配置文件
  */
 async function configCommand() {
     logger_1.logger.info('欢迎使用 Hecom CodeArts 配置向导');
@@ -149,7 +149,7 @@ async function configCommand() {
     const existingConfig = (0, config_loader_1.configExists)() ? (0, config_loader_1.readConfig)() : {};
     if ((0, config_loader_1.configExists)()) {
         const overwrite = await (0, prompts_1.confirm)({
-            message: '检测到已存在全局配置，是否覆盖？',
+            message: '检测到已存在配置文件，是否覆盖？',
             default: true,
         });
         if (!overwrite) {
@@ -188,9 +188,9 @@ async function configCommand() {
                 validate: (inputValue) => (inputValue.trim() ? true : 'CodeArts API 地址不能为空'),
             }),
             domain: await (0, prompts_1.input)({
-                message: '华为云账号名:',
+                message: '租户名/原华为云账号:',
                 default: existingConfig[types_1.ConfigKey.HUAWEI_CLOUD_DOMAIN] || '',
-                validate: (inputValue) => (inputValue.trim() ? true : '华为云账号名不能为空'),
+                validate: (inputValue) => inputValue.trim() ? true : '租户名/原华为云账号不能为空',
             }),
             username: await (0, prompts_1.input)({
                 message: 'IAM 用户名:',
@@ -308,7 +308,7 @@ async function configCommand() {
     };
     try {
         (0, config_loader_1.writeConfig)(finalConfig);
-        logger_1.logger.success('\n✅ 全局配置已成功保存');
+        logger_1.logger.success('\n✅ 配置完成！');
         logger_1.logger.info(`配置文件位置: ${(0, config_loader_1.getConfigPath)()}`);
         logger_1.logger.info('\n提示：配置文件包含敏感信息，请妥善保管。');
     }
@@ -324,7 +324,7 @@ async function configCommand() {
 async function updateProjectConfigCommand(configKey) {
     // 检查配置文件是否存在
     if (!(0, config_loader_1.configExists)()) {
-        logger_1.logger.error('\n❌ 全局配置文件不存在，请先运行 `npx @hecom/codearts config` 创建配置。');
+        logger_1.logger.error('\n❌ 配置文件不存在，请先运行 `npx @hecom/codearts config` 创建配置。');
         process.exit(1);
     }
     // 查找对应的配置项

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

@@ -0,0 +1,6 @@
+import { CliOptions } from '../utils/config-loader';
+/**
+ * Fix 命令：交互式修复 bug，填写缺陷分析信息
+ * @param cliOptions 命令行选项
+ */
+export declare function fixCommand(cliOptions?: CliOptions): Promise<void>;

package/dist/commands/fix.command.js

@@ -0,0 +1,220 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixCommand = fixCommand;
+const prompts_1 = require("@inquirer/prompts");
+const ora_1 = __importDefault(require("ora"));
+const business_service_1 = require("../services/business.service");
+const types_1 = require("../types");
+const config_loader_1 = require("../utils/config-loader");
+const console_1 = require("../utils/console");
+const logger_1 = require("../utils/logger");
+/**
+ * Fix 命令：交互式修复 bug，填写缺陷分析信息
+ * @param cliOptions 命令行选项
+ */
+async function fixCommand(cliOptions) {
+    try {
+        // Step 1: 加载配置
+        const { projectId, config } = (0, config_loader_1.loadConfig)(cliOptions);
+        const businessService = new business_service_1.BusinessService(config);
+        if (!projectId) {
+            logger_1.logger.error('项目 ID 未配置，请先执行 codearts config');
+            return;
+        }
+        // Step 2: 加载 bug 列表和自定义字段选项
+        const spinner = (0, ora_1.default)('正在加载数据...').start();
+        let bugList;
+        let customFieldOptions;
+        try {
+            bugList = await businessService.getCurrentUserBugs(projectId);
+            customFieldOptions = await businessService.getCustomFieldOptions(projectId, [
+                types_1.CustomFieldId.DEFECT_TECHNICAL_ANALYSIS,
+                types_1.CustomFieldId.INTRODUCTION_PHASE,
+            ]);
+            spinner.succeed('数据加载完成');
+        }
+        catch (error) {
+            spinner.fail('数据加载失败');
+            logger_1.logger.error(`${String(error)}`);
+            return;
+        }
+        // Step 3: 检查 bug 列表是否为空
+        if (bugList.length === 0) {
+            logger_1.logger.warn('当前用户没有分配的 bug');
+            return;
+        }
+        // Step 4: 让用户选择 bug
+        const selectedBug = await selectBug(bugList);
+        if (!selectedBug) {
+            logger_1.logger.info('操作取消');
+            return;
+        }
+        // Step 5: 填写缺陷分析信息
+        const bugFixData = {};
+        // 5.1: 选择缺陷技术分析（必填）
+        const defectAnalysisOptions = customFieldOptions[types_1.CustomFieldId.DEFECT_TECHNICAL_ANALYSIS] || [];
+        if (defectAnalysisOptions.length === 0) {
+            logger_1.logger.error('无法获取缺陷技术分析选项');
+            return;
+        }
+        bugFixData.defectAnalysis = await (0, prompts_1.select)({
+            message: '请选择缺陷技术分析（必填）',
+            choices: defectAnalysisOptions.map((option) => ({
+                name: option,
+                value: option,
+            })),
+        });
+        // 5.2: 填写问题原因及解决办法（可选）
+        const problemReason = await (0, prompts_1.input)({
+            message: '请输入问题原因及解决办法（可选，留空跳过）',
+        });
+        if (problemReason.trim()) {
+            bugFixData.problemReason = problemReason;
+        }
+        // 5.3: 填写影响范围（可选）
+        const impactScope = await (0, prompts_1.input)({
+            message: '请输入影响范围（可选，留空跳过）',
+        });
+        if (impactScope.trim()) {
+            bugFixData.impactScope = impactScope;
+        }
+        // Step 6: 检查是否为客户反馈 bug
+        const isCustomerFeedback = checkIsCustomerFeedback(selectedBug);
+        if (isCustomerFeedback) {
+            // 6.1: 选择引入阶段（必填）
+            const introductionPhaseOptions = customFieldOptions[types_1.CustomFieldId.INTRODUCTION_PHASE] || [];
+            if (introductionPhaseOptions.length === 0) {
+                logger_1.logger.error('无法获取引入阶段选项');
+                return;
+            }
+            bugFixData.introductionStage = await (0, prompts_1.select)({
+                message: '请选择引入阶段（必填）',
+                choices: introductionPhaseOptions
+                    .sort()
+                    .reverse()
+                    .map((option) => ({
+                    name: option,
+                    value: option,
+                })),
+            });
+            // 6.2: 输入发布时间（必填）
+            let releaseDate;
+            let validDate = false;
+            while (!validDate) {
+                releaseDate = await (0, prompts_1.input)({
+                    message: '请输入发布时间（必填，格式：YYYY/M/D）',
+                    validate: (value) => {
+                        if (!value) {
+                            return '发布时间不能为空';
+                        }
+                        const dateRegex = /^\d{4}\/\d{1,2}\/\d{1,2}$/;
+                        if (!dateRegex.test(value)) {
+                            return '日期格式不正确，请使用 YYYY/M/D 格式';
+                        }
+                        const date = new Date(value);
+                        if (isNaN(date.getTime())) {
+                            return '请输入有效的日期';
+                        }
+                        return true;
+                    },
+                });
+                validDate = true;
+                bugFixData.releaseDate = releaseDate;
+            }
+        }
+        // Step 7: 确认并提交
+        const confirmed = await showSummaryAndConfirm(selectedBug, bugFixData, isCustomerFeedback);
+        if (!confirmed) {
+            logger_1.logger.info('操作已取消');
+            return;
+        }
+        // Step 8: 调用 API 更新 bug
+        const updateSpinner = (0, ora_1.default)('正在保存缺陷信息...').start();
+        try {
+            await businessService.fixBug(projectId, selectedBug, bugFixData);
+            updateSpinner.succeed('缺陷信息保存成功！');
+            logger_1.logger.info(`\nBug 链接：${(0, console_1.issueLink)(projectId, String(selectedBug.id))}`);
+            // Step 9: 询问是否继续修复
+            const continueIterate = await (0, prompts_1.confirm)({
+                message: '是否继续修复？',
+                default: false,
+            });
+            if (continueIterate) {
+                await fixCommand(cliOptions);
+            }
+        }
+        catch (error) {
+            updateSpinner.fail('保存失败');
+            logger_1.logger.error(`${String(error)}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'ExitPromptError') {
+            logger_1.logger.info('操作取消');
+        }
+        else {
+            logger_1.logger.error(`执行 fix 命令失败: ${String(error)}`);
+        }
+    }
+}
+/**
+ * 让用户选择一个 bug
+ * @param bugList bug 列表
+ * @returns 选中的 bug，或 null 如果用户取消
+ */
+async function selectBug(bugList) {
+    const bugChoices = bugList.map((bug) => {
+        const statusName = bug.status?.name || '未知状态';
+        const name = bug.name.length > 40 ? `${bug.name.slice(0, 47)}...` : bug.name;
+        const label = `[${statusName}] ${name}`;
+        return {
+            name: label,
+            value: bug,
+        };
+    });
+    const selectedBug = await (0, prompts_1.select)({
+        message: '请选择要修复的 bug',
+        choices: bugChoices,
+        pageSize: 10,
+    });
+    return selectedBug || null;
+}
+/**
+ * 检查 bug 是否为客户反馈类型
+ * @param bug bug 工作项
+ * @returns 是否为客户反馈
+ */
+function checkIsCustomerFeedback(bug) {
+    const customFields = bug.new_custom_fields || [];
+    const defectTypeField = customFields.find((field) => field?.custom_field === types_1.CustomFieldId.DEFECT_TYPE || field?.field_name === '缺陷类型');
+    const defectType = defectTypeField?.value || '';
+    return defectType === '客户反馈';
+}
+/**
+ * 显示总结信息并确认提交
+ * @param bug 选中的 bug
+ * @param bugFixData 填写的缺陷信息
+ * @param isCustomerFeedback 是否为客户反馈
+ * @returns 用户是否确认提交
+ */
+async function showSummaryAndConfirm(bug, bugFixData, isCustomerFeedback) {
+    logger_1.logger.info('\n========== 填写信息总结 ==========\n');
+    logger_1.logger.info(`Bug ID: #${bug.id}`);
+    logger_1.logger.info(`Bug 标题: ${bug.name}`);
+    logger_1.logger.info(`缺陷技术分析: ${bugFixData.defectAnalysis || '未填写'}`);
+    logger_1.logger.info(`问题原因: ${bugFixData.problemReason || '未填写'}`);
+    logger_1.logger.info(`影响范围: ${bugFixData.impactScope || '未填写'}`);
+    if (isCustomerFeedback) {
+        logger_1.logger.info(`引入阶段: ${bugFixData.introductionStage || '未填写'}`);
+        logger_1.logger.info(`发布时间: ${bugFixData.releaseDate || '未填写'}`);
+    }
+    logger_1.logger.info('\n==================================\n');
+    const confirmed = await (0, prompts_1.confirm)({
+        message: '确认提交以上信息？',
+        default: true,
+    });
+    return confirmed;
+}

package/dist/commands/index.d.ts

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

package/dist/commands/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bugCommand = exports.configCommand = exports.workHourCommand = exports.dailyCommand = void 0;
+exports.fixCommand = 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");
@@ -9,3 +9,5 @@ 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; } });
+var fix_command_1 = require("./fix.command");
+Object.defineProperty(exports, "fixCommand", { enumerable: true, get: function () { return fix_command_1.fixCommand; } });

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

@@ -1,4 +1,4 @@
-import { ApiResponse, CachedToken, HuaweiCloudConfig, ListChildIssuesV2Response, ListChildIssuesV4Response, ListIssuesV4Request, ListIssuesV4Response, ListProjectIterationsV4Request, ListProjectIterationsV4Response, ProjectListResponse, ProjectMemberListResponse, ProjectMemberQueryParams, ProjectQueryParams, ShowProjectWorkHoursRequest, ShowProjectWorkHoursResponse } from '../types';
+import { AddIssueNotesRequest, AddIssueNotesResponse, ApiResponse, CachedToken, CurrentUserInfo, GetCustomFieldsResponse, HuaweiCloudConfig, ListChildIssuesV2Response, ListChildIssuesV4Response, ListIssuesV4Request, ListIssuesV4Response, ListProjectIterationsV4Request, ListProjectIterationsV4Response, ProjectListResponse, ProjectMemberListResponse, ProjectMemberQueryParams, ProjectQueryParams, ShowProjectWorkHoursRequest, ShowProjectWorkHoursResponse, UpdateIssueRequest } from '../types';
 /**
  * 华为云CodeArts API服务类
  * 支持IAM Token认证和CodeArts API调用
@@ -71,10 +71,14 @@ export declare class ApiService {
      * 创建工作项
      */
     createIssue(projectId: string, issueData: unknown): Promise<ApiResponse<unknown>>;
+    /**
+     * 工作项添加评论
+     */
+    addIssueNotes(params: AddIssueNotesRequest): Promise<ApiResponse<AddIssueNotesResponse>>;
     /**
      * 更新工作项
      */
-    updateIssue(projectId: string, issueId: string, issueData: unknown): Promise<ApiResponse<unknown>>;
+    updateIssue(projectId: string, issueId: string, issueData: UpdateIssueRequest): Promise<ApiResponse<unknown>>;
     /**
      * 删除工作项
      */
@@ -91,10 +95,18 @@ export declare class ApiService {
      * 获取项目成员列表
      */
     getMembers(projectId: string, params?: ProjectMemberQueryParams): Promise<ApiResponse<ProjectMemberListResponse>>;
+    /**
+     * 获取当前用户信息
+     */
+    showCurUserInfo(): Promise<ApiResponse<CurrentUserInfo>>;
     /**
      * 按用户查询工时（单项目）
      */
     showProjectWorkHours(projectId: string, params?: ShowProjectWorkHoursRequest): Promise<ApiResponse<ShowProjectWorkHoursResponse>>;
+    /**
+     * 获取自定义字段信息
+     */
+    getCustomFields(projectId: string, customFieldIds: string[]): Promise<ApiResponse<GetCustomFieldsResponse>>;
     /**
      * 获取当前Token信息（用于调试）
      */

package/dist/services/api.service.js

@@ -347,6 +347,15 @@ class ApiService {
             data: issueData,
         });
     }
+    /**
+     * 工作项添加评论
+     */
+    async addIssueNotes(params) {
+        return this.request('/v2/issues/update-issue-notes', {
+            method: 'POST',
+            data: params,
+        });
+    }
     /**
      * 更新工作项
      */
@@ -394,6 +403,14 @@ class ApiService {
             },
         });
     }
+    /**
+     * 获取当前用户信息
+     */
+    async showCurUserInfo() {
+        return this.request('/v4/user', {
+            method: 'GET',
+        });
+    }
     /**
      * 按用户查询工时（单项目）
      */
@@ -407,6 +424,17 @@ class ApiService {
             },
         });
     }
+    /**
+     * 获取自定义字段信息
+     */
+    async getCustomFields(projectId, customFieldIds) {
+        return this.request(`/v4/projects/${projectId}/issues/custom-fields`, {
+            method: 'POST',
+            data: {
+                custom_fields: customFieldIds,
+            },
+        });
+    }
     /**
      * 获取当前Token信息（用于调试）
      */

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的底层调用
@@ -43,6 +43,7 @@ export declare class BusinessService {
      * @returns Task类型的工作项列表
      */
     getWorkloadByIterationsAndUsers(projectId: string, iterationIds: number[], userIds: string[]): Promise<IssueItem[]>;
+    addIssueNote(projectId: string, issueId: number, content: string): Promise<unknown>;
     /**
      * 统计工作项进度信息
      * @param issues 工作项列表
@@ -101,4 +102,35 @@ 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[]>;
+    /**
+     * 批量获取自定义字段的选项
+     * @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,
@@ -134,6 +134,17 @@ 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 工作项列表
@@ -157,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;
             // 累计总工时
@@ -268,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,
@@ -340,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,
@@ -451,5 +464,186 @@ 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;
+    }
+    /**
+     * 批量获取自定义字段的选项
+     * @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,31 @@ export interface IssueStatus {
     id: number;
     name: string;
 }
+export declare enum IssueStatusId {
+    NEW_REQUIREMENT = 1,// 新需求
+    IN_PROGRESS = 2,// 进行中
+    RESOLVED = 3,// 已解决
+    TESTING = 4,// 测试中
+    CLOSED = 5,// 已关闭
+    PRODUCT_DESIGN = 7,// 产品设计
+    REVIEW_READY = 8,// 可评审
+    DEV_POOL = 9,// 开发池
+    DEVELOPING = 10,// 开发中
+    TEST_READY = 11,// 可提测
+    REOPENED = 15,// 重新打开
+    NEW_ISSUE = 17
+}
 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 +352,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 +487,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（缺陷技术分析）字段的选项值枚举定义
@@ -568,3 +634,43 @@ export interface ConsoleTotal<T> {
     totalMap: [string, string | (() => string)][];
     list: T[];
 }
+export interface AddIssueNotesResponse {
+    result: AddIssueNotesResult;
+    status: string;
+}
+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,31 @@
 "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["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["REOPENED"] = 15] = "REOPENED";
+    IssueStatusId[IssueStatusId["NEW_ISSUE"] = 17] = "NEW_ISSUE";
+})(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 +33,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,23 +1,23 @@
 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 {
@@ -32,7 +32,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.1",
+  "version": "0.4.0",
   "description": "华为云 CodeArts 统计分析工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",