周报 / 月度总结
日志回答「今天做了什么」，复盘回答「这个项目为什么成/败」，而周报与月度总结回答**「这段时间有没有朝目标前进」**——把散落的日志聚合成可回顾、可分享、可调整方向的阶段快照。
定位与频率
| 维度 | 周报 | 月度总结 |
|---|---|---|
| 频率 | 每周一次 | 每月一次 |
| 耗时 | 20～30 分钟 | 1～2 小时 |
| 输入 | 本周学习日志 | 本月 4～5 篇周报 + 日志 |
| 主要问题 | 本周推进了什么、卡在哪、下周怎么调整 | 本月主线是否推进、时间去哪了、下月目标是否要改 |
| 篇幅 | 5～10 行要点 | 一页左右，可含数据表 |
周报是月度总结的原料：周报坚持写，月度总结只需拼接；跳过周报直接写月报，回忆损耗会让数据失真。
与相关记录的分工
| 记录 | 时机 | 颗粒度 | 侧重 | 关系 |
|---|---|---|---|---|
| 学习日志 | 每日 | 当天 | 记录 | 周报/月报的数据源 |
| 周报 / 月度总结 | 每周 / 每月 | 一段时期 | 归纳 + 校准 | 本页 |
| 踩坑记录 | 踩坑时 | 单条 | 问题 | 周报中引用的排错经历落到这里 |
| 项目复盘 | 里程碑/项目结束 | 单个项目 | 归因 | 复盘的行动项进入下月计划的检查项 |
模板（直接复制）
markdown
---
title: 周报 2026-W36（08.31–09.06）
description: 本周主线一句话 + 下周重点
tags:
- 周报
---
# 周报 2026-W36
## 本周主线
按[学习路径](../paths/)中的目标写 1-3 句：推进到路线哪一步。
## 数据快照
| 指标 | 本周 | 上周 | 说明 |
| --- | --- | --- | --- |
| 学习投入（小时） | | | 含日志与练习 |
| 主题数 / 文章数 | | | 学到几个主题、沉淀几篇笔记 |
| 产出物 | | | 项目 / 练习 / 文章链接 |
| 踩坑数 | | | 见[踩坑记录](./pitfalls) |
## 收获与疑问
- 本周最值得记的三句话收获（从日志「收获」字段挑选）；
- 遗留疑问：答上来的划掉并补结论，没答上的继续排进下周。
## 下周计划
- [ ] 主线：…（对应路线下一里程碑）
- [ ] 补齐：上周遗留的疑问 / 未完成练习
- [ ] 预防：上周踩坑的「预防」动作是否已落实
## 一句话总结
本周最接近目标的时刻是…，下周唯一要改进的是…月度总结在此结构上增加一节「月度评估」，用下面的问题清单自查。
月度评估清单
- [ ] 主线推进：这个月是不是在既定学习路径上？偏离了多少、为什么？
- [ ] 时间去向：投入时间与产出是否匹配？哪个环节耗时最重（查日志）？
- [ ] 文档沉淀：本月新收录/更新了哪些页面？它们被其他文章引用了吗？
- [ ] 遗留债务：多少疑问挂了超过两周？该升级为踩坑记录还是专题文章？
- [ ] 下月目标：结合项目复盘的行动项，写下个月要验收的 1-2 件事。
怎么写才有效
| 要点 | 要求 | 反例 |
|---|---|---|
| 数据要有来源 | 数字都从日志里数出来，不靠回忆 | 「大概学了 20 小时吧」 |
| 归纳代替流水账 | 挑 3 条最有价值的收获，不逐日复述 | 把 7 天日志抄一遍 |
| 计划可验收 | 写具体事件与验收标准，与路径里程碑对齐 | 「下周继续学」 |
| 定期回顾 | 月报末尾回看上月目标是否兑现 | 写完好几个月不再看 |
示例对比
流水账（差）：
本周学了 Vue 响应式和 React Hooks，做了几个练习，感觉进度不错。下周继续。
问题：无数据、无主线对齐、无可验收计划，一个月后无法回答「学得怎么样」。
可校准（好）：
写作规范速记
- 命名
weekly-YYYY-MM.md或monthly-YYYY-MM.md，按月归档在docs/journals/下； - 数据一律来自日志，能数出来就不写「大概」；
- 收获只用三句话，说完说透，其余链接到对应笔记；
- 每条计划都要能对应到学习路径的下一步，闭环才能防止方向漂移；
- 写完后把本月计划中完成/未完成项同步到日志与下月计划。
写作规范请参阅过程记录。