Log Service for Django CMS - 智能版
=================================

简介
----
此日志服务提供两种智能日志管理：
1. 持久型日志 (persistent): 自动行数管理，超过限制自动删除最早内容
2. 追踪型日志 (track): 适合任务进度跟踪，追加写入不清空历史

核心特性
-------
- 单一读取接口，简化路由配置
- 智能行数管理，无需手动清空
- 基于日志类型的自动处理策略
- BS5模态框实时查看
- 进度自动检测和显示

使用方法
-------

1. 后端写入：
# 持久型日志（自动管理行数）
log_service.write_log('task_id', '消息内容', log_type='persistent')

# 追踪型日志（追加不清空）
log_service.write_log('task_id', '进度消息', log_type='track')

2. 前端查看：
<!-- 简单包含 -->
{% include "log_service/includes/log_modals.html" %}

<!-- 触发按钮 -->
<button onclick="showLogModal('your_task_id')">查看日志</button>

<!-- 带进度显示的按钮 -->
<button onclick="showLogModal('your_task_id', {showProgress: true})">
    查看进度
</button>

配置选项
-------
showProgress: true/false    # 是否显示进度条
refreshInterval: 毫秒数      # 刷新间隔（默认2000）
autoRefresh: true/false     # 是否自动刷新

注意事项
-------
1. 日志文件存储在项目根目录的logs文件夹中
2. 持久型日志默认最多保存500行，可通过max_lines参数调整
3. 确保logs目录有写入权限
4. 大量并发任务时适当调整刷新频率

文件结构
-------
apps/
└── log_service/
    ├── __init__.py
    ├── services.py     # 核心服务类
    ├── views.py        # 只读视图
    ├── urls.py         # 简化路由
    └── templates/
        └── log_service/
            └── includes/
                └── log_modals.html  # 所有前端组件

更新日志
-------
v2.0 - 智能优化版
- 简化路由，只保留读取接口
- 智能日志类型管理
- 自动行数控制
- 优化前端集成体验