🤖 MyLifeTracker -心元—— 24小时数字赛博生命

你的 AI 数字生命助手，24/7 实时监控属于Ta/你的数字世界

📱 手机活动 · 🎵 音乐播放 · 🚴 运动轨迹 · 🌤️ 天气位置 · 💬 AI 语音对话

让 AI 数字生命成为你的贴身管家，随时了解Ta/你在做什么、听什么、去哪里

🚀 一键部署方案正在开发中！

访问 xodn.com 注册内测账号 | 查看心元 (XODN) 项目

心元 (X Origin Digital Nexus AI) - 数字生命记忆库，让人人都能轻松部署自己的数字生命

🎯 核心应用场景

📚 自律专注沉浸

番茄钟计时、专注时长统计
应用使用分析、效率提升建议
AI 主动提醒休息

👨‍🎓 学生使用监控

家长实时了解孩子手机使用
学习时长统计、娱乐时间控制
及时引导健康用机习惯

💑 情侣朋友关怀

了解 Ta 的日常生活状态
共享音乐品味、运动轨迹
让关心变得更具体贴心

👴 老人安全守护

监控长辈活动状态
异常行为及时预警
位置追踪、健康关怀

📊 健康日志规划

运动数据记录分析
生活习惯智能建议
每日/每周健康报告

⚠️ 隐私提醒：监控他人数据必须获得对方的明确同意和授权，尊重隐私是使用本系统的前提！

🚀 快速体验

🎯 推荐方式：一键部署（开发中）

💡 心元 (XODN) - 数字生命记忆库项目
作者正在开发人人可用的一键部署方案，无需手动配置服务器和客户端！

立即体验：

🌐 访问主网站： me.jiclub.site - 查看实时数据仪表板
📦 查看 XODN 项目： github.com/StalinDev54/xodn - 心元数字生命记忆库
💬 AI 对话体验： chat.jiclub.site - 与数字生命对话（开发优化中）

心元 (XODN) 项目特点：

✅ 一键部署，无需复杂配置
✅ 自动配置 Android 监控客户端
✅ 云端数据同步和备份
✅ 多设备数据聚合
✅ 更强大的 AI 分析能力

🛠️ 开发者本地部署

如果你是开发者，想要自己部署和定制 MyLifeTracker，请参考本地部署指南。

🔍 项目概述

核心定位：你的 24 小时数字生命监控中枢

MyLifeTracker 不仅是数据追踪工具，更是一个 24/7 全天候运行的 AI 数字生命系统。它能实时监控你的数字世界，并通过 AI 语音对话与你互动。

想象一下： 当你拿起手机刷 B 站时，你的数字生命知道；当你戴上耳机听音乐时，它能告诉你这是今天第几首歌；当你骑行 30 公里后，它会主动提醒你补充水分；当你工作专注 2 小时后，它会温柔地建议你休息一下。

更多可能： 24 小时实时监控 Ta 的数字生活！无论是朋友、同事、家人，还是男女朋友，只要 Ta 同意安装客户端，你就能实时了解 Ta 在做什么、听什么歌、去哪里、用了多久手机。让关心变得更具体，让陪伴变得更贴心。（当然，这需要对方的知情同意哦~）

🎯 核心能力：实时视奸你的数字生活

监控维度	实时能力	AI 联动
📱 手机活动	实时监控你正在使用的 APP、使用时长、锁屏状态	"你已经刷抖音 1 小时了，该休息了"
🎵 音乐播放	实时同步网易云音乐播放状态、歌词、进度	"这首《夜曲》你今天循环了 8 遍"
🌤️ 天气位置	实时获取当前位置天气、空气质量	"外面下雨了，记得带伞"
🚴 运动轨迹	实时追踪骑行路线、速度、距离	"今天骑行 30km，消耗 800 卡路里"
💻 电脑活动	监控正在使用的软件、专注时长	"你已经专注编码 90 分钟，喝口水吧"
📊 数据统计	实时访客、社交媒体数据、任务进度	"你的 B 站粉丝涨了 50 个"

🤖 AI 数字生命：不只是工具，更是陪伴

通过集成小智 AI 和 chat.jiclub.site，你的数字生命可以：

📞 24 小时语音通话：随时拨打电话与你的数字生命对话
💬 智能文本交互：通过 chat.jiclub.site 发送消息，获取实时数据报告
🎙️ 主动语音播报：基于实时数据主动提醒（如"你该睡觉了"）
🧠 个性化建议：分析你的生活习惯，提供健康、效率建议
🎭 情感陪伴：不只是冰冷的数据，更是有温度的交流

项目状态

开发阶段： 核心功能已完成，24 小时实时监控系统稳定运行
主网站入口： me.jiclub.site - 项目主页和数据仪表板
AI 对话入口： chat.jiclub.site - 与你的数字生命对话（开发优化中，暂未开源）
一键部署方案： 心元 (XODN) 项目 - 数字生命记忆库，访问 xodn.com 注册内测
支持平台：
- ✅ Windows（电脑监控 + 网易云音乐监听）
- ✅ Android（手机活动监控，推荐使用 AutoTask）
- 🚧 macOS（开发中）
- 📋 iOS（规划中）
AI 集成： 已接入小智 AI，支持 24 小时语音通话和文本对话
协作邀请： 欢迎开发者点亮 ⭐ Star 支持，关注作者博客获取实时开发日志

核心差异化：真正的 24 小时数字生命

与市面上的数据追踪工具不同，MyLifeTracker 的核心是 AI 数字生命：

🔄 全天候运行：无需手动打开，后台自动收集数据
🧠 智能理解：不只是记录数据，更能理解你的行为模式
💬 双向交互：你可以问它"我今天听了什么歌"，它也会主动提醒你"该休息了"
🎭 个性化陪伴：基于你的数据生成专属的生活建议和情感陪伴
🔗 多端联动：手机、电脑、音乐、运动数据无缝同步
👥 多人监控：支持监控多个设备，实时了解朋友、家人、伴侣的数字生活（需对方同意）

这不是冰冷的数据仪表板，而是一个懂你的 AI 生活助手。

🎯 适用场景

📊 自我管理：追踪自己的数字生活，提升效率和健康
👨‍👩‍👧‍👦 家庭关怀：父母了解孩子的手机使用情况，及时引导
💑 情侣互动：了解对方的日常，增进感情（需双方同意）
👥 团队协作：团队成员工作状态透明化，提升协作效率
🏥 健康监测：监控长辈的活动状态，及时发现异常

⚠️ 隐私提醒：监控他人数据必须获得对方的明确同意和授权，尊重隐私是使用本系统的前提！

✨ 核心功能：24 小时实时监控矩阵

📱 手机活动实时监控（Android）

通过 AutoTask/Tasker 自动化应用，实现 零感知的全天候监控：

监控项	实时能力	数据示例	AI 联动
应用使用	实时记录当前使用的 APP 及使用时长	"抖音 - 使用中 - 45分钟"	"你已经刷抖音 1 小时了"
锁屏状态	监听锁屏/解锁事件，统计锁屏时长	"锁屏 - 23:30 - 持续 8 小时"	"你该睡觉了，明天还要早起"
电池状态	实时电量、充电状态	"电量 20% - 未充电"	"电量不足，记得充电"
应用切换	记录应用切换频率和使用时长	"微信 30分钟 → B站 45分钟 → 抖音 1小时"	"你今天切换了 50 次应用"

🚀 一键部署方案（推荐）： 访问心元 (XODN) 项目或 xodn.com 注册内测账号，无需手动配置 AutoTask，系统自动完成所有配置！

手动配置方式： android-up/README.md | AutoTask 配置教程

🎵 音乐播放实时同步（网易云音乐）

独立的 TypeScript 监听服务，实时读取网易云音乐客户端数据库：

监控项	实时能力	数据示例	AI 联动
当前播放	实时歌曲信息	"周杰伦 - 夜曲 - 03:45/04:30"	"这首《夜曲》你今天循环了 8 遍"
播放状态	播放/暂停/切歌	"播放中 - 单曲循环"	"你已经听了 2 小时音乐了"
歌词同步	逐句歌词展示	"我给你的爱写在西元前..."	语音播报当前歌词
播放历史	最近 15 首歌曲	"今日播放 30 首，累计 2.5 小时"	"你今天听的都是伤感歌曲"

配置指南： netease-windows/README.md

🌤️ 天气位置实时追踪

监控项	实时能力	数据示例	AI 联动
当前天气	实时温度、天气状况	"北京 - 晴 - 25°C"	"外面天气不错，出去走走吧"
空气质量	PM2.5、AQI 指数	"AQI 150 - 轻度污染"	"空气质量不好，少出门"
位置追踪	基于 IP/GPS 定位	"当前位置：北京市朝阳区"	"你已经在公司待了 8 小时了"

🚴 运动轨迹实时分析（行者 API）

监控项	实时能力	数据示例	AI 联动
骑行轨迹	GPX 轨迹可视化	"30km - 平均速度 25km/h"	"今天骑行 30km，消耗 800 卡路里"
实时速度	当前速度、最高速度	"当前 28km/h - 最高 45km/h"	"速度有点快，注意安全"
装备磨损	自行车里程统计	"车架累计 5000km"	"该保养自行车了"

💻 电脑活动监控（Windows/macOS）

监控项	实时能力	数据示例	AI 联动
软件使用	当前使用的软件	"VS Code - 编码中 - 90分钟"	"你已经专注编码 90 分钟，休息一下"
专注模式	番茄钟计时	"专注 25 分钟 - 休息 5 分钟"	"专注时间到，该休息了"
锁屏记录	锁屏/解锁时间	"锁屏 - 12:30（午休）"	"午休时间到，记得吃饭"

📊 数据统计实时更新

监控项	实时能力	数据示例	AI 联动
网站访客	实时在线人数	"当前 5 人在线"	"你的网站今天访问量破千了"
B站数据	粉丝数、播放量	"粉丝 1250 人（+50）"	"你的 B 站粉丝涨了 50 个"
任务进度	待办任务完成率	"今日完成 5/8 个任务"	"还有 3 个任务未完成"

🤖 AI 数字生命交互（核心亮点）

基于小智 AI 和 chat.jiclub.site（开发优化中）：

交互方式	能力	使用场景
📞 语音通话	24 小时随时拨打电话对话	"我今天听了什么歌？"
💬 文本聊天	通过 chat.jiclub.site 发送消息	"帮我总结今天的活动"
🎙️ 主动播报	基于实时数据主动提醒	"你已经工作 3 小时了，该休息了"
📊 数据报告	生成每日/每周生活报告	"本周骑行 150km，听歌 20 小时"
🧠 智能建议	基于行为模式提供建议	"你最近睡眠不足，建议早点休息"
🎭 情感陪伴	有温度的交流互动	"今天辛苦了，明天会更好"

🚀 快速体验：

访问 me.jiclub.site 查看实时数据仪表板

访问 xodn.com 注册内测账号体验完整功能

查看心元 (XODN) 项目了解一键部署方案

🛠️ 技术栈

MyLifeTracker 基于现代化、解耦的架构构建，专为可扩展性和快速性能而设计。

前端技术栈

技术	用途	选择原因	当前进度
Vue 3	前端框架	利用 `<script setup>` 和 Composition API 实现高度响应式和可维护的组件	已完成 80%（图像页面开发中）
Vite	构建工具	提供极快的开发环境和优化的生产构建	已完成 100%
ECharts / Chart.js	数据可视化	行业领先的库，用于将复杂数据集渲染为可读的交互式图表	已完成 90%
MDUI / Sober UI	UI 框架	结合创建独特美学，平衡 Material Design 与极简现代主义	已完成 85%
Axios	API 客户端	可靠的 HTTP 客户端，用于与 Express 后端和外部音乐/歌词 API 交互	已完成 100%

后端技术栈

技术	用途	选择原因	当前进度
Express	后端服务器	轻量级且灵活的框架，用于处理 API 代理和实时 Socket 管理	已完成 90%（核心接口稳定）
Socket.io	实时通信	实现双向、低延迟通信，用于在线用户计数和共享收听	已完成 100%
Axios	HTTP 客户端	用于后端请求第三方 API（百度统计、行者运动等）	已完成 100%
JSDOM	HTML 解析	用于网页数据爬取和解析	已完成 100%
http-proxy-middleware	API 代理	代理 B站、网易云等第三方 API，解决 CORS 问题	已完成 100%
dotenv	环境变量管理	安全管理敏感配置信息（Token、密钥等）	已完成 100%

音乐监听服务技术栈

技术	用途	选择原因	当前进度
TypeScript	开发语言	提供类型安全和更好的开发体验	已完成 100%
better-sqlite3	数据库访问	读取网易云音乐客户端的本地数据库	已完成 100%
Axios	HTTP 客户端	向后端服务器上传音乐播放状态	已完成 100%
nanobus	事件总线	处理音乐状态变化事件	已完成 100%

移动端客户端

平台	实现方式	功能	当前进度
Android	AutoTask / Tasker	使用 AutoTask（推荐）或 Tasker/MacroDroid 等自动化工具监听锁屏、应用切换，上传设备使用日志	配置文档已完成
iOS	快捷指令	计划使用快捷指令自动化实现类似功能	规划中

AI 与实时通信

技术	用途	说明	当前进度
小智 AI	AI 语音交互	24 小时语音通话、语义理解、TTS/ASR	已完成 90%（稳定运行）
chat.jiclub.site	文本对话	在线聊天界面，实时获取数字生命数据报告	已完成 100%
Socket.io	实时通信	实现双向、低延迟通信，用于在线用户计数和数据推送	已完成 100%
MCP 服务	音频流处理	处理语音通话的音频流	已完成 85%

数据存储

技术	用途	说明	当前进度
JSON 文件存储	数据持久化	当前使用 JSON 文件存储（lifelogs.json、cloudmusic_logs.json、focus_tasks.json）	已完成 100%（稳定运行）
SQLite + Redis	数据存储	计划方案：本地数据持久化 + 实时数据缓存	规划中

第三方集成

行者 API v2： 运动轨迹、骑行数据获取（已完成 100%，联调通过）
网易云音乐开放 API： 音乐状态数据获取（已完成 100%，联调通过）
百度统计 API： 网站访问数据分析（已完成 100%，通过后端代理）
B站开放 API： 用户信息和动态数据（已完成 100%，通过后端代理）

📁 项目结构

项目遵循模块化、基于组件的结构，分离 UI 元素、业务逻辑和后端服务之间的关注点。

MyLifeTracker/
├── 📁 .trae/                      # AI 辅助开发规则
├── 📁 .codebuddy/                  # 分析和摘要报告
├── 📁 public/                      # 静态资源和 webmanifest
│   ├── 📄 site.webmanifest         # PWA 配置
│   └── 📄 favicon.ico              # 站点图标
├── 📁 src/                         # 前端源代码
│   ├── 📁 assets/                  # 字体、样式和图像资源
│   │   ├── 📁 APPicons/            # 50+ 应用图标集合
│   │   ├── 📄 material_icons.css   # 图标字体定义
│   │   └── 📄 style.css            # 全局应用样式
│   ├── 📁 components/              # 可复用 Vue 组件
│   │   ├── 📁 dialogs/             # 模态界面（音乐、骑行、支付）
│   │   ├── 📁 features/            # 核心仪表板模块（实时、统计、播放器）
│   │   ├── 📁 ui/                  # 展示卡片（Bilibili、QQ、天气）
│   │   └── 📁 utils/               # 交互式 UI 工具（待办、一言）
│   ├── 📁 router/                  # Vue Router 配置
│   ├── 📁 utils/                   # 业务逻辑和 API 包装器
│   │   ├── 📄 musicApi.js          # 网易云音乐集成
│   │   ├── 📄 server.js            # 前端-服务器通信逻辑
│   │   └── 📄 listenTogetherApi.js # 基于 Socket 的同步逻辑
│   ├── 📁 views/                   # 主页面布局（待办、活动、个人资料）
│   ├── 📄 App.vue                  # 根应用组件
│   └── 📄 main.js                  # 应用入口点
├── 📁 server-up/                   # 后端服务器（Express + Socket.IO）
│   ├── 📄 server.js                # 主服务器文件
│   ├── 📄 package.json             # 后端依赖配置
│   ├── 📄 .env                     # 环境变量配置（需自行创建）
│   ├── 📄 lifelogs.json            # 设备日志数据存储
│   ├── 📄 cloudmusic_logs.json     # 音乐播放日志存储
│   └── 📄 focus_tasks.json         # 专注任务数据存储
├── 📁 netease-windows/             # 网易云音乐客户端监听服务（TypeScript）
│   ├── 📁 src/                     # 源代码目录
│   │   ├── 📁 cloudmusic-detector/ # 网易云音乐检测器核心
│   │   ├── 📄 index.ts             # 主入口文件
│   │   └── 📄 utils.ts             # 工具函数
│   ├── 📄 package.json             # 依赖配置
│   ├── 📄 tsconfig.json            # TypeScript 配置
│   ├── 📄 .env                     # 环境变量（需自行创建）
│   ├── 📄 start-dev.bat            # Windows 快速启动脚本
│   └── 📄 README.md                # 客户端文档
├── 📁 android-up/                  # Android 设备日志上传客户端
│   └── 📄 README.md                # Android 客户端配置文档
├── 📄 package.json                 # 前端项目依赖和脚本
├── 📄 pnpm-lock.yaml               # 依赖锁定文件
├── 📄 vite.config.js               # 构建和开发配置
├── 📄 production-proxy-config.md   # 部署代理文档
└── 📄 README.md                    # 项目文档

🚀 快速开始

🎯 快速体验（推荐）

如果你想快速体验 MyLifeTracker 的完整功能，无需自己部署：

访问主网站： me.jiclub.site - 查看实时数据仪表板
注册内测账号： xodn.com - 获取一键部署方案和完整功能体验
查看 XODN 项目： github.com/StalinDev54/xodn - 心元数字生命记忆库
AI 对话体验： chat.jiclub.site - 与数字生命对话（开发优化中）

💡 心元 (XODN) 一键部署方案： 作者正在开发人人可用的一键部署方案，注册 xodn.com 即可参与内测，无需手动配置服务器和客户端！

🛠️ 本地部署（开发者）

如果你是开发者，想要自己部署和定制 MyLifeTracker：

环境要求

Node.js： 版本 18.x 或更高
包管理器： npm 或 pnpm（推荐）
系统： Windows 10+/macOS 12+

安装步骤

1. 克隆仓库

git clone https://github.com/StalinDev54/MyLifeTracker.git
cd MyLifeTracker

2. 安装前端依赖

npm install
# 或
pnpm install

3. 安装后端依赖

cd server-up
npm install
cd ..

4. 安装网易云音乐监听服务依赖（可选）

如果需要监听本地网易云音乐客户端的播放状态：

cd netease-windows
npm install
cd ..

5. 配置环境变量

💡 提示： 各模块的详细配置说明请参考对应文档：

后端服务器配置

网易云音乐监听服务配置

Android 客户端配置

在 server-up 目录下创建 .env 文件：

cd server-up
cp .env.example .env  # 如果有示例文件

编辑 .env 文件，配置以下变量：

# 服务器端口
PORT=3000

# 百度统计 Token（可选）
BAIDU_STAT_TOKEN=your_baidu_token

# 网站根目录（生产环境）
WEBSITE_ROOT=/www/wwwroot/me.jiclub.site

# JS 目录（生产环境）
JS_DIRECTORY=/www/wwwroot/node

# API 鉴权密钥（重要：请修改为自己的密钥）
SECRET_KEY=your_secret_key_here

# 行者运动 API Token（可选，用于骑行数据）
XINGZHE_TOKEN=your_xingzhe_token

# 爬取目标 URL（可选）
SCRAPE_TARGET_URL=https://your-target-url.com

配置网易云音乐监听服务（可选）：

📝 详细配置步骤： 参考 netease-windows/README.md

在 netease-windows 目录下创建 .env 文件：

cd netease-windows
cp .env.example .env

编辑 .env 文件：

# 后端 API 地址
API_URL=http://localhost:3000/api/cloudmusic

# 鉴权密钥（与 server-up 的 SECRET_KEY 保持一致）
AUTH_KEY=your_secret_key_here

配置 Android 设备日志上传（可选）：

📝 详细配置步骤： 参考 android-up/README.md 和 android-up/autotask-guide.md

推荐使用 AutoTask 自动化应用（免费开源）：

项目地址：xjunz/AutoTask
支持 Shizuku 模式和无障碍服务模式
监听锁屏/解锁事件，自动上传设备使用状态
详细配置步骤见 android-up/README.md 和 android-up/autotask-guide.md
如需配置教程，请联系项目作者

也可以使用 Tasker、MacroDroid 等其他自动化应用，配置方式类似（参考 android-up/tasker-config-example.md）。

6. 启动开发服务器

启动后端服务器（端口 3000）：

cd server-up
npm start
# 或使用 nodemon 热重载
npm run dev

启动网易云音乐监听服务（可选）：

在新的终端窗口中：

cd netease-windows
npm run dev
# 或在 Windows 上双击 start-dev.bat

启动前端开发服务器（端口 5173）：

在新的终端窗口中：

npm run dev

应用将在以下地址可用：

前端：http://localhost:5173
后端：http://localhost:3000
音乐监听服务：后台运行，自动上传播放状态到后端

生产构建

构建前端

npm run build

部署后端

cd server-up
# 使用 PM2 或其他进程管理器
pm2 start server.js --name mylifetracker-backend

预览生产构建

npm run preview

💡 使用指南

典型使用场景

场景 1：早晨起床

你的手机解锁（Android 自动上传解锁事件）
数字生命通过语音播报："早上好，昨晚睡了 7.5 小时（锁屏时长统计），今天天气晴朗，适合骑行"
你打开网易云音乐听歌（监听服务自动同步播放状态）
数字生命："正在播放《晴天》，这是你最喜欢的歌"

场景 2：工作时间

你打开 VS Code 开始编码（电脑监控记录软件使用）
专注 90 分钟后，数字生命主动提醒："你已经专注编码 90 分钟，该休息一下了"
你切换到 B 站刷视频（手机监控记录应用切换和使用时长）
数字生命："你已经刷 B 站 30 分钟了，该回去工作了"

场景 3：下班骑行

你开始骑行（行者 APP 自动记录轨迹）
骑行结束后，数字生命自动生成报告："今天骑行 30km，平均速度 25km/h，消耗 800 卡路里，记得补充水分"
你可以通过 me.jiclub.site 查看详细的骑行轨迹和数据统计

场景 4：睡前总结

你拨打数字生命的电话："今天我做了什么？"
数字生命语音回复："今天你工作了 8 小时，听了 30 首歌，骑行 30km，刷了 1 小时 B 站，手机使用时长 5 小时（锁屏 19 小时），完成了 5 个任务，表现不错！"
你锁屏睡觉（Android 自动上传锁屏事件和时长）
数字生命："晚安，明天会更好"

🎯 实时监控亮点： 系统能精确统计你的手机使用时长、锁屏时长、每个应用的使用时长、电池状态等，所有数据都是实时的！

🚀 快速体验： 访问 xodn.com 注册内测账号，或查看心元 (XODN) 项目了解一键部署方案。

后端架构说明

后端服务器采用 Express + Socket.IO 架构，提供 RESTful API 和实时通信能力：

核心功能模块

实时通信层（Socket.IO）
- 在线用户统计
- 实时日志推送
- 音乐播放状态同步
API 代理层
- B站 API 代理（用户信息、图片资源）
- 百度统计 API 代理（隐藏 Token）
- 网易云音乐 API 代理
数据管理层
- 设备日志管理（lifelogs.json）
- 音乐播放记录（cloudmusic_logs.json）
- 专注任务管理（focus_tasks.json）
第三方集成
- 行者运动 API（骑行数据）
- 网页数据爬取（JSDOM）
移动端数据采集
- Android 设备通过自动化应用（AutoTask/Tasker/MacroDroid）上传
- 监听锁屏/解锁、应用切换、电池状态
- 自动同步到后端服务器
- 详细配置：android-up/README.md

网易云音乐监听服务

📖 完整文档： netease-windows/README.md

独立的 TypeScript 服务，用于监听本地网易云音乐客户端的播放状态：

工作原理：

读取网易云音乐客户端的本地 SQLite 数据库
实时检测当前播放的歌曲 ID、播放状态、播放进度
检测单曲循环、切歌、暂停/播放等事件
通过防抖机制避免频繁上传
自动上传播放状态到后端 API

支持的功能：

实时获取当前播放歌曲信息（歌曲 ID、名称、艺术家、专辑）
监听播放/暂停状态变化
跟踪播放进度（支持进度条拖拽）
检测单曲循环重新播放
自动同步到后端服务器

使用场景：

在仪表板上实时显示当前播放的音乐
记录音乐播放历史
支持"一起听"功能的数据源
生成个人音乐统计报告

数据存储说明

当前使用 JSON 文件存储（Demo 阶段）：

lifelogs.json - 设备使用日志（最多保留 30 条）
cloudmusic_logs.json - 音乐播放记录（最多保留 15 条）
focus_tasks.json - 专注任务数据（分为进行中和待办）

未来将迁移到 SQLite + Redis 方案以提升性能和可靠性。

后端 API 端点

📖 完整 API 文档： server-up/README.md

后端服务器（Express）运行在 http://localhost:3000，提供以下 API 端点：

基础信息

服务状态： GET / - 查看服务运行状态和可用 API 列表

实时数据

在线用户数： GET /api/online-users - 返回当前活跃的 Socket 连接数
Socket.IO 实时推送： 支持 onlineUsersUpdate、logsUpdate、cloudmusicUpdate 事件

音乐相关

获取音乐日志： GET /api/cloudmusic - 获取最近 15 条音乐播放记录
添加音乐日志： POST /api/cloudmusic - 添加新的音乐播放记录（需鉴权）
- Headers: X-Auth-Key: your_secret_key
- Body: 支持任意参数（如 id, name, artist, album, duration 等）
- 详细说明：netease-windows/README.md

设备日志

获取设备日志： GET /getStalin - 获取设备使用日志
添加设备日志： POST /postStalin - 添加设备日志（需鉴权）
- Headers: X-Auth-Key: your_secret_key
- Body: { device, status, battery, is_charging, app_name, app_package }
- 详细说明：android-up/README.md

专注任务

获取专注任务： GET /api/focus-tasks - 获取所有专注任务
更新专注任务： POST /api/focus-tasks - 更新专注任务列表（需鉴权）
- Headers: X-Auth-Key: your_secret_key
- Body: { inProgress: [], pending: [] }
切换任务状态： POST /api/focus-tasks/toggle - 开始/暂停任务（需鉴权）
- Headers: X-Auth-Key: your_secret_key
- Body: { taskId, action: 'start' | 'pause' }

运动数据

获取行者运动列表： GET /Getxingzhe?limit=10&offset=0 - 获取骑行记录列表
获取运动详情： GET /Getxingzhe/:id - 获取指定 ID 的骑行详情

数据分析

百度统计代理： POST /baidu-stat/proxy - 安全获取百度统计数据（隐藏 Token）
爬取动态数据： GET /getlifeabout - 爬取生活动态数据

第三方代理

B站用户信息： /x/web-interface/card - 代理 B站 API
B站图片资源： /bilibili-img/*, /bilibili-img-i1/*, /bilibili-img-i2/* - 代理 B站图片

前端使用

仪表板交互

活动监控： 打开"最近活动"视图查看已记录事件的时间线
任务管理： 导航到"待办"视图使用 iOS 风格的手势列表
骑行数据： 使用统计对话框输入或查看最新的骑行指标和装备磨损
一起听： 使用浮动按钮与平台上的其他活跃用户发起同步音乐会话
专注模式： 在待办任务中启动专注计时，支持番茄钟模式

鉴权说明

🔐 安全提示： 详细的鉴权配置请参考 server-up/README.md

部分 API 需要在请求头中携带鉴权密钥：

headers: {
  'X-Auth-Key': 'your_secret_key',
  'Content-Type': 'application/json'
}

请在 server-up/.env 文件中设置 SECRET_KEY 环境变量，并确保各客户端（netease-windows、android-up）的 AUTH_KEY 与之保持一致。

✅ 已完成功能

🚴 骑行轨迹功能

完成时间： 2025年9月29日

技术实现：

对接行者 API v2（OAuth2.0 授权）
支持 GPX 轨迹解析、SVG 路径渲染
ECharts 热力图展示

功能亮点：

轨迹回放与可视化
距离/速度/耗时统计
导出轨迹文件（GPX/PNG）

数字生命联动： 骑行结束后自动生成数据总结语音播报

🔒 锁屏记录修复

解决方案：

监听系统锁屏事件（Windows：powerMonitor / macOS：NSWorkspace）
触发日志异步写入

解决问题：

修复锁屏状态下应用使用时长统计中断
解决数据缺失问题

优化点： 断联后重新解锁自动补录缺失日志

🎵 网易云音乐联动

📖 完整文档： netease-windows/README.md

实现方式：

集成 NeteaseCloudMusicApi
通过 WebSocket 实时推送播放状态/歌词

特殊适配：

支持「一起听」模式用户状态同步（需登录态验证）
歌词逐句同步展示

本地监听：

独立的 TypeScript 服务（netease-windows）
实时监听 Windows 客户端播放状态
配置指南：netease-windows/README.md

数字生命联动： 歌曲切换时主动播报歌曲名称、歌手，支持语音点歌

✅ 待办专注功能

核心逻辑：

任务与专注状态绑定
专注时长计入任务进度
支持 Pomodoro 番茄钟模式（25min 专注 + 5min 休息）

交互设计：

专注状态切换触发桌面通知 + 数字生命语音提醒
中断时弹窗确认

数据统计： 生成每日/每周专注报告（专注时长、任务完成率）

🤖 AI 数字生命集成

技术依赖：

MCP 服务处理音频流
对接小智 AI 实现语义理解
TTS/ASR 完成语音交互

功能支持：

文本转语音（普通话/英语）
语音识别
实时语音通话
数字生命形象表情同步

交互亮点： 支持自定义数字生命昵称、语速、语气，形象随语音实时动效

🗓️ 开发路线

功能项	优先级	状态备注	依赖条件	预计完成时间
数字生命形象自定义	高	开发中（核心亮点功能，支持上传自定义形象、调整形象动作）	前端 3D 渲染组件 + 形象驱动接口	2026年5月
iOS 手机监控适配	高	规划中（使用快捷指令实现类似 Android 的监控功能）	iOS 快捷指令开发 + API 适配	2026年6月
运动手环数据联动	高	规划中（核心需求，需硬件支持+开放接口）	小米/华为手环开放 API 适配、蓝牙通信	2026年7月
生活数据智能分析报告	中	规划中（基于周/月数据生成效率/健康分析，提供优化建议）	数据统计算法 + ECharts 图表可视化	2026年6月
多音乐平台支持	中	规划中（支持 QQ 音乐、Spotify 等平台）	各平台 API 适配	2026年8月
实时弹幕交互功能	低	待评估（计划做最小 Demo 验证需求，需用户反馈支撑是否保留）	前端弹幕组件开发 + 用户权限控制	待定
~~实现「我的设备日志清单」功能~~	低	已取消（需求优先级下调，功能并入「数据报表」模块）	-	-

👥 开发招募

项目已开源，诚邀各方向开发者加入，共同打造"24 小时 AI 数字生命监控系统"！新手友好，提供技术指导，不限经验~

招募方向及要求

招募角色	核心职责	技能要求（基础/进阶）	所需人数
前端开发	1. 数字生命形象渲染优化（3D/动效） 2. 数据可视化图表优化 3. 移动端 UI 适配	基础：Vue3/Vite 进阶：3D 渲染（如 Three.js）	2-3 人
后端开发	1. SQLite + Redis 数据存储集成 2. 第三方 API 接口封装（如手环 API） 3. 服务性能优化	基础：Node.js/Express 进阶：数据库优化/接口安全	1-2 人
跨平台开发	1. 音乐监听服务 macOS/Linux 适配 2. 其他音乐平台支持（QQ音乐、Spotify） 3. iOS 快捷指令开发	基础：TypeScript/Node.js 进阶：系统底层开发、数据库操作	1-2 人
AI 模块开发	1. 数字生命语义理解优化 2. 个性化推荐算法开发 3. 行为模式分析	基础：API 调用进阶：自然语言处理（NLP）基础	1-2 人
测试工程师	1. 编写测试用例（功能/兼容性测试） 2. 反馈 BUG 并协助修复 3. 优化测试流程	基础：测试用例设计进阶：自动化测试工具使用	1 人
文档贡献者	1. 完善开源文档（安装指南、API 说明） 2. 撰写使用教程/博客 3. 翻译英文文档	基础：Markdown 语法进阶：技术文档写作能力	2 人
设计志愿者	1. 数字生命形象设计/优化 2. 移动端 UI 设计 3. 宣传海报制作	基础：设计软件（PS/Figma）进阶：UI/3D 设计经验	1-2 人

你将获得

项目核心贡献者署名（仓库 README + 软件关于页）
数字生命定制特权（自定义专属形象、优先体验新功能）
技术交流机会（与作者及各方向开发者深度沟通，解决技术难题）
开源项目实战经验（适合新手积累项目履历，进阶开发者拓展技术边界）
不定期小福利（项目周边、技术书籍等）

参与方式

关注作者博客或项目仓库（开源后公布地址），获取最新动态
发送邮件至：1545433540@qq.com（替换为实际招募邮箱），邮件主题格式：「【开发招募】- 角色 - 姓名」
邮件内容需包含：
- 个人简介（含技术栈、过往项目/学习经历）
- 可投入时间（如：每周 5-8 小时）
- 期望参与的具体工作（如：前端 3D 渲染优化）
- 联系方式（微信/QQ）
筛选通过后，加入项目协作群，分配入门任务（新手提供指导文档）

或者直接在 GitHub 提交 Issue/PR，我们会及时回复！

💬 加入交流群

扫码加入 MyLifeTracker 交流群
与开发者和用户一起交流讨论，获取最新动态和技术支持

🤝 贡献指南

我们欢迎为改进 MyLifeTracker 做出贡献！无论是修复骑行逻辑中的错误还是添加新的社交媒体信息卡，您的帮助都值得赞赏。

协作流程

Fork 项目仓库 - 点击页面右上角的 'Fork' 按钮
创建功能分支
- 功能开发：feature/xxx（如 feature/digital-life-custom）
- BUG 修复：fix/xxx（如 fix/music-sync）
- 文档优化：doc/xxx（如 doc/update-install-guide）
```
git checkout -b feature/amazing-feature
```
进行更改 - 确保代码遵循 Vue 3 Composition API 风格
彻底测试 - 验证组件在不同屏幕尺寸下正确渲染

提交更改

git commit -m 'feat: 新增 Bilibili 粉丝数卡片'

推送到分支
```
git push origin feature/amazing-feature
```
打开 Pull Request - 提供清晰的更改描述，如果有 UI 更改请附上截图

开发指南

✅ 遵循现有代码风格（SFC <script setup>）
📝 为 musicApi.js 或 server.js 中的复杂逻辑添加注释
🎨 确保新 UI 组件符合 Sober Theme 美学
🎯 保持提交专注和原子化

代码规范

前端： 遵循 Vue 官方风格指南，使用 ESLint + Prettier 格式化代码
后端： 遵循 Node.js 代码规范，使用 JSDoc 注释接口
提交规范： 参考 Angular Commit Message Format

后端开发注意事项

环境变量管理
- 敏感信息（Token、密钥）必须通过 .env 文件配置
- 不要在代码中硬编码任何密钥或 Token
- 参考 server-up/.env.example 配置环境变量
API 鉴权
- 所有写入操作（POST/PUT/DELETE）必须验证 X-Auth-Key 请求头
- 使用 SECRET_KEY 环境变量进行鉴权
数据文件操作
- 使用异步文件操作（fsPromises）
- 写入操作使用队列机制避免并发冲突
- 定期清理过期数据（如日志限制条数）
错误处理
- 所有 API 端点必须有完整的 try-catch 错误处理
- 返回统一的错误响应格式：{ success: false, error: "错误类型", detail: "详细信息" }
- 记录详细的错误日志便于调试
CORS 配置
- 在 ALLOWED_ORIGINS 数组中添加允许的域名
- 开发环境和生产环境使用不同的域名配置
Socket.IO 事件
- 新增实时推送功能时，定义清晰的事件名称
- 在客户端和服务端同步更新事件监听器

🙏 致谢

感谢以下项目/平台提供的技术支持与灵感，开源精神永存！

网易云音乐 API 封装
- 项目：NeteaseCloudMusicApi
- 致谢：提供稳定的音乐状态/歌词数据接口，支撑音乐联动功能实现
行者开放平台
- 链接：行者开放平台
- 致谢：提供骑行轨迹数据接口，助力运动模块快速落地
AI 交互能力支持
- 项目：小智 AI（ESP32 软件服务）
- 致谢：提供成熟的 TTS/ASR 与语义理解能力，降低 AI 模块开发门槛
技术框架支持
- 项目：Vue3、Vite、Electron、ECharts
- 致谢：高效的开发框架，加速项目迭代效率

📝 许可证

本项目采用 自定义开源许可证。

使用条款：

✅ 个人使用： 完全免费，可自由使用、修改和部署
✅ 学习研究： 欢迎用于学习、研究和非商业用途
✅ 开源贡献： 欢迎提交 PR 和 Issue，共同完善项目
⚠️ 商业使用： 需要获得作者授权，请联系作者洽谈商业合作
⚠️ 二次分发： 允许分发，但必须保留原作者版权声明
⚠️ 责任声明： 软件按"原样"提供，不提供任何保证

商业授权：

如需将本项目用于商业用途（包括但不限于）：

企业内部使用
商业产品集成
付费服务提供
商业化运营

请通过以下方式联系作者获取商业授权：

📧 邮箱：1545433540@qq.com
📝 博客：blog.jiclub.site
💬 GitHub：提交 Issue 说明商业合作意向

版权声明：

❓ 常见问题（FAQ）

Q：这个项目会侵犯我的隐私吗？
A：完全不会。所有数据都存储在你的本地服务器（JSON 文件），不会上传到任何云端。你可以完全控制自己的数据，甚至可以断网使用。
Q：如何快速体验完整功能？
A：
- 访问 xodn.com 注册内测账号，体验一键部署方案
- 查看心元 (XODN) 项目了解数字生命记忆库
- 访问 me.jiclub.site 查看实时数据仪表板
Q：什么是心元 (XODN) 项目？
A：心元 (X Origin Digital Nexus AI) 是数字生命记忆库项目，提供一键部署方案，让人人都能轻松部署自己的数字生命监控系统。无需手动配置服务器、客户端，系统自动完成所有配置。项目地址：github.com/StalinDev54/xodn
Q：数字生命能做什么？
A：数字生命是一个 AI 助手，可以：
- 24 小时语音通话（通过小智 AI）
- 文本聊天（通过 chat.jiclub.site）
- 实时监控你的手机、电脑、音乐、运动数据
- 精确统计手机使用时长、锁屏时长、每个应用的使用时长、电池状态
- 主动提醒你休息、喝水、睡觉
- 生成每日/每周生活报告
- 提供个性化的健康和效率建议
Q：如何与数字生命对话？
A：有三种方式：
- 语音通话：通过小智 AI 拨打电话（需配置小智 AI 设备）
- 文本聊天：访问 chat.jiclub.site 发送消息（开发优化中）
- 数据仪表板：访问 me.jiclub.site 查看实时数据
Q：手机监控能统计哪些数据？
A：可以实时统计：
- 手机使用总时长
- 锁屏总时长（精确到分钟）
- 每个应用的使用时长（如抖音 1 小时、微信 30 分钟）
- 应用切换频率和顺序
- 电池电量和充电状态
- 所有数据都是实时的，可以随时查询
Q：Android 手机监控会耗电吗？
A：不会。使用 AutoTask 等自动化应用只在特定事件（锁屏、解锁、应用切换）时触发，不会常驻后台，耗电量极低。
Q：网易云音乐监听服务会影响客户端性能吗？
A：不会。监听服务仅读取数据库文件，不会修改任何数据，也不会干扰客户端的正常运行。采用了防抖机制，避免频繁读取造成性能影响。详见 netease-windows/README.md。
Q：我没有小智 AI 设备，还能用吗？
A：可以。小智 AI 只是语音通话功能的一部分，你仍然可以：
- 使用 chat.jiclub.site 进行文本对话
- 访问 me.jiclub.site 查看实时数据仪表板
- 使用所有监控和统计功能
- 后续我们会支持更多 AI 平台（如 ChatGPT、Claude）
Q：数据存储在哪里？是否安全？
A：当前使用本地 JSON 文件存储（路径：server-up/lifelogs.json、server-up/cloudmusic_logs.json、server-up/focus_tasks.json），所有数据仅保存在本地服务器，无云端上传，安全性可控。
Q：一键部署方案什么时候上线？
A：正在开发中，访问 xodn.com 注册账号即可参与内测，了解最新开发进度。查看心元 (XODN) 项目获取更多信息。
Q：如何获取第三方 API 的 Token？
A：
- 行者运动 Token： 访问行者开放平台注册并创建应用
- 百度统计 Token： 登录百度统计后台，在 API 管理中获取
- 网易云音乐： 使用 NeteaseCloudMusicApi 项目提供的接口
Q：如何在 Android 手机上上传设备使用日志？
A：
- 推荐方式： 访问 xodn.com 注册内测账号，使用心元 (XODN) 一键部署方案
- 手动配置： 使用 AutoTask 自动化应用（免费开源）配置自动上传任务。详细配置步骤请参考 android-up/README.md 和 android-up/autotask-guide.md 文档。
Q：设备日志会记录哪些信息？
A：仅记录设备名称、锁屏状态、锁屏时长、电池电量、充电状态、当前应用包名、应用使用时长。不会记录应用内容、聊天记录、密码等敏感信息。所有数据仅用于个人使用统计。详见 android-up/README.md。
Q：我可以自定义数字生命的形象吗？
A：当前提供默认形象，「自定义形象」功能正在开发中（预计 2026年5月完成），届时你可以上传自己的形象、调整动作和表情。
Q：项目可以商业使用吗？
A：个人使用完全免费，学习研究不受限制。如需商业使用（企业内部使用、商业产品集成、付费服务等），需要获得作者授权。请通过邮箱 1545433540@qq.com 或作者博客联系洽谈商业合作。
Q：我是新手，可以参与开发吗？
A：完全可以！项目新手友好，提供入门任务和技术指导，文档优化、测试等角色无需深厚开发经验，欢迎学生/入门开发者加入。
Q：数字生命会主动提醒我吗？
A：会的！数字生命会基于你的实时数据主动提醒你：
- 工作太久了，该休息了
- 刷手机太久了，该做正事了
- 该睡觉了，明天还要早起
- 外面下雨了，记得带伞
- 电量不足，记得充电
- 等等...
Q：chat.jiclub.site 什么时候开源？
A：chat.jiclub.site 目前正在开发优化中，暂未开源。访问 xodn.com 注册内测账号可以提前体验。
Q：可以监控别人的手机吗？
A：技术上可以实现，但必须遵守以下原则：
- ✅ 必须获得对方的明确同意和授权
- ✅ 对方需要主动安装客户端并配置上传
- ✅ 适用于家庭关怀（父母监护孩子）、情侣互动（双方同意）等合法场景
- ⚠️ 严禁用于非法监控、侵犯隐私等违法行为
- ⚠️ 使用者需承担相应的法律责任
推荐使用场景：父母关心孩子手机使用、情侣之间增进了解、团队工作状态透明化等。
Q：如何添加多个监控设备？
A：每个设备配置不同的设备名称（device 参数），后端会自动区分不同设备的数据。你可以在仪表板上切换查看不同设备的数据。详细配置请参考 android-up/README.md。

用 ❤️ 打造 by MyLifeTracker 团队

让 AI 数字生命成为你的 24 小时贴身管家

⬆️ 返回顶部

✨ 期待与你一起，让 AI 数字生命走进日常生活！

🌐 主网站入口： me.jiclub.site - 查看实时数据仪表板

💬 AI 对话入口： chat.jiclub.site - 与你的数字生命对话（开发优化中）

🚀 一键部署方案： xodn.com - 注册内测账号，了解最新开发进度

📦 心元 (XODN) 项目： github.com/StalinDev54/xodn - 数字生命记忆库

📝 关注更新： 作者博客 - 获取最新开发日志

⭐ 支持项目： 点亮 Star，让更多人看到这个项目！

Name		Name	Last commit message	Last commit date
Latest commit History 37 Commits
.codebuddy		.codebuddy
.trae/rules		.trae/rules
.vscode		.vscode
android-up		android-up
netease-windows		netease-windows
public		public
server-up		server-up
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
production-proxy-config.md		production-proxy-config.md
vite.config.js		vite.config.js

Folders and files

Latest commit

History

Repository files navigation