# Jira Sync Cron

**Repository Path**: NoSloth/jira-sync-cron

## Basic Information

- **Project Name**: Jira Sync Cron
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Jira-Sync-Cron

> **Jira自动化问题同步助手** - 用户使用说明

## 项目简介 | Project Introduction

`自动化循环执行问题同步助手` 用于定时循环执行 Jira问题同步管理助手 工具。

![v1.4.0_GUI.](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/v1.4.0_GUI.png)

## 核心特性 | Core Features

- **⏱️ 定时调度**：轻量级调度器 (`scheduler.exe`)，支持精确到分钟的后台静默执行。
- **🩺 环境自愈**：内置 `check_env.dll`，自动检测 Chrome 浏览器与 Chromedriver 的主版本号。若版本不匹配或缺失，会暂停并引导用户修复，确保自动化环境可用。
- **🌑 极致静默**：消除 `chromedriver` 运行时产生的黑窗口闪烁，实现后台无感运行。
- **📊 智能监控**：实时监控网页进度条状态，精准判断任务完成时机，杜绝数据同步中途截断。
- **📦 独立部署**：包含完整的版本信息，无需在目标机器上安装 Python 环境即可直接运行。
- **📊 监控面板**：全新引入 GUI 控制台，提供“运行日志”与“业务同步日志”双视窗实时刷新，任务状态与进度一目了然。


## 项目结构 | Project Structure

### v1.4.0-beta (2026-08-05)版本


<div style="font-family: 'Consolas', 'Monaco', monospace; background-color: #f8f9fa; padding: 16px 20px; border-radius: 8px; border-left: 4px solid #007bff; line-height: 1.8; font-size: 14px;">
  <div style="color: #333; font-weight: bold; margin-bottom: 4px;">jira-sync-cron/</div>
  <div style="padding-left: 20px; color: #555;">
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">main.exe</span> <span style="color: #6c757d;"># 核心自动化同步脚本</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">自动化循环执行问题同步助手.exe</span> <span style="color: #6c757d;"># 图形化程序入口</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">check_env.dll</span> <span style="color: #6c757d;"># 环境检测</span></div>
	<div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">test_env.exe</span> <span style="color: #6c757d;"># 环境检测器(运行检测环境)</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">config.py</span> <span style="color: #6c757d;"># 配置文件 (JQL、Token、目标平台等)</span></div>
    <div><span style="color: #d63384;">└──</span> <span style="display: inline-block; width: 320px;">chromedriver.exe</span> <span style="color: #6c757d;"># 需要下载对应版本</span></div>
  </div>
</div>

### v1.3.0-beta (2026-08-03) 之前版本


<div style="font-family: 'Consolas', 'Monaco', monospace; background-color: #f8f9fa; padding: 16px 20px; border-radius: 8px; border-left: 4px solid #007bff; line-height: 1.8; font-size: 14px;">
  <div style="color: #333; font-weight: bold; margin-bottom: 4px;">jira-sync-cron/</div>
  <div style="padding-left: 20px; color: #555;">
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">main.exe</span> <span style="color: #6c757d;"># 核心自动化同步脚本</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">自动化循环执行问题同步助手.exe</span> <span style="color: #6c757d;"># 程序入口</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">check_env.dll</span> <span style="color: #6c757d;"># 环境检测器源码</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">config.py</span> <span style="color: #6c757d;"># 配置文件 (JQL、Token、目标平台等)</span></div>
    <div><span style="color: #d63384;">├──</span> <span style="display: inline-block; width: 320px;">config.ini</span> <span style="color: #6c757d;"># 配置文件 (运行间隔时间，默认60分钟)</span></div>
    <div><span style="color: #d63384;">└──</span> <span style="display: inline-block; width: 320px;">chromedriver.exe</span> <span style="color: #6c757d;"># 需要下载对应版本</span></div>
  </div>
</div>

## 快速开始 | Quick Start

### 安装步骤 | Installation Steps

##### v1.4.0-beta (2026-08-05)

1. **下载程序文件**
   - 下载 `自动化循环执行问题同步助手.zip` 到本地电脑
   - 右键点击文件，选择"解压到当前文件夹"或"全部解压..."

2. **准备运行环境**
   - 解压后运行`test_env.exe` 可现实检测环境状态（[WARN] 缺少 Chromedriver。建议下载版本: 109.0.5414.120
按回车键重试，或按 'q' 键退出程序:）
   - 根据 *建议下载版本号* 下载对应版本（大版本号保持一致）
   - 国内镜像站[下载地址](https://repo.huaweicloud.com/chromedriver/)    **<<-- 点击即可前往下载**
   - 下载解压后，解压文件夹中的`chromedriver.exe`复制到文件夹下
       
![chromedriver](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/%E7%B2%98%E8%B4%B4chromedriver.png)

3. **启动程序**
   - 双击 `自动化循环执行问题同步助手.exe` 文件即可启动程序

##### v1.3.0-beta (2026-08-03) 之前版本

1. **下载程序文件**
   - 下载 `自动化循环执行问题同步助手.zip` 到本地电脑
   - 右键点击文件，选择"解压到当前文件夹"或"全部解压..."

2. **准备运行环境**
   - 解压后运行`main.exe` 可现实检测环境状态（[WARN] 缺少 Chromedriver。建议下载版本: 109.0.5414.120
按回车键重试，或按 'q' 键退出程序:）
   - 根据 *建议下载版本号* 下载对应版本（大版本号保持一致）
   - 国内镜像站[下载地址](https://repo.huaweicloud.com/chromedriver/)    **<<-- 点击即可前往下载**
   - 下载解压后，解压文件夹中的`chromedriver.exe`复制到文件夹下
    
![chromedriver](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/%E7%B2%98%E8%B4%B4chromedriver.png)

3. **启动程序**
   - 双击 `自动化循环执行问题同步助手.exe` 文件即可启动程序

### 使用步骤 | Usage Steps

##### v1.4.0-beta (2026-08-05)

1. 将下载好匹配的`chromedriver.exe`复制到文件夹下。

2. 直接运行程序修改配置。

3. 点击`立即运行`。

##### v1.3.0-beta (2026-08-03) 之前版本

1. **配置运行间隔时间**
	- 编辑`config.ini`文件
	- 编辑`IntervalMinutes=`数字（单位：分钟min，建议时间设置30分钟以上，同步超时时间20分钟，设置较短可能会打开同时打开多个程序）
	
![config.ini](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/config_ini.png)

2. **修改运行模式及自动化配置**
	- 编辑`config.py`文件
	
![config.py](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/config_py.png)

3. **运行`自动化循环执行问题同步助手.exe`**
	- 点击`自动化循环执行问题同步助手.exe`
	
![运行](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/%E5%AE%9A%E6%97%B6%E8%B0%83%E5%BA%A6%E5%99%A8.png)

4. **查看运行日志**
	- 记事本打开`sync_log.txt`
	
![sync_log](https://gitee.com/NoSloth/picbed/raw/master/jira-sync-cron/log_txt.png)

---

## 更新记录 | Version History

### v1.4.0-beta (2026-08-05)

- 核心架构升级：重构底层调度逻辑，实现的“无限循环”与静默执行，任务结束后自动进入倒计时并唤醒下一次同步。
- 可视化监控面板：全新引入 GUI 控制台，提供“运行日志”与“业务同步日志”双视窗实时刷新，任务状态与进度一目了然。
- 动态配置热更新：支持在面板内直接修改 URL、Token、JQL 等核心参数，修改后自动热更新并保存至 config.py，告别手动编辑。
- 极致静默体验：从底层消除 chromedriver 运行时产生的黑窗口闪烁，实现后台无感运行，彻底告别控制台干扰。
- 编码兼容优化：重构子进程输出捕获机制，完美兼容 GBK/UTF-8 混合编码，彻底解决中文乱码与 UI 假死（未响应）问题。
- 状态守护机制：内置智能状态机与异常中断保护，支持随时手动启停，确保自动化流程高可用。

### v1.3.0-beta (2026-08-03)

- 修改超时问题，超时检测改为1800s
- 添加显示进度功能
- dll修改
- 环境检测仅运行一次，在 scheduler.c 中调用

### v1.2.4-beta (2026-07-29)

- 修改超时问题，超时检测改为1200s
- 添加倒计时功能，修复时间结束不自启功能
- 修复时间结束不自启
- 修复 同步按钮 无法正常点击
- 动态读取配置文件

---