首页 / 周报
周报
按 ISO 周归档的工作记录。每周一页，内容按四大类固定顺序组织： 1 需求 · 2 Bug · 3 经验总结 · 4 问题复盘；四类都不再分小类， 大类下面直接 1. 2. 3. 排。 所有条目另有一份全站留档库，按大类 / 问题类型 / 模块可筛。 支持图文留档：截图直接嵌进正文，点击全屏放大。 跨周的任务按§3.4 归属规则决定记在哪一周。
已归档4 周（W36 / W37 / W38 / W39）
累计留档19 条
需求9 条
Bug9 条
经验总结1 条
问题复盘0 条
最近更新2026-09-18
四大类是第一层，编号跟着大类走
W{周}-R{序} 需求 · -B{序} Bug ·
-E{序} 经验 · -P{序} 复盘。
Bug 写代码/配置错在哪，复盘写我的排查过程错在哪——同一件事经常两边各有一条。
完整口径见 全站留档库 §1。
1. 周报列表
W39
09/21 – 09/27
需求 0 · Bug 1
W38
09/14 – 09/20
需求 3 · Bug 5
W37
09/07 – 09/13
需求 1 · Bug 0
W36
08/31 – 09/06
需求 4 · Bug 3
W35 没有单独成页——那周唯一的问题是 W36-B01，按§3.4 归属规则算小耗时任务，只记在完成周 W36。
2. 常用入口
全站留档库
所有留档的唯一索引。第一层按四大类（需求/Bug/经验/复盘）筛，再按问题类型和模块继续收窄。
分类索引 · 8 条
留档模板
新一周开工时直接复制这个文件改。四大类骨架 + 现成积木：需求卡、留档卡、经验 tip、复盘块、时序表、飞书条目。
复制即用
交付标准与留档规范
沟通与协作 3 条 + 交付与验收 3 条。写周报前自己照着逐条过一遍，但清单不写进周报——它是功能模块界面遵循的东西，贴进来只会挡阅读。
规范
Bug 案例大全
历史沉淀的 30+ 真实 bug。周报里的问题稳定复盘后，会提炼进这里作为长期知识。
历史沉淀
3. 怎么用这套周报
3.1 写的时候
| 动作 | 落在哪 | 要点 |
|---|---|---|
| 接到一个需求 / 问题 | records.html | 先定大类再编号：W36-R01 / -B01 / -E01 / -P01。别等排查完才登记 |
| 需求交付 | weekly/{ISO周}.html §1 | 固定四段：背景 / 做法 / 影响面 / 验收。验收要写怎么验的，
不是「已完成」——--noEmit EXIT=0 不算验收，得 grep 产物 |
| 排查过程 | weekly/{ISO周}.html §2 | 时序表逐条对日志时间戳；根因要具体到文件行号或配置字段 |
| 抽经验 | weekly/{ISO周}.html §3 | 用 <div class="tip">，末尾必须带 tip-src 写来源 + 适用场景，
否则下次搜不到也想不起来 |
| 复盘弯路 | weekly/{ISO周}.html §4 | 四段：当时怎么想的 / 实际 / 代价 / 下次怎么改。 这是整份周报唯一别人拿不到的部分，不许省 |
| 截图 / 视频 | weekly/img/ | 命名 w36-b01-overlay.png（带大类字母）；正文用 <figure class="shot"> |
| 问题结论 | 两处同步 | 周报正文 + records.html 索引卡，大类、问题类型和模块标签保持一致 |
| 让人搜得到 | assets/search-index.js | 末尾加一条 { t, c, h, k }，不加就搜不到；
h 里的锚点要和页内 id 对得上，别写过期锚点 |
| 登记导航 | assets/site.js | 新建一周要在 NAV「周报」组里加一行，否则侧边栏进不去 |
3.2 图文留档的三种写法
单张图（点击全屏放大，全站自动生效）：
<figure class="shot">
<img src="img/w36-b01-overlay.png" alt="调试面板">
<figcaption><b>QA 截图（18:24:51）</b>：说明文字</figcaption>
</figure>多图并排（s2 两列 / s3 三列）：
<div class="shot-grid s2">
<figure class="shot">...</figure>
<figure class="shot">...</figure>
</div>图还没就位——留一个占位块，图片补上后把这个 div 删掉：
<figure class="shot">
<div class="shot-miss">把截图放到 weekly/img/xxx.png</div>
<img src="img/xxx.png" alt="">
</figure>
视频不嵌进页面
录屏体积大，直接嵌会把站点撑爆。用
<div class="attach"> 记落盘路径就行，
需要看的人自己去那个目录拿。日志、配置文件同理。
3.3 分类筛选怎么加
任何容器加 data-filter-scope，里面的卡片加 data-cat="标签1 标签2"，
site.js 会自动扫出所有标签、生成筛选按钮条、带上每类的数量。
不需要手写按钮，也不需要改 JS。
大类必须放 data-cat 的第一个
筛选条前四个按钮是四大类，靠第一个标签识别：
data-cat="需求 客户端 关卡工具 副本集合"、
data-cat="Bug 策划 配置摆放 坠落重生"。
顺序写错，大类按钮就排不到前面。
3.4 跨周任务记在哪一周
一个任务上周开工、这周才完成，按耗时大小分两种写法。判据是： 这一周结束时，这件事值不值得单独占一段周报。
| 耗时 | 记在哪 | 编号 | 怎么写 |
|---|---|---|---|
| 小耗时 净投入 ≤ 2 天 |
只记完成周 | 用完成周的周次 | 正文加一行「起止」，写清提出周和完成周，别把开工周也开一页 |
| 大耗时 跨周且净投入 > 2 天 |
两周都记 | 编号沿用首次出现那周，不随周次变 | 每周一张卡，卡上标「第 N 周 / 共 N 周」+ 进度条；完成周那张写最终结论 |
为什么编号不跟着周次变
大任务的编号是身份，不是日期。W36-B02 在 W37、W38 的周报里还叫
W36-B02，这样 records.html 里只需要一张卡，
详情链接指向最新那一周的周报即可。
大耗时任务在进行周的写法（rec-span 标周次，prog 标进度）：
W36-R09
第 2 周 / 共 3 周
（示例）某跨周重构，本周进行中
进行中
进度
卡点
有卡点写在这里，没有就删掉这一段。卡点连续两周不动要升级上报。
<span class="rec-span s-cont">第 2 周 / 共 3 周</span> <!-- 进行周：黄色 -->
<span class="rec-span">第 3 周 / 共 3 周</span> <!-- 完成周：主色 -->
<div class="prog">
<div class="prog-bar"><div class="prog-fill" style="width:65%"></div></div>
<div class="prog-meta">
<span class="prog-pct">65%</span>
<span>本周投入 3 天</span><span>累计 5 天</span>
<span class="prog-line"><b>已完成：</b>...</span>
<span class="prog-line"><b>下周做：</b>...</span>
</div>
</div>
进度条还有两个变体：prog-fill p-block（红，卡住了）、
prog-fill p-done（绿，本周做完）。
进度别写「差不多快好了」
prog-line 必须写具体做完了哪几块、下周做哪几块。
只写百分比等于没写——下周自己看不懂当时的 65% 是指什么。