@hecom/codearts 0.2.0 → 0.2.2

package/README.md

@@ -1,6 +1,6 @@
 # @hecom/codearts
 
-基于华为云 CodeArts API 的工时统计分析工具。
+基于华为云 CodeArts API 的统计分析工具。
 
 ## 快速开始
 
@@ -24,16 +24,29 @@ npx @hecom/codearts daily
 # 生成当年工时统计
 npx @hecom/codearts work-hour
 
-# 生成指定日期/年份的统计
-npx @hecom/codearts daily 2026-01-15
-npx @hecom/codearts work-hour 2025
+# 按迭代统计产品缺陷率
+npx @hecom/codearts bug-rate "迭代1,迭代2"
+```
 
-# 使用命令行参数覆盖配置
-npx @hecom/codearts daily 2026-01-15 --project-id abc123 --role-id 1,2
-npx @hecom/codearts work-hour 2025 --role-id 1,2,3
+### 3. 更新配置
 
-# 更新配置
+```bash
+# 更新全局配置
 npx @hecom/codearts config
+
+# 单独更新角色配置
+npx @hecom/codearts config role-id
+
+# 查看当前配置
+npx @hecom/codearts config show
+```
+
+### 4. 升级
+
+```bash
+# 更新最新版本
+npx @hecom/codearts@latest
+
 ```
 
 ---
@@ -42,7 +55,7 @@ npx @hecom/codearts config
 
 ### 环境要求
 
-- Node.js >= 16.0.0
+- Node.js >= 23.0.0
 - npm >= 7.0.0
 
 ### 安装依赖
@@ -51,175 +64,39 @@ npx @hecom/codearts config
 npm install
 ```
 
-### 本地链接 CLI 工具
-
-```bash
-npm run build
-npm link
-codearts --help
-```
-
-### 开发调试
-
-```bash
-# 编译 TypeScript
-npm run build
-
-# 运行测试
-npm test
-```
-
-### 高级配置
+### 本地运行
 
-**配置优先级**：命令行参数 > 当前目录 .env > 全局配置 > 默认值
-
-#### 项目级配置
-
-在项目目录创建 `.env` 文件（优先级高于全局配置）：
+> 本地运行命令时，注意使用 `--` 分隔 npm 参数和 CLI 参数，否则 CLI 参数可能无法正确传递。
 
 ```bash
-cp .env.example .env
-```
-
-修改 `.env` 文件中的配置：
+# 运行命令
+npm run dev
 
-```env
-# 华为云IAM认证端点（根据区域调整）
-HUAWEI_CLOUD_IAM_ENDPOINT=https://iam.cn-north-4.myhuaweicloud.com
-HUAWEI_CLOUD_REGION=cn-north-4
+npm run dev -- daily
 
-# IAM用户凭证
-HUAWEI_CLOUD_USERNAME=your-iam-username
-HUAWEI_CLOUD_PASSWORD=your-iam-password
-HUAWEI_CLOUD_DOMAIN=your-domain-name
-
-# 项目配置
-CODEARTS_BASE_URL=https://projectman-ext.cn-north-4.myhuaweicloud.cn
-PROJECT_ID=your-project-id
-ROLE_ID=1,2,3  # 支持逗号分隔的多个角色ID
+npm run dev -- work-hour
 ```
 
-**适用场景**: 团队协作，不同项目使用不同配置
-
-#### 环境变量说明
-
-| 变量名                      | 说明                               | 必填 | 默认值                                               |
-| --------------------------- | ---------------------------------- | ---- | ---------------------------------------------------- |
-| `HUAWEI_CLOUD_IAM_ENDPOINT` | IAM 认证端点                       | 否   | `https://iam.cn-north-4.myhuaweicloud.com`           |
-| `HUAWEI_CLOUD_REGION`       | 华为云区域                         | 否   | `cn-north-4`                                         |
-| `HUAWEI_CLOUD_USERNAME`     | IAM 用户名                         | 是   | -                                                    |
-| `HUAWEI_CLOUD_PASSWORD`     | IAM 密码                           | 是   | -                                                    |
-| `HUAWEI_CLOUD_DOMAIN`       | 华为云账号名                       | 是   | -                                                    |
-| `CODEARTS_BASE_URL`         | CodeArts API 地址                  | 否   | `https://projectman-ext.cn-north-4.myhuaweicloud.cn` |
-| `PROJECT_ID`                | 项目 ID                            | 是   | -                                                    |
-| `ROLE_ID`                   | 角色 ID（支持逗号分隔，如: 1,2,3） | 是   | -                                                    |
-| `TARGET_DATE`               | 目标日期（YYYY-MM-DD）             | 否   | 当天日期                                             |
-
----
-
-## 项目信息
-
-### 项目描述
-
-这是一个使用 TypeScript/Node.js 构建的工时统计分析项目，通过华为云 CodeArts API 获取 issue、人员、工时等数据，并生成日报和年度工时统计报表。
-
-### 技术栈
-
-- **语言**: TypeScript
-- **运行环境**: Node.js
-- **HTTP客户端**: Axios
-- **测试框架**: Jest
-
-### 项目结构
+### 本地链接 CLI 工具
 
+```bash
+npm run build
+npm link
+codearts --help
 ```
-@hecom/codearts/
-├── src/
-│   ├── bin/                    # CLI 入口
-│   │   └── cli.ts              # Commander.js CLI 定义
-│   ├── commands/               # 命令实现
-│   │   ├── config.command.ts   # 配置命令逻辑
-│   │   ├── daily.command.ts    # 日报命令逻辑
-│   │   ├── work-hour.command.ts# 工时统计命令逻辑
-│   │   └── index.ts            # 命令导出
-│   ├── services/               # API服务类
-│   │   ├── api.service.ts      # 华为云基础 API 封装
-│   │   └── business.service.ts # 业务场景 API 封装
-│   ├── utils/                  # 工具函数
-│   │   ├── global-config.ts    # 全局配置查找
-│   │   └── config-loader.ts    # 配置加载器（CLI参数 > 环境变量）
-│   ├── config/                 # 配置文件
-│   │   └── holidays.ts         # 节假日配置与工作日计算
-│   ├── types/                  # TypeScript 类型定义
-│   │   └── index.ts            # API 契约与数据结构定义
-│   └── index.ts                # 模块导出
-├── bin/
-│   └── codearts                # CLI 可执行文件
-├── __tests__/                  # 测试文件
-├── dist/                       # 编译输出目录
-├── .env                        # 环境变量配置
-├── .env.example                # 环境变量配置模板
-├── tsconfig.json               # TypeScript配置
-├── jest.config.js              # Jest测试配置
-└── package.json                # 项目配置
-```
-
-### 核心功能
-
-#### 日报统计 (daily)
-
-生成指定日期的工时日报，包括：
-
-- 按人员统计当日工时
-- 统计 Bug 修复工时（自动合并同一 Bug 的多人工时）
-- 统计活跃的工作项数量
-- 计算工时完成率（基于角色成员数）
-- 生成可读的日报格式输出
-
-#### 年度工时统计 (work-hour)
-
-生成指定年份的工时统计报表，包括：
-
-- 计算年度应计工作日（自动排除法定节假日和周末）
-- 统计实际工时与应计工时的完成率
-- 按人员生成工时明细表
-- 按领域类型（需求、缺陷、任务等）统计工时分布
-- 支持多角色统计（按角色分组，显示小计和总计）
-- 生成 Markdown 格式的统计表格
-
-### API服务层
-
-#### ApiService (api.service.ts)
-
-华为云 CodeArts 基础 API 封装：
-
-- IAM Token 认证管理（自动获取和缓存）
-- 项目管理 API（项目列表、成员查询）
-- 迭代管理 API（迭代列表、迭代详情）
-- 工作项 API（Issue 列表、详情、创建、更新）
-- 工时管理 API（工时查询、提交）
-- 请求日志（可选的 curl 风格日志输出）
-- 完善的错误处理
-
-#### BusinessService (business.service.ts)
-
-面向业务场景的高级 API 封装：
-
-- `getMembersByRoleId()`: 通过角色获取人员列表
-- `getActiveIterationsOnDate()`: 查询指定日期的活跃迭代
-- `getWorkloadByIterationsAndUsers()`: 批量查询工作量
-- `getAllIssuesByIteration()`: 查询迭代内所有 Issue（自动分页）
-- `getDailyWorkHourStats()`: 获取日报工时统计
-- `getAllWorkHourStats()`: 获取年度工时统计
-- `addIssueNote()`: 添加工作项备注
-
-### 节假日配置 (config/holidays.ts)
 
-- 支持中国法定节假日配置
-- 支持调休工作日配置
-- 支持大小周制度
-- 自动计算年度应计工作日
-- 判断指定日期是否为工作日
+### 配置项
+
+| 配置项                      | 说明                               | 必填 |
+| --------------------------- | ---------------------------------- | ---- |
+| `HUAWEI_CLOUD_IAM_ENDPOINT` | IAM 认证端点                       | 是   |
+| `HUAWEI_CLOUD_REGION`       | 华为云区域                         | 是   |
+| `CODEARTS_BASE_URL`         | CodeArts API 地址                  | 是   |
+| `HUAWEI_CLOUD_DOMAIN`       | 华为云账号名                       | 是   |
+| `HUAWEI_CLOUD_USERNAME`     | IAM 用户名                         | 是   |
+| `HUAWEI_CLOUD_PASSWORD`     | IAM 密码                           | 是   |
+| `PROJECT_ID`                | 项目 ID                            | 是   |
+| `ROLE_ID`                   | 角色 ID（支持逗号分隔，如: 1,2,3） | 是   |
 
 ---
 

package/dist/bin/cli.js

@@ -33,19 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": 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 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");
+const config_loader_1 = require("../utils/config-loader");
+const logger_1 = require("../utils/logger");
 // 读取 package.json 中的版本号
 const packageJsonPath = path.join(__dirname, '../../package.json');
 const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
@@ -53,51 +50,72 @@ const version = packageJson.version;
 const program = new commander_1.Command();
 program.name('codearts').description('华为云 CodeArts 统计分析工具').version(version);
 // 全局选项（环境变量覆盖）
-program.option('--role-id <ids>', '角色 ID（支持逗号分隔，如: 1,2,3），优先级高于环境变量 ROLE_ID');
-// config 命令 - 交互式配置向导
 program
+    .option('--role-id <ids>', '角色 ID（支持逗号分隔，如: 1,2）')
+    .option('--output <format>', '输出格式：console、csv、json', 'console');
+// config 命令 - 交互式配置向导
+const configCmd = program
     .command('config')
-    .description('交互式配置向导，引导用户创建或更新全局配置文件\n\n')
+    .description('交互式配置向导，引导用户创建或更新全局配置文件')
     .action(async () => {
     await (0, config_command_1.configCommand)();
 });
+// config show 子命令 - 显示当前配置
+configCmd
+    .command('show')
+    .description('显示当前配置信息')
+    .action(async () => {
+    await (0, config_command_1.showConfigCommand)();
+});
+// 为每个项目配置项添加子命令
+const availableConfigs = (0, config_command_1.getAvailableProjectConfigs)();
+availableConfigs.forEach((configItem) => {
+    const subCommandName = configItem.key.toLowerCase().replace(/_/g, '-');
+    configCmd
+        .command(subCommandName)
+        .description(`更新${configItem.label}`)
+        .action(async () => {
+        await (0, config_command_1.updateProjectConfigCommand)(configItem.key);
+    });
+});
 // daily 命令
 program
     .command('daily [date]')
-    .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);
+    .description('每日工时统计（默认日期为当天）')
+    .option('-r, --report', '显示总结报告', false)
+    .action(async (date, options, command) => {
+    const cliOptions = { ...command.parent.opts(), report: options.report };
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, daily_command_1.dailyCommand)(date, cliOptions);
 });
 // work-hour 命令
 program
     .command('work-hour [year]')
-    .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);
+    .description('年度工时统计（默认当前年份）')
+    .action(async (year, options, command) => {
+    const cliOptions = command.parent.opts();
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, work_hour_command_1.workHourCommand)(year, cliOptions);
 });
 // 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);
+    .description('产品缺陷率统计，支持多个迭代')
+    .action(async (iterations, options, command) => {
+    const cliOptions = command.parent.opts();
+    logger_1.logger.setOutputFormat(cliOptions.output);
+    await (0, bug_command_1.bugCommand)(iterations, cliOptions);
 });
 // 检查配置并自动执行 config 命令
 async function checkConfigAndRun() {
     const args = process.argv.slice(2);
     // 如果没有参数（直接执行 codearts），检测配置
     if (args.length === 0) {
-        // 加载当前目录 .env 文件
-        dotenv_1.default.config();
-        // 检查是否有配置（全局配置或环境变量）
-        const hasGlobalConfig = (0, global_config_1.globalConfigExists)();
-        const hasEnvConfig = process.env.PROJECT_ID && process.env.ROLE_ID;
-        if (!hasGlobalConfig && !hasEnvConfig) {
+        // 检查是否有全局配置
+        const hasConfig = (0, config_loader_1.configExists)();
+        if (!hasConfig) {
             // 没有配置，自动执行 config 命令
-            console.log('未检测到配置文件，启动配置向导...\n');
+            logger_1.logger.info('未检测到配置文件，启动配置向导...\n');
             await (0, config_command_1.configCommand)();
             return;
         }
@@ -108,6 +126,6 @@ async function checkConfigAndRun() {
     program.parse();
 }
 checkConfigAndRun().catch((error) => {
-    console.error('执行失败:', error);
+    logger_1.logger.error('执行失败: ', error);
     process.exit(1);
 });

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

@@ -1,7 +1,5 @@
 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

@@ -4,13 +4,12 @@ exports.bugCommand = bugCommand;
 const business_service_1 = require("../services/business.service");
 const types_1 = require("../types");
 const config_loader_1 = require("../utils/config-loader");
+const csv_writer_1 = require("../utils/csv-writer");
+const logger_1 = require("../utils/logger");
 /**
  * 判断 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 ||
@@ -19,32 +18,35 @@ function isRequirementOrDesignBug(bug) {
     return false;
 }
 /**
- * 生成 Bug 统计报告
+ * 查询 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: 获取指定角色的成员列表（如果启用了角色过滤）
+async function queryBugReportData(businessService, projectId, roleIds, iterationTitles) {
+    const roleNames = new Set();
     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));
+            members.forEach((member) => {
+                targetMemberIds.add(member.user_num_id);
+                roleNames.add(member.role_name);
+            });
         }
-        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;
+        return {
+            iterations: iterationTitles,
+            roleIds,
+            roleNames: Array.from(roleNames),
+            userStats: [],
+            summary: {
+                totalBugs: 0,
+                totalProductBugs: 0,
+                overallProductDefectRate: 0,
+                userCount: 0,
+            },
+        };
     }
-    // Step 3: 过滤出目标角色成员处理的 Story（如果启用了角色过滤）
     const filteredStories = roleIds.length > 0
         ? stories.filter((story) => {
             const assignedUserId = story.assigned_user?.id;
@@ -52,27 +54,27 @@ async function generateBugReport(businessService, projectId, roleIds, iterationT
         })
         : 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...`);
+        return {
+            iterations: iterationTitles,
+            roleIds,
+            roleNames: Array.from(roleNames),
+            userStats: [],
+            summary: {
+                totalBugs: 0,
+                totalProductBugs: 0,
+                overallProductDefectRate: 0,
+                userCount: 0,
+            },
+        };
     }
-    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) {
@@ -98,61 +100,103 @@ async function generateBugReport(businessService, projectId, roleIds, iterationT
             productBugCount: productBugs.length,
         });
     }
-    // 计算每个人的产品缺陷率
     bugStatsMap.forEach((stats) => {
         stats.productDefectRate =
-            stats.totalBugCount > 0 ? (stats.productBugCount / stats.totalBugCount) * 100 : 0;
+            stats.totalBugCount > 0
+                ? Math.round((stats.productBugCount / stats.totalBugCount) * 100 * 100) / 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));
+    const overallProductDefectRate = totalBugs > 0 ? Math.round((totalProductBugs / totalBugs) * 100 * 100) / 100 : 0;
+    return {
+        iterations: iterationTitles,
+        roleIds,
+        roleNames: Array.from(roleNames),
+        userStats: sortedStats,
+        summary: {
+            totalBugs,
+            totalProductBugs,
+            overallProductDefectRate,
+            userCount: sortedStats.length,
+        },
+    };
+}
+/**
+ * 控制台输出产品缺陷率统计
+ */
+function outputConsole(data) {
+    logger_1.logger.info(`产品缺陷率统计 [${data.roleNames.join(', ')}]`);
+    logger_1.logger.info('='.repeat(80));
+    logger_1.logger.info(`产品缺陷率: ${data.summary.overallProductDefectRate.toFixed(2)}% `);
+    logger_1.logger.info(`总 Bug 数: ${data.summary.totalBugs}个`);
+    logger_1.logger.info(`产品问题: ${data.summary.totalProductBugs}个`);
+    logger_1.logger.info(`统计人数: ${data.summary.userCount}人`);
+    logger_1.logger.info(`统计迭代: ${data.iterations.join(', ')}`);
+    logger_1.logger.info('='.repeat(80));
+    data.userStats.forEach((stats) => {
+        logger_1.logger.info(`\x1b[31m${stats.assignedUser}: ${stats.productDefectRate.toFixed(2)}% (${stats.productBugCount}/${stats.totalBugCount})\x1b[0m`);
+        stats.stories.forEach((story) => {
+            logger_1.logger.info(`  ${story.storyName} (${story.productBugCount}/${story.totalBugCount})`);
+        });
+        logger_1.logger.info('');
+    });
+}
+/**
+ * CSV 文件输出
+ */
+function outputCsv(data, iterationTitles) {
+    const csvLines = [];
+    csvLines.push('迭代,处理人,Story名称,StoryID,总Bug数,产品问题Bug数,产品缺陷率');
+    data.userStats.forEach((userStat) => {
+        userStat.stories.forEach((story) => {
+            const defectRate = story.totalBugCount > 0
+                ? ((story.productBugCount / story.totalBugCount) * 100).toFixed(2)
+                : '0.00';
+            csvLines.push(`"${(0, csv_writer_1.escapeCsv)(data.iterations.join(', '))}",${userStat.assignedUser ?? ''},"${(0, csv_writer_1.escapeCsv)(story.storyName ?? '')}",${story.storyId ?? ''},${story.totalBugCount ?? ''},${story.productBugCount ?? ''},${defectRate}%`);
+        });
+    });
+    const filename = `bug-rate-${iterationTitles.join('-')}.csv`;
+    (0, csv_writer_1.writeCsvFile)(filename, csvLines, logger_1.logger);
+}
+/**
+ * JSON 输出（直接打印到控制台，供编程调用）
+ */
+function outputJson(data) {
+    logger_1.logger.json(data);
 }
 /**
  * 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"');
+            throw new Error('请指定至少一个迭代标题');
         }
-        // 解析迭代标题（支持多种分隔符：逗号、分号、空格、竖线、顿号等）
         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 { projectId, roleIds, config, outputFormat } = (0, config_loader_1.loadConfig)(cliOptions);
         const businessService = new business_service_1.BusinessService(config);
-        await generateBugReport(businessService, projectId, roleIds, iterationTitles);
+        const reportData = await queryBugReportData(businessService, projectId, roleIds, iterationTitles);
+        if (outputFormat === 'console') {
+            outputConsole(reportData);
+        }
+        else if (outputFormat === 'csv') {
+            outputCsv(reportData, iterationTitles);
+        }
+        else if (outputFormat === 'json') {
+            outputJson(reportData);
+        }
     }
     catch (error) {
-        console.error('执行过程中发生错误:', error);
+        logger_1.logger.error(`执行过程中发生错误: `, error);
         process.exit(1);
     }
 }

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

@@ -1,5 +1,30 @@
+import { BusinessService } from '../services/business.service';
+import { ConfigKey } from '../types';
+/**
+ * 第三阶段项目配置的配置项定义
+ */
+interface ProjectConfigItem {
+    key: ConfigKey;
+    label: string;
+    configure: (businessService: BusinessService, projectId: string, existingValue?: string) => Promise<string>;
+}
 /**
  * 交互式配置向导命令
  * 引导用户创建或更新全局配置文件
  */
 export declare function configCommand(): Promise<void>;
+/**
+ * 单独更新某个项目配置项
+ * @param configKey 配置项的键名（例如 ConfigKey.ROLE_ID）
+ */
+export declare function updateProjectConfigCommand(configKey: ConfigKey): Promise<void>;
+/**
+ * 获取所有可用的项目配置项
+ */
+export declare function getAvailableProjectConfigs(): ProjectConfigItem[];
+/**
+ * 显示当前配置
+ *
+ */
+export declare function showConfigCommand(): Promise<void>;
+export {};