脑力状态对比与作息规则生成器

项目定位：一个基于 Python 的本地化数据分析工具，用于对比“熬夜疲惫”与“精力充沛”两种状态下的创意质量差异，据此生成个性化的作息规则，保护长期创新能力。

适用人群：修读“心理健康与创新能力”课程的学生、需要持续创意输出的开发者、设计师、科研人员。

技术栈：Python 3.8+，依赖

"rich"（终端美化）、

"pandas"（数据分析）、

"matplotlib"（可视化）。

一、实际应用场景描述

假设你是一个正在准备毕业设计的技术博主：

你坚持“深夜创作”三个月了。凌晨 1 点到 4 点，宿舍安静，你觉得这是自己的“黄金时间”。你确实产出了 12 篇文章，但回过头看，你发现一个残酷的事实：前 3 篇在白天写的文章，平均阅读量是后 12 篇的 3 倍，点赞率是 2.5 倍。

更糟的是，你现在白天开会时经常走神，下午 3 点必须喝咖啡才能维持清醒，周末一觉睡到下午 2 点还是觉得累。

你陷入了一个误区：把“时间可用性”当成了“创意可用性”。

这个工具要解决的问题是：用量化数据证明“熬夜创作”的真实代价，并通过对比分析，帮你制定一套保护脑力资源的作息规则，而不是空洞的“早点睡”建议。

二、引入痛点

痛点 表现 后果

状态混淆 把“清醒”等同于“有创造力” 在低质量状态下强行创作，产出垃圾

幸存者偏差 只记得熬夜时的“灵感爆发”瞬间 忽略大量熬夜产出的平庸内容

脑力透支 长期睡眠不足导致认知功能下降 创新能力不可逆损伤

作息随意 没有基于数据的个性化作息规则 依赖意志力而非系统设计

这些痛点的本质，是缺乏对自己脑力节律的客观测量和敬畏。

三、核心逻辑讲解

整个系统的数据流如下：

┌──────────────┐ ┌──────────────┐ ┌──────────────────┐

│ SessionLogger│───→│ QualityAnalyzer│───→│ RuleGenerator │

│ 创作时段记录 │ │ 质量对比分析 │ │ 作息规则生成器 │

└──────────────┘ └──────────────┘ └──────────────────┘

记录元数据 统计显著性检验 生成可执行规则

核心设计思想：脑力是有限可再生资源

1. 双重维度记录

- 客观指标：睡眠时间、起床时间、咖啡因摄入、工作时长

- 主观指标：精力评分（1-10）、创意流畅度、成果自评质量

- 产出指标：字数、代码行数、发布后数据（阅读量、点赞等）

2. 配对样本对比（Paired Sample Comparison）

- 不是简单比较“熬夜日”和“早睡日”，而是同一人在不同状态下的自我对照

- 计算每个指标的 Effect Size（效应量），判断差异是否具有实际意义，而不仅仅是统计显著

3. 脑力损耗模型

脑力净值 = 基础脑力 × (睡眠充足度) × (昼夜节律对齐度) - 认知负荷累积

- 连续熬夜会产生累积负债，不是睡一觉就能还清的

4. 规则生成算法

- 基于边际效用递减原则：找到“投入睡眠时间的收益拐点”

- 基于个体节律：识别个人的“创意高峰窗口”

- 输出 SMART 作息规则：具体、可衡量、可实现、相关、有时限

四、代码模块化与注释

项目共 7 个文件，职责清晰分离：

文件 职责 关键类/函数

"config.py" 睡眠质量分级、创意维度权重、规则模板

"SLEEP_QUALITY_MAP",

"CREATIVITY_DIMENSIONS",

"RULE_TEMPLATES"

"utils.py" 时间计算、统计函数、数据校验

"calculate_sleep_debt",

"cohens_d",

"normalize_score"

"session_logger.py" 创作时段记录与数据管理

"CreativeSession",

"SessionLogger.log_session",

"get_sessions_by_condition"

"quality_analyzer.py" 核心对比分析与统计检验

"QualityAnalyzer.compare_conditions",

"calculate_effect_size"

"rule_generator.py" 作息规则生成与优先级排序

"RuleGenerator.generate_rules",

"SleepScheduleRule"

"knowledge_cards.py" 6 张核心知识点卡片

"BRAINSLEEP_CARDS",

"print_card"

"main.py" CLI 入口与交互流程

"main()",

"run_log_session()",

"run_analyze_and_plan"

关键代码片段（

"quality_analyzer.py"）

def compare_conditions(self, metric: str) -> ComparisonResult:

"""

对比两种状态下的指定指标

核心逻辑：

1. 提取"充沛组"（睡眠≥7h，精力≥7）和"疲惫组"（睡眠<6h，精力≤4）

2. 计算均值、标准差

3. 计算 Cohen's d 效应量：

- d < 0.2：差异微小

- 0.2 ≤ d < 0.5：小效应

- 0.5 ≤ d < 0.8：中等效应

- d ≥ 0.8：大效应（具有实际意义）

4. 返回包含统计量和业务解读的结果

"""

fresh = self._filter_sessions(condition="fresh")

tired = self._filter_sessions(condition="tired")

fresh_values = [getattr(s, metric) for s in fresh]

tired_values = [getattr(s, metric) for s in tired]

mean_fresh = statistics.mean(fresh_values)

mean_tired = statistics.mean(tired_values)

# 计算效应量（Cohen's d）

pooled_std = self._calculate_pooled_std(fresh_values, tired_values)

cohens_d = (mean_fresh - mean_tired) / pooled_std if pooled_std > 0 else 0

# 业务解读

if cohens_d >= 0.8:

interpretation = f"充沛状态下的{metric}显著高于疲惫状态（大效应）"

practical_impact = "极高"

elif cohens_d >= 0.5:

interpretation = f"充沛状态下的{metric}中等程度高于疲惫状态"

practical_impact = "高"

else:

interpretation = f"{metric}在两种状态下差异不明显"

practical_impact = "低"

return ComparisonResult(

metric=metric,

mean_fresh=mean_fresh,

mean_tired=mean_tired,

difference=mean_fresh - mean_tired,

cohens_d=cohens_d,

interpretation=interpretation,

practical_impact=practical_impact

)

五、核心知识点卡片（节选）

项目内置 6 张知识点卡片，以下是两张与“睡眠与创造力”直接相关的卡片：

KC-501 睡眠与记忆整合（Memory Consolidation）

创造力并非凭空产生，而是旧知识的重组。慢波睡眠（深睡）负责巩固事实性记忆，REM 睡眠（快速眼动）负责整合抽象关联。剥夺 REM 睡眠会显著降低“顿悟（Aha!）”体验的概率。

KC-502 昼夜节律与认知表现（Circadian Rhythm）

人的认知能力呈 circadian（昼夜节律）波动。大多数成年人的警觉性和工作记忆在上午 9-11 点达到峰值，下午 2-4 点出现低谷，晚上 8-10 点可能有第二个小高峰。违背节律工作，效率可能下降 30% 以上。

完整 6 张卡片涵盖：记忆整合、昼夜节律、默认模式网络（DMN）、睡眠 inertia、脑力疲劳、超量恢复。

六、使用说明

环境准备

pip install rich pandas matplotlib

快速启动

git clone https://github.com/yourname/brain-energy-planner.git

cd brain-energy-planner

python main.py

交互流程

[1] 记录一次创作时段

[2] 查看历史记录

[3] 运行状态对比分析

[4] 生成个性化作息规则

[5] 查看知识点卡片

[6] 导出分析报告

[0] 退出

典型会话示例

>>> 请选择记录类型：[1] 精力充沛 [2] 熬夜疲惫

>>> 2

>>> 昨晚入睡时间：02:30

>>> 今早起床时间：07:00

>>> 主观精力评分（1-10）：3

>>> 咖啡因摄入量（杯）：2

>>> 创作类型：[1] 写代码 [2] 写文档 [3] 设计 [4] brainstorming

>>> 1

>>> 本次产出自评（1-10）：

创意流畅度：2

逻辑严谨性：4

整体质量：3

>>> 客观产出：

有效代码行数：120

花费时间（分钟）：180

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 记录已保存

💡 提示：这已经是本周第 4 次熬夜记录，脑力负债正在累积。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

（积累足够数据后运行分析）

>>> 选择 [3] 运行状态对比分析

╭─ 📊 脑力状态对比分析报告 ─────────────────────╮

│ │

│ 充沛状态样本数：8 │

│ 疲惫状态样本数：12 │

│ │

│ ── 核心指标对比 ── │

│ 创意流畅度: 7.8 vs 3.2 (d=1.42, 极大效应) │

│ 逻辑严谨性: 8.1 vs 5.4 (d=0.96, 大效应) │

│ 整体质量: 8.5 vs 4.1 (d=1.68, 极大效应) │

│ 产出效率: 85行/小时 vs 40行/小时 │

│ │

│ ── 关键发现 ── │

│ ⚠️ 熬夜状态下，创意流畅度下降 59% │

│ ⚠️ 逻辑错误率上升 38% │

│ ⚠️ 同等时间内，有效产出减少 53% │

│ │

│ 💡 结论：你的创意质量对睡眠极其敏感。 │

│ 熬夜不是“争取时间”，而是“浪费时间”。 │

│ │

╰────────────────────────────────────────────────╯

>>> 选择 [4] 生成个性化作息规则

🛡️ 基于你的数据，生成以下作息规则：

【R1】强制睡眠窗口（高优先级）

- 规则：工作日 00:30 前入睡，保证 7 小时睡眠

- 理由：你的数据显示，睡眠<6.5h 时创意质量断崖式下跌

- 执行：23:30 启动“数字宵禁”

【R2】创意时段锁定

- 规则：核心创意工作严格限制在 09:00-11:30

- 理由：此时间段你的逻辑严谨性评分最高（8.1/10）

- 执行：将此窗口设为“深度工作时段”，屏蔽所有通知

【R3】脑力负债偿还机制

- 规则：每熬夜 1 次，次日必须提前 30 分钟睡觉

- 理由：你的恢复周期较长，单次熬夜需要 2 晚才能完全恢复

- 执行：在日历中标记“还债日”

【R4】咖啡因截止时间

- 规则：14:00 后禁止摄入咖啡因

- 理由：你的睡眠敏感度较高，晚间咖啡因显著影响深睡比例

- 执行：14:00 后切换为白开水或花草茶

作为模块调用

from session_logger import SessionLogger

from quality_analyzer import QualityAnalyzer

from rule_generator import RuleGenerator

# 记录数据

logger = SessionLogger()

logger.log_session(

condition="fresh",

sleep_hours=7.5,

energy_level=8,

creativity_flow=8,

logic_rigor=9,

output_quality=9,

lines_of_code=200,

time_spent_minutes=120

)

# 分析对比

analyzer = QualityAnalyzer(logger.get_all_sessions())

report = analyzer.run_full_analysis()

# 生成规则

generator = RuleGenerator(report, logger.get_all_sessions())

rules = generator.generate_rules()

for rule in rules:

print(f"[{rule.priority}] {rule.title}")

print(f" 规则：{rule.rule}")

print(f" 理由：{rule.rationale}")

七、输出示例（分析报告片段）

# 脑力状态与作息优化报告

> 生成时间：2026-07-25

> 数据周期：2026-06-01 ~ 2026-07-24

> 总记录次数：28 次（充沛 10 次，疲惫 18 次）

## 📉 核心发现

1. **创意质量差距巨大**

- 充沛状态下平均产出质量：8.4/10

- 疲惫状态下平均产出质量：3.9/10

- **效应量 d=1.71（极大效应）**

2. **效率悖论**

- 熬夜看似“多工作 3 小时”，但因质量低下，需要额外 2 小时修改

- 净收益为负

3. **恢复滞后**

- 熬夜后需要平均 2.3 天才能恢复到最佳状态

- 连续熬夜会产生累积效应

## 🛡️ 个性化作息规则

### 绝对红线

- **睡眠底线**：工作日 ≥ 7 小时，周末补觉 ≤ 9 小时

- **创意时段**：09:00-11:30（你的黄金窗口）

- **数字宵禁**：00:00 前关闭所有屏幕

### 缓冲机制

- **脑力预算**：每周最多 1 次熬夜额度，且需提前申请

- **还债机制**：熬夜后 48 小时内必须补足睡眠

## 📊 数据可视化


---

*本报告由 Brain Energy Planner v1.0 生成，基于你的真实创作数据。*

八、总结

这个项目最想传达的一个反直觉观点是：熬夜不是勤奋，而是低效的自我欺骗。

作为开发者，我们早就接受了“过早优化是万恶之源”，但我们却心安理得地进行“过早消耗”——在最糟糕的状态下强迫大脑工作，然后花更多时间去修复由此产生的垃圾。

这个工具做的事情很简单：用数据说话，把“早点睡”从一个道德劝诫变成一个经济决策。

三句总结：

1. 时间是线性资源，脑力是指数资源 —— 凌晨 2 点的 1 小时，远不如早上 9 点的 1 小时值钱

2. 保护脑力比压榨脑力更可持续 —— 真正的专业主义，是像对待服务器一样对待自己的大脑

3. 数据是唯一的客观裁判 —— 不要让“我感觉还行”骗了你，让数据告诉你真相

愿你的每一次早睡，都是为了第二天更有力量的创造。

README.md（精简版）

# Brain Energy Planner

一个用于对比不同脑力状态下的创意质量、生成个性化作息规则的 Python 工具。基于实证数据，帮助用户保护脑力资源，提升长期创新能力。

## 核心理念

> 不要用战术上的勤奋（熬夜），掩盖战略上的懒惰（低效）。

## 功能特性

- 创作时段结构化记录

- 充沛 vs 疲惫状态对比分析

- 效应量（Cohen's d）统计检验

- 个性化作息规则生成

- 脑力负债追踪

- 数据可视化报告

## 快速开始

bash

pip install rich pandas matplotlib

python main.py

## 项目结构

brain-energy-planner/

├── config.py # 配置常量

├── utils.py # 工具函数

├── session_logger.py # 创作时段记录

├── quality_analyzer.py # 质量对比分析

├── rule_generator.py # 作息规则生成

├── knowledge_cards.py # 知识点卡片

├── main.py # CLI 入口

└── data/ # 数据存储与图表

## 理论基础

基于睡眠记忆整合理论、昼夜节律、认知疲劳研究、效应量统计等科学成果。

## 隐私说明

所有数据本地存储，无网络传输。

## License

MIT

本项目为教学演示用途，旨在促进科学作息与创新能力的结合。如有持续性睡眠障碍，请咨询专业医师。

利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！