@hecom/codearts 0.2.3 → 0.3.0

package/dist/commands/work-hour.command.js

@@ -1,9 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.workHourCommand = workHourCommand;
+const ora_1 = __importDefault(require("ora"));
 const holidays_1 = require("../config/holidays");
 const business_service_1 = require("../services/business.service");
 const config_loader_1 = require("../utils/config-loader");
+const console_1 = require("../utils/console");
 const csv_writer_1 = require("../utils/csv-writer");
 const logger_1 = require("../utils/logger");
 /**
@@ -16,30 +21,29 @@ function roundToTwo(num) {
  * 查询年度工时数据
  */
 async function queryWorkHourReportData(businessService, projectId, roleIds, targetYear) {
-    const allMembers = [];
+    const members = await businessService.getMembersByRoleIds(projectId, roleIds);
+    const userIds = members.map((member) => member.user_id);
+    const stats = await businessService.getAllWorkHourStats(projectId, userIds, `${targetYear}-01-01`, `${targetYear}-12-31`);
+    // 创建用户ID到成员信息的映射
+    const userIdToMember = new Map();
+    members.forEach((member) => {
+        userIdToMember.set(member.user_id, member);
+    });
     const allUserStats = [];
     const allTypes = new Set();
-    for (const roleId of roleIds) {
-        const roleMembers = await businessService.getMembersByRoleId(projectId, roleId);
-        if (roleMembers.length === 0) {
-            logger_1.logger.warn(`角色ID ${roleId} 未找到用户，跳过`);
-            continue;
-        }
-        const roleName = roleMembers[0].role_name;
-        allMembers.push(...roleMembers);
-        const roleUserIds = roleMembers.map((member) => member.user_id);
-        const stats = await businessService.getAllWorkHourStats(projectId, roleUserIds, `${targetYear}-01-01`, `${targetYear}-12-31`);
-        stats.userStats.forEach((userStat) => {
+    stats.userStats.forEach((userStat) => {
+        const member = userIdToMember.get(userStat.userId);
+        if (member) {
             allUserStats.push({
                 ...userStat,
-                roleName,
-                roleId,
+                roleName: member.role_name,
+                roleId: member.role_id,
             });
             userStat.domainStats.forEach((domainStat) => {
                 allTypes.add(domainStat.type);
             });
-        });
-    }
+        }
+    });
     allUserStats.sort((a, b) => {
         if (a.roleId !== b.roleId) {
             return a.roleId - b.roleId;
@@ -48,37 +52,10 @@ async function queryWorkHourReportData(businessService, projectId, roleIds, targ
     });
     const expectedWorkdays = (0, holidays_1.calculateExpectedWorkdays)(targetYear);
     const expectedHoursPerPerson = expectedWorkdays * 8;
-    const totalExpectedHours = expectedHoursPerPerson * allMembers.length;
+    const totalExpectedHours = expectedHoursPerPerson * members.length;
     const totalHours = roundToTwo(allUserStats.reduce((sum, userStat) => sum + userStat.totalHours, 0));
-    const totalEntries = allUserStats.reduce((sum, userStat) => sum + userStat.domainStats.reduce((s, d) => s + d.workHours.length, 0), 0);
     const userStatsData = [];
-    const roleSubtotals = [];
-    const typeTotals = {};
-    allTypes.forEach((type) => {
-        typeTotals[type] = 0;
-    });
-    let currentRoleId = null;
-    let currentRoleName = '';
-    const roleSubtotalStats = {};
-    allUserStats.forEach((userStat, index) => {
-        if (currentRoleId !== null && currentRoleId !== userStat.roleId) {
-            const subtotalDomainStats = {};
-            let subtotal = 0;
-            allTypes.forEach((type) => {
-                subtotalDomainStats[type] = roleSubtotalStats[type] || 0;
-                subtotal = roundToTwo(subtotal + (roleSubtotalStats[type] || 0));
-            });
-            roleSubtotals.push({
-                roleName: currentRoleName,
-                domainStats: subtotalDomainStats,
-                total: subtotal,
-            });
-            Object.keys(roleSubtotalStats).forEach((key) => {
-                roleSubtotalStats[key] = 0;
-            });
-        }
-        currentRoleId = userStat.roleId;
-        currentRoleName = userStat.roleName;
+    allUserStats.forEach((userStat) => {
         const domainStats = {};
         allTypes.forEach((type) => {
             domainStats[type] = 0;
@@ -87,94 +64,54 @@ async function queryWorkHourReportData(businessService, projectId, roleIds, targ
         userStat.domainStats.forEach((domainStat) => {
             domainStats[domainStat.type] = domainStat.totalHours;
             userTotal = roundToTwo(userTotal + domainStat.totalHours);
-            typeTotals[domainStat.type] = roundToTwo(typeTotals[domainStat.type] + domainStat.totalHours);
-            if (!roleSubtotalStats[domainStat.type]) {
-                roleSubtotalStats[domainStat.type] = 0;
-            }
-            roleSubtotalStats[domainStat.type] = roundToTwo(roleSubtotalStats[domainStat.type] + domainStat.totalHours);
         });
         userStatsData.push({
             userName: userStat.userName,
             roleName: userStat.roleName,
-            roleId: userStat.roleId,
             domainStats,
             total: userTotal,
         });
-        if (index === allUserStats.length - 1) {
-            const subtotalDomainStats = {};
-            let subtotal = 0;
-            allTypes.forEach((type) => {
-                subtotalDomainStats[type] = roleSubtotalStats[type] || 0;
-                subtotal = roundToTwo(subtotal + (roleSubtotalStats[type] || 0));
-            });
-            roleSubtotals.push({
-                roleName: currentRoleName,
-                domainStats: subtotalDomainStats,
-                total: subtotal,
-            });
-        }
-    });
-    const grandTotalDomainStats = {};
-    let grandTotal = 0;
-    allTypes.forEach((type) => {
-        grandTotalDomainStats[type] = typeTotals[type];
-        grandTotal = roundToTwo(grandTotal + typeTotals[type]);
     });
     return {
-        year: targetYear,
-        roleCount: roleIds.length,
-        memberCount: allMembers.length,
-        expectedWorkdays,
-        expectedHours: totalExpectedHours,
-        actualHours: totalHours,
-        completionRate: (totalHours / totalExpectedHours) * 100,
-        entryCount: totalEntries,
-        userStats: userStatsData,
-        roleSubtotals,
-        grandTotal: {
-            domainStats: grandTotalDomainStats,
-            total: grandTotal,
-        },
+        title: `${targetYear}年工时统计`,
+        roleNames: Array.from(new Set(members.map((m) => m.role_name))),
+        totalMap: [
+            ['统计人数', `${members.length} 人`],
+            ['应计工日', `${expectedWorkdays} 天`],
+            ['应计工时', `${totalExpectedHours} 小时`],
+            ['实际工时', `${totalHours} 小时`],
+            ['工时完成率', `${((totalHours / totalExpectedHours) * 100).toFixed(2)}%`],
+        ],
+        list: userStatsData,
     };
 }
 /**
  * 控制台输出工时统计
  */
 function outputConsole(data) {
-    logger_1.logger.info(`\n${data.year}年工时统计 [${data.roleSubtotals.map((r) => r.roleName).join(', ')}]`);
-    logger_1.logger.info('='.repeat(80));
-    logger_1.logger.info(`统计人数: ${data.memberCount} 人`);
-    logger_1.logger.info(`应计工作日: ${data.expectedWorkdays} 天`);
-    logger_1.logger.info(`应计工时: ${data.expectedHours} 小时`);
-    logger_1.logger.info(`实际工时: ${data.actualHours} 小时`);
-    logger_1.logger.info(`工时完成率: ${data.completionRate.toFixed(2)}%`);
-    logger_1.logger.info('='.repeat(80));
+    (0, console_1.consoleTotal)(data);
     // 构建表格数据
     const tableData = {};
-    data.userStats.forEach((userStat) => {
+    data.list.forEach((userStat) => {
         const row = {
             ...userStat.domainStats,
             合计: userStat.total,
         };
         tableData[userStat.userName] = row;
     });
-    // 添加总计行
-    tableData['总计'] = {
-        ...data.grandTotal.domainStats,
-        合计: data.grandTotal.total,
-    };
     logger_1.logger.table(tableData);
 }
 /**
  * CSV 文件输出
  */
-function outputCsv(data, targetYear) {
-    const domains = Object.keys(data.grandTotal.domainStats);
+function outputCsv(list, targetYear) {
+    const domains = Object.keys(list[0].domainStats);
     const csvLines = [];
-    csvLines.push(`用户,角色,${domains.join(',')},合计`);
-    data.userStats.forEach((userStat) => {
+    const headerRow = ['用户', '角色', ...domains, '合计'];
+    csvLines.push((0, csv_writer_1.buildCsvRow)(headerRow));
+    list.forEach((userStat) => {
         const domainValues = domains.map((domain) => userStat.domainStats[domain] || 0);
-        csvLines.push(`${userStat.userName},${userStat.roleName},${domainValues.join(',')},${userStat.total}`);
+        csvLines.push((0, csv_writer_1.buildCsvRow)([userStat.userName, userStat.roleName, ...domainValues, userStat.total]));
     });
     const filename = `work-hour-${targetYear}.csv`;
     (0, csv_writer_1.writeCsvFile)(filename, csvLines, logger_1.logger);
@@ -189,23 +126,19 @@ function outputJson(data) {
  * work-hour 命令入口
  */
 async function workHourCommand(year, cliOptions = {}) {
-    try {
-        const targetYear = year || new Date().getFullYear().toString();
-        const { projectId, roleIds, config, outputFormat } = (0, config_loader_1.loadConfig)(cliOptions);
-        const businessService = new business_service_1.BusinessService(config);
-        const reportData = await queryWorkHourReportData(businessService, projectId, roleIds, targetYear);
-        if (outputFormat === 'console') {
-            outputConsole(reportData);
-        }
-        else if (outputFormat === 'csv') {
-            outputCsv(reportData, targetYear);
-        }
-        else if (outputFormat === 'json') {
-            outputJson(reportData);
-        }
+    const spinner = (0, ora_1.default)('正在查询数据...').start();
+    const targetYear = year || new Date().getFullYear().toString();
+    const { projectId, roleIds, config, outputFormat } = (0, config_loader_1.loadConfig)(cliOptions);
+    const businessService = new business_service_1.BusinessService(config);
+    const reportData = await queryWorkHourReportData(businessService, projectId, roleIds, targetYear);
+    spinner.stop();
+    if (outputFormat === 'console') {
+        outputConsole(reportData);
+    }
+    else if (outputFormat === 'csv') {
+        outputCsv(reportData.list, targetYear);
     }
-    catch (error) {
-        logger_1.logger.error(`执行过程中发生错误:`, error);
-        process.exit(1);
+    else if (outputFormat === 'json') {
+        outputJson(reportData.list);
     }
 }

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

@@ -1,5 +1,4 @@
 import { AllWorkHourStats, HuaweiCloudConfig, IssueItem, IssueItemV2, IterationInfo, ProjectMember, ProjectRole, WorkHourStats, WorkProgressStats } from '../types';
-import { ApiService } from './api.service';
 /**
  * 业务服务类
  * 提供面向业务场景的高级操作，封装ApiService的底层调用
@@ -7,24 +6,28 @@ import { ApiService } from './api.service';
 export declare class BusinessService {
     private apiService;
     constructor(config: HuaweiCloudConfig);
-    /**
-     * 获取底层ApiService实例
-     * 用于需要直接访问API服务的场景
-     */
-    getApiService(): ApiService;
     /**
      * 通过角色ID获取项目成员
      * @param projectId 项目ID
-     * @param roleId 角色ID
+     * @param roleIds 角色ID列表
      * @returns 指定角色的成员列表
      */
-    getMembersByRoleId(projectId: string, roleId: number): Promise<ProjectMember[]>;
+    getMembersByRoleIds(projectId: string, roleIds: number[]): Promise<ProjectMember[]>;
     /**
      * 获取项目中的所有角色列表（去重）
      * @param projectId 项目ID
      * @returns 项目中的所有角色列表
      */
     getProjectRoles(projectId: string): Promise<ProjectRole[]>;
+    /**
+     * 获取项目的迭代列表
+     * @param projectId 项目ID
+     * @param options 可选参数
+     * @returns 迭代列表
+     */
+    getIterations(projectId: string, options?: {
+        limit: number;
+    }): Promise<IterationInfo[]>;
     /**
      * 获取指定日期之后的迭代列表
      * @param projectId 项目ID
@@ -40,14 +43,6 @@ export declare class BusinessService {
      * @returns Task类型的工作项列表
      */
     getWorkloadByIterationsAndUsers(projectId: string, iterationIds: number[], userIds: string[]): Promise<IssueItem[]>;
-    /**
-     * 根据迭代ID和用户ID列表查询工作量列表（仅Task和Story）
-     * @param projectId 项目ID
-     * @param iterationId 迭代ID
-     * @param userIds 用户ID列表
-     * @returns Task和Story类型的工作项列表
-     */
-    getWorkloadByIterationAndUsers(projectId: string, iterationId: number, userIds: string[]): Promise<IssueItem[]>;
     /**
      * 统计工作项进度信息
      * @param issues 工作项列表
@@ -70,12 +65,12 @@ export declare class BusinessService {
      */
     getIterationsByTitles(projectId: string, iterationTitles: string[]): Promise<IterationInfo[]>;
     /**
-     * 根据迭代标题获取所有 Story
+     * 根据迭代信息获取所有 Story
      * @param projectId 项目ID
-     * @param iterationTitles 迭代标题列表
+     * @param iterations 迭代信息列表
      * @returns Story 类型的工作项列表
      */
-    getStoriesByIterationTitles(projectId: string, iterationTitles: string[]): Promise<IssueItem[]>;
+    getStoriesByIterations(projectId: string, iterations: IterationInfo[], userIds?: string[]): Promise<IssueItem[]>;
     /**
      * 查询指定用户在指定时间段内的所有工时统计（按人和领域分组）
      * @param projectId 项目ID

package/dist/services/business.service.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BusinessService = void 0;
+const types_1 = require("../types");
 const api_service_1 = require("./api.service");
 /**
  * 业务服务类
@@ -10,27 +11,21 @@ class BusinessService {
     constructor(config) {
         this.apiService = new api_service_1.ApiService(config);
     }
-    /**
-     * 获取底层ApiService实例
-     * 用于需要直接访问API服务的场景
-     */
-    getApiService() {
-        return this.apiService;
-    }
     // 业务操作方法将在后续添加
     /**
      * 通过角色ID获取项目成员
      * @param projectId 项目ID
-     * @param roleId 角色ID
+     * @param roleIds 角色ID列表
      * @returns 指定角色的成员列表
      */
-    async getMembersByRoleId(projectId, roleId) {
+    async getMembersByRoleIds(projectId, roleIds) {
         const membersResponse = await this.apiService.getMembers(projectId);
         if (!membersResponse.success) {
             throw new Error(`获取成员列表失败: ${membersResponse.error || '未知错误'}`);
         }
         const allMembers = membersResponse.data?.members || [];
-        return allMembers.filter((member) => member.role_id === roleId);
+        const roleIdsSet = new Set(roleIds);
+        return allMembers.filter((member) => roleIdsSet.has(member.role_id));
     }
     /**
      * 获取项目中的所有角色列表（去重）
@@ -71,6 +66,24 @@ class BusinessService {
         // 转换为数组并按 role_id 排序
         return Array.from(rolesMap.values()).sort((a, b) => a.role_id - b.role_id);
     }
+    /**
+     * 获取项目的迭代列表
+     * @param projectId 项目ID
+     * @param options 可选参数
+     * @returns 迭代列表
+     */
+    async getIterations(projectId, options = { limit: 12 }) {
+        const iterationsResponse = await this.apiService.getIterations(projectId, {
+            include_deleted: false,
+        });
+        if (!iterationsResponse.success) {
+            throw new Error(`获取迭代列表失败: ${iterationsResponse.error || '未知错误'}`);
+        }
+        const list = (iterationsResponse.data?.iterations?.length || 0) > options.limit
+            ? iterationsResponse.data?.iterations?.slice(0, options.limit) || []
+            : iterationsResponse.data?.iterations || [];
+        return list;
+    }
     /**
      * 获取指定日期之后的迭代列表
      * @param projectId 项目ID
@@ -89,7 +102,7 @@ class BusinessService {
         // 过滤出在目标日期正在进行中的迭代
         return iterations.filter((iteration) => {
             // 检查迭代状态是否为进行中 (1)
-            if (iteration.status !== '1') {
+            if (iteration.status !== types_1.IterationStatus.IN_PROGRESS) {
                 return false;
             }
             // 检查目标日期是否在迭代时间范围内
@@ -121,27 +134,6 @@ class BusinessService {
         }
         return issuesResponse.data?.issues || [];
     }
-    /**
-     * 根据迭代ID和用户ID列表查询工作量列表（仅Task和Story）
-     * @param projectId 项目ID
-     * @param iterationId 迭代ID
-     * @param userIds 用户ID列表
-     * @returns Task和Story类型的工作项列表
-     */
-    async getWorkloadByIterationAndUsers(projectId, iterationId, userIds) {
-        const issuesResponse = await this.apiService.getIssues(projectId, {
-            iteration_ids: [iterationId],
-            tracker_ids: [2, 7], // 2=Task(任务), 7=Story
-            assigned_ids: userIds,
-            include_deleted: false,
-            limit: 100,
-            offset: 0,
-        });
-        if (!issuesResponse.success) {
-            throw new Error(`获取工作项列表失败: ${issuesResponse.error || '未知错误'}`);
-        }
-        return issuesResponse.data?.issues || [];
-    }
     /**
      * 统计工作项进度信息
      * @param issues 工作项列表
@@ -256,14 +248,12 @@ class BusinessService {
         return iterations.filter((iteration) => iterationTitles.includes(iteration.name));
     }
     /**
-     * 根据迭代标题获取所有 Story
+     * 根据迭代信息获取所有 Story
      * @param projectId 项目ID
-     * @param iterationTitles 迭代标题列表
+     * @param iterations 迭代信息列表
      * @returns Story 类型的工作项列表
      */
-    async getStoriesByIterationTitles(projectId, iterationTitles) {
-        // Step 1: 根据标题获取迭代信息
-        const iterations = await this.getIterationsByTitles(projectId, iterationTitles);
+    async getStoriesByIterations(projectId, iterations, userIds) {
         if (iterations.length === 0) {
             return [];
         }
@@ -277,6 +267,7 @@ class BusinessService {
         while (hasMore) {
             const issuesResponse = await this.apiService.getIssues(projectId, {
                 iteration_ids: iterationIds,
+                assigned_ids: userIds,
                 tracker_ids: [7], // 7=Story
                 include_deleted: false,
                 limit: pageSize,

package/dist/types/index.d.ts

@@ -305,6 +305,12 @@ export interface ListProjectIterationsV4Request {
     updated_time_interval?: string;
     include_deleted?: boolean;
 }
+export declare enum IterationStatus {
+    OPEN = "open",// 老数据默认状态
+    NOT_STARTED = "0",// 未启动
+    IN_PROGRESS = "1",// 进行中
+    COMPLETED = "2"
+}
 export interface IterationInfo {
     begin_time: string;
     deleted: boolean;
@@ -312,7 +318,7 @@ export interface IterationInfo {
     end_time: string;
     id: number;
     name: string;
-    status: string;
+    status: IterationStatus;
     updated_time: number;
 }
 export interface ListProjectIterationsV4Response {
@@ -539,14 +545,6 @@ export declare enum ConfigKey {
     PROJECT_ID = "PROJECT_ID",
     ROLE_ID = "ROLE_ID"
 }
-/**
- * 不可变配置键（只能通过 config 命令设置）
- */
-export declare const IMMUTABLE_CONFIG_KEYS: ConfigKey[];
-/**
- * 可变配置键（可以通过命令行参数覆盖）
- */
-export declare const MUTABLE_CONFIG_KEYS: ConfigKey[];
 /**
  * 类型安全的配置映射
  */
@@ -560,11 +558,13 @@ export type ConfigMap = {
     [ConfigKey.PROJECT_ID]: string;
     [ConfigKey.ROLE_ID]: string;
 };
-/**
- * 部分配置映射（用于读取配置文件）
- */
-export type PartialConfigMap = Partial<ConfigMap>;
 /**
  * 输出格式类型
  */
 export type OutputFormat = 'console' | 'csv' | 'json';
+export interface ConsoleTotal<T> {
+    title: string;
+    roleNames: string[];
+    totalMap: [string, string | (() => string)][];
+    list: T[];
+}

package/dist/types/index.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MUTABLE_CONFIG_KEYS = exports.IMMUTABLE_CONFIG_KEYS = exports.ConfigKey = exports.DefectAnalysisType = void 0;
+exports.ConfigKey = exports.DefectAnalysisType = exports.IterationStatus = void 0;
+var IterationStatus;
+(function (IterationStatus) {
+    IterationStatus["OPEN"] = "open";
+    IterationStatus["NOT_STARTED"] = "0";
+    IterationStatus["IN_PROGRESS"] = "1";
+    IterationStatus["COMPLETED"] = "2";
+})(IterationStatus || (exports.IterationStatus = IterationStatus = {}));
 /**
  * 缺陷技术分析选项枚举
  * custom_field32（缺陷技术分析）字段的选项值枚举定义
@@ -40,19 +47,3 @@ var ConfigKey;
     // 可变配置（可以通过命令行参数覆盖）
     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,4 +1,4 @@
-import { HuaweiCloudConfig, OutputFormat, PartialConfigMap } from '../types';
+import { ConfigMap, HuaweiCloudConfig, OutputFormat } from '../types';
 /**
  * 获取全局配置文件路径
  */
@@ -10,18 +10,18 @@ export declare function configExists(): boolean;
 /**
  * 读取全局配置
  */
-export declare function readConfig(): PartialConfigMap;
+export declare function readConfig(): Partial<ConfigMap>;
 /**
  * 写入全局配置
  * 支持动态配置项，自动按分组组织配置文件
  */
-export declare function writeConfig(config: PartialConfigMap): void;
+export declare function writeConfig(config: Partial<ConfigMap>): void;
 /**
  * 删除全局配置
  */
 export declare function deleteConfig(): void;
 export interface CliOptions {
-    roleId?: string;
+    role?: string;
     output?: string;
     report?: boolean;
 }
@@ -41,4 +41,4 @@ export declare function loadConfig(cliOptions?: CliOptions): LoadedConfig;
  * 获取最终合并后的配置（用于显示）
  * @returns 合并后的配置映射
  */
-export declare function getConfig(): PartialConfigMap;
+export declare function getConfig(): Partial<ConfigMap>;

package/dist/utils/config-loader.js

@@ -181,7 +181,7 @@ const globalConfig = configExists() ? readConfig() : {};
 function loadConfig(cliOptions = {}) {
     // 命令行参数 > 全局配置
     const projectId = globalConfig[types_1.ConfigKey.PROJECT_ID];
-    const roleIdStr = cliOptions.roleId || globalConfig[types_1.ConfigKey.ROLE_ID];
+    const roleIdStr = cliOptions.role || globalConfig[types_1.ConfigKey.ROLE_ID];
     if (!projectId) {
         throw new Error('缺少项目 ID');
     }

package/dist/utils/console.d.ts

@@ -0,0 +1,4 @@
+import { ConsoleTotal } from '../types';
+export declare function showLogo(): void;
+export declare function consoleTotal<T>(total: ConsoleTotal<T>): void;
+export declare function issueLink(projectId: string, issueId: string | number): string;

package/dist/{constant/index.js → utils/console.js}

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showLogo = showLogo;
+exports.consoleTotal = consoleTotal;
+exports.issueLink = issueLink;
 const logger_1 = require("../utils/logger");
 const LOGO_LINES = [
     '██╗  ██╗███████╗ ██████╗ ██████╗ ███╗   ███╗',
@@ -27,3 +29,19 @@ function showLogo() {
     });
     logger_1.logger.info();
 }
+function consoleTotal(total) {
+    logger_1.logger.info(`${total.title} [${total.roleNames.join(', ')}]`);
+    logger_1.logger.info('='.repeat(80));
+    total.totalMap.forEach(([key, value]) => {
+        if (typeof value === 'function') {
+            logger_1.logger.info(`${key}: ${value()}`);
+        }
+        else {
+            logger_1.logger.info(`${key}: ${value}`);
+        }
+    });
+    logger_1.logger.info('='.repeat(80));
+}
+function issueLink(projectId, issueId) {
+    return `https://devcloud.cn-north-4.huaweicloud.com/projectman/scrum/${projectId}/task/detail/${issueId}`;
+}

package/dist/utils/csv-writer.d.ts

@@ -1,8 +1,17 @@
 import { Logger } from './logger';
 /**
- * CSV 转义函数：处理双引号
+ * 构建 CSV 行
+ * @param fields CSV 字段数组
+ * @returns CSV 行字符串
  */
-export declare function escapeCsv(value: string): string;
+export declare function buildCsvRow(fields: (string | number | null | undefined)[]): string;
+/**
+ * 创建 Excel HYPERLINK 公式
+ * @param url 链接地址
+ * @param displayText 显示文本
+ * @returns Excel HYPERLINK 公式字符串
+ */
+export declare function createHyperlinkFormula(url: string, displayText: string): string;
 /**
  * 写入 CSV 文件到当前工作目录
  * @param filename 文件名