个人时间消耗可视化

工作流程

1. 收集数据 → 引导用户提供时间数据（见数据输入格式）
2. 解析数据 → 运行 scripts/parse_time_data.py 解析为标准 JSON
3. 生成报告 → 运行 scripts/generate_report.py 生成 HTML 可视化报告
4. 提供建议 → 基于分析结果给出个性化时间优化建议

数据输入格式

方式 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 大类（用于颜色编码和分析）：

分类规则：

• 用户提供的标签中含"会议/meeting"→ 必要事务
• 含"微信/微博/抖音/B站/游戏/YouTube" → 轻度娱乐（时长>2h/天升级为时间黑洞）
• 含"通勤/公交/地铁/开车" → 生活必需
• 含"专注/番茄/写代码/写作" → 深度工作
• 含"无效/摸鱼/刷手机（无目的）" → 时间黑洞

报告内容结构

生成的 HTML 报告包含：

1. 顶部数据看板 - 当日总时长、深度工作占比、时间黑洞占比、效率评分
2. 时间浪费地图 - 24小时热力图（横轴=小时，纵轴=活动类别）
3. 活动占比饼图 - 6大分类时间占比环形图
4. 时间趋势柱状图 - 多日对比（如有多日数据）
5. 优化建议区 - 基于分析数据的个性化建议（见建议生成逻辑）

详细图表实现见 references/chart_templates.md。

优化建议生成逻辑

基于解析数据自动触发个性化建议，每条建议包含：核心洞察（1句话）+ 行动清单（3条 bullet）+ 人生哲理引用。

触发规则：

建议风格原则：简洁优于详实，每个模块控制在 5–8 行，避免大段说教式文字。

数据隐私说明

所有数据仅在本地处理，不上传任何服务器。在报告开头注明此说明。