# Jira Auto

**Repository Path**: NoSloth/jira-auto

## Basic Information

- **Project Name**: Jira Auto
- **Description**: Jira 自动化工单处理程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Jira Auto 自动化运维工具

## 简介

本工具是一款基于 Python 和 Selenium 开发的 Jira 工单自动化处理程序。支持一键批量处理工单，通过结构化配置实现业务逻辑与代码的完全解耦，支持动态修改经办人等字段，极大提升工单流转效率。

## 📌 版本信息

**当前版本：** v1.2.0

### 版本历史

| 版本 | 日期 | 更新内容 |
|------|------|---------|
| v1.2.0 | 2026-07-21 | 新增 添加评论 功能 |
| v1.1.0 | 2026-07-15 | 新增 修改问题分析部门 功能 |
| v1.0.2 | 2026-07-13 | 新增 ChromeDriver 与 Chrome 版本检测及匹配提示 |
| v1.0.1 | 2026-07-10 | 优化提示信息，纯文本兼容 |
| v1.0.0 | 2026-07-09 | 首个正式版本，支持基础分票功能 |
| v0.2.0 | 2026-06-24 | 支持遍历链接所有票号，完善定位元素 |
| v0.1.0 | 2026-05-28 | 初始版本，仅支持 Jira 登录，基础定位元素 |


### 当前版本（v1.2.0）功能清单

| 功能 | 状态 |
|------|:----:|
| Jira登录 | ✅ |
| 遍历票列表 | ✅ |
| 提取票信息 | ✅ |
| 分页处理 | ✅ |
| 进入编辑模式 | ✅ |
| 修改经办人 | ✅ |
| 保存修改 | ✅ |
| 取消编辑 | ✅ |
| 异常处理 | ✅ |
| ChromeDriver 版本检测 | ✅ |
| Chrome 浏览器版本检测 | ✅ |
| 版本匹配提示 | ✅ |
| 修改问题分析部门 | ✅ |



-  下一步计划

| 版本 | 计划内容 | 状态 |
|------|---------|:----:|
| v1.1.0 | 增添业务操作 | ✅ 已完成 |
| v1.2.0 | 增添业务操作，增加可用性 | ✅ 已完成 |
| v2.0.0 | AI语义分析 + 自动分票 | 📋 计划中 |

## 环境要求

- Windows 10/11 操作系统
- 已安装 Google Chrome 浏览器（版本需与内置的 ChromeDriver 匹配）


## 快速开始
<<<<<<< HEAD
=======
### 文件结构

发布文件夹/

├── JiraAuto_v1.0.1.exe

├── config.txt            # 需要让同事自己配置

└── chromedriver.exe      # 如果打包时没包含，需要单独放


### 1. 配置参数

在程序同级目录下找到 `config.txt` 文件，使用记事本打开，按照以下格式填入你的 Jira 账号信息和业务参数：

```text
# =============================================================================
# Jira 自动化运维工具 - 配置文件
# =============================================================================

# -----------------------------------------------------------------------------
# 1. 连接与认证配置
# -----------------------------------------------------------------------------
# 你的 Jira 账号用户名
JIRA_USERNAME=你的账号

# 你的 Jira 账号密码 (注意：明文存储，请妥善保管此文件)
JIRA_PASSWORD=你的密码

# Jira 问题列表的完整 URL (包含筛选条件 JQL，或直接复制完整url)
# 示例: http://jira.z-onesoftware.com:8080/issues/?filter=-1&jql=project%20%3D%20PQCP
JIRA_URL=http://jira.z-onesoftware.com:8080/issues/?jql=你的JQL查询条件

# ChromeDriver 可执行文件的路径
CHROMEDRIVER_PATH=./chromedriver.exe


# -----------------------------------------------------------------------------
# 2. 业务规则配置
# -----------------------------------------------------------------------------
# 目标经办人姓名
# 格式通常为：姓名-部门缩写 (例如：张三-EA)
TASK_ASSIGNEE_NAME=

# 目标问题分析方部门
# 请填写下拉框中显示的完整部门名称 (例如：IC-智能座舱部)
TASK_DEPARTMENT=

# 评论框内容
# 备注内容格式： [~(被@人域账号)] 内容 (例如：[~xcmtik] 如沟通，请支持提供log，谢谢,test!!!)
COMMENT_CONTENT=
```

### 2. 运行程序

直接双击 `JiraAuto.exe` 即可启动。程序会自动打开浏览器、登录 Jira，并开始根据 JQL 条件批量处理工单。

## 注意事项

1. **名称精确匹配**：`TASK_ASSIGNEE_NAME` 的值必须与 Jira 系统中下拉框显示的姓名（如 `耿猛-EA`）保持绝对一致，否则会导致下拉选项匹配失败。
2. **网络延迟**：如果 Jira 响应较慢，程序内置了自动等待机制，请耐心等待。
3. **安全提醒**：请勿将包含真实密码的 `config.txt` 随意发送给他人。
4. **异常处理**：如果运行过程中遇到报错，请查看控制台输出的错误信息，检查网络连接或配置是否正确。

---
## 联系
如有问题，请联系 项目维护者 [Mingwei-Li@hotmail.com](mailto:Mingwei-Li@hotmail.com)。