8215ffb59cf0a18


本资源为专为FreshUI框架定制的访客记录插件源码，是开发者在Jamiexu大佬原始插件基础上进行全功能重构的二次开发成果。本次升级历经24小时集中攻关，对数据采集精度、存储机制及可视化呈现进行了全面优化，为FreshUI用户提供更专业的访问行为分析工具。

二次开发核心突破

  1. ​数据采集层增强​
    • 新增7项访客属性记录（含屏幕分辨率/色彩深度）
    • 精准时区识别（GMT±智能转换）
    • 搜索引擎爬虫标记（识别Google/Bing等20+爬虫）
  2. ​存储架构重构​
    • 原始单文件存储改为分表结构（日表自动创建）
    • 数据压缩算法升级（Zstandard替代Gzip）
    • 敏感信息脱敏处理（IP地址模糊化存储）
  3. ​可视化方案创新​
    • 实时访客地图（Canvas热力图层渲染）
    • 时段流量波形图（SVG动态绘制）
    • 设备类型环形图（移动端/PC端占比）

技术实现细节

javascript复制// 核心数据记录逻辑（新增属性采集）
function logVisitor() {
  const enhancedData = {
    ...JamiexuBasePlugin.getBasicInfo(), // 继承原有基础字段
    colorDepth: window.screen.colorDepth,
    pixelRatio: window.devicePixelRatio,
    timezoneOffset: new Date().getTimezoneOffset()
  }
  Database.write('visitors_'+getDateTableSuffix(), enhancedData)
}

部署适配说明

  1. ​环境依赖​
    • FreshUI 2.1+（需启用Plugin API）
    • Node.js 14+（仅后台数据处理模块）
    • SQLite3/MySQL 5.7+（存储引擎可选）
  2. ​安装流程​
    • 解压至 /plugins/visitor-stats/
    • 在FreshUI控制台激活插件
    • 执行 npm install --production（安装Zstandard依赖）
  3. ​配置项路径​
    • 数据保留周期：/config/retention-period.json
    • 爬虫过滤名单：/config/crawlers-whitelist.json
    • 热力图渲染参数：/config/heatmap-style.json

性能优化成果

经压力测试验证：

  • 万条记录写入耗时 ≤1.2秒（原始版8.7秒）
  • 实时地图渲染帧率 ≥45fps（原始版12fps）
  • 数据存储体积缩减63%（Zstandard压缩比优势）

该二次开发版本完整保留Jamiexu插件的所有基础能力，同时在/docs/migration-guide.md中提供原始数据迁移方案，确保用户无缝过渡至增强版。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。