@hecom/codearts

基于华为云 CodeArts API 的统计分析工具。

快速开始

1. 初始化

npm install -g @hecom/codearts
codearts config

运行交互式配置向导，根据提示输入必要的配置项。配置文件将保存在 ~/.hecom-codearts/config.env，配置一次后全局可用。

2. 使用

# 查看帮助
codearts --help

# 生成今日工时日报
codearts daily

# 生成指定日期工时日报并显示总结报告
codearts daily 2026-03-27 --report

# 生成当年工时统计
codearts work-hour

# 生成指定年份工时统计
codearts work-hour 2026

# 统计产品缺陷率
codearts bug-rate

# 交互式修复当前用户的 Bug
codearts fix

# 生成质量分析报告
codearts quality --iteration "迭代1,迭代2"

# 生成 Bug 多维度可视化分析报告
codearts rebug chart --iteration "迭代1,迭代2" --terminal "移动端"

# 查看未添加标签的 Bug 列表
codearts rebug no-tag --iteration "迭代1,迭代2" --developer "张三"

# 为指定版本的 Story 拆解 Task
codearts story all "版本1"
codearts story single "版本1"

3. 更新配置

# 更新配置文件
codearts config

# 单独更新角色配置
codearts config role-id

# 单独更新开发端配置
codearts config development-end

# 单独更新终端类型配置
codearts config terminal-type

# 查看当前配置
codearts config show

4. 升级

# 更新最新版本
codearts upgrade

本地开发与调试

环境要求

• Node.js >= 23.0.0
• npm >= 7.0.0

安装依赖

npm install

本地运行

本地运行命令时，注意使用 -- 分隔 npm 参数和 CLI 参数，否则 CLI 参数可能无法正确传递。

# 运行命令
npm run dev

npm run dev -- daily

npm run dev -- work-hour

本地链接 CLI 工具

npm run build
npm link
codearts --help

配置项

| 配置项 | 说明 | 必填 | | --------------------------- | ---------------------------------- | ---- | | 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） | 是 |

License

MIT