🐧 Linux.do 论坛数据分析工具

🌟 一个现代化的 Linux.do 论坛个人数据分析工具，提供全面的数据可视化和深度分析功能。

📦 核心信息

📊 下载和社交统计

✅ 构建和安全状态

🌐 平台和兼容性

📅 维护和发布信息

🚀 快速开始

🌐 在线体验: https://linux-do-analyzer.jhun.edu.kg/

📦 NPM 安装: npm install -g linux-do-analyzer

🔧 NPX 使用: npx linux-do-analyzer

✨ 项目概述

这是一个专为 Linux.do 论坛用户设计的数据分析工具，采用纯前端技术栈构建，支持本地 ZIP 文件上传和实时数据分析。用户可以将从论坛导出的个人数据包上传到工具中，获得详细的多维度数据分析报告和精美的可视化图表。

🚀 安装和使用

🌐 在线直接使用

无需安装，直接访问：https://linux-do-analyzer.jhun.edu.kg/

⚡ 打开即用，支持所有浏览器，完全免费！

全局安装

npm install -g linux-do-analyzer
# 或使用 yarn
yarn global add linux-do-analyzer
# 或使用 pnpm
pnpm add -g linux-do-analyzer

使用 CLI 命令

# 启动服务器（默认端口 8080）
linux-do-analyzer

# 指定端口启动
linux-do-analyzer --port 3000

# 开发模式启动
linux-do-analyzer --dev

# 查看帮助
linux-do-analyzer --help

# 查看版本
linux-do-analyzer --version

无需安装，直接使用：

# 使用 npx 启动（默认端口 8080）
npx linux-do-analyzer

# 指定端口
npx linux-do-analyzer --port 3000

# 开发模式
npx linux-do-analyzer --dev

使用 pnpm 的 npx 等价工具：

# 使用 pnpx 启动
pnpx linux-do-analyzer

# 指定端口
pnpx linux-do-analyzer --port 3000

# 开发模式
pnpx linux-do-analyzer --dev

克隆项目

git clone https://github.com/dext7r/linux-do-analyzer.git
cd linux-do-analyzer

使用 Node.js

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 启动生产服务器
npm start

# 指定端口启动
npm run serve -- --port 3000

使用 Deno

# 启动开发服务器（支持文件监听）
deno task dev

# 启动生产服务器
deno task serve

# 预览服务器（3000端口）
deno task preview

使用其他工具

# 使用 Python
python -m http.server 8080

# 使用 live-server
npx live-server --port=8080

# 使用 serve
npx serve -p 8080

🎯 核心特性

• 👥 用户活跃度分析 - 访问量趋势、阅读时长统计、发帖活动分布
• 💬 社交互动分析 - 点赞给出/收到分析、话题参与度评估
• 🏆 成就系统分析 - 徽章获得时间线、信任等级进展追踪
• 📱 设备使用分析 - 访问设备类型、浏览器分布、地理位置统计
• 📂 内容分类分析 - 各板块活跃度、发帖主题分布

• 📱 响应式设计 - 完美适配桌面端、平板和移动设备
• 🌈 渐变背景 - 科技感十足的深色主题和动态背景效果
• 🎮 交互式图表 - 基于 Chart.js 的高质量数据可视化
• 🎯 卡片式布局 - 清晰的信息层级和优雅的视觉呈现
• ✨ 动画效果 - 流畅的页面加载和交互动画

• 💯 100% 本地处理 - 所有数据分析完全在浏览器中进行
• 🚫 无服务器上传 - 文件不会被上传到任何服务器
• ⚡ 即时分析 - 实时解析和分析，无需等待
• 🔍 数据完整性 - 全面验证数据文件的完整性和有效性

🛠️ 技术架构

• 🎨 TailwindCSS - 现代化 CSS 框架，快速构建响应式界面
• 📊 Chart.js - 强大的图表可视化库
• 🗂️ JSZip - 客户端 ZIP 文件解析和处理
• 💫 jQuery - DOM 操作和事件处理
• 🎯 FontAwesome - 丰富的图标库

js/
├── app.js              # 主应用程序入口和初始化
├── data-manager.js     # 数据存储和管理（IndexedDB）
├── zip-parser.js       # ZIP 文件解析和数据提取
├── data-analyzer.js    # 多维度数据分析引擎
├── chart-renderer.js   # 图表渲染和可视化
└── ui-manager.js       # 用户界面管理和交互控制

• 🧩 模块化设计 - 清晰的功能模块分离，便于维护和扩展
• 🔄 异步处理 - 非阻塞的文件处理和数据分析
• 📦 内存优化 - 高效的数据处理和垃圾回收机制
• ⚠️ 错误处理 - 完善的错误捕获和用户友好的错误提示

📋 使用指南

1. 📝 访问个人设置页面

   • 登录 Linux.do 论坛
   • 进入 账户设置页面

2. 📤 请求数据导出

   • 滚动到页面底部，找到 "下载我的档案" 部分
   • 点击 "请求下载" 按钮
   • 等待系统处理（通常几分钟内完成）

3. 下载数据包

   • 查收邮件通知（检查垃圾邮件箱）
   • 点击邮件中的下载链接
   • 下载 ZIP 格式的数据包（注意：文件大小需小于 10MB）

1. 访问分析工具

   • 使用上述任一方式启动服务器
   • 在浏览器中访问对应地址

2. 上传数据文件

   • 拖拽方式：直接将 ZIP 文件拖拽到上传区域
   • 点击选择：点击上传区域选择文件
   • 支持的文件类型：仅限 .zip 格式

3. 等待分析完成

   • 上传后自动开始解析和分析
   • 显示实时进度条和处理状态
   • 整个过程通常在几秒内完成

4. 查看分析报告

   • 分析完成后自动展示结果
   • 包含多个维度的数据可视化图表
   • 支持交互式图表操作

• 📊 查看已存储数据 - 查看之前分析过的数据
• 📤 导出分析结果 - 将分析数据导出为 JSON 格式
• 🗑️ 清空所有数据 - 清除本地存储的所有分析数据

📂 支持的数据文件

| 文件名 | 状态 | 包含内容 | 分析功能 | |--------|------|----------|----------| | user_archive.csv | 必需 | 用户发帖和话题数据 | 发帖统计、主题分析、分类活跃度 | | preferences.json | 必需 | 用户偏好和个人信息 | 用户信息展示、基础统计 | | visits.csv | 可选 | 每日访问记录 | 访问趋势图表、活跃度分析 | | likes.csv | 可选 | 点赞行为记录 | 点赞活动分析、互动统计 | | user_badges.csv | 可选 | 徽章获得记录 | 成就时间线、徽章统计 | | auth_tokens.csv | 可选 | 登录设备信息 | 设备分析、安全统计 | | bookmarks.csv | 可选 | 书签收藏记录 | 收藏行为分析 | | user_flags.csv | 可选 | 举报记录 | 举报行为统计 |

📈 分析报告内容

• 📝 发帖总数 - 用户发布的帖子和回复数量
• 👍 点赞统计 - 给出和收到的点赞数量
• 🏆 徽章成就 - 获得的各类徽章数量
• 📊 访问统计 - 论坛访问天数和频率
• 🎆 信任等级 - 当前信任级别和进展

1. 每日访问活动图 - 最近 60 天的访问趋势线图
2. 徽章获得时间线 - 徽章获得的时间分布图
3. 设备使用分布图 - 访问设备类型的饼图统计
4. 发帖活动热力图 - 24 小时发帖活动分布
5. 点赞活动趋势图 - 点赞行为的时间趋势分析

• 发帖记录 - 完整的帖子和回复列表
• 访问记录 - 详细的每日访问数据
• 点赞记录 - 点赞和被点赞的详细记录
• 徽章记录 - 徽章获得的完整时间线
• 认证令牌 - 登录设备和会话信息
• 书签和举报 - 收藏和举报的详细记录

• 分类活动分析 - 各个板块的参与度统计
• 数据完整性评估 - 数据文件的完整性检查
• 用户行为模式 - 活跃时间段和使用习惯分析

🌐 部署选项

GitHub Pages

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/username/repository-name.git
git push -u origin main

Vercel/Netlify

• 连接 Git 仓库自动部署
• 零配置，支持自动构建

更多平台

• Deno Deploy - 推荐使用
• Cloudflare Pages
• Firebase Hosting
• AWS S3 + CloudFront

🔒 隐私安全

• ✅ 100% 本地处理 - 所有数据分析完全在浏览器中进行，不会上传到任何服务器
• ✅ 零数据收集 - 工具不收集、存储或传输任何用户数据
• ✅ 离线可用 - 分析功能完全离线，无需网络连接
• ✅ 即时删除 - 关闭浏览器标签页后，所有数据自动清除
• ✅ 开源透明 - 所有源代码公开，可自行审查和部署

• 文件类型验证 - 严格验证上传文件格式，仅接受 ZIP 文件
• 内存处理 - 数据仅在浏览器内存中临时处理，不写入磁盘
• 沙盒环境 - 浏览器天然的安全沙盒环境保护
• 无第三方追踪 - 不使用任何第三方分析或追踪工具

🛠️ 开发信息

Node.js 环境

npm run start      # 启动服务器
npm run dev        # 开发模式
npm run serve      # 生产模式

Deno 环境

deno task serve    # 启动静态文件服务器
deno task dev      # 开发模式（支持文件监听）
deno task preview  # 预览服务器（3000端口）
deno task fmt      # 代码格式化
deno task lint     # 代码检查
deno task check    # 类型检查

📁 linux-do-analyzer/
├── 📄 server.js               # Node.js 服务器
├── 📄 package.json            # NPM 包配置
├── 📁 bin/                    # CLI 可执行文件
│   └── 📄 cli.js              # 命令行接口
├── 📄 index.html              # 主界面文件
├── 📄 deno.json               # Deno 配置文件
├── 📄 README.md               # 项目说明文档
├── 📁 js/                     # JavaScript 模块
│   ├── 📄 app.js              # 主应用程序
│   ├── 📄 data-manager.js     # 数据管理模块
│   ├── 📄 zip-parser.js       # ZIP 文件解析器
│   ├── 📄 data-analyzer.js    # 数据分析引擎
│   ├── 📄 chart-renderer.js   # 图表渲染器
│   └── 📄 ui-manager.js       # 界面管理器
└── 📁 css/                    # 样式文件
    └── 📄 style.css           # 自定义样式

| 模块 | 功能描述 | 主要特性 | |------|----------|----------| | app.js | 应用主入口 | 模块初始化、事件绑定、错误处理 | | data-manager.js | 数据存储管理 | IndexedDB 操作、数据持久化 | | zip-parser.js | 文件解析器 | ZIP 解压、CSV/JSON 解析 | | data-analyzer.js | 数据分析引擎 | 统计计算、趋势分析、模式识别 | | chart-renderer.js | 图表渲染器 | Chart.js 集成、可视化生成 | | ui-manager.js | 界面管理器 | DOM 操作、用户交互、状态管理 |

🤝 参与贡献

• 🐛 报告问题 - 在 Issues 页面报告 Bug 或提出改进建议
• 💡 功能请求 - 提出新功能需求和改进意见
• 🔧 代码贡献 - 提交 Pull Request 改进代码
• 📝 文档完善 - 改进项目文档和使用说明

1. Fork 项目到你的 GitHub 账户
2. 创建功能分支 git checkout -b feature/your-feature-name
3. 提交更改 git commit -m "Add your feature"
4. 推送分支 git push origin feature/your-feature-name
5. 创建 Pull Request

• 使用 ES6+ 语法和现代 JavaScript 特性
• 遵循 函数式编程 和 模块化设计 原则
• 添加必要的 注释 和 文档说明
• 确保代码的 可读性 和 可维护性

📞 支持与反馈

• 📁 项目仓库: GitHub Repository
• 📦 NPM 包: linux-do-analyzer
• 🐛 问题反馈: GitHub Issues
• 💬 社区讨论: Linux.do 论坛

• 作者: dext7r (GitHub: @dext7r)
• 邮箱: 欢迎通过 GitHub Issues 联系

📄 开源许可

本项目采用 MIT 许可证，详情请查看 LICENSE 文件。

许可说明

• ✅ 自由使用 - 可用于个人和商业用途
• ✅ 修改分发 - 可自由修改和重新分发
• ✅ 私有使用 - 可在私有项目中使用
• ❗ 保留版权 - 需保留原作者版权声明

🙏 致谢

感谢以下开源项目和技术栈的支持：

• 📊 Chart.js - 强大的图表可视化库
• 🎨 TailwindCSS - 现代化 CSS 框架
• 🗂️ JSZip - JavaScript ZIP 文件处理库
• 💫 jQuery - 简化 DOM 操作的 JavaScript 库
• 🎯 FontAwesome - 丰富的图标字体库
• 🦕 Deno - 现代 JavaScript 运行时
• 🟢 Node.js - JavaScript 运行时环境

• 🐧 Linux.do 社区 - 提供优质的技术交流平台
• 👥 社区贡献者 - 所有为项目做出贡献的开发者
• 🔬 测试用户 - 提供宝贵的测试反馈和改进建议

🌟 如果这个项目对你有帮助，请给个 Star ⭐

🐧 为 Linux.do 社区用户量身打造 | 🔒 隐私优先 | 🎨 现代化设计