django-simpletask5 0.2.2__tar.gz → 0.2.4__tar.gz

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-simpletask5
-Version: 0.2.2
+Version: 0.2.4
 Summary: Lightweight async task execution framework for Django
 Author-email: rRR0VrFP <rrr0vrfp@qq.com>
 Maintainer-email: rRR0VrFP <rrr0vrfp@qq.com>
@@ -180,6 +180,12 @@ DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS = 3600    # 默认 Pickup 超
 - **执行超时**（`timeout_seconds`）— 任务进入 `running` 状态后，必须在指定时间内完成，否则被 `StatusCheckExecutor` 标记超时。适用于保护实际执行不 hang 死。
 - **Pickup 超时**（`pickup_timeout_seconds`）— 任务创建后等待 Worker 消费的时间上限，也用于被拒绝回退后等待重新调度的保护。通常设得比执行超时更长，因为排队等待时间不可控。
 
+### 日志
+
+```python
+DJANGO_SIMPLETASK_LOG_INTERVAL = 300  # 死循环存活日志与异常节流日志的输出间隔（秒）
+```
+
 ### 归档
 
 ```python
@@ -368,6 +374,8 @@ python manage.py django_simpletask_sync_cronjobs
 
 同步后，用户可以在 Django Admin 中查看和修改 Cron 任务，被手动修改过的任务不会在后续同步中被覆盖（`is_modified_by_user` 标记保护）。
 
+> 注意：cron 表达式按 Django 的 `TIME_ZONE` 设置对应的本地时间解释。`USE_TZ=True` 时仍以本地时间计算触发时刻（存储为 UTC），例如 `TIME_ZONE = 'Asia/Shanghai'` 下 `30 14 * * *` 表示每天 14:30 本地时间触发。
+
 ## 内置执行器
 
 | 执行器 | 说明 |
@@ -392,6 +400,17 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 
 ## Releases
 
+### 0.2.4
+
+- **破坏性变更**: `TaskExecution` 主键由 `execution_id`（UUID）改为默认自增 `id`，`execution_id` 变为 `unique=True` 的唯一标识字段。已有数据库需要执行迁移 `0010_taskexecution_id_alter_taskexecution_execution_id`
+- **定期存活日志** — Worker 与 Crontab 主循环在长时间无消息/无任务时按 `DJANGO_SIMPLETASK_LOG_INTERVAL`（默认 300 秒）定期输出存活日志，并统一带时间戳格式，便于运维确认进程未死循环
+- **MQ 日志降噪** — MQ 消费/发布异常及 Redis 连接失败、锁续期失败改为 `error`/`warning` 级别且无堆栈（默认按间隔节流），避免刷屏；提供 `--debug` 时输出完整堆栈
+- **新增配置** — `DJANGO_SIMPLETASK_LOG_INTERVAL` 控制死循环存活日志与异常节流日志的输出间隔（秒）
+
+### 0.2.3
+
+- **Cron 时区修复** — cron 表达式改为按 Django `TIME_ZONE` 配置的本地时间解释，不再固定按 UTC 计算。`USE_TZ=True` 时使用 `timezone.localtime(now())` 作为 croniter 基准时间，非 UTC 时区下定时任务不再偏移；`USE_TZ=False` 保持原有本地时间行为不变
+
 ### 0.2.2
 
 - **抑制异步消息** — 新增 `_skip_publish` 机制，创建/更新/删除 Task 时可通过 `skip_publish()` 方法、`save(skip_publish=True)`、构造时传入 `skip_publish=True` 等方式禁止触发 RabbitMQ 消息通知

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/README.md

@@ -140,6 +140,12 @@ DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS = 3600    # 默认 Pickup 超
 - **执行超时**（`timeout_seconds`）— 任务进入 `running` 状态后，必须在指定时间内完成，否则被 `StatusCheckExecutor` 标记超时。适用于保护实际执行不 hang 死。
 - **Pickup 超时**（`pickup_timeout_seconds`）— 任务创建后等待 Worker 消费的时间上限，也用于被拒绝回退后等待重新调度的保护。通常设得比执行超时更长，因为排队等待时间不可控。
 
+### 日志
+
+```python
+DJANGO_SIMPLETASK_LOG_INTERVAL = 300  # 死循环存活日志与异常节流日志的输出间隔（秒）
+```
+
 ### 归档
 
 ```python
@@ -328,6 +334,8 @@ python manage.py django_simpletask_sync_cronjobs
 
 同步后，用户可以在 Django Admin 中查看和修改 Cron 任务，被手动修改过的任务不会在后续同步中被覆盖（`is_modified_by_user` 标记保护）。
 
+> 注意：cron 表达式按 Django 的 `TIME_ZONE` 设置对应的本地时间解释。`USE_TZ=True` 时仍以本地时间计算触发时刻（存储为 UTC），例如 `TIME_ZONE = 'Asia/Shanghai'` 下 `30 14 * * *` 表示每天 14:30 本地时间触发。
+
 ## 内置执行器
 
 | 执行器 | 说明 |
@@ -352,6 +360,17 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 
 ## Releases
 
+### 0.2.4
+
+- **破坏性变更**: `TaskExecution` 主键由 `execution_id`（UUID）改为默认自增 `id`，`execution_id` 变为 `unique=True` 的唯一标识字段。已有数据库需要执行迁移 `0010_taskexecution_id_alter_taskexecution_execution_id`
+- **定期存活日志** — Worker 与 Crontab 主循环在长时间无消息/无任务时按 `DJANGO_SIMPLETASK_LOG_INTERVAL`（默认 300 秒）定期输出存活日志，并统一带时间戳格式，便于运维确认进程未死循环
+- **MQ 日志降噪** — MQ 消费/发布异常及 Redis 连接失败、锁续期失败改为 `error`/`warning` 级别且无堆栈（默认按间隔节流），避免刷屏；提供 `--debug` 时输出完整堆栈
+- **新增配置** — `DJANGO_SIMPLETASK_LOG_INTERVAL` 控制死循环存活日志与异常节流日志的输出间隔（秒）
+
+### 0.2.3
+
+- **Cron 时区修复** — cron 表达式改为按 Django `TIME_ZONE` 配置的本地时间解释，不再固定按 UTC 计算。`USE_TZ=True` 时使用 `timezone.localtime(now())` 作为 croniter 基准时间，非 UTC 时区下定时任务不再偏移；`USE_TZ=False` 保持原有本地时间行为不变
+
 ### 0.2.2
 
 - **抑制异步消息** — 新增 `_skip_publish` 机制，创建/更新/删除 Task 时可通过 `skip_publish()` 方法、`save(skip_publish=True)`、构造时传入 `skip_publish=True` 等方式禁止触发 RabbitMQ 消息通知

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/core/cronjob_registry.py

@@ -38,7 +38,8 @@ def _compute_next_run_time(cron_expression, base=None):
     except ImportError:
         return None
     if base is None:
-        base = timezone.now()
+        now = timezone.now()
+        base = timezone.localtime(now) if timezone.is_aware(now) else now
     try:
         cron = croniter(cron_expression, base)
         return cron.get_next(datetime)

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/core/defaults.py

@@ -17,6 +17,7 @@ DJANGO_SIMPLETASK_LOCK_TIMEOUT = getattr(settings, 'DJANGO_SIMPLETASK_LOCK_TIMEO
 DJANGO_SIMPLETASK_LOCK_RENEW_INTERVAL = getattr(settings, 'DJANGO_SIMPLETASK_LOCK_RENEW_INTERVAL', 60)
 
 DJANGO_SIMPLETASK_SHUTDOWN_TIMEOUT = getattr(settings, 'DJANGO_SIMPLETASK_SHUTDOWN_TIMEOUT', 30)
+DJANGO_SIMPLETASK_LOG_INTERVAL = getattr(settings, 'DJANGO_SIMPLETASK_LOG_INTERVAL', 300)
 DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES = getattr(settings, 'DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES', 3)
 DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS = getattr(settings, 'DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS', 600)
 DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS = getattr(settings, 'DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS', 3600)

django_simpletask5-0.2.4/django_simpletask5/core/logging_utils.py

@@ -0,0 +1,17 @@
+import logging
+
+
+def setup_console_logging(level=logging.INFO):
+    """Ensure the root logger logs to console with a timestamped format."""
+    root = logging.getLogger()
+    root.setLevel(level)
+    formatter = logging.Formatter('%(asctime)s [%(levelname)s] %(name)s: %(message)s')
+    if not any(isinstance(h, logging.StreamHandler) for h in root.handlers):
+        handler = logging.StreamHandler()
+        handler.setFormatter(formatter)
+        handler.setLevel(level)
+        root.addHandler(handler)
+    for h in root.handlers:
+        if isinstance(h, logging.StreamHandler):
+            h.setFormatter(formatter)
+            h.setLevel(level)

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/core/message_queue.py

@@ -5,6 +5,8 @@ import time
 from django.conf import settings
 from kombu import Connection, Exchange, Queue, Producer, Consumer
 
+from django_simpletask5.core.defaults import DJANGO_SIMPLETASK_LOG_INTERVAL
+
 logger = logging.getLogger(__name__)
 
 
@@ -66,16 +68,20 @@ class KombuQueue:
                 accept=['json'],
             ):
                 last_poll = time.time()
+                last_heartbeat = time.time()
                 while not self._stopped:
                     try:
                         conn.drain_events(timeout=0.5)
                     except socket.timeout:
-                        pass
+                        now = time.time()
+                        if now - last_heartbeat >= DJANGO_SIMPLETASK_LOG_INTERVAL:
+                            last_heartbeat = now
+                            logger.info('No message received in the last %s seconds, worker alive', DJANGO_SIMPLETASK_LOG_INTERVAL)
                     if poll_callback and time.time() - last_poll >= poll_interval:
                         try:
                             poll_callback()
-                        except Exception:
-                            logger.exception('Poll callback failed')
+                        except Exception as e:
+                            logger.error('Poll callback failed: %s', e)
                         last_poll = time.time()
 
     @staticmethod
@@ -85,8 +91,8 @@ class KombuQueue:
             if result is False:
                 message.reject(requeue=True)
                 return
-        except Exception:
-            logger.exception('Error in message callback')
+        except Exception as e:
+            logger.error('Error in message callback: %s', e)
             message.reject(requeue=True)
             return
         if auto_ack:

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/core/publisher.py

@@ -129,12 +129,12 @@ def _publish_message(execution, routing_key=None):
             )
             logger.debug('Published message for execution %s', execution.execution_id)
             return
-        except Exception:
+        except Exception as e:
             if attempt < 3:
                 logger.warning('Publish attempt %d/3 failed for execution %s, retrying...', attempt, execution.execution_id)
                 time.sleep(1)
             else:
-                logger.exception('Failed to publish message for execution %s after 3 attempts', execution.execution_id)
+                logger.error('Failed to publish message for execution %s after 3 attempts: %s', execution.execution_id, e)
 
     try:
         execution.refresh_from_db()

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/executors/retry_timeout.py

@@ -10,7 +10,7 @@ from django_simpletask5.executors.base import BaseExecutor
 def _publish_message_by_id(execution_id):
     from django_simpletask5.core.publisher import _publish_message
     try:
-        exec_record = TaskExecution.objects.get(pk=execution_id)
+        exec_record = TaskExecution.objects.get(execution_id=execution_id)
         _publish_message(exec_record)
     except TaskExecution.DoesNotExist:
         logger.warning('Execution %s not found for retry publish', execution_id)
@@ -31,10 +31,10 @@ class RetryTimeoutExecutor(BaseExecutor):
         # Pickup timeouts — task was never picked up, don't consume retry
         pickup_ids = list(
             timeout_records.filter(started_at__isnull=True)
-            .values_list('pk', flat=True)
+            .values_list('execution_id', flat=True)
         )
         if pickup_ids:
-            TaskExecution.objects.filter(pk__in=pickup_ids).update(
+            TaskExecution.objects.filter(execution_id__in=pickup_ids).update(
                 status='retry',
             )
             for exec_id in pickup_ids:
@@ -45,10 +45,10 @@ class RetryTimeoutExecutor(BaseExecutor):
         # Execution timeouts — task was actually running, consume retry
         exec_ids = list(
             timeout_records.filter(started_at__isnull=False)
-            .values_list('pk', flat=True)
+            .values_list('execution_id', flat=True)
         )
         if exec_ids:
-            TaskExecution.objects.filter(pk__in=exec_ids).update(
+            TaskExecution.objects.filter(execution_id__in=exec_ids).update(
                 status='retry',
                 retry_count=models.F('retry_count') + 1,
             )

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/management/commands/django_simpletask_crontab.py

@@ -10,7 +10,8 @@ from django.utils import timezone
 
 from django_simpletask5.models import CronJob, TaskExecution
 from django_simpletask5.core.lock import get_lock_manager
-from django_simpletask5.core.defaults import DJANGO_SIMPLETASK_KEY_PREFIX, DJANGO_SIMPLETASK_LOCK_TIMEOUT, DJANGO_SIMPLETASK_DEFAULT_QUEUE, DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS, DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS
+from django_simpletask5.core.defaults import DJANGO_SIMPLETASK_KEY_PREFIX, DJANGO_SIMPLETASK_LOCK_TIMEOUT, DJANGO_SIMPLETASK_DEFAULT_QUEUE, DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS, DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS, DJANGO_SIMPLETASK_LOG_INTERVAL
+from django_simpletask5.core.logging_utils import setup_console_logging
 from django_simpletask5.executors.loader import load_executor_class
 
 logger = logging.getLogger(__name__)
@@ -43,13 +44,15 @@ class Command(BaseCommand):
         )
 
     def handle(self, *args, **options):
-        global _shutdown
+        global _shutdown, _redis_unavailable
+        setup_console_logging(logging.INFO)
         signal.signal(signal.SIGTERM, _signal_handler)
         signal.signal(signal.SIGINT, _sigint_handler)
 
         self.stdout.write('Starting crontab scheduler')
 
         lockman = get_lock_manager()
+        last_error_log = 0.0
 
         while not _shutdown:
             try:
@@ -60,13 +63,16 @@ class Command(BaseCommand):
             except Exception as e:
                 close_old_connections()
                 error_str = str(e)
-                if 'Connection refused' in error_str or 'Error 61' in error_str:
-                    global _redis_unavailable
-                    if not _redis_unavailable:
-                        _redis_unavailable = True
+                is_redis_err = 'Connection refused' in error_str or 'Error 61' in error_str
+                if is_redis_err:
+                    _redis_unavailable = True
+                now = time.time()
+                if now - last_error_log >= DJANGO_SIMPLETASK_LOG_INTERVAL:
+                    last_error_log = now
+                    if is_redis_err:
                         logger.warning('Redis connection failed: %s', e)
-                else:
-                    logger.exception('Error in crontab cycle: %s', e)
+                    else:
+                        logger.error('Error in crontab cycle: %s', e)
                 self._sleep_until(timezone.now() + timedelta(seconds=10))
 
         self.stdout.write('Crontab scheduler stopped.')
@@ -182,5 +188,7 @@ class Command(BaseCommand):
         transaction.on_commit(_publish_cronjob)
 
         from django_simpletask5.core.cronjob_registry import _compute_next_run_time
-        cronjob.next_run_time = _compute_next_run_time(cronjob.cron_expression, base=timezone.now())
+        now = timezone.now()
+        base = timezone.localtime(now) if timezone.is_aware(now) else now
+        cronjob.next_run_time = _compute_next_run_time(cronjob.cron_expression, base=base)
         cronjob.save(update_fields=['next_run_time'])

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/management/commands/django_simpletask_executor.py

@@ -19,9 +19,11 @@ from django_simpletask5.core.defaults import (
     DJANGO_SIMPLETASK_KEY_PREFIX,
     DJANGO_SIMPLETASK_LOCK_TIMEOUT,
     DJANGO_SIMPLETASK_SHUTDOWN_TIMEOUT,
+    DJANGO_SIMPLETASK_LOG_INTERVAL,
     DJANGO_SIMPLETASK_DEFAULT_QUEUE,
     DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS,
 )
+from django_simpletask5.core.logging_utils import setup_console_logging
 from django_simpletask5.core.worker_registry import (
     register_worker, update_worker_status, heartbeat_worker, _get_redis_client,
 )
@@ -59,6 +61,7 @@ _start_lock_renewer._started = False
 
 def _lock_renewer_loop():
     from django_simpletask5.core.defaults import DJANGO_SIMPLETASK_LOCK_RENEW_INTERVAL
+    last_log = 0.0
     while not _shutdown:
         time.sleep(DJANGO_SIMPLETASK_LOCK_RENEW_INTERVAL)
         with _active_locks_lock:
@@ -67,7 +70,10 @@ def _lock_renewer_loop():
             try:
                 lock_ctx.lock.reacquire()
             except Exception:
-                logger.debug('Failed to reacquire lock (execution may have completed, or Redis is down)')
+                now = time.time()
+                if now - last_log >= DJANGO_SIMPLETASK_LOG_INTERVAL:
+                    last_log = now
+                    logger.warning('Failed to reacquire lock (execution may have completed, or Redis is down), will keep retrying')
 
 
 def _signal_handler(signum, frame):
@@ -96,6 +102,8 @@ class ExecutorWorker:
         self.mq = mq
         self.lock_engine_down = False
         self._last_heartbeat = 0.0
+        self._last_register_log = 0.0
+        self._last_consume_error = 0.0
 
     def _heartbeat_if_needed(self):
         now = time.time()
@@ -119,9 +127,11 @@ class ExecutorWorker:
                     logger.info('Redis connection restored')
                 break
             except Exception:
-                if not _redis_unavailable:
-                    _redis_unavailable = True
-                    logger.warning('Redis connection failed, retrying in 2s...')
+                _redis_unavailable = True
+                now = time.time()
+                if now - self._last_register_log >= DJANGO_SIMPLETASK_LOG_INTERVAL:
+                    self._last_register_log = now
+                    logger.warning('Redis connection failed, retrying every 2s...')
                 time.sleep(2)
         update_worker_status('idle')
         logger.info('Worker listening on queue: %s (broker: %s)', self.queue_name, _get_broker_url())
@@ -138,7 +148,10 @@ class ExecutorWorker:
             except Exception as e:
                 if _shutdown:
                     break
-                logger.warning('Consumer connection lost (%s), restarting in 1s...', e)
+                now = time.time()
+                if now - self._last_consume_error >= DJANGO_SIMPLETASK_LOG_INTERVAL:
+                    self._last_consume_error = now
+                    logger.error('Consumer connection lost (%s), restarting in 1s...', e)
                 close_old_connections()
                 time.sleep(1)
 
@@ -300,8 +313,8 @@ class ExecutorWorker:
             self.mq.publish(routing_key=self.queue_name, message=retry_msg)
             logger.info('Published retry message for execution %s (attempt %d/%d)',
                         execution.execution_id, execution.retry_count, execution.max_retries)
-        except Exception:
-            logger.exception('Failed to publish retry message')
+        except Exception as e:
+            logger.error('Failed to publish retry message: %s', e)
 
 
 class Command(BaseCommand):
@@ -347,16 +360,8 @@ class Command(BaseCommand):
         signal.signal(signal.SIGINT, _signal_handler)
 
         debug = options['debug']
+        setup_console_logging(logging.DEBUG if debug else logging.INFO)
         if debug:
-            root = logging.getLogger()
-            root.setLevel(logging.DEBUG)
-            if not any(isinstance(h, logging.StreamHandler) for h in root.handlers):
-                handler = logging.StreamHandler()
-                handler.setLevel(logging.DEBUG)
-                handler.setFormatter(logging.Formatter('%(asctime)s [%(levelname)s] %(name)s: %(message)s'))
-                root.addHandler(handler)
-            for h in root.handlers:
-                h.setLevel(logging.DEBUG)
             self.stdout.write('Debug logging enabled')
 
         num_workers = options['workers']

django_simpletask5-0.2.4/django_simpletask5/migrations/0010_taskexecution_id_alter_taskexecution_execution_id.py

@@ -0,0 +1,31 @@
+# Generated by Django 5.2.16 on 2026-08-04 19:57
+
+import uuid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("django_simpletask5", "0009_add_cronjob_app_label"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="taskexecution",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="taskexecution",
+            name="execution_id",
+            field=models.UUIDField(
+                default=uuid.uuid4,
+                editable=False,
+                unique=True,
+                verbose_name="Execution ID",
+            ),
+        ),
+    ]

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5/models.py

@@ -152,7 +152,7 @@ class TaskExecution(models.Model):
         ('timeout', _('Timeout')),
     ]
 
-    execution_id = models.UUIDField(verbose_name=_('Execution ID'), primary_key=True, default=uuid.uuid4, editable=False)
+    execution_id = models.UUIDField(verbose_name=_('Execution ID'), unique=True, default=uuid.uuid4, editable=False)
     task_id = models.UUIDField(verbose_name=_('Task ID'), null=True, blank=True, db_index=True)
     task_model = models.CharField(verbose_name=_('Task model'), max_length=256, null=True, blank=True, help_text='app_label.ModelName')
     trigger_event = models.CharField(verbose_name=_('Trigger event'), max_length=64, db_index=True)

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-simpletask5
-Version: 0.2.2
+Version: 0.2.4
 Summary: Lightweight async task execution framework for Django
 Author-email: rRR0VrFP <rrr0vrfp@qq.com>
 Maintainer-email: rRR0VrFP <rrr0vrfp@qq.com>
@@ -180,6 +180,12 @@ DJANGO_SIMPLETASK_DEFAULT_PICKUP_TIMEOUT_SECONDS = 3600    # 默认 Pickup 超
 - **执行超时**（`timeout_seconds`）— 任务进入 `running` 状态后，必须在指定时间内完成，否则被 `StatusCheckExecutor` 标记超时。适用于保护实际执行不 hang 死。
 - **Pickup 超时**（`pickup_timeout_seconds`）— 任务创建后等待 Worker 消费的时间上限，也用于被拒绝回退后等待重新调度的保护。通常设得比执行超时更长，因为排队等待时间不可控。
 
+### 日志
+
+```python
+DJANGO_SIMPLETASK_LOG_INTERVAL = 300  # 死循环存活日志与异常节流日志的输出间隔（秒）
+```
+
 ### 归档
 
 ```python
@@ -368,6 +374,8 @@ python manage.py django_simpletask_sync_cronjobs
 
 同步后，用户可以在 Django Admin 中查看和修改 Cron 任务，被手动修改过的任务不会在后续同步中被覆盖（`is_modified_by_user` 标记保护）。
 
+> 注意：cron 表达式按 Django 的 `TIME_ZONE` 设置对应的本地时间解释。`USE_TZ=True` 时仍以本地时间计算触发时刻（存储为 UTC），例如 `TIME_ZONE = 'Asia/Shanghai'` 下 `30 14 * * *` 表示每天 14:30 本地时间触发。
+
 ## 内置执行器
 
 | 执行器 | 说明 |
@@ -392,6 +400,17 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 
 ## Releases
 
+### 0.2.4
+
+- **破坏性变更**: `TaskExecution` 主键由 `execution_id`（UUID）改为默认自增 `id`，`execution_id` 变为 `unique=True` 的唯一标识字段。已有数据库需要执行迁移 `0010_taskexecution_id_alter_taskexecution_execution_id`
+- **定期存活日志** — Worker 与 Crontab 主循环在长时间无消息/无任务时按 `DJANGO_SIMPLETASK_LOG_INTERVAL`（默认 300 秒）定期输出存活日志，并统一带时间戳格式，便于运维确认进程未死循环
+- **MQ 日志降噪** — MQ 消费/发布异常及 Redis 连接失败、锁续期失败改为 `error`/`warning` 级别且无堆栈（默认按间隔节流），避免刷屏；提供 `--debug` 时输出完整堆栈
+- **新增配置** — `DJANGO_SIMPLETASK_LOG_INTERVAL` 控制死循环存活日志与异常节流日志的输出间隔（秒）
+
+### 0.2.3
+
+- **Cron 时区修复** — cron 表达式改为按 Django `TIME_ZONE` 配置的本地时间解释，不再固定按 UTC 计算。`USE_TZ=True` 时使用 `timezone.localtime(now())` 作为 croniter 基准时间，非 UTC 时区下定时任务不再偏移；`USE_TZ=False` 保持原有本地时间行为不变
+
 ### 0.2.2
 
 - **抑制异步消息** — 新增 `_skip_publish` 机制，创建/更新/删除 Task 时可通过 `skip_publish()` 方法、`save(skip_publish=True)`、构造时传入 `skip_publish=True` 等方式禁止触发 RabbitMQ 消息通知

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/django_simpletask5.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ django_simpletask5/core/cronjob_registry.py
 django_simpletask5/core/defaults.py
 django_simpletask5/core/executor_scanner.py
 django_simpletask5/core/lock.py
+django_simpletask5/core/logging_utils.py
 django_simpletask5/core/message_queue.py
 django_simpletask5/core/publisher.py
 django_simpletask5/core/signals.py
@@ -48,6 +49,7 @@ django_simpletask5/migrations/0006_alter_cronjob_options_alter_taskexecution_cre
 django_simpletask5/migrations/0007_rename_task_model_to_executor_class_in_stat.py
 django_simpletask5/migrations/0008_taskexecution_pickup_timeout_seconds.py
 django_simpletask5/migrations/0009_add_cronjob_app_label.py
+django_simpletask5/migrations/0010_taskexecution_id_alter_taskexecution_execution_id.py
 django_simpletask5/migrations/__init__.py
 django_simpletask5/services/__init__.py
 django_simpletask5/services/archive.py

{django_simpletask5-0.2.2 → django_simpletask5-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "django-simpletask5"
-version = "0.2.2"
+version = "0.2.4"
 description = "Lightweight async task execution framework for Django"
 readme = "README.md"
 license = {text = "MIT"}