个人时间消耗可视化
工作流程
- 收集数据 → 引导用户提供时间数据(见数据输入格式)
- 解析数据 → 运行
scripts/parse_time_data.py解析为标准 JSON - 生成报告 → 运行
scripts/generate_report.py生成 HTML 可视化报告 - 提供建议 → 基于分析结果给出个性化时间优化建议
数据输入格式
方式 A:手机屏幕时间(推荐)
请用户提供如下格式的文本(直接截图描述或 iOS"屏幕使用时间"导出):
日期: 2024-01-15
微信: 2小时30分
抖音: 1小时45分
微博: 45分钟
工作相关App: 3小时20分
其他: 1小时
方式 B:日历文件(.ics)
接受用户上传的 .ics 文件路径,自动提取会议/日程时间。
方式 C:自由文本输入
支持用户用自然语言描述,例如:
> "今天开会 4 小时,通勤 1.5 小时,刷手机 2 小时,专注工作 3 小时,吃饭 1 小时"
方式 D:结构化 JSON
{
"date": "2024-01-15",
"entries": [
{"category": "会议", "duration_minutes": 240, "label": "项目评审、周会"},
{"category": "专注工作", "duration_minutes": 180},
{"category": "通勤", "duration_minutes": 90},
{"category": "手机娱乐", "duration_minutes": 120},
{"category": "餐饮休息", "duration_minutes": 60}
]
}
执行步骤
Step 1:解析数据
python3 scripts/parse_time_data.py --input "<用户输入文本或文件路径>" --output /tmp/time_data.json
如果是 .ics 文件:
python3 scripts/parse_time_data.py --ics <文件路径> --output /tmp/time_data.json
Step 2:生成 HTML 报告
python3 scripts/generate_report.py --data /tmp/time_data.json --output /tmp/time_report.html
报告保存到 /tmp/time_report.html,告知用户文件路径并提供下载链接。
时间分类标准
将所有活动归入以下 6 大类(用于颜色编码和分析):
| 分类 | 颜色 | 说明 |
|---|---|---|
| 🔵 深度工作 | #3B82F6 |
专注编程、写作、分析等高价值产出 |
| 🟢 必要事务 | #10B981 |
会议、沟通、邮件(必要但可优化) |
| 🟡 生活必需 | #F59E0B |
通勤、饮食、休息、睡眠 |
| 🟠 轻度娱乐 | #F97316 |
社交媒体、短视频(有限可接受) |
| 🔴 时间黑洞 | #EF4444 |
无目的刷手机、无效会议、拖延 |
| ⚫ 未分类 | #6B7280 |
其他未归类活动 |
分类规则:
- 用户提供的标签中含"会议/meeting"→ 必要事务
- 含"微信/微博/抖音/B站/游戏/YouTube" → 轻度娱乐(时长>2h/天升级为时间黑洞)
- 含"通勤/公交/地铁/开车" → 生活必需
- 含"专注/番茄/写代码/写作" → 深度工作
- 含"无效/摸鱼/刷手机(无目的)" → 时间黑洞
报告内容结构
生成的 HTML 报告包含:
- 顶部数据看板 - 当日总时长、深度工作占比、时间黑洞占比、效率评分
- 时间浪费地图 - 24小时热力图(横轴=小时,纵轴=活动类别)
- 活动占比饼图 - 6大分类时间占比环形图
- 时间趋势柱状图 - 多日对比(如有多日数据)
- 优化建议区 - 基于分析数据的个性化建议(见建议生成逻辑)
详细图表实现见 references/chart_templates.md。
优化建议生成逻辑
基于解析数据自动触发个性化建议,每条建议包含:核心洞察(1句话)+ 行动清单(3条 bullet)+ 人生哲理引用。
触发规则:
| 触发条件 | 建议模块 | 哲理示例 |
|---|---|---|
| 始终 | 今日总览 + 效率评分 | 因评分段位不同引用不同格言 |
| 时间黑洞 > 1h/天 | 数字排毒预警 | "你花在哪里,你的未来就在哪里" |
| 轻度娱乐 > 1.5h/天 | 娱乐超标提醒 | 肖伯纳名言 |
| 深度工作 < 2h/天 | 专注时间保护 | 卡尔·纽波特《深度工作》 |
| 会议 > 4h/天 | 会议减负 | 格雷格·麦吉昂名言 |
| 生活必需 > 1.5h/天 | 通勤价值变现 | "碎片时间是最昂贵的资产" |
| 深度工作 ≥ 2h/天 | 进阶正向反馈 | 帕雷托原则 |
| 效率评分 ≥ 75 | 综合优秀奖励 | 马可·奥勒留《沉思录》 |
建议风格原则:简洁优于详实,每个模块控制在 5–8 行,避免大段说教式文字。
数据隐私说明
所有数据仅在本地处理,不上传任何服务器。在报告开头注明此说明。