上下文恢复

普通开发者每11分钟就会被中断一次。完全恢复深度工作状态需要23分钟。算一算——大多数开发者根本从未进入过深度工作状态。

功能概述

周五晚上，你在功能开发中途合上笔记本电脑。周一早上，你打开它。文件还在。分支还在。终端历史还在。

但你不在了。你曾经拥有的心智模型——你正准备编写的函数、你刚发现的边界情况、哪个测试失败了及其原因、你决定采用和放弃的方案——全都消失了。

上下文恢复从你留下的工作痕迹中重建你的心智状态。

它能恢复什么

1. 你在哪里

上次会话分析：
├── 分支：feature/checkout-v2
├── 上次提交：wip: 多币种税务计算（存在未提交的更改）
├── 已修改文件（未提交）：
│ ├── src/checkout/tax.ts ......... +47行（函数未完成，逻辑中断）
│ ├── src/checkout/tax.test.ts .... +12行（2个测试，1个失败）
│ └── src/types/currency.ts ....... +3行（新增类型）
├── 上次有意义的编辑：src/checkout/tax.ts:84（周五下午3:47）
├── Git暂存：1条记录（实验性：扁平税率方案——行不通）
└── 未提交的删除：无

2. 你在做什么

活动重建：
├── 主要任务：实现多币种税务计算
├── 当前状态：实现中
│ ├── calculateTax() 完成60%（有正常路径，缺少边界情况）
│ ├── 一个测试通过（美元→美元，简单情况）
│ ├── 一个测试失败：应处理日元零小数币种
│ │ └── 错误：期望100，得到1.00（小数处理错误）
│ └── CurrencyType枚举刚添加但尚未在calculateTax中使用
├── 采用方案：按币种的小数精度查找表
├── 放弃方案：扁平百分比（已暂存，标注行不通）
└── 可能的下一步：修复零小数币种（日元、韩元）的小数处理

3. 你已做的决定

决策上下文（从提交、注释和暂存中重建）：
├── 决定采用：币种小数的查找表方案
│ └── 证据：当前实现使用此模式
├── 决定放弃：扁平百分比方案
│ └── 证据：暂存并标注行不通
├── 未决问题：如何处理查找表中没有的币种
│ └── 证据：第67行的TODO注释：// 未知币种的备选方案？
└── 未解决：在应用税前还是税后进行四舍五入
└── 证据：不同测试用例中存在两种顺序

4. 什么在阻碍你

检测到的阻碍：
├── 活跃：日元测试失败（零小数币种处理）
│ └── 这可能是你最后正在处理的事情
├── 待处理：没有四舍五入边界情况的测试
│ └── 第72行的TODO：// 测试四舍五入：$10的33.33%？
└── 外部：未检测到

工作原理

阶段1：工作痕迹收集
├── Git状态：分支、提交、差异、暂存、引用日志
├── 文件状态：修改时间、部分编辑、光标书签
├── 测试状态：上次测试运行结果、哪些测试失败及原因
├── 注释状态：TODO、FIXME、HACK和内联问题
├── 终端状态：最近命令（构建、测试、运行尝试）
└── 时间分析：修改顺序、最后修改时间戳

阶段2：叙事重建
├── 从工作痕迹中重建故事：
│ ├── 你在做什么任务？（分支名、提交信息）
│ ├── 你采用了什么方案？（代码模式分析）
│ ├── 你放弃了什么？（暂存、回滚的更改、差异中的删除代码）
│ ├── 什么在正常工作？（通过的测试、已提交的代码）
│ ├── 什么出了问题？（失败的测试、未完成的函数）
│ └── 你正准备做什么？（部分代码、TODO、光标位置）
├── 按时间顺序排列故事
└── 识别确切的中断点

阶段3：上下文简报
├── 一段总结：这是你上次停下的地方
├── 立即下一步：你正准备...
├── 活跃阻碍：这阻止了你...
├── 未决决定：你尚未决定...
└── 快速胜利：这些接近完成...

阶段4：热身建议
├── 推荐重新进入点（回到心流的最简单方式）
├── 建议先运行失败的测试（即时反馈循环）
├── 标记你离开期间外部发生的变化
│ └──（主分支上的新提交、依赖更新、CI状态）
└── 完全恢复上下文预计时间：X分钟

上下文简报

╔══════════════════════════════════════════════════════════════╗
║ 上下文恢复 ║
║ 分支：feature/checkout-v2 ║
║ 离开时间：周五下午3:47（63小时前） ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 摘要： ║
║ 你正在实现多币种税务计算。 ║
║ 美元路径正常工作。你遇到了零小数币种（日元、韩元） ║
║ 的错误——它们不使用分，所以你的小数数学产生错误结果。 ║
║ 你在修复中途停了下来。 ║
║ ║
║ 恢复点： ║
║ → src/checkout/tax.ts:84 — 修复日元的小数精度 ║
║ → 运行：npm test -- tax.test.ts（1个失败，1个通过） ║
║ ║
║ 你已做的决定： ║
║ ✓ 使用按币种精度查找（非扁平%） ║
║ ✗ 放弃扁平百分比（已暂存，无法处理边界情况） ║
║ ? 未决：未知币种的备选方案 ║
║ ? 未决：税前还是税后四舍五入？ ║
║ ║
║ 你离开期间： ║
║ ├── 主分支有3个提交（均未触及checkout/） ║
║ ├── CI：主分支为绿色 ║
║ └── 无依赖更新 ║
║ ║
║ 热身： ║
║ 1. 运行失败的测试（重新看到错误） ║
║ 2. 修复第84行的日元小数处理 ║
║ 3. 添加韩元测试用例（相同模式） ║
║ 预计上下文恢复时间：约5分钟 ║
╚══════════════════════════════════════════════════════════════╝

何时调用

• - 每天早上。 第一件事。在接触代码之前。
• 任何超过30分钟的会议之后
• 切换分支/任务时
• 接手他人遗弃的分支时
• 假期或休息后
• 当同事问你在X上做到哪里了？

不恢复的代价

为什么重要

上下文切换不仅仅是关闭和打开文件。它关乎加载心智模型——让你在特定代码区域高效工作的决策、发现和意图网络。没有这个模型，你在自己的代码库中就像个游客。

上下文恢复不保存你的会话。它保存你的理解。

零外部依赖。零API调用。纯Git和文件系统分析。