61 平台日志分析模块（仅新统一平台 /data/services 生效）：
- 新增 assets/system/61_platform_log_check.sh：18 服务三组检测
  （core 10 完整含活跃性 / dubbo 2 只检文件+ERROR / missing 6 固定严重），
  ERROR 密度 + 最近 ERROR 时间节点 + 汇总行，KEY 规范 LOGCHK_<大写>_<项> 且每项独立 _LEVEL
- config.sh.template：服务清单 3 组 + 阈值 5 键（静默 15/60min、密度 50/100、窗口 2000 行）
- check_modules 注册（仅 full 套件）+ 阈值白名单；display_names 130 键；测试 +4 用例

一并入库此前遗留（HANDOFF §7 应提交清单）：
- logger 迁移至 utils.logger（compare/notification/report/runner/statistics/target_service + check_modules）
- executor 上传强制 LF + assets/*.sh CRLF 修复
- report_service check_missing 仅查定时目标；runner_service 通知留痕 + 僵尸运行清理
- tests/conftest.py 同步

其他：
- HANDOFF §16 记录本模块设计/踩坑/验证
- .gitignore 追加 data/report_index.json（运行时数据勿入库）

验证：5.44 真实机 1.5s/106 键全 PASS；5.60 部署后旧平台短路正确；全量回归 94 用例通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>

- 归档文件追加 §15 详述精简方案（677→146）、HANDOFF.md 章节重构、提交 06369d48
- HANDOFF.md 顶部状态行 + §6 速览表 + §8 下一步同步更新
Co-Authored-By: Claude <noreply@anthropic.com>

- HANDOFF.md 由 677 行精简为 146 行：保留运维拓扑/部署方式/踩坑清单/进度速览/遗留清单/下一步
- 新增 HANDOFF_归档_2026-09-01.md 存档完整历史会话进度（§8-§14 可按会话编号检索）
- 记录 5.202 定时任务 end_date 过期修复与部署（7249d355 + 运维延长 2027-08-31）
Co-Authored-By: Claude <noreply@anthropic.com>

- _calc_next_run 感知 end_date：已过期或下一跳超出 end_date 时返回 None
- list_schedules 附加 is_expired 派生字段，前端展示"已过期/已失效"状态
- Schedule.vue 增加已过期徽标与"下次执行：已失效"，禁用过期任务启用按钮
- 新增 8 个 end_date 相关单测用例
- 输出 PRD 问题处理/计划执行两份文档（5.202 定时任务 end_date 过期）
Co-Authored-By: Claude <noreply@anthropic.com>

- 报告 token 评估结论：维持 7 天有效期、不加访问次数限制，报告 14 天清理兜底
- 清理仓库根/deploy/ 下无引用的一次性诊断探针脚本（check_*/_diag*/debug_*/tmp_test 等，多数含硬编码明文密码）
- 保留已跟踪正式文件与可复用运维脚本（trigger_*/fix_*/upload_docs* 等）
Co-Authored-By: Claude <noreply@anthropic.com>

后端报告详情接口校验访问 token，允许访客只读查看；前端路由、详情 API 与导出链接透传 token，并避免无效 token 误跳登录；新增 token 有效、过期及越权回归测试。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

- fix: 5.44 签名 ensure_ascii=True 修复含中文保存失败
- fix: 5.44 下载文件名 basename 净化修复 500
- fix: server.py assets 处理 + VUE_DIST_DIR 修复 assets 302
- fix: server.py 页面跳转 url_for 硬编码修复 500
- chore: 部署脚本重构为 systemd 模式 + 全量重建 dist
- chore: upload_to_server.py 补充 pycryptodome 依赖
- docs: 更新 HANDOFF 服务管理文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 five44_client.py 代理客户端，完整移植 5.44 认证签名算法
- 重构 service_manage.py 业务层，接入 5.44 代理转发（含自动重登）
- 更新路由层，授权/项目/文档操作全部支持代理模式
- 未配置目标时自动降级本地占位，保持向后兼容
- 授权页面 JS 完整实现（下载/上传/保存/回填）
- 基础模板新增 Toast 通知系统
- 整理 8 份 PRD 文档到 Docs/服务管理/ 分类目录
- 更新 HANDOFF 交接文档记录当前进度
- 238 单元测试全部通过
Co-Authored-By: Claude <noreply@anthropic.com>

更新 HANDOFF_服务监测.md，记录阶段十四（C6 报告缺失兜底告警）的完整实现细节：
- notification_service.py: 报告缺失告警配置与发送
- report_service.py: check_missing_reports 检测函数
- schedule_service.py: 每天 UTC 01:30 定时检测
- routes.py: 检查缺失报告 API
- Frontend: 通知配置卡片 + 统计页红色告警横幅
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增服务授权模块：下载激活文件、上传授权文件、轮询任务状态
- 新增目标服务器管理：CRUD + 密码加密 + 连接测试
- 新增项目信息管理：保存/读取项目信息（销售/部署/密码/概述）
- 新增部署视图自检文档：模板下载 + 上传回传
- 前端 Authorization.vue 四步流程界面 + Targets.vue 目标管理页
- 后端 14 个 API 端点，管理员权限校验 + 审计日志
- 后端三层架构：routes/service_manage.py + services/service_manage.py + utils/paths.py
- 新增测试用例 test_service_manage.py
- 版本号分散配置（.env.example 新增 BACKEND/FRONTEND_VERSION）
- 服务监测增强：健康度趋势分析、通知服务、统计视图
- 问题排查优化：AI 服务支持自定义 model、离线模式 record_id
- 易用性优化：搜索面板组件、本地缓存、FAQ 面板优化
- PRD 文档：服务管理功能升级 + 易用性优化
Co-Authored-By: Claude <noreply@anthropic.com>

记录 SSH sudo 自动检测 + Docker 权限适配 + 5.60 部署环境修复全过程
Co-Authored-By: Claude <noreply@anthropic.com>

记录 SSH sudo 自动检测功能实现过程和踩坑
Co-Authored-By: Claude <noreply@anthropic.com>

- SSHExecutor 连接后自动检测用户是否为 root
- 非 root 用户自动检测 docker 是否可直接执行
- docker 需要权限时自动启用 sudo 提权
- 尝试用 SSH 密码自动配置免密 sudoers
- Docker 检测脚本新增 _detect_docker_sudo() 自动适配
- 前端目标管理增加 sudo 提权选项和编辑回填
- 新增 GET /api/service-monitor/targets/<id> API
Co-Authored-By: Claude <noreply@anthropic.com>

- product_service.py 新增 add_document/delete_document 方法
- routes/troubleshoot.py 新增 POST /documents/upload + DELETE /{id}/delete
- DocumentsPanel.vue 新增上传/删除按钮（管理员专属）
- FAQsPanel.vue 常见问题置空为「整理中」占位
- nginx.conf 新增 client_max_body_size 100m
- HANDOFF.md 更新会话交接文档
Co-Authored-By: Claude <noreply@anthropic.com>

新增问题排查模块双模式界面，根据 OFFLINE_MODE 自动切换：
- 在线模式：保持原有 AI 分析界面
- 离线模式：左侧产品树 + 右侧资料/FAQ 面板

后端：
- 新增 products.json 配置文件（9 个产品，28 份文档）
- 新增 product_service.py 产品服务模块
- 新增 5 个产品 API 端点
- SearchEngine 新增 search_by_product() 方法

前端：
- Index.vue 重写为模式切换入口
- 新增 OfflineIndex.vue 离线模式主布局
- 新增 ProductTree/DocumentsPanel/FAQsPanel 组件
- 新增 Product/Document/FAQ 类型定义

部署：
- Dockerfile 新增维护手册目录复制
- deploy_docker.py 支持中文文件名上传
Co-Authored-By: Claude <noreply@anthropic.com>

Docker 容器化部署下本级巡检问题修复：
- LocalExecutor 支持 SSH 到宿主机获取真实系统数据
- 新增 get_docker_host_ip() 自动检测宿主机 IP
- 本级目标列表显示警告提示
- docker-compose.yml 添加 extra_hosts + LOCAL_SSH_* 环境变量
- 禁止手动创建 localhost 目标（本级为内置目标）

上一会话遗留合并：
- 版本号+操作日志功能前端构建
- platform/service_manage 页面路由迁移到 Vue SPA
- docker_deploy.sh 添加 --update-fe 选项
Co-Authored-By: Claude <noreply@anthropic.com>

新增功能：
- 平台版本号：导航栏显示版本号，后端 /api/version 接口
- 操作日志：问题排查/服务监测/服务管理各自独立的操作日志页面
- 审计 API：/api/audit/logs、/api/audit/users、/api/audit/actions/<module>

Docker 容器化：
- Dockerfile 多进程架构（nginx + Flask + supervisord）
- nginx 配置：SPA 回退 + SSE 流式输出支持
- deploy/deploy_docker.py：一键部署脚本
Co-Authored-By: Claude <noreply@anthropic.com>

定时任务修复：
- 新增 _schedules_lock 防止 schedules.json 并发写入状态丢失
- _add_job() 添加 misfire_grace_time=3600/coalesce/max_instances
- _execute_scheduled_job 改为 threading.Thread 后台执行，不阻塞 APScheduler 线程

Docker 容器化：
- 重写 Dockerfile（python:3.11-slim + 单进程 + CRLF 修复）
- 重写 docker-compose.yml（单容器 + volume + 资源限制 + 健康检查）
- 新增 deploy/docker_deploy.sh 部署脚本
- 更新 .dockerignore 排除规则

搜索索引路径适配：
- utils/paths.py 新增 SEARCH_INDEX_DIR 常量
- search_engine.py 改用统一路径

文档：
- 新增定时任务问题处理 + 计划执行文档
- 新增 Vue 前端迁移任务清单
- 更新 HANDOFF 交接文档
Co-Authored-By: Claude <noreply@anthropic.com>

用于验证阶段九新增功能的部署状态：
- Compare API 验证
- Excel 导出验证
- PDF 导出验证（含 weasyprint 降级检测）
- Compare Export HTML 验证
Co-Authored-By: Claude <noreply@anthropic.com>

Co-Authored-By: Claude <noreply@anthropic.com>

问题：多个定时任务在同一秒触发时（如都在 09:00），
使用相同的 run_id（时间戳+"sched"），导致：
- 远程工作目录冲突
- _runs 字典冲突
- 后执行的覆盖前一个，只生成一份报告

修复：
- run_inspection_sync: run_id 加入 target_id 前缀 + uuid
- run_inspection: run_id 加入 uuid 替代 threading.get_ident()

影响：
- 定时任务可安全并发执行
- SSE 巡检也获得更强的唯一性保证

测试：167 个测试全绿
Co-Authored-By: Claude <noreply@anthropic.com>

阶段九 P2 功能增强：

Excel 导出（openpyxl）：
- Sheet 1：汇总信息（目标、套件、时间、统计）
- Sheet 2：检测明细（全量表格）
- 状态列条件格式（正常=绿、警告=黄、严重=红）
- 表头冻结

PDF 导出（weasyprint）：
- 使用 weasyprint 将 HTML 转 PDF
- 降级策略：不可用时返回可打印 HTML
- @page 分页规则 + 中文字体支持
- 打印按钮提示（降级模式）

路由改进：
- api_export_report() 重构避免重复代码
- 支持 format=excel/pdf 参数

前端：
- report.html 导出菜单新增两个选项

文档：
- PRD_需求文档_导出PDF_Excel格式.md
- PRD_计划执行_导出PDF_Excel格式.md

测试：167 个测试全绿 ✅Co-Authored-By: Claude <noreply@anthropic.com>

阶段九功能增强（P1 级）：

报告对比功能：
- 新增 compare_service.py 对比服务（5 类差异分类）
- 新增 API：对比 /reports/{id1}/compare/{id2}
- 新增 API：导出 /reports/{id1}/compare/{id2}/export
- 新增 compare.html 对比结果页模板
- report.html 新增"对比历史报告"按钮 + 弹窗
- 值变化阈值：默认 > 20%

异常项趋势告警：
- report_service.py 新增 check_consecutive_abnormal()
- runner_service.py 集成连续异常告警
- notification.html 新增告警配置区（阈值/级别/渠道）
- 冷却期机制：24 小时内不重复告警

文档：
- PRD_需求文档_报告对比功能.md
- PRD_需求文档_异常项趋势告警.md
- PRD_计划执行_报告对比功能.md
- PRD_计划执行_异常项趋势告警.md

测试：167 个测试全绿 ✅Co-Authored-By: Claude <noreply@anthropic.com>

阶段九规划（下次会话执行）：
- P1: 报告对比功能（对比两次巡检结果，差异高亮展示）
- P1: 异常项趋势告警（连续N次异常自动通知）
- P2: 导出 PDF/Excel 格式
Co-Authored-By: Claude <noreply@anthropic.com>

阶段八完成：
- 新增 480px 超小屏幕断点（9 个页面）
- 修正 statistics.html 筛选栏溢出
- 修正 notification.html 端口输入框溢出
- 修正 report.html 模块标题溢出
- run.html 进度条响应式高度
Co-Authored-By: Claude <noreply@anthropic.com>

9 个页面全面优化移动端响应式样式：
- base.html: 新增 480px 断点，顶栏/侧边栏/用户名紧凑化
- index.html: 480px 断点，卡片/按钮缩小，目标管理按钮全宽
- reports.html: 480px 断点，筛选框/报告行/批量栏紧凑化
- report.html: 480px 断点，汇总卡片/异常项/检测项紧凑化，
  模块标题 word-break 防溢出
- statistics.html: 修正 768px 筛选栏完全纵向堆叠（原 flex-wrap
  仍可溢出），趋势选择器纵向堆叠；新增 480px 断点
- schedule.html: 480px 断点，弹窗/星期按钮/时间选择器紧凑化
- targets.html: 480px 断点，表格行/操作按钮/弹窗紧凑化
- notification.html: 修正 768px 端口输入框固定宽度溢出问题，
  改为自适应；新增 480px 断点，开关/表单紧凑化
- run.html: 进度条高度响应式（12→10→8px），480px 断点巡检
  卡片紧凑化，完成横幅长文字 word-break

验证：218 个单元测试全绿，已部署到 5.60
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 PRD_需求文档_服务管理模块.md（页面结构、功能设计、交互流程）

- 新增 PRD_计划执行_服务管理模块.md（静态页面开发执行计划）

- 新增 HANDOFF_服务管理.md（模块交接文档，记录已完成项与下一步）
Co-Authored-By: Claude <noreply@anthropic.com>

检测项丰富化移植（阶段五）：
- 新增 56_fastdfs_check.sh FastDFS功能验证检测（重构版，仅状态检测）
- 新增 57_android_check.sh Android设备检测
- 新增 59_log_export_check.sh 配置日志导出检测
- 新增 60_repair_capability_check.sh 修复能力检测
- check_modules.py 注册 4 个新模块，移除 58_data_backup_check
- display_names.py 追加 85 个 KEY 映射
- parser.py 追加 7 个状态词映射

巡检防重复触发优化（阶段六）：
- runner_service.py 新增 get_running_for_target() 查询运行中巡检
- routes.py 新增 /api/service-monitor/run/status/<id> 端点
- routes.py SSE 流接口增加 409 防重检查
- run.html 前端检查运行状态，阻止重复触发
- index.html 巡检按钮增加预检查逻辑

移动端响应式优化（阶段七）：
- 9 个页面全面优化移动端布局
- base.html: 顶部栏/侧边栏紧凑化，用户名溢出省略
- index.html: 目标卡片/按钮布局优化
- report.html: 报告头纵向排列，状态文字防竖向换行
- reports/schedule/targets: 筛选栏纵向，表格卡片化
- run.html: 巡检卡片紧凑化，取消按钮全宽
- statistics.html: 概览卡片缩小，趋势筛选纵向

验证：218 个单元测试全绿，5.44 full 套件实测通过
Co-Authored-By: Claude <noreply@anthropic.com>

检测项丰富化移植全部完成（阶段一至四，共 10 个新模块）：
- full 套件模块数 30 → 36
- display_names.py 672 条映射
- 218 个单元测试全绿
- 已部署到 5.60
Co-Authored-By: Claude <noreply@anthropic.com>

新增 2 个检测模块（阶段四）：
- 54_file_permission_check.sh：文件权限检测（检查关键文件可执行权限）
- 55_cron_expected.sh：定时任务预期检测（检查预期crontab条目存在）

配套更新：
- check_modules.py 追加 2 个模块注册
- display_names.py 追加 10 个 KEY 映射

文档：PRD_需求文档_P3级移植.md + PRD_计划执行_P3级移植.md
Co-Authored-By: Claude <noreply@anthropic.com>

新增 4 个检测模块（阶段三）：
- 50_system_profile.sh：系统类型识别（平台/容器/ujava变体）
- 51_service_check.sh：平台服务检测（服务进程+端口监听）
- 52_config_ip_check.sh：配置IP检测（未授权IP扫描）
- 53_config_console_check.sh：Console配置检测（只检测不修复）

配套更新：
- check_modules.py 追加 4 个模块注册
- display_names.py 追加 35 个 KEY 映射
- parser.py 追加 2 个状态词映射
- config.sh.template 追加服务匹配模式+端口列表配置

文档：PRD_需求文档_P2级移植.md + PRD_计划执行_P2级移植.md + HANDOFF更新
Co-Authored-By: Claude <noreply@anthropic.com>

新增第 6 节「Git 提交记录」，记录：
- c0200115: 新增安全合规/中间件检测模块并修复状态等级误判
- 3f48af4c: 报告免登访问 + 监测统计模块 + 多项修复

包含完整 commit message 和分支状态说明
Co-Authored-By: Claude <noreply@anthropic.com>

检测项丰富化移植（阶段二）：
- 新增 39_middleware_conn.sh 中间件连接检测（Redis/MySQL/EMQX/FastDFS）
- 新增 46_security_deep.sh 安全合规深度检测（9类：弱密码/基线/可疑文件等）
- check_modules.py 注册 2 个新模块
- display_names.py 追加 36 个 KEY 映射
- thresholds.py 追加 6 个安全阈值
- config.sh.template 追加安全白名单 + EMQX 端口配置

状态等级误判修复：
- 39/46 脚本 LEVEL KEY 对齐为 <值KEY>_LEVEL 格式（与 _resolve_status 约定一致）
- 23_mysql_depth / 25_redis_depth 重构为 output_result 格式
- parser.py _VALUE_STATUS_MAP 补充 11 个异常状态词映射（兜底）

中间件端口检测逻辑重构：
- 改用服务自带工具 ping 优先（redis-cli/mysqladmin/curl API）
- 避免容器内无 ss/netstat 导致误判"端口未监听"

服务管理模块（附带）：
- routes/service_manage.py 新增授权/升级/信息页面路由
- templates/service_manage/ 新增 4 个模板

文档：更新 HANDOFF_服务监测.md 记录修复全过程 + 检测项丰富化 PRD
Co-Authored-By: Claude <noreply@anthropic.com>

- 报告免登访问：通知链接携带 token，免登录直接查看报告
- 操作鉴权：访客模式下点击其他模块跳转登录
- 监测统计模块：新增统计页面，ECharts 可视化图表
- 检测项趋势修复：状态类检测项显示友好提示
- 登录回跳：next 参数支持登录后回到原始页面
- 新增 8 个 PRD 文档：需求/计划执行/问题处理
Co-Authored-By: Claude <noreply@anthropic.com>

- 更新 HANDOFF.md 记录本轮所有改动（钉钉通知优化、toggle 修复、时区问题、FLASK_DEBUG 修复）
- 新增 Toggle 开关样式优化需求文档和计划执行文档
Co-Authored-By: Claude <noreply@anthropic.com>

增大尺寸(52x28)、加深禁用色(#d1d5db)、添加边框、
圆点阴影、hover 外发光，提升视觉对比度和可点击暗示。
Co-Authored-By: Claude <noreply@anthropic.com>

变更：移除 onpaste 限制，保留 oncopy/oncut 限制。
用户可以粘贴密钥，但无法从输入框复制出来。
Co-Authored-By: Claude <noreply@anthropic.com>

toggle-slider 的 pointer-events 默认为 auto，遮挡了
label 的点击传递。修复：
- slider 和 slider:before 加 pointer-events: none
- toggle-switch 加 cursor: pointer
- input 加 position: absolute

点击现在穿透 slider 到达 label，再由 label
传递到内部 checkbox input，toggle 正常工作。
Co-Authored-By: Claude <noreply@anthropic.com>

- 配置字段 webhook -> webhook_url，兼容旧字段加载
- 通知格式改为 Markdown，重点展示异常项详情
  - 严重项最多 5 项，警告项最多 3 项
  - 格式：模块：指标名 = 值（阈值：xxx）
  - 报告链接可点击跳转
- secret 输入框安全控制：禁止粘贴/复制/右键
- 测试消息同步改为 Markdown 格式
Co-Authored-By: Claude <noreply@anthropic.com>

_now() 和 _run_job_body 中的 datetime.now() 改为
datetime.now(SHANGHAI_TZ)，确保 last_run_at / created_at
等字段显示北京时间而非服务器 UTC 时间。
Co-Authored-By: Claude <noreply@anthropic.com>