Package Exports

linux-do-analyzer
linux-do-analyzer/server.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (linux-do-analyzer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🐧 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 包安装

全局安装

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 一键使用

无需安装，直接使用：

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

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

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

📎 PNPX 快速启动

使用 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 论坛
- 进入账户设置页面
📤 请求数据导出
- 滚动到页面底部，找到 "下载我的档案" 部分
- 点击 "请求下载" 按钮
- 等待系统处理（通常几分钟内完成）
下载数据包
- 查收邮件通知（检查垃圾邮件箱）
- 点击邮件中的下载链接
- 下载 ZIP 格式的数据包（注意：文件大小需小于 10MB）

2️⃣ 上传和分析

访问分析工具
- 使用上述任一方式启动服务器
- 在浏览器中访问对应地址
上传数据文件
- 拖拽方式：直接将 ZIP 文件拖拽到上传区域
- 点击选择：点击上传区域选择文件
- 支持的文件类型：仅限 .zip 格式
等待分析完成
- 上传后自动开始解析和分析
- 显示实时进度条和处理状态
- 整个过程通常在几秒内完成
查看分析报告
- 分析完成后自动展示结果
- 包含多个维度的数据可视化图表
- 支持交互式图表操作

3️⃣ 数据管理功能

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

📂 支持的数据文件

📂 数据文件列表

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

📈 分析报告内容

🏷️ 数据概览卡片

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

📊 可视化图表

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

📋 详细数据表格

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

🔍 高级分析功能

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

🌐 部署选项

🔗 在线部署

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 仓库自动部署
零配置，支持自动构建

🔒 隐私安全

🛡️ 数据安全保障

✅ 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 改进代码
📝 文档完善 - 改进项目文档和使用说明

🚀 开发指南

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

📋 代码规范

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

📞 支持与反馈

🔗 相关链接

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

📧 联系方式

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

📄 开源许可

MIT 许可证

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

许可说明

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

🙏 致谢

开源项目

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

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

🙏 特别感谢

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

JSPM

linux-do-analyzer